background image

Chengdu Ebyte Electronic Technology Co., Ltd.

E78-868LN22S

User manual

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

2. Terms and definitions

2.1 LoRa

LoRa is one of the LPWAN communication technologies, the full name is Long Range Radio, which means “long-range
radio” in Chinese; the company that currently dominates the technology is the foreign semtech company;
LoRa's main ISM brand is available worldwide for free bands: 433MHz, 470MHz, 868MHz, 915MHz, etc.
Features: Low power consumption, long distance, low cost.

2.2 LoRaWAN

The LoRa Alliance is an open, non-profit organization led by Semtech in March 2015. The Alliance publishes a

low-power WAN standard based on the open source MAC layer protocol: the LoRaWAN protocol standard.
Network topology: star structure
Network composition: LoRa module, gateway (Gateway or base station), Server (including Network Server, Network
control, Application Server).
LoRaWAN divides the LoRa nodes into three categories: A/B/C:

Two-way transmission terminal(Class A)

Class A's terminal will follow two short downlink receiving windows after each uplink to achieve two-way

transmission. The terminal arranges transmission time slots based on its own communication requirements, with a small
change on the basis of random time (ie, ALOHA protocol). This Class A operation provides the lowest power
consumption end system for the application, and only requires the application to perform downlink transmission of the
server in a short time after the terminal uplink transmission. The downstream transmission of the server at any other time
has to wait for the next uplink of the terminal.

Two-way transmission terminal delineating a reception slot(Class B)

Class B terminals have more receive slots. In addition to Class A's random receive window, Class B devices also

open other receive windows at the specified time. In order for the terminal to open the receiving window at a specified
time, the terminal needs to receive a time-synchronized beacon (Beacon) from the gateway. This allows the server to
know when the terminal is listening.

Two-way transmission terminal that maximizes the reception slot (Class C)

The terminal of Class C basically keeps the receiving window open, and only closes briefly when sending. Class C

terminals consume more power than Class A and Class B, but the delay from the server to the terminal is also the
shortest.

Note: The E78-868LN22S supports both Class A and Class C device types.

2.1.3 ADR

ADR Chinese is called adaptive data rate. In the loraWan network system, in order to maximize the battery life and

overall network capacity of the terminal device, the LoRaWAN network server separately manages the data rate and RF
output of each terminal device through an adaptive data rate (ADR) algorithm, through ADR technology, In the
LORAWAN system, the server automatically updates the rate of setting the node according to the signal receiving
capability of the node. The distance is far, the rate is low, and the distance is high, so the actual bandwidth greatly
improves the effective bandwidth and load capacity of the network.

Summary of Contents for E78-868LN22S

Page 1: ...Chengdu Ebyte Electronic Technology Co Ltd E78 868LN22S User manual Copyright 2012 2021 Chengdu Ebyte Electronic Technology Co Ltd E78 868LN22S User Manual LoRaWAN Wireless Module ...

Page 2: ...NICAL PROPERTIES 6 3 1 E78 868LN22S DIMENSIONS 6 3 2 PIN DEFINITION 6 3 3 RECOMMENDED CONNECTION DIAGRAM 7 4 LORAWAN APPLICATION MODEL DIAGRAM 8 5 ACCESS DEMO 9 6 AT COMMAND 11 7 FAQ 27 7 1 COMMUNICATION RANGE IS TOO SHORT 27 7 2 MODULE IS EASY TO DAMAGE 28 8 IMPORTANT STATEMENT 28 9 REVISION HISTORY 29 10 ABOUT US 29 ...

Page 3: ... this document or any part thereof without the express permission of EBYTE is strictly prohibited The information contained herein is provided as is and EBYTE assumes no liability for the use of the information No warranty either express or implied is given including but not limited with respect to the accuracy correctness reliability and fitness for a particular purpose of the information This do...

Page 4: ...r uses an external antenna the impedance matching degree between the antenna and the module at different frequency points will affect the magnitude of the emission current to varying degrees The current consumed by the RF chip in the pure receiving state is called the receiving current Some RF chips with communication protocols or developers have loaded some self developed protocols on the whole m...

Page 5: ...of the server in a short time after the terminal uplink transmission The downstream transmission of the server at any other time has to wait for the next uplink of the terminal Two way transmission terminal delineating a reception slot Class B Class B terminals have more receive slots In addition to Class A s random receive window Class B devices also open other receive windows at the specified ti...

Page 6: ... the power reference ground 2 VCC Power supply range 2 5 3 7v external ceramic filter capacitor is recommended 3 SETB Low power wake up pin 4 LPUART_RX Input Low power UART RXD 5 BUSY Input output NC reserve 6 I2C_SDA Input output NC reserve 7 I2C_SCL Input output NC reserve 8 UART_CTS Input output NC reserve 9 UART_RTS Input output NC reserve ...

Page 7: ... reserve 19 SETA Input NC reserve 20 UART_RX UART RXD 21 UART_TX UART TXD 22 SWD_DATA SWD DATA 23 SWD_CLK SWD CLK 24 GND Ground wire connected to the power reference ground 25 SPI_MISO Input output SPI MISO Test point internally connected cannot act as an external SPI act as Bootloader 26 SPI_NSS Input output SPI MISO Test point internally connected cannot act as an external SPI 27 SPI_MOSI Input ...

Page 8: ...tem consists of node gateway Lora NetWork Server application server the node is generally designed by LORA chip the gateway is designed by SX1301 provided by semtech Lora NetWork Server now has open source loraserver or commercial TTN The ThingsNetwork users can build their own application server is designed and developed by users mainly used for data exchange with Lora NetWork Server applications...

Page 9: ...ology Co Ltd 5 Access demo The demonstration kit is E78 868LN22S as a node E890 as a gateway to access the free TTN TheThingsNetwork test server for communication test node side OTAA access mode corresponding settings are as follows On the TTN the gateway data record is as follows The TTN node data record is as follows ...

Page 10: ...E78 864LN22S 10 Note For the TTN creation device and corresponding configuration process please refer to LORAWAN Node Gateway TTN Server Configuration Tutorial ...

Page 11: ...evEUI OTAA when entering the network CJOINMODE Set the read join mode OTAA ABP CDEVEUI Set to read DevEUI OTAA when entering the network CAPPEUI Set to read AppEUI OTAA when entering the network CAPPKEY Set to read AppKey OTAA when entering the network CDEVADDR Set to read DevAddr ABP when entering the network CAPPSKEY Set to read AppSkey ABP when accessing the network CNWKSKEY Set to read NwkSkey...

Page 12: ...r Command Type Command Format response CGMI Read the manufacturer s logo Query command AT CGMI CGMI manufacturer OK Parameter Description manufacturer Manufacturer identification Return value description Example AT CGMI CGMI Ebyte OK Precautions Command character Command Type Command Format response CGMM Read module identification Query command AT CGMM CGMM model OK Parameter Description model mod...

Page 13: ...scription Example AT CGSN CGSN 0539349E00032523 OK Precautions Command character Command Type Command Format response CGBR Set baud rate Query command AT CGBR CGBR baud OK Setting command AT CGBR baud OK Parameter Description baud baud rate Return value description Example AT CGBR 9600 OK Precautions Only the baudrates under 9600 are supported Command character Command Type Command Format response...

Page 14: ...uery command AT CDEVEUI CDEVEUI value OK Setting command AT CDEVEUI mode OK Parameter Description mode Node DevEUI Return value description Example AT CDEVEUI CDEVEUI AABBCCDD00112233 OK Precautions Set or read DevEUI return Y1Y2 Y8 hexadecimal format and take 8 bytes Command character Command Type Command Format response CAPPEUI Set AppEUI Test command AT CAPPEUI CAPPEUI AppEUI length is 16 Query...

Page 15: ... AppKey return Y1Y2 Y16 hexadecimal format and take 16 bytes Command character Command Type Command Format response CDEVADDR Set DevAddr Test command AT CDEVADDR CDEVADDR DevAddr length is 8 Device address of ABP mode Query command AT CDEVADDR CDEVADDR value OK Setting command AT CDEVADDR value OK Parameter Description value Node DevAddr Return value description Example AT CDEVADDR 00112233 OK Pre...

Page 16: ...KEY value OK Setting command AT CNWKSKEY value OK Parameter Description value Node NwkSKey Return value description Example AT CNWKSKEY AABBCCDD00112233AABBCCDD00112233 OK Precautions Used in ABP set or read NwkSKey return Y1Y2 Y16 hexadecimal format and take 16 bytes Command character Command Type Command Format response CULDLMODE Set upstream and downstream same different frequency Test command ...

Page 17: ... default is normal working mode Currently only normal operation mode is supported Command character Command Type Command Format response CCLASS Set Class Test command AT CCLASS CCLASS class OK Query command AT CCLASS CCLASS class OK Setting command AT CCLASS class OK Parameter Description class 0 classA 2 classC Return value description Example AT CCLASS 2 OK Precautions Need to be set before Join...

Page 18: ...2 ParaValue4 If the input is legal first return OK then start automatic authentication and return the authentication result CJOIN OK Authentication succeeded CJOIN FAIL authentication failed Parameter Description ParaTag1 ParaTag2 ParaTag4 Authentication parameter tag 1 2 4 ParaValue1 ParaValue2 ParaValue4 Authentication parameter value 1 2 4 ParaTag1 indicates that the JOIN operation is performed...

Page 19: ...to be transmitted at different rates are different see LoRaWan protocol for details and 0 indicates that empty packets are sent Payloadhexadecimal 2 characters for 1 number Return value 1 How to judge whether the data transmission is successful Confirm type data Each time a frame of data is sent there should be a corresponding response message When the module fails to receive the response message ...

Page 20: ...ownlink data TYPE 1Byte downstream transmission type Bit0 0 unconfirm 1 confirm Bit1 0 not ACK 1 ACK Bit2 0 not carried 1 carried indicating whether link command response is carried in downlink data Bit30 not carried 1 carried indicating whether time command response is carried in downstream data Only when this bit is 1 time synchronization is successful Bit4 Bit7 default 0 reserved PORT 1Byte dow...

Page 21: ... description value as follows 0 UnConfirmed up message 1 Confirmed up message AT CCONFIRM 1 OK Example Precautions Need to set before sending data Command character Command Type Command Format response CAPPPORT Set the upstream data port number Test command AT CAPPPORT CAPPPORT value OK Query command AT CAPPPORT CAPPPORT value OK Setting command AT CAPPPORT value OK Parameter Description value as ...

Page 22: ... SF12 BW125 1 SF11 BW125 2 SF10 BW125 3 SF9 BW125 4 SF8 BW125 5 SF7 BW125 AT CDATARATE 1 OK Example Precautions Need to be set before sending data invalid after ADR is enabled Command character Command Type Command Format response CNBTRIALS Set the number of times to send Test command AT CNBTRIALS CNBTRIALS MType value OK Query command AT CNBTRIALS CNBTRIALS MType value OK Setting command AT CNBTR...

Page 23: ...fferent Dr s the minimum period allowed is different The definition of period level is adopted as shown in the following table Rate cycle s level LV1 LV2 DR0 150 300 DR1 75 150 DR2 35 70 DR3 15 30 DR4 10 20 DR5 5 10 Return value description reportMode 0 acyclic reporting data 2 Periodic reporting of data reportInterval This parameter is only available when data is reported periodically Time interv...

Page 24: ...m 1 14dBm 2 12dBm 3 10dBm 4 8dBm 5 6dBm 6 4dBm 7 2dBm AT CTXP 1 OK Example Precautions Need to set before sending data Command character Command Type Command Format response CLINKCHECK Verify network connectivity Test command AT CLINKCHECK CLINKCHECK value OK Setting command AT CLINKCHECK value OK Parameter Description value Enable control for Link Check 0 Link Check is not enabled 1 Perform a Lin...

Page 25: ...age in the following format CLINKCHECK Y0 Y1 Y2 Y3 Y4 YO indicates the Link Check result 0 indicates that the Link Check is successfully executed Not 0 indicates that the Link Check execution failed Y1 is DemodMargin Y2 is NbGateways Y3 is the downstream RSSI Y4 is the downstream SNR AT CLINKCHECK 1 OK CLINKCHECK 0 0 1 68 8 Example Precautions Need to set before sending data Command character Comm...

Page 26: ...d set before sending data It is the protocol default value when not set Command character Command Type Command Format response CSAVE Save MAC parameter settings Test command AT CSAVE CSAVE OK Setting command AT CSAVE OK Parameter Description MType 0 unconfirm package 1 confirm package value is the maximum number of transmissions ranging from 1 to 15 Return value description MType 0 unconfirm packa...

Page 27: ... Wait for the radio frame currently being sent in the communication module to complete and then restart AT IREBOOT 1 OK Example Precautions After receiving the instruction the communication module will reply to OK and restart the communication module No further AT commands are received until the restart is complete 7 FAQ 7 1 Communication range is too short The communication distance will be affec...

Page 28: ...e avoid using modules under too high or too low temperature 8 Important statement 1 EBYTE reserves the right of final interpretation and modification of all contents in this manual 2 As the hardware and software of the product continue to improve this manual may be subject to change without further notice and the final version of the manual shall prevail 3 To protect the environment everyone is re...

Page 29: ...al version GLUHAR 1 1 2021 06 29 Remove Freqbandmask add Channelsmask GLUHAR 10 About us Technical support support cdebyte com Documents and RF Setting download link www ebyte com Thank you for using Ebyte products Please contact us with any questions or suggestions info cdebyte com Official hotline 028 61399028 ext 821 Web www ebyte com Address Innovation Center D347 4 XI XIN Road Chengdu Sichuan...

Reviews: