<
From version < 45.5 >
edited by Xiaoling
on 2022/07/08 10:39
To version < 57.2 >
edited by Xiaoling
on 2022/07/08 11:31
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -59,8 +59,6 @@
59 59  * Micro SIM card slot for NB-IoT SIM
60 60  * 8500mAh Battery for long term use
61 61  
62 -
63 -
64 64  == 1.3  Specification ==
65 65  
66 66  
... ... @@ -69,7 +69,6 @@
69 69  * Supply Voltage: 2.1v ~~ 3.6v
70 70  * Operating Temperature: -40 ~~ 85°C
71 71  
72 -
73 73  (% style="color:#037691" %)**NB-IoT Spec:**
74 74  
75 75  * - B1 @H-FDD: 2100MHz
... ... @@ -79,7 +79,6 @@
79 79  * - B20 @H-FDD: 800MHz
80 80  * - B28 @H-FDD: 700MHz
81 81  
82 -
83 83  (% style="color:#037691" %)**Probe Specification:**
84 84  
85 85  Measure Volume: Base on the centra pin of the probe, a cylinder with 7cm diameter and 10cm height.
... ... @@ -126,6 +126,7 @@
126 126  
127 127  == 2.2 ​ Configure the NSE01 ==
128 128  
125 +
129 129  === 2.2.1 Test Requirement ===
130 130  
131 131  
... ... @@ -135,11 +135,12 @@
135 135  * The local NB-IoT network used the band that NSE01 supports.
136 136  * Your operator is able to distribute the data received in their NB-IoT network to your IoT server.
137 137  
138 -
135 +(((
139 139  Below figure shows our testing structure. Here we have NB-IoT network coverage by China Mobile, the band they use is B8.  The NSE01 will use CoAP((% style="color:red" %)120.24.4.116:5683)(%%) or raw UDP((% style="color:red" %)120.24.4.116:5601)(%%) or MQTT((% style="color:red" %)120.24.4.116:1883)(%%)or TCP((% style="color:red" %)120.24.4.116:5600)(%%)protocol to send data to the test server
137 +)))
140 140  
141 141  
142 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image002.gif]]
140 +[[image:1657249419225-449.png]]
143 143  
144 144  
145 145  
... ... @@ -147,159 +147,177 @@
147 147  
148 148  Insert the NB-IoT Card get from your provider.
149 149  
150 -
151 151  User need to take out the NB-IoT module and insert the SIM card like below:
152 152  
153 153  
154 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image004.gif]]
151 +[[image:1657249468462-536.png]]
155 155  
156 156  
154 +
157 157  === 2.2.3 Connect USB – TTL to NSE01 to configure it ===
158 158  
157 +(((
158 +(((
159 +User need to configure NSE01 via serial port to set the (% style="color:blue" %)**Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below.
160 +)))
161 +)))
159 159  
160 -User need to configure NSE01 via serial port to set the **(% style="color:blue" %)Server Address** / **Uplink Topic** (%%)to define where and how-to uplink packets. NSE01 support AT Commands, user can use a USB to TTL adapter to connect to NSE01 and use AT Commands to configure it, as below.
161 161  
164 +**Connection:**
162 162  
166 + (% style="background-color:yellow" %)USB TTL GND <~-~-~-~-> GND
163 163  
168 + (% style="background-color:yellow" %)USB TTL TXD <~-~-~-~-> UART_RXD
164 164  
165 -Connection:
170 + (% style="background-color:yellow" %)USB TTL RXD <~-~-~-~-> UART_TXD
166 166  
167 -USB TTL GND <~-~-~-~-> GND
168 168  
169 -USB TTL TXD <~-~-~-~-> UART_RXD
173 +In the PC, use below serial tool settings:
170 170  
171 -USB TTL RXD <~-~-~-~-> UART_TXD
175 +* Baud: (% style="color:green" %)**9600**
176 +* Data bits:** (% style="color:green" %)8(%%)**
177 +* Stop bits: (% style="color:green" %)**1**
178 +* Parity: (% style="color:green" %)**None**
179 +* Flow Control: (% style="color:green" %)**None**
172 172  
181 +(((
182 +Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the (% style="color:green" %)**password: 12345678**(%%) to access AT Command input.
183 +)))
173 173  
185 +[[image:image-20220708110657-3.png]]
174 174  
175 -In the PC, use below serial tool settings:
187 +(% style="color:red" %)Note: the valid AT Commands can be found at: (%%)[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
176 176  
177 -* Baud: **9600**
178 -* Data bits:** 8**
179 -* Stop bits: **1**
180 -* Parity: **None**
181 -* Flow Control: **None**
182 182  
183 183  
184 -Make sure the switch is in FLASH position, then power on device by connecting the jumper on NSE01. NSE01 will output system info once power on as below, we can enter the **password: 12345678** to access AT Command input.
191 +=== 2.2.4 Use CoAP protocol to uplink data ===
185 185  
186 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image009.jpg]]
193 +(% 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/>>http://wiki.dragino.com/xwiki/bin/view/Main/Set%20up%20CoAP%20Server/]]
187 187  
188 -Note: the valid AT Commands can be found at:
189 189  
190 -[[http:~~/~~/www.dragino.com/downloads/index.php?dir=NB-IoT/NSE01/>>url:http://www.dragino.com/downloads/index.php?dir=NB-IoT/NBSN50/]]
196 +**Use below commands:**
191 191  
198 +* (% style="color:blue" %)**AT+PRO=1**  (%%) ~/~/ Set to use CoAP protocol to uplink
199 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5683   ** (%%)~/~/ to set CoAP server address and port
200 +* (% style="color:blue" %)**AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0" ** (%%) ~/~/Set COAP resource path
192 192  
193 -1.
194 -11.
195 -111. Use CoAP protocol to uplink data 
196 196  
203 +For parameter description, please refer to AT command set
197 197  
198 -Note: if you don’t have CoAP server, you can refer this link to set up one:
205 +[[image:1657249793983-486.png]]
199 199  
200 -[[http:~~/~~/wiki.dragino.com/index.php?title=Set_up_CoAP_Server>>url:http://wiki.dragino.com/index.php?title=Set_up_CoAP_Server]]
201 201  
208 +After configure the server address and (% style="color:green" %)**reset the device**(%%) (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server.
202 202  
203 -Use below commands:
210 +[[image:1657249831934-534.png]]
204 204  
205 -* **AT+PRO=1**    ~/~/ Set to use CoAP protocol to uplink
206 -* **AT+SERVADDR=120.24.4.116,5683   **~/~/ to set CoAP server address and port
207 -* **AT+URI=5,11,"mqtt",11,"coap",12,"0",15,"c=text1",23,"0"       **~/~/Set COAP resource path
208 208  
209 209  
210 -For parameter description, please refer to AT command set
214 +=== 2.2.5 Use UDP protocol to uplink data(Default protocol) ===
211 211  
212 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image011.jpg]]
216 +This feature is supported since firmware version v1.0.1
213 213  
214 214  
215 -After configure the server address and **reset the device** (via AT+ATZ ), NSE01 will start to uplink sensor values to CoAP server.
219 +* (% style="color:blue" %)**AT+PRO=2   ** (%%) ~/~/ Set to use UDP protocol to uplink
220 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5601   ** (%%) ~/~/ to set UDP server address and port
221 +* (% style="color:blue" %)**AT+CFM=1       ** (%%) ~/~/If the server does not respond, this command is unnecessary
216 216  
217 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image013.jpg]]
218 218  
219 -1.
220 -11.
221 -111. Use UDP protocol to uplink data(Default protocol)
224 +[[image:1657249864775-321.png]]
222 222  
223 223  
224 -This feature is supported since firmware version v1.0.1
225 225  
228 +[[image:1657249930215-289.png]]
226 226  
227 -* **AT+PRO=2   ** ~/~/ Set to use UDP protocol to uplink
228 -* **AT+SERVADDR=120.24.4.116,5601   **~/~/ to set UDP server address and port
229 -* **AT+CFM=1       **~/~/If the server does not respond, this command is unnecessary
230 230  
231 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image015.jpg]]
232 232  
232 +=== 2.2.6 Use MQTT protocol to uplink data ===
233 233  
234 +This feature is supported since firmware version v110
234 234  
235 235  
237 +* (% style="color:blue" %)**AT+PRO=3   ** (%%) ~/~/Set to use MQTT protocol to uplink
238 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,1883   ** (%%) ~/~/Set MQTT server address and port
239 +* (% style="color:blue" %)**AT+CLIENT=CLIENT       ** (%%)~/~/Set up the CLIENT of MQTT
240 +* (% style="color:blue" %)**AT+UNAME=UNAME                               **(%%)~/~/Set the username of MQTT
241 +* (% style="color:blue" %)**AT+PWD=PWD                                        **(%%)~/~/Set the password of MQTT
242 +* (% style="color:blue" %)**AT+PUBTOPIC=NSE01_PUB                    **(%%)~/~/Set the sending topic of MQTT
243 +* (% style="color:blue" %)**AT+SUBTOPIC=NSE01_SUB          **(%%) ~/~/Set the subscription topic of MQTT
236 236  
237 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image017.jpg]]
238 238  
246 +[[image:1657249978444-674.png]]
239 239  
240 -1.
241 -11.
242 -111. Use MQTT protocol to uplink data
243 243  
249 +[[image:1657249990869-686.png]]
244 244  
245 -This feature is supported since firmware version v110
246 246  
247 247  
248 -* **AT+PRO=3   ** ~/~/Set to use MQTT protocol to uplink
249 -* **AT+SERVADDR=120.24.4.116,1883   **~/~/Set MQTT server address and port
250 -* **AT+CLIENT=CLIENT **~/~/Set up the CLIENT of MQTT
251 -* **AT+UNAME=UNAME                           **~/~/Set the username of MQTT
252 -* **AT+PWD=PWD                                      **~/~/Set the password of MQTT
253 -* **AT+PUBTOPIC=NSE01_PUB   **~/~/Set the sending topic of MQTT
254 -* **AT+SUBTOPIC=NSE01_SUB    **~/~/Set the subscription topic of MQTT
253 +(((
254 +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.
255 +)))
255 255  
256 256  
257 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image019.gif]]
258 258  
259 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image021.jpg]]
259 +=== 2.2.7 Use TCP protocol to uplink data ===
260 260  
261 +This feature is supported since firmware version v110
261 261  
262 -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.
263 263  
264 +* (% style="color:blue" %)**AT+PRO=4   ** (%%) ~/~/ Set to use TCP protocol to uplink
265 +* (% style="color:blue" %)**AT+SERVADDR=120.24.4.116,5600   **(%%) ~/~/ to set TCP server address and port
264 264  
265 -1.
266 -11.
267 -111. Use TCP protocol to uplink data
267 +[[image:1657250217799-140.png]]
268 268  
269 269  
270 -This feature is supported since firmware version v110
270 +[[image:1657250255956-604.png]]
271 271  
272 272  
273 -* **AT+PRO=4   ** ~/~/ Set to use TCP protocol to uplink
274 -* **AT+SERVADDR=120.24.4.116,5600   **~/~/ to set TCP server address and port
273 +=== 2.2.8 Change Update Interval ===
275 275  
276 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image023.jpg]]
275 +User can use below command to change the (% style="color:green" %)**uplink interval**.
277 277  
277 +* (% style="color:blue" %)**AT+TDC=600      ** (%%)~/~/ Set Update Interval to 600s
278 278  
279 +(((
280 +(% style="color:red" %)**NOTE:**
281 +)))
279 279  
280 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image025.jpg]]
283 +(((
284 +(% style="color:red" %)1. By default, the device will send an uplink message every 1 hour.
285 +)))
281 281  
282 282  
283 -1.
284 -11.
285 -111. Change Update Interval
286 286  
287 -User can use below command to change the **uplink interval**.
289 +== 2.3  Uplink Payload ==
288 288  
289 -**~ AT+TDC=600      **~/~/ Set Update Interval to 600s
291 +In this mode, uplink payload includes in total 18 bytes
290 290  
293 +(% border="1" cellspacing="10" style="background-color:#ffffcc; color:green; width:510px" %)
294 +|=(% style="width: 50px;" %)(((
295 +**Size(bytes)**
296 +)))|=(% style="width: 50px;" %)**6**|=(% style="width: 25px;" %)2|=(% style="width: 25px;" %)**2**|=(% style="width: 80px;" %)**1**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 80px;" %)**2**|=(% style="width: 40px;" %)**1**
297 +|(% style="width:97px" %)**Value**|(% style="width:83px" %)[[Device ID>>path:#Device_ID]]|(% style="width:41px" %)[[Ver>>path:#Version]]|(% style="width:46px" %)[[BAT>>path:#battery]]|(% style="width:123px" %)[[Signal Strength>>path:#Signal]]|(% style="width:108px" %)[[Soil Moisture>>path:#Payload_Explain]]|(% style="width:133px" %)[[Soil Temperature>>path:#Payload_Explain]]|(% style="width:159px" %)[[Soil Conductivity(EC)>>path:#Payload_Explain]]|(% style="width:80px" %)[[Interrupt>>path:#Interrupt]]
291 291  
292 -**NOTE:**
299 +If we use the MQTT client to subscribe to this MQTT topic, we can see the following information when the NSE01 uplink data.
293 293  
294 -1. By default, the device will send an uplink message every 1 hour.
295 295  
302 +[[image:image-20220708111918-4.png]]
296 296  
297 297  
305 +The payload is ASCII string, representative same HEX:
298 298  
307 +0x72403155615900640c7817075e0a8c02f900 where:
299 299  
309 +* Device ID: 0x 724031556159 = 724031556159
310 +* Version: 0x0064=100=1.0.0
300 300  
312 +* BAT: 0x0c78 = 3192 mV = 3.192V
313 +* Singal: 0x17 = 23
314 +* Soil Moisture: 0x075e= 1886 = 18.86  %
315 +* Soil Temperature:0x0a8c =2700=27 °C
316 +* Soil Conductivity(EC) = 0x02f9 =761 uS /cm
317 +* Interrupt: 0x00 = 0
301 301  
302 -== 2.3 Uplink Payload ==
303 303  
304 304  
305 305  === 2.3.1 MOD~=0(Default Mode) ===
1657249419225-449.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +81.0 KB
Content
1657249468462-536.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +483.6 KB
Content
1657249793983-486.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +85.8 KB
Content
1657249831934-534.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +72.5 KB
Content
1657249864775-321.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +87.0 KB
Content
1657249930215-289.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +77.3 KB
Content
1657249978444-674.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +139.5 KB
Content
1657249990869-686.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +96.9 KB
Content
1657250217799-140.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +98.7 KB
Content
1657250255956-604.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +99.0 KB
Content
image-20220708110657-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +251.7 KB
Content
image-20220708111918-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +38.8 KB
Content
Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0