1.4.2 • Published 2 years ago

homebridge-http-garage v1.4.2

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

homebridge-http-garage

npm npm

Description

This homebridge plugin exposes a web-based garage opener to Apple's HomeKit. Using simple HTTP requests, the plugin allows you to open/close the garage. Please look at homebridge-web-garage if you want a plugin that allows for real-time status updates.

Find script samples for the opener in the examples folder.

Installation

  1. Install homebridge
  2. Install this plugin: npm install -g homebridge-http-garage
  3. Update your config.json

Configuration

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

Core

KeyDescriptionDefault
accessoryMust be GarageDoorOpenerN/A
nameName to appear in the Home appN/A
apirouteRoot URL of your deviceN/A

Optional fields

KeyDescriptionDefault
openTimeTime (in seconds) to simulate your garage opening10
closeTimeTime (in seconds) to simulate your garage closing10
autoLockWhether your garage should auto-close after being openedfalse
autoLockDelayTime (in seconds) until your garage will automatically close (if enabled)20
pollIntervalTime (in seconds) between device polls (if polling is enabled)120

Additional options

KeyDescriptionDefault
timeoutTime (in milliseconds) until the accessory will be marked as Not Responding if it is unreachable3000
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:
{
    "currentState": INT_VALUE
}
  1. Set the state when it receives:
/setState?value=INT_VALUE

State key

StateDescription
0Open
1Closed
1.4.2

2 years ago

1.4.1

2 years ago

1.4.0

2 years ago

1.3.10

2 years ago

1.3.9

2 years ago

1.3.8

2 years ago

1.3.7

4 years ago

1.3.6

4 years ago

1.3.5

4 years ago

1.3.4

4 years ago

1.3.3

4 years ago

1.3.2

4 years ago

1.3.1

4 years ago

1.3.0

5 years ago

1.2.9

5 years ago

1.2.8

5 years ago

1.2.7

5 years ago

1.2.6

5 years ago

1.2.5

5 years ago

1.2.4

5 years ago

1.2.3

5 years ago

1.2.2

5 years ago

1.2.1

5 years ago

1.2.0

5 years ago

1.1.9

5 years ago

1.1.8

5 years ago

1.1.7

5 years ago

1.1.6

5 years ago

1.1.5

5 years ago

1.1.4

5 years ago

1.1.3

5 years ago

1.1.2

5 years ago

1.1.1

5 years ago

1.1.0

5 years ago

1.0.9

5 years ago

1.0.8

5 years ago

1.0.7

5 years ago

1.0.6

5 years ago

1.0.5

5 years ago

1.0.4

5 years ago

1.0.3

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago