MCH2022 badge?
go to

Git revision: 6dc7c4056f3219d1e1eb99067a883e99b9400c6d homeassistant-cz20-badge rev. 21 (by Jeroen)


Connect cz2020 badge from to home-assistant as binary sensor and rgb light.

16 buttons and lights are automatically detected by homeassistant using MQTT. Button numbers are from 0 to 15 github


Make sure to put the correct settings in the app settings menu of Set the server ip of the mqtt server of homeassistant (usually the same ip as your homeassistant). Optionally set the port, username and password. Make sure MQTT and autodiscovery are enabled in your homeassistant config. Choose any device name for the device (default: cz2020) and optionally change the discovery prefix.

Startup sequence

On startup, all keys turn red. The first row turns orange when starting connect to wifi, and to green if wifi connection was successful. The second row turns orange when connecting to the mqtt server, and to green if connected successful. If the second doesn't turn green, check the mqtt server address in the settings of The third and fourth row turn orange when starting programming of homeassistant and setting all states to available, and green on success.


In the homeassistant website, navigate to 'Configuration' and click 'Devices". <device_name> (default: cz2020), should show in the list of devices. Click it to view the states of all 16 buttons and their light. Add automations based on button presses. Use the trigger 'Duration' to program long-presses of the buttons.


Basic structure based on: Light structure based on:

Category: utility
Status: working
Vote Comment Date
No votes yet :(
  • CampZone 2020: working
  • No dependencies found
  • No dependants found
Author: Jeroen

File Last edited Size 2021-05-02 14:01:33 1.76 KiB 2021-05-02 14:01:33 8.18 KiB