Skip to Content
Last modified by Mengting Qiu on 2025/07/03 18:55
From version 95.1
edited by David Huang
on 2023/08/09 18:05
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.David
1 +XWiki.Xiaoling
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  
... ... @@ -35,6 +35,23 @@
35 35  |(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %)
36 36  |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %)
37 37  
44 +
45 +
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 +
38 38  = 3. Configure to connect to different servers =
39 39  
40 40  == 3.1 General UDP Connection ==
... ... @@ -48,7 +48,7 @@
48 48  
49 49  We can use PC tool to simulate UDP connection to make sure server works ok.
50 50  
51 -[[image:image-20230802112413-1.png]]
74 +[[image:image-20230802112413-1.png||height="468" width="1024"]]
52 52  
53 53  
54 54  === 3.1.2 Configure NB-IoT Sensor ===
... ... @@ -98,7 +98,7 @@
98 98  
99 99  [[image:image-20230802112413-4.png]]
100 100  
101 -[[image:image-20230802112413-5.png]]
124 +[[image:image-20230802112413-5.png||height="530" width="987"]]
102 102  
103 103  (% 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.**
104 104  
... ... @@ -110,7 +110,7 @@
110 110  
111 111  [[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.
112 112  
113 -[[image:image-20230802112413-6.png]]
136 +[[image:image-20230802112413-6.png||height="336" width="925"]]
114 114  
115 115  [[image:image-20230802112413-7.png]]
116 116  
... ... @@ -134,6 +134,8 @@
134 134  
135 135  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
136 136  
160 +
161 +
137 137  ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
138 138  
139 139  
... ... @@ -153,7 +153,7 @@
153 153  
154 154  (% style="color:blue" %)**Result: **
155 155  
156 -[[image:image-20230802112413-11.png]]
181 +[[image:image-20230802112413-11.png||height="539" width="901"]]
157 157  
158 158  
159 159  === 3.3.3 Configure NB-IoT Sensor for connection ===
... ... @@ -163,7 +163,7 @@
163 163  
164 164  In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
165 165  
166 -* (% style="color:blue" %)**AT+PRO=3,1** (%%) **~/~/ Set to use ThingSpeak Server and Related Payload**
191 +* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
167 167  
168 168  * (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
169 169  
... ... @@ -175,10 +175,12 @@
175 175  
176 176  * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
177 177  
203 +
204 +
178 178  ==== 3.3.3.2 Uplink Examples ====
179 179  
180 180  
181 -For S31-NB
208 +[[image:image-20230816201942-1.png]]
182 182  
183 183  For SE01-NB
184 184  
... ... @@ -209,9 +209,9 @@
209 209  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.
210 210  
211 211  
212 -[[image:image-20230802112413-12.png]]
239 +[[image:image-20230802112413-12.png||height="504" width="1011"]]
213 213  
214 -[[image:image-20230802112413-13.png]]
241 +[[image:image-20230802112413-13.png||height="331" width="978"]]
215 215  
216 216  
217 217  Below is the NB-IoT Product Table show the mapping.
... ... @@ -236,27 +236,47 @@
236 236  |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod5|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:151px" %)exit_state/input PA4|(% colspan="1" style="width:160px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
237 237  |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod6|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)count|(% colspan="1" style="width:153px" %) |(% colspan="1" style="width:151px" %) |(% colspan="1" style="width:160px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
238 238  
239 -== 3.4 Datacake ==
240 240  
267 +
268 +== 3.4 [[Datacake>>https://datacake.co/]] ==
269 +
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 +
241 241  === 3.4.1 Create device ===
242 242  
243 243  
244 -[[image:image-20230808162301-1.png]]
287 +(% style="color:blue" %)**Add Device**(%%) in DataCake.
245 245  
289 +[[image:image-20230808162301-1.png||height="453" width="952"]]
246 246  
247 -[[image:image-20230808162342-2.png]]
248 248  
292 +[[image:image-20230808162342-2.png||height="541" width="952"]]
249 249  
294 +
295 +(% style="color:blue" %)**Choose the correct model**(%%) from template.
296 +
250 250  [[image:image-20230808162421-3.png]]
251 251  
252 252  
253 -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.
254 254  
255 -[[image:image-20230808163612-7.png]]
302 +[[image:image-20230808163612-7.png||height="549" width="952"]]
256 256  
257 257  [[image:image-20230808163035-5.png]]
258 258  
259 -[[image:image-20230808163049-6.png]]
306 +[[image:image-20230808163049-6.png||height="544" width="926"]]
260 260  
261 261  
262 262  === 3.4.2 Scan QR code to obtain data ===
... ... @@ -264,7 +264,7 @@
264 264  
265 265  Users can use their phones or computers to scan QR codes to obtain device data information.
266 266  
267 -[[image:image-20230808170051-8.png]]
314 +[[image:image-20230808170051-8.png||height="255" width="259"]]
268 268  
269 269  [[image:image-20230808170548-9.png]]
270 270  
... ... @@ -297,17 +297,19 @@
297 297  
298 298  [[image:image-20230809173127-4.png]]
299 299  
347 +
300 300  Please select the NB95S31B template.
301 301  
302 -[[image:image-20230809173310-5.png]]
350 +[[image:image-20230809173310-5.png||height="558" width="926"]]
303 303  
304 304  [[image:image-20230809173438-6.png]]
305 305  
306 306  [[image:image-20230809173800-7.png]]
307 307  
356 +
308 308  Successfully imported template.
309 309  
310 -[[image:image-20230809173835-8.png]]
359 +[[image:image-20230809173835-8.png||height="515" width="860"]]
311 311  
312 312  
313 313  Users can set UDP port.
... ... @@ -314,20 +314,26 @@
314 314  
315 315  [[image:image-20230809174053-9.png]]
316 316  
366 +
317 317  === 3.5.2 Simulate Connection ===
318 318  
369 +
319 319  We have completed the configuration of UDP. We can try sending packets to node red.
320 320  
321 -[[image:image-20230809180523-10.png]]
372 +[[image:image-20230810083934-1.png]]
322 322  
374 +[[image:image-20230810084048-2.png||height="535" width="1052"]]
323 323  
376 +
324 324  === 3.5.3 Configure NB-IoT Sensors ===
325 325  
326 326  
327 -* (% style="color:blue" %)**AT+PRO=2,0(hex format) or 2,1(json format)**(%%)    **~/~/  Set to UDP Server and  Payload**
380 +* (% style="color:blue" %)**AT+PRO=2,0(hex format) or 2,1(json format)  **(%%)** **~/~/  Set to UDP Server and  Payload
328 328  
329 -* **AT+SERVADDR=xx.xx.xx.xx,port   ** **~/~/  Set Server IP and  port**
382 +* (% style="color:blue" %)**AT+SERVADDR=xx.xx.xx.xx,port   **(%%)** **~/~/  Set Server IP and  port
330 330  
384 +
385 +
331 331  == 3.6 ThingsBoard.Cloud (via MQTT) ==
332 332  
333 333  === 3.6.1 Configure ThingsBoard ===
... ... @@ -337,7 +337,7 @@
337 337  
338 338  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
339 339  
340 -[[image:image-20230802112413-32.png]]
395 +[[image:image-20230802112413-32.png||height="583" width="1066"]]
341 341  
342 342  
343 343  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
... ... @@ -349,7 +349,7 @@
349 349  
350 350  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.
351 351  
352 -[[image:image-20230802112413-33.png||height="732" width="1302"]]
407 +[[image:image-20230802112413-33.png||height="597" width="1061"]]
353 353  
354 354  
355 355  (% style="color:blue" %)**Downlink Converter**
... ... @@ -356,7 +356,7 @@
356 356  
357 357  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
358 358  
359 -[[image:image-20230802112413-34.png||height="734" width="1305"]]
414 +[[image:image-20230802112413-34.png||height="598" width="1063"]]
360 360  
361 361  (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
362 362  
... ... @@ -366,14 +366,14 @@
366 366  
367 367  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**;
368 368  
369 -[[image:image-20230802112413-35.png||height="738" width="1312"]]
424 +[[image:image-20230802112413-35.png||height="597" width="1062"]]
370 370  
371 371  
372 372  * The next steps is to add the recently created uplink and downlink converters;
373 373  
374 -[[image:image-20230802112413-36.png||height="736" width="1308"]]
429 +[[image:image-20230802112413-36.png||height="598" width="1062"]]
375 375  
376 -[[image:image-20230802112413-37.png||height="735" width="1307"]]
431 +[[image:image-20230802112413-37.png||height="598" width="1064"]]
377 377  
378 378  
379 379  (% style="color:blue" %)**Add a topic filter:**
... ... @@ -382,7 +382,7 @@
382 382  
383 383  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
384 384  
385 -[[image:image-20230802112413-38.png||height="731" width="1300"]]
440 +[[image:image-20230802112413-38.png||height="598" width="1064"]]
386 386  
387 387  
388 388  === 3.6.2 Simulate with MQTT.fx ===
... ... @@ -390,7 +390,7 @@
390 390  
391 391  [[image:image-20230802112413-39.png]]
392 392  
393 -[[image:image-20230802112413-40.png]]
448 +[[image:image-20230802112413-40.png||height="525" width="980"]]
394 394  
395 395  
396 396  === 3.6.3 Configure NB-IoT Sensor ===
... ... @@ -412,11 +412,11 @@
412 412  
413 413  Test Uplink by click the button for 1 second
414 414  
415 -[[image:image-20230802112413-41.png]]
470 +[[image:image-20230802112413-41.png||height="496" width="828"]]
416 416  
417 417  [[image:image-20230802112413-42.png]]
418 418  
419 -[[image:image-20230802112413-43.png]]
474 +[[image:image-20230802112413-43.png||height="407" width="825"]]
420 420  
421 421  
422 422  == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
... ... @@ -472,16 +472,20 @@
472 472  
473 473  * (% style="color:#037691" %)**AT+PWD=“Your device token”**
474 474  
530 +
531 +
475 475  === 3.7.2 Simulate with MQTT.fx ===
476 476  
534 +
477 477  [[image:image-20230802112413-52.png]]
478 478  
479 479  
480 -[[image:image-20230808105300-2.png]]
538 +[[image:image-20230808105300-2.png||height="553" width="1026"]]
481 481  
540 +
482 482  Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
483 483  
484 -[[image:image-20230808105217-1.png]]
543 +[[image:image-20230808105217-1.png||height="556" width="1031"]]
485 485  
486 486  [[image:image-20230808105329-3.png]]
487 487  
... ... @@ -489,12 +489,11 @@
489 489  === 3.7.3 tago data ===
490 490  
491 491  
492 -[[image:image-20230802112413-50.png]]
551 +[[image:image-20230802112413-50.png||height="242" width="1037"]]
493 493  
494 494  [[image:image-20230802112413-51.png||height="184" width="696"]]
495 495  
496 496  
497 -
498 498  == 3.8 TCP Connection ==
499 499  
500 500  
... ... @@ -506,6 +506,8 @@
506 506  
507 507  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
508 508  
567 +
568 +
509 509  (% style="color:blue" %)**Sensor Console Output when Uplink:**
510 510  
511 511  [[image:image-20230807233631-1.png]]
... ... @@ -515,4 +515,3 @@
515 515  
516 516  [[image:image-20230807233631-2.png]]
517 517  
518 -
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