Release Notes for Wi-Fi General Firmware

Overview

The general firmware of Wi-Fi modules provides core functionalities such as module pairing and data communication. Based on a serial communication protocol, it enables your products to become smart quickly. To continuously enhance the capabilities of the general firmware and meet the latest security and compliance requirements, the firmware undergoes iterative upgrades. You should select the appropriate module and firmware version for product development based on your specific project needs.

WBR series module

• The WBRx series modules mainly include WBR1, WBR2, WBR3, WBR1-IPEX, and WBRU.

• General firmware: keyjkajwawthq4f5.

Release notes

Considerations

• v2.x.x firmware: Developed based on the CI framework, featuring more lenient MCU verification.
• v3.x.x firmware: Developed based on the OS framework, implementing stricter MCU verification. Consequently, cross-architecture OTA updates require careful assessment and should only be performed when absolutely necessary.
• If specific circumstances require an update from v2.x.x to v3.x.x, comprehensive testing is mandatory, including but not limited to pairing, device control, OTA functionality, and production testing. Refer to relevant documentation throughout this process.

CB series module

• The CB series modules mainly include CBU, CB3S, WT3, TCS905-3S, and TCS905-U.

• General firmware: key83r5jq9qqeaxt.

Version description

Considerations

• v2.x.x firmware: Developed based on the CI framework, featuring more lenient MCU verification.
• v3.x.x firmware: Developed based on the OS framework, implementing stricter MCU verification. Consequently, cross-architecture OTA updates require careful assessment and should only be performed when absolutely necessary.
• If specific circumstances require an update from v2.x.x to v3.x.x, comprehensive testing is mandatory, including but not limited to pairing, device control, OTA functionality, and production testing. Refer to relevant documentation throughout this process.

Combo module

• The combo series modules mainly include WBR3D, WBR2D, WBR1D, and WBR1D-IPEX.
• General firmware: keyukmh93ew3retr.

Version description

Considerations

• v2.x.x firmware: Developed based on the CI framework, featuring more lenient MCU verification.
• v3.x.x firmware: Developed based on the OS framework, implementing stricter MCU verification. Consequently, cross-architecture OTA updates require careful assessment and should only be performed when absolutely necessary.
• If specific circumstances require an update from v2.x.x to v3.x.x, comprehensive testing is mandatory, including but not limited to pairing, device control, OTA functionality, and production testing. Refer to relevant documentation throughout this process.

Technical architectures

The primary distinction between the new OS build architecture and the legacy CI build architecture for the MCU general firmware is the addition of I/O validity checks, which can significantly improve initialization success rates. Example:

• The module processes network events itself in working mode query command (0x02): the GPIO pins used to indicate Wi-Fi status, reset the Wi-Fi network, and indicate Bluetooth LE status.
• The infrared (IR) I/O pin in the product information query command (0x01).
• Commands must be proactively sent only after module initialization is completed (sequence: 0x00 -> 0x01 -> 0x02 -> [0x03]).
• Disabled Wi-Fi Easy Connect (EZ) pairing.

MCU serial communication considerations

• Do not proactively send heartbeat commands after a reset. This forces the module into production test mode, blocking normal reset functionality.
• Avoid continuously sending the response to the initial heartbeat (0x00). Doing so might trigger other proactive commands and cause exceptions.
• During baud rate detection, a response must be sent within 500 ms after receiving a heartbeat probe frame. Otherwise, the baud rate cannot be locked.