Version 53.1 by David Huang on 2022/10/08 11:47
Show last authors
1 (% style="text-align:center" %)
2 [[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png||height="442" width="410"]]
3
4 **Table of Contents:**
5
6 {{toc/}}
7
8
9
10 = 1.  Introduction =
11
12
13 == 1.1 ​ What is NSPH01 Soil pH Sensor ==
14
15
16 The Dragino NSPH01 is a (% style="color:blue" %)**NB-IoT soil pH sensor**(%%) for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
17
18 NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:blue" %)pH (%%)**with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use.
19
20 NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
21 \\NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
22 \\NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
23 \\To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection.
24
25
26 [[image:image-20220907153151-1.png]]
27
28
29 [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
30
31
32
33 == 1.2  Features ==
34
35
36 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
37 * Monitor soil pH with temperature compensation.
38 * Monitor soil temperature
39 * pH and Temperature alarm function
40 * Monitor Battery Level
41 * Support pH calibration by end user
42 * Uplink on periodically
43 * Downlink to change configure
44 * IP66 Waterproof Enclosure
45 * IP68 rate for the Sensor Probe
46 * Ultra-Low Power consumption
47 * AT Commands to change parameters
48 * Micro SIM card slot
49 * 8500mAh Battery for long term use
50
51
52 == 1.3  Specification ==
53
54
55 (% style="color:#037691" %)**Common DC Characteristics:**
56
57 * Supply Voltage: 2.1v ~~ 3.6v
58 * Operating Temperature: -40 ~~ 85°C
59
60 (% style="color:#037691" %)**NB-IoT Spec:**
61
62 * - B1 @H-FDD: 2100MHz
63 * - B3 @H-FDD: 1800MHz
64 * - B8 @H-FDD: 900MHz
65 * - B5 @H-FDD: 850MHz
66 * - B20 @H-FDD: 800MHz
67 * - B28 @H-FDD: 700MHz
68
69
70 == 1.4  Probe Specification ==
71
72
73 (% style="color:#037691" %)**Soil pH:**
74
75 * Range: 3 ~~ 10 pH
76 * Resolution: 0.01 pH
77 * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
78 * Temperature Compensation Range: 0 ~~ 50℃
79 * IP68 Protection
80 * Length: 3.5 meters
81
82 (% style="color:#037691" %)**Soil Temperature:**
83
84 * Range -40℃～85℃
85 * Resolution: 0.1℃
86 * Accuracy: <±0.5℃(-10℃～40℃)，<±0.8℃ (others)
87 * IP68 Protection
88 * Length: 3.5 meters
89
90
91 == 1.5  ​Applications ==
92
93
94 * Smart Agriculture
95
96
97 == 1.6  Pin mapping and power on ==
98
99
100 [[image:image-20220907153300-2.png]]
101
102
103
104 = 2.  Use NSPH01 to communicate with IoT Server =
105
106
107 == 2.1  How it works ==
108
109
110 The NSPH01 is equipped with a NB-IoT module, the pre-loaded firmware in NSPH01 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 NSPH01.
111
112 The diagram below shows the working flow in default firmware of NSPH01:
113
114
115 [[image:image-20220907153416-3.png]]
116
117
118
119 == 2.2 ​ Configure the NSPH01 ==
120
121
122 === 2.2.1 Test Requirement ===
123
124
125 To use NSPH01 in the field, make sure meet below requirements:
126
127 * Your local operator has already distributed a NB-IoT Network there.
128 * The local NB-IoT network used the band that NSPH01 supports.
129 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
130
131
132 Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NSPH01 will use** CoAP(120.24.4.116:5683) **or raw **UDP(120.24.4.116:5601)** or **MQTT(120.24.4.116:1883)**or **TCP(120.24.4.116:5600)**protocol to send data to the test server.
133
134
135 [[image:image-20220907153445-4.png]]
136
137
138
139 === 2.2.2 Insert SIM card ===
140
141
142 User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%))
143
144
145 [[image:image-20220907153505-5.png]]
146
147
148
149 === 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
150
151
152 User need to configure NSPH01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NSPH01 support AT Commands, user can use a USB to TTL adapter to connect to NSPH01 and use AT Commands to configure it, as below.
153
154
155 (% style="color:blue" %)**Connection:**
156
157 **~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
158
159 **~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
160
161 **~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
162
163
164 In the PC, use below serial tool settings:
165
166 * Baud:  (% style="color:green" %)**9600**
167 * Data bits:**  (% style="color:green" %)8(%%)**
168 * Stop bits:  (% style="color:green" %)**1**
169 * Parity:  (% style="color:green" %)**None**
170 * Flow Control: (% style="color:green" %)**None**
171
172
173 Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSPH01. NSPH01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
174
175
176 [[image:image-20220912144017-1.png]]
177
178
179 (% style="color:red" %)**Note: the valid AT Commands can be found at:**(%%)**  **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
180
181
182
183 === 2.2.4 Use CoAP protocol to uplink data ===
184
185
186 (% style="color:red" %)**Note: if you don't have CoAP server, you can refer this link to set up one:**(%%)** **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
187
188
189 (% style="color:blue" %)**Use below commands:**
190
191 * (% style="color:#037691" %)**AT+PRO=1**                         (%%) ~/~/  Set to use CoAP protocol to uplink
192 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
193 * (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
194
195 For parameter description, please refer to AT command set
196
197
198 [[image:image-20220907153551-7.png||height="502" width="740"]]
199
200
201 After configure the server address and (% style="color:green" %)**reset the device (via AT+ATZ )**(%%), NSPH01 will start to uplink sensor values to CoAP server.
202
203
204 [[image:image-20220907153612-8.png||height="529" width="729"]]
205
206
207
208 === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
209
210
211 This feature is supported since firmware version v1.0.1
212
213 * (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
214 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
215 * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
216
217
218 [[image:image-20220907153643-9.png||height="401" width="734"]]
219
220
221 [[image:image-20220907153703-10.png||height="309" width="738"]]
222
223
224
225 === 2.2.6 Use MQTT protocol to uplink data ===
226
227
228 This feature is supported since firmware version v110
229
230 * (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/ Set to use MQTT protocol to uplink
231 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/ Set MQTT server address and port
232 * (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/ Set up the CLIENT of MQTT
233 * (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/ Set the username of MQTT
234 * (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/ Set the password of MQTT
235 * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/ Set the sending topic of MQTT
236 * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/ Set the subscription topic of MQTT
237
238
239 [[image:image-20220907153739-11.png||height="491" width="764"]]
240
241
242 [[image:image-20220907153751-12.png||height="555" width="769"]]
243
244
245 MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.
246
247
248
249
250 === 2.2.7 Use TCP protocol to uplink data ===
251
252
253 This feature is supported since firmware version v110
254
255 * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
256 * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
257
258
259 [[image:image-20220907153818-13.png||height="486" width="668"]]
260
261
262 [[image:image-20220907153827-14.png||height="236" width="684"]]
263
264
265
266 === 2.2.8 Change Update Interval ===
267
268
269 Users can use the below command to change the **uplink interval**.
270
271 * (% style="color:blue" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
272
273 (% style="color:red" %)**NOTE: By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**
274
275
276
277 == 2.3  Uplink Payload ==
278
279
280 In this mode, uplink payload includes 87 bytes in total by default.
281
282 Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded.
283
284 (% border="2" style="background-color:#ffffcc; color:green; width:1160px" %)
285 |(% style="width:96px" %)**Size(bytes)**|(% style="width:83px" %)**8**|(% style="width:44px" %)**2**|(% style="width:42px" %)**2**|(% style="width:124px" %)1|(% style="width:57px" %)1|(% style="width:80px" %)1|(% style="width:69px" %)2|(% style="width:134px" %)2|(% style="width:98px" %)4|(% style="width:134px" %)2|(% style="width:68px" %)2|(% style="width:125px" %)4
286 |(% style="width:96px" %)**Value**|(% style="width:83px" %)Device ID|(% style="width:44px" %)Ver|(% style="width:42px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:57px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:69px" %)Soil PH|(% style="width:134px" %)Soil Temperature|(% style="width:98px" %)Time stamp|(% style="width:134px" %)Soil Temperature|(% style="width:68px" %)Soil PH|(% style="width:125px" %)Time stamp  .....
287
288 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data.
289
290 [[image:image-20220907153902-15.png||height="581" width="804"]]
291
292
293 (((
294 The payload is ASCII string, representative same HEX:
295 )))
296
297 (((
298
299 )))
300
301 (((
302 **0x (% style="color:red" %)__f868411056754138__  (% style="color:blue" %)__0064 __ (% style="color:green" %)__0c78__  (% style="color:#00b0f0" %)__17__  (% style="color:#7030a0" %)__01__  (% style="color:#d60093" %)__00__  (% style="color:#a14d07" %)__0225 __ (% style="color:#0020b0" %) __010b__  (% style="color:#420042" %)__6315537b__  (% style="color:#663300" %)//__010b0226631550fb__  __010e022663154d77  01110225631549f1  011502246315466b  01190223631542e5  011d022163153f62  011e022163153bde 011e022163153859__//(%%)**
303 )))
304
305 (((
306
307
308 where:
309 )))
310
311 * Device ID: 0xf868411056754138 = f868411056754138
312 * Version:  0x0064=100=1.0.0
313 * BAT:  0x0c78 = 3192 mV = 3.192V
314 * Singal: 0x17 = 23
315 * Mod:  0x01 = 1
316 * Interrupt: 0x00= 0
317 * Soil PH:  0x0225= 549 = 5.49
318 * Soil Temperature: 0x010b =267=26.7 °C
319 * Time stamp :  0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
320 * Soil Temperature,Soil PH,Time stamp :  010b0226631550fb
321 * 8 sets of recorded data: Temperature,Soil PH,Time stamp :  010e022663154d77,.......
322
323
324
325 == 2.4  Payload Explanation and Sensor Interface ==
326
327
328 === 2.4.1  Device ID ===
329
330
331 By default, the Device ID equal to the last 15 bits of IMEI.
332
333 User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
334
335
336 **Example:**
337
338 AT+DEUI=868411056754138
339
340 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
341
342
343
344 === 2.4.2  Version Info ===
345
346
347 Specify the software version: 0x64=100, means firmware version 1.00.
348
349 For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0.
350
351
352
353 === 2.4.3  Battery Info ===
354
355
356 Check the battery voltage for NSPH01.
357
358 Ex1: 0x0B45 = 2885mV
359
360 Ex2: 0x0B49 = 2889mV
361
362
363
364 === 2.4.4  Signal Strength ===
365
366
367 NB-IoT Network signal Strength.
368
369 **Ex1: 0x1d = 29**
370
371 **0**  -113dBm or less
372
373 **1**  -111dBm
374
375 **2...30** -109dBm... -53dBm
376
377 **31**   -51dBm or greater
378
379 **99**    Not known or not detectable
380
381
382
383 === 2.4.5  Soil PH ===
384
385
386 Get the PH content of the soil. The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of PH in the soil.
387
388 For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is
389
390 (% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**
391
392
393
394 === 2.4.6  Soil Temperature ===
395
396
397 Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is (% style="color:blue" %)**__0x09 0xEC__**(%%), the temperature content in the soil is
398
399
400 **Example**:
401
402 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
403
404 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
405
406
407
408 === 2.4.7  Timestamp ===
409
410
411 Time stamp : 0x6315537b =1662342011
412
413 Convert Unix timestamp to time 2022-9-5 9:40:11.
414
415
416
417 === 2.4.8  Digital Interrupt ===
418
419
420 Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSPH01 will send a packet to the server.
421
422 The command is:
423
424 (% style="color:blue" %)**AT+INTMOD=3 ** (%%) ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**
425
426 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up.
427
428
429 **Example:**
430
431 0x(00): Normal uplink packet.
432
433 0x(01): Interrupt Uplink Packet.
434
435
436
437 === 2.4.9  ​+5V Output ===
438
439
440 NSPH01 will enable +5V output before all sampling and disable the +5v after all sampling. 
441
442 The 5V output time can be controlled by AT Command.
443
444 (% style="color:blue" %)**AT+5VT=1000**
445
446 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
447
448
449
450 == 2.5  Downlink Payload ==
451
452
453 By default, NSPH01 prints the downlink payload to console port.
454
455 [[image:image-20220907154636-17.png]]
456
457
458 (% style="color:blue" %)**Examples:**
459
460 * (% style="color:#037691" %)** Set TDC**
461
462 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
463
464 Payload:    01 00 00 1E    TDC=30S
465
466 Payload:    01 00 00 3C    TDC=60S
467
468 * (% style="color:#037691" %)** Reset**
469
470 If payload = 0x04FF, it will reset the NSPH01
471
472 * (% style="color:#037691" %)** INTMOD**
473
474 Downlink Payload: 06000003, Set AT+INTMOD=3
475
476
477
478 == 2.6  ​LED Indicator ==
479
480
481 The NSPH01 has an internal LED which is to show the status of different state.
482
483 * When power on, NSPH01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe)
484 * Then the LED will be on for 1 second means device is boot normally.
485 * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds.
486 * For each uplink probe, LED will be on for 500ms.
487
488
489
490 == 2.7  Installation and Maintain ==
491
492
493 === 2.7.1  Before measurement ===
494
495
496 If the NSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy. 
497
498
499
500 === 2.7.2  Measurement ===
501
502
503 (% style="color:#037691" %)**Measurement the soil surface:**
504
505
506 [[image:image-20220907154700-18.png]] ​
507
508 Choose the proper measuring position. Split the surface soil according to the measured deep.
509
510 Put pure water, or rainwater to make the soil of measurement point to moist mud. Remove rocks or hard things.
511
512 Slowly insert the probe to the measure point. Don't use large force which will break the probe. Make sure not shake when inserting.
513
514 Put soil over the probe after insert. And start to measure.
515
516
517 (% style="color:#037691" %)**Measurement inside soil:**
518
519 Dig a hole with diameter > 20CM.
520
521 Insert the probe inside, method like measure the surface.
522
523
524
525 === 2.7.3  Maintain Probe ===
526
527
528 1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
529 1. After long time use (3~~ 6  months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it.
530 1. Probe reference electrode is also no strong, need to avoid strong force or hitting.
531 1. User should keep reference electrode wet while not use.
532 1. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
533 1. The probe is IP68 can be put in water.
534
535
536
537 == 2.8  PH and Temperature alarm function ==
538
539
540 (% style="color:#037691" %)**➢ AT Command:**
541
542 (% style="color:blue" %)**AT+ PHALARM=min,max**
543
544 ² When min=3, and max≠0, Alarm higher than max
545
546 ² When min≠0, and max=0, Alarm lower than min
547
548 ² When min≠0 and max≠0, Alarm higher than max or lower than min
549
550
551 (% style="color:blue" %)**Example:**
552
553 AT+ PHALARM =5,8  ~/~/ Alarm when PH lower than 5.
554
555 AT+ TEMPALARM=min,max
556
557 ² When min=0, and max≠0, Alarm higher than max
558
559 ² When min≠0, and max=0, Alarm lower than min
560
561 ² When min≠0 and max≠0, Alarm higher than max or lower than min
562
563
564 (% style="color:blue" %)**Example:**
565
566 AT+ TEMPALARM=20,30  ~/~/ Alarm when temperature lower than 20.
567
568
569
570 == 2.9  Set the number of data to be uploaded and the recording time ==
571
572
573 (% style="color:#037691" %)**➢ AT Command:**
574
575 * (% style="color:blue" %)**AT+TR=900**     (%%) ~/~/  The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds)
576 * (% style="color:blue" %)**AT+NOUD=8**     (%%) ~/~/  The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
577
578
579 This link explains the relationship between TR, NOUD and TDC more clearly** : **[[https:~~/~~/www.processon.com/view/link/6340e606e401fd390891af87>>url:https://www.processon.com/view/link/6340e606e401fd390891af87]]
580
581 == 2.10  Read or Clear cached data ==
582
583
584 (% style="color:#037691" %)**➢ AT Command:**
585
586 * (% style="color:blue" %)**AT+CDP**        (%%) ~/~/  Read cached data
587 * (% style="color:blue" %)**AT+CDP=0**    (%%) ~/~/  Clear cached data
588
589
590 [[image:image-20220907154700-19.png]]
591
592
593
594 == 2.11  Calibration ==
595
596
597 User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable).
598
599 After stable, user can use below command to calibrate.
600
601
602 [[image:image-20220907154700-20.png]] ​
603
604
605
606 == 2.12  ​Firmware Change Log ==
607
608
609 Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0>>https://www.dropbox.com/sh/1tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0]]
610
611 Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
612
613
614
615 == 2.13  ​Battery Analysis ==
616
617
618 === 2.13.1  ​Battery Type ===
619
620
621 The NSPH01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter.
622
623 The battery is designed to last for several years depends on the actually use environment and update interval. 
624
625 The battery-related documents as below:
626
627 * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
628 * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
629 * [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
630
631 [[image:image-20220907154700-21.png]] ​
632
633
634
635 === 2.13.2  Power consumption Analyze ===
636
637
638 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval.
639
640 Instruction to use as below:
641
642 (% style="color:blue" %)**Step 1:  **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]
643
644 (% style="color:blue" %)**Step 2: **(%%) Open it and choose
645
646 * Product Model
647 * Uplink Interval
648 * Working Mode
649
650 And the Life expectation in difference case will be shown on the right.
651
652
653 [[image:image-20220907154700-22.jpeg]]
654
655 ​
656
657
658 === 2.13.3  ​Battery Note ===
659
660
661 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased.
662
663
664
665 === 2.13.4  Replace the battery ===
666
667
668 The default battery pack of NSPH01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes).
669
670
671
672 = 3. ​ Access NB-IoT Module =
673
674
675 Users can directly access the AT command set of the NB-IoT module.
676
677 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 
678
679
680 [[image:image-20220907154700-23.png]]
681
682 ​
683
684
685 = 4.  Using the AT Commands =
686
687
688 == 4.1  Access AT Commands ==
689
690
691 See this link for detail:  [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
692
693 AT+<CMD>?  : Help on <CMD>
694
695 AT+<CMD>         : Run <CMD>
696
697 AT+<CMD>=<value> : Set the value
698
699 AT+<CMD>=?  : Get the value
700
701
702 (% style="color:#037691" %)**General Commands**      
703
704 AT  : Attention       
705
706 AT?  : Short Help     
707
708 ATZ  : MCU Reset    
709
710 AT+TDC  : Application Data Transmission Interval
711
712 AT+CFG  : Print all configurations
713
714 AT+CFGMOD           : Working mode selection
715
716 AT+INTMOD            : Set the trigger interrupt mode
717
718 AT+5VT  : Set extend the time of 5V power  
719
720 AT+PRO  : Choose agreement
721
722 AT+RXDL  : Extend the sending and receiving time
723
724 AT+SERVADDR  : Server Address
725
726 AT+TR      : Get or Set record time"
727
728 AT+APN     : Get or set the APN
729
730 AT+FBAND   : Get or Set whether to automatically modify the frequency band
731
732 AT+DNSCFG  : Get or Set DNS Server
733
734 AT+GETSENSORVALUE   : Returns the current sensor measurement
735
736 AT+NOUD      : Get or Set the number of data to be uploaded
737
738 AT+CDP     : Read or Clear cached data
739
740 AT+TEMPALARM      : Get or Set alarm of temp
741
742 AT+PHALARM     : Get or Set alarm of PH
743
744 AT+ PHCAL  : calibrate PH value
745
746
747 (% style="color:#037691" %)**COAP Management**      
748
749 AT+URI            : Resource parameters
750
751
752 (% style="color:#037691" %)**UDP Management**
753
754 AT+CFM          : Upload confirmation mode (only valid for UDP)
755
756
757 (% style="color:#037691" %)**MQTT Management**
758
759 AT+CLIENT               : Get or Set MQTT client
760
761 AT+UNAME  : Get or Set MQTT Username
762
763 AT+PWD                  : Get or Set MQTT password
764
765 AT+PUBTOPIC  : Get or Set MQTT publish topic
766
767 AT+SUBTOPIC  : Get or Set MQTT subscription topic
768
769
770 (% style="color:#037691" %)**Information**          
771
772 AT+FDR  : Factory Data Reset
773
774 AT+PWORD  : Serial Access Password
775
776
777
778 = ​5.  FAQ =
779
780
781 == 5.1 ​ How to Upgrade Firmware ==
782
783
784 User can upgrade the firmware for 1) bug fix, 2) new feature release.
785
786 Please see this link for how to upgrade:  [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]]
787
788 (% style="color:red" %)**Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.**
789
790
791
792 == 5.2  Can I calibrate NSPH01 to different soil types? ==
793
794
795 NSPH01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]].
796
797
798
799 = 6.  Trouble Shooting =
800
801
802 == 6.1  ​Connection problem when uploading firmware ==
803
804
805 **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]]
806
807
808
809 == 6.2  AT Command input doesn't work ==
810
811
812 In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER** (%%)while press the send key, user need to add ENTER in their string.
813
814
815
816 = 7. ​ Order Info =
817
818
819 Part Number**:** NSPH01
820
821
822
823 = 8.  Packing Info =
824
825
826 **Package Includes**:
827
828 * NSPH01 NB-IoT pH Sensor x 1
829 * External antenna x 1
830
831 **Dimension and weight**:
832
833 * Device Size: cm
834 * Device Weight: g
835 * Package Size / pcs : cm
836 * Weight / pcs : g
837
838
839
840 = 9.  Support =
841
842
843 * 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.
844 * 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.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]]
845
846 ​

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0