<
From version < 51.4 >
edited by Xiaoling
on 2022/09/12 15:04
To version < 39.1 >
edited by David Huang
on 2022/09/07 16:51
>
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,42 +1,31 @@
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 -**Table of Contents:**
4 += **1. Introduction** =
5 5  
6 -{{toc/}}
6 +== **1.1 ​What is NSPH01 Soil pH Sensor** ==
7 7  
8 +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.
8 8  
10 +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.
9 9  
10 -= 1.  Introduction =
11 -
12 -
13 -== 1.1 ​ What is NSPH01 Soil pH Sensor ==
14 -
15 -
16 -The Dragino NSPH01 is a (% style="color:blue" %)**NB-IoT soil pH sensor**(%%) for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
17 -
18 -NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:blue" %)pH (%%)**with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use.
19 -
20 20  NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
21 -\\NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
22 -\\NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
23 -\\To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection.
13 +\\NSPH01 supports different uplink methods include **TCP,MQTT,UDP and CoAP  **for different application requirement.
14 +\\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)
15 +\\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.
24 24  
25 -
17 +(% style="text-align:center" %)
26 26  [[image:image-20220907153151-1.png]]
27 27  
28 -
20 +(% style="text-align:center" %)
29 29  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
30 30  
23 +**1.2 Features**
31 31  
32 -
33 -== 1.2  Features ==
34 -
35 -
36 36  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
37 37  * Monitor soil pH with temperature compensation.
38 38  * Monitor soil temperature
39 -* pH and Temperature alarm function
28 +* PH and Temperature alarm function
40 40  * Monitor Battery Level
41 41  * Support pH calibration by end user
42 42  * Uplink on periodically
... ... @@ -45,18 +45,17 @@
45 45  * IP68 rate for the Sensor Probe
46 46  * Ultra-Low Power consumption
47 47  * AT Commands to change parameters
48 -* Micro SIM card slot
37 +* Micro SIM card slot for NB-IoT SIM
49 49  * 8500mAh Battery for long term use
50 50  
51 -== 1.3  Specification ==
40 +**1.3  Specification**
52 52  
42 +**Common DC Characteristics:**
53 53  
54 -(% style="color:#037691" %)**Common DC Characteristics:**
55 -
56 56  * Supply Voltage: 2.1v ~~ 3.6v
57 57  * Operating Temperature: -40 ~~ 85°C
58 58  
59 -(% style="color:#037691" %)**NB-IoT Spec:**
47 +**NB-IoT Spec:**
60 60  
61 61  * - B1 @H-FDD: 2100MHz
62 62  * - B3 @H-FDD: 1800MHz
... ... @@ -65,11 +65,10 @@
65 65  * - B20 @H-FDD: 800MHz
66 66  * - B28 @H-FDD: 700MHz
67 67  
68 -== 1.4  Probe Specification ==
56 +**1.4 Probe Specification**
69 69  
58 +**Soil pH:**
70 70  
71 -(% style="color:#037691" %)**Soil pH:**
72 -
73 73  * Range: 3 ~~ 10 pH
74 74  * Resolution: 0.01 pH
75 75  * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
... ... @@ -77,7 +77,7 @@
77 77  * IP68 Protection
78 78  * Length: 3.5 meters
79 79  
80 -(% style="color:#037691" %)**Soil Temperature:**
67 +**Soil Temperature:**
81 81  
82 82  * Range -40℃~85℃
83 83  * Resolution: 0.1℃
... ... @@ -85,198 +85,167 @@
85 85  * IP68 Protection
86 86  * Length: 3.5 meters
87 87  
88 -== 1.5 ​Applications ==
75 +**1.5 ​Applications**
89 89  
90 90  * Smart Agriculture
91 91  
92 -== 1.6 Pin mapping and power on ==
79 +**1.6 Pin mapping and power on**
93 93  
94 -
81 +(% style="text-align:center" %)
95 95  [[image:image-20220907153300-2.png]]
96 96  
97 97  
85 +**2.  Use NSPH01 to communicate with IoT Server**
98 98  
99 -= 2.  Use NSPH01 to communicate with IoT Server =
87 +**2.1  How it works**
100 100  
101 -
102 -== 2.1  How it works ==
103 -
104 -
105 105  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.
106 106  
107 107  The diagram below shows the working flow in default firmware of NSPH01:
108 108  
109 -
93 +(% style="text-align:center" %)
110 110  [[image:image-20220907153416-3.png]]
111 111  
96 +**2.2 ​ Configure the NSPH01**
112 112  
98 +**2.2.1 Test Requirement**
113 113  
114 -== 2.2 Configure the NSPH01 ==
100 +To use NSPH01 in your city, make sure meet below requirements:
115 115  
116 -
117 -=== 2.2.1 Test Requirement ===
118 -
119 -
120 -To use NSPH01 in the field, make sure meet below requirements:
121 -
122 122  * Your local operator has already distributed a NB-IoT Network there.
123 123  * The local NB-IoT network used the band that NSPH01 supports.
124 124  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
125 125  
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.
106 +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
127 127  
128 -
108 +(% style="text-align:center" %)
129 129  [[image:image-20220907153445-4.png]]
130 130  
131 131  
112 +**2.2.2 Insert SIM card**
132 132  
133 -=== 2.2.2 Insert SIM card ===
114 +Insert the NB-IoT Card get from your provider.
134 134  
116 +User need to take out the NB-IoT module and insert the SIM card like below:
135 135  
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(%%))
137 -
118 +(% style="text-align:center" %)
138 138  [[image:image-20220907153505-5.png]]
139 139  
121 +**2.2.3 Connect USB – TTL to NSPH01 to configure it**
140 140  
123 +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.
141 141  
142 -=== 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
125 +**Connection:**
143 143  
127 + USB TTL GND <~-~-~-~-> GND
144 144  
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.
129 + USB TTL TXD <~-~-~-~-> UART_RXD
146 146  
131 + USB TTL RXD <~-~-~-~-> UART_TXD
147 147  
148 -(% style="color:blue" %)**Connection:**
149 -
150 -**~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
151 -
152 -**~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
153 -
154 -**~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
155 -
156 -
157 157  In the PC, use below serial tool settings:
158 158  
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 -*
135 +* Baud:  **9600**
136 +* Data bits:** 8**
137 +* Stop bits: **1**
138 +* Parity:  **None**
139 +* Flow Control: **None**
165 165  
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.
141 +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.
167 167  
143 +(% style="text-align:center" %)
144 +[[image:image-20220907153529-6.png]]
168 168  
169 -[[image:image-20220912144017-1.png]]
146 +**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]]
170 170  
148 +**2.2.4 Use CoAP protocol to uplink data**
171 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]]
150 +**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/]]
173 173  
152 +**Use below commands:**
174 174  
154 +* **AT+PRO=1**   ~/~/ Set to use CoAP protocol to uplink
155 +* **AT+SERVADDR=120.24.4.116,5683   ** ~/~/ to set CoAP server address and port
156 +* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path
175 175  
176 -=== 2.2.4 Use CoAP protocol to uplink data ===
177 -
178 -
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/]]
180 -
181 -
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 -
188 188  For parameter description, please refer to AT command set
189 189  
190 -
160 +(% style="text-align:center" %)
191 191  [[image:image-20220907153551-7.png||height="502" width="740"]]
192 192  
163 +After configure the server address and **reset the device** (via AT+ATZ ), NSPH01 will start to uplink sensor values to CoAP server.
193 193  
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 -
165 +(% style="text-align:center" %)
197 197  [[image:image-20220907153612-8.png||height="529" width="729"]]
198 198  
199 199  
169 +**2.2.5 Use UDP protocol to uplink data(Default protocol)**
200 200  
201 -=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
202 -
203 -
204 204  This feature is supported since firmware version v1.0.1
205 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
173 +* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
174 +* **AT+SERVADDR=120.24.4.116,5601   ** ~/~/ to set UDP server address and port
175 +* **AT+CFM=1       ** ~/~/If the server does not respond, this command is unnecessar
209 209  
210 -
211 -
177 +(% style="text-align:center" %)
212 212  [[image:image-20220907153643-9.png||height="401" width="734"]]
213 213  
214 -
180 +(% style="text-align:center" %)
215 215  [[image:image-20220907153703-10.png||height="309" width="738"]]
216 216  
217 217  
184 +**2.2.6 Use MQTT protocol to uplink data**
218 218  
219 -=== 2.2.6 Use MQTT protocol to uplink data ===
220 -
221 -
222 222  This feature is supported since firmware version v110
223 223  
224 -* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/ Set to use MQTT protocol to uplink
225 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/ Set MQTT server address and port
226 -* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/ Set up the CLIENT of MQTT
227 -* (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/ Set the username of MQTT
228 -* (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/ Set the password of MQTT
229 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/ Set the sending topic of MQTT
230 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/ Set the subscription topic of MQTT
188 +* **AT+PRO=3   ** ~/~/Set to use MQTT protocol to uplink
189 +* **AT+SERVADDR=120.24.4.116,1883   ** ~/~/Set MQTT server address and port
190 +* **AT+CLIENT=CLIENT       ** ~/~/Set up the CLIENT of MQTT
191 +* **AT+UNAME=UNAME                               **~/~/Set the username of MQTT
192 +* **AT+PWD=PWD                                        **~/~/Set the password of MQTT
193 +* **AT+PUBTOPIC=NSE01_PUB                    **~/~/Set the sending topic of MQTT
194 +* **AT+SUBTOPIC=NSE01_SUB          ** ~/~/Set the subscription topic of MQTT
231 231  
232 -
233 -
196 +(% style="text-align:center" %)
234 234  [[image:image-20220907153739-11.png||height="491" width="764"]]
235 235  
236 -
199 +(% style="text-align:center" %)
237 237  [[image:image-20220907153751-12.png||height="555" width="769"]]
238 238  
239 -
240 240  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.
241 241  
204 +**2.2.7 Use TCP protocol to uplink data**
242 242  
243 -
244 -
245 -=== 2.2.7 Use TCP protocol to uplink data ===
246 -
247 -
248 248  This feature is supported since firmware version v110
249 249  
250 -* (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
251 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
208 +* **AT+PRO=4   ** ~/~/ Set to use TCP protocol to uplink
209 +* **AT+SERVADDR=120.24.4.116,5600   ** ~/~/ to set TCP server address and port
252 252  
253 -
254 -
211 +(% style="text-align:center" %)
255 255  [[image:image-20220907153818-13.png||height="486" width="668"]]
256 256  
257 -
214 +(% style="text-align:center" %)
258 258  [[image:image-20220907153827-14.png||height="236" width="684"]]
259 259  
217 +**2.2.8 Change Update Interval**
260 260  
219 +User can use below command to change the **uplink interval**.
261 261  
221 +* **AT+TDC=600      ** ~/~/ Set Update Interval to 600s
262 262  
263 -=== 2.2.8 Change Update Interval ===
223 +**NOTE:**
264 264  
265 -Users can use the below command to change the **uplink interval**.
225 +**~1. By default, the device will send an uplink message every 2 hour.**
266 266  
267 -* (% style="color:blue" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
227 +**2.3  Uplink Payload**
268 268  
269 -(% 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).**
270 -
271 -
272 -== 2.3  Uplink Payload ==
273 -
274 274  In this mode, uplink payload includes 87 bytes in total by default.
275 275  
276 276  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.
277 277  
278 -|**Size(bytes)**|**8**|**2**|**2**|1|1|1|2|2|4|2|2|4
279 -|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Soil PH|Soil Temperature|Time stamp|Soil Temperature|Soil PH|Time stamp  .....
233 +(% style="width:934px" %)
234 +|(% 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   
235 +|(% 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  .....
280 280  
281 281  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data.
282 282  
... ... @@ -286,27 +286,28 @@
286 286  
287 287  The payload is ASCII string, representative same HEX:
288 288  
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:
245 +0xf86841105675413800640c781701000225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859 where:
290 290  
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
247 +* Device ID: 0xf868411056754138 = f868411056754138
248 +* Version: 0x0064=100=1.0.0
249 +
250 +* BAT: 0x0c78 = 3192 mV = 3.192V
251 +* Singal: 0x17 = 23
252 +* Mod: 0x01 = 1
253 +* Interrupt: 0x00= 0
297 297  * Soil PH: 0x0225= 549 = 5.49
298 298  * Soil Temperature:0x010B =267=26.7 °C
299 -* Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
256 +* Time stamp : 0x6315537b =1662342011
300 300  * Soil Temperature,Soil PH,Time stamp : 010b0226631550fb
301 -* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
258 +* 8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
302 302  
303 -== 2.4  Payload Explanation and Sensor Interface ==
260 +**2.4  Payload Explanation and Sensor Interface**
304 304  
305 -=== 2.4.1  Device ID ===
262 +**2.4.1  Device ID**
306 306  
307 307  By default, the Device ID equal to the last 15 bits of IMEI.
308 308  
309 -User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
266 +User can use **AT+DEUI** to set Device ID
310 310  
311 311  **Example:**
312 312  
... ... @@ -314,13 +314,13 @@
314 314  
315 315  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
316 316  
317 -=== 2.4.2  Version Info ===
274 +**2.4.2  Version Info**
318 318  
319 319  Specify the software version: 0x64=100, means firmware version 1.00.
320 320  
321 321  For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0.
322 322  
323 -=== 2.4.3  Battery Info ===
280 +**2.4.3  Battery Info**
324 324  
325 325  Check the battery voltage for NSPH01.
326 326  
... ... @@ -328,7 +328,7 @@
328 328  
329 329  Ex2: 0x0B49 = 2889mV
330 330  
331 -=== 2.4.4  Signal Strength ===
288 +**2.4.4  Signal Strength**
332 332  
333 333  NB-IoT Network signal Strength.
334 334  
... ... @@ -344,7 +344,7 @@
344 344  
345 345  **99**    Not known or not detectable
346 346  
347 -=== 2.4.5  Soil PH ===
304 +**2.4.5  Soil PH**
348 348  
349 349  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.
350 350  
... ... @@ -352,23 +352,23 @@
352 352  
353 353  **0229(H) = 549(D) /100 = 5.49.**
354 354  
355 -=== 2.4.6  Soil Temperature ===
312 +**2.4.6  Soil Temperature**
356 356  
357 357  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
358 358  
359 359  **Example**:
360 360  
361 -If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
318 +If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/100 = 2.61 °C
362 362  
363 -If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
320 +If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/100 = -1.29 °C
364 364  
365 -=== 2.4.7  Timestamp ===
322 +**2.4.7  Timestamp**
366 366  
367 367  Time stamp : 0x6315537b =1662342011
368 368  
369 369  Convert Unix timestamp to time 2022-9-5 9:40:11.
370 370  
371 -=== 2.4.8  Digital Interrupt ===
328 +**2.4.8  Digital Interrupt**
372 372  
373 373  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.
374 374  
... ... @@ -384,7 +384,7 @@
384 384  
385 385  0x(01): Interrupt Uplink Packet.
386 386  
387 -=== 2.4.9  ​+5V Output ===
344 +**2.4.9  ​+5V Output**
388 388  
389 389  NSPH01 will enable +5V output before all sampling and disable the +5v after all sampling. 
390 390  
... ... @@ -395,9 +395,9 @@
395 395  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
396 396  
397 397  
398 -== 2.5  Downlink Payload ==
355 +**2.5  Downlink Payload**
399 399  
400 -By default, NSPH01 prints the downlink payload to console port.
357 +By default, NSE01 prints the downlink payload to console port.
401 401  
402 402  (% style="text-align:center" %)
403 403  [[image:image-20220907154636-17.png]]
... ... @@ -420,13 +420,13 @@
420 420  
421 421  * **Reset**
422 422  
423 -If payload = 0x04FF, it will reset the NSPH01
380 +If payload = 0x04FF, it will reset the NSE01
424 424  
425 425  * **INTMOD**
426 426  
427 427  Downlink Payload: 06000003, Set AT+INTMOD=3
428 428  
429 -== 2.6  ​LED Indicator ==
386 +**2.6  ​LED Indicator**
430 430  
431 431  The NSPH01 has an internal LED which is to show the status of different state.
432 432  
... ... @@ -435,13 +435,13 @@
435 435  * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds.
436 436  * For each uplink probe, LED will be on for 500ms.
437 437  
438 -== 2.7 Installation and Maintain ==
395 +**2.7 Installation and Maintain**
439 439  
440 -=== 2.7.1 Before measurement ===
397 +**2.7.1 Before measurement**
441 441  
442 442  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. 
443 443  
444 -=== 2.7.2 Measurement ===
401 +**2.7.2 Measurement**
445 445  
446 446  **Measurement the soil surface:**
447 447  
... ... @@ -461,7 +461,7 @@
461 461  
462 462  Insert the probe inside, method like measure the surface.
463 463  
464 -=== 2.7.3 Maintain Probe ===
421 +**2.7.3 Maintain Probe**
465 465  
466 466  1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
467 467  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.
... ... @@ -470,7 +470,7 @@
470 470  1. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
471 471  1. The probe is IP68 can be put in water.
472 472  
473 -== 2.8 PH and Temperature alarm function ==
430 +**2.8 PH and Temperature alarm function**
474 474  
475 475  ➢ AT Command:
476 476  
... ... @@ -484,7 +484,7 @@
484 484  
485 485  Example:
486 486  
487 -AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5.
444 +AT+ PHALARM =3,5 ~/~/ Alarm when PH lower than 5.
488 488  
489 489  AT+ TEMPALARM=min,max
490 490  
... ... @@ -496,20 +496,20 @@
496 496  
497 497  Example:
498 498  
499 -AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
456 +AT+ TEMPALARM=0,20 ~/~/ Alarm when temperature lower than 20.
500 500  
501 501  
502 -== 2.9 Set the number of data to be uploaded and the recording time ==
459 +**2.9 Set the number of data to be uploaded and the recording time**
503 503  
504 504  ➢ AT Command:
505 505  
506 506  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)
507 507  
465 +
508 508  AT+NOUD=8  ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
509 509  
468 +**2.10 Read or Clear cached data**
510 510  
511 -== 2.10 Read or Clear cached data ==
512 -
513 513  ➢ AT Command:
514 514  
515 515  AT+CDP ~/~/ Read cached data
... ... @@ -520,7 +520,7 @@
520 520  AT+CDP=0 ~/~/ Clear cached data
521 521  
522 522  
523 -== 2.11 Calibration ==
480 +**2.11 Calibration**
524 524  
525 525  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).
526 526  
... ... @@ -528,21 +528,21 @@
528 528  
529 529  [[image:image-20220907154700-20.png]] ​
530 530  
531 -== 2.12  ​Firmware Change Log ==
488 +**2.8  ​Firmware Change Log**
532 532  
533 533  Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]]
534 534  
535 535  Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
536 536  
537 -== 2.13  ​Battery Analysis ==
494 +**2.9  ​Battery Analysis**
538 538  
539 -=== 2.13.1  ​Battery Type ===
496 +**2.9.1  ​Battery Type**
540 540  
541 541  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.
542 542  
543 543  The battery is designed to last for several years depends on the actually use environment and update interval. 
544 544  
545 -The battery-related documents as below:
502 +The battery related documents as below:
546 546  
547 547  * [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
548 548  * [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
... ... @@ -550,7 +550,7 @@
550 550  
551 551  [[image:image-20220907154700-21.png]] ​
552 552  
553 -=== 2.13.2  Power consumption Analyze ===
510 +**2.9.2  Power consumption Analyze**
554 554  
555 555  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.
556 556  
... ... @@ -571,15 +571,15 @@
571 571  
572 572  ​
573 573  
574 -=== 2.13.3  ​Battery Note ===
531 +**2.9.3  ​Battery Note**
575 575  
576 576  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.
577 577  
578 -=== 2.13.4  Replace the battery ===
535 +**2.9.4  Replace the battery**
579 579  
580 580  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).
581 581  
582 -= 3. ​ Access NB-IoT Module =
539 +**3. ​ Access NB-IoT Module**
583 583  
584 584  Users can directly access the AT command set of the NB-IoT module.
585 585  
... ... @@ -590,9 +590,9 @@
590 590  
591 591  ​
592 592  
593 -= 4.  Using the AT Commands =
550 +**4.  Using the AT Commands**
594 594  
595 -== 4.1  Access AT Commands ==
552 +**4.1  Access AT Commands**
596 596  
597 597  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]]
598 598  
... ... @@ -630,18 +630,13 @@
630 630  
631 631  AT+TR      : Get or Set record time"
632 632  
633 -AT+APN     : Get or set the APN
634 634  
635 -AT+FBAND   : Get or Set whether to automatically modify the frequency band
636 -
637 -AT+DNSCFG  : Get or Set DNS Server
638 -
639 -AT+GETSENSORVALUE   : Returns the current sensor measurement
640 -
641 641  AT+NOUD      : Get or Set the number of data to be uploaded
642 642  
593 +
643 643  AT+CDP     : Read or Clear cached data
644 644  
596 +
645 645  AT+TEMPALARM      : Get or Set alarm of temp
646 646  
647 647  AT+PHALARM     : Get or Set alarm of PH
... ... @@ -675,9 +675,9 @@
675 675  
676 676  AT+PWORD  : Serial Access Password
677 677  
678 -= ​5.  FAQ =
630 +**​5.  FAQ**
679 679  
680 -== 5.1 ​ How to Upgrade Firmware ==
632 +**5.1 ​ How to Upgrade Firmware**
681 681  
682 682  User can upgrade the firmware for 1) bug fix, 2) new feature release.
683 683  
... ... @@ -685,29 +685,29 @@
685 685  
686 686  **Notice, **NSPH01 **and **NSPH01 **share the same mother board. They use the same connection and method to update.**
687 687  
688 -== 5.2  Can I calibrate NSPH01 to different soil types? ==
640 +**5.2  Can I calibrate NSPH01 to different soil types?**
689 689  
690 690  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]].
691 691  
692 -= 6.  Trouble Shooting =
644 +**6.  Trouble Shooting**
693 693  
694 -== 6.1  ​Connection problem when uploading firmware ==
646 +**6.1  ​Connection problem when uploading firmware**
695 695  
696 696  **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]]
697 697  
698 -== 6.2  AT Command input doesn't work ==
650 +**6.2  AT Command input doesn't work**
699 699  
700 700  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.
701 701  
702 -= 7. ​ Order Info =
654 +**7. ​ Order Info**
703 703  
704 704  Part Number**:** NSPH01
705 705  
706 -= 8.  Packing Info =
658 +**8.  Packing Info**
707 707  
708 708  **Package Includes**:
709 709  
710 -* NSPH01 NB-IoT pH Sensor x 1
662 +* NSPH01 NB-IoT Soil Moisture & EC Sensor x 1
711 711  * External antenna x 1
712 712  
713 713  **Dimension and weight**:
... ... @@ -715,7 +715,7 @@
715 715  * Size: 195 x 125 x 55 mm
716 716  * Weight:   420g
717 717  
718 -= 9.  Support =
670 +**9.  Support**
719 719  
720 720  * 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.
721 721  * 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]]
image-20220912144017-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -149.6 KB
Content
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0