Last modified by Bei Jinggeng on 2024/03/30 17:53
<
From version < 50.1 >
edited by David Huang
on 2022/09/08 09:48
To version < 56.9 >
edited by Xiaoling
on 2023/04/04 08:50
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.David
1 +XWiki.Xiaoling
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,27 +7,33 @@
7 7  
8 8  
9 9  
10 -= 1. Introduction =
10 += 1.  Introduction =
11 11  
12 -== 1.1 ​What is NSPH01 Soil pH Sensor ==
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.
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.
15 +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 17  
17 +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.
18 +
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 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.
22 22  
23 -(% style="text-align:center" %)
21 +NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
22 +
23 +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)
24 +
25 +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.
26 +
27 +
24 24  [[image:image-20220907153151-1.png]]
25 25  
26 -(% style="text-align:center" %)
30 +
27 27  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
28 28  
29 -== 1.2 Features ==
30 30  
34 +== 1.2  Features ==
35 +
36 +
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
... ... @@ -45,24 +45,26 @@
45 45  
46 46  == 1.3  Specification ==
47 47  
48 -**Common DC Characteristics:**
49 49  
55 +(% style="color:#037691" %)**Common DC Characteristics:**
56 +
50 50  * Supply Voltage: 2.1v ~~ 3.6v
51 51  * Operating Temperature: -40 ~~ 85°C
52 52  
53 -**NB-IoT Spec:**
60 +(% style="color:#037691" %)**NB-IoT Spec:**
54 54  
55 -* - B1 @H-FDD: 2100MHz
56 -* - B3 @H-FDD: 1800MHz
57 -* - B8 @H-FDD: 900MHz
58 -* - B5 @H-FDD: 850MHz
59 -* - B20 @H-FDD: 800MHz
60 -* - B28 @H-FDD: 700MHz
62 +* B1 @H-FDD: 2100MHz
63 +* B3 @H-FDD: 1800MHz
64 +* B8 @H-FDD: 900MHz
65 +* B5 @H-FDD: 850MHz
66 +* B20 @H-FDD: 800MHz
67 +* B28 @H-FDD: 700MHz
61 61  
62 -== 1.4 Probe Specification ==
69 +== 1.4  Probe Specification ==
63 63  
64 -**Soil pH:**
65 65  
72 +(% style="color:#037691" %)**Soil pH:**
73 +
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:**
81 +(% style="color:#037691" %)**Soil Temperature:**
74 74  
75 75  * Range -40℃～85℃
76 76  * Resolution: 0.1℃
... ... @@ -78,31 +78,37 @@
78 78  * IP68 Protection
79 79  * Length: 3.5 meters
80 80  
81 -== 1.5 ​Applications ==
89 +== 1.5  ​Applications ==
82 82  
91 +
83 83  * Smart Agriculture
84 84  
85 -== 1.6 Pin mapping and power on ==
94 +== 1.6  Pin mapping and power on ==
86 86  
87 -(% style="text-align:center" %)
96 +
88 88  [[image:image-20220907153300-2.png]]
89 89  
90 90  
100 +
91 91  = 2.  Use NSPH01 to communicate with IoT Server =
92 92  
93 93  == 2.1  How it works ==
94 94  
105 +
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" %)
110 +
100 100  [[image:image-20220907153416-3.png]]
101 101  
113 +
114 +
102 102  == 2.2 ​ Configure the NSPH01 ==
103 103  
104 104  === 2.2.1 Test Requirement ===
105 105  
119 +
106 106  To use NSPH01 in the field, make sure meet below requirements:
107 107  
108 108  * Your local operator has already distributed a NB-IoT Network there.
... ... @@ -109,163 +109,204 @@
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  
118 118  === 2.2.2 Insert SIM card ===
119 119  
134 +
120 120  User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%))
121 121  
122 -(% style="text-align:center" %)
137 +
123 123  [[image:image-20220907153505-5.png]]
124 124  
140 +
125 125  === 2.2.3 Connect USB – TTL to NSPH01 to configure it ===
126 126  
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.
128 128  
129 -**Connection:**
144 +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.
130 130  
131 - USB TTL GND <~-~-~-~-> GND
132 132  
133 - USB TTL TXD <~-~-~-~-> UART_RXD
147 +(% style="color:blue" %)**Connection:**
134 134  
135 - USB TTL RXD <~-~-~-~-> UART_TXD
149 +**~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
136 136  
151 +**~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
152 +
153 +**~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
154 +
155 +
137 137  In the PC, use below serial tool settings:
138 138  
139 -* Baud:  **9600**
140 -* Data bits:** 8**
141 -* Stop bits: **1**
142 -* Parity:  **None**
143 -* Flow Control: **None**
158 +* Baud:  (% style="color:green" %)**9600**
159 +* Data bits:**  (% style="color:green" %)8(%%)**
160 +* Stop bits:  (% style="color:green" %)**1**
161 +* Parity:  (% style="color:green" %)**None**
162 +* Flow Control: (% style="color:green" %)**None**
144 144  
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.
164 +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.
146 146  
147 -(% style="text-align:center" %)
148 -[[image:image-20220907153529-6.png]]
149 149  
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]]
167 +[[image:image-20220912144017-1.png]]
151 151  
169 +
170 +(% 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]]
171 +
172 +
152 152  === 2.2.4 Use CoAP protocol to uplink data ===
153 153  
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/]]
155 155  
156 -**Use below commands:**
176 +(% 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/]]
157 157  
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
161 161  
179 +(% style="color:blue" %)**Use below commands:**
180 +
181 +* (% style="color:#037691" %)**AT+PRO=1**                         (%%) ~/~/  Set to use CoAP protocol to uplink
182 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%) ~/~/  to set CoAP server address and port
183 +* (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/  Set COAP resource path
184 +
162 162  For parameter description, please refer to AT command set
163 163  
164 -(% style="text-align:center" %)
187 +
165 165  [[image:image-20220907153551-7.png||height="502" width="740"]]
166 166  
167 -After configure the server address and **reset the device** (via AT+ATZ ), NSPH01 will start to uplink sensor values to CoAP server.
168 168  
169 -(% style="text-align:center" %)
191 +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.
192 +
193 +
170 170  [[image:image-20220907153612-8.png||height="529" width="729"]]
171 171  
172 172  
173 173  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
174 174  
199 +
175 175  This feature is supported since firmware version v1.0.1
176 176  
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
202 +* (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/  Set to use UDP protocol to uplink
203 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
204 +* (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
180 180  
181 -(% style="text-align:center" %)
182 182  [[image:image-20220907153643-9.png||height="401" width="734"]]
183 183  
184 -(% style="text-align:center" %)
208 +
185 185  [[image:image-20220907153703-10.png||height="309" width="738"]]
186 186  
187 187  
188 188  === 2.2.6 Use MQTT protocol to uplink data ===
189 189  
214 +
190 190  This feature is supported since firmware version v110
191 191  
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
217 +* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/ Set to use MQTT protocol to uplink
218 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/ Set MQTT server address and port
219 +* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%) ~/~/ Set up the CLIENT of MQTT
220 +* (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/ Set the username of MQTT
221 +* (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/ Set the password of MQTT
222 +* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/ Set the sending topic of MQTT
223 +* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/ Set the subscription topic of MQTT
199 199  
200 -(% style="text-align:center" %)
201 201  [[image:image-20220907153739-11.png||height="491" width="764"]]
202 202  
203 -(% style="text-align:center" %)
227 +
204 204  [[image:image-20220907153751-12.png||height="555" width="769"]]
205 205  
230 +
206 206  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.
207 207  
233 +
208 208  === 2.2.7 Use TCP protocol to uplink data ===
209 209  
236 +
210 210  This feature is supported since firmware version v110
211 211  
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
239 +* (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
240 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
214 214  
215 -(% style="text-align:center" %)
216 216  [[image:image-20220907153818-13.png||height="486" width="668"]]
217 217  
218 -(% style="text-align:center" %)
244 +
219 219  [[image:image-20220907153827-14.png||height="236" width="684"]]
220 220  
247 +
221 221  === 2.2.8 Change Update Interval ===
222 222  
250 +
223 223  Users can use the below command to change the **uplink interval**.
224 224  
225 -* **AT+TDC=7200      ** ~/~/ Set Update Interval to 7200s (2 hour)
253 +* (% style="color:blue" %)**AT+TDC=7200      ** (%%) ~/~/ Set Update Interval to 7200s (2 hour)
226 226  
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).**
255 +(% 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).**
228 228  
229 229  
230 230  == 2.3  Uplink Payload ==
231 231  
260 +
232 232  In this mode, uplink payload includes 87 bytes in total by default.
233 233  
234 234  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.
235 235  
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  .....
265 +(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %)
266 +|=(% 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**
267 +|=(% 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  .....
238 238  
239 239  If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data.
240 240  
241 -(% style="text-align:center" %)
242 242  [[image:image-20220907153902-15.png||height="581" width="804"]]
243 243  
244 244  
274 +(((
245 245  The payload is ASCII string, representative same HEX:
276 +)))
246 246  
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:
278 +(((
279 +
280 +)))
248 248  
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,.......
282 +(((
283 +**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__//(%%)**
284 +)))
260 260  
286 +(((
287 +
288 +
289 +**where:**
290 +)))
291 +
292 +* (% style="color:#037691" %)**Device ID:**(%%)** **0xf868411056754138 = f868411056754138
293 +
294 +* (% style="color:#037691" %)**Version:**  (%%) 0x0064=100=1.0.0
295 +
296 +* (% style="color:#037691" %)**BAT:**   (%%) 0x0c78 = 3192 mV = 3.192V
297 +
298 +* (% style="color:#037691" %)**Singal:** (%%)0x17 = 23
299 +
300 +* (% style="color:#037691" %)**Mod:** (%%) 0x01 = 1
301 +
302 +* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0
303 +
304 +* (% style="color:#037691" %)**Soil PH:** (%%) 0x0225= 549 = 5.49
305 +
306 +* (% style="color:#037691" %)**Soil Temperature:**(%%) 0x010b =267=26.7 °C
307 +
308 +* (% style="color:#037691" %)**Time stamp :**   (%%) 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
309 +
310 +* (% style="color:#037691" %)**Soil Temperature,Soil PH,Time stamp : **(%%) 010b0226631550fb
311 +
312 +* (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp :  010e022663154d77,.......
313 +
261 261  == 2.4  Payload Explanation and Sensor Interface ==
262 262  
263 263  === 2.4.1  Device ID ===
264 264  
318 +
265 265  By default, the Device ID equal to the last 15 bits of IMEI.
266 266  
267 -User can use **AT+DEUI** to set Device ID
321 +User can use (% style="color:blue" %)**AT+DEUI** (%%)to set Device ID
268 268  
323 +
269 269  **Example:**
270 270  
271 271  AT+DEUI=868411056754138
... ... @@ -272,14 +272,18 @@
272 272  
273 273  The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID.
274 274  
330 +
275 275  === 2.4.2  Version Info ===
276 276  
333 +
277 277  Specify the software version: 0x64=100, means firmware version 1.00.
278 278  
279 279  For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0.
280 280  
338 +
281 281  === 2.4.3  Battery Info ===
282 282  
341 +
283 283  Check the battery voltage for NSPH01.
284 284  
285 285  Ex1: 0x0B45 = 2885mV
... ... @@ -286,8 +286,10 @@
286 286  
287 287  Ex2: 0x0B49 = 2889mV
288 288  
348 +
289 289  === 2.4.4  Signal Strength ===
290 290  
351 +
291 291  NB-IoT Network signal Strength.
292 292  
293 293  **Ex1: 0x1d = 29**
... ... @@ -302,18 +302,23 @@
302 302  
303 303  **99**    Not known or not detectable
304 304  
366 +
305 305  === 2.4.5  Soil PH ===
306 306  
369 +
307 307  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.
308 308  
309 -For example, if the data you get from the register is **__0x05 0xDC__**, the PH content in the soil is
372 +For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is
310 310  
311 -**0229(H) = 549(D) /100 = 5.49.**
374 +(% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**
312 312  
376 +
313 313  === 2.4.6  Soil Temperature ===
314 314  
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
316 316  
380 +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
381 +
382 +
317 317  **Example**:
318 318  
319 319  If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C
... ... @@ -320,35 +320,42 @@
320 320  
321 321  If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C
322 322  
389 +
323 323  === 2.4.7  Timestamp ===
324 324  
392 +
325 325  Time stamp : 0x6315537b =1662342011
326 326  
327 327  Convert Unix timestamp to time 2022-9-5 9:40:11.
328 328  
397 +
329 329  === 2.4.8  Digital Interrupt ===
330 330  
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.
332 332  
401 +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.
402 +
333 333  The command is:
334 334  
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]])**.**
405 +(% 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]])**.**
336 336  
337 337  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.
338 338  
339 -Example:
340 340  
410 +**Example:**
411 +
341 341  0x(00): Normal uplink packet.
342 342  
343 343  0x(01): Interrupt Uplink Packet.
344 344  
416 +
345 345  === 2.4.9  ​+5V Output ===
346 346  
419 +
347 347  NSPH01 will enable +5V output before all sampling and disable the +5v after all sampling. 
348 348  
349 349  The 5V output time can be controlled by AT Command.
350 350  
351 -**AT+5VT=1000**
424 +(% style="color:blue" %)**AT+5VT=1000**
352 352  
353 353  Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** **
354 354  
... ... @@ -355,21 +355,16 @@
355 355  
356 356  == 2.5  Downlink Payload ==
357 357  
431 +
358 358  By default, NSPH01 prints the downlink payload to console port.
359 359  
360 -(% style="text-align:center" %)
361 361  [[image:image-20220907154636-17.png]]
362 362  
363 363  
437 +(% style="color:blue" %)**Examples:**
364 364  
439 +* (% style="color:#037691" %)** Set TDC**
365 365  
366 -
367 -
368 -
369 -**Examples:**
370 -
371 -* **Set TDC**
372 -
373 373  If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01.
374 374  
375 375  Payload:    01 00 00 1E    TDC=30S
... ... @@ -376,16 +376,18 @@
376 376  
377 377  Payload:    01 00 00 3C    TDC=60S
378 378  
379 -* **Reset**
447 +* (% style="color:#037691" %)** Reset**
380 380  
381 381  If payload = 0x04FF, it will reset the NSPH01
382 382  
383 -* **INTMOD**
451 +* (% style="color:#037691" %)** INTMOD**
384 384  
385 385  Downlink Payload: 06000003, Set AT+INTMOD=3
386 386  
455 +
387 387  == 2.6  ​LED Indicator ==
388 388  
458 +
389 389  The NSPH01 has an internal LED which is to show the status of different state.
390 390  
391 391  * 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)
... ... @@ -393,16 +393,20 @@
393 393  * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds.
394 394  * For each uplink probe, LED will be on for 500ms.
395 395  
396 -== 2.7 Installation and Maintain ==
466 +== 2.7  Installation and Maintain ==
397 397  
398 -=== 2.7.1 Before measurement ===
468 +=== 2.7.1  Before measurement ===
399 399  
470 +
400 400  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. 
401 401  
402 -=== 2.7.2 Measurement ===
403 403  
404 -**Measurement the soil surface:**
474 +=== 2.7.2  Measurement ===
405 405  
476 +
477 +(% style="color:#037691" %)**Measurement the soil surface:**
478 +
479 +
406 406  [[image:image-20220907154700-18.png]] ​
407 407  
408 408  Choose the proper measuring position. Split the surface soil according to the measured deep.
... ... @@ -413,14 +413,17 @@
413 413  
414 414  Put soil over the probe after insert. And start to measure.
415 415  
416 -**Measurement inside soil:**
417 417  
491 +(% style="color:#037691" %)**Measurement inside soil:**
492 +
418 418  Dig a hole with diameter > 20CM.
419 419  
420 420  Insert the probe inside, method like measure the surface.
421 421  
422 -=== 2.7.3 Maintain Probe ===
423 423  
498 +=== 2.7.3  Maintain Probe ===
499 +
500 +
424 424  1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it.
425 425  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.
426 426  1. Probe reference electrode is also no strong, need to avoid strong force or hitting.
... ... @@ -428,12 +428,13 @@
428 428  1. Avoid the probes to touch oily matter. Which will cause issue in accuracy.
429 429  1. The probe is IP68 can be put in water.
430 430  
431 -== 2.8 PH and Temperature alarm function ==
508 +== 2.8  PH and Temperature alarm function ==
432 432  
433 -➢ AT Command:
434 434  
435 -AT+ PHALARM=min,max
511 +(% style="color:#037691" %)**➢ AT Command:**
436 436  
513 +(% style="color:blue" %)**AT+ PHALARM=min,max**
514 +
437 437  ² When min=3, and max≠0, Alarm higher than max
438 438  
439 439  ² When min≠0, and max=0, Alarm lower than min
... ... @@ -440,10 +440,11 @@
440 440  
441 441  ² When min≠0 and max≠0, Alarm higher than max or lower than min
442 442  
443 -Example:
444 444  
445 -AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5.
522 +(% style="color:blue" %)**Example:**
446 446  
524 +AT+ PHALARM =5,8  ~/~/ Alarm when PH lower than 5.
525 +
447 447  AT+ TEMPALARM=min,max
448 448  
449 449  ² When min=0, and max≠0, Alarm higher than max
... ... @@ -452,98 +452,71 @@
452 452  
453 453  ² When min≠0 and max≠0, Alarm higher than max or lower than min
454 454  
455 -Example:
456 456  
457 -AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20.
535 +(% style="color:blue" %)**Example:**
458 458  
537 +AT+ TEMPALARM=20,30  ~/~/ Alarm when temperature lower than 20.
459 459  
460 -== 2.9 Set the number of data to be uploaded and the recording time ==
461 461  
462 -➢ AT Command:
540 +== 2.9  Set the number of data to be uploaded and the recording time ==
463 463  
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)
465 465  
466 -AT+NOUD=8  ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
543 +(% style="color:#037691" %)**➢ AT Command:**
467 467  
545 +* (% 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)
546 +* (% 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.
468 468  
469 -== 2.10 Read or Clear cached data ==
548 + The diagram below explains the relationship between TR, NOUD, and TDC more clearly**:**
470 470  
471 -➢ AT Command:
550 +[[image:image-20221009000933-1.png||height="750" width="1043"]]
472 472  
473 -AT+CDP ~/~/ Read cached data
474 474  
475 -[[image:image-20220907154700-19.png]]
553 +== 2.10  Read or Clear cached data ==
476 476  
477 477  
478 -AT+CDP=0 ~/~/ Clear cached data
556 +(% style="color:#037691" %)**➢ AT Command:**
479 479  
558 +* (% style="color:blue" %)**AT+CDP**        (%%) ~/~/  Read cached data
559 +* (% style="color:blue" %)**AT+CDP=0**    (%%) ~/~/  Clear cached data
480 480  
481 -== 2.11 Calibration ==
561 +[[image:image-20220907154700-19.png]]
482 482  
483 -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).
484 484  
485 -After stable, user can use below command to calibrate.
564 +== 2.11  Calibration ==
486 486  
487 -[[image:image-20220907154700-20.png]] ​
488 488  
489 -== 2.12  ​Firmware Change Log ==
567 +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).
490 490  
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]]
569 +After stable, user can use below command to calibrate.
492 492  
493 -Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]]
494 494  
495 -== 2.13  ​Battery Analysis ==
572 +[[image:image-20220907154700-20.png]] ​
496 496  
497 -=== 2.13.1  ​Battery Type ===
498 498  
499 -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.
575 +== 2.12  ​Firmware Change Log ==
500 500  
501 -The battery is designed to last for several years depends on the actually use environment and update interval. 
502 502  
503 -The battery-related documents as below:
578 +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]]
504 504  
505 -* [[Battery Dimension>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
506 -* [[Lithium-Thionyl Chloride Battery datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
507 -* [[Lithium-ion Battery-Capacitor datasheet>>url:http://www.dragino.com/downloads/index.php?dir=datasheet/Battery/ER26500/]]
580 +Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]]
508 508  
509 -[[image:image-20220907154700-21.png]] ​
510 510  
511 -=== 2.13.2  Power consumption Analyze ===
583 +== 2.13 Battery & Power Consumption ==
512 512  
513 -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.
514 514  
515 -Instruction to use as below:
586 +NSPH01 uses ER26500 + SPC1520 battery pack. See below link for detail information about the battery info and how to replace.
516 516  
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/]]
588 +[[**Battery Info & Power Consumption Analyze**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20calculate%20the%20battery%20life%20of%20Dragino%20sensors%3F/]] .
518 518  
519 -**Step 2: ** Open it and choose
520 520  
521 -* Product Model
522 -* Uplink Interval
523 -* Working Mode
524 -
525 -And the Life expectation in difference case will be shown on the right.
526 -
527 -(% style="text-align:center" %)
528 -[[image:image-20220907154700-22.jpeg]]
529 -
530 -​
531 -
532 -=== 2.13.3  ​Battery Note ===
533 -
534 -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.
535 -
536 -=== 2.13.4  Replace the battery ===
537 -
538 -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).
539 -
540 540  = 3. ​ Access NB-IoT Module =
541 541  
593 +
542 542  Users can directly access the AT command set of the NB-IoT module.
543 543  
544 544  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/]] 
545 545  
546 -(% style="text-align:center" %)
598 +
547 547  [[image:image-20220907154700-23.png]]
548 548  
549 549  ​
... ... @@ -552,6 +552,7 @@
552 552  
553 553  == 4.1  Access AT Commands ==
554 554  
607 +
555 555  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]]
556 556  
557 557  AT+<CMD>?  : Help on <CMD>
... ... @@ -562,8 +562,9 @@
562 562  
563 563  AT+<CMD>=?  : Get the value
564 564  
565 -**General Commands**      
566 566  
619 +(% style="color:#037691" %)**General Commands**      
620 +
567 567  AT  : Attention       
568 568  
569 569  AT?  : Short Help     
... ... @@ -607,16 +607,18 @@
607 607  AT+ PHCAL  : calibrate PH value
608 608  
609 609  
610 -**COAP Management**      
664 +(% style="color:#037691" %)**COAP Management**      
611 611  
612 612  AT+URI            : Resource parameters
613 613  
614 -**UDP Management**
615 615  
669 +(% style="color:#037691" %)**UDP Management**
670 +
616 616  AT+CFM          : Upload confirmation mode (only valid for UDP)
617 617  
618 -**MQTT Management**
619 619  
674 +(% style="color:#037691" %)**MQTT Management**
675 +
620 620  AT+CLIENT               : Get or Set MQTT client
621 621  
622 622  AT+UNAME  : Get or Set MQTT Username
... ... @@ -627,42 +627,56 @@
627 627  
628 628  AT+SUBTOPIC  : Get or Set MQTT subscription topic
629 629  
630 -**Information**          
631 631  
687 +(% style="color:#037691" %)**Information**          
688 +
632 632  AT+FDR  : Factory Data Reset
633 633  
634 634  AT+PWORD  : Serial Access Password
635 635  
693 +
636 636  = ​5.  FAQ =
637 637  
638 638  == 5.1 ​ How to Upgrade Firmware ==
639 639  
698 +
640 640  User can upgrade the firmware for 1) bug fix, 2) new feature release.
641 641  
642 642  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]]
643 643  
644 -**Notice, **NSPH01 **and **NSPH01 **share the same mother board. They use the same connection and method to update.**
703 +(% style="color:red" %)**Notice, NSPH01 and LSPH01 share the same mother board. They use the same connection and method to update.**
645 645  
705 +
646 646  == 5.2  Can I calibrate NSPH01 to different soil types? ==
647 647  
708 +
648 648  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]].
649 649  
711 +
650 650  = 6.  Trouble Shooting =
651 651  
652 652  == 6.1  ​Connection problem when uploading firmware ==
653 653  
716 +
654 654  **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]]
655 655  
719 +
656 656  == 6.2  AT Command input doesn't work ==
657 657  
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.
659 659  
723 +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.
724 +
725 +
660 660  = 7. ​ Order Info =
661 661  
728 +
662 662  Part Number**:** NSPH01
663 663  
731 +
732 +
664 664  = 8.  Packing Info =
665 665  
735 +
666 666  **Package Includes**:
667 667  
668 668  * NSPH01 NB-IoT pH Sensor x 1
... ... @@ -670,11 +670,14 @@
670 670  
671 671  **Dimension and weight**:
672 672  
673 -* Size: 195 x 125 x 55 mm
674 -* Weight:   420g
743 +* Device Size: cm
744 +* Device Weight: g
745 +* Package Size / pcs : cm
746 +* Weight / pcs : g
675 675  
676 676  = 9.  Support =
677 677  
750 +
678 678  * 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.
679 679  * 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]]
680 680  
image-20220912144017-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +149.6 KB
Content
image-20220923101327-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +12.1 KB
Content
image-20221009000933-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +282.9 KB
Content

Applications

Navigation

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