Ebyte E180-ZG120A User manual

E180-ZG120A User Manual
EFR32 2.4GHz ZigBee
SoC wireless module

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
Contents
1.General introduction.................................................................................................................................................... 1
1.1 Brief introduction..............................................................................................................................................1
1.2 Characteristic function......................................................................................................................................1
1.3 Device type introduction...................................................................................................................................2
1.3.1 End-Device.................................................................................................................................................... 2
1.3.2 Sleep-End-Device..........................................................................................................................................2
1.3.4 Coordinator....................................................................................................................................................3
1.4 Application........................................................................................................................................................ 3
2.Technical parameter.....................................................................................................................................................3
2.1 Limit parameter.................................................................................................................................................3
2.2 Working parameters.......................................................................................................................................... 3
3. Mechanical characteristics..........................................................................................................................................5
4. Operation mode...........................................................................................................................................................7
4.1 Transmission mode........................................................................................................................................... 7
4.2 Configuration mode.......................................................................................................................................... 7
4.3 Mode switch......................................................................................................................................................7
4.3.1 Command switch........................................................................................................................................... 7
4.3.2 Pin switching................................................................................................................................................. 7
5.Transmission mode...................................................................................................................................................... 8
5.1 Data transmission mode....................................................................................................................................8
5.1.1 Broadcast mode............................................................................................................................................. 8
5.1.2 Multicast mode.............................................................................................................................................. 8
5.1.3 Unicast Mode.................................................................................................................................................8
5.2 Receive data output method..............................................................................................................................8
5.2.1 Transparent output......................................................................................................................................... 8
5.2.2 Data + short address...................................................................................................................................... 8
5.2.3 Data+Long address........................................................................................................................................9
5.2.4 Data+RSSI.....................................................................................................................................................9
5.2.5 Data+short address+RSSI..............................................................................................................................9
5.2.6 Data+long address+RSSI...............................................................................................................................9
6.Application function and instruction configuration.................................................................................................... 9
6.1 Function pin...................................................................................................................................................... 9
6.1.1 LINK..............................................................................................................................................................9
6.1.2 WAKE............................................................................................................................................................9
6.1.3 AUX...............................................................................................................................................................9
6.1.4 ACK.............................................................................................................................................................10
6.1.5 TOUCHLINK..............................................................................................................................................10
6.1.6 UART_BAUD_RESET...............................................................................................................................10
6.2 Wireless remote configuration function......................................................................................................... 10
6.3 Touch link Functional application.................................................................................................................. 10
6.3.1 Touch link Introduction............................................................................................................................... 10
6.3.2 Steps of creating a touch link network........................................................................................................ 11

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
6.4 Functional parameter description................................................................................................................... 11
6.5 HEX User instruction set................................................................................................................................ 13
6.5.1 Instruction rule............................................................................................................................................ 13
6.5.2 Read instruction set..................................................................................................................................... 14
6.5.3 Configuration instruction set....................................................................................................................... 16
6.5.4 Network operation instruction set............................................................................................................... 18
6.6 HEX Parameter description............................................................................................................................ 18
6.6.1 System transmitting mode........................................................................................................................... 18
6.6.2 Receiving data output mode........................................................................................................................ 18
6.6.3 Network node type...................................................................................................................................... 18
6.6.4 Network state...............................................................................................................................................19
6.6.5 Network PAN_ID........................................................................................................................................ 19
6.6.6 Network short address：............................................................................................................................. 19
6.6.7 MAC address............................................................................................................................................... 19
6.6.8 Short address of father nodes...................................................................................................................... 19
6.6.9 MAC address of father nodes...................................................................................................................... 19
6.6.10 Network group number group................................................................................................................... 19
6.6.11 Network Channel.......................................................................................................................................19
6.6.12 Transmitting Power................................................................................................................................... 20
6.6.13 Buad rate....................................................................................................................................................20
6.6.14 Sleep time.................................................................................................................................................. 20
6.6.15 Storage time of father nodes......................................................................................................................20
6.6.16 Centralized network opening time............................................................................................................ 20
6.6.17 Period of network reconnection after loss of parent node.........................................................................20
6.6.18 The maximum number of attempts to reconnect....................................................................................... 20
6.6.19 Wireless remote configuration ID............................................................................................................. 21
6.6.20 User gpio parameter.................................................................................................................................. 21
6.6.21 User pwm parameter................................................................................................................................. 21
6.6.22 User adc parameter....................................................................................................................................22
6.6.23 Configure all network parameters............................................................................................................. 22
6.6.24 Configure all network parameters............................................................................................................. 22
6.6.25 Number of end-devices of the parent node............................................................................................... 23
6.6.26 Parent node's end-device list..................................................................................................................... 23
6.6.27 Configure the delayed printing time of AUX wake up external MCU serial port in wireless receiving
state.......................................................................................................................................................................23
6.6.28 Configure serial port wake-up hold time...................................................................................................23
6.6.29 Configure endpoint information................................................................................................................24
6.6.30 Set Link key of trust center....................................................................................................................... 24
6.6.31 firmware version number.......................................................................................................................... 24
7.Quick start..................................................................................................................................................................24
7.1 Quickly build ZigBee network....................................................................................................................... 24
7.2 Quickly join a ZigBee network.......................................................................................................................28
7.3 ZigBee Network communication test............................................................................................................. 30
7.3.1 Unicast test.................................................................................................................................................. 30

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
7.3.1.1 Unicast between end-device and coordinator in the form of short address......................................30
7.3.1.2 Unicast in long address form between end-device and coordinator.................................................31
7.3.2 Multicast testing.......................................................................................................................................... 32
7.3.3 Broadcast test.............................................................................................................................................. 34
8. Secondary development design reference................................................................................................................ 35
8.1 Mechanical dimensions and pin definitions................................................................................................... 35
8.2 Schematic design............................................................................................................................................ 37
8.3 Development................................................................................................................................................... 37
8.4 Hardware design............................................................................................................................................. 37
8.5 Software Programming................................................................................................................................... 38
9.FAQ............................................................................................................................................................................39
9.1 Communication range is too short..................................................................................................................39
9.2 Module is easy to damage...............................................................................................................................39
9.3 Bit error rate is too high..................................................................................................................................39
Revision history............................................................................................................................................................ 39
About us........................................................................................................................................................................ 40

Chengdu Ebyte Electronic Technology Co.,Ltd E180-ZG120A User Manual
4
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd.
1.General introduction
1.1 Brief introduction
E180-ZG120A is a small, low-power, high-reliability, 2.4GHz ZIGBEE module
based on Silicon Labs EFR32MG1B, which is designed and produced by Chengdu
Ebyte. The chip comes with high-performance 32-bit ARM Cortex. -M4 core, integrated
internal power amplifier, transmit power up to 20dBm.
EFR32 is a wireless microcontroller for smart home, IoT transformation and industrial automation. EFR32 network
characteristics belong to ZIGBEE 3.0 standard and provide a complete application integration solution based on
IEEE802.15.4 standard ISM band.
E180-ZG120A was certified by a series of authoritative RF instruments, support serial port transparent transmission mode. It also
integrates self-organizing network function, provides multi-channel configurable AD, IO, PWM interface.
1.2 Characteristic function
Centralized network management: ZIGBEE 3.0 security standard centralized network access mechanism, data
security and reliability;
Green Power: ZIGBEE 3.0 power management mechanism, the entire network power consumption is lower, node
power consumption uA level;
Interoperability: ZigBee 3.0 standard network mechanism, support network protocols such as ZHA and ZLL.
Large capacity: 256K flash, 32K RAM, network nodes can be extended to more than 100;
Role switch: Users can switch freely between the coordinator, router, end-device and sleep-end-device via UART
command.
TOUCHLINK: Support TOUCHLINK network protocol, it is mainly used in lighting control, which simplifies
ZigBee network form. It can also establish a simple and stable ZigBee network without coordinator.
Support a variety of network topology: point-to-point, star network, MESH network;
Network self-healing: when network intermediate nodes are lost, other networks automatically join or maintain the
original network;
Auto Routing: The module supports the network routing function；
Address search: User can find the corresponding short address according to the MAC address (unique, fixed) of the
added network node, and can also find the corresponding long address of each node in network according to the
short address of the node;
Data security: Integrated with ZigBee 3.0 security communication standard, the network contains multi-level
security keys;
UART configuration: Module built-in UART commands, the user can configure (view) the parameters and functions
of module via UART command .
Change network PAN_ID: Network PAN_ID switch freely. Users can define PAN_ID to join the corresponding
network by themselves or automatically select PAN-ID to join the network.
Network opening time can be configured and can be configured to open the network for a period of time. During
this period, ZigBee 3.0-compliant devices can join the network. After this period of time, the network will be shut

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
down and no devices can join. It can also be configured to open permanently. Any ZigBee 3.0 standard device can
be added;
GPIO control:Local/remote GPIO control function，there are 4 IO for users to select.
PWM control :Local/remote PWM control function，there are 5 PWM channels for users to select.
ADC control: Read local/remote adc,there are 5 ADC channels for users to select.
Onekey recovery of baud rate: The module supports onekey recovery of baud rate when users forget the baud rate.
The baud rate is 115200(default).
Serial port receiving wake-up: Support serial port receiving wake-up function. When the module is in sleep state, it
will wake up when receiving a frame of data greater than or equal to 25 bytes. This data is wake-up frame used for
wake-up module and will not be treated as data processing;
Module restore: Users can restore the module via UART commands.
Recover factory setting: Users recover the factory setting via UART commands.
Air configuration: Users can use the air configuration command to remotely configure other devices in network.
1.3 Device type introduction
There are three types of logical devices in ZigBee Network: Coordinator, Router, End-Device, and Sleep-End-Device.
AZigBee network consists of one Coordinator and multiple Routers and multiple End-Devices (the end nodes can be
divided into Sleep-End-Device and End-Device.
1.3.1 End-Device
The main task of the device is to send and receive messages, and other nodes are not allowed to connect with the
devices. The End-device is always in working state, and can receive and transmit data at any time. The standby current of
this device type is about 4 mA.
1.3.2 Sleep-End-Device
The Sleep-End-Device enters the sleep state when there is no data receiving and sending, and the sleep current is as
low as about 2.5uA.
When wireless data transmission or instruction operation is needed, wake-up frame shall be sent through serial port
first, and the length shall be more than or equal to 25 bytes (it is recommended to wake up with " FF FF FF FF FF FF FF FF
FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF " 25 bytes of "FF"). The wake-up time lasts for the Uart_holdtime
time, during which the serial port data (configuration command, payload) can be processed. When a frame of serial port
data is successfully received, the wake-up timeout counter will be refreshed, and the wake-up duration will go further by
Uart_holdtime, otherwise the device will go to sleep again. Uart_holdtime defaults to 1000ms and supports HEX
command to change its value.
Sleep terminal wakeup can also be awakened through the function pin WAKE. WAKE defaults to high level. Pull
down the WAKE pin to wake up the module continuously, and release the WAKE pin to restore the default high level and
the module resumes sleep.
When there is data needs to be received, it is received through periodic wake-up. The longer the wake-up cycle is set,
the later the reception will be. The wake-up cycle must be set less than 30 seconds. If you only need to upload data, you
can set the wake-up cycle to be greater than 30 seconds or longer to reduce power consumption (default is 5 minutes),
such as battery powered sensors.
1.3.3 Router
The other nodes are allowed to connect with the routing device to extend the coverage of the network. The main task

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
is to forward packets, play the role of relay routing, and have all the functions of the end-device. If one node has multiple
paths to another node, when one of the paths fails, the network automatically adjusts to other optimal paths for
transmission to ensure data arrives. A router can establish its own network or join someone else's network. The router is
always active, so it must be powered by the main power.
1.3.4 Coordinator
The coordinator has the function of establishing and managing the network, controlling whether other nodes are allowed to join
the network, storing network information, and having all the functions of routing equipment. It’s main task is to manage the network,
record the information of sub nodes, forward messages, and at the same time, the coordinator needs to identify the authority of the end
device requesting access to the network.
1.4 Application
Smart home and industrial sensors；
Security system and positioning system;
Wireless remote control, UAV;
Wireless game remote control;
Health care products；
Wireless voice, wireless headphones；
Meter reading architecture (AMI);
Automotive industry applications.
Building automation solutions
Automation application of agricultural greenhouse.
2.Technical parameter
2.1 Limit parameter
Main parameter
Performance
Remark
Min
Max
Voltage supply（V）
0
3.8
Voltage over 3.8V will cause permanent damage to module
Blocking power（dBm）
-
10
Chances of burn is slim when modules are used in short
distance
Working temperature（℃）
-40
+85
Industrial grade
2.2 Working parameters
Main parameter
Performance
Remark
Min.
Typ.
Max.
Operating voltage（V）
1.95
3.3
3.7
≥3.3 V ensures output power

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
Communication level（V）
3.3
For 5V TTL, it may be at risk of burning down
Working temperature（℃）
-40
-
+85
Industrial design
Frequency（GHz）
2400
-
2480
Support ISM band
Po
we
r
co
nsu
mp
tio
n
TX current（mA）
135
Instant power consumption
RX current（mA）
11.6
Sleep current （μA）
2.5
Instant power consumption
Max Tx power（dBm）
19.6
20.0
20.5
RF transmitting power up to 20dbm
Air data rate（bps）
250kbps
Air data rate is 250kbps
Main parameter
Description
Remark
Distance for reference
1000m
Between two points (ZigBee network supports
routing multi hop function, and the transmission
distance can be extended by increasing the router).
Crystal frequency
38.4MHz
Protocol
Zigbee 3.0
Standard ZigBee 3.0 protocol
Packing
SMD
Connector
1.27mm
Stamp hole
IC
EFR32MG1B232F256GM48
FLASH
256KB
RAM
32KB
Core
Cortex-M4
Size
17.5*28.7mm
Antenna
PCB/IPEX
50 ohm impedance

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
3. Mechanical characteristics
Pin No.
Pin item
Pin
direction
Application
1
GND
Input /Output
Ground, connecting to power source referential ground
2
GND
Input /Output
Ground, connecting to power source referential ground
3
VCC
Input
Power supply positive reference
4
GND
Input /Output
Ground, connecting to power source referential ground
5
PD10
Input /Output
Reserve
6
PD11
Input /Output
Reserve
7
PD12
Input /Output
Reserve
8
PD13
Input
TOUCHLINK pin, which continuously lowers more than 3000ms, will initiate
a zll network establishment or join request
9
PD14
Input
WAKE pin is mainly used to wake up the sleep end device. It is high level

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
when power is on. When the pin is pulled down externally, the sleep end device
will be awakened.
10
PD15
Output
AUX pin indicates the current working state of the device. When the pin is low
power, it indicates that the device is busy and the high-level indicates that the
device is idle.
11
PA0(TX)
Output
TX Serial port send port TX
12
PA1(RX)
Input
RX Serial port receiving port RX
13
PA2
Input /Output
Reserve
14
PA3
Input /Output
Reserve
15
PA4
Input /Output
Reserve
16
PA5
Input /Output
Reserve
17
PB11
Input
Working mode switching pin, working mode switching when the pull-down
time is greater than 500ms
18
PB12
Input
UART_BAUD_RESET pin is used to reset the baud rate, when power on, the
default is high level, In any mode, if the pin is pulled down for more than
1000ms, the serial port parameters will be restored to the default 115200
19
PB13
Output
ACK pin is used to indicate the status of the last user data transmission. Before
starting the transmission, the pin is pulled down, and after the transmission is
successful, the pin is pulled high
20
GND
Input /Output
Ground, connecting to power source referential ground
21
PB14(GPIO0)
Input /Output
GPIO Input/Output port 0
22
PB15(GPIO1)
Input /Output
GPIO Input/Output Port 1
23
GND
Input /Output
Ground, connecting to power source referential ground
24
GND
Input /Output
Ground, connecting to power source referential ground
25
GND
Input /Output
Ground, connecting to power source referential ground
26
PC6(GPIO2)
Input /Output
GPIO Input/Output port 2
27
PC7(GPIO3)
Input /Output
GPIO Input/Output port 3
28
PC8(ADC1)
Input
ADC Detection port 1
29
PC9(ADC2)
Input
ADC Detection port 2
30
PC10(ADC3)
Input
ADC Detection port 3
31
PC11(ADC4)
Input
ADC Detection port 4
32
SWCLK
Input /Output
DBG_SWCLKTCK
33
SWDIO
Input /Output
DBG_SWDIOTMS
34
PF2(PWM0)
Output
PWM Output port 0
35
PF3(PWM1)
Output
PWM Output port 1
36
PF4(PWM2)
Output
PWM Output port 2
37
PF5(PWM3)
Output
PWM Output port 3
38
PF6(PWM4)
Output
PWM Output port 4
39
PF7
Output
LINK pin indicates the current network status, output high level indicates that
the network has been joined
40
RESETN
Input
Reset pin
41
GND
Input /Output
Ground, connecting to power source referential ground
42
GND
Input /Output
Ground, connecting to power source referential ground

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
4. Operation mode
4.1 Transmission mode
When the module enters the transmission mode, any data received by the serial port will be sent out by wireless. The
transmission mode is wireless communication between network nodes, including unicast, broadcast, multicast, etc.
4.2 Configuration mode
When the module enters the configuration mode, the data received by the serial port defaults to the configuration instruction,
which configures and operates the function of the device. In the configuration mode, the data received by the serial port is regarded as
the hex instruction.
4.3 Mode switch
4.3.1 Command switch
The module power on initialization defaults to the transmission mode
In transmission mode, when the serial port receives "2A 2D 2E" character, it will enter the configuration mode. After entering the
configuration mode successfully, it will return "7A 7D 7E " character. In configuration mode, when the serial port of the module
receives "2F 2C 2B " character, the module exits the configuration mode, enters the transmission mode, and returns "7F 7C 7B"
character after entering the transmission mode successfully.
4.3.2 Pin switching
Working mode switch pin PB11, internal configuration pull-up resistance input mode, power on default high level, in any mode,
when mode switch pin PB11 is pulled down more than 500ms, the module working mode switch, as shown in the figure below:
模式引脚电平
模式引脚电平脉冲
>500ms
模式引脚电平脉冲
配置
传输

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
5.Transmission mode
5.1 Data transmission mode
The data transmission mode includes unicast, broadcast and multicast.
5.1.1 Broadcast mode
In broadcast mode, the sending device sends the data received by the serial port to each node in network (including
itself), and all non-sleeping devices in network will receive data.
5.1.2 Multicast mode
In multicast mode, first set the group number (for grouping) for the devices in network. The sending device must specify the
target group number (to which group to send the data). Then the sending device will send the data received by the serial port to the
network, and the devices with the same group number in network will receive the data.
5.1.3 Unicast Mode
In unicast mode, devices in network point to point communicatation through network address , and the transmitting
device sends the received serial port data to the target address device, and the target address device can return an ACK to
the transmitting device to indicate that the data has been received after receiving the data. .
5.2 Receive data output method
The receiving data output mode refers to a manner in which the serial port outputs data after the module receives the
wireless data;
5.2.1 Transparent output
If the output mode of the configuration device is transparent output, the module will output the original data through
the serial port after receiving the wireless data;
5.2.2 Data + short address
When the output mode is data + short address, after receiving the wireless data, the serial port will output the
original data + the short address of the sending device;

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
5.2.3 Data+Long address
When the output mode is data + long address, after receiving the wireless data, the serial port will output the original
data + the long address of the sending device;
5.2.4 Data+RSSI
When the output mode is data + RSSI, after the module receives the wireless data, the serial port will output the
original data + receive the RSSI value of the data packet;
5.2.5 Data+short address+RSSI
When the output mode is data + short address + RSSI, after receiving the wireless data, the serial port will output the
original data + the short address of the sending device + the RSSI value of the received data packet;
5.2.6 Data+long address+RSSI
When the output mode is data + long address + RSSI, after receiving the wireless data, the serial port will output the
original data + the long address of the sending device + the RSSI value of the received data packet;
Note: The maximum packet length supported by the sender for a single packet is 72 bytes.
6.Application function and instruction configuration
6.1 Function pin
6.1.1 LINK
LINK pin indicates the current network status, after the device is successfully connected to the network, the current pin is
pulled high. When the device has no network or the parent node is lost, this pin is pulled low. The external device can
query the device network status through the pin level. In coordinator mode,this pin indicates whether the module is
establishing a network normally;
6.1.2 WAKE
The WAKE pin is mainly used to wake up the dormant terminal. It defaults to a high level when it is powered on.
When the pin is externally pulled down, the dormant terminal device will continue to be awakened. When the pin is
released externally, it will return to high level and enter sleep; Sleep time is determined by the duration of the external
pull down of this pin; for non-sleeping devices, this pin is meaningless;
6.1.3 AUX
The AUX pin indicates the current working status of the device. When the pin is low, the device is busy; when the

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
pin is high, the device is idle; when the device receives data, the module will pull the AUX pin low after AUX_delaytime,
and the serial port will start outputting Data, used to wake up the external control device, AUX_delaytime is 4ms by
default, which can be changed by the serial port command, and the customer can decide according to the wake-up time of
the main chip;
6.1.4 ACK
ACK pin is used to indicate the status of the last user data transmission, The pin is pulled low before the transmission is
started. After the transmission is successful, the pin is pulled high. The user can judge whether the data is successfully
arrived by the status of the pin. This pin function does not instruct the coordinator to send a broadcast message.
6.1.5 TOUCHLINK
TOUCHLINK pin, which is continuously pulled low for more than 3000ms, will initiate a ZLL network setup or join
request. ZLL's touch link protocol includes an initiator and a target. The initiator is End-device and Sleep-End-device.
The target is generally a router. When the touch link pin is continuously pulled down for more than 3000ms, the initiator
will send a network establishment or joining request to the target.
6.1.6 UART_BAUD_RESET
UART_BAUD_RESET pin is used to reset the baud rate, The default level is high when the device is powered on.
In any mode, the pin of the module is pulled down for more than 1000ms. The serial port parameters will be restored
to the default 115200 and 8N1.
Function pin
Pin port
LINK
PF7
WAKE
PD14
AUX
PD15
ACK
PB13
TOUCHLINK
PD13
UART_BAUD_RESET
PB12
6.2 Wireless remote configuration function
The module supports remote configuration function. The 2-byte wireless configuration ID is identified by A8 8A by
default. The user can modify the remote configuration ID. When the first two bytes of wireless air data received by the module
are wireless configuration ID, the module judges that the data packet is a remote configuration command and executes the
corresponding command operation. The data packet will not be output through the serial port.
6.3 Touch link Functional application
6.3.1 Touch link Introduction
Touch link belongs to the standard networking mechanism in ZigBee Light Link (ZLL) protocol. Touch link is a
contact connection. When two modules are close to each other within a certain range, touch link is activated by button or
command. A ZigBee communication network is established between the two modules.

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
The touch link of the ZLL protocol defines an initiator and a target. The primary responsibility of the initiator is to
initiate the touch link process, which is usually defined as the initiator. The target's role is to wait for a nearby touch link
request. If the initiator does not have a network, the target needs to establish a new network. If the initiator has a network,
the target joins the initiator's network. The lower router will be defined as the target. In a typical light control application,
the remote is the end-device initiator and the light is the router target.
6.3.2 Steps of creating a touch link network
(1) First, before the initiator (end-device) initiates a touch link network, if the initiator (end-device) has joined other
networks before,the information of the previous network must be removed to make the network state in the state of no network.
(2)Secondly, the initiator (end-device) initiates a touch link scan request to discover the target person (router)
existing around, and the scanned person is as close as possible to the initiator in scanning process, and the other devices
are far away from the scanning area as much as possible (the threshold of the scanning signal is -40 dBm) , that is,
devices with signal strength greater than -40dBm will be scanned), if scanning more than two target devices will affect
the success rate of touch link
(3) Secondly, after the initiator scans the target device, if it initiates the touch link for the first time, it initiates a
request to create a new network to the target; if the touch link has succeeded before, it initiates the touch link to the target.
Network request.
(4) Finally, the target responds to the initiator's request to create a new network or join the touch link network.
After the above steps, a new ZLL touch link network has been completed. There may only be one initiator in
network, and other nodes are all targets. Before the touch link, the initiator must first clear the previously added network.
During the touch link process, only one device is close to one device at a time. The touch link network can be used
without coordinator and only requires end-device and router, so that the network is simpler and more convenient, and is
widely used in the field of lighting control.
6.4 Functional parameter description
The module provides a wide range of configurable parameters that can be flexibly adapted to the actual application
needs to build different forms of network.
Configuration
information
Property
Parameter
range
Function Description
PANID
Read/write
0x0000～
0xFFFF
The PANID is the network identifier of ZIGBEE and is used to
determine the identity of the network to which it belongs. All
devices in the same network must have the same PANID. When
the end-device or router is configured as 0xFFFF, it can join any
network that already exists on the same channel；
Local network
address
Read
0x0000～
0xFFFF
It is used to distinguish each node in network. Each device is in
the same network. The local network address must be unique.
When the network is not added, the network address of the device
is 0xFFFF. After joining, the short address of the device is
allocated by the coordinator. The coordinator is fixed at: 0x0000;
Network status
Read
0、1、2、3、
4
Indicates the network status of the current device, including no
network, currently joining the network, successfully joining the
network, having the network but losing the parent node, leaving
the current network, and so on;

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
Target network
address
Read/write
0x0000～
0xFFFF
The current device communication destination (short address) can
be switched at any time through configuration commands;
Local MAC
address
Read
64bitMAC
Module factory MAC address, user can not be changed
Target MAC
address
Read/Write
64bitMAC
In fixed-point mode, use long address to send;
Device type
Read/Write
C、R、E、S
They are: coordinator, router, end-device and sleep end-device;
Channel
Read/Write
CH11～26
The physical channel through which ZIGBEE works;
Transmit mode
Read/Write
0、1、2、3、
4、5
The transmission modes of the configuration module are: broadcast mode,
multicast mode, short address on demand mode, long address on demand
mode, protocol on demand, and protocol multicast. For details, please see
the corresponding mode function introduction;
Output mode
Read/Write
0、1、2、3、
4、5
The data output mode is:
Transparent transmission;
Data + short address;
Data + long address;
Data + RSSI;
Data + short address + RSSI;
Data + long address + RSSI;
Transmitting
power
Read/Write
0～20dbm
Module output power: 0 to 20dbm; high power consumption
requirements, where the distance is not required, the transmission
power can be reduced to save average power consumption;
Remote
configuration
ID
Read/Write
2 byte
It is used to determine whether the data received by the air in the
air is a remote configuration command. The customer can change
the unlimited configuration ID according to the requirements. The
default is A8 8A;
Local network
group number
Read/Write
0～255
Used to configure the device number of the device in network;
Target network
group number
Read/Write
0～255
Group number corresponding to the target when configuring device
multicast;
Wake-up period
(sleep time)
Read/Write
0～2010s
It is used to configure the wake-up cycle of the end-device sleep device.
The larger the cycle is, the lower the overall power consumption is, but
the greater the delay of receiving data is;
Network
opening time
Read/Write
10～2540s
It is used to configure the opening and closing of network security.
During the opening period, the device can join the network, and during
the closing period, the device cannot join;
Lost parent node
reconnection
period
Read/Write
1～255
minutes
When the parent node is lost (the coordinator is powered down), the end-
device reconnects the previous network at regular intervals;
Maximum
number of
reconnections
Read/Write
1 to 255
times
After the parent node is lost, the maximum number of
reconnections, if it has not been reconnected successfully, clears
the previous network information, rescans the new network, and
the scanning period is equal to the reconnection period;
IO state
Read/Write
High/Low
Access/control module level status of the GPIO channel;

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
PWM
Read/Write
1～65535ms
Access/control module duty cycle and period of the PWM
channel;
ADC value
Read
0～3700mv
Read the ADC value of the device, where 0 channel can read the
device power voltage value, and the ADC can detect 3.7V voltage
when the voltage is up to 3.7V;
6.5 HEX User instruction set
6.5.1 Instruction rule
Local serial port read format:
Network parameter reading FE LEN CMD FF
Peripheral parameter reading FE LEN CMD CHANNEL FF
FE :fixed head
LEN: Actual length of DATA
CMD: Actual named ID
CHANNEL: Channel selection for PWM, ADC, GPIO read
FF：Command terminator
Read return format：FB CMD DATA
FB : fixed head
CMD: Command ID
DATA: parameter
Local serial port configuration format：FD LEN CMD DATA FF
FD : fixed head
LEN: Actual length of DATA
CMD: Actual named ID
DATA: Actual parameter
FF：Command terminator
Configuration return：FA CMD
FA: fixed head
CMD: Command ID
Return when reading / configuring access: F7 FF does not exist the information / reading / configuration / format failed
Wireless remote reading/ configuration format: add the wireless configuration ID before the instruction format of local serial port
mode
The default is A8 8A (The value can be modified), for example:
The configuration format is A8 8A FD LEN CMD DATA FF
Parameter reading format: A8 8A FE LEN CMD (CHANNEL) FF
Network operation format：F5 LEN CMD DATA FF
F5 : fixed head
LEN: Actual length of DATA
CMD: Actual named ID
DATA: Actual parameter

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
FF：Command terminator
Configuration return：FC CMD STATUS
FC: Fixed head
CMD: Actual named ID
Status: 00 operation succeeded
01 operation failed
6.5.2 Read instruction set
Command description
Command
ID
Command format
Command example
Read device type
01
Send：FE 01 01 FF
Return：FB 01 dev_type
Send：FE 01 01 FF
Return：FB 01 03
Read network state
02
Send：FE 01 02 FF
Return：FB 02 nwk_state
Send：FE 01 02 FF
Return：FB 02 02
Read network PAN_ID
03
Send：FE 02 03 FF
Return：FB 03 pan_id
Send：FE 02 03 FF
Send：FB 03 FE 5B
Read local short address
05
Send：FE 02 05 FF
Return：FB 05 Short_Addr
Send：FE 02 05 FF
Return：FB 05 F6 FA
Read local MAC address
06
Send：FE 08 06 FF
Return：FB 06 Mac_Addr
Send：FE 08 06 FF
Return：FB 06 1F 1C 21 FE
FF 57 B4 14
Read short address of father
nodes
07
Send：FE 02 07 FF
Return：FB 07
Coor_shortAddr
Send：FE 02 07 FF
Return：FB 07 00 00
Read short MAC address of
father nodes
08
Send：FE 08 08 FF
Return：FB 08 Coor
_Mac_Addr
Send：FE 08 08 FF
Return：FB 08 0C 46 0C FE
FF 9F FD 90
Read network group number
09
Send：FE 01 09 FF
Return：FB 09 group
Send：FE 01 09 FF
Return：FB 09 01
Read communication channel
0A
Send：FE 01 0A FF
Return：FB 0A channel
Send：FE 01 0A FF
Return：FB 0A 0B
Read Send power
0B
Send：FE 01 0B FF
Return：FB 0B txpower
Send：FE 01 0B FF
Return：FB 0B 0A
Read UART baud rate
0C
Send：FE 01 0C FF
Return：FB 0C baud
Send：FE 01 0C FF
Return：FB 0C 09
Read sleep time
0D
Send：FE 01 0D FF
Return：FB 0D sleep_time
Send：FE 01 0D FF
Return：FB 0D 54
Read target short network
address
23
Send：FE 02 23 FF
Return：FB 23
Dec_ShortAddr
Send：FE 02 23 FF
Return：FB 23 00 00

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
Read target network group
number
24
Send：FE 01 24 FF
Return：FB 24 Dec_netid
Send：FE 01 24 FF
Return：FB 24 00
Read target long address
25
Send：FE 08 25 FF
Return：FB 25 Dec_mac
Send：FE 08 25 FF
Return：FB 25 0A 1C 21
FE FF 57 B4 14
Read system transmitting
mode
26
Send：FE 01 26 FF
Return：FB 26 send_mode
Send：FE 01 26 FF
Return：FB 26 02
Read data output mode
27
Send：FE 01 27 FF
Return：FB 27 out_mode
Send：FE 01 27 FF
Return：FB 27 00
Read centralized network
open time
28
Send：FE 01 28 FF
Return：FB 28 net_opentime
Send：FE 01 28 FF
Return：FB 28 FF
The parent node loses the
network reconnection
period
29
Send：FE 01 29 FF
Return：FB 29
net_rejoinperiod
Send：FE 01 29 FF
Return：FB 29 05
The maximum number of
times the parent node lost
network reconnection
30
Send：FE 01 30 FF
Return：FB 30
net_rejoincount
Send：FE 01 30 FF
Return：FB 30 05
Read wireless
configuration ID
31
Send：FE 02 31 FF
Return：FB 31 header
Send：FE 02 31 FF
Return：FB 31 A8 8A
Read all device data
FE
Send：FE 2F FE FF
Return：FB FE all_info
Send：FE 2F FE FF
Return：FB FE 03 02 FE 5B
F6 FA 1F 1C 21 FE FF 57
B4 14 00 00 0C 46 0C FE
FF 9F FD 90 01 0B 0A 09
54 00 00 00 0A 1C 21 FE FF
57 B4 14 02 00 FF 05 05 A8
8A
Read remote/local GPIO level
20
Send：FE 03 20 GpioId FF
Return：FB 20 GpioId In/Out
level
Send：FE 03 20 00 FF
Return：FB 20 00 01 01
Read remote/local PWM state
21
Command：FE 06 21 PWMId
FF
Return：FB 21 PWMId
start/stop
Period Period duty
duty
Send：FE 06 21 00 FF
Return：FB 21 00 01
0A 3E 63 50
Read local /remote ADC state
22
Command：FE 03 22 adcid FF
Return：FB 22 adcid voltage1
voltage2
Send：FE 03 22 00 FF
Return：FB 22 00 0C E4
Number of end-device
nodes reading the parent
node
32
Command：FE 01 32 FF
Return：FB 32 child_count
Send：FE 01 32 FF
Return：FB 32 0A
Read the parent node's
33
Command：FE 0E 33 FF
Send：FE 0E 33 FF

Chengdu Ebyte Electronic Technology Co.,Ltd. E180-ZG120A User Manual
Copyright ©2012–2019, Chengdu Ebyte Electronic Technology Co.,Ltd. 1
end-device node schedule
Return：FB 33 index dev_type
Short_Addr Mac_Addr
Return：FB 33 00 03 FE 5B
0A 1C 21 FE FF 57 B4 14
Read the firmware
version number
34
Command：FE 03 34 FF
Return：FB 34 FirmwareVersion
Send：FE 03 34 FF
Return：FB 34 82 69 01
Read the delayed printing
time of AUX wake up
external MCU serial port
in wireless receiving state
35
Send：FE 01 35 FF
Return：FB 35 AUX_delaytime
Send：FE 01 35 FF
Return：FB 35 04
Read UART wake up
keep time
36
Send：FE 01 36 FF
Return：FB 36 Uart_holdtime
Send：FE 01 36 FF
Return：FB 36 64
Read port info.
37
Send：FE 05 37 FF
Return：FB 37 Endpoint_info
Send：FE 05 37 FF
Return：FB 37 01 FE B0
05 04
Read link key of trust
center
38
Send：FE 10 38 FF
Return：FB 10 TrustCentLinkKey
Send：FE 10 38 FF
Return：FB 38
5A 69 67 42 65 65 41 6C
6C 69 61 6E 63 65 30 39
6.5.3 Configuration instruction set
Configure device type
Send：FD 01 01 dev_type FF
Return：FA 01
Send：FD 01 01 03 FF
Return：FA 01
Configure PAN_ID
Send：FD 02 03 pan_id FF
Return：FA 03
Send：FD 02 03 FE 5B FF
Return：FA 03
Configure the network
group number
Send：FD 01 09 group FF
Return：FA 09
Send：FD 01 09 01 FF
Return：FA 09
Configuring
communication channel
Send：FD 01 0A channel FF
Return：FA 0A
Send：FD 01 0A 0B FF
Return：FA 0A
Configure transmit power
Send：FD 01 0B txpower FF
Return：FA 0B
Send：FD 01 0B 0A FF
Return：FA 0B
Configure serial port baud rate
Send：FD 01 0C baud FF
Return：FA 0C
Send：FD 01 0C 09 FF
Return：FA 0C
Configure sleep time
(end-device valid)
Send：FD 01 0D sleep_time FF
Return：FA 0D
Send：FD 01 0D 54 FF
Return：FA 0D
Configure the target
network short address
Send：FD 02 23 dec_addr FF
Return：FA 23
Send：FD 02 23 00 00 FF
Return：FA 23
Configure the target
network group number
Send：FD 01 24 netid FF
Return：FA 24
Send：FD 01 24 00 FF
Return：FA 24
Configure target long
address
Send：FD 08 25 dec_mac FF
Return：FA 25
Send：FD 08 25 0A 1C 21
FE FF 57 B4 14 FF