mhop/ha-bridge
1
0
Fork 0
mirror of https://github.com/bwssytems/ha-bridge.git synced 2025-12-16 18:24:36 +00:00
Code Issues Packages Projects Releases Wiki Activity

Updtated bridge to be able to emulate the armzilla upnp responses.

Browse Source 
Adding optional field edits - in progress.
This commit is contained in:
Admin
2015-09-02 13:06:59 -05:00
parent 392a46c3d8
commit 68de92bb74
9 changed files with 167 additions and 47 deletions
Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@@ -1,42 +1,40 @@
# ha-bridge
Emulates philips hue api to other home automation gateways. The Amazon echo now supports wemo and philips hue.
Build
-----
To customize and build it yourself, build a new jar with maven:
Emulates philips hue api to other home automation gateways. The Amazon echo now supports wemo and philips hue.
## Build
To customize and build it yourself, build a new jar with maven:
```
mvn install
```
Otherwise go to http://www.bwssystems.com/apps.html to download the latest jar file.
Run
----
Then locate the jar and start the server with:
Otherwise go to http://www.bwssystems.com/apps.html to download the latest jar file.
## Run
Then locate the jar and start the server with:
```
java -jar -Dvera.address=192.168.X.Y ha-bridge-0.X.Y.jar
```
``'
## Available Arguments
### -Dvera.address=<ip address>
The argument for the vera address should be given as it the system does not have a way to find the address. Supply -Dvera.address=X.Y.Z.A on the command line to provide it.
### -Dupnp.config.address=<ip address>
The server defaults to the first available address on the host. Replace the -Dupnp.config.address=<ip address> value with the server ipv4 address you would like to use.
### -Dserver.port=<port>
The server defaults to running on port 8080. If you're already running a server (like openHAB) on 8080, -Dserver.port=<port> on the command line.
### -Dupnp.devices.db=<filepath>
The default location for the db to contain the devices as they are added is "data/devices.db". If you would like a different filename or directory, specify -Dupnp.devices.db=<directory>/<filename> or <filename> if it is the same directory.
The default upnp response port will be 50000 otherwise it can be set with -Dupnp.response.port=<port>.
Upnp has been very closed on this platform to try and respond as a hue and there is now a setting to control if it is more open or strict, Add -Dupnp.strict=<true|false> to your command line to have the emulator respond to what it thinks is an echo to a hue or any other device. The default is upnp.strict=true.
Then configure by going to the url for the host you are running on or localhost:
### -Dupnp.resonse.port=<port>
The upnp response port that will be used. The default is 50000.
### -Dupnp.strict=<true|false>
Upnp has been very closed on this platform to try and respond as a hue and there is now a setting to control if it is more open or strict, Add -Dupnp.strict=<true|false> to your command line to have the emulator respond to what it thinks is an echo to a hue or any other device. The default is upnp.strict=true.
### -Dtrace.upnp=<true|false>
Turn on tracing for upnp discovery messages. The default is false.
### -Dvtwo.compatibility=<true|false>
Turns on compatibility for upnp detection and response as it was in the original version of amazon-echo-ha-bridge. The default is true.
## Web Config
Configure by going to the url for the host you are running on or localhost with port you have assigned:
```
http://192.168.1.240:8080
http://<ip address>:<port>
```
Command line configure
----
Register a device via REST by by using a tool and the url, for example:
## Command line configure
Register a device via REST by by using a tool and the url, for example:
```
POST http://host:8080/api/devices
{
@@ -46,9 +44,8 @@ POST http://host:8080/api/devices
"offUrl" : "http://192.168.1.201:3480/data_request?id=action&output_format=json&serviceId=urn:upnp-org:serviceId:SwitchPower1&action=SetTarget&newTargetValue=0&DeviceNum=41"
}
```
Dimming
----
Dimming is also supported by using the expessions ${intensity.percent} or ${intensity.byte} for 0-100 and 0-255 respectively.
## Dimming
Dimming is also supported by using the expessions ${intensity.percent} or ${intensity.byte} for 0-100 and 0-255 respectively.
e.g.
```
{
@@ -60,14 +57,13 @@ e.g.
```
See the echo's documentation for the dimming phrase.
POST/PUT support
-----
## POST/PUT support
added optional fields
* contentType (currently un-validated)
* httpVerb (POST/PUT/GET only supported)
* contentBody your post/put body here
This will allow control of any other application that may need mroe then GET.
This will allow control of any other application that may need more then GET.
e.g:
```
{
@@ -80,7 +76,7 @@ e.g:
"contentBody" : "{\"fooBar\":\"baz\"}"
}
```
Anything that takes an action as a result of an HTTP request will probably work - like putting Vera in and out of night mode:
Anything that takes an action as a result of an HTTP request will probably work - like putting Vera in and out of night mode:
```
{
"name": "night mode",
@@ -89,10 +85,9 @@ Anything that takes an action as a result of an HTTP request will probably work
"onUrl": "http://192.168.1.201:3480/data_request?id=lu_action&serviceId=urn:micasaverde-com:serviceId:HomeAutomationGateway1&action=SetHouseMode&Mode=3"
}
```
Ask Alexa
----
After this Tell Alexa: "Alexa, discover my devices"
## Ask Alexa
After this Tell Alexa: "Alexa, discover my devices"
Then you can say "Alexa, Turn on the office light" or whatever name you have given your configured devices.
Then you can say "Alexa, Turn on the office light" or whatever name you have given your configured devices.
To view or remove devices that Alexa knows about, you can use the mobile app Menu / Settings / Connected Home
To view or remove devices that Alexa knows about, you can use the mobile app Menu / Settings / Connected Home