User Manual for EBYTE models including: E87-868LN22S, LoRaWAN Wireless Module, E87-868LN22S LoRaWAN Wireless Module
E78-864LN22S 6 3.Mechanicalproperties 3.1E78-868LN22SDimensions 3.2Pindefinition No. Name Direction Function 1 GND Ground wire, connected to the power reference
20 avr. 2021 — EBYTE reserves all rights to this document and the information contained herein. Products, names, logos and designs described herein may in whole or in part ...
Chengdu Ebyte Electronic Technology Co., Ltd. E78-868LN22S User manual E78-868LN22S User Manual LoRaWAN Wireless Module Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd. E78-864LN22S Content 1. OVERVIEW.............................................................................................................................................................................................3 1.1 MAIN PARAMETER.......................................................................................................................................................... 4 1.2 PARAMETER DESCRIPTION.............................................................................................................................................4 2. TERMS AND DEFINITIONS................................................................................................................................................................. 5 3. MECHANICAL 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 2 E78-864LN22S Disclaimer EBYTE reserves all rights to this document and the information contained herein. Products, names, logos and designs described herein may in whole or in part be subject to intellectual property rights. Reproduction, use, modification or disclosure to third parties of 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 document may be revised by EBYTE at any time. For most recent documents, visit www.ebyte.com. 3 E78-864LN22S 1. Overview E78-868LN22S is a standard LoraWan node module designed and manufactured by Chengdu Ebyte Electronic Technology Co., Ltd., working frequency band EU863~870MMHZ, supports CLASS-A/CLASS-C node type, supports ABP/OTAA two network access modes, and at the same time, this module With a variety of low-power modes, the external communication interface uses a standard UART. Users can easily access the standard LoraWan network through AT commands, making it an excellent choice for IoT applications. 1.1 main parameter Product model E78-868LN22 S Core IC ASR6601 Size 26* 16*2.8 mm Net weight 2.0±0.1g working temperature -40 ~ 85 Working humidity 10% ~ 90% Storage temperature -40 ~ 125°C 1.2 Parameter Description When designing the power supply circuit for the module, it is recommended to reserve more than 30% of the remaining amount, and the whole machine is conducive to long-term stable operation The current required for the instant of launch is large but often because the launch time is extremely short, the total energy consumed may be smaller When the customer 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 machine, which may cause the receiving current of the test to be too large The current in the purely receiving state is often mA level, and the "receiving current" of the A level needs to be processed by the developer through software; The shutdown current is often much smaller than the current consumed by the power supply part of the whole machine at no load, without being overly demanding; Since the material itself has a certain error, a single LRC component has an error of ±0.1%. However, since a plurality of LRC components are used in the entire RF loop, there is a case where error accumulation occurs, resulting in a difference in emission current and reception current of different modules; Reducing the transmit power can reduce power consumption to some extent, but reducing the transmit power emissions for a number of reasons reduces the efficiency of the internal PA. 4 Chengdu Ebyte Electronic Technology Co., Ltd. 2. Terms and definitions E78-868LN22S User manual 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. Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd. E78-864LN22S 3. Mechanical properties 3.1 E78-868LN22S Dimensions 3.2 Pin definition No. Name Direction Function 1 GND Ground wire, connected to 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) 6 E78-864LN22S Ground wire, connected to the power reference 10 GND Input/output ground Antenna interface, stamp hole (50 ohm 11 ANT Input/output characteristic impedance) Ground wire, connected to the power reference 12 GND Input/output ground Ground wire, connected to the power reference 13 GND Input/output ground Ground wire, connected to the power reference 14 GND Input/output ground Ground wire, connected to the power reference 15 GND Input/output ground 16 XRES Input/output External reset pins 17 ADC_IN Input NC(reserve) 18 AUX NC(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 SPI MISO Test point, internally connected, cannot 25 SPI_MISO Input/output act as an external SPI(act as Bootloader) SPI MISO Test point, internally connected, cannot 26 SPI_NSS Input/output act as an external SPI SPI MISO Test point, internally connected, cannot 27 SPI_MOSI Input/output act as an external SPI SPI MISO Test point, internally connected, cannot 28 SPI_SCK Input/output act as an external SPI For the pin definition, software driver and communication protocol of the module, please refer to ASR officialASR6601 Datasheet 3.3 Recommended connection diagram 7 Chengdu Ebyte Electronic Technology Co., Ltd. 4. LoraWan application model diagram E78-868LN22S User manual The complete LoraWan network system 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. Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd. Chengdu Ebyte Electronic Technology Co., Ltd. E78-868LN22S User manual 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: Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd. E78-864LN22S Note: For the TTN creation device and corresponding configuration process, please refer to LORAWAN Node + Gateway TTN Server Configuration Tutorial 10 Chengdu Ebyte Electronic Technology Co., Ltd. E78-868LN22S User manual 6. AT command a) Command format <CMD>[op][ para1, para2, para3,...]<CR><LF> Command prefix CMDControl command [op]Command operatorCan be the following: "="indicates the parameter setting. "?"Indicates the current value of the query parameter. ""indicates the execution of the command. "=?"Indicates the parameters of the query setting instruction. [para-n]Indicates the set parameter value or specifies the parameter to be queried. <CR><LF>Enter to change linesASCII 0x0D 0x0A Command Description (general order) CGMI Read the manufacturer's logo CGMM Read module identification CGMR Read version identifier CGSN Read product serial number identifier CGBR Set the baud rate of the UART CJOINMODE Set the read join mode (OTAA, ABP) CDEVEUI Set to read DevEUI (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 (ABP when accessing the network) CCHANNELSMASK Set the read frequency mask (ChannelsMask) CULDLMODE Set to read the Ul/Dl mode (same frequency or different frequency) CWORKMODE Set the read working mode (normal working mode) CCLASS Set the read class type (Class A/C) CBL Read battery level CSTATUS Read node status CJOIN Initiate OTAA access to the network DTRX Send and receive data frames DRX Get the latest received data from Rx buffer and empty Rx buffer Command Description (MAC related configuration command) CCONFIRM Set the type of read send message (confirm or unconfirm) CAPPPORT Set the read application layer port CDATARATE Set the read data rate Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd. E78-864LN22S CRSSI CNBTRIALS CRM CTXP CLINKCHECK CADR CRXP CRX1DELAY CSAVE CRESTORE IREBOOT Get the RSSI value of the channel Set the read NbTrans parameter Set the read report mode Set the read transmit power Enable Link check Enable or disable ADR Set the read receive window parameters Set the delay to read TX and RX1 Save configuration Restore default configuration System reset Command character CGMI (Read the manufacturer's logo ) Command Type Query command Parameter Description Return value description Example Command Format AT+CGMI? response +CGMI=<manufacturer> OK <manufacturer> Manufacturer identification AT+CGMI? +CGMI=Ebyte OK Command character CGMM (Read module identification) Command character CGMR (Read version Precautions Command Type Query command Parameter Description Return value description Example Precautions Command Type Query command Command Format AT+CGMM? response +CGMM=<model> OK <model> module identification AT+CGMM? +CGMM=E78-868LN22S OK Command Format AT+CGMR? response +CGMR=<revision> OK 12 E78-864LN22S identifier) Command character CGSN (Read product serial number identifier) Command character CGBR (Set baud rate) Command character CJOINMODE (Set the Join mode) Parameter Description Return value description Example Precautions Command Type Query command Parameter Description Return value description Example Precautions Command Type Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting <revision> version number AT+CGMR? +CGMR=V1.1.0 OK Command Format AT+CGSN? response +CGSN=<sn> OK <sn> Product serial number identifier AT+CGSN? +CGSN=0539349E00032523 OK Command Format AT+CGBR? AT+CGBR=<baud> response +CGBR=<baud> OK OK <baud> baud rate AT+CGBR=9600 OK Only the baudrates under 9600 are supported. Command Format response AT+CJOINMODE=? AT+CJOINMODE? AT+CJOINMODE=<mode> +CJOINMODE:"mode" OK +CJOINMODE:<mode> OK OK 13 E78-864LN22S Command character CDEVEUI (Set DevEUI) Command character CAPPEUI (Set AppEUI) command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example <mode>Node Join mode 0:OTAA 1:ABP AT+CJOINMODE=0 OK Different mode nodes have different network access modes. ABP should use this command before sending data. Command Format response AT+CDEVEUI=? AT+CDEVEUI? AT+CDEVEUI=<mode> +CDEVEUI=<DevEUI:length is 16> +CDEVEUI:<value> OK OK <mode>Node DevEUI AT+CDEVEUI? +CDEVEUI=AABBCCDD00112233 OK Set or read DevEUI, return Y1Y2...Y8, hexadecimal format, and take 8 bytes. Command Format response AT+CAPPEUI=? AT+CAPPEUI? AT+CAPPEUI=<value> +CAPPEUI=<AppEUI:length is 16> +CAPPEUI:<value> OK OK <value> Node AppEUI AT+CAPPEUI=AABBCCDD00112233 OK 14 E78-864LN22S Command character CAPPKEY (Set AppKey) Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Used in OTAA, set or read AppEUI, return Y1Y2...Y8, hexadecimal format, and take 8 bytes. Command Format response AT+CAPPKEY=? +CAPPKEY=<AppKey:length is 32> AT+CAPPKEY? + CAPPKEY:<value> OK AT+CAPPKEY =<value> OK <value> Node AppEUI AT+CAPPKEY=AABBCCDD00112233AABBCCDD00112233 OK Command character CDEVADDR (Set DevAddr) Command character CAPPSKEY (Set AppSKey) Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Used in OTAA, set or read AppKey, return Y1Y2...Y16, hexadecimal format, and take 16 bytes. Command Format response AT+CDEVADDR=? AT+CDEVADDR? +CDEVADDR=<DevAddr:length is 8 Device address of ABP mode> +CDEVADDR:<value> OK AT+CDEVADDR =<value> OK <value>Node DevAddr AT+CDEVADDR=00112233 OK Used in ABP, set or read DevAddr, return Y1Y2...Y4, hexadecimal format, and take 4 bytes. Command Format response AT+CAPPSKEY=? +CAPPSKEY=<AppSKey:length is 32> AT+CAPPSKEY=<value> +CAPPSKEY:<value> OK 15 E78-864LN22S Command character CNWKSKEY (Set NwkSKey) Command character CULDLMODE (Set upstream and downstream same/different frequency) Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example AT+CDEVADDR =<value> OK <value>Node AppSKey AT+CAPPSKEY=AABBCCDD00112233AABBCCDD00112233 OK Used in ABP, set or read AppSKey, return Y1Y2...Y16, hexadecimal format, which takes 16 bytes. Command Format response AT+CNWKSKEY=? AT+CNWKSKEY? +CNWKSKEY =<NwkSKey:length is 32> +CNWKSKEY:<value> OK AT+CNWKSKEY=<value> OK <value> Node NwkSKey AT+CNWKSKEY=AABBCCDD00112233AABBCCDD00112233 OK Used in ABP, set or read NwkSKey, return Y1Y2...Y16, hexadecimal format, and take 16 bytes. Command Format response AT+CULDLMODE=? AT+CULDLMODE? +CULDLMODE:"mode" OK +CULDLMODE:<mode> OK AT+CULDLMODE=<mode> OK <mode> 1Same frequency mode 2Different frequency mode AT+CULDLMODE=2 OK 16 E78-864LN22S Command character CWORKMODE (Set working mode) Command character CCLASS (Set Class) Command character CSTATUS (Query the current status of the device) Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Set before Join Command Format AT+CWORKMODE=? AT+CWORKMODE? AT+CWORKMODE=<mode> response +CWORKMODE:"mode" OK +CWORKMODE:<mode> OK OK <mode> 2Normal operation mode AT+CWORKMODE=2 OK It needs to be set before joining, and the default is normal working mode Currently only normal operation mode is supported Command Format response AT+CCLASS=? AT+CCLASS? +CCLASS:"class" OK +CCLASS:<class> OK AT+CCLASS=<class> OK <class>: 0:classA 2:classC AT+CCLASS=2 OK Need to be set before Join, the default is classA Command Format response AT+CSTATUS=? AT+CSTATUS? +CSTATUS:"status" OK +CSTATUS:<status> OK 17 E78-864LN22S Command character CJOIN (Set Join) Parameter Description Return value description Example Command Type Test command Query command Setting command Parameter Description Return value description <status> 00 No data operation 01 Data transmission 02 Data transmission failed 03 Data sent successfully 04 JOIN succeeded (only in the first JOIN process) 05 JOIN failed (only in the first JOIN process) 06 The network may be abnormal (Link Check result) 07 Successful data transmission, no downstream 08 Send data successfully, with downstream AT+CSTATUS? +CSTATUS=03 OK Query the current status of the device Command Format response AT+CJOIN=? +CJOIN:<ParaTag1>,[ParaTag2],...[Para Tag4] OK AT+CJOIN? +CJOIN:<ParaValue1>,[ParaValue2],...[ ParaValue4] OK AT+CJOIN=<ParaValue1> If the input is legal, first return OK, then start automatic authentication and return [ParaValue2],.... the authentication result. [ParaValue4] +CJOIN:OK Authentication succeeded +CJOIN: FAIL authentication failed <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, ParaTag1 Ranges 0 stop JOIN 1 start JOINRestart the JOIN process again. For modules that enable hot start, performing this action clears the saved JOIN context parameters. [ParaTag2] Indicates whether the automatic JOIN function is enabled.The factory value is 1 ParaTag2 value range 0 turn off automatic JOIN 1 The automatic JOIN. module automatically starts JOIN after entering the transparent mode. [ParaTag3]indicates the JOIN period,Range of values 7~255, The unit is s. Factory default: 8 18 E78-864LN22S Command character Example Precautions Command Type Test command [paratag4] indicates the maximum number of join attempts. Paratag4 value range: 1-255 AT+CJOIN=1,1,10,8Set the join parameter: enable automatic join, the join cycle is 10s, and the maximum number of attempts is 8 OK +CJOIN:OK Set before Join. Command Format response AT+DTRX=? +DTRX:[confirm],[nbtrials],<Length>,< Payload> OK DTRX (Send and receive data) Setting command Parameter Description Return value description OK+SEND:TX_LEN AT+DTRX=[confirm], OK+SENT:TX_CNT [nbtrials],<Length>, <Payload> OK+RECV:TYPE,PORT,LEN,DATA or ERR+SEND:ERR_NUM ERR+SENT:TX_CNT Confirm and nbtrials refer to the corresponding AT command, which is valid only for this transmission, optional. Lengthindicates the number of strings; the maximum value is described in the access specification; the byte lengths allowed 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, if it does not reach the maximum number, it will retry again. If the downlink message is not received after the maximum number of times is reached, it is a failure and output. ERR+SENT message. During this period, if the transmission of the response message is received, it is successful and the OK+SEND, OK+SENT and OK+RECV messages are output. Unconfirm type data: The downlink response will not be requested after the data is sent, and the OK+SEND, OK+SENT message will be returned at the end of each transmission. If the downlink data is received, the OK+RECV message is sent. 2Data sending status prompt 19 E78-864LN22S Example OK+SEND: TX_LEN indicates that the data transmission request was successful, TX_LEN: 1Byte, the length of the transmitted data OK+SENT: TX_CNT indicates that the data transmission was successful, TX_CNT: 1Byte, the number of data transmissions. ERR+SEND: ERR_NUM indicates that the data transmission request failed for the reason indicated by ERR_NUM. ERR_NUM 1 Byte 0- Not in the network 1- Communication is busy, sending request failed 2- The data length exceeds the current transmittable length, and only the MAC command is sent. ERR+SENT: TX_CNT indicates that the data transmission failed, the maximum number of transmissions has been reached, TX_CNT: 1 Byte, and the number of data transmissions. OK+RECV:TYPE,PORT,LEN,DATA Successful data reception (received response message or active downlink data) TYPE 1Bytedownstream transmission type Bit0 0-unconfirm 1-confirm Bit1 0-not ACK 1-ACK Bit20-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~Bit7default 0, reserved PORT 1Bytedownstream transmission port LEN 1Bytedownstream data length DATA nBytedownstream dataWhen len = 0, this field does not exist. AT+DTRX=1,2,10,0123456789 OK+SEND:03 OK+SENT:01 OK+RECV:02,01,00 Indicates that the confirm data is sent successfully. The valid data received by the server should be "0123456789", and the downstream confirmation has been received. Command character DRX (Receive data) Precautions Command Type Test command Query command Parameter Enter the network first, then send data Command Format response AT+DRX=? AT+DRX? Return value: +DRX:<Length>,<Payload> OK +DRX:<Length>,<Payload> OK 20 E78-864LN22S Command character CCONFIRM (Set upstream transmission type) Command character CAPPPORT (Set the upstream data port number) Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Length 0 means empty packet; PayloadHexadecimal string data; Ono exception in receiving data packet AT+DRX? OK Receive packets from the receive buffer and clear the receive buffer; Command Format AT+CCONFIRM=? response AT+CCONFIRM? AT+CCONFIRM =<value> <value> as follows 0: UnConfirmed up message 1: Confirmed up message <value> as follows 0: UnConfirmed up message 1: Confirmed up message AT+CCONFIRM=1 OK Need to set before sending data +CCONFIRM:"value" OK +DRX:<Length>,<Payload> OK OK Command Format response AT+CAPPPORT=? AT+CAPPPORT? AT+CAPPPORT=<value> +CAPPPORT:"value" OK +CAPPPORT:<value> OK OK <value> as follows: The port used, the data format is decimal, the factory value is 10. Value range: 1~223; Note: Port: 0x00 is the MAC command of LoRaWAN <value> as follows: The port used, the data format is decimal, the factory value is 10. Value range: 1~223; Note: Port: 0x00 is the MAC command of LoRaWAN AT+CAPPPORT=10 OK Need to set before sending data 21 E78-864LN22S Command character CDATARATE (Set the communication rate) Command character CNBTRIALS (Set the number of times to send) Command Type Test command Query command Setting command Parameter Description Return value description Example Precautions Command Type Test command Query command Setting command Parameter Description Return value description Example Command Format response AT+CDATARATE=? AT+CDATARATE? +CDATARATE:"value" OK +CDATARATE:<value> OK AT+CDATARATE =<value> OK <value> as follows: Rate value, the factory value is 3, the value range: 0 - SF12 BW125 1 - SF11 BW125 2 - SF10 BW125 3 - SF9 BW125 4 - SF8 BW125 5 - SF7 BW125 <value> as follows: Rate value, the factory value is 3, the value range: 0 - SF12 BW125 1 - SF11 BW125 2 - SF10 BW125 3 - SF9 BW125 4 - SF8 BW125 5 - SF7 BW125 AT+CDATARATE=1 OK Need to be set before sending data, invalid after ADR is enabled. Command Format response AT+CNBTRIALS=? AT+CNBTRIALS? AT+CNBTRIALS=<MType>,< value> +CNBTRIALS: "MType","value" OK +CNBTRIALS:<MType>,<value> OK OK <MType>: 0:unconfirm packet 1:confirm packet <value>the maximum number of times to send, value range: 1~15; <MType>:0:unconfirm packet 1:confirm packet <value>the maximum number of times to send, value range: 1~15; AT+CNBTRIALS=1,2 OK 22 E78-864LN22S Command character CRM (Set reporting mode) Precautions Command Type Need to set before sending data Command Format Test command AT+CRM=? response +CRM:"reportMode","reportInterval" OK Query command Setting command AT+CRM? AT+CTXP=<reportMode>,[rep ortInterval] +CTXP:<reportMode>,[reportInterval] OK OK Parameter Description <reportMode> 0- acyclic reporting data; 1- Periodic reporting of data; <reportInterval> This parameter is only available when data is reported periodically. Time interval of periodic report data, unit: s.For different 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 Example Precautions <reportMode> 0- acyclic reporting data; 2- Periodic reporting of data; <reportInterval> This parameter is only available when data is reported periodically. Time interval of periodic report data, unit: s.For different 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 AT+CRM=1,10 OK Need to set before sending data 23 E78-864LN22S Command character CTXP (Set the transmit power) Command Type Test command Query command Setting command Parameter Description Command Format response AT+CTXP=? AT+CTXP? +CTXP:"value" OK +CTXP:<value> OK AT+CTXP=<value> OK <is the transmission power size, the factory value is 0. 0 - 16dBm 1 - 14dBm 2 - 12dBm 3 - 10dBm 4 - 8dBm 5 - 6dBm 6 - 4dBm 7 - 2dBm Command character CLINKCHECK (Verify network connectivity) Return value description Example Precautions Command Type Test command Setting command Parameter Description <is the transmission power size, the factory value is 0. 0 - 16dBm 1 - 14dBm 2 - 12dBm 3 - 10dBm 4 - 8dBm 5 - 6dBm 6 - 4dBm 7 - 2dBm AT+CTXP=1 OK Need to set before sending data Command Format response AT+CLINKCHECK=? AT+CLINKCHECK=<value> +CLINKCHECK:"value" OK OK <value>: Enable control for Link Check 0 Link Check is not enabled 1 Perform a Link Check 2 - The module automatically carries the linkcheck command in each upstream packet. Return OK, the setting is successful. If X1=1, after waiting for a while, it will return the second response message in the following format: 24 E78-864LN22S Return value description Example +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 <value>: Enable control for Link Check 0 Link Check is not enabled 1 Perform a Link Check 2 - The module automatically carries the linkcheck command in each upstream packet. Return OK, the setting is successful. If X1=1, after waiting for a while, it will return the second response message 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 Command character CRXP (Set the receive window parameters) Precautions Command Type Test command Setting command Parameter Description Return value description Need to set before sending data Command Format response AT+CRXP=? +CRXP:"RX1DRoffest","RX2DataRate ","RX2Frequency" OK AT+CRXP? +CRXP:<RX1DRoffest>,<RX2DataRate >,<RX2Frequency> OK AT+CRXP=<RX1DRoffest>,< RX2DataRate>,<RX2Frequenc OK y> <RX1DRoffest>,<RX2DataRate>,<RX2Frequency> See the Lorawan protocol for details. 25 E78-864LN22S Example <RX1DRoffest>,<RX2DataRate>,<RX2Frequency> See the Lorawan protocol for details. AT+CRXP=1,1,471000000 OK Command character Precautions Command Type Test command Need to be set before sending data. Use the default value when not setting. Command Format response AT+CRX1DELAY=? +CRX1DELAY:"Delay" OK Query command AT+CRX1DELAY? +CRX1DELAY:<Delay> OK CRX1DELAY (Set the number of times sent) Command character CSAVE (Save MAC parameter settings) Command character CRESTORE (Restore MAC default Setting command Parameter Description Return value description Example Precautions Command Type Test command Setting command Parameter Description Return value description Example Precautions Command Type Test command Setting AT+CRX1DELAY=<Delay> OK Delay: how long to open rx1 window after sending, unit: s; Delay: how long to open rx1 window after sending, unit: s; AT+CRX1DELAY=2 OK Set how long the rx1 window will open after sending, and set before sending data. It is the protocol default value when not set. Command Format response AT+CSAVE=? AT+CSAVE +CSAVE OK OK <MType>: 0: unconfirm package, 1: confirm package. <value>: is the maximum number of transmissions, ranging from 1 to 15; <MType>: 0: unconfirm package, 1: confirm package. <value>: is the maximum number of transmissions, ranging from 1 to 15; This command saves the configuration parameters to EERPOM/FLASH After executing the AT+RESET command, the module will use the new MAC configuration parameters for network initialization and operation. Need to save before sending data Command Format response AT+CRESTORE=? AT+CRESTORE +CRESTORE OK OK 26 E78-864LN22S parameters) command Parameter Description Return value description Example This command restores the MAC default configuration parameters to EERPOM/FLASH. This command restores the MAC default configuration parameters to EERPOM/FLASH. AT+CRESTORE OK Command character IREBOOT (Restart module) Precautions Command Type Test command Setting command Parameter Description Return value description Example Need to save before sending data Command Format response AT+IREBOOT=? AT+IREBOOT=<mode> +IREBOOT:"Mode" OK OK <mode>: restart mode; 0: Restart the communication module immediately. 1: Wait for the radio frame currently being sent in the communication module to complete and then restart. <mode>: restart mode; 0: Restart the communication module immediately. 1: Wait for the radio frame currently being sent in the communication module to complete and then restart. AT+IREBOOT=1 OK 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 affected when obstacle exists. Data lose rate will be affected by temperature, humidity and co-channel interference. The ground will absorb and reflect wireless radio wave, so the performance will be poor when testing near ground. Sea water has great ability in absorbing wireless radio wave, so performance will be poor when testing near the sea. The signal will be affected when the antenna is near metal object or put in a metal case. Power register was set incorrectly, air data rate is set as too high (the higher the air data rate, the shorter the distance). 27 E78-864LN22S The power supply low voltage under room temperature is lower than 2.5V, the lower the voltage, the lower the transmitting power. Due to antenna quality or poor matching between antenna and module. 7.2 Module is easy to damage Please check the power supply source, ensure it is 2.0V~3.6V, voltage higher than 3.6V will damage the module. Please check the stability of power source, the voltage cannot fluctuate too much. Please make sure antistatic measure are taken when installing and using, high frequency devices have electrostatic susceptibility. Please ensure the humidity is within limited range, some parts are sensitive to humidity. Please 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 responsible: in order to reduce the use of paper, this manual only prints the Chinese part, the English manual only provides electronic documents, if necessary, please go to our official website to download; in addition, if the user does not require special, when the user orders in bulk, We only provide product specifications according to a certain percentage of the order quantity. Not every digital radio station is equipped with one by one, please understand. 28 Chengdu Ebyte Electronic Technology Co., Ltd. 9. Revision history Version 1.0 1.1 Date 2021/04/20 2021/06/29 E78-868LN22S User manual Description initial version Remove Freqbandmask,add Channelsmask Issued by GLUHAR 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, China Copyright ©20122021Chengdu Ebyte Electronic Technology Co.,Ltd.