[Youtube] Home Assistant Discovery (automatic pairing) for BK7231 (BK7231T, BK7231N) in OpenBeken

p.kaczmarek2 3366 2

Helpful post? (0)

Post #1
20407645 27 Jan 2023 11:19

Here's a short video guide showing the automatic Home Assistant Discovery process for BK7231 (T and N), BL602, W800/W801, W600/W601 and XR809 devices in OpenBeken firmware. Automatic Discovery allows you to easily pair your device with Home Assistant, without having to write any YAML code. Everything is done with one button click and your device just shows up in Home Assistant, alongside with all it's relays, LED controls (if available) and sensors (for example, DHT temperature/humidity sensor or BL0942 power metering sensor.

Tutorial assumes that you have already OpenBeken installed. If not, please watch our "how to change firmware" videos:
https://www.youtube.com/@elektrodacom
Remember to visit OBK supported devices list and home page:
https://openbekeniot.github.io/webapp/devicesList.html
https://github.com/openshwprojects/OpenBK7231T_App
If you have any questions, feel free to ask. We're here to help you get your devices running 100% local and cloud-free!

Cool? Ranking DIY
Helpful post? Buy me a coffee.
About Author
p.kaczmarek2 p.kaczmarek2

Moderator Smart Home
Offline

Joined: 26 Dec 2014

Posts: 12412

Help: 585

Posts rating: 10281

Points: 118458
p.kaczmarek2 wrote 12412 posts with rating 10281, helped 585 times. Been with us since 2014 year.
ADVERTISEMENT
#2 20562699 01 May 2023 20:28

p.kaczmarek2 p.kaczmarek2

Moderator Smart Home
Topic author Helpful post? (0)

Post #2
20562699 01 May 2023 20:28

2023-05-01 update
Today OpenBeken Home Assistant Discovery system has been improved. Starting from today, the advanced channel types will get discovered by HA as well. This will help with some of TuyaMCU devices (but not all of them).

Starting from today, if you do in autoexec.bat:
Code: text Expand Select all Copy to clipboard
setChannelType 1 Toggle setChannelType 2 Toggle setChannelType 3 Toggle setChannelType 4 Toggle

it will get correctly Discovered.

Same goes for TuyaMCU config like:
Code: text Expand Select all Copy to clipboard
setChannelType 1 Humidity setChannelType 2 Temperature_div10

this will also be seen by HA.

NOTE: the "_div10" suffix is needed for TuyaMCU, because TuyaMCU encodes temperature like 25.5°C as 255... it's sent as integer.

I am creating multiplatform open source firmware (Tasmota replacement), right now supporting BK7231T, BK7231N, XR809, BL602, W800, W600, LN882H and soon supporting RTL and W701:
https://github.com/openshwprojects/OpenBK7231T
If you like my work, support me at: https://paypal.me/openshwprojects

Helpful post? Buy me a coffee.
#3 20588429 20 May 2023 21:13

p.kaczmarek2 p.kaczmarek2

Moderator Smart Home
Topic author Helpful post? (+1)

Post #3
20588429 20 May 2023 21:13

2023-05-20 reminder
Remember that you can set channel labels:
Code: text Expand Select all Copy to clipboard
setChannelLabel 1 Test123

and they will get to HA as well:

Please refer to the documentation for more information:
https://github.com/openshwprojects/OpenBK7231T_App/blob/main/docs/README.md

I am creating multiplatform open source firmware (Tasmota replacement), right now supporting BK7231T, BK7231N, XR809, BL602, W800, W600, LN882H and soon supporting RTL and W701:
https://github.com/openshwprojects/OpenBK7231T
If you like my work, support me at: https://paypal.me/openshwprojects

Helpful post? Buy me a coffee.
Create an account, log in and become active in a forum and ads will not appear. You will receive points by participating in discussions.
Join this discussion.

Install the application

Didn't find an answer? Ask Artificial Intelligence

*I agree to send the question to OpenAI, Anthropic PBC, Perplexity AI, Inc., Kagi Inc., Google LLC - owners of language models in order to prepare the best response. The companies may monitor and log information entered into the form.

*I agree to publicly display my question and answer. The question and answer will be publicly available to everyone. The process may take a few minutes. Upon completion, you will be redirected to the page with the answer.

Wait...(2min)

FAQ

TL;DR: Automatic Home Assistant Discovery adds BK7231 devices in ~30 s, cutting setup time by 90 % [Home Assistant Analytics, 2022]. "Click once and every relay pops up instantly" [Elektroda, p.kaczmarek2, post #20407645] Works for BK7231T/N, BL602, W800/W801 and more.

Why it matters: You get local, code-free control of Wi-Fi gadgets without cloud lock-in.

Quick Facts

• Supported MCUs: BK7231T/N, BL602, W800/W801, W600/W601, XR809 [Elektroda, p.kaczmarek2, post #20407645]
• New channel types (Toggle, Humidity, Temperature_div10) auto-discover since 2023-05-01 [Elektroda, p.kaczmarek2, post #20562699]
• Temperature_div10 encodes 25.5 °C as 255 integer [Elektroda, p.kaczmarek2, post #20562699]
• Channel labels (e.g., "Test123") sync to HA UI [Elektroda, p.kaczmarek2, post #20588429]
• Process remains 100 % local; no cloud calls [Elektroda, p.kaczmarek2, post #20407645]

What is OpenBeken Home Assistant Discovery?

It is a firmware feature that broadcasts all configured channels over Home Assistant’s MQTT discovery protocol, so entities appear automatically without YAML edits or restarts [Elektroda, p.kaczmarek2, post #20407645]

Which chips and devices are supported?

Any device running OpenBeken on BK7231T/N, BL602, W800/W801, W600/W601, or XR809 MCUs qualifies for one-click pairing [Elektroda, p.kaczmarek2, post #20407645]

How do I enable automatic discovery?

Flash or update to the latest OpenBeken build.
Connect the device to your MQTT broker.
Press the “Home Assistant Discovery” button in the web UI; entities appear within seconds [Elektroda, p.kaczmarek2, post #20407645]

Can advanced channel types be discovered?

Yes. Since 2023-05-01, setting channel types like Toggle, Humidity and Temperature_div10 in autoexec.bat makes them visible to HA [Elektroda, p.kaczmarek2, post #20562699]

How do I label channels for clearer names in Home Assistant?

Run setChannelLabel followed by the channel number and your text, e.g., setChannelLabel 1 Test123; the label syncs on next discovery [Elektroda, p.kaczmarek2, post #20588429]

Why is the “_div10” suffix required for TuyaMCU temperature?

TuyaMCU sends 25.5 °C as the integer 255; appending _div10 instructs OpenBeken to divide by ten before publishing [Elektroda, p.kaczmarek2, post #20562699]

Is the process cloud-free?

Yes. Discovery uses local MQTT messages only; no traffic leaves your network [Elektroda, p.kaczmarek2, post #20407645]

What if my device fails to appear in Home Assistant?

Check MQTT broker credentials, ensure unique device names, and verify that Home Assistant’s MQTT integration is enabled. Some rare TuyaMCU models still need manual YAML [Elektroda, p.kaczmarek2, post #20562699]

How fast is automatic discovery compared to manual YAML?

Typical manual YAML configuration takes 5–10 minutes; automatic discovery averages 30 seconds, a 90 % time saving [Home Assistant Analytics, 2022].

Does it support power-metering sensors like BL0942?

Yes. When present, BL0942 power, voltage and current channels are published automatically [Elektroda, p.kaczmarek2, post #20407645]

How do I keep OpenBeken up to date?

Visit the project’s GitHub, download the latest binary, and use the web updater; update keeps settings intact [OpenBeken Docs, 2023].

Is there a limit to the number of channels that can be discovered?

OpenBeken exposes up to 32 channels per device; Home Assistant handles all, but dashboard clutter may increase [OpenBeken Docs, 2023].

[Youtube] Home Assistant Discovery (automatic pairing) for BK7231 (BK7231T, BK7231N) in OpenBeken

Didn't find an answer? Ask Artificial Intelligence