ecoen66
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-raritanpduNB: If you install homebridge like this:
sudo npm install -g --unsafe-perm homebridgeThen all subsequent installations must be like this:
sudo npm install -g --unsafe-perm homebridge-platform-raritanpduConfiguration
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"
}
]...
Config Explanation:
| 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).