RAK Links
RAK473 module is a Wi-Fi module that fully compliant with IEEE 802.11b/g/n wireless standards, It combines an ARM-CM3 MCU, WLAN MAC, a 1T1R capable WLAN baseband, and RF in the module. It have onboard antenna, and external antenna interface, RF output PIN also exist in the board. RAK473 internally integrated TCP / IP protocol stack, supporting numerous protocols such as ARP, IP, ICMP, TCP, UDP, DHCP CLIENT, DHCP SERVER, DNS and other etc. It supports AP mode, Station mode. It also support rich AT command for all kinds of application. Users can easily and quickly use it to wifi networking and data transmission. The baud rate of module serial port is up to 921600bps, which can fully meet the low-rate applications.
In network part, RAK473 supports storing network parameters in the module, and reduce time connect to network. The module has built-in WEB server, supporting wireless network parameters configuration, supporting wireless firmware upgrade. It also supports WPS and EasyConfig. In application part, HTTP, MQTT, MDNS and SSL also be supported.
It also provides a bunch of configurable GPIOs which are configured as SPI ,UART, I2C, I2S, PWM, for different applications and control usage. RAK473 integrates internal 2M SRAM ,and 512KB DRAM and 2MB flash for complete WIFI protocol functions.
RAK473 UART command operation feature completes a few basic steps of WIFI communication, including network scanning, joining network and obtaining an IP address, and eventually establishing Socket communication. RAK473 provides a variety of convenient operation to implement networking, so that customers can easily complete the network configuration, and concentrate on the management of socket and their own data protocols.
To realize automatic networking management, customers can take advantage of WEB, WPS and EasyConfig configuration module. The module will automatically store paramenters after a successful configuration, and these automatic networking commands can be used any time, letting the module automatically complete networking operation, and returning the results.
Host to module: at+<command>=<para 1>,<para 2>,................<para n>\r\n All at commands, including parameters, are ASICII code, such as: at+psk=lthonway\r\n at+connect=LTHonway\r\n 1.After each command is executed, the module will send a return value, as the following format 2.If the command is successful, the return value OK\r\n or OK<para 1><para 2>.......................<para n>\r\n Note: In addition to OK, the other parameters are in hexadecimal, for example, OK\r\n HEX=4F 4B 0D 0A----------------------------No parameters OK@\r\n HEX=4F 4B 64 0D 0A--------------------------parameter =0x64 3.If the command fails, the return value ERROR<code> Note: ERROR is the ASCII code,<code>is hexadecimal, for example, ERROR ?\r\n HEX=45 52 52 4F 52 FE 0D 0A----------------<code>=oxFE
AT command syntax description: AT command begins with “at +” (all lowercase) and end with “\ r \ n”, the maximum command length is 80 bytes, all other commands beginning with any other format are wrong.
Note:The AT command syntax above does not apply to receiving and sending data commands at + recv_data and at + send_data, for detailed instructions, please refer to at + recv_data, at + send_data
Error Code:
Code | Description |
---|---|
-1 | Parameter input error (parameter is not recognized / missing parameter / command too long / other illegal parameter) |
-10 | Module is busy (wait until module processing is completed) |
-12 | Unknown error (internal storage, system, etc.) |
-14 | The system is upgrading, please operate later. |
Other | See specific command for details |
AT command | Description |
---|---|
Module management command | |
at+ascii = <mode>\r\n | Opening ASCII display |
at+mac\r\n | Query of module MAC address |
at+version\r\n | Query of software version |
at+pwrmode = <mode>\r\n | Setting power consumption mode of module |
at+reset\r\n | Reset module |
at+set_hostname = <name>\r\n | Setting module hostname |
at+get_hostname\r\n | Acquiring module hostname |
at+set_funcbitmap = <bitmap>\r\n | Setting special function bit |
at+get_funcbitmap\r\n | Reading special function bit |
at+data_mode\r\n | Setting data mode command |
Network command | |
at+scan = <channel>, <ssid>\r\n | Scanning wireless network |
at+get_scan = <scan_num>\r\n | Reading the specified number of scanning results |
at+psk = <passphrase>\r\n | Setting passwords for joining / creating network |
at+channel = <channel>\r\n | Setting informaiton channel for joining / creating network |
at+ap = <ssid>\r\n | Creating the name of AP Network |
at+connect = <ssid>\r\n | Connecting the specified network |
at+ipstatic = <ip>, <mask>, <gateway>, <dns server1>, <dns server2>\r\n | The IP address information of static setting module |
at+ipdhcp=<mode>\r\n | Opening DHCP Sever under dynamic allocation of IP or AP |
at+easy_config\r\n | Module command of one-key-networking |
at+wps\r\n | Net-connecting through WPS mode |
at+con_status\r\n | Query of network connection status |
at+ipconfig\r\n | Query of IP address information |
at+rssi\r\n | Query of network signal strength |
at+dns = <domain>\r\n | DNS name resolution |
at+ping = <host>, <count>, <size>\r\n | The Host under the Ping network |
at+apconfig = <hidden>, <contry code>\r\n | Advanced settings of AP Network |
at+disc\r\n | Disconnectting the currently connected network |
Mqtt command | |
at+mqtt_init = clientId, alive\r\n | Initialization of mqtt parameter |
at+mqtt_auth = username, password\r\n | Setting authentication parameters |
at+mqtt_con = svr_ip, svr_port, <SSL_enable>\r\n | Connecting the Server |
at+mqtt_discon=fd\r\n | Disconnecting Mqtt connection |
at+mqtt_con_status\r\n | Query of mqtt connection status |
at+ mqtt_sub=sub_topic\r\n | Subscribing themes |
at+mqtt_unsub=sub_topic\r\n | Unsubscribing themes |
at+mqtt_pub = pub_topic, retain\r\n | Setting push topics |
socket command | |
at+ltcp = <local_port>\r\n | Creating TCP Server |
at+tcp = <dest_ip>, <dest_port>, <module_port>, <ssl_enable>\r\n | Establishing TCP Client |
at+ludp=<local port>\r\n | Creating UDP Server |
at+udp=<dest_ip>,<dest_port>,<local_port>\r\n | Establishing UDP Client |
at+multicast=<dest_ip>,<dest_port>,<local_port>\r\n | Creating UDP multicast communication |
at+set_cert = <cert_type>, <file_len>, <data_stream>\r\n | Setting ssl security certificate |
at+cls = <flag>\r\n | Closing opened socket handle |
at+socket_status = <flag>\r\n | Query of socket status |
at+read = <flag>, <data_length>\r\n | Reading data through way of query |
at+send_data = <flag>, <dest_port>, <dest_ip>, <data_length>, <data_stream>\r\n | Sending data |
at+recv_data = <flag> ,<dest_port>, <dest_ip> ,<data_length> ,<data_stream>\r\n | Receiving data |
at+http_get / https_get = <ip / domain>: <port> / <url>\r\n | HTTP / HTTPS GET command |
at+http_post/https_post=<ip/domain>:<port>/<url>,<data>\r\n | HTTP / HTTPS POST command |
Parameter perservation command | |
at+storeconfig\r\n | Save the network parameter / tape parameter |
at+get_storeconfig\r\n | Acquiring the saved network parameter |
at+web_config = web_param\r\n | Modifying the network parameter of the built-in WEB server |
at+get_webconfig\r\n | Acquiring the saved network parameter of built-in WEB |
at+uartconfig = <baud rate>, <data bits>, <stop bits>, <parity>, <flow ctrol>\r\n | Modifying the UART parameter of module, current effect |
at+store_uartconfig = <baud rate>, <data bits>, <stop bits>, <parity>, <flow ctrol>\r\n | Modifying the UART parameter of module, reset effect |
at+auto_connect\r\n | Starting automatical net-connecting |
at+start_web\r\n | Open WEB service, configuring module |
Capture command | |
at+set_filter=<s_mac>,<d_mac>,<rssi>\r\n | Setting packet filtering |
at+start_promisc=<channel>\r\n | Start caught |
at+stop_promisc\r\n | Stop caught |
Read and write NVM data | |
at+nvm_write=<addr>,<len>,<data>\r\n | Write data to NVM |
at+nvm_read=<addr>,<len>\r\n | Read the NVM data |
Firmware upgrade | |
at+upgrade\r\n | Into the firmware upgrade mode |
== Pleace see the programming manual for the detailed meaning of the AT command. ==
Pin | Name | Type | Description |
---|---|---|---|
1,3,21,33 | GND | Ground | All ground pins are connected to ground pad or the copper. |
22 | VCC3.3V | Power | 3.3V power supply. |
2 | RF_OUT | O | 2.4GHz RF output. |
4 | VDDIO | Power | 3.3V for Digital IO or digital blocks. |
11 | RESET | I | Module reset pin, Active low. |
17 | LINK | O | Work status indicator pin of module, output low effective. |
23 | TXD | O | Serial data communication interface send. |
26 | RXD | I | Serial flow control pin, ready to receive, Active low. |
24 | RTS | O | Serial flow control pin, The default output low. Active low, ready to receive data / request the other party to send data. |
25 | CTS | I | Serial flow control pin, Input pull. Active low, ready to send data/request each other to send data. High level cannot send data, low level can send data. |
20 | NC/VCC | I | Use 473/475 module,this pin can Suspended;If use the 476/477 module,this pin must connect VCC3.3V |
Others | NC | NC | Remain disconnected when no use. |
Welcome to RAK473 //Power on information at+ascii=1 //Set ascii show OK at+psk=123456789 //Set AP Password OK at+ap=RAK473_AP //Establish AP OK at+ipstatic=192.168.9.5,255.255.255.0,192.168.9.1,192.168.9.1,0 //Set static IP address OK at+ipdhcp=1 //Open dhcp server OK at+ltcp=25000 //Set tcp server OK8 at+recv_data=connect //Receive STA connection event at+recv_data=128,0,47466,192.168.9.2 //Receive client TCP connection event at+recv_data=0,47466,192.168.9.2,12,hello rak473 //Receive data at+recv_data=129,0,47466,192.168.9.2 //Receive client TCP disconnect event at+recv_data=disconnect //Receive STA disconnect event
Welcome to RAK473 //Power on information at+ascii=1 //Set ascii show OK at+psk=123456789 //Set routing password OK at+connect=rakwireless //Connection Route OK at+ipdhcp=0 //Dynamic acquisition of IP OK mac=9C:44:3D:00:06:59 addr=192.168.31.103 mask=255.255.255.0 gw=192.168.31.1 dns1=192.168.31.1 dns2=0.0.0.0 at+ltcp=25000 //Create a server TCP OK8 at+recv_data=128,0,59231,192.168.31.180 //Receive client TCP connection event at+recv_data=0,59231,192.168.31.180,12,hello rak473 //Receive data at+recv_data=129,0,59231,192.168.31.180 //Receive client TCP disconnect event
For more detailed examples, please refer to the link:WisNode-UART
ITEMS | CONTENTS |
---|---|
Operating Frequency | 2.400-2.4835GHz |
WiFi Standard | 802.11b/g/n |
Modulation | 11b: DBPSK,DQPSK and CCK and DSSS 11g: BPSK,QPSK16QAM,64QAM and OFDM 11n: MCSO-15 OFD |
Data rates | 11b:1,2,5.5 and 11Mbps 11g:6,9,12,18,24,36,48 and 54 Mbps 11n:MCSO-15,up to 150Mbps |
Host Interface | UART |
Dimension | Typical (L x W):21mm x 18mm |
Operation Temperature | -20℃ to +85℃ |
Storage Temperature | -55℃ to +125℃ |
Operation Voltage | 3.3V±0.2V |
ITEMS | CONTENTS | ||||
---|---|---|---|---|---|
Specification | IEEE802.11b | ||||
Mode | DSSS/CCK | ||||
Channel | CH1 to CH13 | ||||
Data rate | 1,2,5.5,11Mbps | ||||
- | |||||
1.Power Levels (calibrated) | Min. | Typ. | Max. | Unit | Note |
1)16dBm Target (For each antenna Port) | 15 | 17 | 19 | dBm | |
- | |||||
2.Frequency error | -25 | 0 | +25 | kHz | |
3. Minimum input level sensitivity | Min. | Typ. | Max. | Unit | Note |
1)11Mbps(FER≤8%) | --- | -82 | --- | dBm | |
2)Maximum input level (FER≤8%) | --- | -10 | --- | dBm |
ITEMS | CONTENTS | ||||
---|---|---|---|---|---|
Specification | IEEE802.11g | ||||
Mode | OFDM | ||||
Channel | CH1 to CH13 | ||||
Data rate | 6,9,12,18,24,36,48,54Mbps | ||||
- | |||||
1.Power Levels (calibrated) | Min. | Typ. | Max. | Unit | Note |
1)16dBm Target (For each antenna Port) | 12 | 14 | 16 | dBm | |
- | |||||
2.Constellation error(EVM)@target power | Min. | Typ. | Max. | Unit | Note |
1)54Mbps | --- | -30 | -28 | dB | |
3.Frequency error | -25 | 0 | +25 | kHz | |
- | |||||
4.Minimum input level sensitivity | Min. | Typ. | Max. | Unit | Note |
1)54Mbps(PER≤10%) | --- | -78 | --- | dBm | |
5.Maximum input level (PER≤10%) | --- | -10 | --- | dBm |
ITEMS | CONTENTS | ||||
---|---|---|---|---|---|
Specification | IEEE802.11n HT20@2.4GHz | ||||
Mode | OFDM | ||||
Channel | CH1 to CH13 | ||||
Data rate | MCS0/1/2/3/4/5/6/7/8/9/10/11/12/13/14/15 | ||||
- | |||||
1.Power Levels (calibrated) | Min. | Typ. | Max. | Unit | Note |
1)16dBm Target (For each antenna Port) | 12 | 14 | 16 | dBm | |
- | |||||
2.Constellation error(EVM)@target power | Min. | Typ. | Max. | Unit | Note |
1)MCS7 | --- | -30 | -28 | dB | |
3.Frequency error | -25 | 0 | +25 | kHz | |
- | |||||
4.Minimum input level sensitivity | Min. | Typ. | Max. | Unit | Note |
1)MCS7(PER≤10%) | --- | -76 | --- | dBm | |
5.Maximum input level (PER≤10%) | --- | -10 | --- | dBm |
ITEMS | CONTENTS | ||||
---|---|---|---|---|---|
Specification | IEEE802.11n HT40@2.4GHz | ||||
Mode | OFDM | ||||
Channel | CH1 to CH13 | ||||
Data rate | MCS0/1/2/3/4/5/6/7/8/9/10/11/12/13/14/15 | ||||
- | |||||
1.Power Levels (calibrated) | Min. | Typ. | Max. | Unit | Note |
1)16dBm Target (For each antenna Port) | 12 | 14 | 16 | dBm | |
- | |||||
2.Constellation error(EVM)@target power | Min. | Typ. | Max. | Unit | Note |
1)MCS7 | --- | -30 | -28 | dB | |
3.Frequency error | -25 | 0 | +25 | kHz | |
- | |||||
4.Minimum input level sensitivity | Min. | Typ. | Max. | Unit | Note |
1)MCS7(PER≤10%) | --- | -74 | --- | dBm | |
5.Maximum input level (PER≤10%) | --- | -10 | --- | dBm |
Product | Describe | Antenna | MOQ(PCS) | Evaluation Board |
---|---|---|---|---|
RAK473MA-XXXX | UART interface module,with on-board antenna | On-board | 400 | RAK473-EVB |
RAK473MB-XXXX | UART interface module,with external antenna | External,U.fl/i.PEX | 400 | |
RAK473MC-XXXX | UART interface module,with RF output interface | RF output | 400 |