An open API service indexing awesome lists of open source software.

https://github.com/ecoen66/homebridge-platform-pdu

Homebridge platform for Raritan and APC PDUs
https://github.com/ecoen66/homebridge-platform-pdu

apc homebridge-platform pdu raritan

Last synced: about 1 month ago
JSON representation

Homebridge platform for Raritan and APC PDUs

Awesome Lists containing this project

README

        

# homebridge-platform-pdu
# Homebridge dynamic Platform Plugin for Raritan and APC PDUs
A [Raritan](https://www.raritan.com) PX-5475 and [APC](https://www.apc.com) AP7931 PDU plugin for
[Homebridge](https://github.com/nfarina/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](https://github.com/invliD/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"
}
]
...

### 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](https://d3b2us605ptvk2.cloudfront.net/download/PX/v1.5.13/PX-1.5.13-MIB.txt) & [APC PowerNet MIB v4.0.4](https://www.apc.com/shop/us/en/products/APC-PowerNet-MIB-v4-0-4/P-SFPMIB404).

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