Changes for page RS485-BL – Waterproof RS485 to LoRaWAN Converter

Last modified by Xiaoling on 2025/04/23 15:57

From 29.15 to 29.16 From 32.8 to 32.9

From version 29.16

edited by Xiaoling
on 2022/06/01 18:05

Change comment: There is no comment for this version

To version 32.8

edited by Xiaoling
on 2022/06/02 09:44

Change comment: There is no comment for this version

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -58,6 +58,7 @@
  == 1.2 Specifications ==
++
  **Hardware System:**
  * STM32L072CZT6 MCU
@@ -64,8 +64,6 @@
  * SX1276/78 Wireless Chip
  * Power Consumption (exclude RS485 device):
  ** Idle: 6uA@3.3v
--
--*
  ** 20dB Transmit: 130mA@3.3v
  **Interface for Model:**
@@ -95,7 +95,6 @@
  * 127 dB Dynamic Range RSSI.
  * Automatic RF Sense and CAD with ultra-fast AFC.
--
  == 1.3 Features ==
  * LoRaWAN Class A & Class C protocol (default Class A)
@@ -107,7 +107,6 @@
  * Support Modbus protocol
  * Support Interrupt uplink
--
  == 1.4 Applications ==
  * Smart Buildings & Home Automation
@@ -117,7 +117,6 @@
  * Smart Cities
  * Smart Factory
--
  == 1.5 Firmware Change log ==
  [[RS485-BL Image files – Download link and Change log>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/RS485-BL/Firmware/||style="background-color: rgb(255, 255, 255);"]]
@@ -126,6 +126,8 @@
  == 1.6 Hardware Change log ==
  (((
++
++
  v1.4
  )))
@@ -208,8 +208,6 @@
  )))
--
--
  [[image:image-20220519174512-1.png]]
  [[image:image-20220519174512-2.png||height="328" width="731"]]
@@ -233,6 +233,7 @@
  [[image:1652953568895-172.png||height="232" width="724"]]
++
  == 3.3 Configure Commands to read data ==
  (((
@@ -339,8 +339,9 @@
  mm: 0: no CRC, 1: add CRC-16/MODBUS in the end of this command
  )))|(% style="width:256px" %)AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
--Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>path:#AT_CFGDEV]].
++Detail of AT+CFGDEV command see [[AT+CFGDEV detail>>||anchor="HRS485DebugCommand28AT2BCFGDEV29"]].
++
  === 3.3.3 Configure read commands for each sampling ===
  (((
@@ -438,7 +438,7 @@
  **Examples:**
--1. For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
++1）For a return string from AT+COMMAND1: 16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
  If we set AT+SEARCH1=1,1E 56 34.      (max 5 bytes for prefix)
@@ -446,7 +446,7 @@
  [[image:1653271044481-711.png]]
--1. For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
++2）For a return string from AT+COMMAND1:  16 0c 1e 56 34 2e 30 58 5f 36 41 30 31 00 49
  If we set AT+SEARCH1=2, 1E 56 34+31 00 49
@@ -465,16 +465,18 @@
  * **c: define the position for valid value.  **
  )))
--Examples:
++**Examples:**
  * Grab bytes:
  [[image:1653271581490-837.png||height="313" width="722"]]
++
  * Grab a section.
  [[image:1653271648378-342.png||height="326" width="720"]]
++
  * Grab different sections.
  [[image:1653271657255-576.png||height="305" width="730"]]
@@ -517,6 +517,7 @@
  [[image:1653271763403-806.png]]
++
  === 3.3.4 Compose the uplink payload ===
  (((
@@ -524,7 +524,7 @@
  )))
  (((
--(% style="color:#4f81bd" %)**Examples: AT+DATAUP=0**
++(% style="color:#037691" %)**Examples: AT+DATAUP=0**
  )))
  (((
@@ -536,7 +536,7 @@
  )))
  (((
--(% style="color:#4f81bd" %)Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx
++(% style="color:#4f81bd" %)**Battery Info+PAYVER + VALID Value from RETURN1 + Valid Value from RETURN2 + … + RETURNx**
  )))
  (((
@@ -545,8 +545,12 @@
  [[image:1653272787040-634.png||height="515" width="719"]]
++
++
  (((
--(% style="color:#4f81bd" %)**Examples: AT+DATAUP=1**
++(% style="color:#037691" %)**Examples: AT+DATAUP=1**
++
++
  )))
  (((
@@ -558,7 +558,7 @@
  )))
  (((
--(% style="color:#4f81bd" %)Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA
++(% style="color:#4f81bd" %)**Battery Info+PAYVER + PAYLOAD COUNT + PAYLOAD# + DATA**
  )))
 . (((
@@ -581,6 +581,7 @@
  So totally there will be 3 uplinks for this sampling, each uplink includes 6 bytes DATA
++
  DATA1=RETURN1 Valid Value = (% style="background-color:#4f81bd; color:white" %) 20 20 0a 33 90 41
  DATA2=1^^st^^ ~~ 6^^th^^ byte of Valid value of RETURN10= (% style="background-color:#4f81bd; color:white" %)02 aa 05 81 0a 20
@@ -587,10 +587,12 @@
  DATA3=7^^th^^ ~~ 11^^th^^ bytes of Valid value of RETURN10 =(% style="background-color:#4f81bd; color:white" %) 20 20 20 2d 30
++
  Below are the uplink payloads:
  [[image:1653272901032-107.png]]
++
  (% style="color:red" %)Notice: the Max bytes is according to the max support bytes in different Frequency Bands for lowest SF. As below:
     ~* For AU915/AS923 bands, if UplinkDwell time=0, max 51 bytes for each uplink ( so 51 -5 = 46 max valid date)
@@ -601,6 +601,8 @@
     ~* For all other bands: max 51 bytes for each uplink  ( so 51 -5 = 46 max valid date).
++
++
  === 3.3.5 Uplink on demand ===
  (((
@@ -617,6 +617,8 @@
  (((
  **0xA8 command**: Send a command to RS485-BL and uplink the output from sensors.
++
++
  )))
  === 3.3.6 Uplink on Interrupt ===
@@ -625,6 +625,7 @@
  [[image:1653273818896-432.png]]
++
  (((
  AT+INTMOD=0  Disable Interrupt
  )))
@@ -639,6 +639,8 @@
  (((
  AT+INTMOD=3  Interrupt trigger by rising edge.
++
++
  )))
  == 3.4 Uplink Payload ==
@@ -666,47 +666,49 @@
  Below is the decoder for the first 3 bytes. The rest bytes are dynamic depends on different RS485 sensors.
  (((
--function Decoder(bytes, port) {
++{{{function Decoder(bytes, port) {}}}
  )))
  (((
--~/~/Payload Formats of RS485-BL Deceive
++{{{//Payload Formats of RS485-BL Deceive}}}
  )))
  (((
--return {
++{{{return {}}}
  )))
  (((
--    ~/~/Battery,units:V
++{{{    //Battery,units:V}}}
  )))
  (((
--    BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,
++{{{    BatV:((bytes[0]<<8 | bytes[1])&0x7fff)/1000,}}}
  )))
  (((
--    ~/~/GPIO_EXTI
++{{{    //GPIO_EXTI  }}}
  )))
  (((
--    EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",
++{{{    EXTI_Trigger:(bytes[0] & 0x80)? "TRUE":"FALSE",}}}
  )))
  (((
--    ~/~/payload of version
++{{{    //payload of version}}}
  )))
  (((
--    Pay_ver:bytes[2],
++{{{    Pay_ver:bytes[2],}}}
  )))
  (((
--    };
++{{{    }; }}}
  )))
  (((
--  }
++}
++
++
  )))
  (((
@@ -715,58 +715,65 @@
  [[image:1653274001211-372.png||height="192" width="732"]]
++
  == 3.5 Configure RS485-BL via AT or Downlink ==
--User can configure RS485-BL via [[AT Commands >>path:#_Using_the_AT]]or LoRaWAN Downlink Commands
++User can configure RS485-BL via AT Commands or LoRaWAN Downlink Commands
  There are two kinds of Commands:
--* **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: http:~/~/wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_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: [[End Device AT Commands and Downlink Command>>doc:Main.End Device AT Commands and Downlink Command.WebHome]]
--* **Sensor Related Commands**: These commands are special designed for RS485-BL.  User can see these commands below:
++* (% style="color:#4f81bd" %)**Sensor Related Commands**(%%): These commands are special designed for RS485-BL.  User can see these commands below:
--1.
--11.
--111. Common Commands:
++=== 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: [[http:~~/~~/wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_Commands>>url:http://wiki.dragino.com/index.php?title=End_Device_AT_Commands_and_Downlink_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]]
--1.
--11.
--111. Sensor related commands:
++=== 3.5.2 Sensor related commands: ===
--==== Choose Device Type (RS485 or TTL) ====
++====   ====
++==== **Choose Device Type (RS485 or TTL)** ====
++
  RS485-BL can connect to either RS485 sensors or TTL sensor. User need to specify what type of sensor need to connect.
--* AT Command
++* **AT Command**
++(% class="box infomessage" %)
++(((
  **AT+MOD=1** ~/~/ Set to support RS485-MODBUS type sensors. User can connect multiply RS485 , Modbus sensors to the A / B pins.
++)))
++(% class="box infomessage" %)
++(((
  **AT+MOD=2** ~/~/ Set to support TTL Level sensors, User can connect one TTL Sensor to the TXD/RXD/GND pins.
++)))
--* Downlink Payload
++* **Downlink Payload**
--**0A aa**     à same as AT+MOD=aa
++**0A aa**     ~-~->  same as AT+MOD=aa
--==== [[RS485 Debug Command>>path:#downlink_A8]] (AT+CFGDEV) ====
++==== **RS485 Debug Command (AT+CFGDEV)** ====
  This command is used to configure the RS485 or TTL sensors; they won’t be used during sampling.
--* AT Command
++* **AT Command**
--AT+CFGDEV=xx xx xx xx xx xx xx xx xx xx xx xx,m
++(% 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:
@@ -780,15 +780,15 @@
  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:
--**A8 01 06 0A 05 00 04 00 01 00**: to activate the RS485 Alarm
++(% style="color:#037691" %)**A8 01 06 0A 05 00 04 00 01 00**(%%): to activate the RS485 Alarm
--**A8 01 06 0A 05 00 04 00 00 00**: to deactivate the RS485 Alarm
++(% style="color:#037691" %)**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.
@@ -797,48 +797,60 @@
  Check TTL Sensor return:
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image024.png]]
++[[image:1654132684752-193.png]]
++==== **Set Payload version** ====
--==== 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:**
--AT+PAYVER: Set PAYVER field = 1
++(% class="box infomessage" %)
++(((
++**AT+PAYVER: Set PAYVER field = 1**
++)))
--* Downlink Payload:
++* **Downlink Payload:**
--0xAE 01   à Set PAYVER field =  0x01
++**0xAE 01**   ~-~-> Set PAYVER field =  0x01
--0xAE 0F   à Set PAYVER field =  0x0F
++**0xAE 0F**   ~-~-> Set PAYVER field =  0x0F
--==== Set RS485 Sampling Commands ====
++==== **Set RS485 Sampling Commands** ====
++
  AT+COMMANDx, AT+DATACUTx and AT+SEARCHx
--These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>path:#polling_485]].
++These three commands are used to configure how the RS485-BL polling data from Modbus device. Detail of usage please see : [[polling RS485 device>>||anchor="H3.3.3Configurereadcommandsforeachsampling"]].
--* AT Command:
++* **AT Command:**
--AT+COMMANDx: Configure RS485 read command to sensor.
++(% class="box infomessage" %)
++(((
++**AT+COMMANDx: Configure RS485 read command to sensor.**
++)))
--AT+DATACUTx: Configure how to handle return from RS485 devices.
++(% class="box infomessage" %)
++(((
++**AT+DATACUTx: Configure how to handle return from RS485 devices.**
++)))
--AT+SEARCHx: Configure search command
++(% class="box infomessage" %)
++(((
++**AT+SEARCHx: Configure search command**
++)))
--* Downlink Payload:
++* **Downlink Payload:**
--0xAF downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
++**0xAF** downlink command can be used to set AT+COMMANDx or AT+DATACUTx.
--Note: if user use AT+COMMANDx to add a new command, he also need to send AT+DATACUTx downlink.
++(% 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
@@ -845,23 +845,23 @@
  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
++* 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-BL will execute an uplink after got this command.
++* YY:   If YY=0, RS485-BL will execute the downlink command without uplink; if YY=1, RS485-BL will execute an uplink after got this command.
--Example:
++**Example:**
--**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 01 06 0A 05 00 04 00 01 00**(%%): Same as AT+COMMAND3=0A 05 00 04 00 01,1
--**AF 03 02 06 10 01 05 06 09 0A 00**: Same as AT+DATACUT3=**16**,**1**,**5+6+9+10**
++(% 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**
--**AF 03 02 06 0B 02 05 07 08 0A 00**: Same as AT+DATACUT3=**11**,**2**,**5~~7+8~~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**
--0xAB downlink command can be used for set AT+SEARCHx
++**0xAB** downlink command can be used for set AT+SEARCHx
--Example: **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
++**Example:** **AB aa 01 03 xx xx xx** (03 here means there are total 3 bytes after 03) So
  * AB aa 01 03 xx xx xx  same as AT+SEARCHaa=1,xx xx xx
  * AB aa 02 03 xx xx xx 02 yy yy(03 means there are 3 bytes after 03, they are xx xx xx;02 means there are 2 bytes after 02, they are yy yy) so the commands
@@ -869,83 +869,95 @@
  **AB aa 02 03 xx xx xx 02 yy yy**  same as **AT+SEARCHaa=2,xx xx xx+yy yy**
--==== Fast command to handle MODBUS device ====
++==== **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 has only two value:
++**AT+MBFUN has only two value:**
--* AT+MBFUN=1: Enable Modbus reading. And get response base on the MODBUS return
++* **AT+MBFUN=1**: Enable Modbus reading. And get response base on the MODBUS return
  AT+MBFUN=1, device 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.
--* AT+MBFUN=0: Disable Modbus fast reading.
++* **AT+MBFUN=0**: Disable Modbus fast reading.
--Example:
++**Example:**
  * AT+MBFUN=1 and AT+DATACUT1/AT+DATACUT2 are not configure (0,0,0).
  * 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:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.png]]
++[[image:1654133913295-597.png]]
--[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image026.png]]
++[[image:1654133954153-643.png]]
--* Downlink Commands:
++* **Downlink Commands:**
--A9 aa -à Same as AT+MBFUN=aa
++**A9 aa** ~-~-> Same as AT+MBFUN=aa
--==== RS485 command timeout ====
++==== **RS485 command timeout** ====
++
  Some Modbus device has slow action to send replies. This command is used to configure the RS485-BL to use longer time to wait for their action.
  Default value: 0, range:  0 ~~ 5 seconds
--* AT Command:
++* **AT Command:**
--AT+CMDDLaa=hex(bb cc)
++(% class="box infomessage" %)
++(((
++**AT+CMDDLaa=hex(bb cc)**
++)))
--Example:
++**Example:**
  **AT+CMDDL1=1000** to send the open time to 1000ms
--* Downlink Payload:
++* **Downlink Payload:**
 x AA aa bb cc
  Same as: AT+CMDDLaa=hex(bb cc)
--   Example:
++   **Example:**
--   0xAA 01 03 E8  à Same as **AT+CMDDL1=1000 ms**
++   **0xAA 01 03 E8**  ~-~-> Same as **AT+CMDDL1=1000 ms**
--==== [[Uplink>>path:#downlink_A8]] payload mode ====
++==== **Uplink payload mode** ====
++
  Define to use one uplink or multiple uplinks for the sampling.
--The use of this command please see: [[Compose Uplink payload>>path:#DataUP]]
++The use of this command please see: [[Compose Uplink payload>>||anchor="H3.3.4Composetheuplinkpayload"]]
--* AT Command:
++* **AT Command:**
--AT+DATAUP=0
++(% class="box infomessage" %)
++(((
++**AT+DATAUP=0**
++)))
--AT+DATAUP=1
++(% class="box infomessage" %)
++(((
++**AT+DATAUP=1**
++)))
--* Downlink Payload:
++* **Downlink Payload:**
--0xAD 00   à Same as AT+DATAUP=0
++0xAD 00   **~-~->** Same as AT+DATAUP=0
--0xAD 01   à Same as AT+DATAUP=1
++0xAD 01   **~-~->** Same as AT+DATAUP=1
  ==== Manually trigger an Uplink ====

1654132684752-193.png

Author

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

Size

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

Content

1654133913295-597.png

Author

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

Size

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

Content

1654133954153-643.png

Author

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

Size

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

Content