https://github.com/w-floyd/ha-mqtt-iot

A simple configurable MQTT client that allows actions to be taken or values be reported from a PC
https://github.com/w-floyd/ha-mqtt-iot

autodiscovery go golang ha home-assistant home-automation homeassistant iot mqtt

Last synced: 18 days ago
JSON representation

A simple configurable MQTT client that allows actions to be taken or values be reported from a PC

• Host: GitHub
• URL: https://github.com/w-floyd/ha-mqtt-iot
• Owner: W-Floyd
• License: mit
• Created: 2020-10-06T06:41:39.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2024-02-05T20:28:58.000Z (9 months ago)
• Last Synced: 2024-10-09T06:51:16.967Z (28 days ago)
• Topics: autodiscovery, go, golang, ha, home-assistant, home-automation, homeassistant, iot, mqtt
• Language: Go
• Homepage:
• Size: 1010 KB
• Stars: 41
• Watchers: 4
• Forks: 7
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# HomeAssistant MQTT IOT

## In need of a better name

A simple Golang program that allows commandline based MQTT entities.

It uses HomeAssistant MQTT autodiscovery, thinly wrapping all of the native json fields for each object, handling topic creation, subscription, updating, and so on.

See `sample.config.json` and `sample.secrets.json` for examples.

Run `./ha-mqtt-iot -help` for help.

## Automatic Code Generation

Most of this tool is automatically generated from the Home Assistant documentation.

As such, should this documentation change, the code may be regenerated using `go generate`, or `go run ./helpers/generate`.

If this has been run before, clear the cache found in `./helpers/generate/cache/`.

## Writing new configs

View the sample config for examples.

Most fields are inherited from the Home Assistant documentation, but to double check one can check the `./devices/internaldevice/*.go` files for the struct.

The program will fail on finding unknown fields.