Advertisement

Quick Links

RAK425 User Guide
RAK425 Serial WIFI Module
User Guide V1.4
Shenzhen Rakwireless Technology Co.,Ltd
www.rakwireless.com
Mail:info@rakwireless.com
1

Advertisement

Table of Contents
loading

Summary of Contents for RAK 425 Series

  • Page 1 RAK425 User Guide RAK425 Serial WIFI Module User Guide V1.4 Shenzhen Rakwireless Technology Co.,Ltd www.rakwireless.com Mail:info@rakwireless.com...
  • Page 2: Table Of Contents

    RAK425 User Guide Content RAK425 Serial WIFI Module................1 1 Quick Start......................- 1 - STEP1: Check before Power Up..............- 2 - STEP2: State after Power Up................- 2 - STEP3: Pass-through Data Test..............- 5 - 2 Functional Description................... - 8 - 2.1 Overview.....................
  • Page 3 RAK425 User Guide STA Node Parameter Settings..............- 19 - IO Communication Parameter Settings..........- 20 - Network Parameter Settings..............- 21 - Advanced Management................- 21 - Firmware Upgrade................... - 23 - 4.4 Wireless Configuration Tool..............- 24 - 4.5 Serial Interface Configuration Tool............- 25 - 4.6 Dual Socket Applications.................- 26 - 4.7 EasyConfig Functional Demonstration..........
  • Page 4 RAK425 User Guide 5.4.5 Copy user parameters..............- 37 - 5.5 AP SAT Operating Commands............... - 37 - 5.5.1 Query AP connection status............- 37 - 5.5.2 Query STA wireless signal strength..........- 38 - 5.5.3 Scan for wireless networks............- 38 - 5.5.4 Get wireless network..............
  • Page 5: Quick Start

    RAK425 User Guide 1 Quick Start Thank you for choosing RAK425 serial pass-through module, the pass-through module is extremely easy to use and feature-rich, to meet various needs of customers. First, we use RAK425 evaluation kit to have a feel of it. The Evaluation Kit is shown as Figure 1-1 Figure 1-1 View of Development Board Table 1-2 Main Peripherals...
  • Page 6: Step1: Check Before Power Up

    RAK425 User Guide 2. Press and hold shorter than 3 sec,one-key configuration to network (with phone) Into ultra-low power mode button Press and holdlonger than 5 sec and release, into the Sleep ultra-low power Press, and then release to wake up module STEP1: Check before Power Up Evaluation Kit contains a serial adapter cable, a USB cable, a module with external antenna, also provides antenna with IPEX connector interface.
  • Page 7 RAK425 User Guide Figure 1-3 AP Scanning after Factory Doubleclick to join the network (the Link lights up), an IP address will be assigned as Figure 1-4 shows: Figure 1-4 Join inFactory AP - 3 -...
  • Page 8 RAK425 User Guide Open browser and enterthe module gateway address 192.168.7.1, the default web authentication interface pops up, enter authentication username: admin password: admin. As Figure 1-5 shows: Figure 1-5 WEB Authentication The built-in WEBServer interface is shown. AP settingsand IO communication settings can be viewed (i.e.UART interface and socket communication settings), as...
  • Page 9: Step3: Pass-Through Data Test

    RAK425 User Guide Figure 1-7 Factory IO Communication Test STEP3: Pass-through Data Test Open serial port tool, select the COM port. The default baud rate is 115200, data bit is 8, and stop bit is 1, no parity check, no flow control. Then open network debugging tools (TCP / UDP tools) to establish TCP client connection, with target IP 192.168.7.1, server port 25000, as Figure 1-8 shows: - 5 -...
  • Page 10 RAK425 User Guide Figure 1-8 Establish a TCP Client After the TCP is connected, data can be exchanged, as Figure 1-9 shows. At this point the module becomes a virtual serial port on the network, data from serial port and network can be exchanged. Figure 1-9 Factory Pass-throughTest Keep in mind the state of the indicators Status indicators:...
  • Page 11 RAK425 User Guide Module is ready to enter factory mode —— quick flashing Module Upgrade Error —— slow flashing Link indicators: module is connected to router in STA mode, module builds STA connection in AP mode ——on(output low) Conversely off EasyConfig, WPS in one-key configuration ——...
  • Page 12: Functional Description

    RAK425 User Guide 2 Functional Description 2.1 Overview RAK425 module is an ultra-low power WIFI module that fully supports IEEE 802.11b/g/n wireless standards, with a small package and easy-to-use features. The RAK425 is a complete serial pass-through module integrated with TCP / IP protocol stack and drivers, easy to use by simply using the PC, WEB Browser, APPs tool to work individually or in bulk for parameters configuration, and then module connects the serial ports and network for normal usage.
  • Page 13: Feature Description

    RAK425 User Guide  Support OPEN, WEP, WPA/WPA2-PSK Encryptions  Support SoftAP, Station modes  Support TCP, UDP protocols  Support DHCP SERVER / DHCPCLIENT  Support AT commands and transparent transmission mode  Support UART communication with a data flow control, maximum rate of 921600bps ...
  • Page 14: Tcp/Ip

    RAK425 User Guide  Supportproactively identifying devices in LAN  Support wireless configuration and firmware upgrade 2.4.3 TCP/IP  DHCP Client and Server features  DNS Client and Server functions  TCP Client, TCP Server, UDP Client, UDP Server and UDP Multicast functions ...
  • Page 15: Hardware Introduction

    RAK425 User Guide 3 Hardware Introduction 3.1 Module type Figure 3-1 RAK425BI Top View Figure 3-2 RAK425BI Bottom View Figure 3-3 RAK425BL Top View Figure 3-4 RAK425BL Bottom View Figure 3-5 RAK425BX Top View Figure 3-6 RAK425BX Bottom View - 11 -...
  • Page 16: Pin Definition

    RAK425 User Guide 3.2 Pin Definition Table 3-1: Pin Definition Pin Serial No. Name Type Description Ground connected to ground pad or the copper VCC3V3 Power 3.3V power supply Module configuration pin to achieve EasyConfig and DefaultConfig function EasyConfig press (<3S) to enter CONFIG I,PU intoone-key configuration network...
  • Page 17 RAK425 User Guide Module networking indicator "0" - STA connected in AP mode, LINK O,PU Connected to router in STA mode "1" - disconnected Remain disconnected when no use Note: 1. I - input O - output PU – pulling up PD - pulling down Status indicator: Module started properly...
  • Page 18: Use Encyclopedia

    RAK425 User Guide 4 Use Encyclopedia 4.1 Basic Flow Chart The main working state of the module is pass-through mode, as well asassistant command mode, allowing parameters management and query. The module chooses mode according to the MODE pin level, which is high(default), it enters into the pass-through mode.
  • Page 19: Variety Of Configurations

    RAK425 User Guide 4.2 Variety of Configurations For pass-through module, it’s aim for data communications. The precondition of WIFI communication is parameter configurations, among which the more important ones network configuration (network name, password, address) andcommunication protocol socket settings (TCP, UDP). For parameters, the module defines the following two concepts.
  • Page 20: Web Configuration

    RAK425 User Guide 4.3 WEB Configuration After the module has established AP or joineda router, enter the IP address in the browser to access themodule. When in AP mode, IP address is default recognized as gateway address, such as 192.168.7.1. When in STA mode, if the IP address is automatically acquired, module IP address cannot be determined.
  • Page 21: Mode Selection Page

    RAK425 User Guide When opening the address in the browser, message box will pop up that requires authentication (may take a few seconds before the pop-up), enter the default username | password: admin | admin, the configuration page will appear as shown in Figure 4-3: Figure 4-3 WEB Page Mode Selection Page Select the network mode which is divided into AP mode and STA mode...
  • Page 22: Ap Settings

    RAK425 User Guide mode is set when module is before or after network connections,ensuringthe module to reduce power consumption when idle. AP Settings Set an AP network name, with length limit of 32 bit. It is also configurable whether the network has broadcast (that can be scanned by other WIFI device), for security reasons, choose not to broadcast.
  • Page 23: Sta Node Parameter Settings

    RAK425 User Guide STA Node Parameter Settings When module is used in STA mode, it adds its own routing equipment. The network name can be manually filled in orby search a router nearby, click the router into the searching page found to confirm.If the router is encrypted, pages will be prompted to enter password.
  • Page 24: Io Communication Parameter Settings

    RAK425 User Guide IO Communication Parameter Settings IO communication includes serial ports parameter settings and network parameter settings shown as Figure 4-6: Serial port parameters settings include serial port baud rate (autobaud is not supported), data bits, parity bits and stop bits. It supports hardware flow control, and 485 one-way communication function.
  • Page 25: Network Parameter Settings

    RAK425 User Guide Network Parameter Settings The network parameters are all about network communications settings, socket parameters settings includes three parameters, target server address, port number, and local port number. The module supports two communication Sockets, SocketA and SocketB. They are all available for one of the TCP server, TCP client, UDP server and UDP client.
  • Page 26 RAK425 User Guide Figure 4-7 Advanced Management Page - 22 -...
  • Page 27: Firmware Upgrade

    RAK425 User Guide Firmware Upgrade The module provides wireless upgrade functionality to facilitate customer evaluation. Please upgrade carefully, for technical support please contact RAK shown as Figure 4-8: Figure 4-8 Firmware Upgrade Page - 23 -...
  • Page 28: Wireless Configuration Tool

    RAK425 User Guide 4.4 Wireless Configuration Tool Wireless configuration tool of the module can conduct locally discovery, RAK module can be found in LAN after scanning. Click to select the module for authentication, enter the default authentication. When succeeded, configurethe corresponding parameters, save and reset.
  • Page 29: Serial Interface Configuration Tool

    RAK425 User Guide 4.5 Serial Interface Configuration Tool The module provides AT command assessment under assistant command mode, the tool can also complete bulk editing on the factory parameters settings and user parameters settings. Software provides open source, customers can also independentlydesign.
  • Page 30: Dual Socket Applications

    RAK425 User Guide 4.6 Dual Socket Applications The module supports opening sockets for two-way communication to meet customer demand for multi-sockets. The following shows how to configurerouter and open dual sockets from the factory mode. One socketis to establish TCP server for local access.
  • Page 31 RAK425 User Guide Figure 4-12 STA Mode Figure 4-13 Select Specified Router Figure 4-14 Fill in Password Now, configure IO communication socket, open dual sockets, set socketA to TCP server, local port 25000, ignore the target server address and port number shown as Figure 4-15: set SocketB to TCP client, with the server IP 192.168.1.101, server port - 27 -...
  • Page 32 RAK425 User Guide number 12345. Save and restart. See Figure 4-16 as below: Figure 4-15 Socket A Settings Figure 4-16 Socket B Settings After the restart, until the link light on the development board starts flashing, the module is connected to the specified router, then there is a client connected to SocketB 192.168.1.120:12345 this is the module TCP connection.
  • Page 33 RAK425 User Guide Figure 4-17 Assigning IP Create another TCP client on the TCP / UDP tool connecting to module TCP server, build SocketA, 192.168.1.120:25000. Shown as Figure 4-18: Figure 4-18 Dual Socket Established - 29 -...
  • Page 34: Easyconfig Functional Demonstration

    Link light stops flashing, and light again. MAC address of the module pops up on the phone. See Figure 4-20 as below: RAK provides Android and IOS client development libraries, and also provides customized services. Note: when user confirms the choice of EasyConfig functionality, it is recommendedconnect the module Link pin with LED indicator.
  • Page 35 RAK425 User Guide If the module Link light is on, but there is no return with the MAC address of the phone, it is primarily because the module is already networked, but DHCP IP is not assigned. Check signal value of the router, and whether the DHCPServer is turned on or the route is busy.
  • Page 36: Assistant At Command

    RAK425 User Guide 5 Assistant AT Command Table 5-1 AT Command Set AT Command Description Module Management Commands at+ascii=<mode>\r\n Open ASCII display at+mac\r\n Query Module MAC address at+easy_txrx\r\n Enter pass-through mode at+version\r\n Check software version at+reset \r\n Reset module at+restore\r\n Restore factory settings Parameter Configuration Commands at+write_config=configuration...
  • Page 37: Syntax

    RAK425 User Guide at+apconfig=<contry code>\r\n AP Advanced Settings Send and Receive Data Commands at+send_data=0, dest_port,dest_i Send data from SocketA p, datalen,databuffer \r\n at+recv_data=0,dest_port, Receive data from SocketA dest_ip,datalen,databuffer \r\n 5.1 Syntax Host to module: at+<command>=<para 1>, <para 2>,....<para n>\r\n All AT commands, including parameters are ASICII code, e.g: at+scan=0,TP-LINK_2.4GHz\r\n After each command has been executed, the module will send a return value in the following format...
  • Page 38: Open Assistantcommand

    RAK425 User Guide 5.2 Open AssistantCommand Open the assistant command interface in pass-through mode, similar to handshake way shown as Figure 5-2. 1. PC (master MCU) sends"+ + +", the request goes to the command mode。 2. Set timer 200ms, and wait for module returning"U" (0x55). If the module is not returned within the specified time, the timer of 200ms is sent again Send "+ + +"...
  • Page 39: Query Module Mac Address

    RAK425 User Guide 5.3.2 Query Module MAC address Command: at+mac\r\n Description: Check MAC address of the module Return: OK<Mac>\r\n ERROR<code>\r\n 5.3.3 Enter pass-through mode Command: at+easy_txrx\r\n Description: Send the command to enter pass-through mode Return: OK\r\n ERROR<code>\r\n 5.3.4 Check software version Command: at+version\r\n Descrption: Check the current version of the firmware, including the host version and WLAN version...
  • Page 40: Write User Configuration

    RAK425 User Guide 5.4.1 Write user configuration Command: at+write_config=configuration parameter length, configuration parameter\r\n Description: Write the user configuration parameters at one time, user sends all of the configuration parameters to the module including network mode, power consumption mode, network parameters, serial port and communication parameters. User can also enable and disable the factory advanced features, such as LAN discovery, WEBServer and AP / STA switching mechanism.
  • Page 41: Modify Factory Configuration

    RAK425 User Guide RAK_XXXXXX the last 3 letters are that of MAC address, which can also be configured by the factory modification. return: OKwifi_mode=AP&power_mode=full&ap_channel=1&ap_ssid=RAK_000001& ap_secu_en=0..\r\n ERROR<code>\r\n 5.4.4 Modify factory configuration Command: at+write_restoreconfig=configuration parameter length, configuration parameter\r\n Description: Modify the default configuration parameters, also customers can modify the default configuration parameters as required.
  • Page 42: Query Sta Wireless Signal Strength

    RAK425 User Guide Return: OK<code>\r\n code=0 Not connected code=1 Connected 5.5.2 Query STA wireless signal strength Command: at+rssi\r\n Description: Check wireless signal strength under STA. Return: OK<RSSI>\r\n ERROR<code>\r\n Note: When there is no network connection, the command is invalid. When module is as the AP, the default is-0db. 5.5.3 Scan for wireless networks Command: at+scan=<channel>,<ssid>\r\n...
  • Page 43: One-Key Networking Command

    RAK425 User Guide 1. If user does not need to get the wireless network information, this command can be omitted! 2. All information scanned has been read. If read again, the module will return error -2, at this point, command "at + scan"is needed to rescan! 3.
  • Page 44: Wps Configuration Commands

    RAK425 User Guide 5.5.6 WPS configuration commands Command:at+wps\r\n Description: If this command is sent, module enters into WPS configuration mode, meanwhile press the WPS button on the router. Customers can check whether the connection is on via Query network status command. Return: OK //enter the WPS configuration mode 5.5.7 Check IP status...
  • Page 45: Ping Command

    RAK425 User Guide Remark 5.5.8 Ping command Commad: at+ping=<host>, <count>, <size>\r\n Descrtiption: Run the ping command to test network connectivity. Return: OK\r\n ERROR<code>\r\n Table 5-4 ping command returns <HOST> Specified host <COUNT> The number of packets, the default value is 1. (optional) Packet size, maximum packet is 1000bytes, default is 64bytes.
  • Page 46: Send And Receive Data Commands

    RAK425 User Guide Table 5-5 Parameter Description: Parameter Value Description <contry code > Country code Country code, i.e., China (CN) (US) Return: OK\r\n ERROR<code>\r\n 5.6 Send and Receive Data Commands 5.6.1 Sending data Command: at+send_data=uuid,dest_port,dest_ip,datalen,databuffer \r\n Description: Send data uuid of the corresponding Socket (A, B). Parameter Description: uuid=0 Indicates socket A;uuid=1 Indicates socket B...
  • Page 47: Appendix

    RAK425 User Guide order.When programming is recommended to use ASCII display disabled mode. Parameter Description: uuid=0 Indicates socket A;uuid=1 Indicates socket B dest_port Indicates the target port dest_ip Indicates the target IP datalen Indicates the received data length databuffer Indicates the received data content 5.7 Appendix Read/write module configuration of keywords and parameters keywords...
  • Page 48 RAK425 User Guide security: sta_psk 1234567890 sta_dhcp_en static: 0 dhcp: 1 sta_ipaddr 192.168.1.100 sta_netmask 255.255.255.0 sta_gateway 192.168.1.1 sta_dnssever1 192.68.1.1 sta_dnssever2 0.0.0.0 UART parameters uart_baudrate 9600,19200,38400,57600,115200,230400,460800,921 uart_datalen (5-8) uart_parity_en none: odd: Even: uart_stoplen (1-2) uart_rtscts_en forbidden: enable: RS485/RTS: 2 (RTS as a transceiver pin, switch High level to send) Socket parameters socket_multi_en One Socket:...
  • Page 49 (when the net connection is loss ,module switching network on the factory and user parameters Every minute ) web_switch Use rak web: Use customer web: web_func_en Disable WEB config: Enable WEB config: udp_func_en Disable UDP discover: enable UDP discover:...
  • Page 50: Sales And Service

    RAK425 User Guide 6 Sales and Service Beijing FAE mailbox: allan.jin@rakwireless.com Tel : 010-62716015 Fax: 010-62716015 Address: Room 1108, Jin Yanlong Building, Xisanqi Desheng Gate, Haidian District, Beijing Shanghai FAE mailbox: steven.tang@rakwireless.com Tel : 021-54721182 Fax: 021-54721038 Address: Room 306, Ran East Business Center 1 Building, No.150, 2161 Lane, Wanyuan road, Minhang District, Shanghai Shenzhen FAE mailbox: vincent.wu@rakwireless.com...
  • Page 51: Revision History

    RAK425 User Guide 7 Revision History Revision History and Modifiction Version Modification Date V1.0 Initial Draft 2014-02-14 V1.1 Add user parameters appendix factory 2014-07-01 Update the contact way, Update the document format V1.2 2014-08-22 V1.3 Update the Physical picture 2014-08-28 Deletes chematics and height picture, V1.4 add notes ASCII display,...

This manual is also suitable for:

425bi425bl425bx

Table of Contents