0% found this document useful (0 votes)
159 views54 pages

E103-W02 UserManual EN V3.0

Uploaded by

Dhanuka
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
159 views54 pages

E103-W02 UserManual EN V3.0

Uploaded by

Dhanuka
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 54

Chengdu Ebyte Electronic Technology Co.,Ltd.

E103-W02 User Manual

E103-W02 User Manual

Serial port wifi SMD small-sized PCB Antenna MQTT

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 1


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

Content
1. Product introduction ...................................................................................................................... 4
Brief introduction ...................................................................................................................... 4
Basic usage ................................................................................................................................ 5
Electrical parameter .................................................................................................................. 5
Electrical characteristic ............................................................................................................. 6
2. Function description ...................................................................................................................... 7
Pin definition ............................................................................................................................. 7
Application schematic ............................................................................................................... 8
3.Quick start ...................................................................................................................................... 9
3.1 Traditional mode(NORMAL) ........................................................................................... 10
3.1.1 Link preparation ..................................................................................................... 10
3.1.2 Set the module as AP to establishes TCP SERVER and PC wireless connection 11
3.1.3 Set the module as AP to establish a UDP server wireless connection with a PC ... 13
3.1.4 Set module as STA(Station)to connect other WiFi hot spots ............................ 15
......................................................................................................................................... 21
3.1.5 Web page configuration .......................................................................................... 21
......................................................................................................................................... 22
3.1.6 Remote AT command ............................................................................................. 22
3.2 MQTT Client mode(MQTT) ............................................................................................. 23
1.1 3.2.1 Setting process.................................................................................................. 23
3.2.2 Device access demo ............................................................................................ 24
3.2.3 MQTT precautions ................................................................................................. 27
3.3 HTTP Client mode (HTTP) ............................................................................................... 27
3.3.1 Setting process........................................................................................................ 27
3.3.2 Use of POST request method ................................................................................. 28
3.3.3 Use of GET request method ................................................................................... 29
3.3.4 HTTP Client precautions ........................................................................................ 31
3.4 Server multi-Link mode (MULTIS) .................................................................................. 31
3.4.1 Setting process........................................................................................................ 31
3.4.2 Multi-Client access demo .................................................................................... 31
3.4.3 MULTIS precautions .............................................................................................. 33
3.5 Client Multi-link Mode (MULTIC) ........................................................................... 34
3.5.1 Setting process........................................................................................................ 34
3.5.2 Demo of A B general client access server .............................................................. 34
3.5.3 EBT Private Network Access Demo ...................................................................... 36
3.5.4 MULTIC precautions ............................................................................................. 38
3.6 Change UART baud rate ................................................................................................... 38
3.7 Low power consumption configuration description .......................................................... 38
4.Specification for networking ........................................................................................................ 39
Networking role ...................................................................................................................... 39
Networking model ................................................................................................................... 40
5. AT Command .............................................................................................................................. 41

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 2


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

6. Antenna selection ........................................................................................................................ 53


7. Customized cooperation .............................................................................................................. 53
8. Revision history .......................................................................................................................... 54
9. About us ...................................................................................................................................... 54

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 3


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

1. Product introduction

Brief introduction

E103-W02 is an ultra low power UART to Wi-Fi


module with small size SMT packing and embeded PCB
antenna, operating at 2.4 ~ 2.484GHz. The module can
transmit and receive data through UART, which makes it
easier for wireless applications.
E103-W02 is developed based on the TI CC3200, by
Chengdu Ebyte Electronic Technology Co.,Ltd. It is a
transparent transmission module for network access
through UART by AT command, it is widely used for
wearable electronics, home automation, home security, personal care, smart home, accessories & remote
controller, automobile, lighting, industrial internet, etc.
E103-W02 supports standard IEEE802.11b/g/n protocol and complete TCP/IP protocol stack,
supports STA/AP mode network role and multiple network operating mode, it supports SmartConfig,
UART transparent transmission, transparent transmission on power-up, etc. Network connection can be
achieved after easy configuration, which saves the efforts and time of the user in developing.

No. Feature Description

4 power consumption modes can be freely configured, and the standby


1 Ultra-low power power consumption is less than 5uA in the lowest power consumption
mode.
High-speed
2 transparent The module supports 3Mbit high-speed continuous transmission.
transmission
Support web page Module is accessible via web page and quickly read or configure the
3
configuration module parameters.
Automatically connect to WIFI network after power on, and then connect
Power-on transparent
4 to the target device through the protocol according to different network
transmission
modes.
Automatic
reconnection after After the network connection is disconnected and restored in STATION
5
network mode, the module automatically reconnects to the target.
disconnection
Quick network Support Airkiss/SmartConfig function for quick network configuration of
6
configuration modules.

Support remote AT command, AT command can be used to configure


7 Remote AT command
module remotely.
When the module is used as a TCP client, it supports the heartbeat
8 Heartbeat packet mechanism, and users can customize the heartbeat packet content to
support serial port heartbeat packet.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 4


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

When the module is used as a TCP client, it supports the connection


9 Registration packet registration mechanism, and users can customize the contents of the
registration package.
Cloud platform
The module can realize multi-device cloud platform transparent
10 transparent
transmission after related parameter configuration is completed.
transmission
Multiple network Traditional TCP / UDP mode, multi-link TCP / UDP mode, MQTT client
11111
operating mode
111 mode, HTTP client mode

1`212 Support EBYTE Access to EBYTE cloud platform, simple cloud platform setting can
12 cloud access quickly realize remote transparent transmission of different equipment

1313 Pin status reminder Pin level reminder varies according to different operating status

For more features, please refer to the relevant application documents

Basic usage

No. Instruction Description


Module-to- Module 1 is set to AP mode and a TCP or UDP server is established. Module
0 module 2 is set to STATION mode and connected to AP 1 and communicates with
communication Module 1 through TCP or UDP Client.
The Wi-Fi module is connected to the network through a wireless router, and
communicates with a server on the network (LAN or Internet) through TCP
Module-to-Server
1 Client or UDP.
communication
If connecting to an Internet server is needed,it requires to configure the
corresponding port mapping on the router .
The Wi-Fi module is connected to the network through a wireless router, and
Module-to-Client
2 establishes a TCP or UDP server to intercept connection signals.
communication
The client communicates with the module server by connecting it.
For more usage, please refer to the networking description in Section 5.

Electrical parameter

No. Name Value Remark


1 RF chip CC3200 TI
2 Size 27 * 19 * 2.70mm With PCB antenna
Average 2.2g With PCB antenna
3
weight
PCB 4 Impedance debugging
4
process

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 5


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
Working 2.4~2.484 GHz
5
frequency
Productio Lead-free process, Wireless products must be machine-mounted to ensure
6
n process SMT batch consistency and reliability
7 Interface 1.27mm SMD
2.4 ~ 3.6V DC Note: higher than 3.6V voltage will cause permanent
Supply
8
voltage damage to the module
Communi Maximum 3.6 It is recommended that the difference from the supply
9 cation
level voltage is less than 0.3V to reduce power consumption
Measured About 50m Clear and open, maximum power, height 2m
10
distance About 500m Clear and open, maximum power, height 2m
Transmit 20dBm About 100mW
11
power
Built-in intelligent Configuration parameters can be set or read via AT
AT
12 processing commands
support

Wi-Fi 802.11 b/g/n


13
version
Communi UART serial port
14 cation
interface
PCB onboard 50Ω characteristic impedance, which can be changed by
15 Antenna antenna/IPX socket
yourself
-40 ~ +85℃ Industrial grade(Chip range, please modify according to
Operating
16 temperatu crystal parameters)
re

Operating 10% ~ 90% Relative humidity, non-condensing


17
humidity
Storage -40 ~ +85℃ Industrial grade
18 temperatu
re

Electrical characteristic

Parameter Condition Min Typical Max Unit


Storage temperature -40 Room 85 ℃
range temperature
Working voltage 2.4 3.3 3.6 V
VIL/VIH -0.5/0.65VDD - 0.35VDD/
VDD+0.5
V
VOL/VO N/2.4 - 0.4/N
Any IO
H
IMAX - - 3.5 mA

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 6


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

2. Function description

Pin definition

No. Definiti I/O Function


on
1、8、9、 GND Ground
11、12、
13、16、
17、28、
29、44
2 GPIO26 IO General IO
3 GPIO27 IO General IO
4 RST I Reset pin, low level reset
5 SOP2 I Programming emulation mode selection
6 SOP1 I Programming emulation mode selection
7 SOP0 I Programming emulation mode selection
10 VCC Device power VDC:2.4V~3.6V(over 300mA)
14 GPIO31 IO General IO
15 GPIO0 IO General IO
18 GPIO30 IO General IO

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 7


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
19 GPIO1 O UART TX, support AT command
20 GPIO2 I UART RX, support AT command
21 GPIO3 IO General IO
22 GPIO4 IO General IO
23 GPIO5 IO General IO
24 GPIO6 IO General IO
25 GPIO7 IO General IO
26 GPIO8 IO General IO
27 O Wifi connection indicator, it outputs low level when connected and
GPIO9
high level while not connected.
30 O Network connection indicator, it outputs low level when connected
GPIO10
and high level while not connected.
31 O SmartConfig status indicator, it indicates low when in SmartConfig
GPIO11
status and high while not in the status.
Factory setting reset pin, keep it at lower level at power on and
wait the indicator led flickers for 3 times alternately to restore
32 GPIO12 I
factory setting. (Press the reset button when restoring factory
settings)
33 GPIO13 IO General IO
34 GPIO14 IO General IO
35 GPIO15 IO General IO
36 GPIO16 IO General IO
37 GPIO17 IO General IO
38 GPIO22 IO General IO
39 GPIO28 IO General IO
40 TDI I JTAG emulation pin
41 TDO O JTAG emulation pin
42 TCK I JTAG emulation pin
43 TMS IO JTAG emulation pin

Application schematic

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 8


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

 Note:supply voltage must be 2.4V~3.6V, 500mA LDO is recommended for steady operation
of module

3.Quick start

E103-W02 module has the following 5 modes:


Mode Description
NORMAL In this mode, there is no difference from the function of V2.0, that is, it supports
1-channel TCP server or 1-channel TCP Client or 1-channel UDP, and supports
remote AT command function.
MQTT In this mode, it supports the general MQTT client function, and supports 1-
channel subscription topic and 1-channel report topic at the same time.
HTTP In this mode, it supports general HTTP client, and POST and GET request
methods.
MULTIS In this mode, it supports multiple TCP links. As a TCPSERVER, the module
can allow 4 TCPclients to access simultaneously.
MULTIC In this mode, it supports multiple TCP / UDP links. As a TCP / UDP client, the
module can access three servers simultaneously.

E103-W02 module is easy to use. In order to allow users to quickly familiarize with the module,
the following guides users to quickly use the module for different modes, and to configure and
communicate in various modes through simple settings.
All the commands are used during testing are AT commands. We developed HTTP web page for
users to access the module and conduct quick configuration.
The tests in this chapter are conducted with Serial debugging assistant, the module will return the
current commands so that users could quickly learn the way to use AT commands. (Notes: All AT
commands shall be followed with a line break except for “+++” commands)
•In addition, users could use external MCU instead of baseboard to connect the UART of the module
for AT commands communication to realize secondary development.

Hardware:

1 E103-W02 Wi-Fi module*1

2 E103-W02 Wi-Fi module test baseboard*1

3 PC with Wi-Fi*1

4 Router*1 (or cellphone Wi-Fi hotspot)

Software(Download from our website)

1 AccessPort/XCOM

2 TCP&UDP test tool

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 9


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3 SmartConfig(one-key configuration)cellphone app“Wi-Fi Starter”

3.1 Traditional mode(NORMAL)

3.1.1 Link preparation


First of all, you need to know that when the module is restored to factory settings or the default
status, the network role is AP, and the network mode is NORMAL mode. First, we need to connect the
PC to the module to establish a network connection.
①. Connect the factory-made E103-W02 baseboard to the PC through the Micro USB data cable.
②. Open the serial port debugging assistant "AccessPort" and select the port number; if you don't
know the port number, please check in the device manager (see the picture below)

③ Set the serial port debugging parameters (baud rate: 115200bps, data bit: 8bit, parity bit: no parity,
stop bit: 1bit).(See the picture below)

④. We open the wireless network on the PC, find the wireless network with SSID beginning with
"EBT" (such as: EBT_9BB311), and click on "Next" to connect. ("9BB311" here is the last 6 digits of
the module MAC address. The MAC address of different modules is different, so the SSID of different
modules is also different.)

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 10


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

⑤. After the connection is successful, the LED1 light on the module baseboard is always on (GPIO9
is pulled low), and the PC shows that the connection is successful, otherwise please repeat the above
steps.

3.1.2 Set the module as AP to establishes TCP SERVER and PC wireless connection

①. Open the TCP & UDP testing tool, create a connection, and set the parameters (see the figure below).
(The parameter value can be sent through the serial debugging assistant to send the corresponding AT
command for query and then exit the AT command mode to realize the subsequent two-way
communication between the PC and the module)

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 11


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

②. Click on the "Create" button to complete the creation, and then click on the "Connect" button.

③ The LED 2 on the module baseboard is always on (GPIO10 is pulled low), indicating that the
connection is completed,then the PC and the module can communicate with each other mutually (it means
TCP & UDP testing tool and AccessPort can communicate with each other mutually), if not, please repeat
above steps.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 12


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
④. It can transmit documents (better in TXT format), just have a try.

3.1.3 Set the module as AP to establish a UDP server wireless connection with a PC
Now let’s try to set up UDP communication, which needs some simple configuration on the module.
①. Make sure the link preparation is completed successfully.
② Enter AT command mode for simple configuration. (Please make sure to complete the
operation of No. 1 first. Since it is sending commands, please turn off the Real Time Send function of
the port in order to configure the module, if there is no Real Time Send function in your AccessPort,
please ignore this notice)
a. Start to configure the port, input command “+++”in the sending textbox (please do not add line
break), and click on Send button to start sending command.
b. If the port returns “Entered AT mode”, it means the module has entered AT command mode, if
not, please repeat the above steps.

④. By step ④, we have entered AT command mode, now let‘s start to configure Socket protocol.
a. Input“AT+SOCK=UDP,SERVER,192.168.1.2,8887,8889”in the sending textbox (please add
line break, which means to press Enter after “AT+SOCK=UDP,SERVER,192.168.1.2,8887,8889”),
click on Send button to start sending.
b. If the port returns “Socket update OK”, it means the command has successfully set the
protocol parameters, if not, please repeat the above steps.

④. Reset the module or restart when power off after setting parameters to validate the settings; If
there are still other parameters to set, please complete the setting before reset or repower. Because we
only configure Socket protocol, so just directly reset or repower (GPT010 is pulled low), the LED2 will
be lit up on the baseboard, it means the UDP protocol is available.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 13


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

④. Open the TCP&UDP testing tools, create connection and set parameters (See the picture below).

④. Click on the “Create” button to complete the creation.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 14


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
④. When creation is completed, it can realize two-way transmission between PC and module (it
means transmission between TCP&UDP testing tool and AccessPort), if not, please repeat above steps.

④. It can transmit document (it is better to be in TXT format), just have a try.
In addition, customers can also set the socket link as TCP Client in AP mode. The setting method is
the same as above, which will not be explained here.

3.1.4 Set module as STA(Station)to connect other WiFi hot spots


In order to make it easier for users to access the network using the roles of the left and right STA in
the following chapters, a section on how to access other WIFI nodes is added here for users' reference.
Connect other Wi-Fi hot spots as STA (Station)
④.Connect the baseboard of E103-W02 and PC with Micro USB data cable.
④.Open AccessPort, select COM number; If you are not clear about the COM number, please check
in your Device Manager (see the picture below ).

④.Set UART parameters (baud rate: 115200bps, data bit: 8 bits, parity bit: none, stop bit: 1 bit).
(refer to the picture below)

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 15


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

④.Simple configuration by AT command.


(Since we are sending command, in order for better configuration, please turn off the Real Time
Send function of the UART; If there is no Real Time Send function in you AccessPort, please ignore
this notice)

a. Start UART configuration, input “+++”in the sending textbox (no line break), click on Send button
to send command.
b. If the UART returns “Entered AT mode”, it means the module has entered AT command mode, if
not, please reset and repeat above steps.
④.Now our module is connecting other AP as STA, so please set the mode as STA mode.
a. Input AT command “AT+ROLE=STA”in the sending textbox (with line break), which means
pressing Enter after inputting “AT+ROLE=STA”), and then click on Send button.
b. If the UART returns “Set STA mode”, it means the module has been set as STA mode, if not,
please repeat above steps.

④.Set Wi-Fi hot spot parameters (STA parameters)


a. Input AT command “AT+STA=Ebyte,2,E61TTL1W”in the sending textbox of the AccessPort
(with line break, which means pressing Enter after inputting “AT+STA=Ebyte,2,E61TTL1W”), and then
click on Send button to send the command. <The parameters must be set according to the user’s Wi-Fi
hot spot; the “Ebyte” in front of the AT command is the Wi-Fi hot spot SSID (Wi-Fi name),‘2’is the
encryption method WPA2 (if there is no password, it shall be “0”),“E61TTL1W”is the password of the
Wi-Fi (if there is no password, it shall be null)>

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 16


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
b. If the UART returns“STA update OK”, it means the STA parameters are set successfully by
command, if not, please repeat above steps.

④.Reset or repower the module, if the Wi-Fi modules are far from each other, please install antennas.
④.If LED1 is lit up(GPI09 is pulled low), it means the module is successfully connected to Wi-Fi hot
spot.

Connect other Wi-Fi hot spots as STA (Station) through SmartConfig (one-click config.)
④.Connect the E103-W02 baseboard and PC with Micro USB data line.
④.Open AccessPort, select COM number; if you are not clear about the COM number, please check in
your Device Manager (see the picture below).

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 17


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

④.Set UART parameters (baud rate: 115200bps, data bit: 8 bits, parity bit: none, stop bit: 1 bit).(see the
picture below)

④.Simple configuration by AT command.


a. Start UART configuration, input “+++”in the sending textbox (no line break), click on Send button
to send command.
b. If the UART returns “Entered AT mode”, it means the module has entered AT command mode, if
not, please reset and repeat above steps.
④.Please set the module as STA mode first.
a. Input AT command “AT+ROLE=STA” in the sending textbox of the AccessPort (with line
break, which means pressing Enter after inputting “AT+ROLE=STA”), and then click on Send button
to send command.
b. If the UART returns “Set STA mode”, it means the module has entered STA mode successfully,
if not, please repeat above steps.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 18


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

④.Rest or repower the module, and repeat the step ④.


④. Enter SmartConfig (one-click config) mode.
a. Input AT command “AT+SMT=60” (with line break, which means pressing Enter after inputting
“AT+SMT=60”), and then click Send button to send command. (The 60 in the AT command means the
module will exit SmartConfig (one-click config) mode if the module fails to connect the Wi-Fi hot spot
after 60s)(During this 60S, the module has been waiting to accept the instructions sent by the mobile
phone, and the LED1 will be lit up when the acceptance is successful (GPIO9 is pulled low))
b. If the UART returns “Enter into SmartConfig”, and LED3 is lit up(GPI001 is pulled low), it means
the module has entered SmartConfig (one-click config) mode, if not, please repeat above steps.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 19


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

④.Turn on cellphone Wi-Fi and connect to one hot spot.


④.Install and open APP “Wi-Fi Starter”, input Wi-Fi hot spot passwords, and click on “Start”.
(Network Name is the name of the Wi-Fi hot spot your cellphone is connecting to, the software will
recognize automatically, no input is needed. )

④.If the modules are far from each other, please install antennas. If the LED1 on baseboard is lit
up(GPIO9 is pulled low), it means the module is successfully connected to Wi-Fi hot spot, if not, please
repeat above steps. (when successfully connected, the module will remember the Wi-Fi hot spot
(including passwords), it will automatically connect to it upon reset or repower next time)

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 20


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

Here, users can also use the AT + AIRKISS command to implement the AIRKISS configuration.

3.1.5 Web page configuration

The E103-W02 can use the web page to reconfigure the module parameters. Before performing this
operation, the module needs to connect to the PC wirelessly. After the PC displays the connection
successfully, open the IP address of the browser input module (if the module is not clear) The IP address
can be queried using the serial port AT command "AT+APIP=?")

Then enter the module parameter configuration page, where you can reset multiple parameters of
the module.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 21


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

After the parameters are reconfigured, the module needs to be restarted and the configuration
parameters take effect.

3.1.6 Remote AT command

The E103-W02 in NORMAL mode can use the remote AT command to send an AT command to the
module 12476 port using the UDP communication protocol. When using the remote AT command, you
do not need to use "+++" for mode switching. Remote command is only allowed in the module NORMAL
mode, and will not be used when switching to other modes (such as MQTT, HTTP).

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 22


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.2 MQTT Client mode(MQTT)

In the NORMAL mode chapter, we introduced the module setting process and the use of AT
instruction in detail. In this chapter and the introduction of other modes, we only make some simple
introduction and use of the AT instruction for functions.
MQTT is a client-server based message publish / subscribe transmission protocol. The MQTT
protocol is lightweight, simple, open, and easy to implement. These characteristics make it applicable to
a wide range. In many cases, including restricted environments, such as machine-to-machine (M2M)
communication and the Internet of Things (IoT). It has been widely used in satellite sensors to
communicate with sensors, occasionally dialing medical devices, smart homes, and some miniaturized
devicesAmong them, communication sensors through satellite links, medical devices that occasionally
dial, smart homes, and some miniaturized devices have been widely used.
1.1 3.2.1 Setting process
When the module works in MQTT mode, at this time, some sub-functions of other modes will not
be enabled (such as NORMAL remote AT command will not be allowed to be used). MQTT mode is the
module's role as an MQTT client to access users in the target MQTT server, when users use the MQTT
mode, if they want to access the public network for long-distance transmission or access to the cloud
server, they need to know that the network role of the module should be set to the STA mode. The
following uses ONENET as an example to introduce the access method and communication.

1. Enter AT mode, make the current network role in STA mode


a.
b. +++
c. AT+ROLE=STA
d. 2.Connect to WIFI (AP), and connect to the network

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 23


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
e.AT + STA = EBYTE, 2, JSZXE880
3. Switch the mode and set the operating mode to MQTT mode
AT + MODE = MQTT
f.4. Set the MQTT connection information and connect to the ONENET MQTT server (provided
that the user has created the relevant MQTT device)
AT + MADDR = 183.230.40.39,6002 (Address can be IP or URL)
5. Set MQTT access information (the specific information is filled in according to the actual parameters
of users)
AT + MUSER = ”ClientID”, ”Username”, ”Userpassword” (The parameters here must be distinguished
by quotation marks)
6. Set MQTT subscription information
AT + MSUB = Topic, Qos
7. Set MQTT report information
AT + MPUB = Topic, Qos, Retain
8, restart to take effect
AT + RST

3.2.2 Device access demo

A complete set of MQTT AT command operation is shown below:

Login to our ONENET MQTT device management platform, when there is no access, the offline status
is displayed, as shown in the picture below

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 24


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

After the setting is completed, the ONENET cloud platform management displays the online status after
successful access.

At this time, when the ONENET is successfully connected, the GPIO10 pin is pulled low at to indicate
the status of successful access, and the disconnection it will be pulled high.
In order to demonstrate the data transmission process of the device intuitively, we use another W02 to
follow the above steps (note that the path of subscription and reporting needs to be exchanged)
As shown in the picture below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 25


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

After connecting, as shown in the figure below:

MQTT communication between two devices is now possible.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 26


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.2.3 MQTT precautions


In the above usage list, ONENET is used as a use case, but this function is a general MQTT function
and can support different MQTT servers. In the process of use, especially when MQTT accesses the
server of the MQTT service provider (such as Ali Cloud , Baidu Cloud, ONENET), need to draw the
corresponding three elements of MQTT according to its rules.

3.3 HTTP Client mode (HTTP)

3.3.1 Setting process


When the module works in the HTTP Client mode, some sub-functions in other modes or modes
will not be enabled at this time. In the HTTP Client mode, the module acts as an HTTP client to access
the user's target HTTP server. If users want to access the Ethernet data in this mode, they need to know
that the network role of the module should be set to STA mode. In the following, the access method and
communication will be described.

1. Enter AT mode and put the current network role in STA mode
+++
AT + ROLE = STA
2. Connect to WIFI (AP) and connect to the network
AT + STA = EBYTE, 2, JSZXE880
3. Switch the mode and set the operating mode to HTTP mode
AT + MODE = HTTP
4. Set the HTTP connection information, connect to the destination IP and monitor port of the
HTTP server
AT + HCADDR = 192.168.0.136,80 (HTTP server address of local LAN)

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 27


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
5. Set the request path and method of the HTTP server
AT + HCMODE = / 1.txt, POST
6. Set the HTTP client's request header options (up to 180 bytes)
AT + HCHEAD =, (Parameter sending "," means no header information is set)
7. restart to take effect
AT + RST

3.3.2 Use of POST request method


The AT command of AT + HCMODE = URL, POST allows the module to request data by POST.
The URL is the specified access path. For the convenience of demonstration, we start a server software
on the PC under the same LAN as the module, and the software creates a 1.txt file in the same directory,
and writes some data into the txt file, as shown in the picture below:

In the serial port, each time the data is sent, it will trigger the request data of the HTTP client, while
the corresponding data input by the serial port is reported to the server data, and the data is sent in the
serial port: 123, the module will request data from the server according to the set request path and method.
After requesting data, the server will return the file to the serial port, as shown in the picture below: The
red box in the figure is the request information of the module as an HTTP client.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 28


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

The POST method is generally recommended for customers when uploading large data to the server.
If you only request data from the server, you can choose the GET method.

3.3.3 Use of GET request method


The AT command of AT + HCMODE = URL, GET allows the module to request data by GET. The
URL is the specified access path. It only works when the access data is POST. The GET access path
needs to be specified in the serial data. Based on the POST, reset the request method, as shown in the
picture below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 29


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

When you need to request data, you need to specify the HTTP Client access path before sending
serial data, as shown in the picture below

In the above picture, you can see the request method and path resolved by the server, and when
using the GET method, the access path in the serial data needs to be specified (remember to add "?" and
a space)
The GET method is more flexible and suitable for small data uploads, but the request path often
becomes the case.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 30


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.3.4 HTTP Client precautions

The access path set by the AT command is only valid for the POST request method. The GET
method requires the data header in the serial port data to specify the access path.
The HTTP client's default request header attributes are:
Host: xxx.xxx.xxx.xxx
Accept: * / *
Content-Length: xx
This can ensure that customers can request data without setting the header.
Customers can set the header information through the data format of AT + HCHEAD = XX: XX,
XXX: XXX. If customers want to add after the default request header
Connection: keep-alive
Content-Type: application / json
They need to use the following AT format, the total length cannot exceed 180 bytes:
AT + HCHEAD = Connection: keep-alive, Content-Type: application / json

3.4 Server multi-Link mode (MULTIS)

When the module works in MULTIS mode, other modes or sub-functions will not be used. MULTIS
means that the module as a server can support the connection mode of multiple clients. At present, this
mode supports the connection of 4 clients at the same time. The modules are listed bunder the role of AP
below, realizing multi-client communication.

3.4.1 Setting process


1. Enter AT mode and put the current network role in AP mode
+++
AT + ROLE = AP
2. Switch the mode and set the operating mode to MULTIS mode
AT + MODE = MULTIS
3. Set the local monitoring port number of MULTIS (default 5001)
AT + MULTISP = 5002
4, restart to take effect
AT + RST

3.4.2 Multi-Client access demo

The operation of A complete set of AT commands operation in MULTIS mode is shown below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 31


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

After restarting, at this time, the module works in MULTIS mode. It has been established after
the server is turned on. The port number and local IP are set by users. The SSID of the module connected
by the computer is that the computer and the module are in the same LAN. After the computer
successfully connects to the module, the GPIO9 pin is pulled low.
After successfully connecting, we create 4 clients on the computer and fill in the IP and port the
module server(Module IP: 192.168.1.1 port number is 5002)
As shown in the picture below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 32


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

The data received by the module's serial port will be broadcast to each client connection.

3.4.3 MULTIS precautions


When there is a client access, the GPIO10 pin will be pulled low at this time to indicate the client's
access. When there is no client connection in the module server link, GPIO10 will be pulled high to
indicate that there is no any client access.
Any message sent by the TCP client will be printed out by the module's serial port, and the message
input by the module's serial port will be broadcast by the server to each client link.
Each client can choose to go online and offline at any time without restarting the configuration
server.
When the server already has four client links, if there is another access, the server will automatically
kick off the oldest client link to the server.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 33


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.5 Client Multi-link Mode (MULTIC)


When the module works in MULTIC mode, other modes or sub-functions will not be used.
MULTIC means that the module as a client can support the connection mode of multiple servers. At
present, this mode supports the connection of 3 servers simultaneously. Among them, A and B are general
TCP / UDP link, and the other is a dedicated client, which only supports the exclusive services of access
to the Ebyte cloud server, making it easy for users to access our cloud server. In this example, the module
will be made to work in the network role of STA, to demonstrate the setting process of A and B and the
use of the Ebyte dedicated link.

3.5.1 Setting process


1. Enter AT mode and put the current network role in STA mode
+++
AT + ROLE = STA
2. Connect to WIFI (AP) and connect to the network
AT + STA = EBYTE, 2, JSZXE880
3. Switch the mode and set the operating mode to MULTIC mode
AT + MODE = MULTIC
4. Set the connection information of SOCKET A, connect to the destination server, and the
connection type is TCP
AT + SOCKA = ON, TCP, 192.168.0.136,7788,7789
5. Set the connection information of SOCKET B, connect to the destination server, and the
connection type is UDP
AT + SOCKB = ON, UDP, 192.168.0.136,7688,7689
6, restart to take effect
AT + RST

3.5.2 Demo of A B general client access server

A complete set of AT command operation in MULTIC mode is shown below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 34


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

If more than two links are established and the link has a TCP type link, the server (TCP) needs to
be established before the module is restarted. The reason will be explained in the following notes. Under
normal circumstances, the local TCP server and the The UDP server is connected by the A B client of
the module, as shown in the picture below:

When the serial port sends data, it is sent to each server connected to the module client by broadcast,
and the data sent by each server is printed to the module serial port.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 35


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.5.3 EBT Private Network Access Demo


Based on the above chapters, we need to know the MAC address and SN code of our module. The
MAC address can be queried by command:
AT + MAC =?
and the SN code is authorized by us to users, and users can query through AT + DEVSN = ?.
1. Remain the MULTIC mode unchanged, set the socket Ebyte server information:
AT + SOCKEBT = ON
2. After getting the SN code provided by us, through the AT command:
AT + DEVSN =? (16-bit SN code)
to query the SN code, so that when the cloud platform is authenticated later, it can be correctly
authenticated.
3. Log in URL http://yun.cdebyte.com/login, enter the Ebyte cloud login interface to log in. If users has
not registered yet, they can register first and then log in, as shown in the picture below.

3. After entering the login interface, add a device in the device list and enter the module's MAC
address and SN code correctly, as shown in the picture below:

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 36


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

4.After adding correctly, as shown in the picture below, in this way, multiple modules can be
established on the cloud platform to correspond to the device.

5. Restart the module to access the Ebyte cloud platform server. At this time, check the information
related to cloud platform device, the device is already online, as shown in the picture below:

If users want to achieve remote forwarding between multiple devices, or data forwarding with other
products of our company through W02, they can set it in the relevant setting column. We will not repeat
them here.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 37


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

3.5.4 MULTIC precautions


In MULTIC mode, it supports the connection of three client access servers, two general socket links,
one dedicated Ebyte socket link, and three links can be used simultaneously, or one or more of them can
be used. There are no restrictions on matching.
When the module is started, it will try to connect to the server pointed by the client for the first time.
When all the clients of the module are not correctly connected to the specified server, the module will
re-establish the connection. When there is a client connected to the server correctly, the module It will
not retry to connect again. User need to know that if the they have enabled two or more clients, if one of
them fails to access the server, it will not be used in subsequent work.
When the server accessed by the client kicks off the client actively, if two or more clients are
currently enabled, it will not be used in subsequent work.
When one or more clients successfully access the server, GPIO10 will be pulled low at this time to
indicate the status of at least one server successfully connected. When no client successfully accesses the
server, GPIO10 will be pulled high to indicate that no server is currently connected.

3.6 Change UART baud rate

No. Remark
1 E103-W02 Wi-Fi module supports 300 ~ 3000000bps UART baud rate.
By sending AT+UART command, the user can modify the UART parameters. For example:
2
AT+UART=115200, 8, 0,1
3 Please refer to AT command set for detailed command.
Baud rate 300-3000000bps(default115200)
NONE(default)
Parity bit support EVEN
ODD
5 bits
6 bits
Data bit
7 bits
8 bits
1 bit
Stop bit
2bits

3.7 Low power consumption configuration description

E103-W02 can be configured to four power consumption modes: Active, Sleep, LPDS, Hibernate.
By sending AT+PM command, the user can configure the module to corresponding low power
consumption mode. For example: AT+PM=1, 5

√(Active)/×(O MCU NET WAKEUP REF CURRENT


FF) RTC RAM UART GPIO CPU NET RXD AP STATION
Active √ √ √ √ √ √ - - 71mA 18mA

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 38


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

Sleep √ √ √ √ × √ √ √ 68mA 16mA

Lpds √ √ × × × √ √ √ 63mA 2.5mA

Hibernate √ × × × × × × √ 4.6uA 4.5uA

Mode 0: Active mode


All external devices of the module work normally. It is normal working normal, at this time, the
module works with best performance and quickest response.
Mode 1: Sleep mode
It can be woken up by UART or network data packet, GPIO keeps output, the module will
continue to operate from the point of entering sleep mode, the response time of wake up is shorter that
in deepsleep model. Wake up method: UART RXD, network.
Mode 2: LPDS mode
The module enters LPDS mode, and the network part keeps operating, the GPIO output of the
module is in high resistance state. It can be woken up by UART or network data packet, the wake up
data packet is transparently transmitted normally. At this time, a short data will be sent to wake up the
module before normally sending the data packet. The network data as received will be output through
UART. Wake up method: UART RXD, network.
Mode 3: Hibernate mode
The module enters hibernate mode, the network and MCU are all in sleep mode, GPIO output high
resistance state, it can only be woken up by UART data. The module will restart and operate. The
power consumption could be lower than 5uA. Wake up method: UART RXD.

Tips:
1.Set low-power mode in AP mode. The module will not enter low-power mode immediately after startup.
Only when connected to the network (as AP mode, there are devices connected to the module) will enter
low-power mode.
2. After receiving the network data and the serial port data, the delay time for entering the low power
consumption mode will be refreshed. For example: in hibernate mode, after sending serial port data to
wake up the module and wait for connection to the server, you can continuously send data for a long time
without worrying that the module will re-enter hibernate mode. When the serial port or network data
reception is completed, the timing of the delay entry into the low-power mode starts immediately, and
the module re-enters the hibernate mode after the delay time is reached.
3. In low power mode, all IO are in a high-impedance state, so the status indicator is invalid, and it will
not reflect the current actual connection status.

4.Specification for networking

Networking role

No Remark
1 As physical connection, E103-W02 supports AP mode (router) and STATION (Wi-Fi

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 39


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
device). At most 1 Wi-Fi device can be supported when module works at AP mode.
As Socket, E103-W02 includes TCP Server, TCP Client and UDP. Based on TCP
2 connection mechanism, if long time connection is needed, please use TCP heartbeat
packet.

Networking model

Module builds TCP Client to connect with remote server when working at STATION mode
(classic)

Can be used for home IoT, meter-reading, real-time monitoring etc.


Module can communicate with network server for real-time data.
Users can operate module by real-time communication.

Module builds TCP Server to connect with Wi-Fi device when working at STATION mode

This module is similar to type one, the only difference is module builds TCP Server instead of TCP
Client when working at STATION mode.
At most 4 remote devices can be connected when module connects with network.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 40


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

One module build TCP Server when works at AP mode, and the other module build TCP
Client when works at STATION mode to communicate with it.
The network model can be referred to as intra-module networking. A module in an AP mode can
connect up to three STATIONs, that is, up to four module devices in the network. The TCP Server
can be established on any module under the condition of completing the internal networking, and
the remaining three modules can communicate with it using the TCP Client.

5.AT Command

Test method:
(Remember to add
Enter and a line feed.
Example AT command
The query command Function
No. Command Test example response
is AT + XXX = ?, the description
following only
describes how to use
it)

Parameter
specification:
0 +++ No parameter Entered AT mode
Response:
Entered AT mode

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 41


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

AT+ALLSTATE Execute all


Parameter query
specification:
No parameter commands,
AT+ALLSTAT Returns the results of the
1 Response: for example: AT+ALLSTATE
E All parameter executed query
AT+AP=?
information
AT+MAC=
?

AT+AIRKISS Enter
Parameter AIRKISS
2 AT+AIRKISS specification: mode and AT+AIRKISS Enter into AirKiss
No parameter
wait for AP
Response:
Enter into AirKiss access

AT+APIP=<APIP>,< Set / Query APIP:192.168.1.1


Mask>,<Gateway>,< AP IP Mask:255.255.255.0
AT+APIP=?
DNS> Related Gateway:192.168.1.1
Parameter Parameters DNS:192.168.1.1
specification:
APIP: IP address in
3 AT+APIP the AP mode
AT+APIP=192.16
Mask:Subnet mask Set AP IP
8.1.2,255.255.255
Gateway:Address related APIP update OK
.0,192.168.1.1,19
DNS: DNS server parameters
2168.1.1
address
Response:
APIP Update OK
AT+AP=<SSID>,<Se
cType>,< Password> SSID:EBT_65C60F
Query AP AT+AP=?
Parameter SecType:0 Password:

specification:
SSID:Service set
identifier
<1~32Byte>
4 AT+AP SecType:Encryption
type(0: no password, AT+AP=EBYTE,
1: WEP encryption, 2: Set AP AP update OK
2,12345678
WPA2 encryption)
Password:
<8~63Byte>
Response:
AP Update OK
AT+CHAN=<Channe Query AP
AT+CHAN=? AP Channel:11
5 AT+CHAN l> channel
Parameter AT+CHAN=1 AP channel update OK

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 42


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
specification:
Channel:Number of
channels
Set AP
( 1~11) AT+CHAN AP channel update OK
channel
Response:
AP Channel Update
OK
AT+DEVSN=?
Parameter +DEVSN SN:
specification: Query SN 191126173603FF1D
6 AT+DEVSN No parameter AT+DEVSN=?
code
Response:
+DEVSN OK
AT+EXIT
Parameter
specification:
No parameter Exit AT
7 AT+EXIT AT+EXIT Exited AT mode
Response: mode
Exited AT Command
mode
AT+HELP
Parameter View help
specification:
No parameter command Show usage of all AT
8 AT+HELP AT+HELP
Response: for each AT commands
Functional description
command
of all commands
Query the
enable
AT+HTTP=<Switch>
status of the AT+HTTP=? Http status: 1
Parameter
HTTP
specification:
server
9 AT+HTTP Switch: 0(Off)or
Set the
1(On)
enable
Response:
status of the AT+HTTP=1 Http status set OK
Http status set OK
HTTP
SERVER
AT+HCADDR=<Ser Query
ver Addr>,<Server related
+HCADDR
Port> parameters
AT+HCADDR=? State:OFF,Addr:192.168.1.1,
Parameter of the HTTP
Port:80
specification: CLIENT
10 AT+HCADDR Server Addr:HTTP address
Server IP Set related
Server Port: HTTP parameters
AT+HCADDR=1
Server Port of the HTTP +HCADDR OK
92.168.1.1,80
Response: CLIENT
+HCADDR OK address

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 43


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
Query
AT+HCMODE=<UR
related
L>,<Request>
parameters +HCMODE
Parameter AT+HCMODE=?
of HTTP URL:/post,Request:POST
specification:
CLIENT
URL:Request server
11 AT+HCMODE mode
path (1 ~ 64 bytes)
Request: Request Set related

method GET / POST parameters


AT+HCMODE=/
(1 ~ 10 bytes) of HTTP +HCMODE OK
k.txt,POST
Response: CLIENT
+HCMODE OK mode
AT+HCMODE=<hea Query the
d1>,<head2>,…<head header
+HCHEAD Header:Accept:
n> information AT+HCHEAD=?
*/*
Parameter of HTTP
specification: CLIENT
12 AT+HCHEAD head1~headn:Header
Set the
information, with ","
header
as a sentence, no more
information AT+HCHEAD=, +HCHEAD OK
than 128 bytes
of HTTP
Response:
CLIENT
+HCHEAD OK
AT+KEEPALIVE=< Query
ON/OFF>,<Period>,< related Keepalive status: OFF
AT+KEEPALIVE
len><Info> parameters Period:50 Len:5
=?
Parameter of heartbeat InfoPkt:0102030405
specification: packet
<ON/OFF>:ON/OFF
If OFF, the following
parameters are invalid
(Factory default is
OFF)
AT+KEEPALI <Period >:Heartbeat
13
VE cycle in seconds (1 ~ Set related
300) parameters AT+KEEPALIVE
<Len>: Set the of the =ON,10,5,010203 Keepalive set OK
heartbeat packet heartbeat 0405
length (1 ~ 31) packet
<Info>: Heartbeat
packet content
(Less than 32
hexadecimal digits)
Response:
Keepalive set OK

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 44


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
AT+MULTISP=<Port Query the
> port number AT+MULTISP=? +MULTISP Port:5001
Parameter of the server
specification:
14 AT+MULTISP
<Port>:Multi-client Set the port
AT+MULTISP=5
server port number number of +MULTISP OK
(1~65536) 002
the server
Response:
+MULTISP OK
Query
AT+MADDR=<Serve
r IP/URL >,<Port> related +MADDR
Parameter parameters AT+MADDR=? State:OFF,Addr:www.ebyte.c
specification:
of MQTT om,Port:1883
Server IP/URL:
15 AT+MADDR MQTT server address address
URL or ip
Port:MQTT server Set related
port parameters AT+MADDR=18
Response: +MADDR OK
of MQTT 3.230.40.39,6002
+MADDR OK
address
AT+MUSER=<"Clie Query
ntID">,<"UserName" Related
+MUSER
>,<"UserPWD"> Parameters
AT+MUSER=? ClientID:Roy,UserName:ebyt
Note that this of MQTT
e,UserPwd:123456
parameter needs to be user
quoted information
Parameter
specification:
16 AT+MUSER
Customer ID (up to Set related
64 bytes) parameters
AT+MUSER="55
UserName: user name of MQTT
5656353","28077 +MUSER OK
(up to 64 bytes) user
3","02"
UserPWD: user secret information
(up to 64 bytes)
Response:
+MUSER OK
AT+MSUB=<Topic>, Query
<Qos>
Parameter related
+MSUB
specification: parameters AT+MSUB=?
Topic:Set the Topic:subtopic,Qos:0
of MQTT
subscribed
Sub topic
17 AT+MSUB
Topic Path (up to 64
Set related
bytes)
parameters AT+MSUB=
Qos: Set the +MSUB OK
of MQTT subtopic,0
subscribed Qos
Sub topic
message level 0,1,2

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 45


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
Response:
+MSUB OK
AT+MPUB=<Topic>, Query
<Qos>,<retain>
Parameter related +MPUB
specification: parameters AT+MPUB=? Topic:pubtopic,Qos:0,Retatin:
Topic: Set the
of MQTT 0
reported
Pub topic
Topic path (up to 64
bytes)
18 AT+MPUB
Qos: Set the reported
Set related
Qos message level
parameters AT+MPUB=
0,1,2 +MPUB OK
of MQTT pubtopic,0,0
retain:Set the reported
Pub topic
will parameter 0,1
Response:
+MSUB OK
AT+MODE=<RunMo Query the
de> current +MODE Run
AT+MODE=?
Parameter communicat Mode:NORMAL
specification: ion mode
<RunMode>:
Module operation
mode. The values are:
NORMAL:
Traditional mode,
original function
19 AT+MODE mode
Set the
MQTT:MQTT
current AT+MODE=MQ
mode +MODE OK
communicat TT
HTTP: HTTP
ion mode
CLIENT mode
MULTIS:Multi-
client access mode
MULTIC:Multi-
server connection
mode
Response:
+MODE OK
AT+MAC=?
Parameter
specification: Query mac
20 AT+MAC AT+MAC=? 1893D7429AA7
No parameter address
Response:
MAC address
AT+ONENETIPPOR Query OneNET
AT+ONENETI AT+ONENETIPP
21 T=< related RemoteIP:183.230.40.33
PPORT ORT=?
RemoteIP >,<Remote parameters RemotePort:80

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 46


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
Port > of ONENET
Parameter IP and port
specification:
RemoteIP: IP address
Set related
RemotePort: AT+ONENETIPP
parameters OneNET RemoteIpPort set
Communication ORT=183.230.40.
of ONENET OK
server port 33,80
IP and port
Response:
OneNET
RemoteIpPort set OK
AT+ONENETUNI=< Query user
ON/OFF>,P_ID,A_In OneNET status:OFF
fo,S_name related AT+ONENETUN
P_ID:95205 AU_Info:ebyte1
Parameter parameters I=?
specification: S_Name:Smart
of ONENET
ON/OFF: ON/OFF If
OFF, the following
parameters are invalid
(default OFF)
P_ID: OneNET
AT+ONENETU
22 product ID
NI Set user
A_Info: OneNET AT+ONENETUN
related
Device authentication I=ON,278656,02 , OneNET Uni Set OK
parameters
information EbyteScr
of ONENET
S_name:OneNET
Product script file
name
Response:
OneNET Uni Set OK
AT+ONENETADD=
<index>,<deviceID>,
<Apikey>
Parameter
specification:
Index: Add device to
group index number
(less than 20) AT+ONENETAD
Add
deviceID:OneNET D=1,548806592,
AT+ONENETA ONENET
23 Device ID K0ITQw7RcARC Add Success
DD device ID
of the receiving Hdou22fjSEz3sQ
device U=
Apikey: OneNET
APIkey of the
receiving device
Response:
Add Success

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 47


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
AT+ONENETDEL=<
index>
Parameter
Delete
AT+ONENETD specification: AT+ONENETDE
24 Index: Add device to ONENET Delete Success
EL L
device ID
group index number
(less than 20)
Response:
Delete Success
AT+ONENETSEL=<
index>
Parameter
specification:
Index: Add device to
group index number
(less than 20)
Deviece ID: 548806592
Response: Select
AT+ONENETS AT+ONENETSE APIKey:
25 Deviece ID: ONENET
EL L=1 BFizARKT6LyQClPaT7Qef
17502768 APIKey: device
XOKUrE=
pyZVOnnBGhT=7X0
Bl6oqoaEdh2
(Device exist)
or Deviece ID: -
APIKey: - (The index
has no information)
AT+STATUS=?
Parameter
specification:
No parameter WiFi Status:
AT+STATUS= View link
26 Response: AT+STATUS=? IP=192.168.0.161 ,
? WiFi Status: status
Gateway=192.168.0.1
IP=192.168.1.1 ,
Gateway=0.0.0.0
AT+PM=<Power Query
Mode>,<Delay> related
Parameter parameters
AT+PM=? Power Mode:0 Set Delay:5
specification: of power
Power Mode:Power managemen
consumption mode: t
27 AT+PM
( 0,1,2,3)
Set related
Delay:Delay time to
parameters
enter low power status
of power AT+PM=0,240 Power mode set OK
after waking up
managemen
( 2~240S)
Response: t
Power mode set OK

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 48


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
AT+RESTORE
Parameter Factory
specification:
28 AT+RESTORE No parameter reset AT+RESTORE Restore OK
Response: operation
Restore OK
AT+REGPKT=<ON/ Query
OFF>,<len>,<Info> related
Parameter parameters RegPkt status: OFF Len:5
AT+REGPKT=?
specification: of the RegPkt:0A0B0C0D0E
<ON/OFF>: ON/OFF registration
If OFF, the following packet
parameters are
invalid(factory default
is OFF)
29 AT+REGPKT
<len>: The length of Set related
the set registration parameters
AT+REGPKT=O
packet (1 ~ 31) of the
N,10,0102030405 RegPkt info set OK
<Info>: Registration registration
060708090A
packet content (less packet
than 32 hexadecimal
numbers)
response:
RegPkt info set OK
AT+ROLE=<mode> Query
Parameter network role
AT+ROLE=? Role=AP
specification: of the
mode: module
Set to AP means
Access Point,
providing wireless
30 AT+ROLE
access service
Set network
Set to STA means
role of the AT+ROLE=STA Set STA mode
Station, similar to a
module
wireless terminal
Response:
Set AP mode or
Set STA mode
AT+RST
Parameter
specification:
31 AT+RST No parameter Restart AT+RST +RST OK
Response:
Module rebooting
AT+STAIP=<IPMode Query STAIP:192.168.0.161
>,<STAIP>,<Mask>,
32 AT+STAIP related AT+STAIP=? Mask:255.255.255.0
<Gateway>,<DNS>
Parameter Information Gateway:192.168.0.1

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 49


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
specification: of the STA DNS:192.168.0.1
IPMode:IP mode
IP IPMode:DHCP
(DHCP or STATIC)
STAIP: IP address in
STA mode
Mask: Subnet mask AT+STAIP=DHC
Set related
Gateway: gateway P,192.168.0.161,2
Information
address 55.255.255.0,192. STAIP update OK
of the STA
DNS: DNS server 168.0.1,192.168.0
IP
address .1
Response:
STAIP Update OK
AT+SOCKA=<ON/O Query
FF>,<Protocol>,<Re related +SOCKA
moteIP>,<RemotePor parameters State:OFF,Proto:TCP,RIP:19
AT+SOCKA=?
t>,< LocalPort > of the 2.168.1.1,RPort:7789,LPort:7
Remark: SOCKA secondary 788
SOCKB is the socket A
secondary SOCK and
only supports clients
Parameter
Description:
<ON / OFF>: enable
switch, default is off,
33 AT+SOCKA
OFF is invalid for
Set related
subsequent parameter
parameters AT+SOCKA=ON
setting
of the ,TCP,183.221.116 +SOCKA OK
Protocol: UDP / TCP:
secondary .120,8886,8889
the communication
socket A
protocol used
Remote IP: remote IP
Remote Port: remote
port
Local Port: local port
response:
+ SOCKA OK
Query
AT+SOCKB=<ON/O
related +SOCKB
FF>,<Protocol>,<Re
parameters State:OFF,Proto:TCP,RIP:19
34 AT+SOCKB moteIP>,<RemotePor AT+SOCKB=?
of the 2.168.1.1,RPort:7689,LPort:7
t>,< LocalPort >
secondary 688
Remark:
socketB

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 50


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
SOCKA SOCKB is
the secondary SOCK
and only supports
clients
Parameter
Description:
<ON / OFF>: enable
switch, default is off,
Set related
OFF is invalid for
parameters AT+SOCKB=ON
subsequent parameter
of the ,TCP,183.221.116 +SOCKB OK
setting
secondary .120,8886,8889
Protocol: UDP / TCP:
socketB
the communication
protocol used
RemoteIP: remote IP
RemotePort: remote
port
LocalPort: local port
response:
+ SOCKB OK

Query the
AT+SOCKEBT=<ON
access status
/OFF> AT+SOCKEBT=? +SOCKEBT State:OFF
of EBYTE
Parameter
specification:
<ON/OFF>: Enable
35 AT+SOCKEBT switch,default is off.
When it is off, the
following parameter Set the
settings are invalid. access status AT+SOCKEBT=
+SOCKEBT
Response: of EBYTE ON
+SOCKEBT OK

AT+SOCK=<Protoco Query
l>,<CS>,<RemoteIP> Protocol:TCP CS:CLIENT
,<RemotePort>,< related
RemoteIP:183.230.40.40
LocalPort > parameters AT+SOCK=?
Parameter RemotePort:1811
specification: of the main
LocalPort:8887
Protocol:protocol socket
36 AT+SOCK ( TCP or UDP)
CS:(CLIENT or Set related
SERVER) AT+SOCK=TCP,
parameters
RemoteIP:Remote CLIENT ,183.230 Socket update OK
IP address of the main
.40.40,1811,8887
RemotePort:Remote socket
port number

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 51


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
LocalPort:Local
port number
Response:
Socket Update OK
AT+SMT=<Timeout>
Parameter
specification:
Timeout:Exit this
mode when timeout
(available 0 ~ 255; 0: Enter
37 AT+SMT never exit, 1 ~ 255: SmartConfi AT+SMT=60 Enter into Smartconfig
(Exit after 1 ~ 255 g mode
seconds)
Response:
Enter into
Smartconfig
AT+STA=<SSID>,<S Query
ecType>,< Password> related
AT+STA=? SSID:E880-IR01 TYPE:2
Parameter parameters
specification: of STA
SSID:Service set
38 AT+STA identifier
<1~32Byte> Set related
SecType:Encryption AT+STA=E880-
parameters STA update OK
type IR01,2,JSZXE880
Password: of STA
<8~63Byte>
Response:
STA Update OK
AT+UBEAT=<ON/O Query
FF>,<heard related
words>,<Type>,<peri parameters +UBEAT State:OFF,Heart
AT+UBEAT=?
od> of the serial words:hello,Type:Asc,Peri:5
Parameter heartbeat
specification: packet
<ON/OFF>:
Whether the serial
heartbeat function is
39 AT+UBEAT
enabled. It is not
Set related
enabled by default.
parameters
heard words: AT+UBEAT=ON
of the serial +UBEAT OK
Heartbeat content (up ,EBYTE,0,5
heartbeat
to 64 bytes)
packet
Type:Heartbeat
type:0:ascll
1:HEX
period:Heartbeat

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 52


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual
cycle(0~255)
Response:
+UBEAT OK
AT+UART=<Baud>, Query
<Databit>,<Parbit>,<
Stopbit> related
Parameter Baud:115200 Databit:8
parameters AT+UART=?
specification: Parbit:0 Stopbit:1
Baud:Baud rate of the serial
40 AT+UART (available 300- port
3000000bps)
Set related
Databit:Data bit
Parbit:Parity bit parameters AT+UART=1152
Stopbit:Stop bit Uart update OK
of the serial 00,8,0,1
Response:
Uart Update OK port
Parameter
specification:
No parameter Query
41 AT+VER=? Response: version AT+VER=? E103-W02 V3.0
Print the current information
version information

6. Antenna selection

The default 0R resistor is soldered as shown above (left), and the antenna interface is PCB. If you
need to change the antenna interface mode to IPEX, please change the 0R resistor to the above (right).

7. Customized cooperation

 If customers need to customize products,please contact us.


 Ebyte has reached in-depth cooperation with many well-known enterprises.

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 53


Chengdu Ebyte Electronic Technology Co.,Ltd. E103-W02 User Manual

8. Revision history
Version Date Description Issued by
1.0 2017-10-16 Initial version huaa
1.1 2018-5-23 Content addition huaa
1.2 2018-9-18 Manual split huaa
1.3 2019-2-17 Error correction Ray
1.4 2019-8-9 Content addition All
3.0 2019-12-18 version update Blue

9. About us

Technical support: [email protected]


Documents and RF Setting download link::www.ebyte.com
Thank you for using Ebyte products! Please contact us with any questions or suggestions:
[email protected]
-------------------------------------------------------------------------------------------------
Office hotline:028-64146160 ext. 821
Web: www.ebyte.com
Address: Innovation Center D347, 4# XI-XIN Road,Chengdu, Sichuan, China

Copyright ©2012–2019,Chengdu Ebyte Electronic Technology Co.,Ltd. 54

You might also like