NiceMCU XH-WB3S BK7238 Flashing, Testing, Pinout, Development, Porting

divadiow 8460 244

#241 21641874 22 Aug 2025 23:48

insmod insmod

Level 26
Helpful post? (0)

Post #241
21641874 22 Aug 2025 23:48

>>21641862
Yes, see https://github.com/openshwprojects/OpenBK7231T_App/issues/1769

Added after 1 [hours] 42 [minutes]:

3.0.78 builds
https://github.com/NonPIayerCharacter/OpenBK7231T_App/actions/runs/17167633393
Used BK7231N wpa supplicant for BK7231U/T and BK7252.
BK7231T works with it.
Last release - 510kb. This one - 497kb
Removed wolfssl dependency from original libs with ar -d
Size increased by 1792 bytes, but there would be no hidden surprises that way.
A bug i've seen - on every seconds timer triggered several times instantly during OTA
Code: text Expand Select all Copy to clipboard
Info:MAIN:Time 2021, idle 142052/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2022, idle 116612/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2023, idle 1698/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2024, idle 1315/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2025, idle 98963/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2026, idle 135908/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24 Info:MAIN:Time 2027, idle 136134/s, free 88000, MQTT 0(105), bWifi 1, secondsWithNoPing -1, socks 3/24

Added after 9 [minutes]:

@divadiow
There is a 'bug' in your beken_freertos_sdk_release repo.
Since you probably just unpacked newer version on top of the older one (like i did for mine), some files that were deleted/moved remained.
I've had build error with BK7252, because audio_pub.h was in two folders at once, and older version was included.
Older: https://github.com/divadiow/beken_freertos_sd...blob/3.0.78/beken378/driver/audio/audio_pub.h
Latest: https://github.com/divadiow/beken_freertos_sd...ob/3.0.78/beken378/driver/include/audio_pub.h
ADVERTISEMENT
#242 21642035 23 Aug 2025 08:22

divadiow divadiow

Level 35

Topic author Helpful post? (0)

Post #242
21642035 23 Aug 2025 08:22

insmod wrote:
There is a 'bug' in your beken_freertos_sdk_release repo.
Since you probably just unpacked newer version on top of the older one (like i did for mine), some files that were deleted/moved remained.

damn yes. I was after a nice way to see the differences between versions but actually the correct way would have been to delete the lot between branches? Hmm.

Added after 57 [minutes]:

Anyway, anything caught your interest in .78 vs .76?
ADVERTISEMENT
#243 21642058 23 Aug 2025 08:33

insmod insmod

Level 26

Helpful post? (0)

Post #243
21642058 23 Aug 2025 08:33

>>21642035
It became possible to use mbedtls exclusively (without wolfssl) on BK7231U/T and BK7252.
That reduced binary size significantly.
Plus an idea came to me to play with mbedtls config. I removed some unneeded things to cut binary size.
Plus i tried mbedtls 2.27.0 (default is 2.6.0). Binary size was increased some, but there were more free heap, + there were more idle cycles (?) (from 140-150k to ~170k).
ADVERTISEMENT
#244 21642253 23 Aug 2025 13:26

divadiow divadiow

Level 35

Topic author Helpful post? (0)

Post #244
21642253 23 Aug 2025 13:26

insmod wrote:
Plus fixed UART.

_3.0.78_72c0170f2c72

yay. maybe i can finish soil sensor
#245 21642257 23 Aug 2025 13:32

p.kaczmarek2 p.kaczmarek2

Moderator Smart Home

Helpful post? (0)

Post #245
21642257 23 Aug 2025 13:32

Great! @insmod , a question - I didn't do SSL on LWIP on any of the platforms yet, so far I only used HTTPS on ESP, but now I am wondering... would it be possible to move SSL to shared app, like you did with mqtt.c? I don't know currently how SSL is done under the hood, but isn't it just relying on LWIP raw TCP sockets, nothing more? Wouldn't it be possible to have SSL added to obk shared app once and have it working for all platforms (if enabled)?

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

Topic summary

The discussion centers on the NiceMCU XH-WB3S development board featuring the BK7238 SoC, initially suspected to be BK7231T but confirmed as BK7238. Users share experiences with flashing, testing, and porting firmware, including challenges with encryption keys, flash IDs, and bootloader compatibility. The BK7238 uses 2MB flash with varying encryption keys per chip, complicating universal firmware flashing. Tools like BKFIL and Easy Flasher (EF) are used for backup and restore, with EF supporting full flash erase and restore including bootloader. Flash ID support was extended to include missing flash chips to avoid CRC errors. Arduino SDK and Beken FreeRTOS SDK (version 3.0.70.1 and newer 3.0.76) are referenced for development, with partial support for BK7238 and related chips (BK7231N, BK7231U, BK7252). Porting efforts include adapting delay functions for 160MHz BK7238, resolving flashvars alignment issues due to 64-bit time_t, and addressing HTTP server and TCP socket stability problems in LWIP. OTA updates are functional but require correct image types and bootloader versions. Power save modes and their impact on peripherals like BL0937 energy meter and DS18B20 sensors are discussed, with some instability noted under power save. SPI flashing and UART flashing methods are compared, with SPI preferred for some devices. BK7231U (CC8000 chip) support is emerging, with builds available but some undefined references and boot issues. BK7252 camera module support is experimental, with encrypted flash complicating firmware use. Users report issues with DS18B20 sensor timing on BK7238 due to delay_us inaccuracies, partially fixed by new SDK delay implementations. Logging and MQTT load affect system stability and sensor reading consistency. The community shares flash dumps, toolchain links, and SDK forks to aid development and testing. Overall, the thread provides detailed technical insights into BK7238-based NiceMCU boards' flashing, SDK porting, peripheral support, and firmware development challenges and progress.
Summary generated by the language model.

Home page
/
Forum
/
Smart Home
/
Smart Home IoT
/
NiceMCU XH-WB3S BK7238 Flashing, Testing, Pinout, Development, Porting

FAQ

TL;DR: A NiceMCU XH-WB3S board (BK7238, 2 MB flash) can run OpenBeken if you erase the whole SPI and re-flash with a CRC-fixed 7238 image; boards cost ≈ US $1.50 each and need >300 mA during Wi-Fi start-up. “Boot loops usually mean undervoltage” [Elektroda, insmod, post #21562748]

Why it matters: Correct flashing and stable power prevent endless reboots and CRC errors.

Quick Facts

• Chipset: BK7238, ARM Cortex-M33, 160 MHz [Elektroda, divadiow, post #21440151]
• On-board flash: 2 MB (ID 0x852015) [Elektroda, divadiow, post #21289375]
• Dev-board price: US $1–1.5 on AliExpress [Elektroda, insmod, post #21327474]
• Recommended supply: 3.3 V @ ≥350 mA during TX bursts [*BK72xx DS*]
• Default UART: 115 200 bps on P0 (UART2) [Elektroda, divadiow, post #21442320]

Why do I get endless CRC-mismatch errors when flashing?

The GUI flasher lacked the Puya 25Q16HB (ID 0x152085) entry, so the chip stayed write-protected and every sector verify failed. Update to BK7231GUIFlashTool ≥v1.9.21 or add the ID manually, then erase and re-flash [Elektroda, p.kaczmarek2, post #21342531]

Which firmware file should I use for the XH-WB3S board?

Use OpenBK7238_QIO_x.xx.xx.bin (or the .rbl OTA file) because the module really contains a BK7238, not a BK7231 [Elektroda, DeDaMrAz, post #21542280]

The board reboots every few seconds—why?

A reboot loop with only the RT-Thread banner usually means the 3.3 V rail dips below 3.0 V when Wi-Fi starts. Provide a stable ≥350 mA source or add a 470 µF capacitor [Elektroda, insmod, post #21562748]

How do I force the bootloader to accept my image?

Check “Overwrite bootloader” in the GUI, flash the CRC-fixed QIO image, then reset. On BK7238 the bootloader sits at 0x0 and refuses un-CRC’d binaries [Elektroda, divadiow, post #21550671]

What is the “No TLV header found in flash” message?

It comes from the SDK’s RF-calibration code; the first boot notices that the RF OTP/TLV partition is empty, writes defaults, then continues. The notice is harmless [Elektroda, p.kaczmarek2, post #21564311]

Why does my custom MAC vanish after reboot?

BK7238 stores the MAC in the RF-OTP/TLV area. Current OpenBeken writes it to config only; on the 7238 it must be written with manual_cal_write_macaddr_to_flash(). Until patched, the chip reloads the factory MAC on cold boot [Elektroda, p.kaczmarek2, post #21564311]

How can I enter Safe-Config mode if AP never appears?

Press or toggle RESET five times within 5 s; the bootloader starts OBK in SafeConfig, creating AP “OpenBK_xxxxxx” even with invalid Wi-Fi data [Elektroda, divadiow, post #21550706]

Power-meter readings jump by 20 V—bug or feature?

Voltage spikes on BL0937 driver occur when heavy logging or MQTT runs. Disable verbose logs (loglevel 0) or MQTT to stabilise readings [Elektroda, insmod, post #21520958]

Fast-Connect flag—what does it do?

FastConnect 1 skips full scan and uses stored BSSID/PSK. It cuts connect time from ≈3 s to 300 ms and saves ≈80 mA∙s per wake-up [Elektroda, insmod, post #21507260]

I only see garbage on UART—correct pins?

UART2 TX (module P0) outputs OBK logs at 115 200 bps. Connect RX of your adapter to P0, 3.3 V tolerant [Elektroda, divadiow, post #21550104]

Edge case: What if I flashed a BK7231 image to BK7238?

The chip shows only the bootloader banner and reboots; re-flash the correct 7238 QIO binary or full 2 MB dump via SPI [Elektroda, divadiow, post #21342237]

3-step How-To: Recover a soft-bricked XH-WB3S

Erase full 0-0x1FFFFF with BKFIL (SPI needed if UART locked). 2. Flash OpenBK7238_QIO_x.bin at 0x0 with “Overwrite bootloader”. 3. Reset; join AP and finish setup—done.