Wiki source code of S31-NB/S31B-NB_BN-IoT Outdoor Temperature & Humidity Sensor User Manual

Version 82.17 by Xiaoling on 2023/08/19 14:29

version	line-number	content
69.2	1	(% style="text-align:center" %)
	2	[[image:image-20230819102136-3.png]]
1.1	3
	4
26.1	5
31.2	6	Table of Contents：
30.1	7
1.1	8	{{toc/}}
	9
	10
	11
	12
	13
	14
31.1	15	= 1. Introduction =
1.1	16
70.3	17	== 1.1 What is S31x-NB NB-IoT Temperature & Humidity Sensor ==
1.1	18
39.6	19
73.3	20	The Dragino S31-NB and S31B-NB are (% style="color:blue" %)NB-IoT Temperature and Humidity Sensor(%%) for Internet of Things solution. It is used to measure the surrounding (% style="color:blue" %)environment temperature and relative air humidity precisely(%%), and then upload to IoT server via NB-IoT network*.
1.1	21
73.3	22	The temperature & humidity sensor used in S31-NB is SHT31, which is fully calibrated, linearized, and temperature compensated digital output from Sensirion, it provides a strong reliability and long-term stability. The SHT31 is fixed in a (% style="color:blue" %)waterproof anti-condensation casing(%%) for long term use.
1.1	23
75.2	24	S31-NB supports different uplink methods include (% style="color:blue" %)TCP, MQTT, UDP for different application requirement. and Support Uplinks to various IoT Servers.
1.1	25
73.3	26	S31-NB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), It is designed for long term use up to several years. (Real-world battery life depends on the use environment, update period and uplink method. Please check related Power Analyze report).
1.1	27
70.2	28	*make sure you have NB-IoT coverage locally.
1.1	29
	30
70.2	31	[[image:1692411831805-116.png]]
1.1	32
	33
	34	== 1.2 Features ==
	35
39.6	36
70.3	37	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	38	* Ultra-low power consumption
70.3	39	* External 3 meters SHT31 probe (For S31-NB)
	40	* Measure range -40°C ~~ 85°C
5.1	41	* Temperature & Humidity alarm
70.3	42	* Multiply Sampling and one uplink
	43	* Support Bluetooth v5.1 remote configure and update firmware
1.1	44	* Uplink on periodically
	45	* Downlink to change configure
	46	* 8500mAh Battery for long term use
70.3	47	* Nano SIM card slot for NB-IoT SIM
1.1	48
	49	== 1.3 Specification ==
	50
	51
	52	(% style="color:#037691" %)Common DC Characteristics:
	53
70.4	54	* Supply Voltage: 2.1v ~~ 3.6v
1.1	55	* Operating Temperature: -40 ~~ 85°C
	56
	57	(% style="color:#037691" %)Temperature Sensor:
	58
5.1	59	* Range: -40 to + 80°C
	60	* Accuracy: ±0.2 @ 0-90 °C
	61	* Resolution: 0.1°C
	62	* Long Term Shift: <0.03 °C/yr
1.1	63
5.1	64	(% style="color:#037691" %)Humidity Sensor:
	65
	66	* Range: 0 ~~ 99.9% RH
	67	* Accuracy: ± 2%RH ( 0 ~~ 100%RH)
	68	* Resolution: 0.01% RH
	69	* Long Term Shift: <0.25 %RH/yr
	70
70.4	71	(% style="color:#037691" %)NB-IoT Spec:
1.1	72
70.4	73	NB-IoT Module: BC660K-GL
1.1	74
70.4	75	Support Bands:
	76
	77	* B1 @H-FDD: 2100MHz
	78	* B2 @H-FDD: 1900MHz
	79	* B3 @H-FDD: 1800MHz
	80	* B4 @H-FDD: 2100MHz
	81	* B5 @H-FDD: 860MHz
	82	* B8 @H-FDD: 900MHz
	83	* B12 @H-FDD: 720MHz
	84	* B13 @H-FDD: 740MHz
	85	* B17 @H-FDD: 730MHz
	86	* B18 @H-FDD: 870MHz
	87	* B19 @H-FDD: 870MHz
	88	* B20 @H-FDD: 790MHz
	89	* B25 @H-FDD: 1900MHz
	90	* B28 @H-FDD: 750MHz
	91	* B66 @H-FDD: 2000MHz
	92	* B70 @H-FDD: 2000MHz
	93	* B85 @H-FDD: 700MHz
	94
1.1	95	(% style="color:#037691" %)Battery:
	96
	97	* Li/SOCI2 un-chargeable battery
	98	* Capacity: 8500mAh
70.5	99	* Self Discharge: <1% / Year @ 25°C
1.1	100	* Max continuously current: 130mA
	101	* Max boost current: 2A, 1 second
	102
	103	(% style="color:#037691" %)Power Consumption
	104
70.4	105	* STOP Mode: 10uA @ 3.3v
	106	* Max transmit power: 350mA@3.3v
1.1	107
73.2	108	== 1.4 Applications ==
1.1	109
	110
70.5	111	* Smart Buildings & Home Automation
	112	* Logistics and Supply Chain Management
	113	* Smart Metering
	114	* Smart Agriculture
	115	* Smart Cities
	116	* Smart Factory
	117
73.2	118	== 1.5 Sleep mode and working mode ==
	119
	120
	121	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any LoRaWAN activate. This mode is used for storage and shipping to save battery life.
	122
	123	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as LoRaWAN Sensor to Join LoRaWAN network and send out sensor data to server. Between each sampling/tx/rx periodically, sensor will be in IDLE mode), in IDLE mode, sensor has the same power consumption as Deep Sleep mode.
	124
	125
	126
	127	== 1.6 Button & LEDs ==
	128
	129
6.1	130	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	131
	132
14.13	133	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %)
80.11	134	\|=(% 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
1.1	135	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	136	If sensor has already attached to NB-IoT network, sensor will send an uplink packet, (% style="color:blue" %)blue led (%%)will blink once.
1.1	137	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	138	)))
	139	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	140	(% style="color:green" %)Green led(%%) will fast blink 5 times, device will enter (% style="color:#037691" %)OTA mode(%%) for 3 seconds. And then start to attach NB-IoT network.
1.1	141	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	142	Once sensor is active, BLE module will be active and user can connect via BLE to configure device, no matter if device attach NB-IoT network or not.
1.1	143	)))
6.1	144	\|(% style="width:167px" %)Fast press ACT 5 times.\|(% style="width:117px" %)Deactivate Device\|(% style="width:225px" %)(% style="color:red" %)Red led(%%) will solid on for 5 seconds. Means device is in Deep Sleep Mode.
1.1	145
73.2	146	== 1.7 BLE connection ==
1.1	147
	148
73.2	149	S31x-NB support BLE remote configure and firmware update.
1.1	150
	151
	152	BLE can be used to configure the parameter of sensor or see the console output from sensor. BLE will be only activate on below case:
	153
	154	* Press button to send an uplink
	155	* Press button to active device.
	156	* Device Power on or reset.
	157
	158	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	159
	160
73.3	161	== 1.8 Pin Definitions & Switch ==
1.1	162
73.3	163
	164	S31x-NB use the mother board from S31-NB which as below.
	165
73.2	166	[[image:image-20230819104805-5.png]]
1.1	167
43.1	168
	169
73.3	170	=== 1.8.1 Jumper JP2 ===
43.1	171
73.3	172
	173	Power on Device when put this jumper.
	174
	175
	176	=== 1.8.2 BOOT MODE / SW1 ===
	177
	178
	179	1) (% style="color:blue" %)ISP(%%): upgrade mode, device won't have any signal in this mode. but ready for upgrade firmware. LED won't work. Firmware won't run.
	180
	181	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
	182
	183
	184	=== 1.8.3 Reset Button ===
	185
80.2	186
73.3	187	Press to reboot the device.
	188
	189
	190
	191	== 1.9 Hardware Variant ==
	192
	193
75.2	194	(% border="1" cellspacing="5" style="width:410px" %)
80.10	195	\|=(% 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
44.1	196	\|(% style="width:102px" %)(((
	197	S31-LB
75.2	198	)))\|(% style="width:126px" %)(((
	199	(% style="text-align:center" %)
	200	[[image:image-20230819110632-6.png\|\|height="130" width="104"]]
	201	)))\|(% style="width:179px" %)(((
6.1	202	1 x SHT31 Probe
1.1	203
75.2	204	Cable Length : 3 meters
1.1	205
	206
	207	)))
44.1	208	\|(% style="width:102px" %)(((
	209	S31B-LB
75.2	210	)))\|(% style="width:126px" %)(((
	211	(% style="text-align:center" %)
	212	[[image:image-20230819110702-7.png\|\|height="164" width="90"]]
	213	)))\|(% style="width:179px" %)(((
6.1	214	1 x SHT31 Probe
1.1	215
6.1	216	Installed in device.
1.1	217	)))
	218
	219	(% style="display:none" %)
	220
	221
	222
	223
80.2	224	= 2. Use S31-NB to communicate with IoT Server =
1.1	225
80.2	226	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	227
	228
80.2	229	The S31-NB is equipped with a NB-IoT module, the pre-loaded firmware in S31-NB will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by S31-NB.
1.1	230
	231
80.2	232	Below shows the network structure:
1.1	233
80.2	234	[[image:1692415924540-357.png]]
1.1	235
	236
80.4	237	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of S31-NB.
1.1	238
	239
82.17	240	(% 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.
1.1	241
80.2	242	1. 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]].
80.4	243
80.8	244	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.1	245
80.2	246	Below shows result of different server as a glance.
1.1	247
	248
80.9	249	(% border="1" cellspacing="4" style="width:515px" %)
81.2	250	\|(% 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
80.9	251	\|(% 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" %)
	252	\|(% 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" %)
	253	\|(% 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" %)
	254	\|(% 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" %)
	255	\|(% 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" %)
	256	\|(% 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" %)
	257	\|(% 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" %)
	258	\|(% style="width:127px" %) \|(% style="width:385px" %) \|(% style="width:170px" %)
80.2	259
80.4	260	(% 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]].
80.2	261
	262
	263	== 2.2 Payload Types ==
	264
	265
80.3	266	To meet different server requirement, S31-NB supports different payload type.
1.1	267
81.2	268	Includes:
1.1	269
80.3	270	* [[General JSON format payload>>path:#General_Json]]. (Type=5)
80.7	271
80.3	272	* [[HEX format Payload>>path:#HEX_Payload]]. (Type=0)
80.7	273
80.3	274	* [[ThingSpeak Format>>path:#ThingSpeak_Payload]]. (Type=1)
80.7	275
80.3	276	* [[ThingsBoard Format>>path:#ThingsBoard_Payload]]. (Type=3)
1.1	277
80.3	278	User can specify the payload type when choose the connection protocol. Example:
1.1	279
81.2	280	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	281
80.8	282	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	283
81.2	284	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	285
	286
81.2	287	=== 2.2.1 General Json Format (Type~=5) ===
1.1	288
80.8	289
80.3	290	This is the General Json Format. As below:
1.1	291
80.8	292	(% 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}}
1.1	293
	294
81.2	295	(% style="color:red" %)Notice, from above payload:
1.1	296
80.3	297	* Temperature , Humidity , Battery & Signal are the value at uplink time.
1.1	298
80.4	299	* 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.
1.1	300
81.2	301	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	302
	303
80.3	304	This is the HEX Format. As below:
1.1	305
80.8	306	(% style="color:#4472c4" %)f86620705346276200640cba16010000000011011801e864d49c2d011a01e364d49925011901eb64d49871011901e564d497bd011a01e664d49709011901e964d49655011a01e864d495a1011a01e864d494ed011801e864d49439
1.1	307
81.2	308	[[image:1692424009971-458.png]]
6.1	309
1.1	310
80.4	311	(% style="color:blue" %)Version:
1.1	312
80.3	313	These bytes include the hardware and software version.
1.1	314
80.4	315	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x00 for S31B-NB & S31-NB
1.1	316
80.4	317	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=100, means firmware version 100
1.1	318
	319
81.2	320	(% style="color:blue" %)BAT (Battery Info):
1.1	321
80.3	322	Ex1: 0x0CBA = 3258mV
1.1	323
	324
80.4	325	(% style="color:blue" %)Signal Strength:
1.1	326
80.3	327	NB-IoT Network signal Strength.
1.1	328
80.3	329	Ex1: 0x16 = 22
1.1	330
80.3	331	0 -113dBm or less
1.1	332
80.3	333	1 -111dBm
1.1	334
80.3	335	2...30 -109dBm... -53dBm
1.1	336
80.3	337	31 -51dBm or greater
1.1	338
80.3	339	99 Not known or not detectable
1.1	340
	341
80.4	342	(% style="color:blue" %)Temperature:
1.1	343
	344	If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
	345
	346	If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
	347
80.3	348	(FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
1.1	349
	350
80.4	351	(% style="color:blue" %)Humidity:
1.1	352
80.3	353	Read:0295(H)=661(D) Value: 661 / 10=66.1, So 66.1%
1.1	354
	355
80.4	356	(% style="color:blue" %)TimeStamp:
1.1	357
80.3	358	Unit TimeStamp Example: 64d49439(H) = 1691653177(D)
1.1	359
80.3	360	Put the decimal value into this link(https:~/~/www.epochconverter.com/) to get the time.
1.1	361
	362
81.2	363	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
1.1	364
80.8	365
80.3	366	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	367
80.8	368	(% style="color:#4472c4" %){"IMEI":866207053462762,"temperature":29.2,"humidity":54.2,"battery":3.27,"signal":24}
46.1	369
1.1	370
81.2	371	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
1.1	372
80.8	373
80.3	374	This payload meets ThingSpeak platform requirement. It includes only four fields. Form 1~~4 are:
1.1	375
80.3	376	Temperature, Humidity, Battery & Signal. This payload type only valid for ThingsSpeak Platform
14.22	377
80.3	378	As below:
1.1	379
80.8	380	(% style="color:#4472c4" %)field1=27.9&field2=49.9&field3=3.23&field4=28
1.1	381
10.1	382
80.4	383	== 2.3 Test Uplink and Change Update Interval ==
1.1	384
	385
80.4	386	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	387
80.4	388	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	389
82.2	390	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	391
80.3	392	User can also push the button for more than 1 seconds to activate an uplink.
1.1	393
	394
80.4	395	== 2.4 Multi-Samplings and One uplink ==
39.5	396
80.4	397
80.3	398	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:
1.1	399
82.6	400	* (% 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)
1.1	401
82.12	402	* (% 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.
1.1	403
80.3	404	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	405
82.2	406	[[image:1692424376354-959.png]]
1.1	407
	408
80.4	409	== 2.5 Humidity and Temperature alarm function ==
1.1	410
80.5	411
80.3	412	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.
39.5	413
1.1	414
80.4	415	(% style="color:blue" %)AT Commands:
1.1	416
80.4	417	(% style="color:#037691" %)AT+ SHHUM=min,max
1.1	418
82.6	419	Example: AT+ SHHUM=50,80 ~/~/ Alarm when humidity lower than 50 or higher than 80.
1.1	420
	421
80.4	422	(% style="color:#037691" %)AT+ SHTEMP=min,max
1.1	423
82.6	424	Example: AT+ SHTEMP=20,30 ~/~/ Alarm when temperature lower than 20 or higher than 30
1.1	425
	426
80.4	427	(% style="color:red" %)Notice:
1.1	428
80.4	429	* To disable Alarm, user can set min and max to same value , such as (% style="color:#037691" %)AT+SHTEMP=0,0.
1.1	430
80.4	431	* 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.
1.1	432
80.5	433	== 2.6 Trggier an uplink by external interrupt ==
	434
	435
80.3	436	S31-NB has an external trigger interrupt function. Users can use the PB15 pin to trigger the upload of data packets.
55.1	437
80.5	438	(% style="color:blue" %)AT command:
46.1	439
82.6	440	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	441
82.6	442	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt
1.1	443
82.6	444	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	445
82.6	446	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	447
82.6	448	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	449
80.6	450	= 3. Configure S31x-NB =
1.1	451
16.4	452	== 3.1 Configure Methods ==
1.1	453
	454
80.6	455	S31x-NB supports below configure method:
1.1	456
	457	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	458
11.1	459	* 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]].
80.6	460
82.8	461	== 3.2 AT Commands Set ==
1.1	462
	463
82.8	464	AT+<CMD>? : Help on <CMD>
1.1	465
82.8	466	AT+<CMD> : Run <CMD>
1.1	467
82.8	468	AT+<CMD>=<value> : Set the value
1.1	469
82.8	470	AT+<CMD>=? : Get the value
1.1	471
	472
82.10	473	(% style="color:blue" %)General Commands
1.1	474
82.8	475	AT : Attention
1.1	476
82.9	477	AT? : Short Help
1.1	478
82.9	479	ATZ : MCU Reset
1.1	480
82.9	481	AT+TDC : Application Data Transmission Interval
1.1	482
82.9	483	AT+CFG : Print all configurations
1.1	484
82.8	485	AT+CFGMOD : Working mode selection
1.1	486
82.9	487	AT+DEUI : Get or set the Device ID
1.1	488
82.8	489	AT+INTMOD : Set the trigger interrupt mode
1.1	490
82.8	491	AT+5VT : Set extend the time of 5V power
1.1	492
82.8	493	AT+PRO : Choose agreement
1.1	494
82.9	495	AT+RXDL : Extend the sending and receiving time
1.1	496
82.9	497	AT+DNSCFG : Get or Set DNS Server
1.1	498
82.8	499	AT+GETSENSORVALUE : Returns the current sensor measurement
1.1	500
82.9	501	AT+NOUD : Get or Set the number of data to be uploaded
1.1	502
82.8	503	AT+CDP : Read or Clear cached data
1.1	504
82.9	505	AT+SHTEMP: Get or Set alarm of temp
1.1	506
82.9	507	AT+SHHUM: Get or Set alarm of moisture
1.1	508
82.9	509	AT+SERVADDR : Server Address
1.1	510
82.9	511
82.10	512	(% style="color:blue" %)UDP Management
1.1	513
82.9	514	AT+CFM : Upload confirmation mode (only valid for UDP)
1.1	515
39.6	516
82.10	517	(% style="color:blue" %)MQTT Management
1.1	518
82.8	519	AT+CLIENT : Get or Set MQTT client
1.1	520
82.8	521	AT+UNAME : Get or Set MQTT Username
1.1	522
82.8	523	AT+PWD : Get or Set MQTT password
1.1	524
82.9	525	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	526
82.9	527	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	528
	529
82.10	530	(% style="color:blue" %)Information
1.1	531
82.9	532	AT+FDR : Factory Data Reset
1.1	533
82.9	534	AT+PWORD : Serial Access Password
1.1	535
82.9	536	AT+LDATA : Get the last upload data
39.6	537
82.9	538	AT+CDP : Read or Clear cached data
1.1	539
82.9	540
16.4	541	= 4. Battery & Power Consumption =
14.45	542
1.1	543
82.11	544	S31x-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	545
	546	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	547
	548
82.11	549	= 5. Firmware update =
1.1	550
	551
82.11	552	User can change device firmware to::
1.1	553
13.1	554	* Update with new features.
82.11	555
13.1	556	* Fix bugs.
1.1	557
82.13	558	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/fhb3uyl4gt6clru/AAAiZVTFcxrfE1JOOyfcgO9ha?dl=0]]
1.1	559
31.1	560	Methods to Update Firmware:
1.1	561
82.12	562	* (Recommended way) OTA firmware update via BLE: [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/BLE_Firmware_Update_NB_Sensors_BC660K-GL/]].
82.14	563
64.2	564	* Update through UART TTL interface : [[Instruction>>url:http://wiki.dragino.com/xwiki/bin/view/Main/UART%20Access%20for%20LoRa%20ST%20v4%20base%20model/#H1.LoRaSTv4baseHardware]].
1.1	565
82.14	566
	567
31.1	568	= 6. FAQ =
1.1	569
82.15	570	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	571
	572
82.15	573	User can access to BC660K-GL directly and send AT Commands.
1.1	574
82.15	575	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	576
	577
	578
82.15	579	= 7. Order Info =
1.1	580
	581
82.15	582	Part Number: (% style="color:blue" %)S31-NB-XX / S31B-NB-XX
1.1	583
82.15	584	(% style="color:red" %)XX(%%):
1.1	585
82.15	586	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	587
82.15	588	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	589
82.15	590	(% style="color:#037691" %)*~ 1NCE SIM Card NB-IoT network coverage**(%%): Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
1.1	591
	592
82.15	593
31.1	594	= 8. Packing Info =
1.1	595
39.6	596
39.1	597	(% style="color:#037691" %)Package Includes:
1.1	598
82.16	599	* S31-NB or S31-NB NB-IoT Sensor Node x 1
1.1	600
82.16	601	* External antenna x 1
	602
	603
	604
39.1	605	(% style="color:#037691" %)Dimension and weight:
1.1	606
82.16	607	* Device Size: 13.0 x 5 x 4.5 cm
1.1	608
82.16	609	* Device Weight: 150g
1.1	610
82.16	611	* Package Size / pcs : 14.0 x 8x 5 cm
1.1	612
82.16	613	* Weight / pcs : 180g
1.1	614
82.16	615
31.1	616	= 9. Support =
1.1	617
	618
31.1	619	* Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule.
39.6	620
	621	* 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]].
75.2	622
80.9	623	(% style="display:none" %) (%%)

Wiki source code of S31-NB/S31B-NB_BN-IoT Outdoor Temperature & Humidity Sensor User Manual

Applications