Last modified by Bei Jinggeng on 2024/03/30 17:53
<
From version < 48.1 >
edited by Edwin Chen
on 2022/09/08 00:30
To version < 51.3 >
edited by Xiaoling
on 2022/09/12 15:01
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
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,32 @@
7 7  
8 8  
9 9  
10 -= 1. Introduction =
10 += 1.  Introduction =
11 11  
12 -== 1.1 ​What is NSPH01 Soil pH Sensor ==
13 13  
14 -The Dragino NSPH01 is a **NB-IoT soil pH sensor** for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
13 +== 1.1 ​ What is NSPH01 Soil pH Sensor ==
15 15  
16 -NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** pH **with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use.
17 17  
16 +The Dragino NSPH01 is a (% style="color:blue" %)**NB-IoT soil pH sensor**(%%) for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof.
17 +
18 +NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:blue" %)pH (%%)**with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use.
19 +
18 18  NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage.
19 -\\NSPH01 supports different uplink methods include **TCP,MQTT,UDP and CoAP  **for different application requirement.
20 -\\NSPH01 is powered by **8500mAh Li-SOCI2 battery**, It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
21 -\\To use NSPH01, user needs to check if there is NB-IoT coverage in 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 +\\NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP  **(%%)for different application requirement.
22 +\\NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method)
23 +\\To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection.
22 22  
23 -(% style="text-align:center" %)
25 +
24 24  [[image:image-20220907153151-1.png]]
25 25  
26 -(% style="text-align:center" %)
28 +
27 27  [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]]
28 28  
29 -== 1.2 Features ==
30 30  
32 +
33 +== 1.2  Features ==
34 +
35 +
31 31  * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD
32 32  * Monitor soil pH with temperature compensation.
33 33  * Monitor soil temperature
... ... @@ -45,12 +45,13 @@
45 45  
46 46  == 1.3  Specification ==
47 47  
48 -**Common DC Characteristics:**
49 49  
54 +(% style="color:#037691" %)**Common DC Characteristics:**
55 +
50 50  * Supply Voltage: 2.1v ~~ 3.6v
51 51  * Operating Temperature: -40 ~~ 85°C
52 52  
53 -**NB-IoT Spec:**
59 +(% style="color:#037691" %)**NB-IoT Spec:**
54 54  
55 55  * - B1 @H-FDD: 2100MHz
56 56  * - B3 @H-FDD: 1800MHz
... ... @@ -59,10 +59,11 @@
59 59  * - B20 @H-FDD: 800MHz
60 60  * - B28 @H-FDD: 700MHz
61 61  
62 -== 1.4 Probe Specification ==
68 +== 1.4  Probe Specification ==
63 63  
64 -**Soil pH:**
65 65  
71 +(% style="color:#037691" %)**Soil pH:**
72 +
66 66  * Range: 3 ~~ 10 pH
67 67  * Resolution: 0.01 pH
68 68  * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen)
... ... @@ -70,7 +70,7 @@
70 70  * IP68 Protection
71 71  * Length: 3.5 meters
72 72  
73 -**Soil Temperature:**
80 +(% style="color:#037691" %)**Soil Temperature:**
74 74  
75 75  * Range -40℃～85℃
76 76  * Resolution: 0.1℃
... ... @@ -84,25 +84,32 @@
84 84  
85 85  == 1.6 Pin mapping and power on ==
86 86  
87 -(% style="text-align:center" %)
94 +
88 88  [[image:image-20220907153300-2.png]]
89 89  
90 90  
98 +
91 91  = 2.  Use NSPH01 to communicate with IoT Server =
92 92  
101 +
93 93  == 2.1  How it works ==
94 94  
104 +
95 95  The NSPH01 is equipped with a NB-IoT module, the pre-loaded firmware in NSPH01 will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module.  The NB-IoT network will forward this value to IoT server via the protocol defined by NSPH01.
96 96  
97 97  The diagram below shows the working flow in default firmware of NSPH01:
98 98  
99 -(% style="text-align:center" %)
109 +
100 100  [[image:image-20220907153416-3.png]]
101 101  
112 +
113 +
102 102  == 2.2 ​ Configure the NSPH01 ==
103 103  
116 +
104 104  === 2.2.1 Test Requirement ===
105 105  
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.
... ... @@ -111,77 +111,91 @@
111 111  
112 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.
113 113  
114 -(% style="text-align:center" %)
128 +
115 115  [[image:image-20220907153445-4.png]]
116 116  
117 117  
132 +
118 118  === 2.2.2 Insert SIM card ===
119 119  
135 +
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" %)
123 123  [[image:image-20220907153505-5.png]]
124 124  
140 +
141 +
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:**
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.
130 130  
131 - USB TTL GND <~-~-~-~-> GND
132 132  
133 - USB TTL TXD <~-~-~-~-> UART_RXD
148 +(% style="color:blue" %)**Connection:**
134 134  
135 - USB TTL RXD <~-~-~-~-> UART_TXD
150 +**~ (% style="background-color:yellow" %) USB TTL GND <~-~-~-~->  GND(%%)**
136 136  
152 +**~ (% style="background-color:yellow" %) USB TTL TXD  <~-~-~-~->  UART_RXD(%%)**
153 +
154 +**~ (% style="background-color:yellow" %) USB TTL RXD  <~-~-~-~->  UART_TXD(%%)**
155 +
156 +
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**
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 +*
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.
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.
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]]
169 +[[image:image-20220912144017-1.png]]
151 151  
171 +
172 +(% style="color:red" %)**Note: the valid AT Commands can be found at:**(%%)**  **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]]
173 +
174 +
175 +
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:**
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/]]
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  
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 +
162 162  For parameter description, please refer to AT command set
163 163  
164 -(% style="text-align:center" %)
190 +
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" %)
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 +
170 170  [[image:image-20220907153612-8.png||height="529" width="729"]]
171 171  
172 172  
200 +
173 173  === 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
174 174  
203 +
175 175  This feature is supported since firmware version v1.0.1
205 +(%%)
206 +* **(% style="color:blue" %)AT+PRO=2   ** ~/~/  Set to use UDP protocol to uplink
207 +* **(% style="color:blue" %)AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/  to set UDP server address and port
208 +* **(% style="color:blue" %)AT+CFM=1       ** (%%) ~/~/  If the server does not respond, this command is unnecessar
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
180 -
181 -(% style="text-align:center" %)
182 182  [[image:image-20220907153643-9.png||height="401" width="734"]]
183 183  
184 -(% style="text-align:center" %)
212 +
185 185  [[image:image-20220907153703-10.png||height="309" width="738"]]
186 186  
187 187  
... ... @@ -189,42 +189,48 @@
189 189  
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
220 +* **(% style="color:blue" %)AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
221 +* **(% style="color:blue" %)AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
222 +* **(% style="color:blue" %)AT+CLIENT=CLIENT       ** (%%) ~/~/Set up the CLIENT of MQTT
223 +* **(% style="color:blue" %)AT+UNAME=UNAME                               ** (%%)~/~/Set the username of MQTT
224 +* **(% style="color:blue" %)AT+PWD=PWD                                        ** (%%)~/~/Set the password of MQTT
225 +* **(% style="color:blue" %)AT+PUBTOPIC=NSE01_PUB                    **(%%) ~/~/Set the sending topic of MQTT
226 +* **(% style="color:blue" %)AT+SUBTOPIC=NSE01_SUB          ** (%%) ~/~/Set the subscription topic of MQTT
199 199  
200 -(% style="text-align:center" %)
228 +
201 201  [[image:image-20220907153739-11.png||height="491" width="764"]]
202 202  
203 -(% style="text-align:center" %)
231 +
204 204  [[image:image-20220907153751-12.png||height="555" width="769"]]
205 205  
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  
236 +
237 +
238 +
208 208  === 2.2.7 Use TCP protocol to uplink data ===
209 209  
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
243 +* **(% style="color:blue" %)AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
244 +* **(% style="color:blue" %)AT+SERVADDR=120.24.4.116,5600   ** (%%) ~/~/ to set TCP server address and port
214 214  
215 -(% style="text-align:center" %)
246 +
216 216  [[image:image-20220907153818-13.png||height="486" width="668"]]
217 217  
218 -(% style="text-align:center" %)
249 +
219 219  [[image:image-20220907153827-14.png||height="236" width="684"]]
220 220  
252 +
253 +
254 +
221 221  === 2.2.8 Change Update Interval ===
222 222  
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)
259 +* **(% 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).**
261 +**(% 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 ==
... ... @@ -244,19 +244,19 @@
244 244  
245 245  The payload is ASCII string, representative same HEX:
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" %)0225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859(%%) where:
281 +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:
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(%%)
283 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138
284 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0
285 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V
286 +* (% style="color:red" %)Singal: 0x17 = 23
287 +* (% style="color:blue" %)Mod: 0x01 = 1
288 +* (% style="color:green" %)Interrupt: 0x00= 0
255 255  * Soil PH: 0x0225= 549 = 5.49
256 256  * Soil Temperature:0x010B =267=26.7 °C
257 257  * Time stamp : 0x6315537b =1662342011  ([[Unix Epoch Time>>url:http://www.epochconverter.com/]])
258 258  * Soil Temperature,Soil PH,Time stamp : 010b0226631550fb
259 -* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......(%%)
293 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......
260 260  
261 261  == 2.4  Payload Explanation and Sensor Interface ==
262 262  
... ... @@ -264,7 +264,7 @@
264 264  
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
301 +User can use **(% style="color:blue" %)AT+DEUI** (%%)to set Device ID
268 268  
269 269  **Example:**
270 270  
... ... @@ -588,13 +588,18 @@
588 588  
589 589  AT+TR      : Get or Set record time"
590 590  
625 +AT+APN     : Get or set the APN
591 591  
592 -AT+NOUD      : Get or Set the number of data to be uploaded
627 +AT+FBAND   : Get or Set whether to automatically modify the frequency band
593 593  
629 +AT+DNSCFG  : Get or Set DNS Server
594 594  
595 -AT+CDP     : Read or Clear cached data
631 +AT+GETSENSORVALUE   : Returns the current sensor measurement
596 596  
633 +AT+NOUD      : Get or Set the number of data to be uploaded
597 597  
635 +AT+CDP     : Read or Clear cached data
636 +
598 598  AT+TEMPALARM      : Get or Set alarm of temp
599 599  
600 600  AT+PHALARM     : Get or Set alarm of PH
image-20220912144017-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +149.6 KB
Content

Applications

Navigation

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