NAME
asem - driver for UPS in ASEM PB1300
NOTE ABOUT HISTORIC NUT RELEASE
Note
|
Two NUT websites
This version of the page reflects NUT release v2.8.1 with codebase commited 4ba352d8f at 2023-10-31T21:46:20+01:00 Options, features and capabilities in current development (and future releases) are detailed on the main site and may differ from ones described here. |
NOTE
This man page only documents the hardware-specific features of the asem driver. For information about the core driver, see nutupsdrv(8).
SUPPORTED HARDWARE
The asem driver supports the UPS in ASEM PB1300 embedded PCs. Likely other I2C devices from the same manufacturer will work too, since this is a "custom" charger.
Seems that there are two versions of the charger. Older one is based on Max1667, newer one is a custom solution. Both are on I2C address 0x09. To be compatible with both versions, the driver just reads bit 15 of address 0x13 which yields online/on battery status. Battery monitor is a BQ2060 at address 0x0B.
EXTRA ARGUMENTS
The required parameter for this driver is the I2C bus name:
- port=dev-node
-
On the Asem PB1300, this should be
/dev/i2c-7
for the i801 SMBUS adapter.
This driver also supports the following optional settings:
- lb=num
-
Set the low battery threshold to num volts.
- hb=num
-
Set the high battery threshold to num volts.
INSTALLATION
This driver is specific to the Linux I2C API, and requires the lm_sensors libi2c-dev or its equivalent to compile.
Beware that the SystemIO memory used by the I2C controller is reserved
by ACPI. If only a native I2C driver (e.g. i2c_i801, as of 3.5.X Linux
kernels) is available, then you’ll need to relax the ACPI resources check.
For example, you can boot with the acpi_enforce_resources=lax
option.
KNOWN ISSUES AND BUGS
The driver shutdown function is not implemented, so other arrangements must be made to turn off the UPS.
AUTHOR
Giuseppe Corbelli <giuseppe.corbelli@copanitalia.com>
SEE ALSO
The core driver:
Internet resources:
-
PB1300 specifications: http://www.asem.it/en/products/industrial-automation/box-pcs/performance/pb1300/
-
BQ2060 datasheet: http://www.ti.com/lit/ds/symlink/bq2060.pdf
-
The NUT (Network UPS Tools) home page: https://www.networkupstools.org/