Last modified by Mengting Qiu on 2025/07/03 18:55

From version 83.8
edited by Xiaoling
on 2023/08/09 10:56
Change comment: There is no comment for this version
To version 105.2
edited by Xiaoling
on 2023/11/06 16:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -4,6 +4,10 @@
4 4  {{toc/}}
5 5  
6 6  
7 +
8 +
9 +
10 +
7 7  = 1. The use of this guideline =
8 8  
9 9  
... ... @@ -12,12 +12,14 @@
12 12  
13 13  = 2. Attach Network =
14 14  
19 +== 2.1 General Configure to attach network ==
15 15  
21 +
16 16  To attache NB-IoT sensors to NB-IoT Network, You need to:
17 17  
18 18  1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone)
19 19  1. Insert the SIM card to Sensor
20 -1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (% class="mark" %)(补充 APN 指令(%%))
26 +1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (AT+APN=<APN>)
21 21  
22 22  [[image:image-20230808205045-1.png||height="293" width="438"]]
23 23  
... ... @@ -26,7 +26,7 @@
26 26  The -NB and -NS models support (% style="color:blue" %)**LTE Cat NB2**(%%), with below frequency band: multiple frequency bands of (% style="color:blue" %)**B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85**(%%) . Make sure you use a the NB-IoT SIM card.
27 27  
28 28  (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %)
29 -|(% style="background-color:#4f81bd; color:white; width:117px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:151px" %)**APN**|(% style="background-color:#4f81bd; color:white; width:474px" %)**NB-IoT Coverage**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Comments**
35 +|(% style="background-color:#4f81bd; color:white; width:117px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:151px" %)**AT+APN=**|(% style="background-color:#4f81bd; color:white; width:474px" %)**NB-IoT Coverage**|(% style="background-color:#4f81bd; color:white; width:135px" %)**Comments**
30 30  |(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:474px" %)(((
31 31  **[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]**
32 32  
... ... @@ -37,6 +37,21 @@
37 37  
38 38  
39 39  
46 +== 2.2 Speed Up Network Attach time ==
47 +
48 +
49 +BC660K-GL supports multi bands (% style="color:blue" %)**B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85. **(%%) It will search one by one and try to attach, this will take a lot of time and even cause attach fail. User can lock the band to specify band for its operator to make this faster.
50 +
51 +(% style="color:#037691" %)**AT+QBAND?       ** (%%) ~/~/ Check what is the current used frequency band
52 +
53 +(% style="color:#037691" %)**AT+QBAND=1,4    ** (%%) ~/~/ Set to use 1 frequency band. Band4
54 +
55 +(% style="color:#037691" %)**AT+QBAND=2,8,20**  (%%) ~/~/ Set to use 2 frequency bands. Band 8 and Band 20
56 +
57 +
58 +See bands used for different provider:** [[NB-IoT Deployment , Bands, Operator list>>http://wiki.dragino.com/xwiki/bin/view/Main/NB-IoT%20Deployment%20%2C%20Bands%2C%20Operator%20list/]]**
59 +
60 +
40 40  = 3. Configure to connect to different servers =
41 41  
42 42  == 3.1 General UDP Connection ==
... ... @@ -50,7 +50,7 @@
50 50  
51 51  We can use PC tool to simulate UDP connection to make sure server works ok.
52 52  
53 -[[image:image-20230802112413-1.png]]
74 +[[image:image-20230802112413-1.png||height="468" width="1024"]]
54 54  
55 55  
56 56  === 3.1.2 Configure NB-IoT Sensor ===
... ... @@ -100,7 +100,7 @@
100 100  
101 101  [[image:image-20230802112413-4.png]]
102 102  
103 -[[image:image-20230802112413-5.png]]
124 +[[image:image-20230802112413-5.png||height="530" width="987"]]
104 104  
105 105  (% style="color:red" %)**Notice: MQTT protocol has a much higher power consumption compare with UDP/CoAP protocol. Please check the power analyze document and adjust the uplink  period to a suitable interval.**
106 106  
... ... @@ -112,7 +112,7 @@
112 112  
113 113  [[ThingSpeak>>url:https://thingspeak.com/]] connection uses MQTT Connection. So we need to get MQTT Credentials first. You need to point MQTT Devices to ThingSpeak Channel as well.
114 114  
115 -[[image:image-20230802112413-6.png]]
136 +[[image:image-20230802112413-6.png||height="336" width="925"]]
116 116  
117 117  [[image:image-20230802112413-7.png]]
118 118  
... ... @@ -157,7 +157,7 @@
157 157  
158 158  (% style="color:blue" %)**Result: **
159 159  
160 -[[image:image-20230802112413-11.png]]
181 +[[image:image-20230802112413-11.png||height="539" width="901"]]
161 161  
162 162  
163 163  === 3.3.3 Configure NB-IoT Sensor for connection ===
... ... @@ -180,10 +180,11 @@
180 180  * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
181 181  
182 182  
204 +
183 183  ==== 3.3.3.2 Uplink Examples ====
184 184  
185 185  
186 -For S31-NB
208 +[[image:image-20230816201942-1.png]]
187 187  
188 188  For SE01-NB
189 189  
... ... @@ -214,9 +214,9 @@
214 214  When NB-IoT sensor upload to ThingSpeak. The payload already specify which fileds related to which sensor value. Use need to create fileds in Channels Settings. with name so to see the value correctly.
215 215  
216 216  
217 -[[image:image-20230802112413-12.png]]
239 +[[image:image-20230802112413-12.png||height="504" width="1011"]]
218 218  
219 -[[image:image-20230802112413-13.png]]
241 +[[image:image-20230802112413-13.png||height="331" width="978"]]
220 220  
221 221  
222 222  Below is the NB-IoT Product Table show the mapping.
... ... @@ -243,27 +243,45 @@
243 243  
244 244  
245 245  
246 -== 3.4 Datacake ==
268 +== 3.4 [[Datacake>>https://datacake.co/]] ==
247 247  
270 +
271 +(% class="wikigeneratedid" %)
272 +Dragino NB-IoT sensors has its template in **[[Datacake>>https://datacake.co/]]** Platform. There are two version for NB Sensor,
273 +
274 +
275 +(% class="wikigeneratedid" %)
276 +As example for S31B-NB. there are two versions: **S31B-NB-1D and S31B-NB-GE.**
277 +
278 +* (% style="color:blue" %)**S31B-NB-1D**(%%): This version have pre-configure DataCake connection. User just need to Power on this device, it will auto connect send data to DataCake Server.
279 +
280 +* (% style="color:blue" %)**S31B-NB-GE**(%%): This verson doesn't have pre-configure Datacake connection. User need to enter the AT Commands to connect to Datacake. See below for instruction.
281 +
282 +
283 +
248 248  === 3.4.1 Create device ===
249 249  
250 250  
251 -[[image:image-20230808162301-1.png]]
287 +(% style="color:blue" %)**Add Device**(%%) in DataCake.
252 252  
289 +[[image:image-20230808162301-1.png||height="453" width="952"]]
253 253  
254 -[[image:image-20230808162342-2.png]]
255 255  
292 +[[image:image-20230808162342-2.png||height="541" width="952"]]
256 256  
294 +
295 +(% style="color:blue" %)**Choose the correct model**(%%) from template.
296 +
257 257  [[image:image-20230808162421-3.png]]
258 258  
259 259  
260 -The device ID needs to be filled in with IMEI, and a prefix of** 'f' **needs to be added.
300 +(% style="color:blue" %)**Fill Device ID**(%%). The device ID needs to be filled in with IMEI, and a prefix of(% style="color:blue" %)** 'f' **(%%)needs to be added.
261 261  
262 -[[image:image-20230808163612-7.png]]
302 +[[image:image-20230808163612-7.png||height="549" width="952"]]
263 263  
264 264  [[image:image-20230808163035-5.png]]
265 265  
266 -[[image:image-20230808163049-6.png]]
306 +[[image:image-20230808163049-6.png||height="544" width="926"]]
267 267  
268 268  
269 269  === 3.4.2 Scan QR code to obtain data ===
... ... @@ -271,7 +271,7 @@
271 271  
272 272  Users can use their phones or computers to scan QR codes to obtain device data information.
273 273  
274 -[[image:image-20230808170051-8.png]]
314 +[[image:image-20230808170051-8.png||height="255" width="259"]]
275 275  
276 276  [[image:image-20230808170548-9.png]]
277 277  
... ... @@ -289,35 +289,60 @@
289 289  === 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] ===
290 290  
291 291  
292 -[[image:image-20230802112413-29.png]]
332 +Take S31-NB UDP protocol as an example.
293 293  
334 +Dragino provides input flow examples for the sensors.
294 294  
295 -[[image:image-20230802112413-30.png]]
336 +User can download the required JSON file through Dragino Node-RED input flow template.
296 296  
338 +Download sample JSON file link: [[https:~~/~~/www.dropbox.com/sh/mduw85jcuwsua22/AAAvwPhg9z6dLjJhmZjqBf_ma?dl=0>>url:https://www.dropbox.com/sh/mduw85jcuwsua22/AAAvwPhg9z6dLjJhmZjqBf_ma?dl=0]]
297 297  
298 -=== 3.5.2 Simulate Connection ===
340 +We can directly import the template.
299 299  
342 +The templates for S31-NB and NB95S31B are the same.
300 300  
301 -[[image:image-20230802112413-31.png]]
302 302  
345 +[[image:image-20230809173127-4.png]]
303 303  
304 -=== 3.5.3 Configure NB-IoT Sensors ===
305 305  
348 +Please select the NB95S31B template.
306 306  
307 -* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%)    **~/~/  Set to mqtt Server and  Payload**
350 +[[image:image-20230809173310-5.png||height="558" width="926"]]
308 308  
309 -* (% style="color:blue" %)**AT+CLIENT=any value**
352 +[[image:image-20230809173438-6.png]]
310 310  
311 -* (% style="color:blue" %)**AT+UNAME=any value**
354 +[[image:image-20230809173800-7.png]]
312 312  
313 -* (% style="color:blue" %)**AT+PWD=any value**
314 314  
315 -* (% style="color:blue" %)**AT+PUBTOPIC=any value**
357 +Successfully imported template.
316 316  
317 -* (% style="color:blue" %)**AT+SUBTOPIC=any value**
359 +[[image:image-20230809173835-8.png||height="515" width="860"]]
318 318  
319 319  
362 +Users can set UDP port.
320 320  
364 +[[image:image-20230809174053-9.png]]
365 +
366 +
367 +=== 3.5.2 Simulate Connection ===
368 +
369 +
370 +We have completed the configuration of UDP. We can try sending packets to node red.
371 +
372 +[[image:image-20230810083934-1.png]]
373 +
374 +[[image:image-20230810084048-2.png||height="535" width="1052"]]
375 +
376 +
377 +=== 3.5.3 Configure NB-IoT Sensors ===
378 +
379 +
380 +* (% style="color:blue" %)**AT+PRO=2,0(hex format) or 2,1(json format)  **(%%)** **~/~/  Set to UDP Server and  Payload
381 +
382 +* (% style="color:blue" %)**AT+SERVADDR=xx.xx.xx.xx,port   **(%%)** **~/~/  Set Server IP and  port
383 +
384 +
385 +
321 321  == 3.6 ThingsBoard.Cloud (via MQTT) ==
322 322  
323 323  === 3.6.1 Configure ThingsBoard ===
... ... @@ -327,7 +327,7 @@
327 327  
328 328  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
329 329  
330 -[[image:image-20230802112413-32.png]]
395 +[[image:image-20230802112413-32.png||height="583" width="1066"]]
331 331  
332 332  
333 333  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
... ... @@ -339,7 +339,7 @@
339 339  
340 340  To create an uplink converter go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page and click (% style="color:blue" %)**“plus”** (%%)button. Name it (% style="color:blue" %)**“MQTT Uplink Converter”**(%%) and select type (% style="color:blue" %)"**Uplink"**(%%). Use debug mode for now.
341 341  
342 -[[image:image-20230802112413-33.png||height="732" width="1302"]]
407 +[[image:image-20230802112413-33.png||height="597" width="1061"]]
343 343  
344 344  
345 345  (% style="color:blue" %)**Downlink Converter**
... ... @@ -346,7 +346,7 @@
346 346  
347 347  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
348 348  
349 -[[image:image-20230802112413-34.png||height="734" width="1305"]]
414 +[[image:image-20230802112413-34.png||height="598" width="1063"]]
350 350  
351 351  (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
352 352  
... ... @@ -356,14 +356,14 @@
356 356  
357 357  Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“MQTT Integration”**(%%), select type (% style="color:blue" %)**MQTT**;
358 358  
359 -[[image:image-20230802112413-35.png||height="738" width="1312"]]
424 +[[image:image-20230802112413-35.png||height="597" width="1062"]]
360 360  
361 361  
362 362  * The next steps is to add the recently created uplink and downlink converters;
363 363  
364 -[[image:image-20230802112413-36.png||height="736" width="1308"]]
429 +[[image:image-20230802112413-36.png||height="598" width="1062"]]
365 365  
366 -[[image:image-20230802112413-37.png||height="735" width="1307"]]
431 +[[image:image-20230802112413-37.png||height="598" width="1064"]]
367 367  
368 368  
369 369  (% style="color:blue" %)**Add a topic filter:**
... ... @@ -372,7 +372,7 @@
372 372  
373 373  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
374 374  
375 -[[image:image-20230802112413-38.png||height="731" width="1300"]]
440 +[[image:image-20230802112413-38.png||height="598" width="1064"]]
376 376  
377 377  
378 378  === 3.6.2 Simulate with MQTT.fx ===
... ... @@ -380,7 +380,7 @@
380 380  
381 381  [[image:image-20230802112413-39.png]]
382 382  
383 -[[image:image-20230802112413-40.png]]
448 +[[image:image-20230802112413-40.png||height="525" width="980"]]
384 384  
385 385  
386 386  === 3.6.3 Configure NB-IoT Sensor ===
... ... @@ -402,11 +402,11 @@
402 402  
403 403  Test Uplink by click the button for 1 second
404 404  
405 -[[image:image-20230802112413-41.png]]
470 +[[image:image-20230802112413-41.png||height="496" width="828"]]
406 406  
407 407  [[image:image-20230802112413-42.png]]
408 408  
409 -[[image:image-20230802112413-43.png]]
474 +[[image:image-20230802112413-43.png||height="407" width="825"]]
410 410  
411 411  
412 412  == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
... ... @@ -448,8 +448,6 @@
448 448  
449 449  * (% style="color:#037691" %)**SUBTOPIC: “Any value”**
450 450  
451 -
452 -
453 453  (% style="color:blue" %)**AT command:**
454 454  
455 455  * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
... ... @@ -468,14 +468,16 @@
468 468  
469 469  === 3.7.2 Simulate with MQTT.fx ===
470 470  
534 +
471 471  [[image:image-20230802112413-52.png]]
472 472  
473 473  
474 -[[image:image-20230808105300-2.png]]
538 +[[image:image-20230808105300-2.png||height="553" width="1026"]]
475 475  
540 +
476 476  Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
477 477  
478 -[[image:image-20230808105217-1.png]]
543 +[[image:image-20230808105217-1.png||height="556" width="1031"]]
479 479  
480 480  [[image:image-20230808105329-3.png]]
481 481  
... ... @@ -483,12 +483,11 @@
483 483  === 3.7.3 tago data ===
484 484  
485 485  
486 -[[image:image-20230802112413-50.png]]
551 +[[image:image-20230802112413-50.png||height="242" width="1037"]]
487 487  
488 488  [[image:image-20230802112413-51.png||height="184" width="696"]]
489 489  
490 490  
491 -
492 492  == 3.8 TCP Connection ==
493 493  
494 494  
... ... @@ -501,6 +501,7 @@
501 501  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
502 502  
503 503  
568 +
504 504  (% style="color:blue" %)**Sensor Console Output when Uplink:**
505 505  
506 506  [[image:image-20230807233631-1.png]]
... ... @@ -510,5 +510,3 @@
510 510  
511 511  [[image:image-20230807233631-2.png]]
512 512  
513 -
514 -
image-20230809165928-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +74.4 KB
Content
image-20230809170225-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +39.9 KB
Content
image-20230809170532-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +38.7 KB
Content
image-20230809173127-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +82.5 KB
Content
image-20230809173310-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +51.9 KB
Content
image-20230809173438-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +41.0 KB
Content
image-20230809173800-7.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +46.8 KB
Content
image-20230809173835-8.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +88.8 KB
Content
image-20230809174053-9.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +58.0 KB
Content
image-20230809180523-10.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +91.9 KB
Content
image-20230810083934-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +85.1 KB
Content
image-20230810084048-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.David
Size
... ... @@ -1,0 +1,1 @@
1 +63.7 KB
Content
image-20230816201942-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +99.8 KB
Content