FAQ
TL;DR: In Jan 2024, a firmware fix added Bridge toggle support; "Please update and retry." If OpenBK appears frozen after SetStartValue, verify pins and check TX2 logs. [Elektroda, p.kaczmarek2, post #20906548]
Why it matters: This FAQ helps OpenBK users on BK7231N TOB9-63M resolve boot issues and restore button control after startup changes.
Quick Facts
- Tested firmware noted: OpenBK7231N_QIO_1.17.391 on a TOB9-63M smart switch. [Elektroda, Exkilla, post #20895551]
- Example startup backlog uses UTC+2 and a 60‑second energy window (SetupEnergyStats 1 60 5). [Elektroda, Exkilla, post #20896946]
- UART debugging via TX2 showed GEN:17 key_short_press button events. [Elektroda, Exkilla, post #20904666]
- Fix merged: Btn_Tgl_All now also toggles BridgeForward/Reverse; update firmware to enable the physical button. [Elektroda, p.kaczmarek2, post #20906548]
- Hardware uses a bistable (latching) relay; avoid mapping as standard Relay to prevent heating. [Elektroda, Exkilla, post #20906463]
Why does my TOB9-63M seem to freeze after adding SetStartValue to startup?
It often still boots, but the pin assignment can reset after a startup command change. That leaves controls unassigned, so the UI appears dead. Confirm activity over TX2, then reapply pin roles to restore control. Reconfigure LED, button, and bridge coil pins if they cleared. [Elektroda, Exkilla, post #20897368]
How can I recover if OpenBK won’t boot after a startup script change?
Use the project flasher’s option to clear the command line, then reboot. If the board still misbehaves, reflash OpenBK and reconfigure pins from scratch. This removes a bad startup command that can block normal initialization. [Elektroda, p.kaczmarek2, post #20896962]
How do I capture OpenBK debug logs on this device?
Use the TX2 UART output to see boot and button events. "Ok, so what does the debug log output on TX2 say?" Follow that hint: attach a USB‑UART to TX2, open a console, and power cycle to read logs. 1) Connect TX2. 2) Open serial console. 3) Reboot and observe. [Elektroda, p.kaczmarek2, post #20897089]
Why doesn’t the physical button toggle even though the web Toggle works?
Earlier builds only toggled Relay roles, so Btn_Tgl_All ignored Bridge coils. The maintainer merged a fix to include BridgeForward/Reverse. Update to a newer build and retest. "Please update and retry." After updating, button toggling works with bistable relays. [Elektroda, p.kaczmarek2, post #20906548]
What pin roles should I assign for a bistable relay on TOB9-63M?
Map the coils to BridgeFWD and BridgeREV, and the front button to Btn_Tgl_All. Example mapping seen: LED on pin 9, WifiLED on 15, Btn_Tgl_All on 17, BridgeFWD on 24, BridgeREV on 26. With the fix, Btn_Tgl_All will toggle the bridge channels. [Elektroda, Exkilla, post #20897368]
Is it safe to map a bistable relay as a standard Relay?
No. The device uses a latching (bistable) relay. Mapping it as a normal Relay can drive a coil continuously and cause heating. Keep roles as BridgeForward/BridgeReverse for safe operation. [Elektroda, Exkilla, post #20906463]
Can I avoid SetStartValue and still set power state on boot?
Yes. Use a script line with setChannel to initialize the desired state, or configure this via the GUI. The maintainer recommended setChannel as a simpler, safer alternative to SetStartValue. [Elektroda, p.kaczmarek2, post #20896320]
Which OpenBK build contains the Bridge toggle fix for the button?
A fix was applied by the maintainer in mid‑January 2024. Update to a newer OpenBK build than that date to include Btn_Tgl_All support for Bridge roles. [Elektroda, p.kaczmarek2, post #20906548]
What do these log lines mean: Button_OnInitialPressDown and key_short_press?
They indicate the firmware detected a valid button event. The sample shows GEN:17, meaning channel 17 received a short press. If nothing toggles afterward, your mapping or toggle logic is wrong. Update firmware or correct pin roles. [Elektroda, Exkilla, post #20904666]
My device looks bricked, but stock Tuya firmware works. What does that indicate?
Hardware is fine. Your OpenBK configuration is mis-set or incompatible. Restore OpenBK with clean settings, then correctly remap pins. You can also keep Tuya stock if you prefer stability. [Elektroda, Exkilla, post #20895551]
What tool should I use to flash or reset a BK7231N device?
BK7231Flasher successfully wrote OpenBK in this case. If the device still fails after flashing, revisit your configuration or restore your Tuya backup to regain function. [Elektroda, Exkilla, post #20896988]
How should I configure NTP and energy stats on OpenBK for this device?
An example backlog sets NTP server 217.147.223.78, timezone offset 2, starts BL0942, then SetupEnergyStats 1 60 5. The 60 denotes a 60‑second energy statistics window. Adjust these to your region and reporting needs. [Elektroda, Exkilla, post #20896946]
Edge case: It boots but the UI seems dead. How can I confirm and fix it?
Connect to TX2 and check the console. If logs show normal boot, your pins likely reset. Reassign LED, button, and Bridge roles via console or web once reachable. The device should resume normal control. [Elektroda, Exkilla, post #20897368]
