The announcement of the ultra-low cost ARM based Realtek RTL8710 WiFi modules for IoT applications generated quite a lot of buzz since they can potentially compete with the popular ESP8266 modules. The main problem at the time was documentation and software support, but after some searches we could find that RTL8710 was part of Realtek Ameba family, and found some documents and an SDK for RTL8710/RTL8711/RTL8195. ICStation also kindly provided one B&T RTL-00 module for review, which costs $3.55 shipped per unit, and as low as $2.85 if you purchase 10 or more.
The question here is how to get started? The answer can be found in page 8 of the Chinese datasheet for the module with GB0 and GB1 pins used for Tx and Rx to access the serial console. Time for some soldering…
For the first test, we’ll just need Tx (GB1), Rx (GB0), GND and 3.3V, and cut breadboard wires to give me the flexibility to use it with a breadboard just in case.
Now you need to connect the module to a USB to TTL debug board with all four pins connected since it will also provide power.
Insert the debug board into a USB port of your computer, and setup a serial connection @ 38400 8N1 using minicom, screen, putty, or other serial capable app. I struggled to get the full boot, until I found ATSR command would reboot the board:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 |
[B&T_IOT_RTL8710]#ATSR ========================================================= ROM Version: 0.3 Build ToolChain Version: gcc version 4.8.3 (Realtek ASDK-4.8.3p1 Build 2003) ========================================================= Check boot type form eFuse SPI Initial Image1 length: 0x3704, Image Addr: 0x10000bc8 Image1 Validate OK, Going jump to Image1 ===== Enter Image 1 ==== load NEW fw 0 Flash Image2:Addr 0xb000, Len 321412, Load to SRAM 0x10006000 No Image3 Img2 Sign: RTKWin, InfaStart @ 0x10006079 ===== Enter Image 2 ==== [B&T_IOT_RTL8710] ###################### #################### ######################## [B&T_IOT_RTL8710] # # # # # # [B&T_IOT_RTL8710] # ################ # # # ################## ######### ######### [B&T_IOT_RTL8710] # # # # # # # # [B&T_IOT_RTL8710] # # # # # # # # [B&T_IOT_RTL8710] # # # # # # # # [B&T_IOT_RTL8710] # # # # # # # # [B&T_IOT_RTL8710] # ################ # # # # # [B&T_IOT_RTL8710] # # # # # # [B&T_IOT_RTL8710] # ################## # ####### # # # [B&T_IOT_RTL8710] # # # # # # # # [B&T_IOT_RTL8710] # # # # # ####### # #### # # [B&T_IOT_RTL8710] # # # # # # # # # # # # [B&T_IOT_RTL8710] # # # # # # # # # # # # [B&T_IOT_RTL8710] # # # # # # # # # # # # [B&T_IOT_RTL8710] # ################ # # ########## ##### # # # [B&T_IOT_RTL8710] # # # # # # [B&T_IOT_RTL8710] ####################### ##################### ######## [B&T_IOT_RTL8710] ######### Company website&Support&Forum link: http://www.iot-tech-now.com/ ############## [B&T_IOT_RTL8710] ######### CHECK FIREWARM SUCCESS !!! ############## [B&T_IOT_RTL8710]# Initializing WIFI ... Start LOG SERVICE MODE RTL8195A[HAL]: ISR 81 had been allocated!!! WIFI initialized init_thread(50), Available heap 0xb160 Enter INTERACTIVE MODE # |
If you type help you’ll see some AT commands:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
[B&T_IOT_RTL8710]#help WLAN AT COMMAND SET: SET LOG OUTPUT MODE: 1. # ATSE=2(0: NO DEBUG,1:OUTPUT REMOTE UART, 2:LOCALE UART, DEFAULT MODE 1 ===========STA MODE================= 1. Wlan Scan for Network Access Point # ATWS 2. Set Wifi STA Mode # ATPW=1 3. Connect to an AES AP # ATPN=<ssid>,<pwd>,<key_id>(,<bssid>) ===========AP MODE================= 1. Set Wifi AP Mode # ATPW=2 2. Set AP parameter # ATPA=<ssid>,<pwd>,<chl>,<hidden> ===========TEST WIFI Status============== 5. View WIFI Status #ATW? 5. Ping #ATPP=xxxx.xxxx.xxxx.xxxx |
You can find the full AT command set in RTL8710 forums, and somehow it differs from the AT command set found in AN0025 Realtek at command.pdf application note available in Ameba Standard SDK.
Time to have some fun by trying to connect the board to my WiFi router:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 |
# ATWS [ATWS]: _AT_WLAN_SCAN_ [MEM] After do cmd, available heap 41056 2 Infra 94:0c:6d:e6:5b:10 -42 1 6 WPA/WPA2 AES 4 Infra d0:c7:c0:f9:eb:0f -46 11 6 WPA/WPA2 AES [B&T_IOT_RTL8710]#ATPW=1 [MEM] After do cmd, available heap 45296 [B&T_IOT_RTL8710]#ATPN=CNX-TRANSLATION,somepasswordhere RTL8195A[Driver]: set ssid [CNX-TRANSLATION] RTL8195A[Driver]: start auth to 94:0c:6d:e6:5b:10 RTL8195A[Driver]: auth success, start assoc RTL8195A[Driver]: association success(res=5) RTL8195A[Driver]: set pairwise key to hw: alg:4(WEP40-1 WEP104-5 TKIP-2 AES-4) RTL8195A[Driver]: set group key to hw: alg:2(WEP40-1 WEP104-5 TKIP-2 AES-4) key1 IP address : 192.168.0.110 [MEM] After do cmd, available heap 45128 [B&T_IOT_RTL8710]#ping 192.168.0.1 [ping_test] PING 192.168.0.1 120(148) bytes of data [ping_test] 128 bytes from 192.168.0.1: icmp_seq=1 time=7 ms [ping_test] 128 bytes from 192.168.0.1: icmp_seq=2 time=4 ms [ping_test] 128 bytes from 192.168.0.1: icmp_seq=3 time=4 ms [MEM] After do cmd, available heap 45128 # |
Success, and that was easy. Now AP mode….
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
# ATPW=2 [MEM] After do cmd, available heap 45296 [B&T_IOT_RTL8710]#ATPA=CNXSOFTRTL8710,wifiiot2,3,0 Writting boot mode 0x77665502 and Wi-Fi setting to flash ... LwIP_DHCP: dhcp stop. Deinitializing WIFI ... WIFI deinitialized Initializing WIFI ... WIFI initialized [MEM] After do cmd, available heap 45104 |
ATPA needs four arguments with ESSID,password (8 to 64 characters), channel, and hidden or not (1 or 0). I could now find the new access point with my phone, so I connected to it and typed the password. The serial console outputted the following during the connection:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
[B&T_IOT_RTL8710]# RTL8195A[Driver]: +OnAuth: 00:08:22:47:0c:1c RTL8195A[Driver]: +OnAssocReq RTL8195A[Driver]: ap mode 4-1 RTL8195A[Driver]: ap mode 4-2 RTL8195A[Driver]: ap mode 4-3 RTL8195A[Driver]: ap mode 4-4 RTL8195A[Driver]: set pairwise key to hw: alg:4(WEP40-1 WEP104-5 TKIP-2 AES-4) c RTL8195A[Driver]: set group key to hw: alg:4(WEP40-1 WEP104-5 TKIP-2 AES-4) key1 [B&T_IOT_RTL8710]# |
The command ATW? will return lots of info about WiFi status:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
[B&T_IOT_RTL8710]#ATW? [ATW?]: _AT_WLAN_INFO_ WIFI wlan0 Status: Running ============================== [rltk_wlan_statistic] tx stat: tx_packets=667, tx_dropped=0, tx_bytes=67662 [rltk_wlan_statistic] rx stat: rx_packets=2219, rx_dropped=2917, rx_bytes=266600 [rltk_wlan_statistic] min_free_heap_size=44000, current heap free size=44944 [rltk_wlan_statistic] max_skbbuf_used_num=4, skbbuf_used_num=0 [rltk_wlan_statistic] max_skbdata_used_num=4, skbdata_used_num=0 [rltk_wlan_statistic] max_timer_used_num=11 WIFI wlan0 Setting: ============================== MODE => AP SSID => CNXSOFTRTL8710 CHANNEL => 3 SECURITY => AES PASSWORD => wifiiot2 Interface (wlan0) ============================== MAC => 00:f8:87:11:00:12 IP => 192.168.43.1 GW => 192.168.43.1 Associated Client List: ============================== Client Num: 1 Client 1: MAC => 00:08:22:47:0c:1c Task List: log_servi R 5 776 6 IDLE R 0 42 4 Tmr Svc B 5 456 5 TCP_IP B 9 754 7 rtw_check B 5 220 30 rtw_recv_ B 5 994 25 interacti B 4 1132 16 LOGUART_T B 9 86 1 cmd_threa B 6 298 28 rtw_littl B 10 456 29 rtw_inter B 6 208 27 rtw_TDMA_ B 7 220 31 rtw_xmit_ B 5 178 26 [MEM] After do cmd, available heap 44944 |
I’ll complete those little tests by enabling the web server in the board:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 |
# ATSW=c WEB:Enter start web server! [MEM] After do cmd, available heap 42672 LoadWifiConfig(): Read from FLASH! LoadWifiConfig(): local_config.boot_mode=0x77665502 LoadWifiConfig(): local_config.ssid=CNXSOFTRTL8710 LoadWifiConfig(): local_config.channel=3 LoadWifiConfig(): local_config.security_type=1 LoadWifiConfig(): local_config.password=wifiiot2 LwIP_DHCP: dhcp stop. Deinitializing WIFI ... WIFI deinitialized Initializing WIFI ... WIFI initialized RTL8195A[Driver]: +OnAuth: 00:08:22:47:0c:1c RTL8195A[Driver]: +OnAssocReq RTL8195A[Driver]: ap mode 4-1 RTL8195A[Driver]: ap mode 4-2 RTL8195A[Driver]: ap mode 4-3 RTL8195A[Driver]: ap mode 4-4 RTL8195A[Driver]: set pairwise key to hw: alg:4(WEP40-1 WEP104-5 TKIP-2 AES-4) c RTL8195A[Driver]: set group key to hw: alg:4(WEP40-1 WEP104-5 TKIP-2 AES-4) key1 [B&T_IOT_RTL8710]# |
You can now connect to the web interface to configure the access point.
AT commands are all good, and you can configure WiFi, UDP/TCP servers, and even OTA firmware update, but there’s nothing about controlling GPIOs there… So that will be something to look into. [Update: ATSG is the command for GPIOs. See comment]
Dpape on RTL8710 forums discovered something very interesting: B&T RTL-00 module is pin-to-pin compatible with ESP12E module based on ESP8266, so if you already own a board with such module including NodeMCU board, you could unsolder the ESP8266 module, and replace it with RTL8710 and get going.
That’s exactly what he’s done and shown to work, with the module bought from Aliexpress, which appears to come pre-loaded with the exact same firmware. You’d normally not need the red USB debug board as shown above, but he removed the USB to TTL chip on NodeMCU previously, so that’s why…
The modules are actually only mostly pin-to-pin compatible, as for example GC5, corresponding to ADC on ESP12E, does not seem to support ADC, but only I2C1 SCL, SPI0 CS2, and GPIO_INT signals. But the power signals, Tx and TX, and most GPIO signal will match.
Realtek RTL8710 is still nowhere near ESP8266 in terms of community and software support however. However an ARM development board company – previously featured in this blog and many news outlets – is involved in the project, and I’ve been informed more details will be provided in 2 to 3 weeks. The current modules sold are for the Chinese market, and an international version is planned with a slightly different radio.
Jean-Luc started CNX Software in 2010 as a part-time endeavor, before quitting his job as a software engineering manager, and starting to write daily news, and reviews full time later in 2011.
Support CNX Software! Donate via cryptocurrencies, become a Patron on Patreon, or purchase goods on Amazon or Aliexpress
Awesome! The RTL8710 WiFi Wireless Transceiver updates a lot and more popular than the old edition. Thanks Jean’s review for ICStation product. Looking forward to further cooperation with you Jean. Nice day 🙂
Great post @cnxsoftware, nice to see your findings. It would be great to get to get our hands on the source of this B&T firmware, this way we could ad GPIO, …. control.
@Daan
I’m assuming it will be released in about two weeks. I might also get some test results between ESP8266 and RTL8710 next week from the “development board” company.
The told me they did not expect us to find about the module so early…. So that’s why it’s not quite ready yet.
@Daan
Examples of AT commands for GPIO controls.
Write:
Read:
As found in http://www.amebaiot.com/wp-content/uploads/2016/06/AN0075-Realtek-Ameba-1-at-command-v2.2.pdf
@Jean-Luc Aufranc (CNXSoft)
Nice find,
I have placed it on the forum https://www.rtl8710forum.com/viewtopic.php?f=6&t=11
These remind me back to the very first day ESP8266 shown up to us. Using as a WiFi module along with Arduino via serial port AT command. But the most interesting things happened when Espressif released a Toolchain and SDK, then a community growing much more faster. We can start developing with C language and then Lua came in, finally Arduino platform based on ESP8266. So ESP8266 can stand alone itself as a main controller. A lot special stuffs has been pushing out like a WPS, SmartConfig, RTOS and over the air chip programming. I think no one else can… Read more »
> when Espressif released a Toolchain and SDK
Espressif didn’t release SDK, it was leaked. Toolchain was made by a community (namely, a guy whose dayjob is supporting Xtensa GCC).
The ESP8266 has option of a socket to connect an external Antenna. I don’t see one in the photos above. Does RTL8710 have option of external Antenna ? When will a full spec covering Tx/Rx levels and power consumptions become available ?
I made a quick testing with openocd and bare metal programming without SDK (I just searched some register values from SDK source). I got the LED blinking, software is running in RAM. It might be possible to use openocd for flashing as well, need to write some helper code to run in ram (as I understand, the flash is some kind of “spi flash” inside the chip).
https://bitbucket.org/rebane/rtl8710/src
@cnx can you let us know the model name for the USB – UART debug board ?
@Iridiumsat
I’m still optimistic about RTL8710. Within two weeks, we’ll know more. A NodeMCU like board with RTL8710 is also in the works.
@Rebane
Nice work!
@paul
I think I got that one with a Cubieboard… Any standard USB to TTL boards supporting 3.3V will do. For example: http://www.ebay.com/itm/CP2102-USB-2-0-to-TTL-UART-Module-6Pin-Serial-Converter-STC-Replace-FT232-Module-/381374541932
@paul
That’s what RTL-01 model is for. The data may already be available in some documents in Chinese. Now I’m mostly taking a wait and see approach as more info will come out in 2 or 3 weeks.
Great post, will try to reproduce what you did once I have back at home!
I will try to replace one of those Wemos D1 mini with the RTL module…
I have just connected and got this different reply that you.
When I type help its look like this.
And when try any AT commands it act very strange.
Reply from help:
COMMAND LIST:
==============================
wifi_connect
wifi_connect_bssid
wifi_disconnect
wifi_info
wifi_on
wifi_off
wifi_ap
wifi_scan
iwpriv
wifi_promisc
wifi_update
wifi_simple_config
wifi_wps
wifi_sta_ap
wifi_debug
ping
cpu
dw
ew
exit
help
[MEM] After do cmd, available heap 10008
@Martin Schmidt
You must have a different firmware.
If you have a JLink/SWD debugger, you could try to update the firmware from Ameba GCC SDK -> http://www.cnx-software.com/2016/11/28/pine64-padi-iot-stamp-rtl8710af-wifi-kit-review-part-2-serial-console-gcc-sdk-flashing-debugging-code/
Hi,
recently connected to rtl8710 through ftdi232.
Not sure if I’m missing something but seems like there is some malfunction.
The only message I get is the following:
[B&T_IOT_RTL8710] ######### NOT B&T FIREWARM CHECK FAILED!!! ##############
If I type anything and press enter nothing happens.
No AT command is executed, only if I type a lot I get the next message:
Too long cmd string.
Could someone please confirm whether this is normal or not.
@Victor
That’s odd. It looks like they may check the brand of the module “NOT B&T”. Are you using a B&T module?
You’d better ask in RTL8710 forum, or look for that string in Ameba SDK to understand what it means.
@Jean-Luc Aufranc (CNXSoft)
Thanx, will try that.
Today I gave it another try and shortend the chip-en pin accidentally.
Now it loads up until the Initializing wifi message and does nothing.
Doesn’t accept commands, no wifi network created by the chip, but the
serial console is active.
Seems to like like the chip is damaged physically or the firmware wasn’t written properly…