Changes for page NSPH01-NB-IoT Soil pH Sensor User Manual
Last modified by Bei Jinggeng on 2024/03/30 17:53
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 3 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - Content
-
... ... @@ -1,5 +1,5 @@ 1 1 (% style="text-align:center" %) 2 -[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png ||height="442" width="410"]]2 +[[image:)YK]Y_LZJIO]J2~~VA}OQJM2.png]] 3 3 4 4 **Table of Contents:** 5 5 ... ... @@ -7,35 +7,27 @@ 7 7 8 8 9 9 10 -= 1. 10 += 1. Introduction = 11 11 12 +== 1.1 What is NSPH01 Soil pH Sensor == 12 12 13 - == 1.1 WhatisNSPH01Soil pHSensor==14 +The Dragino NSPH01 is a **NB-IoT soil pH sensor** for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof. 14 14 16 +NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** pH **with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use. 15 15 16 -The Dragino NSPH01 is a (% style="color:blue" %)**NB-IoT soil pH sensor**(%%) for IoT of Agriculture. It is designed to measure the soil pH and soil temperature, so to send to the platform to analyze the soil acid or alkali level. The probe is IP68 waterproof. 17 - 18 -NSPH01 probe is made by Solid AgCl reference electrode and Pure metal pH sensitive electrode. It can detect soil's** (% style="color:blue" %)pH (%%)**with high accuracy and stable value. The NSPH01 probe can be buried into soil for long time use. 19 - 20 20 NarrowBand-Internet of Things (NB-IoT) is a standards-based low power wide area (LPWA) technology developed to enable a wide range of new IoT devices and services. NB-IoT significantly improves the power consumption of user devices, system capacity and spectrum efficiency, especially in deep coverage. 19 +\\NSPH01 supports different uplink methods include **TCP,MQTT,UDP and CoAP **for different application requirement. 20 +\\NSPH01 is powered by **8500mAh Li-SOCI2 battery**, It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 21 +\\To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a **NB-IoT SIM card** from local operator and install NSPH01 to get NB-IoT network connection. 21 21 22 -NSPH01 supports different uplink methods include (% style="color:blue" %)**TCP,MQTT,UDP and CoAP **(%%)for different application requirement. 23 - 24 -NSPH01 is powered by (% style="color:blue" %)**8500mAh Li-SOCI2 battery**(%%), It is designed for long term use up to 5 years. (Actually Battery life depends on the use environment, update period & uplink method) 25 - 26 -To use NSPH01, user needs to check if there is NB-IoT coverage in the installation area and with the bands NSPH01 supports. If the local operator supports it, user needs to get a (% style="color:blue" %)**NB-IoT SIM card** (%%)from local operator and install NSPH01 to get NB-IoT network connection. 27 - 28 - 23 +(% style="text-align:center" %) 29 29 [[image:image-20220907153151-1.png]] 30 30 31 - 26 +(% style="text-align:center" %) 32 32 [[image:M_K`YF9`CAYAE\@}3T]FHT$9.png]] 33 33 29 +== 1.2 Features == 34 34 35 - 36 -== 1.2 Features == 37 - 38 - 39 39 * NB-IoT Bands: B1/B3/B8/B5/B20/B28 @H-FDD 40 40 * Monitor soil pH with temperature compensation. 41 41 * Monitor soil temperature ... ... @@ -51,17 +51,14 @@ 51 51 * Micro SIM card slot 52 52 * 8500mAh Battery for long term use 53 53 54 - 55 - 56 56 == 1.3 Specification == 57 57 48 +**Common DC Characteristics:** 58 58 59 -(% style="color:#037691" %)**Common DC Characteristics:** 60 - 61 61 * Supply Voltage: 2.1v ~~ 3.6v 62 62 * Operating Temperature: -40 ~~ 85°C 63 63 64 - (% style="color:#037691" %)**NB-IoT Spec:**53 +**NB-IoT Spec:** 65 65 66 66 * - B1 @H-FDD: 2100MHz 67 67 * - B3 @H-FDD: 1800MHz ... ... @@ -70,13 +70,10 @@ 70 70 * - B20 @H-FDD: 800MHz 71 71 * - B28 @H-FDD: 700MHz 72 72 62 +== 1.4 Probe Specification == 73 73 64 +**Soil pH:** 74 74 75 -== 1.4 Probe Specification == 76 - 77 - 78 -(% style="color:#037691" %)**Soil pH:** 79 - 80 80 * Range: 3 ~~ 10 pH 81 81 * Resolution: 0.01 pH 82 82 * Accuracy: ±2% under (0~~50 ℃, Accuracy will poor under 0 due to frozen) ... ... @@ -84,7 +84,7 @@ 84 84 * IP68 Protection 85 85 * Length: 3.5 meters 86 86 87 - (% style="color:#037691" %)**Soil Temperature:**73 +**Soil Temperature:** 88 88 89 89 * Range -40℃~85℃ 90 90 * Resolution: 0.1℃ ... ... @@ -92,43 +92,31 @@ 92 92 * IP68 Protection 93 93 * Length: 3.5 meters 94 94 81 +== 1.5 Applications == 95 95 96 - 97 -== 1.5 Applications == 98 - 99 - 100 100 * Smart Agriculture 101 101 85 +== 1.6 Pin mapping and power on == 102 102 103 - 104 -== 1.6 Pin mapping and power on == 105 - 106 - 87 +(% style="text-align:center" %) 107 107 [[image:image-20220907153300-2.png]] 108 108 109 109 110 - 111 111 = 2. Use NSPH01 to communicate with IoT Server = 112 112 113 - 114 114 == 2.1 How it works == 115 115 116 - 117 117 The NSPH01 is equipped with a NB-IoT module, the pre-loaded firmware in NSPH01 will get environment data from sensors and send the value to local NB-IoT network via the NB-IoT module. The NB-IoT network will forward this value to IoT server via the protocol defined by NSPH01. 118 118 119 119 The diagram below shows the working flow in default firmware of NSPH01: 120 120 121 - 99 +(% style="text-align:center" %) 122 122 [[image:image-20220907153416-3.png]] 123 123 124 - 125 - 126 126 == 2.2 Configure the NSPH01 == 127 127 128 - 129 129 === 2.2.1 Test Requirement === 130 130 131 - 132 132 To use NSPH01 in the field, make sure meet below requirements: 133 133 134 134 * Your local operator has already distributed a NB-IoT Network there. ... ... @@ -135,215 +135,163 @@ 135 135 * The local NB-IoT network used the band that NSPH01 supports. 136 136 * Your operator is able to distribute the data received in their NB-IoT network to your IoT server. 137 137 138 -Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSPH01 will use **CoAP(120.24.4.116:5683)**or raw**UDP(120.24.4.116:5601)**or**MQTT(120.24.4.116:1883)**or**TCP(120.24.4.116:5600)**protocol to send data to the test server.112 +Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8. The NSPH01 will use CoAP(120.24.4.116:5683) or raw UDP(120.24.4.116:5601) or MQTT(120.24.4.116:1883)or TCP(120.24.4.116:5600)protocol to send data to the test server. 139 139 140 - 114 +(% style="text-align:center" %) 141 141 [[image:image-20220907153445-4.png]] 142 142 143 143 144 - 145 145 === 2.2.2 Insert SIM card === 146 146 147 - 148 148 User need to take out the NB-IoT module and insert the SIM card like below. ((% style="color:red" %) Pay attention to the direction(%%)) 149 149 150 - 122 +(% style="text-align:center" %) 151 151 [[image:image-20220907153505-5.png]] 152 152 153 - 154 - 155 155 === 2.2.3 Connect USB – TTL to NSPH01 to configure it === 156 156 127 +User need to configure NSPH01 via serial port to set the **Server Address** / **Uplink Topic** to define where and how-to uplink packets. NSPH01 support AT Commands, user can use a USB to TTL adapter to connect to NSPH01 and use AT Commands to configure it, as below. 157 157 158 - User need to configure NSPH01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic**(%%) to define where and how-to uplink packets. NSPH01 support ATCommands, user canusea USB to TTL adapter toconnectto NSPH01 and use AT Commands to configure it, as below.129 +**Connection:** 159 159 131 + USB TTL GND <~-~-~-~-> GND 160 160 161 - (%style="color:blue"%)**Connection:**133 + USB TTL TXD <~-~-~-~-> UART_RXD 162 162 163 - **~(% style="background-color:yellow" %)USB TTLGND <~-~-~-~->GND(%%)**135 + USB TTL RXD <~-~-~-~-> UART_TXD 164 164 165 -**~ (% style="background-color:yellow" %) USB TTL TXD <~-~-~-~-> UART_RXD(%%)** 166 - 167 -**~ (% style="background-color:yellow" %) USB TTL RXD <~-~-~-~-> UART_TXD(%%)** 168 - 169 - 170 170 In the PC, use below serial tool settings: 171 171 172 -* Baud: (% style="color:green" %)**9600**173 -* Data bits:** (% style="color:green" %)8(%%)**174 -* Stop bits: (% style="color:green" %)**1**175 -* Parity: (% style="color:green" %)**None**176 -* Flow Control: (%style="color:green" %)**None**139 +* Baud: **9600** 140 +* Data bits:** 8** 141 +* Stop bits: **1** 142 +* Parity: **None** 143 +* Flow Control: **None** 177 177 178 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSPH01. NSPH01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%)to access AT Command input.145 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSPH01. NSPH01 will output system info once power on as below, we can enter the **password: 12345678** to access AT Command input. 179 179 147 +(% style="text-align:center" %) 148 +[[image:image-20220907153529-6.png]] 180 180 181 - [[image:image-20220912144017-1.png]]150 +**Note: the valid AT Commands can be found at: **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] 182 182 183 - 184 -(% style="color:red" %)**Note: the valid AT Commands can be found at:**(%%)** **[[**https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0**>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] 185 - 186 - 187 - 188 188 === 2.2.4 Use CoAP protocol to uplink data === 189 189 154 +**Note: if you don't have CoAP server, you can refer this link to set up one: **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]] 190 190 191 - (% style="color:red" %)**Note: if you don't have CoAPserver,you can refer thislink toset up one:**(%%)** **[[**http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/**>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]156 +**Use below commands:** 192 192 158 +* **AT+PRO=1** ~/~/ Set to use CoAP protocol to uplink 159 +* **AT+SERVADDR=120.24.4.116,5683 ** ~/~/ to set CoAP server address and port 160 +* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** ~/~/Set COAP resource path 193 193 194 -(% style="color:blue" %)**Use below commands:** 195 - 196 -* (% style="color:#037691" %)**AT+PRO=1** (%%) ~/~/ Set to use CoAP protocol to uplink 197 -* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683 ** (%%) ~/~/ to set CoAP server address and port 198 -* (% style="color:#037691" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/ Set COAP resource path 199 - 200 200 For parameter description, please refer to AT command set 201 201 202 - 164 +(% style="text-align:center" %) 203 203 [[image:image-20220907153551-7.png||height="502" width="740"]] 204 204 167 +After configure the server address and **reset the device** (via AT+ATZ ), NSPH01 will start to uplink sensor values to CoAP server. 205 205 206 -After configure the server address and (% style="color:green" %)**reset the device (via AT+ATZ )**(%%), NSPH01 will start to uplink sensor values to CoAP server. 207 - 208 - 169 +(% style="text-align:center" %) 209 209 [[image:image-20220907153612-8.png||height="529" width="729"]] 210 210 211 211 212 - 213 213 === 2.2.5 Use UDP protocol to uplink data(Default protocol) === 214 214 215 - 216 216 This feature is supported since firmware version v1.0.1 217 217 218 -* (% style="color:blue" %)**AT+PRO=2 **(%%)~/~/219 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601 **(%%)~/~/220 -* (% style="color:blue" %)**AT+CFM=1 **(%%)~/~/177 +* **AT+PRO=2 ** ~/~/ Set to use UDP protocol to uplink 178 +* **AT+SERVADDR=120.24.4.116,5601 ** ~/~/ to set UDP server address and port 179 +* **AT+CFM=1 ** ~/~/If the server does not respond, this command is unnecessar 221 221 181 +(% style="text-align:center" %) 222 222 [[image:image-20220907153643-9.png||height="401" width="734"]] 223 223 224 - 184 +(% style="text-align:center" %) 225 225 [[image:image-20220907153703-10.png||height="309" width="738"]] 226 226 227 227 228 - 229 229 === 2.2.6 Use MQTT protocol to uplink data === 230 230 231 - 232 232 This feature is supported since firmware version v110 233 233 234 -* (% style="color:blue" %)**AT+PRO=3 **(%%)~/~/235 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883 **(%%)~/~/236 -* (% style="color:blue" %)**AT+CLIENT=CLIENT **(%%)~/~/237 -* (% style="color:blue" %)**AT+UNAME=UNAME **(%%)~/~/238 -* (% style="color:blue" %)**AT+PWD=PWD **(%%)~/~/239 -* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB **(%%)~/~/240 -* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB **(%%)~/~/192 +* **AT+PRO=3 ** ~/~/Set to use MQTT protocol to uplink 193 +* **AT+SERVADDR=120.24.4.116,1883 ** ~/~/Set MQTT server address and port 194 +* **AT+CLIENT=CLIENT ** ~/~/Set up the CLIENT of MQTT 195 +* **AT+UNAME=UNAME **~/~/Set the username of MQTT 196 +* **AT+PWD=PWD **~/~/Set the password of MQTT 197 +* **AT+PUBTOPIC=NSE01_PUB **~/~/Set the sending topic of MQTT 198 +* **AT+SUBTOPIC=NSE01_SUB ** ~/~/Set the subscription topic of MQTT 241 241 200 +(% style="text-align:center" %) 242 242 [[image:image-20220907153739-11.png||height="491" width="764"]] 243 243 244 - 203 +(% style="text-align:center" %) 245 245 [[image:image-20220907153751-12.png||height="555" width="769"]] 246 246 247 - 248 248 MQTT protocol has a much higher power consumption compare vs UDP / CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval. 249 249 250 - 251 - 252 252 === 2.2.7 Use TCP protocol to uplink data === 253 253 254 - 255 255 This feature is supported since firmware version v110 256 256 257 -* (% style="color:blue" %)**AT+PRO=4 **(%%)~/~/ Set to use TCP protocol to uplink258 -* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600 **(%%)~/~/ to set TCP server address and port212 +* **AT+PRO=4 ** ~/~/ Set to use TCP protocol to uplink 213 +* **AT+SERVADDR=120.24.4.116,5600 ** ~/~/ to set TCP server address and port 259 259 215 +(% style="text-align:center" %) 260 260 [[image:image-20220907153818-13.png||height="486" width="668"]] 261 261 262 - 218 +(% style="text-align:center" %) 263 263 [[image:image-20220907153827-14.png||height="236" width="684"]] 264 264 265 - 266 - 267 267 === 2.2.8 Change Update Interval === 268 268 269 - 270 270 Users can use the below command to change the **uplink interval**. 271 271 272 -* (% style="color:blue" %)**AT+TDC=7200 **(%%)~/~/ Set Update Interval to 7200s (2 hour)225 +* **AT+TDC=7200 ** ~/~/ Set Update Interval to 7200s (2 hour) 273 273 274 - (% style="color:red" %)**NOTE: By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).**227 +**NOTE: By default, the device will send an uplink message every 2 hours. Each Uplink Include 8 set of records in this 2 hour (15 minute interval / record).** 275 275 276 276 277 - 278 278 == 2.3 Uplink Payload == 279 279 280 - 281 281 In this mode, uplink payload includes 87 bytes in total by default. 282 282 283 283 Each time the device uploads a data package, 8 sets of recorded data will be attached. Up to 32 sets of recorded data can be uploaded. 284 284 285 -(% border="1.5" style="background-color:#ffffcc; color:green; width:520px" %) 286 -|=(% scope="row" style="width: 50px;" %)**Size(bytes)**|(% style="width:40px" %)**8**|(% style="width:20px" %)**2**|(% style="width:25px" %)**2**|(% style="width:60px" %)**1**|(% style="width:20px" %)**1**|(% style="width:40px" %)**1**|(% style="width:40px" %)**2**|(% style="width:50px" %)**2**|(% style="width:50px" %)**4**|(% style="width:50px" %)**2**|(% style="width:35px" %)**2**|(% style="width:40px" %)**4** 287 -|=(% style="width: 96px;" %)**Value**|(% style="width:83px" %)Device ID|(% style="width:44px" %)Ver|(% style="width:42px" %)BAT|(% style="width:124px" %)Signal Strength|(% style="width:57px" %)MOD|(% style="width:80px" %)Interrupt|(% style="width:69px" %)Soil PH|(% style="width:134px" %)Soil Temperature|(% style="width:98px" %)Time stamp|(% style="width:134px" %)Soil Temperature|(% style="width:68px" %)Soil PH|(% style="width:125px" %)Time stamp ..... 236 +|**Size(bytes)**|**8**|**2**|**2**|1|1|1|2|2|4|2|2|4 237 +|**Value**|Device ID|Ver|BAT|Signal Strength|MOD|Interrupt|Soil PH|Soil Temperature|Time stamp|Soil Temperature|Soil PH|Time stamp ..... 288 288 289 289 If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSPH01 uplink data. 290 290 241 +(% style="text-align:center" %) 291 291 [[image:image-20220907153902-15.png||height="581" width="804"]] 292 292 293 293 294 -((( 295 295 The payload is ASCII string, representative same HEX: 296 -))) 297 297 298 -((( 299 - 300 -))) 247 +0x(% style="color:red" %)f868411056754138(%%)(% style="color:blue" %)0064(%%)(% style="color:green" %)0c78(%%)(% style="color:red" %)17(%%)(% style="color:blue" %)01(%%)(% style="color:green" %)00(%%)(% style="color:red" %)0225010b6315537b010b0226631550fb010e022663154d7701110225631549f1011502246315466b01190223631542e5011d022163153f62011e022163153bde011e022163153859(%%) where: 301 301 302 -((( 303 -**0x (% style="color:red" %)__f868411056754138__ (% style="color:blue" %)__0064 __ (% style="color:green" %)__0c78__ (% style="color:#00b0f0" %)__17__ (% style="color:#7030a0" %)__01__ (% style="color:#d60093" %)__00__ (% style="color:#a14d07" %)__0225 __ (% style="color:#0020b0" %) __010b__ (% style="color:#420042" %)__6315537b__ (% style="color:#663300" %)//__010b0226631550fb__ __010e022663154d77 01110225631549f1 011502246315466b 01190223631542e5 011d022163153f62 011e022163153bde 011e022163153859__//(%%)** 304 -))) 249 +* (% style="color:red" %)Device ID: 0xf868411056754138 = f868411056754138 (%%) 250 +* (% style="color:blue" %)Version: 0x0064=100=1.0.0 (%%) 251 +* (% style="color:green" %)BAT: 0x0c78 = 3192 mV = 3.192V (%%) 252 +* (% style="color:red" %)Singal: 0x17 = 23 (%%) 253 +* (% style="color:blue" %)Mod: 0x01 = 1 (%%) 254 +* (% style="color:green" %)Interrupt: 0x00= 0(%%) 255 +* Soil PH: 0x0225= 549 = 5.49 256 +* Soil Temperature:0x010B =267=26.7 °C 257 +* Time stamp : 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 258 +* Soil Temperature,Soil PH,Time stamp : 010b0226631550fb 259 +* (% style="color:red" %)8 sets of recorded data: Temperature,Soil PH,Time stamp : 010e022663154d77,.......(%%) 305 305 306 -((( 307 - 308 - 309 -**where:** 310 -))) 311 - 312 -* (% style="color:#037691" %)**Device ID:**(%%)** **0xf868411056754138 = f868411056754138 313 - 314 -* (% style="color:#037691" %)**Version:** (%%) 0x0064=100=1.0.0 315 - 316 -* (% style="color:#037691" %)**BAT:** (%%) 0x0c78 = 3192 mV = 3.192V 317 - 318 -* (% style="color:#037691" %)**Singal:** (%%)0x17 = 23 319 - 320 -* (% style="color:#037691" %)**Mod:** (%%) 0x01 = 1 321 - 322 -* (% style="color:#037691" %)**Interrupt:**(%%) 0x00= 0 323 - 324 -* (% style="color:#037691" %)**Soil PH:** (%%) 0x0225= 549 = 5.49 325 - 326 -* (% style="color:#037691" %)**Soil Temperature:**(%%) 0x010b =267=26.7 °C 327 - 328 -* (% style="color:#037691" %)**Time stamp :** (%%) 0x6315537b =1662342011 ([[Unix Epoch Time>>url:http://www.epochconverter.com/]]) 329 - 330 -* (% style="color:#037691" %)**Soil Temperature,Soil PH,Time stamp : **(%%) 010b0226631550fb 331 - 332 -* (% style="color:#037691" %)**8 sets of recorded data:**(%%) Temperature,Soil PH,Time stamp : 010e022663154d77,....... 333 - 334 - 335 - 336 336 == 2.4 Payload Explanation and Sensor Interface == 337 337 338 - 339 339 === 2.4.1 Device ID === 340 340 341 - 342 342 By default, the Device ID equal to the last 15 bits of IMEI. 343 343 344 -User can use (% style="color:blue" %)**AT+DEUI**(%%)to set Device ID267 +User can use **AT+DEUI** to set Device ID 345 345 346 - 347 347 **Example:** 348 348 349 349 AT+DEUI=868411056754138 ... ... @@ -350,20 +350,14 @@ 350 350 351 351 The Device ID is stored in a none-erase area, Upgrade the firmware or run AT+FDR won't erase Device ID. 352 352 353 - 354 - 355 355 === 2.4.2 Version Info === 356 356 357 - 358 358 Specify the software version: 0x64=100, means firmware version 1.00. 359 359 360 360 For example: 0x00 64 : this device is NSPH01 with firmware version 1.0.0. 361 361 362 - 363 - 364 364 === 2.4.3 Battery Info === 365 365 366 - 367 367 Check the battery voltage for NSPH01. 368 368 369 369 Ex1: 0x0B45 = 2885mV ... ... @@ -370,11 +370,8 @@ 370 370 371 371 Ex2: 0x0B49 = 2889mV 372 372 373 - 374 - 375 375 === 2.4.4 Signal Strength === 376 376 377 - 378 378 NB-IoT Network signal Strength. 379 379 380 380 **Ex1: 0x1d = 29** ... ... @@ -389,25 +389,18 @@ 389 389 390 390 **99** Not known or not detectable 391 391 392 - 393 - 394 394 === 2.4.5 Soil PH === 395 395 396 - 397 397 Get the PH content of the soil. The value range of the register is 300-1000(Decimal), divide this value by 100 to get the percentage of PH in the soil. 398 398 399 -For example, if the data you get from the register is (% style="color:blue" %)**__0x05 0xDC__**(%%), the PH content in the soil is309 +For example, if the data you get from the register is **__0x05 0xDC__**, the PH content in the soil is 400 400 401 - (% style="color:blue" %)**0229(H) = 549(D) /100 = 5.49.**311 +**0229(H) = 549(D) /100 = 5.49.** 402 402 403 - 404 - 405 405 === 2.4.6 Soil Temperature === 406 406 315 +Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is **__0x09 0xEC__**, the temperature content in the soil is 407 407 408 -Get the temperature in the soil. The value range of the register is -4000 - +800(Decimal), divide this value by 100 to get the temperature in the soil. For example, if the data you get from the register is (% style="color:blue" %)**__0x09 0xEC__**(%%), the temperature content in the soil is 409 - 410 - 411 411 **Example**: 412 412 413 413 If payload is 0105H: ((0x0105 & 0x8000)>>15 === 0),temp = 0105(H)/10 = 26.1 °C ... ... @@ -414,62 +414,56 @@ 414 414 415 415 If payload is FF7EH: ((FF7E & 0x8000)>>15 ===1),temp = (FF7E(H)-FFFF(H))/10 = -12.9 °C 416 416 417 - 418 - 419 419 === 2.4.7 Timestamp === 420 420 421 - 422 422 Time stamp : 0x6315537b =1662342011 423 423 424 424 Convert Unix timestamp to time 2022-9-5 9:40:11. 425 425 426 - 427 - 428 428 === 2.4.8 Digital Interrupt === 429 429 331 +Digital Interrupt refers to pin **GPIO_EXTI**, and there are different trigger methods. When there is a trigger, the NSPH01 will send a packet to the server. 430 430 431 -Digital Interrupt refers to pin (% style="color:blue" %)**GPIO_EXTI**(%%), and there are different trigger methods. When there is a trigger, the NSPH01 will send a packet to the server. 432 - 433 433 The command is: 434 434 435 - (% style="color:blue" %)**AT+INTMOD=3 **(%%)~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.**335 +**AT+INTMOD=3 ** ~/~/(more info about INMOD please refer [[**AT Command Manual**>>url:https://www.dragino.com/downloads/downloads/NB-IoT/NBSN95/DRAGINO_NBSN95-NB_AT%20Commands_v1.1.0.pdf]])**.** 436 436 437 437 The lower four bits of this data field shows if this packet is generated by interrupt or not. Click here for the hardware and software set up. 438 438 339 +Example: 439 439 440 -**Example:** 441 - 442 442 0x(00): Normal uplink packet. 443 443 444 444 0x(01): Interrupt Uplink Packet. 445 445 446 - 447 - 448 448 === 2.4.9 +5V Output === 449 449 450 - 451 451 NSPH01 will enable +5V output before all sampling and disable the +5v after all sampling. 452 452 453 453 The 5V output time can be controlled by AT Command. 454 454 455 - (% style="color:blue" %)**AT+5VT=1000**351 +**AT+5VT=1000** 456 456 457 457 Means set 5V valid time to have 1000ms. So the real 5V output will actually have 1000ms + sampling time for other sensors.** ** 458 458 459 459 460 - 461 461 == 2.5 Downlink Payload == 462 462 463 - 464 464 By default, NSPH01 prints the downlink payload to console port. 465 465 360 +(% style="text-align:center" %) 466 466 [[image:image-20220907154636-17.png]] 467 467 468 468 469 -(% style="color:blue" %)**Examples:** 470 470 471 -* (% style="color:#037691" %)** Set TDC** 472 472 366 + 367 + 368 + 369 +**Examples:** 370 + 371 +* **Set TDC** 372 + 473 473 If the payload=0100003C, it means set the END Node's TDC to 0x00003C=60(S), while type code is 01. 474 474 475 475 Payload: 01 00 00 1E TDC=30S ... ... @@ -476,19 +476,16 @@ 476 476 477 477 Payload: 01 00 00 3C TDC=60S 478 478 479 -* (% style="color:#037691" %)**379 +* **Reset** 480 480 481 481 If payload = 0x04FF, it will reset the NSPH01 482 482 483 -* (% style="color:#037691" %)**383 +* **INTMOD** 484 484 485 485 Downlink Payload: 06000003, Set AT+INTMOD=3 486 486 487 - 488 - 489 489 == 2.6 LED Indicator == 490 490 491 - 492 492 The NSPH01 has an internal LED which is to show the status of different state. 493 493 494 494 * When power on, NSPH01 will detect if sensor probe is connected, if probe detected, LED will blink four times. (no blinks in this step is no probe) ... ... @@ -496,24 +496,16 @@ 496 496 * After NSPH01 join NB-IoT network. The LED will be ON for 3 seconds. 497 497 * For each uplink probe, LED will be on for 500ms. 498 498 396 +== 2.7 Installation and Maintain == 499 499 398 +=== 2.7.1 Before measurement === 500 500 501 -== 2.7 Installation and Maintain == 502 - 503 - 504 -=== 2.7.1 Before measurement === 505 - 506 - 507 507 If the NSPH01 has more than 7 days not use or just clean the pH probe. User should put the probe inside pure water for more than 24 hours for activation. If no put in water, user need to put inside soil for more than 24 hours to ensure the measurement accuracy. 508 508 402 +=== 2.7.2 Measurement === 509 509 404 +**Measurement the soil surface:** 510 510 511 -=== 2.7.2 Measurement === 512 - 513 - 514 -(% style="color:#037691" %)**Measurement the soil surface:** 515 - 516 - 517 517 [[image:image-20220907154700-18.png]] 518 518 519 519 Choose the proper measuring position. Split the surface soil according to the measured deep. ... ... @@ -524,18 +524,14 @@ 524 524 525 525 Put soil over the probe after insert. And start to measure. 526 526 416 +**Measurement inside soil:** 527 527 528 -(% style="color:#037691" %)**Measurement inside soil:** 529 - 530 530 Dig a hole with diameter > 20CM. 531 531 532 532 Insert the probe inside, method like measure the surface. 533 533 422 +=== 2.7.3 Maintain Probe === 534 534 535 - 536 -=== 2.7.3 Maintain Probe === 537 - 538 - 539 539 1. pH probe electrode is fragile and no strong. User must avoid strong force or hitting it. 540 540 1. After long time use (3~~ 6 months). The probe electrode needs to be clean; user can use high grade sandpaper to polish it or put in 5% hydrochloric acid for several minutes. After the metal probe looks like new, user can use pure water to wash it. 541 541 1. Probe reference electrode is also no strong, need to avoid strong force or hitting. ... ... @@ -543,15 +543,12 @@ 543 543 1. Avoid the probes to touch oily matter. Which will cause issue in accuracy. 544 544 1. The probe is IP68 can be put in water. 545 545 431 +== 2.8 PH and Temperature alarm function == 546 546 433 +➢ AT Command: 547 547 548 - ==2.8PHand Temperature alarm function==435 +AT+ PHALARM=min,max 549 549 550 - 551 -(% style="color:#037691" %)**➢ AT Command:** 552 - 553 -(% style="color:blue" %)**AT+ PHALARM=min,max** 554 - 555 555 ² When min=3, and max≠0, Alarm higher than max 556 556 557 557 ² When min≠0, and max=0, Alarm lower than min ... ... @@ -558,11 +558,10 @@ 558 558 559 559 ² When min≠0 and max≠0, Alarm higher than max or lower than min 560 560 443 +Example: 561 561 562 - (%style="color:blue"%)**Example:**445 +AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5. 563 563 564 -AT+ PHALARM =5,8 ~/~/ Alarm when PH lower than 5. 565 - 566 566 AT+ TEMPALARM=min,max 567 567 568 568 ² When min=0, and max≠0, Alarm higher than max ... ... @@ -571,66 +571,50 @@ 571 571 572 572 ² When min≠0 and max≠0, Alarm higher than max or lower than min 573 573 455 +Example: 574 574 575 - (%style="color:blue"%)**Example:**457 +AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 576 576 577 -AT+ TEMPALARM=20,30 ~/~/ Alarm when temperature lower than 20. 578 578 460 +== 2.9 Set the number of data to be uploaded and the recording time == 579 579 462 +➢ AT Command: 580 580 581 -= = 2.9Setthe numberofdatatobeuploadedandhe recording time==464 +AT+TR=900 ~/~/The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 582 582 466 +AT+NOUD=8 ~/~/The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 583 583 584 -(% style="color:#037691" %)**➢ AT Command:** 585 585 586 -* (% style="color:blue" %)**AT+TR=900** (%%) ~/~/ The unit is seconds, and the default is to record data once every 900 seconds.( The minimum can be set to 180 seconds) 587 -* (% style="color:blue" %)**AT+NOUD=8** (%%) ~/~/ The device uploads 8 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 469 +== 2.10 Read or Clear cached data == 588 588 589 - T hediagram below explains the relationship between TR, NOUD, andTDC more clearly**:**471 +➢ AT Command: 590 590 591 - [[image:image-20221009000933-1.png||height="750"width="1043"]]473 +AT+CDP ~/~/ Read cached data 592 592 593 - 594 - 595 -== 2.10 Read or Clear cached data == 596 - 597 - 598 -(% style="color:#037691" %)**➢ AT Command:** 599 - 600 -* (% style="color:blue" %)**AT+CDP** (%%) ~/~/ Read cached data 601 -* (% style="color:blue" %)**AT+CDP=0** (%%) ~/~/ Clear cached data 602 - 603 603 [[image:image-20220907154700-19.png]] 604 604 605 605 478 +AT+CDP=0 ~/~/ Clear cached data 606 606 607 -== 2.11 Calibration == 608 608 481 +== 2.11 Calibration == 609 609 610 610 User can do calibration for the probe. It is limited to use below pH buffer solution to calibrate: 4.00, 6.86, 9.18. When calibration, user need to clean the electrode and put the probe in the pH buffer solution to wait the value stable ( a new clean electrode might need max 24 hours to be stable). 611 611 612 612 After stable, user can use below command to calibrate. 613 613 614 - 615 615 [[image:image-20220907154700-20.png]] 616 616 617 - 618 - 619 619 == 2.12 Firmware Change Log == 620 620 491 +Download URL & Firmware Change log: [[https:~~/~~/www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0>>url:https://www.dropbox.com/sh/1zmcakvbkf24f8x/AACmq2dZ3iRB9F1nVWeEB9Moa?dl=0]] 621 621 622 - DownloadURL &FirmwareChange log: [[https:~~/~~/www.dropbox.com/sh/1tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0>>https://www.dropbox.com/sh/1tv07fro2pvjqj8/AAD-2wbfGfluTZfh38fQqdA_a?dl=0]]493 +Upgrade Instruction: [[Upgrade Firmware>>path:#H5.1200BHowtoUpgradeFirmware]] 623 623 624 -Upgrade Instruction: [[Upgrade Firmware>>||anchor="H5.1200BHowtoUpgradeFirmware"]] 625 - 626 - 627 - 628 628 == 2.13 Battery Analysis == 629 629 630 - 631 631 === 2.13.1 Battery Type === 632 632 633 - 634 634 The NSPH01 battery is a combination of an 8500mAh Li/SOCI2 Battery and a Super Capacitor. The battery is none-rechargeable battery type with a low discharge rate (<2% per year). This type of battery is commonly used in IoT devices such as water meter. 635 635 636 636 The battery is designed to last for several years depends on the actually use environment and update interval. ... ... @@ -643,18 +643,15 @@ 643 643 644 644 [[image:image-20220907154700-21.png]] 645 645 646 - 647 - 648 648 === 2.13.2 Power consumption Analyze === 649 649 650 - 651 651 Dragino battery powered product are all runs in Low Power mode. We have an update battery calculator which base on the measurement of the real device. User can use this calculator to check the battery life and calculate the battery life if want to use different transmit interval. 652 652 653 653 Instruction to use as below: 654 654 655 - (% style="color:blue" %)**Step 1: **(%%)Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]]517 +**Step 1: **Downlink the up-to-date DRAGINO_Battery_Life_Prediction_Table.xlsx from: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_End_Node/Battery_Analyze/]] 656 656 657 - (% style="color:blue" %)**Step 2: **(%%)Open it and choose519 +**Step 2: ** Open it and choose 658 658 659 659 * Product Model 660 660 * Uplink Interval ... ... @@ -662,45 +662,34 @@ 662 662 663 663 And the Life expectation in difference case will be shown on the right. 664 664 665 - 527 +(% style="text-align:center" %) 666 666 [[image:image-20220907154700-22.jpeg]] 667 667 668 668 669 669 670 - 671 671 === 2.13.3 Battery Note === 672 672 673 - 674 674 The Li-SICO battery is designed for small current / long period application. It is not good to use a high current, short period transmit method. The recommended minimum period for use of this battery is 5 minutes. If you use a shorter period time to transmit LoRa, then the battery life may be decreased. 675 675 676 - 677 - 678 678 === 2.13.4 Replace the battery === 679 679 680 - 681 681 The default battery pack of NSPH01 includes a ER26500 plus super capacitor. If user can't find this pack locally, they can find ER26500 or equivalence without the SPC1520 capacitor, which will also work in most case. The SPC can enlarge the battery life for high frequency use (update period below 5 minutes). 682 682 683 - 684 - 685 685 = 3. Access NB-IoT Module = 686 686 687 - 688 688 Users can directly access the AT command set of the NB-IoT module. 689 689 690 690 The AT Command set can refer the BC35-G NB-IoT Module AT Command: [[https:~~/~~/www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/>>url:https://www.dragino.com/downloads/index.php?dir=datasheet/other_vendors/BC35-G/]] 691 691 692 - 546 +(% style="text-align:center" %) 693 693 [[image:image-20220907154700-23.png]] 694 694 695 695 696 696 697 - 698 698 = 4. Using the AT Commands = 699 699 700 - 701 701 == 4.1 Access AT Commands == 702 702 703 - 704 704 See this link for detail: [[https:~~/~~/www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0>>url:https://www.dropbox.com/sh/351dwor6joz8nwh/AADn1BQaAAxLF_QMyU8NkW47a?dl=0]] 705 705 706 706 AT+<CMD>? : Help on <CMD> ... ... @@ -711,9 +711,8 @@ 711 711 712 712 AT+<CMD>=? : Get the value 713 713 565 +**General Commands** 714 714 715 -(% style="color:#037691" %)**General Commands** 716 - 717 717 AT : Attention 718 718 719 719 AT? : Short Help ... ... @@ -738,18 +738,13 @@ 738 738 739 739 AT+TR : Get or Set record time" 740 740 741 -AT+APN : Get or set the APN 742 742 743 -AT+FBAND : Get or Set whether to automatically modify the frequency band 744 - 745 -AT+DNSCFG : Get or Set DNS Server 746 - 747 -AT+GETSENSORVALUE : Returns the current sensor measurement 748 - 749 749 AT+NOUD : Get or Set the number of data to be uploaded 750 750 594 + 751 751 AT+CDP : Read or Clear cached data 752 752 597 + 753 753 AT+TEMPALARM : Get or Set alarm of temp 754 754 755 755 AT+PHALARM : Get or Set alarm of PH ... ... @@ -757,18 +757,16 @@ 757 757 AT+ PHCAL : calibrate PH value 758 758 759 759 760 - (% style="color:#037691" %)**COAP Management**605 +**COAP Management** 761 761 762 762 AT+URI : Resource parameters 763 763 609 +**UDP Management** 764 764 765 -(% style="color:#037691" %)**UDP Management** 766 - 767 767 AT+CFM : Upload confirmation mode (only valid for UDP) 768 768 613 +**MQTT Management** 769 769 770 -(% style="color:#037691" %)**MQTT Management** 771 - 772 772 AT+CLIENT : Get or Set MQTT client 773 773 774 774 AT+UNAME : Get or Set MQTT Username ... ... @@ -779,63 +779,42 @@ 779 779 780 780 AT+SUBTOPIC : Get or Set MQTT subscription topic 781 781 625 +**Information** 782 782 783 -(% style="color:#037691" %)**Information** 784 - 785 785 AT+FDR : Factory Data Reset 786 786 787 787 AT+PWORD : Serial Access Password 788 788 789 - 790 - 791 791 = 5. FAQ = 792 792 793 - 794 794 == 5.1 How to Upgrade Firmware == 795 795 796 - 797 797 User can upgrade the firmware for 1) bug fix, 2) new feature release. 798 798 799 799 Please see this link for how to upgrade: [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H2.HardwareUpgradeMethodSupportList]] 800 800 801 - (% style="color:red" %)**Notice, NSPH01 andLSPH01 share the same mother board. They use the same connection and method to update.**639 +**Notice, **NSPH01 **and **NSPH01 **share the same mother board. They use the same connection and method to update.** 802 802 803 - 804 - 805 805 == 5.2 Can I calibrate NSPH01 to different soil types? == 806 806 807 - 808 808 NSPH01 is calibrated for saline-alkali soil and loamy soil. If users want to use it for other soil, they can calibrate the value in the IoT platform base on the value measured by saline-alkali soil and loamy soil. The formula can be found at [[this link>>url:https://www.dragino.com/downloads/downloads/LoRa_End_Node/LSE01/Calibrate_to_other_Soil_20220605.pdf]]. 809 809 810 - 811 - 812 812 = 6. Trouble Shooting = 813 813 814 - 815 815 == 6.1 Connection problem when uploading firmware == 816 816 817 - 818 818 **Please see: **[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Firmware%20Upgrade%20Instruction%20for%20STM32%20base%20products/#H3.3Troubleshooting]] 819 819 820 - 821 - 822 822 == 6.2 AT Command input doesn't work == 823 823 653 +In the case if user can see the console output but can't type input to the device. Please check if you already include the **ENTER** while sending out the command. Some serial tool doesn't send **ENTER** while press the send key, user need to add ENTER in their string. 824 824 825 -In the case if user can see the console output but can't type input to the device. Please check if you already include the (% style="color:green" %)**ENTER**(%%) while sending out the command. Some serial tool doesn't send (% style="color:green" %)**ENTER** (%%)while press the send key, user need to add ENTER in their string. 826 - 827 - 828 - 829 829 = 7. Order Info = 830 830 831 - 832 832 Part Number**:** NSPH01 833 833 834 - 835 - 836 836 = 8. Packing Info = 837 837 838 - 839 839 **Package Includes**: 840 840 841 841 * NSPH01 NB-IoT pH Sensor x 1 ... ... @@ -843,16 +843,11 @@ 843 843 844 844 **Dimension and weight**: 845 845 846 -* Device Size: cm 847 -* Device Weight: g 848 -* Package Size / pcs : cm 849 -* Weight / pcs : g 668 +* Size: 195 x 125 x 55 mm 669 +* Weight: 420g 850 850 851 - 852 - 853 853 = 9. Support = 854 854 855 - 856 856 * Support is provided Monday to Friday, from 09:00 to 18:00 GMT+8. Due to different timezones we cannot offer live support. However, your questions will be answered as soon as possible in the before-mentioned schedule. 857 857 * Provide as much information as possible regarding your enquiry (product models, accurately describe your problem and steps to replicate it etc) and send a mail to [[support@dragino.com>>url:http://../../../../../../D:%5C%E5%B8%82%E5%9C%BA%E8%B5%84%E6%96%99%5C%E8%AF%B4%E6%98%8E%E4%B9%A6%5CLoRa%5CLT%E7%B3%BB%E5%88%97%5Csupport@dragino.com]] 858 858
- image-20220912144017-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -149.6 KB - Content
- image-20220923101327-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -12.1 KB - Content
- image-20221009000933-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -282.9 KB - Content