1.0.8 • Published 2 years ago

homebridge-web-shower v1.0.8

Weekly downloads
1
License
MIT
Repository
github
Last release
2 years ago

homebridge-web-shower (Under Development)

npm npm

Description

This homebridge plugin exposes a web-based shower to Apple's HomeKit. Using simple HTTP requests, the plugin allows you to turn on/off specific shower heads aand control the temperature.

Installation

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

Configuration

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

Core

KeyDescriptionDefault
accessoryMust be WebSprinklersN/A
nameName to appear in the Home appN/A
apirouteRoot URL of your deviceN/A
townYour nearest townN/A
countryYour country codeN/A
keyYour Apixu API keyN/A
zonesNumber of sprinkler zones3

Optional fields

KeyDescriptionDefault
schedulingWhether or not to enable scheduling (yes/no)yes

Additional options

KeyDescriptionDefault
pollIntervalTime (in seconds) between device polls300
listenerWhether to start a listener to get real-time changes from the devicefalse
timeoutTime (in milliseconds) until the accessory will be marked as Not Responding if it is unreachable3000
portPort for your HTTP listener (if enabled)2000
http_methodHTTP method used to communicate with the deviceGET
usernameUsername if HTTP authentication is enabledN/A
passwordPassword if HTTP authentication is enabledN/A
modelAppears under the Model field for the accessoryplugin
serialAppears under the Serial field for the accessoryapiroute
manufacturerAppears under the Manufacturer field for the accessoryauthor
firmwareAppears under the Firmware field for the accessoryversion

API Interfacing

Your API should be able to:

  1. Return JSON information when it receives /status:
[
  {
    "zone": 1,
    "state": 0
  },
  {
    "zone": 2,
    "state": 0
  },
  {
    "zone": 3,
    "state": 0
  },
  ...
]
  1. Set zone state when it receives:
/state?value=INT_VALUE?zone=INT_VALUE

Optional (if listener is enabled)

  1. Update state following a manual zone override by messaging the listen server:
/state?value=INT_VALUE?zone=INT_VALUE
1.0.8

2 years ago

1.0.7

2 years ago

1.0.6

2 years ago

1.0.5

2 years ago

1.0.4

4 years ago

1.0.3

4 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago