Changes for page RS485-LN – RS485 to LoRaWAN Converter User Manual

Last modified by Bei Jinggeng on 2025/01/16 11:36

From version < 58.25 >

edited by Xiaoling
on 2022/06/06 11:27

To version < 58.2 >

edited by Xiaoling
on 2022/06/06 11:09

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -509,27 +509,14 @@
  == 3.5 Configure RS485-BL via AT or Downlink ==
--(((
  User can configure RS485-LN via AT Commands or LoRaWAN Downlink Commands
--)))
--(((
  There are two kinds of Commands:
--)))
--* (((
--(% style="color:#4f81bd" %)**Common Commands**(%%): They should be available for each sensor, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
--)))
++* (% style="color:#4f81bd" %)**Common Commands**(%%): They should be available for each sensor, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
--* (((
--(% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
--)))
++* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-LN.  User can see these commands below:
--(((
--
--)))
--
--
  === 3.5.1 Common Commands ===
  They should be available for each of Dragino Sensors, such as: change uplink interval, reset device. For firmware v1.3, user can find what common commands it supports: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
@@ -548,282 +548,142 @@
--
  ==== **RS485 Debug Command** ====
--(((
  This command is used to configure the RS485 devices; they won’t be used during sampling.
--)))
--* (((
--**AT Command**
--)))
++* **AT Command**
  (% class="box infomessage" %)
  (((
--(((
  **AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m**
  )))
--)))
--(((
  m: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
--)))
--* (((
--**Downlink Payload**
--)))
++* **Downlink Payload**
--(((
  Format: A8 MM NN XX XX XX XX YY
--)))
--(((
  Where:
--)))
--* (((
--MM: 1: add CRC-16/MODBUS ; 0: no CRC
--)))
--* (((
--NN: The length of RS485 command
--)))
--* (((
--XX XX XX XX: RS485 command total NN bytes
--)))
--* (((
--(((
--YY: How many bytes will be uplink from the return of this RS485 command,
--)))
++* MM: 1: add CRC-16/MODBUS ; 0: no CRC
++* NN: The length of RS485 command
++* XX XX XX XX: RS485 command total NN bytes
++* YY: How many bytes will be uplink from the return of this RS485 command,
++** if YY=0, RS485-LN will execute the downlink command without uplink;
++** if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
++** if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
--* (((
--if YY=0, RS485-LN will execute the downlink command without uplink;
--)))
--* (((
--if YY>0, RS485-LN will uplink total YY bytes from the output of this RS485 command; Fport=200
--)))
--* (((
--if YY=FF, RS485-LN will uplink RS485 output with the downlink command content; Fport=200.
--)))
--)))
--
--(((
  **Example 1** ~-~-> Configure without ask for uplink (YY=0)
--)))
--(((
  To connect a Modbus Alarm with below commands.
--)))
--* (((
--The command to active alarm is: 0A 05 00 04 00 01 4C B0. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
--)))
++* The command to active alarm is: 0A 05 00 04 00 01 4C B0. Where 0A 05 00 04 00 01 is the Modbus command to read the register 00 40 where stored the DI status. The 4C B0 is the CRC-16/MODBUS which calculate manually.
--* (((
--The command to deactivate alarm is: 0A 05 00 04 00 00 8D 70. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
--)))
++* The command to deactivate alarm is: 0A 05 00 04 00 00 8D 70. Where 0A 05 00 04 00 00 is the Modbus command to read the register 00 40 where stored the DI status. The 8D 70 is the CRC-16/MODBUS which calculate manually.
--(((
  So if user want to use downlink command to control to RS485 Alarm, he can use:
--)))
--(((
  (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
--)))
--(((
  (% style="color:#4f81bd" %)**A8 01 06 0A 05 00 04 00 00 00**(%%): to deactivate the RS485 Alarm
--)))
--(((
  A8 is type code and 01 means add CRC-16/MODBUS at the end, the 3^^rd^^ byte is 06, means the next 6 bytes are the command to be sent to the RS485 network, the final byte 00 means this command don’t need to acquire output.
--)))
--(((
--
--)))
--(((
  **Example 2** ~-~-> Configure with requesting uplink and original downlink command (**YY=FF**)
--)))
--(((
  User in IoT server send a downlink command: (% style="color:#4f81bd" %)**A8 01 06 0A 08 00 04 00 01 YY**
--)))
--(((
--
--)))
--(((
  RS485-LN got this downlink command and send (% style="color:#4f81bd" %)**0A 08 00 04 00 01 **(%%)to Modbus network. One of the RS485 sensor in the network send back Modbus reply **0A 08 00 04 00 00**. RS485-LN get this reply and combine with the original downlink command and uplink. The uplink message is:
--)))
--(((
     **A8** (% style="color:#4f81bd" %)**0A 08 00 04 00  **(% style="color:red" %)**01 06** ** **(% style="color:green" %)**0A 08 00 04 00 00**
--)))
--(((
   [[image:1654159460680-153.png]]
--)))
--
  ==== **Set Payload version** ====
--(((
  This is the first byte of the uplink payload. RS485-BL can connect to different sensors. User can set the PAYVER field to tell server how to decode the current payload.
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
  (% class="box infomessage" %)
  (((
--(((
  **AT+PAYVER: Set PAYVER field = 1**
  )))
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0xAE 01**   ~-~-> Set PAYVER field =  0x01
--)))
--(((
  **0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
--)))
--
  ==== **Set RS485 Sampling Commands** ====
--(((
  AT+COMMANDx or AT+DATACUTx
--)))
--(((
  These three commands are used to configure how the RS485-LN polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
--)))
--(((
--
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
  (% class="box infomessage" %)
  (((
--(((
  **AT+COMMANDx: Configure RS485 read command to sensor.**
  )))
--)))
  (% class="box infomessage" %)
  (((
--(((
  **AT+DATACUTx: Configure how to handle return from RS485 devices.**
  )))
--)))
--(((
--
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
--)))
--(((
  (% style="color:red" %)**Note**(%%): if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
--)))
--(((
  Format: AF MM NN LL XX XX XX XX YY
--)))
--(((
  Where:
--)))
--* (((
--MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
--)))
--* (((
--NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
--)))
--* (((
--LL:   The length of AT+COMMAND or AT+DATACUT command
--)))
--* (((
--XX XX XX XX: AT+COMMAND or AT+DATACUT command
--)))
--* (((
--YY:   If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
--)))
++* MM: the ATCOMMAND or AT+DATACUT to be set. Value from 01 ~~ 0F,
++* NN:  0: no CRC; 1: add CRC-16/MODBUS ; 2: set the AT+DATACUT value.
++* LL:   The length of AT+COMMAND or AT+DATACUT command
++* XX XX XX XX: AT+COMMAND or AT+DATACUT command
++* YY:   If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-LN will execute an uplink after got this command.
--(((
  **Example:**
--)))
--(((
  (% style="color:#037691" %)**AF 03 01 06 0A 05 00 04 00 01 00**(%%): Same as AT+COMMAND3=0A 05 00 04 00 01,1
--)))
--(((
  (% style="color:#037691" %)**AF 03 02 06**(% style="color:orange" %)** 10 **(% style="color:red" %)**01 **(% style="color:green" %)**05 06 09 0A**(% style="color:#037691" %)** 00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**16**(%%),(% style="color:red" %)**1**(%%),(% style="color:green" %)**5+6+9+10**
--)))
--(((
  (% style="color:#037691" %)**AF 03 02 06 **(% style="color:orange" %)**0B**(% style="color:red" %)** 02 **(% style="color:green" %)**05 07 08 0A **(% style="color:#037691" %)**00**(%%): Same as AT+DATACUT3=(% style="color:orange" %)**11**(%%),(% style="color:red" %)**2**(%%),(% style="color:green" %)**5~~7+8~~10**
--)))
--
  ==== **Fast command to handle MODBUS device** ====
--(((
  AT+MBFUN is valid since v1.3 firmware version. The command is for fast configure to read Modbus devices. It is only valid for the devices which follow the [[MODBUS-RTU protocol>>url:https://www.modbustools.com/modbus.html]].
--)))
--(((
  This command is valid since v1.3 firmware version
--)))
--(((
  AT+MBFUN can auto read the Modbus function code: 01, 02, 03 or 04. AT+MBFUN has lower priority vs AT+DATACUT command. If AT+DATACUT command is configured, AT+MBFUN will be ignore.
--)))
--(((
--
--)))
--(((
  **Example:**
--)))
--* (((
--AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN.
--)))
--* (((
--AT+COMMAND1= 01 03 00 10 00 08,1 ~-~-> read slave address 01 , function code 03, start address 00 01, quantity of registers 00 08.
--)))
--* (((
--AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
--)))
++* AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0). So RS485-LN.
++* AT+COMMAND1= 01 03 00 10 00 08,1 ~-~-> read slave address 01 , function code 03, start address 00 01, quantity of registers 00 08.
++* AT+COMMAND2= 01 02 00 40 00 10,1 ~-~-> read slave address 01 , function code 02, start address 00 40, quantity of inputs 00 10.
  [[image:image-20220602165351-6.png]]
@@ -831,376 +831,201 @@
--
  ==== **RS485 command timeout** ====
--(((
  Some Modbus device has slow action to send replies. This command is used to configure the RS485-LN to use longer time to wait for their action.
--)))
--(((
  Default value: 0, range:  0 ~~ 65 seconds
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
  (% class="box infomessage" %)
  (((
--(((
  **AT+CMDDLaa=hex(bb cc)*1000**
  )))
--)))
--(((
  **Example:**
--)))
--(((
  **AT+CMDDL1=1000** to send the open time to 1000ms
--)))
--(((
--
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0x AA aa bb cc**
--)))
--(((
  Same as: AT+CMDDLaa=hex(bb cc)*1000
--)))
--(((
     **Example:**
--)))
--(((
 xAA 01 00 01  ~-~-> Same as **AT+CMDDL1=1000 ms**
--)))
--
  ==== **Uplink payload mode** ====
--(((
  Define to use one uplink or multiple uplinks for the sampling.
--)))
--(((
  The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
  (% class="box infomessage" %)
  (((
--(((
  **AT+DATAUP=0**
  )))
--)))
  (% class="box infomessage" %)
  (((
--(((
  **AT+DATAUP=1**
  )))
--)))
--(((
--
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0xAD 00**   **~-~->** Same as AT+DATAUP=0
--)))
--(((
  **0xAD 01**   **~-~->** Same as AT+DATAUP=1
--)))
--
  ==== **Manually trigger an Uplink** ====
--(((
  Ask device to send an uplink immediately.
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
--(((
  No AT Command for this, user can press the [[ACT button>>||anchor="H3.7Buttons"]] for 1 second for the same.
--)))
--(((
--
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0x08 FF**, RS485-LN will immediately send an uplink.
--)))
--
  ==== **Clear RS485 Command** ====
--(((
  The AT+COMMANDx and AT+DATACUTx settings are stored in special location, user can use below command to clear them.
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
--(((
  **AT+CMDEAR=mm,nn**   mm: start position of erase ,nn: stop position of erase
--)))
--(((
  Etc. AT+CMDEAR=1,10 means erase AT+COMMAND1/AT+DATACUT1 to AT+COMMAND10/AT+DATACUT10
--)))
--(((
  Example screen shot after clear all RS485 commands.
--)))
--(((
--
--)))
--(((
  The uplink screen shot is:
--)))
  [[image:1654160691922-496.png]]
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **0x09 aa bb**  same as AT+CMDEAR=aa,bb
--)))
--
  ==== **Set Serial Communication Parameters** ====
--(((
  Set the Rs485 serial communication parameters:
--)))
--* (((
--**AT Command:**
--)))
++* **AT Command:**
--(((
  Set Baud Rate:
--)))
  (% class="box infomessage" %)
  (((
--(((
  **AT+BAUDR=9600**    ~/~/ Options: (1200,2400,4800,14400,19200,115200)
  )))
--)))
--(((
  Set UART Parity
--)))
  (% class="box infomessage" %)
  (((
--(((
  **AT+PARITY=0**    ~/~/ Option: 0: no parity, 1: odd parity, 2: even parity
  )))
--)))
--(((
  Set STOPBIT
--)))
  (% class="box infomessage" %)
  (((
--(((
  **AT+STOPBIT=0**    ~/~/ Option: 0 for 1bit; 1 for 1.5 bit ; 2 for 2 bits
  )))
--)))
--(((
--
--)))
--* (((
--**Downlink Payload:**
--)))
++* **Downlink Payload:**
--(((
  **A7 01 aa bb**: Same  AT+BAUDR=hex(aa bb)*100
--)))
--(((
  **Example:**
--)))
--* (((
--A7 01 00 60   same as AT+BAUDR=9600
--)))
--* (((
--A7 01 04 80     same as AT+BAUDR=115200
--)))
++* A7 01 00 60   same as AT+BAUDR=9600
++* A7 01 04 80     same as AT+BAUDR=115200
--(((
  A7 02 aa: Same as  AT+PARITY=aa  (aa value: 00 , 01 or 02)
--)))
--(((
  A7 03 aa: Same as  AT+STOPBIT=aa  (aa value: 00 , 01 or 02)
--)))
--
--
  == 3.6 Listening mode for RS485 network ==
--(((
  This feature support since firmware v1.4
--)))
--(((
  RS485-LN supports listening mode, it can listen the RS485 network packets and send them via LoRaWAN uplink. Below is the structure. The blue arrow shows the RS485 network packets to RS485-LN.
--)))
  [[image:image-20220602171200-8.png||height="567" width="1007"]]
--(((
  To enable the listening mode, use can run the command AT+RXMODE.
--)))
--(((
--
--)))
--(% border="1" cellspacing="10" style="background-color:#ffffcc; width:500px" %)
--|=(% style="width: 161px;" %)(((
--**Command example:**
--)))|=(% style="width: 337px;" %)(((
--**Function**
--)))
--|(% style="width:161px" %)(((
--AT+RXMODE=1,10
--)))|(% style="width:337px" %)(((
--Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks.
--)))
--|(% style="width:161px" %)(((
--AT+RXMODE=2,500
--)))|(% style="width:337px" %)(((
--Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms
--)))
--|(% style="width:161px" %)(((
--AT+RXMODE=0,0
--)))|(% style="width:337px" %)(((
--Disable listening mode. This is the default settings.
--)))
--|(% style="width:161px" %)(((
--
--)))|(% style="width:337px" %)(((
--A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 | cc)
--)))
++(% border="1" style="background-color:#ffffcc; width:500px" %)
++|=(% style="width: 161px;" %)**Command example:**|=(% style="width: 337px;" %)**Function**
++|(% style="width:161px" %)AT+RXMODE=1,10 |(% style="width:337px" %)Enable listening mode 1, if RS485-LN has received more than 10 RS485 commands from the network. RS485-LN will send these commands via LoRaWAN uplinks.
++|(% style="width:161px" %)AT+RXMODE=2,500|(% style="width:337px" %)Enable listening mode 2, RS485-LN will capture and send a 500ms content once from the first detect of character. Max value is 65535 ms
++|(% style="width:161px" %)AT+RXMODE=0,0|(% style="width:337px" %)Disable listening mode. This is the default settings.
++|(% style="width:161px" %) |(% style="width:337px" %)A6 aa bb cc  same as AT+RXMODE=aa,(bb<<8 ~| cc)
--(((
  **Downlink Command:**
--)))
--(((
  **0xA6 aa bb cc ** same as AT+RXMODE=aa,(bb<<8 | cc)
--)))
--(((
--
--)))
--(((
  **Example**:
--)))
--(((
  The RS485-LN is set to AT+RXMODE=2,1000
--)))
--(((
  There is a two Modbus commands in the RS485 network as below:
--)))
--(((
  The Modbus master send a command: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b
--)))
--(((
  And Modbus slave reply with: (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33
--)))
--(((
  RS485-LN will capture both and send the uplink: (% style="background-color:#ffc000" %)01 03 00 00 00 02 c4 0b  (% style="background-color:green" %)01 03 04 00 00 00 00 fa 33
--)))
--(((
  [[image:image-20220602171200-9.png]]
--)))
--(((
--
--)))
--(((
  (% style="color:red" %)Notice: Listening mode can work with the default polling mode of RS485-LN. When RS485-LN is in to send the RS485 commands (from AT+COMMANDx), the listening mode will be interrupt for a while.
--)))
  == 3.7 Buttons ==
--(% border="1" cellspacing="10" style="background-color:#f7faff; width:500px" %)
++(% border="1" style="background-color:#f7faff; width:500px" %)
  |=**Button**|=(% style="width: 1420px;" %)**Feature**
  |**ACT**|(% style="width:1420px" %)If RS485 joined in network, press this button for more than 1 second, RS485 will upload a packet, and the SYS LED will give a (% style="color:blue" %)**Blue blink**
  |**RST**|(% style="width:1420px" %)Reboot RS485
  |**PRO**|(% style="width:1420px" %)Use for upload image, see [[How to Update Image>>||anchor="H6.1Howtoupgradetheimage3F"]]
--
--
  == 3.8 LEDs ==
--(% border="1" cellspacing="10" style="background-color:#f7faff; width:500px" %)
++(% border="1" style="background-color:#f7faff; width:500px" %)
  |=**LEDs**|=**Feature**
  |**PWR**|Always on if there is power
  |**SYS**|After device is powered on, the SYS will (% style="color:green" %)**fast blink in GREEN** (%%)for 5 times, means RS485-LN start to join LoRaWAN network. If join success, SYS will be (% style="color:green" %)**on GREEN for 5 seconds**(%%)**. **SYS will (% style="color:green" %)**blink Blue**(%%) on every upload and (% style="color:green" %)**blink Green**(%%) once receive a downlink message.
--
--
  = 4. Case Study =
  User can check this URL for some case studies: [[APP RS485 COMMUNICATE WITH SENSORS>>doc:Main.Application Note \: Communicate with Different Sensors ----- RS485-LN  RS485-BL.WebHome]]
@@ -1210,16 +1210,12 @@
  == 5.1 Access AT Command ==
--(((
  RS485-BL supports AT Command set. User can use a USB to TTL adapter plus the 3.5mm Program Cable to connect to RS485-BL to use AT command, as below.
--)))
  [[image:1654162355560-817.png]]
--(((
  In PC, User needs to set (% style="color:blue" %)**serial tool**(%%)(such as [[putty>>url:https://www.chiark.greenend.org.uk/~~sgtatham/putty/latest.html]], SecureCRT) baud rate to (% style="color:green" %)**9600**(%%) to access to access serial console of RS485-BL. The default password is 123456. Below is the output for reference:
--)))
  [[image:1654162368066-342.png]]

Changes for page RS485-LN – RS485 to LoRaWAN Converter User Manual

Summary

Details

Applications

Navigation