MQTT client reporting measurements of FT017TH wireless thermo/hygrometers
Project description
wireless-sensor-mqtt 🌡
MQTT client reporting measurements of FT017TH wireless thermo/hygrometers
Requirements
- MQTT broker
- FT017TH sensor
- CC1101 transceiver
- Linux machine with CC1101 connected to SPI port (wiring instructions for raspberry pi)
Setup
$ pip3 install --user --upgrade wireless-sensor-mqtt
Usage
$ wireless-sensor-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS \
--mqtt-topic-prefix MQTT_TOPIC_PREFIX
Measurements will be published on topics
MQTT_TOPIC_PREFIX/temperature-degrees-celsius
and MQTT_TOPIC_PREFIX/relative-humidity-percent
(e.g., living-room/temperature-degrees-celsius
with --mqtt-topic-prefix living-room
).
Add --debug
to get debug logs.
MQTT via TLS
TLS is enabled by default.
Run wireless-sensor-mqtt --mqtt-disable-tls …
to disable TLS.
MQTT Authentication
wireless-sensor-mqtt --mqtt-username me --mqtt-password secret …
# or
wireless-sensor-mqtt --mqtt-username me --mqtt-password-file /var/lib/secrets/mqtt/password …
Home Assistant 🏡
Home Assistant will detect two new sensors automatically, if connected to the same MQTT broker and MQTT discovery is enabled (enabled by default since version 0.117.0).
When using a custom discovery_prefix
, run wireless-sensor-mqtt --homeassistant-discovery-prefix custom-prefix …
.
Docker 🐳
Pre-built docker images are available at https://hub.docker.com/r/fphammerle/wireless-sensor-mqtt/tags
$ sudo docker run --name wireless_sensor_mqtt \
--device /dev/spidev0.0 fphammerle/wireless-sensor-mqtt \
wireless-sensor-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS …
Optionally add --read-only --cap-drop ALL --security-opt no-new-privileges
before image specifier.
Annotation of signed tags docker/*
contains docker image digests: https://github.com/fphammerle/wireless-sensor-mqtt/tags
Docker Compose 🐙
- Clone this repository.
- Edit
docker-compose.yml
. sudo docker-compose up --build
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for wireless-sensor-mqtt-0.3.0a2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c41e0dfcdb5d4290cb7ff5f97abae0e94c7f0f5d7c687fc03ccf290e3191bc2e |
|
MD5 | 36287a94ee7cd50d9ca7a9bc8672ce47 |
|
BLAKE2b-256 | 99947061db79e3b5eea60512f5f3ee996567910db9d203fd61a0a8cb82d8305b |
Hashes for wireless_sensor_mqtt-0.3.0a2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2b59d165f941534c156351c0807561b5bc91723f20721946c906290f4af0aaab |
|
MD5 | 785cb1030a864a9b22c82b4e8d0400b7 |
|
BLAKE2b-256 | 988487e136fe2bd3e7705b548e850b6479820d948a9ff05145878a0ab29a1ea2 |