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
- Host: GitHub
- URL: https://github.com/ecoen66/homebridge-platform-pdu
- Owner: ecoen66
- License: apache-2.0
- Created: 2020-05-05T21:44:09.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T16:58:27.000Z (about 1 year ago)
- Last Synced: 2024-04-23T18:19:51.125Z (about 1 year ago)
- Topics: apc, homebridge-platform, pdu, raritan
- Language: TypeScript
- Homepage:
- Size: 228 KB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
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-raritanpduNB: 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).