jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-05-07 03:28:58 +00:00
Code Issues Packages Projects Releases Wiki Activity
home-assistant.io/source/_components/sensor.apcupsd.markdown
Flyte 80ca6b43d1 Add apcupsd component documentation
2016-02-10 18:52:41 +00:00

2.3 KiB
Raw Blame History

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category
layout title description date sidebar comments sharing footer logo ha_category
page APCUPSd Sensor Instructions on how to set up APCUPSd sensors within Home Assistant. 2016-02-10 18:28 true false true true apcupsd.png Sensor

Any of the lines of output from the apcaccess command can be used as a sensor device in Home Assistant. In order to create a sensor for a value, create an entity within a sensor section of your configuration. The following parameters may be used:

  • name (Required): The name you'd like to give the sensor in Home Assistant.
  • platform (Required): Set to apcupsd.
  • type (Required): The label for the value you'd like to track based on the output of apcaccess. Refer to the examples for ideas.

Example

Given the following output from apcaccess:

APC      : 001,051,1149
DATE     : 2016-02-09 17:13:31 +0000
HOSTNAME : localhost
VERSION  : 3.14.12 (29 March 2014) redhat
UPSNAME  : netrack
CABLE    : Custom Cable Smart
DRIVER   : APC Smart UPS (any)
UPSMODE  : Stand Alone
STARTTIME: 2016-02-09 16:06:47 +0000
MODEL    : SMART-UPS 1400
STATUS   : TRIM ONLINE
LINEV    : 247.0 Volts
LOADPCT  : 13.0 Percent
BCHARGE  : 100.0 Percent
TIMELEFT : 104.0 Minutes
MBATTCHG : 5 Percent
MINTIMEL : 3 Minutes
MAXTIME  : 0 Seconds
MAXLINEV : 249.6 Volts
MINLINEV : 244.4 Volts
OUTPUTV  : 218.4 Volts
SENSE    : High
DWAKE    : 0 Seconds
DSHUTD   : 180 Seconds
DLOWBATT : 2 Minutes
LOTRANS  : 196.0 Volts
HITRANS  : 253.0 Volts
RETPCT   : 15.0 Percent
ITEMP    : 30.6 C
ALARMDEL : Low Battery
BATTV    : 27.6 Volts
LINEFREQ : 50.0 Hz
LASTXFER : High line voltage
NUMXFERS : 0
TONBATT  : 0 Seconds
CUMONBATT: 0 Seconds
XOFFBATT : N/A
SELFTEST : NO
STESTI   : 336
STATFLAG : 0x0500000A
DIPSW    : 0x00
REG1     : 0x00
REG2     : 0x00
REG3     : 0x00
MANDATE  : 07/13/99
SERIALNO : GS9888761008
BATTDATE : 13/11/15
NOMOUTV  : 230 Volts
NOMBATTV : 24.0 Volts
EXTBATTS : 0
FIRMWARE : 70.11.I
END APC  : 2016-02-09 17:13:46 +0000

Use the (case insensitive) values from the left hand column as your type:

sensor:
  - name: Mains Voltage
    platform: apcupsd
    type: linev

  - name: UPS Load
    platform: apcupsd
    type: loadpct

  - name: UPS Temperature
    platform: apcupsd
    type: itemp