Last modified by Bei Jinggeng on 2024/03/30 17:53
<
From version < 56.8 >
edited by Xiaoling
on 2022/10/25 16:46
To version < 50.1 >
edited by David Huang
on 2022/09/08 09:48
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoling
1 +XWiki.David
Content
... ... @@ -1,5 +1,5 @@
1 1  (% style="text-align:center" %)
2 -[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png||height="442" width="410"]]
2 +[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png]]
3 3  
4 4  **Table of Contents:**
5 5  
... ... @@ -7,35 +7,27 @@
7 7  
8 8  
9 9  
10 -= 1.  Introduction =
10 += 1. Introduction =
11 11  
12 +== 1.1 ​What is NSPH01 Soil pH Sensor ==
12 12  
13 -== 1.1 ​ What is NSPH01 Soil pH Sensor ==
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.
14 14  
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.
15 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 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.
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 the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a **NB-IoT SIM card** from local operator and install NSPH01 to get NB-IoT network connection.
21 21  
22 -NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
23 -
24 -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)
25 -
26 -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.
27 -
28 -
23 +(% style="text-align:center" %)
29 29  [[image:image-20220907153151-1.png]]
30 30  
31 -
26 +(% style="text-align:center" %)
32 32  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
33 33  
29 +== 1.2 Features ==
34 34  
35 -
36 -== 1.2  Features ==
37 -
38 -
39 39  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
40 40  * Monitor soil pH with temperature compensation.
41 41  * Monitor soil temperature
... ... @@ -51,17 +51,14 @@
51 51  * Micro SIM card slot
52 52  * 8500mAh Battery for long term use
53 53  
54 -
55 -
56 56  == 1.3  Specification ==
57 57  
48 +**Common DC Characteristics:**
58 58  
59 -(% style="color:#037691" %)**Common DC Characteristics:**
60 -
61 61  * Supply Voltage: 2.1v ~~ 3.6v
62 62  * Operating Temperature: -40 ~~ 85°C
63 63  
64 -(% style="color:#037691" %)**NB-IoT Spec:**
53 +**NB-IoT Spec:**
65 65  
66 66  * - B1 @H-FDD: 2100MHz
67 67  * - B3 @H-FDD: 1800MHz
... ... @@ -70,13 +70,10 @@
70 70  * - B20 @H-FDD: 800MHz
71 71  * - B28 @H-FDD: 700MHz
72 72  
62 +== 1.4 Probe Specification ==
73 73  
64 +**Soil pH:**
74 74  
75 -== 1.4  Probe Specification ==
76 -
77 -
78 -(% style="color:#037691" %)**Soil pH:**
79 -
80 80  * Range: 3 ~~ 10 pH
81 81  * Resolution: 0.01 pH
82 82  * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
... ... @@ -84,7 +84,7 @@
84 84  * IP68 Protection
85 85  * Length: 3.5 meters
86 86  
87 -(% style="color:#037691" %)**Soil Temperature:**
73 +**Soil Temperature:**
88 88  
89 89  * Range -40℃～85℃
90 90  * Resolution: 0.1℃
... ... @@ -92,43 +92,31 @@
92 92  * IP68 Protection
93 93  * Length: 3.5 meters
94 94  
81 +== 1.5 ​Applications ==
95 95  
96 -
97 -== 1.5  ​Applications ==
98 -
99 -
100 100  * Smart Agriculture
101 101  
85 +== 1.6 Pin mapping and power on ==
102 102  
103 -
104 -== 1.6  Pin mapping and power on ==
105 -
106 -
87 +(% style="text-align:center" %)
107 107  [[image:image-20220907153300-2.png]]
108 108  
109 109  
110 -
111 111  = 2.  Use NSPH01 to communicate with IoT Server =
112 112  
113 -
114 114  == 2.1  How it works ==
115 115  
116 -
117 117  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.
118 118  
119 119  The diagram below shows the working flow in default firmware of NSPH01:
120 120  
121 -
99 +(% style="text-align:center" %)
122 122  [[image:image-20220907153416-3.png]]
123 123  
124 -
125 -
126 126  == 2.2 ​ Configure the NSPH01 ==
127 127  
128 -
129 129  === 2.2.1 Test Requirement ===
130 130  
131 -
132 132  To use NSPH01 in the field, make sure meet below requirements:
133 133  
134 134  * Your local operator has already distributed a NB-IoT Network there.
... ... @@ -135,215 +135,163 @@
135 135  * The local NB-IoT network used the band that NSPH01 supports.
136 136  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
137 137  
138 -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.
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.
139 139  
140 -
114 +(% style="text-align:center" %)
141 141  [[image:image-20220907153445-4.png]]
142 142  
143 143  
144 -
145 145  === 2.2.2 Insert SIM card ===
146 146  
147 -
148 148  User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%))
149 149  
150 -
122 +(% style="text-align:center" %)
151 151  [[image:image-20220907153505-5.png]]
152 152  
153 -
154 -
155 155  === 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
156 156  
127 +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.
157 157  
158 -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.
129 +**Connection:**
159 159  
131 + USB TTL GND <~-~-~-~-> GND
160 160  
161 -(% style="color:blue" %)**Connection:**
133 + USB TTL TXD <~-~-~-~-> UART_RXD
162 162  
163 -**~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
135 + USB TTL RXD <~-~-~-~-> UART_TXD
164 164  
165 -**~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
166 -
167 -**~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
168 -
169 -
170 170  In the PC, use below serial tool settings:
171 171  
172 -* Baud:  (% style="color:green" %)**9600**
173 -* Data bits:**  (% style="color:green" %)8(%%)**
174 -* Stop bits:  (% style="color:green" %)**1**
175 -* Parity:  (% style="color:green" %)**None**
176 -* Flow Control: (% style="color:green" %)**None**
139 +* Baud:  **9600**
140 +* Data bits:** 8**
141 +* Stop bits: **1**
142 +* Parity:  **None**
143 +* Flow Control: **None**
177 177  
178 -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.
145 +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.
179 179  
147 +(% style="text-align:center" %)
148 +[[image:image-20220907153529-6.png]]
180 180  
181 -[[image:image-20220912144017-1.png]]
150 +**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]]
182 182  
183 -
184 -(% 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]]
185 -
186 -
187 -
188 188  === 2.2.4 Use CoAP protocol to uplink data ===
189 189  
154 +**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/]]
190 190  
191 -(% 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/]]
156 +**Use below commands:**
192 192  
158 +* **AT+PRO=1**   ~/~/ Set to use CoAP protocol to uplink
159 +* **AT+SERVADDR=120.24.4.116,5683   ** ~/~/ to set CoAP server address and port
160 +* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path
193 193  
194 -(% style="color:blue" %)**Use below commands:**
195 -
196 -* (% style="color:#037691" %)**AT+PRO=1**                         (%%) ~/~/  Set to use CoAP protocol to uplink
197 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
198 -* (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
199 -
200 200  For parameter description, please refer to AT command set
201 201  
202 -
164 +(% style="text-align:center" %)
203 203  [[image:image-20220907153551-7.png||height="502" width="740"]]
204 204  
167 +After configure the server address and **reset the device** (via AT+ATZ ), NSPH01 will start to uplink sensor values to CoAP server.
205 205  
206 -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.
207 -
208 -
169 +(% style="text-align:center" %)
209 209  [[image:image-20220907153612-8.png||height="529" width="729"]]
210 210  
211 211  
212 -
213 213  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
214 214  
215 -
216 216  This feature is supported since firmware version v1.0.1
217 217  
218 -* (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
219 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
220 -* (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
177 +* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
178 +* **AT+SERVADDR=120.24.4.116,5601   ** ~/~/ to set UDP server address and port
179 +* **AT+CFM=1       ** ~/~/If the server does not respond, this command is unnecessar
221 221  
181 +(% style="text-align:center" %)
222 222  [[image:image-20220907153643-9.png||height="401" width="734"]]
223 223  
224 -
184 +(% style="text-align:center" %)
225 225  [[image:image-20220907153703-10.png||height="309" width="738"]]
226 226  
227 227  
228 -
229 229  === 2.2.6 Use MQTT protocol to uplink data ===
230 230  
231 -
232 232  This feature is supported since firmware version v110
233 233  
234 -* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/ Set to use MQTT protocol to uplink
235 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/ Set MQTT server address and port
236 -* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/ Set up the CLIENT of MQTT
237 -* (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/ Set the username of MQTT
238 -* (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/ Set the password of MQTT
239 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/ Set the sending topic of MQTT
240 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/ Set the subscription topic of MQTT
192 +* **AT+PRO=3   ** ~/~/Set to use MQTT protocol to uplink
193 +* **AT+SERVADDR=120.24.4.116,1883   ** ~/~/Set MQTT server address and port
194 +* **AT+CLIENT=CLIENT       ** ~/~/Set up the CLIENT of MQTT
195 +* **AT+UNAME=UNAME                               **~/~/Set the username of MQTT
196 +* **AT+PWD=PWD                                        **~/~/Set the password of MQTT
197 +* **AT+PUBTOPIC=NSE01_PUB                    **~/~/Set the sending topic of MQTT
198 +* **AT+SUBTOPIC=NSE01_SUB          ** ~/~/Set the subscription topic of MQTT
241 241  
200 +(% style="text-align:center" %)
242 242  [[image:image-20220907153739-11.png||height="491" width="764"]]
243 243  
244 -
203 +(% style="text-align:center" %)
245 245  [[image:image-20220907153751-12.png||height="555" width="769"]]
246 246  
247 -
248 248  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.
249 249  
250 -
251 -
252 252  === 2.2.7 Use TCP protocol to uplink data ===
253 253  
254 -
255 255  This feature is supported since firmware version v110
256 256  
257 -* (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
258 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
212 +* **AT+PRO=4   ** ~/~/ Set to use TCP protocol to uplink
213 +* **AT+SERVADDR=120.24.4.116,5600   ** ~/~/ to set TCP server address and port
259 259  
215 +(% style="text-align:center" %)
260 260  [[image:image-20220907153818-13.png||height="486" width="668"]]
261 261  
262 -
218 +(% style="text-align:center" %)
263 263  [[image:image-20220907153827-14.png||height="236" width="684"]]
264 264  
265 -
266 -
267 267  === 2.2.8 Change Update Interval ===
268 268  
269 -
270 270  Users can use the below command to change the **uplink interval**.
271 271  
272 -* (% style="color:blue" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
225 +* **AT+TDC=7200      ** ~/~/ Set Update Interval to 7200s (2 hour)
273 273  
274 -(% 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).**
227 +**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).**
275 275  
276 276  
277 -
278 278  == 2.3  Uplink Payload ==
279 279  
280 -
281 281  In this mode, uplink payload includes 87 bytes in total by default.
282 282  
283 283  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.
284 284  
285 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
286 -|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:20px" %)**2**|(% style="width:25px" %)**2**|(% style="width:60px" %)**1**|(% style="width:20px" %)**1**|(% style="width:40px" %)**1**|(% style="width:40px" %)**2**|(% style="width:50px" %)**2**|(% style="width:50px" %)**4**|(% style="width:50px" %)**2**|(% style="width:35px" %)**2**|(% style="width:40px" %)**4**
287 -|=(% 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  .....
236 +|**Size(bytes)**|**8**|**2**|**2**|1|1|1|2|2|4|2|2|4
237 +|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Soil PH|Soil Temperature|Time stamp|Soil Temperature|Soil PH|Time stamp  .....
288 288  
289 289  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data.
290 290  
241 +(% style="text-align:center" %)
291 291  [[image:image-20220907153902-15.png||height="581" width="804"]]
292 292  
293 293  
294 -(((
295 295  The payload is ASCII string, representative same HEX:
296 -)))
297 297  
298 -(((
299 -
300 -)))
247 +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:
301 301  
302 -(((
303 -**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__//(%%)**
304 -)))
249 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
250 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0
251 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
252 +* (% style="color:red" %)Singal: 0x17 = 23
253 +* (% style="color:blue" %)Mod: 0x01 = 1
254 +* (% style="color:green" %)Interrupt: 0x00= 0
255 +* Soil PH: 0x0225= 549 = 5.49
256 +* Soil Temperature:0x010B =267=26.7 °C
257 +* Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
258 +* Soil Temperature,Soil PH,Time stamp : 010b0226631550fb
259 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
305 305  
306 -(((
307 -
308 -
309 -**where:**
310 -)))
311 -
312 -* (% style="color:#037691" %)**Device ID:**(%%)** **0xf868411056754138 = f868411056754138
313 -
314 -* (% style="color:#037691" %)**Version:**  (%%) 0x0064=100=1.0.0
315 -
316 -* (% style="color:#037691" %)**BAT:**   (%%) 0x0c78 = 3192 mV = 3.192V
317 -
318 -* (% style="color:#037691" %)**Singal:** (%%)0x17 = 23
319 -
320 -* (% style="color:#037691" %)**Mod:** (%%) 0x01 = 1
321 -
322 -* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0
323 -
324 -* (% style="color:#037691" %)**Soil PH:** (%%) 0x0225= 549 = 5.49
325 -
326 -* (% style="color:#037691" %)**Soil Temperature:**(%%) 0x010b =267=26.7 °C
327 -
328 -* (% style="color:#037691" %)**Time stamp :**   (%%) 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
329 -
330 -* (% style="color:#037691" %)**Soil Temperature,Soil PH,Time stamp : **(%%) 010b0226631550fb
331 -
332 -* (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp :  010e022663154d77,.......
333 -
334 -
335 -
336 336  == 2.4  Payload Explanation and Sensor Interface ==
337 337  
338 -
339 339  === 2.4.1  Device ID ===
340 340  
341 -
342 342  By default, the Device ID equal to the last 15 bits of IMEI.
343 343  
344 -User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
267 +User can use **AT+DEUI** to set Device ID
345 345  
346 -
347 347  **Example:**
348 348  
349 349  AT+DEUI=868411056754138
... ... @@ -350,20 +350,14 @@
350 350  
351 351  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
352 352  
353 -
354 -
355 355  === 2.4.2  Version Info ===
356 356  
357 -
358 358  Specify the software version: 0x64=100, means firmware version 1.00.
359 359  
360 360  For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0.
361 361  
362 -
363 -
364 364  === 2.4.3  Battery Info ===
365 365  
366 -
367 367  Check the battery voltage for NSPH01.
368 368  
369 369  Ex1: 0x0B45 = 2885mV
... ... @@ -370,11 +370,8 @@
370 370  
371 371  Ex2: 0x0B49 = 2889mV
372 372  
373 -
374 -
375 375  === 2.4.4  Signal Strength ===
376 376  
377 -
378 378  NB-IoT Network signal Strength.
379 379  
380 380  **Ex1: 0x1d = 29**
... ... @@ -389,25 +389,18 @@
389 389  
390 390  **99**    Not known or not detectable
391 391  
392 -
393 -
394 394  === 2.4.5  Soil PH ===
395 395  
396 -
397 397  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.
398 398  
399 -For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is
309 +For example, if the data you get from the register is **__0x05 0xDC__**, the PH content in the soil is
400 400  
401 -(% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**
311 +**0229(H) = 549(D) /100 = 5.49.**
402 402  
403 -
404 -
405 405  === 2.4.6  Soil Temperature ===
406 406  
315 +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
407 407  
408 -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
409 -
410 -
411 411  **Example**:
412 412  
413 413  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
... ... @@ -414,62 +414,56 @@
414 414  
415 415  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
416 416  
417 -
418 -
419 419  === 2.4.7  Timestamp ===
420 420  
421 -
422 422  Time stamp : 0x6315537b =1662342011
423 423  
424 424  Convert Unix timestamp to time 2022-9-5 9:40:11.
425 425  
426 -
427 -
428 428  === 2.4.8  Digital Interrupt ===
429 429  
331 +Digital Interrupt refers to pin **GPIO_EXTI**, and there are different trigger methods. When there is a trigger, the NSPH01 will send a packet to the server.
430 430  
431 -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.
432 -
433 433  The command is:
434 434  
435 -(% 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]])**.**
335 +**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]])**.**
436 436  
437 437  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.
438 438  
339 +Example:
439 439  
440 -**Example:**
441 -
442 442  0x(00): Normal uplink packet.
443 443  
444 444  0x(01): Interrupt Uplink Packet.
445 445  
446 -
447 -
448 448  === 2.4.9  ​+5V Output ===
449 449  
450 -
451 451  NSPH01 will enable +5V output before all sampling and disable the +5v after all sampling. 
452 452  
453 453  The 5V output time can be controlled by AT Command.
454 454  
455 -(% style="color:blue" %)**AT+5VT=1000**
351 +**AT+5VT=1000**
456 456  
457 457  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
458 458  
459 459  
460 -
461 461  == 2.5  Downlink Payload ==
462 462  
463 -
464 464  By default, NSPH01 prints the downlink payload to console port.
465 465  
360 +(% style="text-align:center" %)
466 466  [[image:image-20220907154636-17.png]]
467 467  
468 468  
469 -(% style="color:blue" %)**Examples:**
470 470  
471 -* (% style="color:#037691" %)** Set TDC**
472 472  
366 +
367 +
368 +
369 +**Examples:**
370 +
371 +* **Set TDC**
372 +
473 473  If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
474 474  
475 475  Payload:    01 00 00 1E    TDC=30S
... ... @@ -476,19 +476,16 @@
476 476  
477 477  Payload:    01 00 00 3C    TDC=60S
478 478  
479 -* (% style="color:#037691" %)** Reset**
379 +* **Reset**
480 480  
481 481  If payload = 0x04FF, it will reset the NSPH01
482 482  
483 -* (% style="color:#037691" %)** INTMOD**
383 +* **INTMOD**
484 484  
485 485  Downlink Payload: 06000003, Set AT+INTMOD=3
486 486  
487 -
488 -
489 489  == 2.6  ​LED Indicator ==
490 490  
491 -
492 492  The NSPH01 has an internal LED which is to show the status of different state.
493 493  
494 494  * 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)
... ... @@ -496,24 +496,16 @@
496 496  * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds.
497 497  * For each uplink probe, LED will be on for 500ms.
498 498  
396 +== 2.7 Installation and Maintain ==
499 499  
398 +=== 2.7.1 Before measurement ===
500 500  
501 -== 2.7  Installation and Maintain ==
502 -
503 -
504 -=== 2.7.1  Before measurement ===
505 -
506 -
507 507  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. 
508 508  
402 +=== 2.7.2 Measurement ===
509 509  
404 +**Measurement the soil surface:**
510 510  
511 -=== 2.7.2  Measurement ===
512 -
513 -
514 -(% style="color:#037691" %)**Measurement the soil surface:**
515 -
516 -
517 517  [[image:image-20220907154700-18.png]] ​
518 518  
519 519  Choose the proper measuring position. Split the surface soil according to the measured deep.
... ... @@ -524,18 +524,14 @@
524 524  
525 525  Put soil over the probe after insert. And start to measure.
526 526  
416 +**Measurement inside soil:**
527 527  
528 -(% style="color:#037691" %)**Measurement inside soil:**
529 -
530 530  Dig a hole with diameter > 20CM.
531 531  
532 532  Insert the probe inside, method like measure the surface.
533 533  
422 +=== 2.7.3 Maintain Probe ===
534 534  
535 -
536 -=== 2.7.3  Maintain Probe ===
537 -
538 -
539 539  1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
540 540  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.
541 541  1. Probe reference electrode is also no strong, need to avoid strong force or hitting.
... ... @@ -543,15 +543,12 @@
543 543  1. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
544 544  1. The probe is IP68 can be put in water.
545 545  
431 +== 2.8 PH and Temperature alarm function ==
546 546  
433 +➢ AT Command:
547 547  
548 -== 2.8  PH and Temperature alarm function ==
435 +AT+ PHALARM=min,max
549 549  
550 -
551 -(% style="color:#037691" %)**➢ AT Command:**
552 -
553 -(% style="color:blue" %)**AT+ PHALARM=min,max**
554 -
555 555  ² When min=3, and max≠0, Alarm higher than max
556 556  
557 557  ² When min≠0, and max=0, Alarm lower than min
... ... @@ -558,11 +558,10 @@
558 558  
559 559  ² When min≠0 and max≠0, Alarm higher than max or lower than min
560 560  
443 +Example:
561 561  
562 -(% style="color:blue" %)**Example:**
445 +AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5.
563 563  
564 -AT+ PHALARM =5,8  ~/~/ Alarm when PH lower than 5.
565 -
566 566  AT+ TEMPALARM=min,max
567 567  
568 568  ² When min=0, and max≠0, Alarm higher than max
... ... @@ -571,66 +571,50 @@
571 571  
572 572  ² When min≠0 and max≠0, Alarm higher than max or lower than min
573 573  
455 +Example:
574 574  
575 -(% style="color:blue" %)**Example:**
457 +AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
576 576  
577 -AT+ TEMPALARM=20,30  ~/~/ Alarm when temperature lower than 20.
578 578  
460 +== 2.9 Set the number of data to be uploaded and the recording time ==
579 579  
462 +➢ AT Command:
580 580  
581 -== 2.9  Set the number of data to be uploaded and the recording time ==
464 +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)
582 582  
466 +AT+NOUD=8  ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
583 583  
584 -(% style="color:#037691" %)**➢ AT Command:**
585 585  
586 -* (% 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)
587 -* (% 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.
469 +== 2.10 Read or Clear cached data ==
588 588  
589 - The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
471 +➢ AT Command:
590 590  
591 -[[image:image-20221009000933-1.png||height="750" width="1043"]]
473 +AT+CDP ~/~/ Read cached data
592 592  
593 -
594 -
595 -== 2.10  Read or Clear cached data ==
596 -
597 -
598 -(% style="color:#037691" %)**➢ AT Command:**
599 -
600 -* (% style="color:blue" %)**AT+CDP**        (%%) ~/~/  Read cached data
601 -* (% style="color:blue" %)**AT+CDP=0**    (%%) ~/~/  Clear cached data
602 -
603 603  [[image:image-20220907154700-19.png]]
604 604  
605 605  
478 +AT+CDP=0 ~/~/ Clear cached data
606 606  
607 -== 2.11  Calibration ==
608 608  
481 +== 2.11 Calibration ==
609 609  
610 610  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).
611 611  
612 612  After stable, user can use below command to calibrate.
613 613  
614 -
615 615  [[image:image-20220907154700-20.png]] ​
616 616  
617 -
618 -
619 619  == 2.12  ​Firmware Change Log ==
620 620  
491 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
621 621  
622 -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]]
493 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
623 623  
624 -Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
625 -
626 -
627 -
628 628  == 2.13  ​Battery Analysis ==
629 629  
630 -
631 631  === 2.13.1  ​Battery Type ===
632 632  
633 -
634 634  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.
635 635  
636 636  The battery is designed to last for several years depends on the actually use environment and update interval. 
... ... @@ -643,18 +643,15 @@
643 643  
644 644  [[image:image-20220907154700-21.png]] ​
645 645  
646 -
647 -
648 648  === 2.13.2  Power consumption Analyze ===
649 649  
650 -
651 651  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.
652 652  
653 653  Instruction to use as below:
654 654  
655 -(% 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/]]
517 +**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/]]
656 656  
657 -(% style="color:blue" %)**Step 2: **(%%) Open it and choose
519 +**Step 2: ** Open it and choose
658 658  
659 659  * Product Model
660 660  * Uplink Interval
... ... @@ -662,45 +662,34 @@
662 662  
663 663  And the Life expectation in difference case will be shown on the right.
664 664  
665 -
527 +(% style="text-align:center" %)
666 666  [[image:image-20220907154700-22.jpeg]]
667 667  
668 668  ​
669 669  
670 -
671 671  === 2.13.3  ​Battery Note ===
672 672  
673 -
674 674  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.
675 675  
676 -
677 -
678 678  === 2.13.4  Replace the battery ===
679 679  
680 -
681 681  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).
682 682  
683 -
684 -
685 685  = 3. ​ Access NB-IoT Module =
686 686  
687 -
688 688  Users can directly access the AT command set of the NB-IoT module.
689 689  
690 690  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/]] 
691 691  
692 -
546 +(% style="text-align:center" %)
693 693  [[image:image-20220907154700-23.png]]
694 694  
695 695  ​
696 696  
697 -
698 698  = 4.  Using the AT Commands =
699 699  
700 -
701 701  == 4.1  Access AT Commands ==
702 702  
703 -
704 704  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]]
705 705  
706 706  AT+<CMD>?  : Help on <CMD>
... ... @@ -711,9 +711,8 @@
711 711  
712 712  AT+<CMD>=?  : Get the value
713 713  
565 +**General Commands**      
714 714  
715 -(% style="color:#037691" %)**General Commands**      
716 -
717 717  AT  : Attention       
718 718  
719 719  AT?  : Short Help     
... ... @@ -757,18 +757,16 @@
757 757  AT+ PHCAL  : calibrate PH value
758 758  
759 759  
760 -(% style="color:#037691" %)**COAP Management**      
610 +**COAP Management**      
761 761  
762 762  AT+URI            : Resource parameters
763 763  
614 +**UDP Management**
764 764  
765 -(% style="color:#037691" %)**UDP Management**
766 -
767 767  AT+CFM          : Upload confirmation mode (only valid for UDP)
768 768  
618 +**MQTT Management**
769 769  
770 -(% style="color:#037691" %)**MQTT Management**
771 -
772 772  AT+CLIENT               : Get or Set MQTT client
773 773  
774 774  AT+UNAME  : Get or Set MQTT Username
... ... @@ -779,63 +779,42 @@
779 779  
780 780  AT+SUBTOPIC  : Get or Set MQTT subscription topic
781 781  
630 +**Information**          
782 782  
783 -(% style="color:#037691" %)**Information**          
784 -
785 785  AT+FDR  : Factory Data Reset
786 786  
787 787  AT+PWORD  : Serial Access Password
788 788  
789 -
790 -
791 791  = ​5.  FAQ =
792 792  
793 -
794 794  == 5.1 ​ How to Upgrade Firmware ==
795 795  
796 -
797 797  User can upgrade the firmware for 1) bug fix, 2) new feature release.
798 798  
799 799  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]]
800 800  
801 -(% style="color:red" %)**Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.**
644 +**Notice, **NSPH01 **and **NSPH01 **share the same mother board. They use the same connection and method to update.**
802 802  
803 -
804 -
805 805  == 5.2  Can I calibrate NSPH01 to different soil types? ==
806 806  
807 -
808 808  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]].
809 809  
810 -
811 -
812 812  = 6.  Trouble Shooting =
813 813  
814 -
815 815  == 6.1  ​Connection problem when uploading firmware ==
816 816  
817 -
818 818  **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]]
819 819  
820 -
821 -
822 822  == 6.2  AT Command input doesn't work ==
823 823  
658 +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 **ENTER** while sending out the command. Some serial tool doesn't send **ENTER** while press the send key, user need to add ENTER in their string.
824 824  
825 -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.
826 -
827 -
828 -
829 829  = 7. ​ Order Info =
830 830  
831 -
832 832  Part Number**:** NSPH01
833 833  
834 -
835 -
836 836  = 8.  Packing Info =
837 837  
838 -
839 839  **Package Includes**:
840 840  
841 841  * NSPH01 NB-IoT pH Sensor x 1
... ... @@ -843,16 +843,11 @@
843 843  
844 844  **Dimension and weight**:
845 845  
846 -* Device Size: cm
847 -* Device Weight: g
848 -* Package Size / pcs : cm
849 -* Weight / pcs : g
673 +* Size: 195 x 125 x 55 mm
674 +* Weight:   420g
850 850  
851 -
852 -
853 853  = 9.  Support =
854 854  
855 -
856 856  * 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.
857 857  * 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]]
858 858  
image-20220912144017-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -149.6 KB
Content
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

Applications

Navigation

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