intertechno-cc1101-mqtt

MQTT client controlling Intertechno Outlets via a CC1101 Transceiver

Compatible with Home Assistant's MQTT Switch platform.

Requirements

MQTT broker
Intertechno smart outlet
CC1101 transceiver
Linux machine with CC1101 connected to SPI port (wiring instructions for raspberry pi)

Setup

$ pip3 install --user --upgrade git+https://git.hammerle.me/fphammerle/intertechno-cc1101-mqtt

On Raspbian / Raspberry Pi OS, dependencies can optionally be installed via:

$ sudo apt-get install --no-install-recommends python3-spidev python3-paho-mqtt

Usage

$ intertechno-cc1101-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS

Send ON or OFF to topic intertechno-cc1101/[ADDRESS]/[BUTTON_INDEX]/set.

$ mosquitto_pub -h MQTT_BROKER -t intertechno-cc1101/12345678/0/set -m ON

⚠️ Support for TLS is not implemented yet. Do not connect to brokers via unprotected networks (e.g., internet, wifi network).

Aliases

$  intertechno-cc1101-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS --alias-file aliases.json

with aliases.json:

{"some-name": {"address": 12345678, "button-index": 0},
"another-name": {"address": 12345678, "button-index": 1},
"another_address": {"address": 21420815, "button-index": 0}}

Send ON or OFF to topic intertechno-cc1101/[ALIAS]/set.

$ mosquitto_pub -h MQTT_BROKER -t intertechno-cc1101/some-name/set -m ON

Home Assistant 🏡

Automatic Discovery

Home Assistant will detect devices specified in --alias-file aliases.json automatically, if connected to the same MQTT broker and MQTT discovery is enabled (enabled by default since version 0.117.0).

Manual Configuration

# https://www.home-assistant.io/docs/mqtt/broker/#configuration-variables
mqtt:
  broker: BROKER_HOSTNAME_OR_IP_ADDRESS
  # credentials, additional options…

# https://www.home-assistant.io/integrations/switch.mqtt/#configuration-variables
switch:
- platform: mqtt
  name: intertechno_smart_outlet
  command_topic: intertechno-cc1101/12345678/0/set
  # http://materialdesignicons.com/
  icon: mdi:light-switch

Docker 🐳

$ sudo docker build -t intertechno-cc1101-mqtt .
$ sudo docker run --name intertechno_cc1101_mqtt \
    --read-only --cap-drop ALL --security-opt no-new-privileges \
    --device /dev/spidev0.0 intertechno-cc1101-mqtt \
    intertechno-cc1101-mqtt --mqtt-host HOSTNAME_OR_IP_ADDRESS …

Docker Compose 🐙

Clone this repository.
Adapt command in docker-compose.yml.
sudo docker-compose up --build

README.md 3.0 KB Histórico Raw