WRTnode2R starting guide

From WRTnode Wiki
Jump to: navigation, search
This page is a translated version of the page WRTnode2R开箱指南 and the translation is 100% complete.

Other languages:

The most first tip:
WRTnode2R default WiFi ssid: WRTnode2R_xxxx
Defual password for the Wi-Fi ssid: 12345678

What's in the WRTnode2R retail package

WRTnode2R retail package including the WRTnode2R and it's standerd shield
This is how they are togother ready to work.

How WRTnode2R inserted into the shield

Plug the golden core module WRTnode2R into the miniPCI socket as the angle like the figure:
And push the outside of the golden module lightly, as the figure:
After a "carrrrrh" sound, the core module and the base board fitted each other perfectly, as the figure:
Isn't the inserting of WRTnode2R looks like the inserting of the RAM stick to the laptop? Yep, it's just how we want to design.

Light up WRTnode2R


  • The board is powered by micro-USB connector, find an ordinary micro-USB power cable( which is not included in the retail package)
  • Plug into the baseboard's micro-USB connector, and the other side you could use any USB port which could offer more than 500mA and 5V power, such as a computer or a laptop's USB interface or a mobile phone charger or something like this.
  • The blue LED lights on and the OpenWrt starts to run in the board.
  • 20 seconds later, you will find a Wi-Fi with the SSID like WRTnode2R_xxxx( xxxx means the last four byte of the MAC address of your WRTnode2R), you could connecting the Wi-Fi with computer or phone with the password 12345678.

Login to WRTnode2R using telnet or ssh

Use any PC with Windows, Linux or MacOS operating system, install PuTTY on Windows PC, use any Linux / MacOS terminal software on Linux / MacOS.

  • First ping the WRTnode to see if connection is available. The default IP of WRTnode2R is set to, but WRTnode2R is able to resolve openwrt.lan to as well:
ping openwrt.lan
  • Connect to WRTnode2R using telnet or ssh

If you connect first time to WRTnode2R or you didn't set password for root user of OpenWrt, use telnet to connect:



telnet openwrt.lan

If you a password for root user was set, use SSH to connect:

ssh root@


ssh root@openwrt.lan

Input your root password and a screen should appear like, ok, that's it. you could play your Linux CLI interacting here now:

No internet no happiness

Now we will connect WRTnode2R to the internet. of course, you must have a 2.4G Wi-Fi ap or router with has connected on the internet.

root@OpenWrt:~# aps

'aps' is the command of WRTnode2R to scan the Wi-Fi available, the output of 'aps' looks like this:

WRTnode AP scaner.
Begin scaning APs, pls wait...
APs available are...
ra0       get_site_survey:
Ch  SSID                             BSSID               Security               Siganl(%)W-Mode  ExtCH  NT WPS DPID
1   Tenda                            xx:xx:xx:xx:xx:xx   NONE                   70       11b/g/n ABOVE  In YES
1   hshn                             xx:xx:xx:xx:xx:xx   WPA2PSK/AES            96       11b/g/n NONE   In YES
6   TP-LINK                          xx:xx:xx:xx:xx:xx   NONE                   55       11b/g   NONE   In  NO
6   BY01                             xx:xx:xx:xx:xx:xx   NONE                   100      11b/g/n NONE   In YES
6   Tenda_xxxxxx                     xx:xx:xx:xx:xx:xx   WPAPSK/AES             50       11b/g/n ABOVE  In  NO
11  CU_wpFS                          xx:xx:xx:xx:xx:xx   WPAPSK/TKIPAES         70       11b/g/n NONE   In YES

ok,we will connect one:

root@OpenWrt:~# setwifi SSID_you_connetctin the_password

be careful, there's a space between the SSID and the password
Such as:

root@OpenWrt:~# setwifi TP_linkAB33CD my_password

Press Enter and wait 5 seconds, or sometimes we need to reconnect our computer to the WRTnode2R's SSID, so let's see if we have got the IP address from uppter router:

root@OpenWrt:~# ia

we'll see

root@OpenWrt:~# ia
apcli0    Link encap:Ethernet  HWaddr xx:xx:xx:xx:xx:xx
          inet addr:  Bcast:  Mask:
          inet6 addr: xxxx::xxxx:xxxx:xxxx:xxxx/xx Scope:Link
          RX packets:0 errors:0 dropped:0 overruns:0 frame:0
          TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:0 (0.0 B)  TX bytes:0 (0.0 B)

sometimes getting the IP address will lasts more than 5 seconds, so be patient. Once we got the IP address, let's see if the board have access the internet:

root@OpenWrt:~# ping baidu.com
PING baidu.com ( 56 data bytes
64 bytes from seq=0 ttl=54 time=6.071 ms

See, thus we connected our computer to the WRTnode2R, and we connected the WRTnode2R to the internet.

WRTnode2R software repository

root@OpenWrt:~# opkg update
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/base/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_base.
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/telephony/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_telephony.
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/packages/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_packages.
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/routing/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_routing.
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/luci/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_luci.
Downloading http://downloads.openwrt.org/chaos_calmer/15.05/ramips/mt7628/packages/management/Packages.gz.
Updated list of available packages in /var/opkg-lists/chaos_calmer_management.

root@OpenWrt:~# opkg install xxxx

Play stm32

Updating the firmware of stm32

In the stm32 of WRTnode2R/en, we preset a bootloader in the first 4K of stm32 so we could update firmware of stm32 online in mt7688, which provide by a 7688 tools named flash-stm32.
Using flash-stm32 like:

root@OpenWrt:~# flash-stm32 URL

URL argument could be the file url from internet or the local file.
We recommended to update the new firmware:

root@OpenWrt:~# flash-stm32 http://d.wrtnode.com/2R-stm32/WRTnode2r_stm32_V1.bin

As shown, stm32 updating finished, after that stm32 will reboot automatically.

If user want to do stm32 development by yourself, use tools like stlink to deleop/debug/reflash. Here's what we must know:

  1. User-developed code to redirect to the interrupt vector table location 0x08001000.
  2. User Codes, the position to be downloaded to 0x08001000.
  3. If the user completely abandoned the code we provide, but also want to support online update firmware, you need to realize 7688 control stm32 reset function in the user code.(In we provide in the code, has achieved the reset command, so based on the code we provide for development, do not need to complete this step)

Try msh on WRTnode

STM32 running on the real time operating system RT-Thread,Benefit from the RTT in a friendly msh command line debugging components, our factory firmware implemented the RTT spi slave device driver, and the msh input and output ports are mapped to the spi bus.At the same time,We provide the software by 7688 and STM32 SPI bus communication(Including spiS0 device driver, spi-bridge communication software and flash-stm32 firmware upgrade program)
msh command line

  • Login to WRTnode2R.
  • Use the spi-bridge command to open msh terminal,then press the 'tab' key and the 'enter' key to list all available commands.
  • For example, run the ps command.


  • Use the 'exit' commad exit msh terminal.

More about WRTnode2R stm32 introduction, please refer to the manual of STM32 development in WRTnode2R

Restore To Factory Settings

Then you could do whatever you want in WRTnode2R via ssh, just like an ordinary Linux PC, and when you done something you dislike and want to restore the board as you first getting it, here's how:

root@OpenWrt:~# firstboot
This will erase all settings and remove any installed packages. Are you sure? [N/y]
/dev/mtdblock5 is mounted as /overlay, only erasing files
root@OpenWrt:~# reboot

OpenWrt SDK

This SDK is an universal one for all WRTnode hardwares, and for WRTnode2R choosing [ WRTnode 2 series ] in [ Subtarget ] when make menuconfig.

more resources

WRTnode2R Specifications
WRTnode2R pinmap
WRTnode2R baseboard pinmap
Apply WRTnode2R in mass manufacturing products

keep on rock, man!

keep on rock, man!