Wiki source code of TS01-NB -- NB-IoT Tilting Sensor User Manual

Last modified by Mengting Qiu on 2024/05/20 10:40

version	line-number	content
139.9	1
	2
69.2	3	(% style="text-align:center" %)
139.9	4	[[image:image-20231024134617-1.png\|\|height="512" width="408"]]
1.1	5
	6
26.1	7
83.2	8
	9
	10
82.23	11	Table of Contents:
30.1	12
1.1	13	{{toc/}}
	14
	15
	16
	17
	18
	19
31.1	20	= 1. Introduction =
1.1	21
124.3	22	== 1.1 What is NB-IoT Tilting Sensor ==
1.1	23
39.6	24
124.3	25	The Dragino TS01-NB is a (% style="color:blue" %)NB-IoT Tilting Sensor(%%) for Internet of Things solution. TS01-NB is an outdoor Tilting Sensor specially designed for (% style="color:blue" %)detecting the angle of trees, buildings or large scale equipment.
1.1	26
124.3	27	TS01-NB measures pitch and roll angle and converts to NB-IoT wireless data and sends to IoT platform via NB-IoT network.
1.1	28
124.3	29	TS01-NB supports different uplink methods including (% style="color:blue" %)MQTT, MQTTs, UDP & TCP(%%) for different application requirement, and support uplinks to various IoT Servers.
1.1	30
124.3	31	TS01-NB (% style="color:blue" %)supports BLE configure (%%)and(% style="color:blue" %) OTA update(%%) which make user easy to use.
1.1	32
124.3	33	TS01-NB is powered by (% style="color:blue" %)8500mAh Li-SOCI2 battery(%%), it is designed for long-term use up to several years.
1.1	34
124.3	35	TS01-NB has optional built-in SIM card and default IoT server connection version. Which makes it works with simple configuration.
	36
126.2	37	[[image:image-20231024184022-1.png\|\|height="330" width="883"]]
1.1	38
83.3	39
1.1	40	== 1.2 Features ==
	41
39.6	42
70.3	43	* NB-IoT Bands: B1/B2/B3/B4/B5/B8/B12/B13/B17/B18/B19/B20/B25/B28/B66/B70/B85 @H-FDD
1.1	44	* Ultra-low power consumption
124.4	45	* Detect pitch and roll angle
	46	* Support Angle Alarm
	47	* Support Datalog feature
70.3	48	* Multiply Sampling and one uplink
124.4	49	* Support BLE remote configure and update firmware
1.1	50	* Uplink on periodically
	51	* Downlink to change configure
	52	* 8500mAh Battery for long term use
84.6	53	* Uplink via MQTT, MQTTs, TCP, or UDP
70.3	54	* Nano SIM card slot for NB-IoT SIM
1.1	55
	56	== 1.3 Specification ==
	57
	58
82.28	59	(% style="color:blue" %)Common DC Characteristics:
1.1	60
84.5	61	* Supply Voltage: 2.5v ~~ 3.6v
1.1	62	* Operating Temperature: -40 ~~ 85°C
	63
124.5	64	(% style="color:blue" %)Angle Spec:
1.1	65
124.5	66	* Measure Pitch and Roll
	67	* Accuracy: 0.3°C
1.1	68
82.28	69	(% style="color:blue" %)NB-IoT Spec:
1.1	70
82.28	71	(% style="color:#037691" %)NB-IoT Module: BC660K-GL
1.1	72
82.29	73	(% style="color:#037691" %)Support Bands:
70.4	74
	75	* B1 @H-FDD: 2100MHz
	76	* B2 @H-FDD: 1900MHz
	77	* B3 @H-FDD: 1800MHz
	78	* B4 @H-FDD: 2100MHz
	79	* B5 @H-FDD: 860MHz
	80	* B8 @H-FDD: 900MHz
	81	* B12 @H-FDD: 720MHz
	82	* B13 @H-FDD: 740MHz
	83	* B17 @H-FDD: 730MHz
	84	* B18 @H-FDD: 870MHz
	85	* B19 @H-FDD: 870MHz
	86	* B20 @H-FDD: 790MHz
	87	* B25 @H-FDD: 1900MHz
	88	* B28 @H-FDD: 750MHz
	89	* B66 @H-FDD: 2000MHz
	90	* B70 @H-FDD: 2000MHz
	91	* B85 @H-FDD: 700MHz
	92
82.28	93	(% style="color:blue" %)Battery:
1.1	94
	95	* Li/SOCI2 un-chargeable battery
	96	* Capacity: 8500mAh
70.5	97	* Self Discharge: <1% / Year @ 25°C
1.1	98	* Max continuously current: 130mA
	99	* Max boost current: 2A, 1 second
	100
82.28	101	(% style="color:blue" %)Power Consumption
1.1	102
70.4	103	* STOP Mode: 10uA @ 3.3v
84.24	104	* Max transmit power: 350mA@3.3v
1.1	105
124.6	106	== 1.4 Sleep mode and working mode ==
70.5	107
73.2	108
122.2	109	(% style="color:blue" %)Deep Sleep Mode: (%%)Sensor doesn't have any NB-IoT activate. This mode is used for storage and shipping to save battery life.
73.2	110
122.2	111	(% style="color:blue" %)Working Mode: (%%)In this mode, Sensor will work as NB-IoT Sensor to Join NB-IoT 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.
73.2	112
	113
124.6	114	== 1.5 Button & LEDs ==
73.2	115
	116
6.1	117	[[image:Main.User Manual for LoRaWAN End Nodes.D20-LBD22-LBD23-LB_LoRaWAN_Temperature_Sensor_User_Manual.WebHome@1675071855856-879.png]]
1.1	118
	119
139.10	120	(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
139.9	121	\|=(% style="width: 167px;background-color:#4F81BD;color:white" %)Behavior on ACT\|=(% style="width: 117px;background-color:#4F81BD;color:white" %)Function\|=(% style="width:226px;background-color:#4F81BD;color:white" %)Action
1.1	122	\|(% style="width:167px" %)Pressing ACT between 1s < time < 3s\|(% style="width:117px" %)Send an uplink\|(% style="width:225px" %)(((
73.2	123	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	124	Meanwhile, BLE module will be active and user can connect via BLE to configure device.
	125	)))
	126	\|(% style="width:167px" %)Pressing ACT for more than 3s\|(% style="width:117px" %)Active Device\|(% style="width:225px" %)(((
73.2	127	(% 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	128	(% style="color:green" %)Green led(%%) will solidly turn on for 5 seconds after joined in network.
73.2	129	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	130	)))
6.1	131	\|(% 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	132
122.3	133	(% style="color:red" %)Note: When the device is executing a program, the buttons may become invalid. It is best to press the buttons after the device has completed the program execution.
	134
	135
124.6	136	== 1.6 BLE connection ==
1.1	137
	138
124.6	139	TS01-NB support BLE remote configure and firmware update.
1.1	140
	141
	142	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:
	143
	144	* Press button to send an uplink
	145	* Press button to active device.
	146	* Device Power on or reset.
	147
	148	If there is no activity connection on BLE in 60 seconds, sensor will shut down BLE module to enter low power mode.
	149
	150
139.8	151	== 1.7 Pin Definitions , Switch & SIM Direction ==
1.1	152
73.3	153
124.6	154	TS01-NB use the mother board which as below.
73.3	155
132.1	156	[[image:image-20231109114816-2.png]]
1.1	157
43.1	158
124.6	159	=== 1.7.1 Jumper JP2 ===
43.1	160
73.3	161
	162	Power on Device when put this jumper.
	163
	164
124.6	165	=== 1.7.2 BOOT MODE / SW1 ===
73.3	166
	167
82.31	168	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.
73.3	169
82.31	170	2) (% style="color:blue" %)Flash(%%): work mode, device starts to work and send out console output for further debug
73.3	171
	172
124.6	173	=== 1.7.3 Reset Button ===
73.3	174
80.2	175
73.3	176	Press to reboot the device.
	177
	178
139.8	179	=== 1.7.4 SIM Card Direction ===
	180
	181
	182	See this link. [[How to insert SIM Card>>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]].
	183
	184
124.6	185	== 1.8 Sketch of Pitch and Roll ==
1.1	186
124.6	187
129.2	188	[[image:image-20231025105743-1.png]]
124.6	189
129.2	190
129.4	191	== 1.9 Installation direction ==
124.6	192
129.2	193
129.3	194	(% style="color:blue" %)Horizontal installation:
124.6	195
129.2	196	[[image:image-20231025105808-2.png]]
124.6	197
129.3	198	(% style="color:blue" %)Vertical installation:
124.6	199
129.2	200	[[image:image-20231025105857-3.png]]
124.6	201
	202
	203	= 2. Use TS01-NB to communicate with IoT Server =
	204
80.2	205	== 2.1 Send data to IoT server via NB-IoT network ==
1.1	206
	207
124.6	208	The TS01-NB is equipped with a NB-IoT module, the pre-loaded firmware in TS01-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 TS01-NB.
1.1	209
	210
80.2	211	Below shows the network structure:
1.1	212
126.2	213	[[image:image-20231024184036-2.png\|\|height="340" width="909"]]
1.1	214
	215
124.6	216	There are two version: (% style="color:blue" %)-GE(%%) and (% style="color:blue" %)-1D(%%) version of TS01-NB.
1.1	217
	218
124.6	219	(% 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 TS01-NB send data to IoT server.
1.1	220
82.19	221	* 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	222
82.19	223	* 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	224
80.2	225	Below shows result of different server as a glance.
1.1	226
80.9	227	(% border="1" cellspacing="4" style="width:515px" %)
81.2	228	\|(% 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
82.24	229	\|(% 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" %)(((
	230	(% style="text-align:center" %)
	231	[[image:image-20230819113244-8.png\|\|height="183" width="367"]]
	232	)))\|(% style="width:170px" %)
	233	\|(% 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" %)(((
	234	(% style="text-align:center" %)
82.25	235	[[image:image-20230819113244-9.png\|\|height="119" width="367"]]
82.24	236	)))\|(% style="width:170px" %)
80.9	237	\|(% 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" %)
	238	\|(% 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" %)
	239	\|(% 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" %)
82.24	240	\|(% 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" %)(((
	241	(% style="text-align:center" %)
82.25	242	[[image:image-20230819113244-10.png\|\|height="104" width="367"]]
82.24	243	)))\|(% style="width:170px" %)
	244	\|(% 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" %)(((
	245	(% style="text-align:center" %)
82.25	246	[[image:image-20230819113244-11.png\|\|height="141" width="367"]]
82.24	247	)))\|(% style="width:170px" %)
80.2	248
124.6	249	(% 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 TS01-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	250
	251
130.3	252	== 2.2 Payload Types ==
80.2	253
	254
124.6	255	To meet different server requirement, TS01-NB supports different payload type.
1.1	256
81.2	257	Includes:
1.1	258
82.21	259	* [[General JSON format payload>>\|\|anchor="H2.2.1GeneralJsonFormat28Type3D529"]]. (Type=5)
80.7	260
82.21	261	* [[HEX format Payload>>\|\|anchor="H2.2.2HEXformatPayload28Type3D029"]]. (Type=0)
80.7	262
82.21	263	* [[ThingSpeak Format>>\|\|anchor="H2.2.4ThingSpeakPayload28Type3D129"]]. (Type=1)
80.7	264
82.21	265	* [[ThingsBoard Format>>\|\|anchor="H2.2.3ThingsBoardPayload28Type3D329"]]. (Type=3)
1.1	266
80.3	267	User can specify the payload type when choose the connection protocol. Example:
1.1	268
81.2	269	(% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Use UDP Connection & hex Payload
1.1	270
80.8	271	(% style="color:#037691" %)AT+PRO=2,5 (%%) ~/~/ Use UDP Connection & Json Payload
1.1	272
117.1	273	(% style="color:#037691" %)AT+PRO=3,0 (%%) ~/~/ Use MQTT Connection & hex Payload
	274
	275	(% style="color:#037691" %)AT+PRO=3,1 (%%)~/~/ Use MQTT Connection & ThingSpeak
	276
	277	(% style="color:#037691" %)AT+PRO=3,3 (%%)~/~/ Use MQTT Connection & ThingsBoard
	278
81.2	279	(% style="color:#037691" %)AT+PRO=3,5 (%%) ~/~/ Use MQTT Connection & Json Payload
1.1	280
117.1	281	(% style="color:#037691" %)AT+PRO=4,0 (%%) ~/~/ Use TCP Connection & hex Payload
1.1	282
117.1	283	(% style="color:#037691" %)AT+PRO=4,5 (%%) ~/~/ Use TCP Connection & Json Payload
	284
	285
82.20	286	=== 2.2.1 General Json Format(Type~=5) ===
1.1	287
80.8	288
80.3	289	This is the General Json Format. As below:
133.2	290	\\(% style="color:#4472c4" %){"IMEI":"866207052559857","Model":"TS01-NB","temperature":26.0,"roll":-26.94,"pitch":-0.48,"battery":3.53,"signal":25,"1":{26.1,-26.87,-0.46,2023/11/09 06:29:31},"2":{350.2,0.42,3.83,2023/11/07 09:33:59},"3":{352.2,19.19,3.88,2023/11/07 09:19:02},"4":{352.7,0.62,3.88,2023/11/07 09:04:00},"5":{0.0,0.59,3.88,2023/11/07 08:49:02},"6":{0.0,0.62,3.88,2023/11/07 08:34:02},"7":{363.1,0.62,3.89,2023/11/07 08:18:59},"8":{0.0,0.79,3.88,2023/11/07 08:04:02}}
1.1	291
	292
133.2	293	[[image:image-20231109144307-1.png\|\|height="813" width="1107"]]
	294
81.2	295	(% style="color:red" %)Notice, from above payload:
1.1	296
136.2	297	* Temperature, Roll, Pitch, Battery & Signal are the value at uplink time.
1.1	298
136.2	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, Roll, Pitch, 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
134.3	306	(% style="color:#4472c4" %)f86620705255985702640de716000000010c3ffa0007654c88f70105eed20514654c84790103ee970409654c80f50105ece5ffad654c7c4b0dae004c02ba654a04870dc20da602c3654a01060dc7007002c36549fd800000006c02c36549f9fe0000007002c36549f67a
1.1	307
130.2	308	[[image:image-20231109104707-1.png\|\|height="207" width="1267"]]
6.1	309
1.1	310
134.2	311	[[image:image-20231109153528-2.png\|\|height="816" width="1096"]]
	312
80.4	313	(% style="color:blue" %)Version:
1.1	314
80.3	315	These bytes include the hardware and software version.
1.1	316
124.6	317	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x02 for TS01-NB
1.1	318
136.2	319	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=101, means firmware version 1.0.0
1.1	320
	321
81.2	322	(% style="color:blue" %)BAT (Battery Info):
1.1	323
124.6	324	Sensor Battery Level.
117.1	325
124.6	326	Ex1: 0x0B45 = 2885mV
1.1	327
117.1	328	Ex2: 0x0B49 = 2889mV
1.1	329
117.1	330
124.6	331	(% style="color:blue" %)Temperature:
1.1	332
124.6	333	Example:
1.1	334
124.6	335	If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
1.1	336
124.6	337	If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
1.1	338
139.10	339	(FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
1.1	340
	341
124.6	342	(% style="color:blue" %)Roll:
1.1	343
124.6	344	Read:0x(0197)=412 Value: 412 / 100=4.12
1.1	345
	346
124.6	347	(% style="color:blue" %)Pitch:
93.1	348
124.6	349	Read:0x(0251)=412 Value: 593/ 100=5.93
93.1	350
	351
124.6	352	(% style="color:blue" %)Alarm Flag & Level of PA8:
93.1	353
124.6	354	Example:
93.1	355
124.6	356	If payload & 0x01 = 0x01 ~-~-> This is an Alarm Message.
93.1	357
124.6	358	If payload & 0x01 = 0x00 ~-~-> This is a normal uplink message, no alarm.
1.1	359
124.6	360	If payload & 0x80>>7 = 0x01 ~-~-> The PA8 is low level.
1.1	361
124.6	362	If payload & 0x80>>7 =0x00 ~-~-> The PA8 is high level.
1.1	363
	364
124.6	365	(% style="color:blue" %)Instal flag:
1.1	366
124.6	367	Read:0x(00)=0 (% style="color:#037691" %) (%%) ~/~/ horizontal direction
80.8	368
124.6	369	Read:0x(01)=1 (% style="color:#037691" %) (%%) ~/~/ Vertical direction
1.1	370
46.1	371
124.6	372	(% style="color:blue" %)TimeStamp:
1.1	373
124.6	374	Unit TimeStamp Example: 64e2d74f(H) = 1692587855(D)
1.1	375
124.6	376	Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]])to get the time.
80.8	377
1.1	378
124.6	379	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
14.22	380
1.1	381
124.6	382	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	383
136.2	384	(% style="color:blue" %){"IMEI":"866207052559857","Model":"TS01-NB","temperature":26.2,"roll":88.63,"pitch":-0.18,"battery":3.55,"signal":26}
10.1	385
136.2	386	[[image:image-20231109160445-3.png\|\|height="577" width="1095"]]
1.1	387
	388
124.6	389	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
84.18	390
	391
136.2	392	This payload meets ThingSpeak platform requirement. It includes only five fields. Form 1~~5 are:
84.18	393
136.2	394	Temperature, Roll, Pitch, Battery & Signal. This payload type only valid for ThingsSpeak Platform
84.18	395
124.6	396	As below:
84.18	397
136.2	398	(% style="color:blue" %)field1=Temperature value&field2=Roll value&field3=Pitch value&field4=Battery value&field5=Signal value
84.18	399
136.2	400	[[image:image-20231109163026-4.png\|\|height="970" width="976"]]
84.18	401
129.6	402
136.3	403	== 2.3 Angle Alarm Feature ==
84.18	404
	405
124.7	406	TS01-NB work flow with Alarm feature.
124.6	407
124.7	408	TS01-NB has two alarm modes.
124.6	409
	410
	411	(% style="color:blue" %)Alarm Mode 1:
	412
	413	(% style="color:#037691" %)AT+AMOD=1
	414
	415	(% style="color:#037691" %)AT+XALARM=Xvalue, AT+YALARM=Yvalue
	416
	417	When an angle change is detected that exceeds the range compared to the last time, an alarm is reported.
	418
	419	For example:
	420
	421	AT+XALARM=10
	422
	423	AT+YALARM=20
	424
	425	The last angle measured on the X-axis was 120 degrees, and this time the angle measured on the X-axis is 135 degrees, an alarm will be triggered to upload a data packet.
	426
	427	The last time the angle measured on the Y-axis was 100 degrees, but this time the angle measured on the Y-axis is 50 degrees, which will trigger an alarm and upload the data packet.
	428
	429	If the alarm conditions are met on the X-axis or Y-axis, an alarm will be triggered.
	430
	431
	432	(% style="color:blue" %)Alarm Mode 2:
	433
	434	(% style="color:#037691" %)AT+AMOD=2
	435
	436	(% style="color:#037691" %)AT+XALARM=min,max
	437
	438	When min=0, and max≠0, Alarm higher than max
	439
	440	When min≠0, and max=0, Alarm lower than min
	441
	442	When min≠0 and max≠0, Alarm higher than max or lower than min
	443
	444	Example:
	445
	446	AT+ XALARM=50,80 ~/~/ Alarm when Roll lower than 50.
	447
	448
137.4	449	(% style="color:#037691" %)AT+YALARM=min,max
124.6	450
137.4	451	When min=0, and max≠0, Alarm higher than max
124.6	452
137.4	453	When min≠0, and max=0, Alarm lower than min
124.6	454
137.4	455	When min≠0 and max≠0, Alarm higher than max or lower than min
124.6	456
137.4	457	Example:
124.6	458
	459	AT+ YALARM=20,30 ~/~/ Alarm when Pitch lower than 20.
	460
	461
129.8	462	Alarm Mode 0:
124.6	463
	464	AT+AMOD=0 ~/~/ Turn off alarm function
	465
	466
	467	(% style="color:blue" %)Alarm time setting:
	468
137.4	469	(% style="color:#037691" %)AT+TR=180 (%%) ~/~/ It means triggering an alarm every 3 minutes.
124.6	470
	471
136.3	472	== 2.4 Calibration and installation direction ==
124.6	473
	474
	475	(% style="color:blue" %)AT+CAL : Calibration angle
	476
	477	(% style="color:red" %)NOTE: If the installation direction is horizontal, the user needs to place the device horizontally for calibration. If the installation direction is vertical, the user needs to place the device vertically for calibration. If the direction is incorrect, it may result in opposite angles or inaccurate degrees.
	478
	479	When the calibration angle is 0 or close to 0, it is considered successful calibration.
	480
	481
	482	(% style="color:blue" %)Installation direction command:
	483
	484	(% style="color:#037691" %)AT+INSTAL=0 (%%) ~/~/ horizontal direction
	485
	486	(% style="color:#037691" %)AT+INSTAL=1 (%%) ~/~/ Vertical direction
	487
	488
136.3	489	== 2.5 Test Uplink and Change Update Interval ==
124.6	490
	491
80.4	492	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%) & AT+NOUD=8
1.1	493
80.4	494	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	495
82.2	496	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	497
80.3	498	User can also push the button for more than 1 seconds to activate an uplink.
1.1	499
	500
136.3	501	== 2.6 Multi-Samplings and One uplink ==
39.5	502
145.2	503	(% style="color:red" %)Notice: The AT+NOUD feature is upgraded to Clock Logging, please refer [[Clock Logging Feature>>\|\|anchor="H2.13Clocklogging28Sincefirmwareversionv1.2.129"]]
145.1	504
124.6	505	To save battery life, TS01-NB will sample Idc_input & Vdc_input 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	506
82.6	507	* (% 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	508
82.12	509	* (% 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	510
80.3	511	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	512
82.2	513	[[image:1692424376354-959.png]]
1.1	514
	515
136.3	516	== 2.7 Trggier an uplink by external interrupt ==
1.1	517
80.5	518
124.6	519	TS01-NB has an external trigger interrupt function. Users can use the GPIO_EXTI pin to trigger the upload of data packets.
55.1	520
80.5	521	(% style="color:blue" %)AT command:
46.1	522
82.6	523	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	524
117.1	525	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt,as a digital input pin
1.1	526
82.6	527	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	528
82.6	529	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	530
82.6	531	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	532
136.3	533	== 2.8 Set Alarm Interval ==
118.1	534
	535
124.6	536	The shortest time of two Alarm packet. (unit: min)
118.1	537
124.6	538	(% style="color:blue" %)AT Command:
118.1	539
124.6	540	* (% style="color:#037691" %)AT+ATDC=30
118.1	541
124.6	542	(% style="color:blue" %)Downlink Payload:
118.1	543
124.6	544	* (% style="color:#037691" %)0x(0D 00 1E)(%%) ~/~/ Set AT+ATDC=0x 00 1E = 30 minutes
118.1	545
136.3	546	== 2.9 Set Calibration ==
118.1	547
	548
124.6	549	(% style="color:blue" %)AT Command:
118.1	550
124.6	551	* (% style="color:#037691" %)AT+CAL
118.1	552
124.6	553	(% style="color:blue" %)Downlink Payload:
118.1	554
124.6	555	* (% style="color:#037691" %)0x(F2 00)
118.1	556
136.3	557	== 2.10 Set installation direction ==
118.1	558
	559
124.6	560	The shortest time of two Alarm packet. (unit: min)
118.1	561
124.6	562	(% style="color:blue" %)AT Command:
1.1	563
124.6	564	* (% style="color:#037691" %)AT+INSTAL=0
	565
	566	(% style="color:blue" %)Downlink Payload:
	567
	568	* (% style="color:#037691" %)0x(F0 00)(%%) ~/~/ Set AT+INSTAL=0
	569
136.3	570	== 2.11 Set angle alarm ==
124.6	571
	572
	573	(% style="color:blue" %)AT Command:
	574
	575	* (% style="color:#037691" %)AT+XALARM=value
	576
	577	* (% style="color:#037691" %)AT+XALARM=min,max
	578
	579	(% style="color:blue" %)Downlink Payload:
	580
	581	* (% style="color:#037691" %)0x(F3 00 1E) (%%) ~/~/ Set AT+XALARM=30
	582
	583	* (% style="color:#037691" %)0x(F3 00 1E 00 50) (%%) ~/~/ Set AT+XALARM=30,80
	584
	585	* (% style="color:#037691" %)0x(F4 00 1E) (%%) ~/~/ Set AT+YALARM=30
	586
	587	* (% style="color:#037691" %)0x(F4 00 1E 00 50) (%%) ~/~/ Set AT+YALARM=30,80
	588
148.1	589	== (% data-sider-select-id="1abef3ab-5327-49cb-bd69-c1648a23341a" %)2.12 Set alarm mode(%%) ==
124.6	590
	591
	592	(% style="color:blue" %)AT Command:
	593
	594	* (% style="color:#037691" %)AT+AMOD=1
	595
	596	(% style="color:blue" %)Downlink Payload:
	597
	598	* (% style="color:#037691" %)0x(F5 01) (%%) ~/~/ Set AT+AMOD=1
	599
143.1	600	== 2.13 Clock logging (Since firmware version v1.2.1) ==
	601
	602	Sometimes when we deploy lots of end nodes in field. We want all sensors sample data at the same time, and upload these data together for analyze. In such case, we can use clock loging feature.
	603
	604	We can use this command to set the start time of data recording and the time interval to meet the requirements of the specific collection time of data.
	605
	606	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)
	607
	608	(% style="color:#037691" %)a: (%%)0: Disable Clock logging. 1: Enable Clock Logging
	609
143.2	610	(% style="color:#037691" %)b: (%%)Specify First sampling start second: range (0 ~~ 3599, 65535) ~/~/ (% style="color:red" %)Note:(%%) If parameter b is set to 65535, the log period starts after the node accesses the network and sends packets.
143.1	611
	612	(% style="color:#037691" %)c: (%%)Specify the sampling interval: range (0 ~~ 255 minutes)
	613
	614	(% style="color:#037691" %)d:(%%)How many entries should be uplink on every TDC (max 32)
	615
	616	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SPH01-NB_NB-IoT_Soil_pH_Sensor_User_Manual/WebHome/image-20240315141254-1.png?rev=1.1\|\|alt="image-20240315141254-1.png"]]
	617
	618	Example:
	619
	620	AT+CLOCKLOG=1,65535,1,5
	621
	622	After the node sends the first packet, data is recorded to the memory at intervals of 1 minute. For each TDC uplink, the uplink load will include: battery information + the last 5 memory records (payload + timestamp).
	623
	624	(% class="wikigeneratedid" %)
	625	[[image:image-20240316163501-1.png\|\|height="517" width="1064"]]
	626
	627	(% class="wikigeneratedid" %)
	628	(% style="color:red" %)Note: Users need to synchronize the server time before configuring this command. If the server time is not synchronized before this command is configured, the command takes effect only after the node is reset.
	629
	630
143.2	631	== 2.14 Example Query saved historical records ==
143.1	632
	633
	634	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+CDP(%%)
	635
	636	This command can be used to search the saved history, recording up to 32 groups of data, each group of historical data contains a maximum of 100 bytes.
	637
	638	(% class="wikigeneratedid" %)
	639	[[image:image-20240316163550-2.png\|\|height="638" width="829"]]
	640
	641
144.2	642	== 2.15 Uplink log query ==
	643
149.2	644
144.2	645	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+GETLOG(%%)
	646
	647	This command can be used to query upstream logs of data packets.
	648
	649	[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/PS-NB-NA_NB-IoT_Analog_Sensor_User_Manual/WebHome/image-20240407191922-2.png?width=903&height=631&rev=1.1\|\|alt="image-20240407191922-2.png"]]
	650
	651
149.1	652	== (% data-sider-select-id="2d2445b0-da61-405a-badd-484eb546c390" %)2.16 (%%)Scheduled domain name resolution ==
144.2	653
149.2	654
148.1	655	(% data-sider-select-id="27359b94-e7f5-4ea4-bd74-8e323eb3fc2b" %)
147.1	656	This command can be used to resolve domain names regularly.
	657
148.1	658	(% data-sider-select-id="27359b94-e7f5-4ea4-bd74-8e323eb3fc2b" %)
	659	(% data-sider-select-id="50daeb1a-df96-4ffd-8d25-c39f71f1c6bc" style="color:blue" %)AT Command:
147.1	660
149.2	661	* (% data-sider-select-id="810d804c-01b0-4651-acfc-dbed2f0ed9e1" style="color:#037691" %)AT+DNSTIMER=XX(%%) ~/~/ Unit: hour
148.1	662
149.1	663	After setting this command, domain name resolution will be performed regularly.
148.1	664
149.2	665
124.6	666	= 3. Configure TS01-NB =
	667
16.4	668	== 3.1 Configure Methods ==
1.1	669
	670
124.6	671	TS01-NB supports below configure method:
1.1	672
	673	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	674
11.1	675	* 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	676
82.8	677	== 3.2 AT Commands Set ==
1.1	678
	679
82.8	680	AT+<CMD>? : Help on <CMD>
1.1	681
82.8	682	AT+<CMD> : Run <CMD>
1.1	683
82.8	684	AT+<CMD>=<value> : Set the value
1.1	685
82.8	686	AT+<CMD>=? : Get the value
1.1	687
	688
82.10	689	(% style="color:blue" %)General Commands
1.1	690
82.8	691	AT : Attention
1.1	692
82.9	693	AT? : Short Help
1.1	694
82.9	695	ATZ : MCU Reset
1.1	696
82.9	697	AT+TDC : Application Data Transmission Interval
1.1	698
82.9	699	AT+CFG : Print all configurations
1.1	700
118.1	701	AT+MODEL :Get module information
1.1	702
118.1	703	AT+SLEEP :Get or set the sleep status
	704
82.9	705	AT+DEUI : Get or set the Device ID
1.1	706
82.8	707	AT+INTMOD : Set the trigger interrupt mode
1.1	708
137.1	709	AT+APN : Get or set the APN
118.1	710
137.2	711	AT+5VT : Set extend the time of 5V power
118.1	712
137.1	713	AT+PRO : Get or Set usage agreement (1:COAP,2:UDP,3:MQTT,4:TCP)
1.1	714
82.9	715	AT+RXDL : Extend the sending and receiving time
1.1	716
137.1	717	AT+TR : Get or set SHT record time
1.1	718
118.1	719	AT+CDP : Read or Clear cached data
1.1	720
82.9	721	AT+NOUD : Get or Set the number of data to be uploaded
1.1	722
118.1	723	AT+DNSCFG : Get or Set DNS Server
1.1	724
118.1	725	AT+CSQTIME : Get or Set the time to join the network
1.1	726
118.1	727	AT+DNSTIMER : Get or Set the NDS timer
1.1	728
118.1	729	AT+TLSMOD : Get or Set the TLS mode
	730
	731	AT+GETSENSORVALUE : Returns the current sensor measurement
	732
82.9	733	AT+SERVADDR : Server Address
1.1	734
82.9	735
82.10	736	(% style="color:blue" %)MQTT Management
1.1	737
82.8	738	AT+CLIENT : Get or Set MQTT client
1.1	739
82.8	740	AT+UNAME : Get or Set MQTT Username
1.1	741
82.8	742	AT+PWD : Get or Set MQTT password
1.1	743
82.9	744	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	745
82.9	746	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	747
	748
82.10	749	(% style="color:blue" %)Information
1.1	750
82.9	751	AT+FDR : Factory Data Reset
1.1	752
82.9	753	AT+PWORD : Serial Access Password
1.1	754
82.9	755	AT+LDATA : Get the last upload data
39.6	756
82.9	757	AT+CDP : Read or Clear cached data
1.1	758
82.9	759
16.4	760	= 4. Battery & Power Consumption =
14.45	761
1.1	762
124.6	763	TS01-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	764
	765	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	766
	767
82.11	768	= 5. Firmware update =
1.1	769
	770
82.11	771	User can change device firmware to::
1.1	772
13.1	773	* Update with new features.
82.11	774
13.1	775	* Fix bugs.
1.1	776
129.10	777	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/3483wf9ou9ixvy4/AACbuqPFOx0ebOwYKIEJFhZua?dl=0]]
1.1	778
31.1	779	Methods to Update Firmware:
1.1	780
82.12	781	* (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	782
140.1	783	* Update through UART TTL interface : [[Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/UART_Access_for_NB_ST_BC660K-GL/#H4.2UpdateFirmware28Assumethedevicealreadyhaveabootloader29]].
1.1	784
31.1	785	= 6. FAQ =
1.1	786
82.15	787	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	788
	789
82.15	790	User can access to BC660K-GL directly and send AT Commands.
1.1	791
82.15	792	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	793
	794
150.1	795	== 6.2 How to configure the certificate? ==
	796
	797
	798	User can can refer to this [[description>>url:http://wiki.dragino.com/xwiki/bin/view/How%20to%20configure%20the%20certificate%3F/]] to configure the certificate.
	799
	800
	801
82.15	802	= 7. Order Info =
1.1	803
	804
124.6	805	Part Number: (% style="color:blue" %)TS01-NB-XX
1.1	806
84.10	807	(% style="color:red" %)XX:
1.1	808
82.15	809	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	810
82.15	811	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	812
31.1	813	= 8. Packing Info =
1.1	814
39.6	815
39.1	816	(% style="color:#037691" %)Package Includes:
1.1	817
124.6	818	* TS01-NB NB-IoT Tilting Sensor x 1
1.1	819
82.16	820	* External antenna x 1
	821
39.1	822	(% style="color:#037691" %)Dimension and weight:
1.1	823
84.17	824	* Device Size: cm
1.1	825
84.17	826	* Device Weight: g
1.1	827
84.17	828	* Package Size / pcs : cm
1.1	829
84.17	830	* Weight / pcs : g
1.1	831
31.1	832	= 9. Support =
1.1	833
	834
31.1	835	* 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	836
	837	* 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	838
80.9	839	(% style="display:none" %) (%%)

Wiki source code of TS01-NB -- NB-IoT Tilting Sensor User Manual

Applications

Navigation