Skip to content

Generic - RTL8710BX (4M/980k)

by Generic - product page

Information  
Board code generic-rtl8710bx-4mb-980k
MCU Realtek RTL8710BX
Series AmebaZ
Partition layout Large Custom (2x 980k apps)
Specifications  
Frequency 62.5 MHz
Flash size 4 MiB
RAM size 256 KiB
Voltage 3.0V - 3.6V
I/O 17x GPIO, 6x PWM, 2x UART, 1x ADC
Wi-Fi 802.11 b/g/n

Usage

Board code: generic-rtl8710bx-4mb-980k

In platformio.ini:

[env:generic-rtl8710bx-4mb-980k]
platform = libretiny
board = generic-rtl8710bx-4mb-980k
framework = arduino

In ESPHome YAML:

rtl87xx:
  board: generic-rtl8710bx-4mb-980k

Quick flashing guide

Pin Connection
PA29 / RX2 TX of USB-UART adapter
PA30 / TX2 RX of USB-UART adapter
PA29 (strapping pin) GND to enter download mode
CEN (Chip-Enable) GND to reset the chip
  1. Connect the USB-UART adapter.
  2. Connect PA29 (TX2) to GND.
  3. Power-cycle the device or briefly short CEN to GND.
  4. Disconnect PA29 from GND, keep connected to USB-UART.
  5. Start the flashing process.

Pin functions

Name(s) UART I²C SPI PWM Other
PA00 PWM2
PA05 PWM4
PA06 FCS
PA07 FD1
PA08 FD2
PA09 FD0
PA10 FSCK
PA11 FD3
PA12 PWM3
PA14 PWM0 SWCLK
PA15 PWM1 SWDIO
PA18 RX0 SCL1 SCK0, SCK1
PA19, ADC1 CTS0 SDA0 CS0, CS1
PA22 RTS0 SCL0 MISO0, MISO1 PWM5
PA23 TX0 SDA1 MOSI0, MOSI1 PWM0
PA29 RX2 SCL0 PWM4
PA30 TX2 SDA0 PWM4

Flash memory map

Flash size: 4 MiB / 4,194,304 B / 0x400000

Hex values are in bytes.

Name Code Start Length End
Boot XIP boot_xip 0x000000 16 KiB / 0x4000 0x004000
Boot RAM boot_ram 0x004000 16 KiB / 0x4000 0x008000
(reserved) - 0x008000 4 KiB / 0x1000 0x009000
System Data system 0x009000 4 KiB / 0x1000 0x00A000
Calibration calibration 0x00A000 4 KiB / 0x1000 0x00B000
OTA1 Image ota1 0x00B000 980 KiB / 0xF5000 0x100000
OTA2 Image ota2 0x100000 980 KiB / 0xF5000 0x1F5000
LibreTiny Storage kvs 0x1F5000 32 KiB / 0x8000 0x1FD000
User Data userdata 0x1FD000 2 MiB / 0x202000 0x3FF000
RDP rdp 0x1FF000 4 KiB / 0x1000 0x200000

Information

This is a generic board definition for RTL8710BX with 4 MiB of flash. It has a bigger application partition size (980 KiB). The used bootloader is also different from the standard Tuya one.

It can be found in Ezviz T31 smart plug - bare chip soldered onto the manufacturer-made PCB. The plug is not Tuya/SmartLife-compatible and has a 25Q32CSIG flash chip. Refer to libretiny#23 for photos and more information.

Note that stock firmware seems to use smaller app images (0x80000 / 512 KiB). After 0x180000 some product-test data and device logs can be found. Because the OTA2 offset is 0x100000, the board definition was configured to use all available space.