supported_hardware:apc
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
supported_hardware:apc [2018/11/14 12:29] – James Sentman | supported_hardware:apc [2018/11/17 15:13] – [XTension Units] James Sentman | ||
---|---|---|---|
Line 182: | Line 182: | ||
====XTension Setup==== | ====XTension Setup==== | ||
- | {{: | + | {{: |
+ | Set the polling times. You can set separate polling times for when the power is on and then the power is off. I don’t need to see every single change in load when things are working fine and so the default for AC On Polling time is 30 seconds. Once the power goes off though I want to see updates to the battery charge and time left more often so the default for polling times when the power is off is every 10 seconds. When the interface is running you can manually poll it for new information with the Poll Now button. | ||
+ | |||
+ | The Event Broadcast Port is set by the xtevent.py script you installed above. Immediate events are sent to XTension via a UDP broadcast on this port. If you change this port in XTension then you must edit the xtevent.py script on your raspberry pi to match or you won’t receive any realtime events. | ||
+ | |||
+ | Click the save button, find the new interface in the Interface Status window and check it’s enabled checkbox to start it up. | ||
====XTension Units==== | ====XTension Units==== | ||
{{ : | {{ : | ||
- | **AC Power**: shows online and is in an on state as long as the AC power is available. | + | **AC Power**: shows online and is in an on state as long as the AC power is available. |
**Error**: sometimes the software will append an error message to the status line. I have seen “LOWBATT” when my ups battery wasn’t going to be able to service the high load. This unit will display either “none” or the message sent. It will be off as long as there is no error and will turn on to alert you that the UPS has sent some error message. Use the On script to notify yourself of an error message from the UPS. Note that this is not the same as a failed battery self test, that message handled separately see the “Self Test Failure” unit below. | **Error**: sometimes the software will append an error message to the status line. I have seen “LOWBATT” when my ups battery wasn’t going to be able to service the high load. This unit will display either “none” or the message sent. It will be off as long as there is no error and will turn on to alert you that the UPS has sent some error message. Use the On script to notify yourself of an error message from the UPS. Note that this is not the same as a failed battery self test, that message handled separately see the “Self Test Failure” unit below. | ||
Line 204: | Line 209: | ||
**Self Test Failure**: If no self test has been run since the program connected then this unit will be in an off state and show “none”. Once a test has been run while it’s watching the unit label will change to “OK” unless there is a problem. If a self test failure of the battery or the load or whatever happens the label will change to the error message and the unit will turn on. Use the on script to notify yourself of a failed self test. | **Self Test Failure**: If no self test has been run since the program connected then this unit will be in an off state and show “none”. Once a test has been run while it’s watching the unit label will change to “OK” unless there is a problem. If a self test failure of the battery or the load or whatever happens the label will change to the error message and the unit will turn on. Use the on script to notify yourself of a failed self test. | ||
+ | |||
+ | **On Battery**: When the power has been out long enough for the UPS to be sure it isn’t a self test this unit will turn on. This is usually 5 or 6 seconds after a power failure. This will not turn on for power failure events shorter than that duration. This could be useful as you might turn off loads that are plugged into the UPS that are not necessary in a long term power failure condition to reduce the load and increase the runtime. | ||
+ | |||
+ | **Charging**: | ||
If your device supports these additional readings then units to create them will be setup as well. Most simpler units do not support these. | If your device supports these additional readings then units to create them will be setup as well. Most simpler units do not support these. | ||
Line 214: | Line 223: | ||
**Humidity**: | **Humidity**: | ||
- | |||
====History==== | ====History==== | ||
- | The apcupsd plugin first appeared in XTension 9.4.12 on Oct 2nd 2018 and is written by James Sentman | + | * The apcupsd plugin first appeared in XTension 9.4.12 on Oct 2nd 2018 and is written by James Sentman |
+ | * Version 2.0 of the plugin added support for realtime event reception of power fails and other messages. It also stops the ups software from shutting down the pi and killing the power from the UPS early. It was released in XTension version 9.4.13 in November of 2018. |
supported_hardware/apc.txt · Last modified: 2023/02/17 13:39 by James Sentman