homebridge-web-fan

1.0.7 • Public • Published

homebridge-web-fan

npm npm

Description

This homebridge plugin exposes a web-based valve to Apple's HomeKit. Using simple HTTP requests, the plugin allows you to turn on/off the fan.

Installation

  1. Install homebridge
  2. Install this plugin: npm install -g homebridge-web-fan
  3. Update your config.json file

Configuration

"accessories": [
     {
       "accessory": "WebFan",
       "name": "Fan",
       "apiroute": "http://myurl.com"
     }
]

Core

Key Description Default
accessory Must be WebFan N/A
name Name to appear in the Home app N/A
apiroute Root URL of your device N/A

Optional fields

Key Description Default
rotationSpeed Whether to expose rotation speed as a characteristic false
rotationDirection Whether to expose rotation direction as a characteristic false

Additional options

Key Description Default
pollInterval Time (in seconds) between device polls 300
listener Whether to start a listener to get real-time changes from the device false
timeout Time (in milliseconds) until the accessory will be marked as Not Responding if it is unreachable 3000
port Port for your HTTP listener (if enabled) 2000
http_method HTTP method used to communicate with the device GET
username Username if HTTP authentication is enabled N/A
password Password if HTTP authentication is enabled N/A
model Appears under the Model field for the accessory plugin
serial Appears under the Serial field for the accessory apiroute
manufacturer Appears under the Manufacturer field for the accessory author
firmware Appears under the Firmware field for the accessory version

API Interfacing

Your API should be able to:

  1. Return JSON information when it receives /status:
{
    "currentState": INT_VALUE
}
  1. Set the state when it receives:
/setState?value=INT_VALUE

Optional (if listener is enabled)

  1. Update state following a manual override by messaging the listen server:
/state?value=INT_VALUE
  1. If rotationSpeed is enabled, update rotationSpeed following a manual override by messaging the listen server:
/rotationSpeed?value=INT_VALUE_0_TO_100
  1. If rotationDirection is enabled, update rotationDirection following a manual override by messaging the listen server:
/rotationDirection?value=INT_VALUE_0_TO_1

Readme

Keywords

Package Sidebar

Install

npm i homebridge-web-fan

Weekly Downloads

1

Version

1.0.7

License

MIT

Unpacked Size

12.3 kB

Total Files

4

Last publish

Collaborators

  • phenotypic