#raspberry-pi #mqtt #homie

app applehat

Service to use a Rainbow HAT on a Raspberry Pi to show sensor data from Homie

1 unstable release

0.1.0 Jan 18, 2023

#6 in #homie

MIT/Apache

165KB
3.5K SLoC

Applehat

crates.io page

applehat is a service to use a Rainbow HAT on a Raspberry Pi to show data from sensors on an MQTT broker following the Homie convention.

Installation

It is recommended to install the latest released Debian package from our releases.

Alternatively, you may install with cargo install, but that will require some more setup:

$ cargo install applehat

Usage

There should be a config file under /etc/applehat:

  • applehat.toml contains the main configuration for the service, such as which MQTT broker to connect to. See applehat.example.toml for an example of the settings that are supported.

After editing these config files you will need to restart the service:

$ sudo systemctl restart applehat.service

You may find it helpful to watch the logs to see whether it is managing to connect:

$ sudo journalctl -u applehat.service --output=cat --follow

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~17–30MB
~541K SLoC