1.0.6 • Published 4 years ago
Share package homebridge-web-door
Description This homebridge plugin exposes a web-based valve to Apple's HomeKit . Using simple HTTP requests, the plugin allows you to open and close the door.
Installation Install homebridge Install this plugin: npm install -g homebridge-web-door Update your config.json file Configuration "accessories": [
{
"accessory": "WebDoor",
"name": "Door",
"apiroute": "http://myurl.com"
}
]Core Key Description Default accessoryMust be WebDoor N/A nameName to appear in the Home app N/A apirouteRoot URL of your device N/A
Optional fields Key Description Default autoResetWhether obstruction detection should automatically change the state back to 0 after being triggered falseautoResetDelayTime (in seconds) until the obstruction detection will automatically reset (if enabled) 5
Additional options Key Description Default pollIntervalTime (in seconds) between device polls 300timeoutTime (in milliseconds) until the accessory will be marked as Not Responding if it is unreachable 3000portPort for your HTTP listener (only one listener per port) 2000http_methodHTTP method used to communicate with the device GETusernameUsername if HTTP authentication is enabled N/A passwordPassword if HTTP authentication is enabled N/A modelAppears under the Model field for the accessory plugin serialAppears under the Serial field for the accessory apiroute manufacturerAppears under the Manufacturer field for the accessory author firmwareAppears under the Firmware field for the accessory version
API Interfacing Your API should be able to:
Return JSON information when it receives /status: {
"positionState": INT_VALUE,
"currentPosition": INT_VALUE,
"targetPosition": INT_VALUE
}Open/close the garage when it receives: /targetPosition?value=INT_VALUE_0_TO_100Update currentPosition as it opens/closes by messaging the listen server: /currentPosition?value=INT_VALUE_0_TO_100Update positionState as it opens/closes by messaging the listen server: /positionState?value=INT_VALUE_0_TO_2Update targetPosition following a manual override by messaging the listen server: /targetPosition?value=INT_VALUE_0_TO_100Update obstructionDetected when an obstruction is detected by messaging the listen server (should notify 0 after obstruction moves unless autoReset is enabled): /obstructionDetected?value=INT_VALUE_0_TO_1PositionState Key Number Name 0Opening 1Closing 2Stationary