Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teverett/hsmqtt
A Java MQTT bridge for the HomeSeer JSON API
https://github.com/teverett/hsmqtt
home-automation homeseer mqtt
Last synced: 28 days ago
JSON representation
A Java MQTT bridge for the HomeSeer JSON API
- Host: GitHub
- URL: https://github.com/teverett/hsmqtt
- Owner: teverett
- License: bsd-3-clause
- Created: 2020-07-14T23:20:19.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-03-19T01:39:00.000Z (9 months ago)
- Last Synced: 2024-11-15T19:58:25.312Z (about 1 month ago)
- Topics: home-automation, homeseer, mqtt
- Language: Java
- Homepage:
- Size: 108 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# HomeSeer hsMQTT
A Java [MQTT](https://en.wikipedia.org/wiki/MQTT) bridge for HomeSeer. msMQTT polls the HomeSeer API on a schedule and publishes device change messages to an MQTT Broker. Messages are published in JSON format.
hsMQTT is one of numerous HomeSeer support applications created by khubla.com, including
* [hsClient](https://github.com/teverett/hsclient)
* [hsInflux](https://github.com/teverett/hsinflux)
* [hsMQTT](https://github.com/teverett/hsOpenAPI)
* [hsOpenAPI](https://github.com/teverett/hsOpenAPI)
msMQTT uses [hsClient](https://github.com/teverett/hsclient)
## License
msMQTT is distributed under the BSD 3-Clause License.
## Configuration
msMQTT is configured via the file "hsmqtt.properties". A typical example is
```
# HomeSeer
hsurl=http://192.168.75.129/JSON
hsuser=HOMESEERUSERNAME
hspassword=HOMESEERPASSWORD
# MQTT
mqtturl=tcp://192.168.75.71:1883
mqtttopic=devices
mqttpublisherid=hsMQTT
# Number of threads to poll HomeSeer on
pollingthreads=5
# minutes
pollinginterval=1
```
## Example message
```json
{"deviceRef":107,"value":0.0,"lastChange":1594530001541,"location":"Living Room","location2":"Main Floor","name":"Living Room Dimmer","status":"Off","type":"Z-Wave Switch"}
```
## Usage
```
java -jar target/hsmqtt-1.0.0-SNAPSHOT.jar
```
A log file is generated to hsmqtt.log and rotated every 30 days.