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

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

From version < 57.49 >

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

To version < 58.25 >

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

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 1 added, 0 removed)
- image-20220606110929-1.png

Details

Page properties

Content

@@ -501,33 +501,35 @@
  == 3.4 Uplink Payload ==
--(% border="1" style="background-color:#4bacc6; color:white; width:734px" %)
--|**Size(bytes)**|(% style="width:120px" %)**2**|(% style="width:116px" %)**1**|(% style="width:386px" %)**Length depends on the return from the commands**
--|Value|(% style="width:120px" %)(((
--Battery(mV)
--&
++[[image:image-20220606110929-1.png]]
--Interrupt _Flag
--)))|(% style="width:116px" %)(((
--PAYLOAD_VER
--
--
--)))|(% style="width:386px" %)If the valid payload is too long and exceed the maximum support payload length in server, server will show payload not provided in the LoRaWAN server.
--
  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
  == 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]]
@@ -546,142 +546,282 @@
++
  ==== **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,
--** 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.
++* (((
++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.
++)))
++)))
++
++(((
  **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]]
@@ -689,201 +689,376 @@
++
  ==== **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" 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" 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)
++)))
++(((
  **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" style="background-color:#f7faff; width:500px" %)
++(% border="1" cellspacing="10" 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" style="background-color:#f7faff; width:500px" %)
++(% border="1" cellspacing="10" 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]]
@@ -893,12 +893,16 @@
  == 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]]

image-20220606110929-1.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.Xiaoling

Size

...	...	@@ -1,0 +1,1 @@
	1	+13.9 KB

Content

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

Summary

Details

Applications

Navigation