<
From version < 56.25 >
edited by Xiaoling
on 2024/01/18 14:17
To version < 51.6 >
edited by Xiaoling
on 2022/09/12 15:28
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,16 +3,6 @@
1 -
2 -
3 3  (% style="text-align:center" %)
4 4  [[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png||height="442" width="410"]]
5 5  
6 -
7 -
8 -
9 -
10 -
11 -
12 -
13 -
14 14  **Table of Contents:**
15 15  
16 16  {{toc/}}
... ... @@ -19,34 +19,20 @@
19 19  
20 20  = 1.  Introduction =
21 21  
12 +
22 22  == 1.1 ​ What is NSPH01 Soil pH Sensor ==
23 23  
24 24  
25 -(((
26 26  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.
27 -)))
28 28  
29 -(((
30 30  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.
31 -)))
32 32  
33 -(((
34 34  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.
35 -)))
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.
36 36  
37 -(((
38 -NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
39 -)))
40 40  
41 -(((
42 -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)
43 -)))
44 -
45 -(((
46 -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.
47 -)))
48 -
49 -
50 50  [[image:image-20220907153151-1.png]]
51 51  
52 52  
... ... @@ -53,6 +53,7 @@
53 53  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
54 54  
55 55  
32 +
56 56  == 1.2  Features ==
57 57  
58 58  
... ... @@ -81,12 +81,12 @@
81 81  
82 82  (% style="color:#037691" %)**NB-IoT Spec:**
83 83  
84 -* B1 @H-FDD: 2100MHz
85 -* B3 @H-FDD: 1800MHz
86 -* B8 @H-FDD: 900MHz
87 -* B5 @H-FDD: 850MHz
88 -* B20 @H-FDD: 800MHz
89 -* B28 @H-FDD: 700MHz
61 +* - B1 @H-FDD: 2100MHz
62 +* - B3 @H-FDD: 1800MHz
63 +* - B8 @H-FDD: 900MHz
64 +* - B5 @H-FDD: 850MHz
65 +* - B20 @H-FDD: 800MHz
66 +* - B28 @H-FDD: 700MHz
90 90  
91 91  == 1.4  Probe Specification ==
92 92  
... ... @@ -108,19 +108,20 @@
108 108  * IP68 Protection
109 109  * Length: 3.5 meters
110 110  
111 -== 1.5  ​Applications ==
88 +== 1.5 ​Applications ==
112 112  
113 -
114 114  * Smart Agriculture
115 115  
116 -== 1.6  Pin mapping and power on ==
92 +== 1.6 Pin mapping and power on ==
117 117  
118 118  
119 119  [[image:image-20220907153300-2.png]]
120 120  
121 121  
98 +
122 122  = 2.  Use NSPH01 to communicate with IoT Server =
123 123  
101 +
124 124  == 2.1  How it works ==
125 125  
126 126  
... ... @@ -132,8 +132,10 @@
132 132  [[image:image-20220907153416-3.png]]
133 133  
134 134  
113 +
135 135  == 2.2 ​ Configure the NSPH01 ==
136 136  
116 +
137 137  === 2.2.1 Test Requirement ===
138 138  
139 139  
... ... @@ -143,21 +143,22 @@
143 143  * The local NB-IoT network used the band that NSPH01 supports.
144 144  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
145 145  
146 -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.
126 +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.
147 147  
148 148  
149 149  [[image:image-20220907153445-4.png]]
150 150  
151 151  
132 +
152 152  === 2.2.2 Insert SIM card ===
153 153  
154 154  
155 155  User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%))
156 156  
157 -
158 158  [[image:image-20220907153505-5.png]]
159 159  
160 160  
141 +
161 161  === 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
162 162  
163 163  
... ... @@ -180,14 +180,18 @@
180 180  * Stop bits:  (% style="color:green" %)**1**
181 181  * Parity:  (% style="color:green" %)**None**
182 182  * Flow Control: (% style="color:green" %)**None**
164 +*
183 183  
184 184  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.
185 185  
168 +
186 186  [[image:image-20220912144017-1.png]]
187 187  
171 +
188 188  (% 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]]
189 189  
190 190  
175 +
191 191  === 2.2.4 Use CoAP protocol to uplink data ===
192 192  
193 193  
... ... @@ -212,6 +212,7 @@
212 212  [[image:image-20220907153612-8.png||height="529" width="729"]]
213 213  
214 214  
200 +
215 215  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
216 216  
217 217  
... ... @@ -221,6 +221,7 @@
221 221  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
222 222  * (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
223 223  
210 +
224 224  [[image:image-20220907153643-9.png||height="401" width="734"]]
225 225  
226 226  
... ... @@ -227,6 +227,7 @@
227 227  [[image:image-20220907153703-10.png||height="309" width="738"]]
228 228  
229 229  
217 +
230 230  === 2.2.6 Use MQTT protocol to uplink data ===
231 231  
232 232  
... ... @@ -240,6 +240,7 @@
240 240  * (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/ Set the sending topic of MQTT
241 241  * (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/ Set the subscription topic of MQTT
242 242  
231 +
243 243  [[image:image-20220907153739-11.png||height="491" width="764"]]
244 244  
245 245  
... ... @@ -249,6 +249,8 @@
249 249  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.
250 250  
251 251  
241 +
242 +
252 252  === 2.2.7 Use TCP protocol to uplink data ===
253 253  
254 254  
... ... @@ -257,6 +257,7 @@
257 257  * (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
258 258  * (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
259 259  
251 +
260 260  [[image:image-20220907153818-13.png||height="486" width="668"]]
261 261  
262 262  
... ... @@ -263,6 +263,7 @@
263 263  [[image:image-20220907153827-14.png||height="236" width="684"]]
264 264  
265 265  
258 +
266 266  === 2.2.8 Change Update Interval ===
267 267  
268 268  
... ... @@ -270,9 +270,11 @@
270 270  
271 271  * (% style="color:blue" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
272 272  
266 +
273 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 274  
275 275  
270 +
276 276  == 2.3  Uplink Payload ==
277 277  
278 278  
... ... @@ -280,9 +280,9 @@
280 280  
281 281  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.
282 282  
283 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:515px" %)
284 -|(% style="background-color:#4f81bd; color:white; width:50px" %)**Size(bytes)**|(% style="background-color:#4f81bd; color:white; width:40px" %)**8**|(% style="background-color:#4f81bd; color:white; width:20px" %)**2**|(% style="background-color:#4f81bd; color:white; width:23px" %)**2**|(% style="background-color:#4f81bd; color:white; width:60px" %)**1**|(% style="background-color:#4f81bd; color:white; width:20px" %)**1**|(% style="background-color:#4f81bd; color:white; width:40px" %)**1**|(% style="background-color:#4f81bd; color:white; width:40px" %)**2**|(% style="background-color:#4f81bd; color:white; width:51px" %)**2**|(% style="background-color:#4f81bd; color:white; width:49px" %)**4**|(% style="background-color:#4f81bd; color:white; width:49px" %)**2**|(% style="background-color:#4f81bd; color:white; width:34px" %)**2**|(% style="background-color:#4f81bd; color:white; width:39px" %)**4**
285 -|(% 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  .....
278 +(% border="2" style="background-color:#ffffcc; color:green; width:1160px" %)
279 +|(% 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
280 +|(% 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  .....
286 286  
287 287  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data.
288 288  
... ... @@ -289,48 +289,28 @@
289 289  [[image:image-20220907153902-15.png||height="581" width="804"]]
290 290  
291 291  
292 -(((
293 293  The payload is ASCII string, representative same HEX:
294 -)))
295 295  
296 -(((
297 -
298 -)))
289 +0x(% style="color:red" %)f868411056754138(% style="color:blue" %)0064(% style="color:green" %)0c78(% style="color:red" %)17(% style="color:blue" %)01(% style="color:green" %)00(% style="color:red" %)**//0225010b6315537b//**010b0226631550fb//**010e022663154d77**//01110225631549f1//**011502246315466b**//01190223631542e5//**011d022163153f62**//011e022163153bde//**011e022163153859**//(%%) where:
299 299  
300 -(((
301 -**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__//(%%)**
302 -)))
291 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
292 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0
293 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
294 +* (% style="color:red" %)Singal: 0x17 = 23
295 +* (% style="color:blue" %)Mod: 0x01 = 1
296 +* (% style="color:green" %)Interrupt: 0x00= 0
297 +* Soil PH: 0x0225= 549 = 5.49
298 +* Soil Temperature: 0x010B =267=26.7 °C
299 +* Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
300 +* Soil Temperature,Soil PH,Time stamp : 010b0226631550fb
301 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
303 303  
304 -(((
305 -
306 306  
307 -**where:**
308 -)))
309 309  
310 -* (% style="color:#037691" %)**Device ID:**(%%)** **0xf868411056754138 = f868411056754138
311 311  
312 -* (% style="color:#037691" %)**Version:**  (%%) 0x0064=100=1.0.0
313 -
314 -* (% style="color:#037691" %)**BAT:**   (%%) 0x0c78 = 3192 mV = 3.192V
315 -
316 -* (% style="color:#037691" %)**Singal:** (%%)0x17 = 23
317 -
318 -* (% style="color:#037691" %)**Mod:** (%%) 0x01 = 1
319 -
320 -* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0
321 -
322 -* (% style="color:#037691" %)**Soil PH:** (%%) 0x0225= 549 = 5.49
323 -
324 -* (% style="color:#037691" %)**Soil Temperature:**(%%) 0x010b =267=26.7 °C
325 -
326 -* (% style="color:#037691" %)**Time stamp :**   (%%) 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
327 -
328 -* (% style="color:#037691" %)**Soil Temperature,Soil PH,Time stamp : **(%%) 010b0226631550fb
329 -
330 -* (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp :  010e022663154d77,.......
331 -
332 332  == 2.4  Payload Explanation and Sensor Interface ==
333 333  
308 +
334 334  === 2.4.1  Device ID ===
335 335  
336 336  
... ... @@ -346,6 +346,7 @@
346 346  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
347 347  
348 348  
324 +
349 349  === 2.4.2  Version Info ===
350 350  
351 351  
... ... @@ -354,6 +354,7 @@
354 354  For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0.
355 355  
356 356  
333 +
357 357  === 2.4.3  Battery Info ===
358 358  
359 359  
... ... @@ -364,6 +364,7 @@
364 364  Ex2: 0x0B49 = 2889mV
365 365  
366 366  
344 +
367 367  === 2.4.4  Signal Strength ===
368 368  
369 369  
... ... @@ -382,22 +382,23 @@
382 382  **99**    Not known or not detectable
383 383  
384 384  
363 +
385 385  === 2.4.5  Soil PH ===
386 386  
387 387  
388 388  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.
389 389  
390 -For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is
369 +For example, if the data you get from the register is **__0x05 0xDC__**, the PH content in the soil is
391 391  
392 -(% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**
371 +**0229(H) = 549(D) /100 = 5.49.**
393 393  
394 394  
374 +
395 395  === 2.4.6  Soil Temperature ===
396 396  
397 397  
398 -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
378 +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 **__0x09 0xEC__**, the temperature content in the soil is
399 399  
400 -
401 401  **Example**:
402 402  
403 403  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
... ... @@ -405,6 +405,7 @@
405 405  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
406 406  
407 407  
387 +
408 408  === 2.4.7  Timestamp ===
409 409  
410 410  
... ... @@ -413,6 +413,7 @@
413 413  Convert Unix timestamp to time 2022-9-5 9:40:11.
414 414  
415 415  
396 +
416 416  === 2.4.8  Digital Interrupt ===
417 417  
418 418  
... ... @@ -424,14 +424,14 @@
424 424  
425 425  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.
426 426  
408 +Example:
427 427  
428 -**Example:**
429 -
430 430  0x(00): Normal uplink packet.
431 431  
432 432  0x(01): Interrupt Uplink Packet.
433 433  
434 434  
415 +
435 435  === 2.4.9  ​+5V Output ===
436 436  
437 437  
... ... @@ -444,17 +444,15 @@
444 444  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
445 445  
446 446  
428 +
447 447  == 2.5  Downlink Payload ==
448 448  
449 449  
450 450  By default, NSPH01 prints the downlink payload to console port.
451 451  
452 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:510px" %)
453 -|=(% style="width: 183px; background-color:#4F81BD;color:white" %)**Downlink Control Type**|=(% style="width: 55px; background-color:#4F81BD;color:white" %)FPort|=(% style="width: 93px; background-color:#4F81BD;color:white" %)**Type Code**|=(% style="width: 179px; background-color:#4F81BD;color:white" %)**Downlink payload size(bytes)**
454 -|(% style="width:183px" %)TDC (Transmit Time Interval)|(% style="width:55px" %)Any|(% style="width:93px" %)01|(% style="width:146px" %)4
455 -|(% style="width:183px" %)RESET|(% style="width:55px" %)Any|(% style="width:93px" %)04|(% style="width:146px" %)2
456 -|(% style="width:183px" %)INTMOD|(% style="width:55px" %)Any|(% style="width:93px" %)06|(% style="width:146px" %)4
434 +[[image:image-20220907154636-17.png]]
457 457  
436 +
458 458  (% style="color:blue" %)**Examples:**
459 459  
460 460  * (% style="color:#037691" %)** Set TDC**
... ... @@ -474,6 +474,7 @@
474 474  Downlink Payload: 06000003, Set AT+INTMOD=3
475 475  
476 476  
456 +
477 477  == 2.6  ​LED Indicator ==
478 478  
479 479  
... ... @@ -484,8 +484,12 @@
484 484  * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds.
485 485  * For each uplink probe, LED will be on for 500ms.
486 486  
467 +
468 +
469 +
487 487  == 2.7  Installation and Maintain ==
488 488  
472 +
489 489  === 2.7.1  Before measurement ===
490 490  
491 491  
... ... @@ -492,10 +492,11 @@
492 492  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. 
493 493  
494 494  
479 +
495 495  === 2.7.2  Measurement ===
496 496  
497 497  
498 -(% style="color:#037691" %)**Measurement the soil surface:**
483 +**(% style="color:#037691" %)Measurement the soil surface:**
499 499  
500 500  
501 501  [[image:image-20220907154700-18.png]] ​
... ... @@ -509,7 +509,7 @@
509 509  Put soil over the probe after insert. And start to measure.
510 510  
511 511  
512 -(% style="color:#037691" %)**Measurement inside soil:**
497 +**(% style="color:#037691" %)Measurement inside soil:**
513 513  
514 514  Dig a hole with diameter > 20CM.
515 515  
... ... @@ -516,6 +516,7 @@
516 516  Insert the probe inside, method like measure the surface.
517 517  
518 518  
504 +
519 519  === 2.7.3  Maintain Probe ===
520 520  
521 521  
... ... @@ -526,12 +526,15 @@
526 526  1. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
527 527  1. The probe is IP68 can be put in water.
528 528  
515 +
516 +
517 +
529 529  == 2.8  PH and Temperature alarm function ==
530 530  
531 531  
532 -(% style="color:#037691" %)**➢ AT Command:**
521 +**(% style="color:#037691" %)➢ AT Command:**
533 533  
534 -(% style="color:blue" %)**AT+ PHALARM=min,max**
523 +**(% style="color:blue" %)AT+ PHALARM=min,max**
535 535  
536 536  ² When min=3, and max≠0, Alarm higher than max
537 537  
... ... @@ -540,7 +540,7 @@
540 540  ² When min≠0 and max≠0, Alarm higher than max or lower than min
541 541  
542 542  
543 -(% style="color:blue" %)**Example:**
532 +**(% style="color:blue" %)Example:**
544 544  
545 545  AT+ PHALARM =5,8  ~/~/ Alarm when PH lower than 5.
546 546  
... ... @@ -553,35 +553,36 @@
553 553  ² When min≠0 and max≠0, Alarm higher than max or lower than min
554 554  
555 555  
556 -(% style="color:blue" %)**Example:**
545 +**(% style="color:blue" %)Example:**
557 557  
558 558  AT+ TEMPALARM=20,30  ~/~/ Alarm when temperature lower than 20.
559 559  
560 560  
561 -== 2.9  Set the number of data to be uploaded and the recording time ==
562 562  
551 +== 2.9 Set the number of data to be uploaded and the recording time ==
563 563  
564 -(% style="color:#037691" %)**➢ AT Command:**
565 565  
566 -* (% 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)
567 -* (% 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.
554 +**(% style="color:#037691" %)➢ AT Command:**
568 568  
569 - The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
556 +**(% 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)
570 570  
571 -[[image:image-20221009000933-1.png||height="750" width="1043"]]
558 +**(% 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.
572 572  
573 573  
574 -== 2.10  Read or Clear cached data ==
561 +== 2.10 Read or Clear cached data ==
575 575  
576 576  
577 -(% style="color:#037691" %)**➢ AT Command:**
564 +**(% style="color:#037691" %)➢ AT Command:**
578 578  
579 -* (% style="color:blue" %)**AT+CDP**        (%%) ~/~/  Read cached data
580 -* (% style="color:blue" %)**AT+CDP=0**    (%%) ~/~/  Clear cached data
566 +**(% style="color:blue" %)AT+CDP**  (%%) ~/~/  Read cached data
581 581  
568 +**(% style="color:blue" %)AT+CDP=0** (%%) ~/~/ Clear cached data
569 +
570 +
582 582  [[image:image-20220907154700-19.png]]
583 583  
584 584  
574 +
585 585  == 2.11  Calibration ==
586 586  
587 587  
... ... @@ -589,50 +589,77 @@
589 589  
590 590  After stable, user can use below command to calibrate.
591 591  
592 -(% border="1" cellspacing="3" style="background-color:#f2f2f2; width:515px" %)
593 -|(% style="background-color:#4f81bd; color:white; width:118px" %)**pH buffer solution**|(% style="background-color:#4f81bd; color:white; width:149px" %)**AT Command to calibrate**|(% style="background-color:#4f81bd; color:white; width:149px" %)**Downlink Command**|(% style="background-color:#4f81bd; color:white; width:99px" %)**Read Cal Value**
594 -|(% style="width:149px" %)4.00|(% style="width:197px" %)AT+PHCAL=4|(% style="width:206px" %)(((
595 -0x13 04
596 -Reply with Calibrate payload
597 -)))|(% style="width:136px" %)(((
598 -AT+PHCAL=?
599 -Example 41,61,91
600 -)))
601 -|(% style="width:149px" %)6.86|(% style="width:197px" %)AT+PHCAL=6|(% style="width:206px" %)(((
602 -0x13 06
603 -Reply with Calibrate payload
604 -)))|(% style="width:136px" %)AT+PHCAL=?
605 -|(% style="width:149px" %)9.18|(% style="width:197px" %)AT+PHCAL=9|(% style="width:206px" %)(((
606 -0x13 09
607 -Reply with Calibrate payload
608 -)))|(% style="width:136px" %)AT+PHCAL=?
609 -|(% style="width:149px" %)Factory Default|(% style="width:197px" %)AT+PHCAL=15|(% style="width:206px" %)(((
610 -0x13 15
611 -Reply with Calibrate payload
612 -)))|(% style="width:136px" %)(((
613 -AT+PHCAL=?
614 -Example 151
615 -)))
616 616  
617 - ​
583 +[[image:image-20220907154700-20.png]]
618 618  
619 619  
586 +
620 620  == 2.12  ​Firmware Change Log ==
621 621  
622 622  
623 -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]]
590 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
624 624  
625 -Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
592 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
626 626  
627 627  
628 -== 2.13 Battery & Power Consumption ==
629 629  
596 +== 2.13  ​Battery Analysis ==
630 630  
631 -NSPH01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
632 632  
633 -[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
599 +=== 2.13.1  ​Battery Type ===
634 634  
635 635  
602 +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.
603 +
604 +The battery is designed to last for several years depends on the actually use environment and update interval. 
605 +
606 +The battery-related documents as below:
607 +
608 +* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
609 +* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
610 +* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
611 +
612 +[[image:image-20220907154700-21.png]] ​
613 +
614 +
615 +
616 +=== 2.13.2  Power consumption Analyze ===
617 +
618 +
619 +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.
620 +
621 +Instruction to use as below:
622 +
623 +**(% 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/]]
624 +
625 +**(% style="color:#037691" %)Step 2: **(%%) Open it and choose
626 +
627 +* Product Model
628 +* Uplink Interval
629 +* Working Mode
630 +
631 +And the Life expectation in difference case will be shown on the right.
632 +
633 +
634 +[[image:image-20220907154700-22.jpeg]]
635 +
636 +​
637 +
638 +
639 +=== 2.13.3  ​Battery Note ===
640 +
641 +
642 +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.
643 +
644 +
645 +
646 +=== 2.13.4  Replace the battery ===
647 +
648 +
649 +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).
650 +
651 +
652 +
636 636  = 3. ​ Access NB-IoT Module =
637 637  
638 638  
... ... @@ -645,8 +645,10 @@
645 645  
646 646  ​
647 647  
665 +
648 648  = 4.  Using the AT Commands =
649 649  
668 +
650 650  == 4.1  Access AT Commands ==
651 651  
652 652  
... ... @@ -661,7 +661,7 @@
661 661  AT+<CMD>=?  : Get the value
662 662  
663 663  
664 -(% style="color:#037691" %)**General Commands**      
683 +**(% style="color:#037691" %)General Commands**      
665 665  
666 666  AT  : Attention       
667 667  
... ... @@ -706,17 +706,17 @@
706 706  AT+ PHCAL  : calibrate PH value
707 707  
708 708  
709 -(% style="color:#037691" %)**COAP Management**      
728 +**(% style="color:#037691" %)COAP Management**      
710 710  
711 711  AT+URI            : Resource parameters
712 712  
713 713  
714 -(% style="color:#037691" %)**UDP Management**
733 +**(% style="color:#037691" %)UDP Management**
715 715  
716 716  AT+CFM          : Upload confirmation mode (only valid for UDP)
717 717  
718 718  
719 -(% style="color:#037691" %)**MQTT Management**
738 +**(% style="color:#037691" %)MQTT Management**
720 720  
721 721  AT+CLIENT               : Get or Set MQTT client
722 722  
... ... @@ -729,7 +729,7 @@
729 729  AT+SUBTOPIC  : Get or Set MQTT subscription topic
730 730  
731 731  
732 -(% style="color:#037691" %)**Information**          
751 +**(% style="color:#037691" %)Information**          
733 733  
734 734  AT+FDR  : Factory Data Reset
735 735  
... ... @@ -736,8 +736,10 @@
736 736  AT+PWORD  : Serial Access Password
737 737  
738 738  
758 +
739 739  = ​5.  FAQ =
740 740  
761 +
741 741  == 5.1 ​ How to Upgrade Firmware ==
742 742  
743 743  
... ... @@ -745,9 +745,10 @@
745 745  
746 746  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]]
747 747  
748 -(% style="color:red" %)**Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.**
769 +**(% style="color:red" %)Notice, **NSPH01 **and **LSPH01 **share the same mother board. They use the same connection and method to update.**
749 749  
750 750  
772 +
751 751  == 5.2  Can I calibrate NSPH01 to different soil types? ==
752 752  
753 753  
... ... @@ -754,8 +754,10 @@
754 754  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]].
755 755  
756 756  
779 +
757 757  = 6.  Trouble Shooting =
758 758  
782 +
759 759  == 6.1  ​Connection problem when uploading firmware ==
760 760  
761 761  
... ... @@ -762,18 +762,14 @@
762 762  **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]]
763 763  
764 764  
789 +
765 765  == 6.2  AT Command input doesn't work ==
766 766  
767 767  
768 -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.
793 +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.
769 769  
770 770  
771 -== 6.3 Not able to connect to NB-IoT network and keep showing "Signal Strength:99". ==
772 772  
773 -
774 -This means sensor is trying to join the NB-IoT network but fail. Please see this link for **//[[trouble shooting for signal strenght:99>>doc:Main.CSQ\:99,99.WebHome]]//**.
775 -
776 -
777 777  = 7. ​ Order Info =
778 778  
779 779  
... ... @@ -780,6 +780,7 @@
780 780  Part Number**:** NSPH01
781 781  
782 782  
803 +
783 783  = 8.  Packing Info =
784 784  
785 785  
... ... @@ -790,11 +790,12 @@
790 790  
791 791  **Dimension and weight**:
792 792  
793 -* Device Size: cm
794 -* Device Weight: g
795 -* Package Size / pcs : cm
796 -* Weight / pcs : g
814 +* Size: 195 x 125 x 55 mm
815 +* Weight:   420g
797 797  
817 +
818 +
819 +
798 798  = 9.  Support =
799 799  
800 800  
image-20220923101327-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -12.1 KB
Content
image-20221009000933-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -282.9 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0