Last modified by Bei Jinggeng on 2024/03/30 17:53
<
From version < 44.3 >
edited by Xiaoling
on 2022/09/07 17:56
To version < 51.2 >
edited by Xiaoling
on 2022/09/12 14:57
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png]]
2 +[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png||height="442" width="410"]]
3 3  
4 4  **Table of Contents:**
5 5  
... ... @@ -7,31 +7,36 @@
7 7  
8 8  
9 9  
10 -= 1. Introduction =
10 += 1.  Introduction =
11 11  
12 -== 1.1 ​What is NSPH01 Soil pH Sensor ==
13 13  
14 -The Dragino NSPH01 is a **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.
13 +== 1.1 ​ What is NSPH01 Soil pH Sensor ==
15 15  
16 -NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** pH **with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use.
17 17  
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 +
18 18  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.
19 -\\NSPH01 supports different uplink methods include **TCP,MQTT,UDP and CoAP  **for different application requirement.
20 -\\NSPH01 is powered by  **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)
21 -\\To use NSPH01, user needs to check if there is NB-IoT coverage in local area and with the bands NSPH01 supports. If the local operate support it, user needs to get a **NB-IoT SIM card** from local operator and install NSPH01 to get NB-IoT network connection.
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.
22 22  
23 -(% style="text-align:center" %)
25 +
24 24  [[image:image-20220907153151-1.png]]
25 25  
26 -(% style="text-align:center" %)
28 +
27 27  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
28 28  
29 -== 1.2 Features ==
30 30  
32 +
33 +== 1.2  Features ==
34 +
35 +
31 31  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
32 32  * Monitor soil pH with temperature compensation.
33 33  * Monitor soil temperature
34 -* PH and Temperature alarm function
39 +* pH and Temperature alarm function
35 35  * Monitor Battery Level
36 36  * Support pH calibration by end user
37 37  * Uplink on periodically
... ... @@ -40,17 +40,18 @@
40 40  * IP68 rate for the Sensor Probe
41 41  * Ultra-Low Power consumption
42 42  * AT Commands to change parameters
43 -* Micro SIM card slot for NB-IoT SIM
48 +* Micro SIM card slot
44 44  * 8500mAh Battery for long term use
45 45  
46 46  == 1.3  Specification ==
47 47  
48 -**Common DC Characteristics:**
49 49  
54 +(% style="color:#037691" %)**Common DC Characteristics:**
55 +
50 50  * Supply Voltage: 2.1v ~~ 3.6v
51 51  * Operating Temperature: -40 ~~ 85°C
52 52  
53 -**NB-IoT Spec:**
59 +(% style="color:#037691" %)**NB-IoT Spec:**
54 54  
55 55  * - B1 @H-FDD: 2100MHz
56 56  * - B3 @H-FDD: 1800MHz
... ... @@ -59,10 +59,11 @@
59 59  * - B20 @H-FDD: 800MHz
60 60  * - B28 @H-FDD: 700MHz
61 61  
62 -== 1.4 Probe Specification ==
68 +== 1.4  Probe Specification ==
63 63  
64 -**Soil pH:**
65 65  
71 +(% style="color:#037691" %)**Soil pH:**
72 +
66 66  * Range: 3 ~~ 10 pH
67 67  * Resolution: 0.01 pH
68 68  * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
... ... @@ -70,7 +70,7 @@
70 70  * IP68 Protection
71 71  * Length: 3.5 meters
72 72  
73 -**Soil Temperature:**
80 +(% style="color:#037691" %)**Soil Temperature:**
74 74  
75 75  * Range -40℃～85℃
76 76  * Resolution: 0.1℃
... ... @@ -84,106 +84,125 @@
84 84  
85 85  == 1.6 Pin mapping and power on ==
86 86  
87 -(% style="text-align:center" %)
94 +
88 88  [[image:image-20220907153300-2.png]]
89 89  
90 90  
98 +
91 91  = 2.  Use NSPH01 to communicate with IoT Server =
92 92  
101 +
93 93  == 2.1  How it works ==
94 94  
104 +
95 95  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.
96 96  
97 97  The diagram below shows the working flow in default firmware of NSPH01:
98 98  
99 -(% style="text-align:center" %)
109 +
100 100  [[image:image-20220907153416-3.png]]
101 101  
112 +
113 +
102 102  == 2.2 ​ Configure the NSPH01 ==
103 103  
116 +
104 104  === 2.2.1 Test Requirement ===
105 105  
106 -To use NSPH01 in your city, make sure meet below requirements:
107 107  
120 +To use NSPH01 in the field, make sure meet below requirements:
121 +
108 108  * Your local operator has already distributed a NB-IoT Network there.
109 109  * The local NB-IoT network used the band that NSPH01 supports.
110 110  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
111 111  
112 -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.
113 113  
114 -(% style="text-align:center" %)
128 +
115 115  [[image:image-20220907153445-4.png]]
116 116  
117 117  
132 +
118 118  === 2.2.2 Insert SIM card ===
119 119  
120 -Insert the NB-IoT Card get from your provider.
121 121  
122 -User need to take out the NB-IoT module and insert the SIM card like below:
136 +User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%))
123 123  
124 -(% style="text-align:center" %)
125 125  [[image:image-20220907153505-5.png]]
126 126  
140 +
141 +
127 127  === 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
128 128  
129 -User need to configure NSPH01 via serial port to set the **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.
130 130  
131 -**Connection:**
145 +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.
132 132  
133 - USB TTL GND <~-~-~-~-> GND
134 134  
135 - USB TTL TXD <~-~-~-~-> UART_RXD
148 +(% style="color:blue" %)**Connection:**
136 136  
137 - USB TTL RXD <~-~-~-~-> UART_TXD
150 +**~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
138 138  
152 +**~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
153 +
154 +**~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
155 +
156 +
139 139  In the PC, use below serial tool settings:
140 140  
141 -* Baud:  **9600**
142 -* Data bits:** 8**
143 -* Stop bits: **1**
144 -* Parity:  **None**
145 -* Flow Control: **None**
159 +* Baud:  (% style="color:green" %)**9600**
160 +* Data bits:**  (% style="color:green" %)8(%%)**
161 +* Stop bits:  (% style="color:green" %)**1**
162 +* Parity:  (% style="color:green" %)**None**
163 +* Flow Control: (% style="color:green" %)**None**
164 +*
146 146  
147 -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 **password: 12345678** to access AT Command input.
166 +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.
148 148  
149 -(% style="text-align:center" %)
150 -[[image:image-20220907153529-6.png]]
151 151  
152 -**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]]
169 +[[image:image-20220912144017-1.png]]
153 153  
171 +
172 +(% 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]]
173 +
174 +
175 +
154 154  === 2.2.4 Use CoAP protocol to uplink data ===
155 155  
156 -**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/]]
157 157  
158 -**Use below commands:**
179 +(% 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/]]
159 159  
160 -* **AT+PRO=1**   ~/~/ Set to use CoAP protocol to uplink
161 -* **AT+SERVADDR=120.24.4.116,5683   ** ~/~/ to set CoAP server address and port
162 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path
163 163  
182 +(% style="color:blue" %)**Use below commands:**
183 +
184 +* (% style="color:#037691" %)**AT+PRO=1**                         (%%) ~/~/  Set to use CoAP protocol to uplink
185 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
186 +* (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
187 +
164 164  For parameter description, please refer to AT command set
165 165  
166 -(% style="text-align:center" %)
190 +
167 167  [[image:image-20220907153551-7.png||height="502" width="740"]]
168 168  
169 -After configure the server address and **reset the device** (via AT+ATZ ), NSPH01 will start to uplink sensor values to CoAP server.
170 170  
171 -(% style="text-align:center" %)
194 +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.
195 +
196 +
172 172  [[image:image-20220907153612-8.png||height="529" width="729"]]
173 173  
174 174  
200 +
175 175  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
176 176  
203 +
177 177  This feature is supported since firmware version v1.0.1
205 +(%%)
206 +* **(% style="color:blue" %)AT+PRO=2   ** ~/~/  Set to use UDP protocol to uplink
207 +* **(% style="color:blue" %)AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
208 +* **(% style="color:blue" %)AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
178 178  
179 -* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
180 -* **AT+SERVADDR=120.24.4.116,5601   ** ~/~/ to set UDP server address and port
181 -* **AT+CFM=1       ** ~/~/If the server does not respond, this command is unnecessar
182 -
183 -(% style="text-align:center" %)
184 184  [[image:image-20220907153643-9.png||height="401" width="734"]]
185 185  
186 -(% style="text-align:center" %)
212 +
187 187  [[image:image-20220907153703-10.png||height="309" width="738"]]
188 188  
189 189  
... ... @@ -222,13 +222,12 @@
222 222  
223 223  === 2.2.8 Change Update Interval ===
224 224  
225 -User can use below command to change the **uplink interval**.
251 +Users can use the below command to change the **uplink interval**.
226 226  
227 -* **AT+TDC=600      ** ~/~/ Set Update Interval to 600s
253 +* **AT+TDC=7200      ** ~/~/ Set Update Interval to 7200s (2 hour)
228 228  
229 -**NOTE:**
255 +**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).**
230 230  
231 -**~1. By default, the device will send an uplink message every 2 hour.**
232 232  
233 233  == 2.3  Uplink Payload ==
234 234  
... ... @@ -236,10 +236,6 @@
236 236  
237 237  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.
238 238  
239 -(% style="width:934px" %)
240 -|(% style="width:93px" %)**Size(bytes)**|(% style="width:82px" %)**8**|(% style="width:43px" %)**2**|(% style="width:41px" %)**2**|(% style="width:126px" %)**1**|(% style="width:54px" %)**1**|(% style="width:84px" %)1|(% style="width:75px" %)2|(% style="width:133px" %)2|(% style="width:70px" %)2|(% style="width:127px" %)4   
241 -|(% style="width:93px" %)**Value**|(% style="width:82px" %)Device ID|(% style="width:43px" %)Ver|(% style="width:41px" %)BAT|(% style="width:126px" %)Signal Strength|(% style="width:54px" %)MOD|(% style="width:84px" %)Interrupt|(% style="width:75px" %)Soil PH|(% style="width:133px" %)Soil Temperature|(% style="width:70px" %)Soil PH|(% style="width:127px" %)Time stamp  .....
242 -
243 243  |**Size(bytes)**|**8**|**2**|**2**|1|1|1|2|2|4|2|2|4
244 244  |**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Soil PH|Soil Temperature|Time stamp|Soil Temperature|Soil PH|Time stamp  .....
245 245  
... ... @@ -251,20 +251,19 @@
251 251  
252 252  The payload is ASCII string, representative same HEX:
253 253  
254 -0xf86841105675413800640c781701000225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859 where:
275 +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:
255 255  
256 -* Device ID: 0xf868411056754138 = f868411056754138
257 -* Version: 0x0064=100=1.0.0
258 -
259 -* BAT: 0x0c78 = 3192 mV = 3.192V
260 -* Singal: 0x17 = 23
261 -* Mod: 0x01 = 1
262 -* Interrupt: 0x00= 0
277 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
278 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0
279 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
280 +* (% style="color:red" %)Singal: 0x17 = 23
281 +* (% style="color:blue" %)Mod: 0x01 = 1
282 +* (% style="color:green" %)Interrupt: 0x00= 0
263 263  * Soil PH: 0x0225= 549 = 5.49
264 264  * Soil Temperature:0x010B =267=26.7 °C
265 -* Time stamp : 0x6315537b =1662342011
285 +* Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
266 266  * Soil Temperature,Soil PH,Time stamp : 010b0226631550fb
267 -* 8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
287 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
268 268  
269 269  == 2.4  Payload Explanation and Sensor Interface ==
270 270  
... ... @@ -471,9 +471,9 @@
471 471  
472 472  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)
473 473  
474 -
475 475  AT+NOUD=8  ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
476 476  
496 +
477 477  == 2.10 Read or Clear cached data ==
478 478  
479 479  ➢ AT Command:
... ... @@ -508,7 +508,7 @@
508 508  
509 509  The battery is designed to last for several years depends on the actually use environment and update interval. 
510 510  
511 -The battery related documents as below:
531 +The battery-related documents as below:
512 512  
513 513  * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
514 514  * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
... ... @@ -596,13 +596,18 @@
596 596  
597 597  AT+TR      : Get or Set record time"
598 598  
619 +AT+APN     : Get or set the APN
599 599  
600 -AT+NOUD      : Get or Set the number of data to be uploaded
621 +AT+FBAND   : Get or Set whether to automatically modify the frequency band
601 601  
623 +AT+DNSCFG  : Get or Set DNS Server
602 602  
603 -AT+CDP     : Read or Clear cached data
625 +AT+GETSENSORVALUE   : Returns the current sensor measurement
604 604  
627 +AT+NOUD      : Get or Set the number of data to be uploaded
605 605  
629 +AT+CDP     : Read or Clear cached data
630 +
606 606  AT+TEMPALARM      : Get or Set alarm of temp
607 607  
608 608  AT+PHALARM     : Get or Set alarm of PH
... ... @@ -668,7 +668,7 @@
668 668  
669 669  **Package Includes**:
670 670  
671 -* NSPH01 NB-IoT Soil Moisture & EC Sensor x 1
696 +* NSPH01 NB-IoT pH Sensor x 1
672 672  * External antenna x 1
673 673  
674 674  **Dimension and weight**:
image-20220912144017-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +149.6 KB
Content

Applications

Navigation

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