Changes for page wiki_test

Last modified by Mengting Qiu on 2024/09/05 17:35

From 80.2 to 80.1 From 82.11 to 82.10

From version 82.10

edited by Xiaoling
on 2023/08/19 14:03

Change comment: There is no comment for this version

To version 80.2

edited by Xiaoling
on 2023/08/19 11:33

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 2 removed)
- 1692424009971-458.png
- 1692424376354-959.png

Details

Page properties

Content

@@ -115,6 +115,8 @@
  * Smart Cities
  * Smart Factory
++
++
  == 1.5 Sleep mode and working mode ==
@@ -131,7 +131,7 @@
  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
--|=(% style="width: 167px;background-color:#4F81BD;color:white" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#4F81BD;color:white" %)**Function**|=(% style="width:225px;background-color:#4F81BD;color:white" %)**Action**
++|=(% style="width: 167px;background-color:#D9E2F3;color:#0070C0" %)**Behavior on ACT**|=(% style="width: 117px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 225px;background-color:#D9E2F3;color:#0070C0" %)**Action**
  |(% style="width:167px" %)Pressing ACT between 1s < time < 3s|(% style="width:117px" %)Send an uplink|(% style="width:225px" %)(((
  If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)**blue led** (%%)will blink once.
  Meanwhile, BLE module will be active and user can connect via BLE to configure device.
@@ -192,7 +192,7 @@
  (% border="1" cellspacing="5" style="width:410px" %)
--|=(% style="width: 102px;background-color:#4F81BD;color:white" %)Model|=(% style="width: 126px; background-color:#4F81BD;color:white" %)Photo|=(% style="width: 179px;background-color:#4F81BD;color:white" %)Probe Info
++|=(% style="width: 102px;background-color:#D9E2F3;color:#0070C0" %)Model|=(% style="width: 126px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Photo|=(% style="width: 179px; background-color: rgb(217, 226, 243); color: rgb(0, 112, 192);" %)Probe Info
  |(% style="width:102px" %)(((
  S31-LB
  )))|(% style="width:126px" %)(((
@@ -234,315 +234,609 @@
  [[image:1692415924540-357.png]]
--There are two version: (% style="color:blue" %)**-GE**(%%) and (% style="color:blue" %)**-1D**(%%) version of S31-NB.
++There are two version: **-GE** and **-1D** version of S31-NB.
--(% style="color:blue" %)**GE Version**(%%): This version doesn’t include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server.
++**GE Version**: This version doesn’t include SIM card or point to any IoT server. User needs to use AT Commands to configure below two steps to set S31-NB send data to IoT server.
 . Install NB-IoT SIM card and configure APN. See instruction of [[Attach Network>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.AttachNetwork]].
++1. Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]].
--1. Set up sensor to point to IoT Server. See instruction of [[Configure to Connect Different Servers>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.Configuretoconnecttodifferentservers]].
--
  Below shows result of different server as a glance.
--(% border="1" cellspacing="4" style="width:515px" %)
--|(% style="background-color:#4f81bd; color:white; width:100px" %)**Servers**|(% style="background-color:#4f81bd; color:white; width:300px" %)**Dash Board**|(% style="background-color:#4f81bd; color:white; width:115px" %)**Comments**
--|(% style="width:127px" %)[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-8.png||height="183" width="367"]]|(% style="width:170px" %)
--|(% style="width:127px" %)[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|(% style="width:385px" %)[[image:image-20230819113244-9.png||height="120" width="369"]]|(% style="width:170px" %)
--|(% style="width:127px" %)[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]|(% style="width:385px" %) |(% style="width:170px" %)
--|(% style="width:127px" %)[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
--|(% style="width:127px" %)[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|(% style="width:385px" %)Raw Payload. Need Developer to design Dash Board|(% style="width:170px" %)
--|(% style="width:127px" %)[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-10.png||height="82" width="291"]]|(% style="width:170px" %)
--|(% style="width:127px" %)[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|(% style="width:385px" %)[[image:image-20230819113244-11.png||height="113" width="293"]]|(% style="width:170px" %)
--|(% style="width:127px" %) |(% style="width:385px" %) |(% style="width:170px" %)
++|**Servers**|**Dash Board**|**Comments**
++|[[Node-Red>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.5A0Node-RedA028viaA0MQTT29]]|[[image:image-20230819113244-8.png]]|
++|[[DataCake>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]]|[[image:image-20230819113244-9.png]]|
++|[[Tago.IO>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.7A0Tago.ioA028viaA0MQTT29]]| |
++|[[General UDP>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.1GeneralA0UDPA0Connection]]|Raw Payload. Need Developer to design Dash Board|
++|[[General MQTT>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.2GeneralA0MQTTA0Connection]]|Raw Payload. Need Developer to design Dash Board|
++|[[ThingSpeak>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.3A0ThingSpeakA028viaA0MQTT29]]|[[image:image-20230819113244-10.png]]|
++|[[ThingsBoard>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.6A0ThingsBoard.CloudA028viaA0MQTT29]]|[[image:image-20230819113244-11.png]]|
++| | |
--(% style="color:blue" %)**1D Version**(%%): This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate S31-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
++**1D Version**: This version has 1NCE SIM card pre-installed and configure to send value to DataCake. User Just need to select the sensor type in DataCake and Activate S31-NB and user will be able to see data in DataCake. See here for [[DataCake Config Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H3.4Datacake]].
++
++
  == 2.2 Payload Types ==
--To meet different server requirement, S31-NB supports different payload type.
++Following is an example for how to join the [[TTN v3 LoRaWAN Network>>url:https://console.cloud.thethings.network/]]. Below is the network structure; we use the [[LPS8v2>>url:https://www.dragino.com/products/lora-lorawan-gateway/item/228-lps8v2.html]]  as a LoRaWAN gateway in this example.
--**Includes:**
++The LPS8V2 is already set to connected to [[TTN network >>url:https://console.cloud.thethings.network/]], so what we need to now is configure the TTN server.
--* [[General JSON format payload>>path:#General_Json]]. (Type=5)
--* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0)
++(% style="color:blue" %)**Step 1:**(%%) Create a device in TTN with the OTAA keys from S31x-LB.
--* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1)
++Each S31x-LB is shipped with a sticker with the default device EUI as below:
--* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3)
++[[image:image-20230426084152-1.png||alt="图片-20230426084152-1.png" height="233" width="502"]]
--User can specify the payload type when choose the connection protocol. Example:
--(% style="color:#037691" %)**AT+PRO=2,0**  (%%)          ~/~/ Use UDP Connection & hex Payload
++You can enter this key in the LoRaWAN Server portal. Below is TTN screen shot:
--(% style="color:#037691" %)**AT+PRO=2,5**   (%%)         ~/~/ Use UDP Connection & Json Payload
--(% style="color:#037691" %)**AT+PRO=3,5 **  (%%)         ~/~/ Use MQTT Connection & Json Payload
++(% style="color:blue" %)**Register the device**
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/1654935135620-998.png?rev=1.1||alt="1654935135620-998.png"]]
--=== 2.2.1 General Json Format (Type~=5) ===
++(% style="color:blue" %)**Add APP EUI and DEV EUI**
--This is the General Json Format. As below:
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-4.png?width=753&height=551&rev=1.1||alt="图片-20220611161308-4.png"]]
--(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24,"Model":S31x-NB, "1":{28.2,48.3,2023/08/10 08:00:37},"2":{28.1,49.1,2023/08/10 07:57:37},"3":{28.1,48.5,2023/08/10 07:54:37},"4":{28.2,48.6,2023/08/10 07:51:37},"5":{28.1,48.9,2023/08/10 07:48:37},"6":{28.2,48.8,2023/08/10 07:45:37},"7":{28.2,48.8,2023/08/10 07:42:37},"8":{28.0,48.8,2023/08/10 07:39:37}}**
++(% style="color:blue" %)**Add APP EUI in the application**
--(% style="color:red" %)**Notice, from above payload:**
--* Temperature , Humidity , Battery & Signal are the value at uplink time.
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-5.png?width=742&height=601&rev=1.1||alt="图片-20220611161308-5.png"]]
--* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)**AT+NOUD=8 ** (%%)Command. Each entry includes (from left to right): Temperature, Humidity, Sampling time.
++(% style="color:blue" %)**Add APP KEY**
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LSN50v2-S31-S31B%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20User%20Manual/WebHome/image-20220611161308-6.png?width=744&height=485&rev=1.1||alt="图片-20220611161308-6.png"]]
--=== 2.2.2 HEX format Payload(Type~=0) ===
++(% style="color:blue" %)**Step 2:**(%%) Activate on S31x-LB
--This is the HEX Format. As below:
--(% style="color:#4472c4" %)**f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439**
++Press the button for 5 seconds to activate the S31x-LB.
--[[image:1692424009971-458.png]]
++(% style="color:green" %)**Green led**(%%) will fast blink 5 times, device will enter (% style="color:blue" %)**OTA mode**(%%) for 3 seconds. And then start to JOIN LoRaWAN network. (% style="color:green" %)**Green led**(%%) will solidly turn on for 5 seconds after joined in network.
++After join success, it will start to upload messages to TTN and you can see the messages in the panel.
--(% style="color:blue" %)**Version:**
--These bytes include the hardware and software version.
++== 2.3 Uplink Payload ==
--(% style="color:#037691" %)**Higher byte:**(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
++=== 2.3.1 Device Status, FPORT~=5 ===
--(% style="color:#037691" %)**Lower byte:**(%%) Specify the software version: 0x64=100, means firmware version 100
++Users can use the downlink command(**0x26 01**) to ask S31x-LB to send device configure detail, include device configure status. S31x-LB will uplink a payload via FPort=5 to server.
--(% style="color:blue" %)**BAT (Battery Info):**
++The Payload format is as below.
--Ex1: 0x0CBA = 3258mV
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|(% colspan="6" style="background-color:#d9e2f3; color:#0070c0" %)**Device Status (FPORT=5)**
++|(% style="width:103px" %)**Size (bytes)**|(% style="width:72px" %)**1**|**2**|(% style="width:91px" %)**1**|(% style="width:86px" %)**1**|(% style="width:44px" %)**2**
++|(% style="width:103px" %)**Value**|(% style="width:72px" %)Sensor Model|Firmware Version|(% style="width:91px" %)Frequency Band|(% style="width:86px" %)Sub-band|(% style="width:44px" %)BAT
--(% style="color:blue" %)**Signal Strength:**
++Example parse in TTNv3
--NB-IoT Network signal Strength.
++[[image:image-20230524144422-1.png||height="174" width="1080"]]
--**Ex1: 0x16 = 22**
--**0**        -113dBm or less
++(% style="color:#037691" %)**Sensor Model**(%%): For S31x-LB, this value is 0x0A
--**1**        -111dBm
++(% style="color:#037691" %)**Firmware Version**(%%): 0x0100, Means: v1.0.0 version
--**2...30** -109dBm... -53dBm
++(% style="color:#037691" %)**Frequency Band**:
--**31**      -51dBm or greater
++0x01: EU868
--**99**      Not known or not detectable
++0x02: US915
++0x03: IN865
--(% style="color:blue" %)**Temperature: **
++0x04: AU915
++0x05: KZ865
++
++0x06: RU864
++
++0x07: AS923
++
++0x08: AS923-1
++
++0x09: AS923-2
++
++0x0a: AS923-3
++
++0x0b: CN470
++
++0x0c: EU433
++
++0x0d: KR920
++
++0x0e: MA869
++
++
++(% style="color:#037691" %)**Sub-Band**:
++
++AU915 and US915:value 0x00 ~~ 0x08
++
++CN470: value 0x0B ~~ 0x0C
++
++Other Bands: Always 0x00
++
++
++(% style="color:#037691" %)**Battery Info**:
++
++Check the battery voltage.
++
++Ex1: 0x0B45 = 2885mV
++
++Ex2: 0x0B49 = 2889mV
++
++
++=== 2.3.2  Sensor Data. FPORT~=2 ===
++
++
++Sensor Data is uplink via FPORT=2
++
++(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
++|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
++**Size(bytes)**
++)))|=(% style="width: 40px;background-color:#D9E2F3;color:#0070C0" %)2|=(% style="width: 90px;background-color:#D9E2F3;color:#0070C0" %)4|=(% style="width: 150px; background-color: #D9E2F3;color:#0070C0" %)1|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)**2**|=(% style="width: 80px; background-color: #D9E2F3;color:#0070C0" %)2
++|(% style="width:99px" %)Value|(% style="width:69px" %)(((
++Battery
++)))|(% style="width:130px" %)(((
++Unix TimeStamp
++)))|(% style="width:194px" %)(((
++Alarm Flag & MOD& Level of PA8
++)))|(% style="width:106px" %)(((
++Temperature
++)))|(% style="width:97px" %)(((
++Humidity
++)))
++
++[[image:image-20230524144456-2.png||height="180" width="1142"]]
++
++
++==== (% style="color:#4472c4" %)**Battery**(%%) ====
++
++Sensor Battery Level.
++
++Ex1: 0x0B45 = 2885mV
++
++Ex2: 0x0B49 = 2889mV
++
++
++==== (% style="color:#4472c4" %)**Temperature**(%%) ====
++
++**Example**:
++
  If payload is: 0105H:  (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
  If payload is: FF3FH :  (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
--(FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
++（FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative）
--(% style="color:blue" %)**Humidity:   **
++==== (% style="color:#4472c4" %)**Humidity**(%%) ====
--Read:0295(H)=661(D)    Value:  661 / 10=66.1, So 66.1%
++Read:0x(0197)=412    Value:  412 / 10=41.2, So 41.2%
--(% style="color:blue" %)**TimeStamp:   **
--Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
++==== (% style="color:#4472c4" %)**Alarm Flag & MOD & Level of PA8**(%%) ====
--Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
++**Example:**
--=== 2.2.3 ThingsBoard Payload(Type~=3) ===
++If payload & 0x01 = 0x01  **~-~->** This is an Alarm Message.It means that the temperature and humidity exceed the alarm value or trigger an interrupt.
++If payload & 0x01 = 0x00  **~-~->** This is a normal uplink message, no alarm.
--Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
++If payload & 0x80>>7 = 0x01  **~-~->** The PA8 is low level.
--(% style="color:#4472c4" %)**{"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}**
++If payload & 0x80>>7 =0x00  **~-~->** The PA8 is high level.
++If payload >> 2 = 0x00     **~-~->**  means MOD=1, This is a sampling uplink message.
--=== 2.2.4 ThingSpeak Payload(Type~=1) ===
++If payload >> 2 = 0x31     **~-~->**  means MOD=31, this message is a reply message for polling, this message contains the alarm settings. see [[this link>>path:#HPolltheAlarmsettings:]] for detail.
--This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
++== 2.4 Payload Decoder file ==
--Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
--As below:
++In TTN, use can add a custom payload so it shows friendly reading
--(% style="color:#4472c4" %)**field1=27.9&field2=49.9&field3=3.23&field4=28**
++In the page (% style="color:#037691" %)**Applications ~-~-> Payload Formats ~-~-> Custom ~-~-> decoder**(%%) to add the decoder from:
++[[https:~~/~~/github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB>>https://github.com/dragino/dragino-end-node-decoder/tree/main/S31-LB%26S31B-LB]]
--== 2.3 Test Uplink and Change Update Interval ==
++== 2.5 Datalog Feature ==
--By default, Sensor will send uplinks (% style="color:blue" %)**every 2 hours**(%%) & AT+NOUD=8
--User can use below commands to change the (% style="color:blue" %)**uplink interval**.
++Datalog Feature is to ensure IoT Server can get all sampling data from Sensor even if the LoRaWAN network is down. For each sampling, S31x-LB will store the reading for future retrieving purposes.
--(% style="color:#037691" %)**AT+TDC=600 ** (%%)      ~/~/ Set Update Interval to 600s
--User can also push the button for more than 1 seconds to activate an uplink.
++=== 2.5.1 Ways to get datalog via LoRaWAN ===
--== 2.4 Multi-Samplings and One uplink ==
++Set [[PNACKMD=1>>||anchor="H2.5.4DatalogUplinkpayload28FPORT3D329"]], S31x-LB will wait for ACK for every uplink, when there is no LoRaWAN network,S31x-LB will mark these records with non-ack messages and store the sensor data, and it will send all messages (10s interval) after the network recovery.
++* (((
++a) S31x-LB will do an ACK check for data records sending to make sure every data arrive server.
++)))
++* (((
++b) S31x-LB will send data in **CONFIRMED Mode** when PNACKMD=1, but S31x-LB won't re-transmit the packet if it doesn't get ACK, it will just mark it as a NONE-ACK message. In a future uplink if S31x-LB gets a ACK, S31x-LB will consider there is a network connection and resend all NONE-ACK messages.
++)))
--To save battery life, S31-NB will sample temperature & humidity data every 15 minutes and send one uplink every 2 hours. So each uplink it will include 8 stored data + 1 real-time data. They are defined by:
++Below is the typical case for the auto-update datalog feature (Set PNACKMD=1)
--* (% style="color:#037691" %)**AT+TR=900**   (%%)     ~/~/ The unit is seconds, and the default is to record data once every 900 seconds (15 minutes, the minimum can be set to 180 seconds)
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220703111700-2.png?width=1119&height=381&rev=1.1||alt="图片-20220703111700-2.png" height="381" width="1119"]]
--* (% style="color:#037691" %)**AT+NOUD=8**     (%%)~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
--The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
++=== 2.5.2 Unix TimeStamp ===
--[[image:1692424376354-959.png]]
++S31x-LB uses Unix TimeStamp format based on
--== 2.5 Humidity and Temperature alarm function ==
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-11.png?width=627&height=97&rev=1.1||alt="图片-20220523001219-11.png" height="97" width="627"]]
++User can get this time from link:  [[https:~~/~~/www.epochconverter.com/>>url:https://www.epochconverter.com/]] :
--On each sampling define by AT+TR ( default 900s or 15 minutes), when the value exceed the range, it will trigger an Alarm and immediately sends a uplink.
++Below is the converter example
++[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/LHT65N%20LoRaWAN%20Temperature%20%26%20Humidity%20Sensor%20Manual/WebHome/image-20220523001219-12.png?width=720&height=298&rev=1.1||alt="图片-20220523001219-12.png" height="298" width="720"]]
--(% style="color:blue" %)**AT Commands:**
--(% style="color:#037691" %)**AT+ SHHUM=min,max**
++So, we can use AT+TIMESTAMP=1611889405 or downlink 3060137afd00 to set the current time 2021 – Jan ~-~- 29 Friday 03:03:25
--Example: AT+ SHHUM=50,80     ~/~/ Alarm when humidity lower than 50 or higher than 80.
++=== 2.5.3 Set Device Time ===
--(% style="color:#037691" %)**AT+ SHTEMP=min,max**
--Example: AT+ SHTEMP=20,30   ~/~/ Alarm when temperature lower than 20 or higher than 30
++User need to set (% style="color:blue" %)**SYNCMOD=1**(%%) to enable sync time via MAC command.
++Once S31x-LB Joined LoRaWAN network, it will send the MAC command (DeviceTimeReq) and the server will reply with (DeviceTimeAns) to send the current time to S31x-LB. If S31x-LB fails to get the time from the server, S31x-LB will use the internal time and wait for next time request (AT+SYNCTDC to set the time request period, default is 10 days).
--(% style="color:red" %)**Notice:**
++(% style="color:red" %)**Note: LoRaWAN Server need to support LoRaWAN v1.0.3(MAC v1.0.3) or higher to support this MAC command feature, Chirpstack,TTN V3 v3 and loriot support but TTN V3 v2 doesn't support. If server doesn't support this command, it will through away uplink packet with this command, so user will lose the packet with time request for TTN V3 v2 if SYNCMOD=1.**
--* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)**AT+SHTEMP=0,0.**
--* If user only want to send only min or max, user can set the alarm to a value that device won’t reach. For example: (% style="color:#037691" %)**AT+SHTEMP=-80,0.**
++=== 2.5.4 Datalog Uplink payload (FPORT~=3) ===
++The Datalog uplinks will use below payload format.
--== 2.6 Trggier an uplink by external interrupt ==
++**Retrieval data payload:**
++(% border="1" cellspacing="5" style="background-color:#f2f2f2; width:500px" %)
++|=(% style="width: 60px;background-color:#D9E2F3;color:#0070C0" %)(((
++**Size(bytes)**
++)))|=(% style="width: 40px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 55px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 65px; background-color:#D9E2F3;color:#0070C0" %)**2**|=(% style="width: 180px; background-color:#D9E2F3;color:#0070C0" %)**1**|=(% style="width: 100px; background-color:#D9E2F3;color:#0070C0" %)**4**
++|(% style="width:103px" %)Value|(% style="width:68px" %)(((
++ignore
++)))|(% style="width:104px" %)(((
++(((
++Humidity
++)))
--S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
++(((
++
++)))
++)))|(% style="width:87px" %)(((
++Temperature
++)))|(% style="width:178px" %)(((
++Poll message flag & Alarm Flag& Level of PA8
++)))|(% style="width:137px" %)Unix Time Stamp
--(% style="color:blue" %)**AT command:**
++**Poll message flag & Alarm Flag & Level of PA8:**
--* (% style="color:#037691" %)**AT+INTMOD **(%%)        ~/~/ Set the trigger interrupt mode
++[[image:image-20230524114302-1.png||height="115" width="736"]]
--* (% style="color:#037691" %)**AT+INTMOD=0 **(%%)   ~/~/ Disable Interrupt
--* (% style="color:#037691" %)**AT+INTMOD=1 **(%%)   ~/~/ Trigger by rising and falling edge
++**No ACK Message**:  1: This message means this payload is fromn Uplink Message which doesn't get ACK from the server before ( for **PNACKMD=1** feature)
--* (% style="color:#037691" %)**AT+INTMOD=2 **(%%)   ~/~/ Trigger by falling edge
++**Poll Message Flag**: 1: This message is a poll message reply.
--* (% style="color:#037691" %)**AT+INTMOD=3  **(%%)  ~/~/ Trigger by rising edge
++* Poll Message Flag is set to 1.
++* Each data entry is 11 bytes, to save airtime and battery, devices will send max bytes according to the current DR and Frequency bands.
--= 3. Configure S31x-NB =
++For example, in US915 band, the max payload for different DR is:
++**a) DR0:** max is 11 bytes so one entry of data
++
++**b) DR1:** max is 53 bytes so devices will upload 4 entries of data (total 44 bytes)
++
++**c) DR2:** total payload includes 11 entries of data
++
++**d) DR3: **total payload includes 22 entries of data.
++
++If devise doesn't have any data in the polling time. Device will uplink 11 bytes of 0
++
++**Example:**
++
++If S31x-LB has below data inside Flash:
++
++[[image:image-20230524114654-2.png]]
++
++
++If user sends below downlink command:  31646D84E1646D856C05
++
++Where : Start time: 646D84E1 = time 23/5/24 03:30:41
++
++             Stop time: 646D856C= time 23/5/24 03:33:00
++
++
++**S31x-LB will uplink this payload.**
++
++[[image:image-20230524114826-3.png||height="448" width="1244"]]
++
++(((
++00 00 02 36 01 10 40 64 6D 84 E1 00 00 02 37 01 10 40 64 6D 84 F8 00 00 02 37 01 0F 40 64 6D 85 04 00 00 02 3A 01 0F 40 64 6D 85 18 00 00 02 3C 01 0F 40 64 6D 85 36 00 00 02 3D 01 0E 40 64 6D 85 3F 00 00 02 3F 01 0E 40 64 6D 85 60 00 00 02 40 01 0E 40 64 6D 85 6A
++)))
++
++(((
++Where the first 11 bytes is for the first entry:
++)))
++
++(((
++00 00 02 36 01 10 40 64 6D 84 E1
++)))
++
++(((
++**Hum**=0x0236/10=56.6
++)))
++
++(((
++**Temp**=0x0110/10=27.2
++)))
++
++(((
++**poll message flag & Alarm Flag & Level of PA8**=0x40,means reply data,sampling uplink message,the PA8 is low level.
++)))
++
++(((
++**Unix time** is 0x646D84E1=1684899041s=23/5/24 03:30:41
++)))
++
++
++(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的(% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" data-widget="image" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220, 220, 220, 0.5); display:none" tabindex="-1" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==||alt="数据 URI 图片" draggable="true" height="15" role="presentation" title="单击并拖动以移动" width="15"]](% aria-label="数据 URI 图像图像小部件" contenteditable="false" role="region" style="background-image:url(http://wiki1.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" tabindex="-1" title="单击并拖动以调整大小" %)的
++
++== 2.6 Temperature Alarm Feature ==
++
++
++S31x-LB work flow with Alarm feature.
++
++
++[[image:image-20230524110125-3.png||height="768" width="1115"]]
++
++
++
++== 2.7 Frequency Plans ==
++
++
++The S31x-LB uses OTAA mode and below frequency plans by default. If user want to use it with different frequency plan, please refer the AT command sets.
++
++[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20Frequency%20Band/]]
++
++
++== 2.8 Firmware Change Log ==
++
++
++**Firmware download link: **[[https:~~/~~/www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0>>https://www.dropbox.com/sh/fis3g6nmhv0eokg/AAC6BcCZaX4BdqZkduUvZ3jIa?dl=0]]
++
++
++= 3. Configure S31x-LB =
++
  == 3.1 Configure Methods ==
--S31x-NB supports below configure method:
++S31x-LB supports below configure method:
  * AT Command via Bluetooth Connection (**Recommended**): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
--
  * AT Command via UART Connection : See [[UART Connection>>http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H2.3UARTConnectionforSN50v3basemotherboard]].
++* LoRaWAN Downlink.  Instruction for different platforms: See [[IoT LoRaWAN Server>>http://wiki.dragino.com/xwiki/bin/view/Main/]] section.
--== 3.2 AT Commands Set ==
++== 3.2 General Commands ==
--AT+<CMD>?           : Help on <CMD>
++These commands are to configure:
--AT+<CMD>                      : Run <CMD>
++* General system settings like: uplink interval.
++* LoRaWAN protocol & radio related command.
--AT+<CMD>=<value>      : Set the value
++They are same for all Dragino Devices which support DLWS-005 LoRaWAN Stack. These commands can be found on the wiki:
--AT+<CMD>=?          : Get the value
++[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
--(% style="color:blue" %)**General Commands**
++== 3.3 Commands special design for S31x-LB ==
--AT                    : Attention
--AT?                  : Short Help
++These commands only valid for S31x-LB, as below:
--ATZ                 : MCU Reset
--AT+TDC          : Application Data Transmission Interval
++=== 3.3.1 Set Transmit Interval Time ===
--AT+CFG          : Print all configurations
--AT+CFGMOD           : Working mode selection
++Feature: Change LoRaWAN End Node Transmit Interval.
--AT+DEUI                  : Get or set the Device ID
++(% style="color:blue" %)**AT Command: AT+TDC**
--AT+INTMOD            : Set the trigger interrupt mode
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 156px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 137px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="background-color:#D9E2F3;color:#0070C0" %)**Response**
++|(% style="width:156px" %)AT+TDC=?|(% style="width:137px" %)Show current transmit Interval|(((
++30000
++OK
++the interval is 30000ms = 30s
++)))
++|(% style="width:156px" %)AT+TDC=60000|(% style="width:137px" %)Set Transmit Interval|(((
++OK
++Set transmit interval to 60000ms = 60 seconds
++)))
--AT+5VT           : Set extend the time of 5V power
++(% style="color:blue" %)**Downlink Command: 0x01**
--AT+PRO          : Choose agreement
++Format: Command Code (0x01) followed by 3 bytes time value.
--AT+RXDL        : Extend the sending and receiving time
++If the downlink payload=0100003C, it means set the END Node's Transmit Interval to 0x00003C=60(S), while type code is 01.
--AT+DNSCFG   : Get or Set DNS Server
++* Example 1: Downlink Payload: 0100001E       ~/~/  Set Transmit Interval (TDC) = 30 seconds
++* Example 2: Downlink Payload: 0100003C       ~/~/  Set Transmit Interval (TDC) = 60 seconds
--AT+GETSENSORVALUE   : Returns the current sensor measurement
++=== 3.3.2 Get Device Status ===
--AT+NOUD  : Get or Set the number of data to be uploaded
--AT+CDP     : Read or Clear cached data
++Send a LoRaWAN downlink to ask device send Alarm settings.
--AT+SHTEMP:   Get or Set alarm of temp
++(% style="color:blue" %)**Downlink Payload:  **(%%)0x26 01
--AT+SHHUM:   Get or Set alarm of moisture
++Sensor will upload Device Status via FPORT=5. See payload section for detail.
--AT+SERVADDR :   Server Address
++=== 3.3.3 Set Temperature Alarm Threshold ===
--(% style="color:blue" %)**UDP Management**
--AT+CFM  :    Upload confirmation mode (only valid for UDP)
++* (% style="color:blue" %)**AT Command:**
++(% style="color:#037691" %)**AT+SHTEMP=min,max**
--(% style="color:blue" %)**MQTT Management**
++* When min=0, and max≠0, Alarm higher than max
++* When min≠0, and max=0, Alarm lower than min
++* When min≠0 and max≠0, Alarm higher than max or lower than min
--AT+CLIENT               : Get or Set MQTT client
++Example:
--AT+UNAME              : Get or Set MQTT Username
++   AT+SHTEMP=0,30   ~/~/ Alarm when temperature higher than 30.
--AT+PWD                  : Get or Set MQTT password
++* (% style="color:blue" %)**Downlink Payload:**
--AT+PUBTOPIC          : Get or Set MQTT publish topic
++(% style="color:#037691" %)**0x(0C 01 00 1E)**  (%%)     ~/~/ Set AT+SHTEMP=0,30
--AT+SUBTOPIC          : Get or Set MQTT subscription topic
++(% style="color:red" %)**(note: 3^^rd^^ byte= 0x00 for low limit(not set), 4^^th^^ byte = 0x1E for high limit: 30)**
--(% style="color:blue" %)**Information**
++=== 3.3.4 Set Humidity Alarm Threshold ===
--AT+FDR              : Factory Data Reset
--AT+PWORD        : Serial Access Password
++* (% style="color:blue" %)**AT Command:**
--AT+LDATA           : Get the last upload data
++(% style="color:#037691" %)**AT+SHHUM=min,max**
--AT+CDP               : Read or Clear cached data
++* When min=0, and max≠0, Alarm higher than max
++* When min≠0, and max=0, Alarm lower than min
++* When min≠0 and max≠0, Alarm higher than max or lower than min
++Example:
++   AT+SHHUM=70,0      ~/~/ Alarm when humidity lower than 70%.
++
++* (% style="color:blue" %)**Downlink Payload:**
++
++(% style="color:#037691" %)**0x(0C 02 46 00)**(%%)         ~/~/ Set AT+SHTHUM=70,0
++
++(% style="color:red" %)**(note: 3^^rd^^ byte= 0x46 for low limit (70%), 4^^th^^ byte = 0x00 for high limit (not set))**
++
++
++=== 3.3.5 Set Alarm Interval ===
++
++
++The shortest time of two Alarm packet. (unit: min)
++
++* (% style="color:blue" %)**AT Command:**
++
++(% style="color:#037691" %)**AT+ATDC=30** (%%)      ~/~/ The shortest interval of two Alarm packets is 30 minutes, Means is there is an alarm packet uplink, there won't be another one in the next 30 minutes.
++
++* (% style="color:blue" %)**Downlink Payload:**
++
++(% style="color:#037691" %)**0x(0D 00 1E)**(%%)     **~-~--> ** Set AT+ATDC=0x 00 1E = 30 minutes
++
++
++=== 3.3.6 Get Alarm settings ===
++
++
++Send a LoRaWAN downlink to ask device send Alarm settings.
++
++* (% style="color:#037691" %)**Downlink Payload:  **(%%)0x0E 01
++
++**Example:**
++
++[[image:image-20230524110211-4.png]]
++
++**Explain:**
++
++* Alarm & MOD bit is 0x7C, 0x7C >> 2 = 0x31: Means this message is the Alarm settings message.
++
++=== 3.3.7 Set Interrupt Mode ===
++
++
++Feature, Set Interrupt mode for PA8 of pin.
++
++When AT+INTMOD=0 is set, PA8 is used as a digital input port.
++
++(% style="color:blue" %)**AT Command: AT+INTMOD**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++|(% style="width:154px" %)AT+INTMOD=?|(% style="width:196px" %)Show current interrupt mode|(% style="width:157px" %)(((
++0
++OK
++the mode is 0 =Disable Interrupt
++)))
++|(% style="width:154px" %)AT+INTMOD=2|(% style="width:196px" %)(((
++Set Transmit Interval
++0. (Disable Interrupt),
++~1. (Trigger by rising and falling edge)
++2. (Trigger by falling edge)
++3. (Trigger by rising edge)
++)))|(% style="width:157px" %)OK
++
++(% style="color:blue" %)**Downlink Command: 0x06**
++
++Format: Command Code (0x06) followed by 3 bytes.
++
++This means that the interrupt mode of the end node is set to 0x000003=3 (rising edge trigger), and the type code is 06.
++
++* Example 1: Downlink Payload: 06000000       ~/~/  Turn off interrupt mode
++* Example 2: Downlink Payload: 06000003      ~/~/   Set the interrupt mode to rising edge trigger
++
++=== 3.3.8 Set Power Output Duration ===
++
++
++Control the output duration 5V . Before each sampling, device will
++
++~1. first enable the power output to external sensor,
++
++2. keep it on as per duration, read sensor value and construct uplink payload
++
++3. final, close the power output.
++
++(% style="color:blue" %)**AT Command: AT+5VT**
++
++(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
++|=(% style="width: 155px;background-color:#D9E2F3;color:#0070C0" %)**Command Example**|=(% style="width: 197px;background-color:#D9E2F3;color:#0070C0" %)**Function**|=(% style="width: 158px;background-color:#D9E2F3;color:#0070C0" %)**Response**
++|(% style="width:154px" %)AT+5VT=?|(% style="width:196px" %)Show 5V open time.|(% style="width:157px" %)0 (default)
++OK
++|(% style="width:154px" %)AT+5VT=1000|(% style="width:196px" %)Close after a delay of 1000 milliseconds.|(% style="width:157px" %)OK
++
++(% style="color:blue" %)**Downlink Command: 0x07**
++
++Format: Command Code (0x07) followed by 2 bytes.
++
++The first and second bytes are the time to turn on.
++
++* Example 1: Downlink Payload: 070000     **~-~-->**   AT+5VT=0
++* Example 2: Downlink Payload: 0701F4      **~-~-->**  AT+5VT=500
++
  = 4. Battery & Power Consumption =
@@ -620,4 +620,4 @@
  * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[Support@dragino.cc>>mailto:Support@dragino.cc]].
--(% style="display:none" %)  (%%)
++(% style="display:none" %) (%%)

1692424009971-458.png

Author

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

Size

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

Content

1692424376354-959.png

Author

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

Size

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

Content