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

Last modified by Mengting Qiu on 2024/05/31 16:49

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:
1.1	290
156.1	291	(% style="color:#4472c4" %){"IMEI":"863663062798914","Model":"TS01-NB","temperature":25.7,"roll":-0.75,"pitch":-0.76,"interrupt":0,"interrupt_level":0,"battery":3.34,"signal":18,"1":[25.6,-0.76,-0.76,"2024/05/29 06:36:23"],"2":[25.7,-0.77,-0.74,"2024/05/29 06:35:23"],"3":[25.7,-0.76,-0.75,"2024/05/29 06:34:23"],"4":[25.8,-0.76,-0.76,"2024/05/29 06:33:23"],"5":[25.8,-0.75,-0.75,"2024/05/29 06:32:23"],"6":[25.9,-0.73,-0.71,"2024/05/29 06:31:23"],"7":[26.0,-0.77,-0.72,"2024/05/29 06:30:23"],"8":[26.0,-0.76,-0.72,"2024/05/29 06:29:23"]}
1.1	292
133.2	293
156.1	294	[[image:image-20240531163705-1.png\|\|height="741" width="964"]]
	295
81.2	296	(% style="color:red" %)Notice, from above payload:
1.1	297
156.1	298	* Temperature, Roll, Pitch, Interrupt, Interrupt_level, Battery & Signal are the value at uplink time.
1.1	299
156.1	300	* Json entry 1 ~~ 8 are the last 1 ~~ 8 sampling data as specify by (% style="color:#037691" %)AT+CLOCKLOG=1,65535,15,8 (%%)Command. Each entry includes (from left to right): Temperature, Roll, Pitch, Sampling time.
1.1	301
81.2	302	=== 2.2.2 HEX format Payload(Type~=0) ===
1.1	303
	304
80.3	305	This is the HEX Format. As below:
1.1	306
156.1	307	(% style="color:#4472c4" %)f863663062798914027b0cfc0f00000000000101ff78ff766656cdac0101ff77ff736656cd5f0100ff77ff766656cd530100ff76ff766656cce70101ff73ff7a6656ccab0101ff76ff776656cc6f0102ff76ff766656cc330102ff78ff786656cbf70103ff7cff7f6656cbbb
1.1	308
156.1	309	[[image:image-20240531163843-2.png]]
6.1	310
1.1	311
156.1	312	[[image:image-20240531163901-3.png]]
134.2	313
80.4	314	(% style="color:blue" %)Version:
1.1	315
80.3	316	These bytes include the hardware and software version.
1.1	317
124.6	318	(% style="color:#037691" %)Higher byte:(%%) Specify Sensor Model: 0x02 for TS01-NB
1.1	319
136.2	320	(% style="color:#037691" %)Lower byte:(%%) Specify the software version: 0x64=101, means firmware version 1.0.0
1.1	321
	322
81.2	323	(% style="color:blue" %)BAT (Battery Info):
1.1	324
124.6	325	Sensor Battery Level.
117.1	326
124.6	327	Ex1: 0x0B45 = 2885mV
1.1	328
117.1	329	Ex2: 0x0B49 = 2889mV
1.1	330
117.1	331
156.1	332	(% style="color:blue" %)Direction:
1.1	333
156.1	334	Read:0x(00)=0 (% style="color:#037691" %) (%%) ~/~/ horizontal direction
1.1	335
156.1	336	Read:0x(01)=1 (% style="color:#037691" %) (%%) ~/~/ Vertical direction
1.1	337
	338
156.1	339	(% style="color:blue" %)Level of PA4:
1.1	340
156.1	341	payload: 0x00 ~-~-> The PA8 is low level.
1.1	342
156.1	343	payload: 0x01 ~-~-> The PA8 is high level.
1.1	344
	345
156.1	346	(% style="color:blue" %)Interrupt:
1.1	347
156.1	348	This data field shows if this packet is generated by interrupt or not.
93.1	349
156.1	350	Example:
93.1	351
156.1	352	If byte[0]&0x01=0x00 : Normal uplink packet.
93.1	353
156.1	354	If byte[0]&0x01=0x01 : Interrupt Uplink Packet.
93.1	355
	356
156.1	357	(% style="color:blue" %)Interrupt_level:
93.1	358
156.1	359	This byte shows whether the interrupt is triggered by a high or low level.
1.1	360
156.1	361	Ex1: 0x00 Interrupt triggered by falling edge (low level)
1.1	362
156.1	363	Ex2: 0x01 Interrupt triggered by rising edge (high level)
1.1	364
	365
156.1	366	(% style="color:blue" %)DS18B20 Temperature:
1.1	367
156.1	368	Example:
80.8	369
156.1	370	If payload is: 0105H: (0105 & 8000 == 0), temp = 0105H /10 = 26.1 degree
1.1	371
156.1	372	If payload is: FF3FH : (FF3F & 8000 == 1) , temp = (FF3FH - 65536)/10 = -19.3 degrees.
46.1	373
156.1	374	(FF3F & 8000：Judge whether the highest bit is 1, when the highest bit is 1, it is negative)
	375
	376
	377	(% style="color:blue" %)Roll:
	378
	379	Read:0x(0197)=412 Value: 412 / 100=4.12
	380
	381
	382	(% style="color:blue" %)Pitch:
	383
	384	Read:0x(0251)=412 Value: 593/ 100=5.93
	385
	386
124.6	387	(% style="color:blue" %)TimeStamp:
1.1	388
124.6	389	Unit TimeStamp Example: 64e2d74f(H) = 1692587855(D)
1.1	390
124.6	391	Put the decimal value into this link([[https:~~/~~/www.epochconverter.com)>>https://www.epochconverter.com]])to get the time.
80.8	392
1.1	393
124.6	394	=== 2.2.3 ThingsBoard Payload(Type~=3) ===
14.22	395
1.1	396
124.6	397	Type3 payload special design for ThingsBoard, it will also configure other default server to ThingsBoard.
1.1	398
156.1	399	(% style="color:blue" %)**{
	400	"topic": "2276492",
	401	"payload": {
	402	"IMEI": "863663062798914",
	403	"Model": "TS01-NB",
	404	"temperature": 25.4,
	405	"roll": 106.85,
	406	"pitch": 3.39,
	407	"interrupt": 0,
	408	"interrupt_level": 0,
	409	"battery": 3.34,
	410	"signal": 16,
	411	"1": [25.4, 106.8, 3.41, "2024/05/29 06:57:59"],
	412	"2": [25.4, 106.83, 3.41, "2024/05/29 06:57:47"],
	413	"3": [25.5, -0.75, -0.82, "2024/05/29 06:56:26"],
	414	"4": [25.5, -0.75, -0.81, "2024/05/29 06:54:59"],
	415	"5": [25.5, -0.73, -0.82, "2024/05/29 06:53:59"],
	416	"6": [25.5, -0.77, -0.81, "2024/05/29 06:51:45"],
	417	"7": [25.6, -0.76, -0.81, "2024/05/29 06:50:44"],
	418	"8": [25.6, -0.75, -0.81, "2024/05/29 06:49:44"]
	419	}
	420	}**
10.1	421
1.1	422
156.1	423	[[image:image-20240531164548-4.png]]
1.1	424
124.6	425	=== 2.2.4 ThingSpeak Payload(Type~=1) ===
84.18	426
	427
136.2	428	This payload meets ThingSpeak platform requirement. It includes only five fields. Form 1~~5 are:
84.18	429
136.2	430	Temperature, Roll, Pitch, Battery & Signal. This payload type only valid for ThingsSpeak Platform
84.18	431
124.6	432	As below:
84.18	433
136.2	434	(% style="color:blue" %)field1=Temperature value&field2=Roll value&field3=Pitch value&field4=Battery value&field5=Signal value
84.18	435
136.2	436	[[image:image-20231109163026-4.png\|\|height="970" width="976"]]
84.18	437
129.6	438
136.3	439	== 2.3 Angle Alarm Feature ==
84.18	440
	441
124.7	442	TS01-NB work flow with Alarm feature.
124.6	443
124.7	444	TS01-NB has two alarm modes.
124.6	445
	446
	447	(% style="color:blue" %)Alarm Mode 1:
	448
	449	(% style="color:#037691" %)AT+AMOD=1
	450
	451	(% style="color:#037691" %)AT+XALARM=Xvalue, AT+YALARM=Yvalue
	452
	453	When an angle change is detected that exceeds the range compared to the last time, an alarm is reported.
	454
	455	For example:
	456
	457	AT+XALARM=10
	458
	459	AT+YALARM=20
	460
	461	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.
	462
	463	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.
	464
	465	If the alarm conditions are met on the X-axis or Y-axis, an alarm will be triggered.
	466
	467
	468	(% style="color:blue" %)Alarm Mode 2:
	469
	470	(% style="color:#037691" %)AT+AMOD=2
	471
	472	(% style="color:#037691" %)AT+XALARM=min,max
	473
	474	When min=0, and max≠0, Alarm higher than max
	475
	476	When min≠0, and max=0, Alarm lower than min
	477
	478	When min≠0 and max≠0, Alarm higher than max or lower than min
	479
	480	Example:
	481
	482	AT+ XALARM=50,80 ~/~/ Alarm when Roll lower than 50.
	483
	484
137.4	485	(% style="color:#037691" %)AT+YALARM=min,max
124.6	486
137.4	487	When min=0, and max≠0, Alarm higher than max
124.6	488
137.4	489	When min≠0, and max=0, Alarm lower than min
124.6	490
137.4	491	When min≠0 and max≠0, Alarm higher than max or lower than min
124.6	492
137.4	493	Example:
124.6	494
	495	AT+ YALARM=20,30 ~/~/ Alarm when Pitch lower than 20.
	496
	497
129.8	498	Alarm Mode 0:
124.6	499
	500	AT+AMOD=0 ~/~/ Turn off alarm function
	501
	502
	503	(% style="color:blue" %)Alarm time setting:
	504
137.4	505	(% style="color:#037691" %)AT+TR=180 (%%) ~/~/ It means triggering an alarm every 3 minutes.
124.6	506
	507
136.3	508	== 2.4 Calibration and installation direction ==
124.6	509
	510
	511	(% style="color:blue" %)AT+CAL : Calibration angle
	512
	513	(% 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.
	514
	515	When the calibration angle is 0 or close to 0, it is considered successful calibration.
	516
	517
	518	(% style="color:blue" %)Installation direction command:
	519
	520	(% style="color:#037691" %)AT+INSTAL=0 (%%) ~/~/ horizontal direction
	521
	522	(% style="color:#037691" %)AT+INSTAL=1 (%%) ~/~/ Vertical direction
	523
	524
136.3	525	== 2.5 Test Uplink and Change Update Interval ==
124.6	526
	527
156.1	528	By default, Sensor will send uplinks (% style="color:blue" %)every 2 hours(%%)
1.1	529
80.4	530	User can use below commands to change the (% style="color:blue" %)uplink interval.
1.1	531
82.2	532	(% style="color:#037691" %)AT+TDC=600 (%%) ~/~/ Set Update Interval to 600s
1.1	533
80.3	534	User can also push the button for more than 1 seconds to activate an uplink.
1.1	535
	536
136.3	537	== 2.6 Multi-Samplings and One uplink ==
39.5	538
145.2	539	(% 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	540
124.6	541	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	542
82.6	543	* (% 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	544
82.12	545	* (% 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	546
80.3	547	The diagram below explains the relationship between TR, NOUD, and TDC more clearly:
1.1	548
82.2	549	[[image:1692424376354-959.png]]
1.1	550
	551
136.3	552	== 2.7 Trggier an uplink by external interrupt ==
1.1	553
80.5	554
124.6	555	TS01-NB has an external trigger interrupt function. Users can use the GPIO_EXTI pin to trigger the upload of data packets.
55.1	556
80.5	557	(% style="color:blue" %)AT command:
46.1	558
82.6	559	* (% style="color:#037691" %)AT+INTMOD (%%) ~/~/ Set the trigger interrupt mode
46.1	560
117.1	561	* (% style="color:#037691" %)AT+INTMOD=0 (%%) ~/~/ Disable Interrupt,as a digital input pin
1.1	562
82.6	563	* (% style="color:#037691" %)AT+INTMOD=1 (%%) ~/~/ Trigger by rising and falling edge
80.5	564
82.6	565	* (% style="color:#037691" %)AT+INTMOD=2 (%%) ~/~/ Trigger by falling edge
80.5	566
82.6	567	* (% style="color:#037691" %)AT+INTMOD=3 (%%) ~/~/ Trigger by rising edge
80.5	568
136.3	569	== 2.8 Set Alarm Interval ==
118.1	570
	571
124.6	572	The shortest time of two Alarm packet. (unit: min)
118.1	573
124.6	574	(% style="color:blue" %)AT Command:
118.1	575
124.6	576	* (% style="color:#037691" %)AT+ATDC=30
118.1	577
124.6	578	(% style="color:blue" %)Downlink Payload:
118.1	579
124.6	580	* (% style="color:#037691" %)0x(0D 00 1E)(%%) ~/~/ Set AT+ATDC=0x 00 1E = 30 minutes
118.1	581
136.3	582	== 2.9 Set Calibration ==
118.1	583
	584
124.6	585	(% style="color:blue" %)AT Command:
118.1	586
124.6	587	* (% style="color:#037691" %)AT+CAL
118.1	588
124.6	589	(% style="color:blue" %)Downlink Payload:
118.1	590
124.6	591	* (% style="color:#037691" %)0x(F2 00)
118.1	592
136.3	593	== 2.10 Set installation direction ==
118.1	594
	595
124.6	596	The shortest time of two Alarm packet. (unit: min)
118.1	597
124.6	598	(% style="color:blue" %)AT Command:
1.1	599
124.6	600	* (% style="color:#037691" %)AT+INSTAL=0
	601
	602	(% style="color:blue" %)Downlink Payload:
	603
	604	* (% style="color:#037691" %)0x(F0 00)(%%) ~/~/ Set AT+INSTAL=0
	605
136.3	606	== 2.11 Set angle alarm ==
124.6	607
	608
	609	(% style="color:blue" %)AT Command:
	610
	611	* (% style="color:#037691" %)AT+XALARM=value
	612
	613	* (% style="color:#037691" %)AT+XALARM=min,max
	614
	615	(% style="color:blue" %)Downlink Payload:
	616
	617	* (% style="color:#037691" %)0x(F3 00 1E) (%%) ~/~/ Set AT+XALARM=30
	618
	619	* (% style="color:#037691" %)0x(F3 00 1E 00 50) (%%) ~/~/ Set AT+XALARM=30,80
	620
	621	* (% style="color:#037691" %)0x(F4 00 1E) (%%) ~/~/ Set AT+YALARM=30
	622
	623	* (% style="color:#037691" %)0x(F4 00 1E 00 50) (%%) ~/~/ Set AT+YALARM=30,80
	624
148.1	625	== (% data-sider-select-id="1abef3ab-5327-49cb-bd69-c1648a23341a" %)2.12 Set alarm mode(%%) ==
124.6	626
	627
	628	(% style="color:blue" %)AT Command:
	629
	630	* (% style="color:#037691" %)AT+AMOD=1
	631
	632	(% style="color:blue" %)Downlink Payload:
	633
	634	* (% style="color:#037691" %)0x(F5 01) (%%) ~/~/ Set AT+AMOD=1
	635
143.1	636	== 2.13 Clock logging (Since firmware version v1.2.1) ==
	637
	638	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.
	639
	640	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.
	641
	642	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+CLOCKLOG=a,b,c,d(%%)
	643
	644	(% style="color:#037691" %)a: (%%)0: Disable Clock logging. 1: Enable Clock Logging
	645
143.2	646	(% 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	647
	648	(% style="color:#037691" %)c: (%%)Specify the sampling interval: range (0 ~~ 255 minutes)
	649
	650	(% style="color:#037691" %)d:(%%)How many entries should be uplink on every TDC (max 32)
	651
	652	[[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"]]
	653
	654	Example:
	655
	656	AT+CLOCKLOG=1,65535,1,5
	657
	658	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).
	659
	660	(% class="wikigeneratedid" %)
	661	[[image:image-20240316163501-1.png\|\|height="517" width="1064"]]
	662
	663	(% class="wikigeneratedid" %)
	664	(% 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.
	665
	666
156.1	667	* (% style="color:blue" %)Downlink Command:(%%) (% style="color:#037691" %)0x0A(%%)
	668
	669	Format: Command Code (0x0A) followed by 5 bytes.
	670
	671	* Example 1: Downlink Payload: 0A01FFFF0F08 ~/~/ Set SHT record time: AT+CLOCKLOG=1,65535,15,8
	672	* Example 1: Downlink Payload: 0A0104B00F08 ~/~/ Set SHT record time: AT+CLOCKLOG=1,1200,15,8
	673
	674	(% style="color:red" %)Note: When entering the downlink payload, there must be no Spaces between bytes.
	675
	676
	677
	678
143.2	679	== 2.14 Example Query saved historical records ==
143.1	680
	681
	682	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+CDP(%%)
	683
	684	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.
	685
	686	(% class="wikigeneratedid" %)
	687	[[image:image-20240316163550-2.png\|\|height="638" width="829"]]
	688
	689
144.2	690	== 2.15 Uplink log query ==
	691
149.2	692
144.2	693	* (% style="color:blue" %)AT Command:(%%) (% style="color:#037691" %)AT+GETLOG(%%)
	694
	695	This command can be used to query upstream logs of data packets.
	696
	697	[[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"]]
	698
	699
149.1	700	== (% data-sider-select-id="2d2445b0-da61-405a-badd-484eb546c390" %)2.16 (%%)Scheduled domain name resolution ==
144.2	701
149.2	702
148.1	703	(% data-sider-select-id="27359b94-e7f5-4ea4-bd74-8e323eb3fc2b" %)
147.1	704	This command can be used to resolve domain names regularly.
	705
148.1	706	(% data-sider-select-id="27359b94-e7f5-4ea4-bd74-8e323eb3fc2b" %)
	707	(% data-sider-select-id="50daeb1a-df96-4ffd-8d25-c39f71f1c6bc" style="color:blue" %)AT Command:
147.1	708
149.2	709	* (% data-sider-select-id="810d804c-01b0-4651-acfc-dbed2f0ed9e1" style="color:#037691" %)AT+DNSTIMER=XX(%%) ~/~/ Unit: hour
148.1	710
149.1	711	After setting this command, domain name resolution will be performed regularly.
148.1	712
149.2	713
156.1	714
	715	== 2.17 Set the QoS level ==
	716
	717	This command is used to set the QoS level of MQTT.
	718
	719	(% data-sider-select-id="50daeb1a-df96-4ffd-8d25-c39f71f1c6bc" style="color:blue" %)AT Command:
	720
	721	* (% data-sider-select-id="810d804c-01b0-4651-acfc-dbed2f0ed9e1" style="color:#037691" %)AT+MQOS=xx(%%) ~/~/ 0~~2
	722
	723	(% style="color:blue" %)Downlink Command:(%%) (% style="color:#037691" %)0x07(%%)
	724
	725	Format: Command Code (0x07) followed by 1 byte.
	726
	727	Ex1: Downlink payload: 0x0700 ~/~/AT+MQOS=0
	728
	729	Ex2: Downlink payload: 0x0701 ~/~/AT+MQOS=1
	730
	731
	732
124.6	733	= 3. Configure TS01-NB =
	734
16.4	735	== 3.1 Configure Methods ==
1.1	736
	737
124.6	738	TS01-NB supports below configure method:
1.1	739
	740	* AT Command via Bluetooth Connection (Recommended): [[BLE Configure Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/BLE%20Bluetooth%20Remote%20Configure/]].
80.6	741
11.1	742	* 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	743
82.8	744	== 3.2 AT Commands Set ==
1.1	745
	746
82.8	747	AT+<CMD>? : Help on <CMD>
1.1	748
82.8	749	AT+<CMD> : Run <CMD>
1.1	750
82.8	751	AT+<CMD>=<value> : Set the value
1.1	752
82.8	753	AT+<CMD>=? : Get the value
1.1	754
	755
82.10	756	(% style="color:blue" %)General Commands
1.1	757
82.8	758	AT : Attention
1.1	759
82.9	760	AT? : Short Help
1.1	761
82.9	762	ATZ : MCU Reset
1.1	763
82.9	764	AT+TDC : Application Data Transmission Interval
1.1	765
82.9	766	AT+CFG : Print all configurations
1.1	767
118.1	768	AT+MODEL :Get module information
1.1	769
118.1	770	AT+SLEEP :Get or set the sleep status
	771
82.9	772	AT+DEUI : Get or set the Device ID
1.1	773
82.8	774	AT+INTMOD : Set the trigger interrupt mode
1.1	775
137.1	776	AT+APN : Get or set the APN
118.1	777
137.2	778	AT+5VT : Set extend the time of 5V power
118.1	779
137.1	780	AT+PRO : Get or Set usage agreement (1:COAP,2:UDP,3:MQTT,4:TCP)
1.1	781
82.9	782	AT+RXDL : Extend the sending and receiving time
1.1	783
137.1	784	AT+TR : Get or set SHT record time
1.1	785
118.1	786	AT+CDP : Read or Clear cached data
1.1	787
82.9	788	AT+NOUD : Get or Set the number of data to be uploaded
1.1	789
118.1	790	AT+DNSCFG : Get or Set DNS Server
1.1	791
118.1	792	AT+CSQTIME : Get or Set the time to join the network
1.1	793
118.1	794	AT+DNSTIMER : Get or Set the NDS timer
1.1	795
118.1	796	AT+TLSMOD : Get or Set the TLS mode
	797
	798	AT+GETSENSORVALUE : Returns the current sensor measurement
	799
82.9	800	AT+SERVADDR : Server Address
1.1	801
82.9	802
82.10	803	(% style="color:blue" %)MQTT Management
1.1	804
82.8	805	AT+CLIENT : Get or Set MQTT client
1.1	806
82.8	807	AT+UNAME : Get or Set MQTT Username
1.1	808
82.8	809	AT+PWD : Get or Set MQTT password
1.1	810
82.9	811	AT+PUBTOPIC : Get or Set MQTT publish topic
1.1	812
82.9	813	AT+SUBTOPIC : Get or Set MQTT subscription topic
1.1	814
	815
82.10	816	(% style="color:blue" %)Information
1.1	817
82.9	818	AT+FDR : Factory Data Reset
1.1	819
82.9	820	AT+PWORD : Serial Access Password
1.1	821
82.9	822	AT+LDATA : Get the last upload data
39.6	823
82.9	824	AT+CDP : Read or Clear cached data
1.1	825
82.9	826
16.4	827	= 4. Battery & Power Consumption =
14.45	828
1.1	829
124.6	830	TS01-NB use ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
1.1	831
	832	[[Battery Info & Power Consumption Analyze>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
	833
	834
82.11	835	= 5. Firmware update =
1.1	836
	837
82.11	838	User can change device firmware to::
1.1	839
13.1	840	* Update with new features.
82.11	841
13.1	842	* Fix bugs.
1.1	843
129.10	844	Firmware and changelog can be downloaded from : [[Firmware download link>>https://www.dropbox.com/sh/3483wf9ou9ixvy4/AACbuqPFOx0ebOwYKIEJFhZua?dl=0]]
1.1	845
31.1	846	Methods to Update Firmware:
1.1	847
82.12	848	* (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	849
140.1	850	* 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	851
31.1	852	= 6. FAQ =
1.1	853
82.15	854	== 6.1 How can I access t BC660K-GL AT Commands? ==
1.1	855
	856
82.15	857	User can access to BC660K-GL directly and send AT Commands.
1.1	858
82.15	859	[[See BC660K-GL AT Command set>>url:https://www.dropbox.com/sh/5f6ssda5fum8rvs/AABT68l8ZzWOvZ5eg2qwOoFda?dl=0]]
1.1	860
	861
150.1	862
	863
82.15	864	= 7. Order Info =
1.1	865
	866
124.6	867	Part Number: (% style="color:blue" %)TS01-NB-XX
1.1	868
84.10	869	(% style="color:red" %)XX:
1.1	870
82.15	871	* (% style="color:#037691" %)GE(%%): General version ( Exclude SIM card)
1.1	872
82.15	873	* (% style="color:#037691" %)1D(%%): with 1NCE* 10 years 500MB SIM card and Pre-configure to DataCake server
1.1	874
31.1	875	= 8. Packing Info =
1.1	876
39.6	877
39.1	878	(% style="color:#037691" %)Package Includes:
1.1	879
124.6	880	* TS01-NB NB-IoT Tilting Sensor x 1
1.1	881
82.16	882	* External antenna x 1
	883
39.1	884	(% style="color:#037691" %)Dimension and weight:
1.1	885
84.17	886	* Device Size: cm
1.1	887
84.17	888	* Device Weight: g
1.1	889
84.17	890	* Package Size / pcs : cm
1.1	891
84.17	892	* Weight / pcs : g
1.1	893
31.1	894	= 9. Support =
1.1	895
	896
31.1	897	* 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	898
	899	* 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	900
80.9	901	(% style="display:none" %) (%%)

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

Applications

Navigation