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-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).