homebridge-platform-pdu

Homebridge dynamic Platform Plugin for Raritan and APC PDUs

A Raritan PX-5475 and APC AP7931 PDU plugin for
Homebridge. This creates one or more PDU accessories, each with multiple outlet services and a light meter service to report on current utilization in Watts.

This code is heavily based on the work of invliD's homebridge-digipower-pdu accessory.

Installation

Run these commands:

% sudo npm install -g homebridge
% sudo npm install -g homebridge-platform-raritanpdu

NB: If you install homebridge like this:

sudo npm install -g --unsafe-perm homebridge

Then all subsequent installations must be like this:

sudo npm install -g --unsafe-perm homebridge-platform-raritanpdu

Configuration

Example platform config (needs to be added to the homebridge config.json):
...

"platforms": [
{
"name": "LAB Platform PDU",
"debug": false;
"pdus": [
{
"ipAddress": "192.168.1.70",
"snmpCommunity": "private"
},
{
"ipAddress": "192.168.1.75",
"snmpCommunity": "private"
}

],
"platform": "Platform PDU"
}
]
...

$3

Field | Description
----------------------------|------------
platform | (required) Must always be "Platform PDU".
name | (required) A name for HomeBridge to use to reference the platform.
ip_address | (required) The internal ip address of your PDU.
snmp_community | (required) The Write community string for your PDU.
debug | (optional) Enables additional logging from the platform for troubleshooting.

Supported Agents

The only tested Raritan PDU model for this plugin is the one that I have in my lab, the PX-5475, but others should work.
The only tested APC PDU model for this plugin is the one that I have in my lab, the AP7931.
This is accomplished using the PX-PDU-MIB & APC PowerNet MIB v4.0.4.

The outlet count is grabbed from the PDU using SNMP, as are the Model, FirmwareRevision, SerialNumber & SNMP system name (used as a DisplayName).