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

From version 101.1
edited by Edwin Chen
on 2023/08/16 20:20
Change comment: Uploaded new attachment "image-20230816201942-1.png", version {1}
To version 106.1
edited by Saxer Lin
on 2023/11/25 17:22
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Edwin
1 +XWiki.Saxer
Content
... ... @@ -16,7 +16,9 @@
16 16  
17 17  = 2. Attach Network =
18 18  
19 +== 2.1 General Configure to attach network ==
19 19  
21 +
20 20  To attache NB-IoT sensors to NB-IoT Network, You need to:
21 21  
22 22  1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone)
... ... @@ -40,7 +40,21 @@
40 40  |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %)
41 41  
42 42  
45 +== 2.2 Speed Up Network Attach time ==
43 43  
47 +
48 +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.
49 +
50 +(% style="color:#037691" %)**AT+QBAND?       ** (%%) ~/~/ Check what is the current used frequency band
51 +
52 +(% style="color:#037691" %)**AT+QBAND=1,4    ** (%%) ~/~/ Set to use 1 frequency band. Band4
53 +
54 +(% style="color:#037691" %)**AT+QBAND=2,8,20**  (%%) ~/~/ Set to use 2 frequency bands. Band 8 and Band 20
55 +
56 +
57 +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/]]**
58 +
59 +
44 44  = 3. Configure to connect to different servers =
45 45  
46 46  == 3.1 General UDP Connection ==
... ... @@ -54,7 +54,7 @@
54 54  
55 55  We can use PC tool to simulate UDP connection to make sure server works ok.
56 56  
57 -[[image:image-20230802112413-1.png]]
73 +[[image:image-20230802112413-1.png||height="468" width="1024"]]
58 58  
59 59  
60 60  === 3.1.2 Configure NB-IoT Sensor ===
... ... @@ -104,7 +104,7 @@
104 104  
105 105  [[image:image-20230802112413-4.png]]
106 106  
107 -[[image:image-20230802112413-5.png]]
123 +[[image:image-20230802112413-5.png||height="530" width="987"]]
108 108  
109 109  (% 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.**
110 110  
... ... @@ -116,7 +116,7 @@
116 116  
117 117  [[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.
118 118  
119 -[[image:image-20230802112413-6.png]]
135 +[[image:image-20230802112413-6.png||height="336" width="925"]]
120 120  
121 121  [[image:image-20230802112413-7.png]]
122 122  
... ... @@ -141,7 +141,6 @@
141 141  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
142 142  
143 143  
144 -
145 145  ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
146 146  
147 147  
... ... @@ -161,7 +161,7 @@
161 161  
162 162  (% style="color:blue" %)**Result: **
163 163  
164 -[[image:image-20230802112413-11.png]]
179 +[[image:image-20230802112413-11.png||height="539" width="901"]]
165 165  
166 166  
167 167  === 3.3.3 Configure NB-IoT Sensor for connection ===
... ... @@ -184,11 +184,10 @@
184 184  * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
185 185  
186 186  
187 -
188 188  ==== 3.3.3.2 Uplink Examples ====
189 189  
190 190  
191 -For S31-NB
205 +[[image:image-20230816201942-1.png]]
192 192  
193 193  For SE01-NB
194 194  
... ... @@ -219,9 +219,9 @@
219 219  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.
220 220  
221 221  
222 -[[image:image-20230802112413-12.png]]
236 +[[image:image-20230802112413-12.png||height="504" width="1011"]]
223 223  
224 -[[image:image-20230802112413-13.png]]
238 +[[image:image-20230802112413-13.png||height="331" width="978"]]
225 225  
226 226  
227 227  Below is the NB-IoT Product Table show the mapping.
... ... @@ -247,7 +247,6 @@
247 247  |(% 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" %)
248 248  
249 249  
250 -
251 251  == 3.4 [[Datacake>>https://datacake.co/]] ==
252 252  
253 253  
... ... @@ -263,16 +263,15 @@
263 263  * (% 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.
264 264  
265 265  
266 -
267 267  === 3.4.1 Create device ===
268 268  
269 269  
270 270  (% style="color:blue" %)**Add Device**(%%) in DataCake.
271 271  
272 -[[image:image-20230808162301-1.png]]
284 +[[image:image-20230808162301-1.png||height="453" width="952"]]
273 273  
274 274  
275 -[[image:image-20230808162342-2.png]]
287 +[[image:image-20230808162342-2.png||height="541" width="952"]]
276 276  
277 277  
278 278  (% style="color:blue" %)**Choose the correct model**(%%) from template.
... ... @@ -282,11 +282,11 @@
282 282  
283 283  (% 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.
284 284  
285 -[[image:image-20230808163612-7.png]]
297 +[[image:image-20230808163612-7.png||height="549" width="952"]]
286 286  
287 287  [[image:image-20230808163035-5.png]]
288 288  
289 -[[image:image-20230808163049-6.png]]
301 +[[image:image-20230808163049-6.png||height="544" width="926"]]
290 290  
291 291  
292 292  === 3.4.2 Scan QR code to obtain data ===
... ... @@ -330,7 +330,7 @@
330 330  
331 331  Please select the NB95S31B template.
332 332  
333 -[[image:image-20230809173310-5.png]]
345 +[[image:image-20230809173310-5.png||height="558" width="926"]]
334 334  
335 335  [[image:image-20230809173438-6.png]]
336 336  
... ... @@ -339,7 +339,7 @@
339 339  
340 340  Successfully imported template.
341 341  
342 -[[image:image-20230809173835-8.png]]
354 +[[image:image-20230809173835-8.png||height="515" width="860"]]
343 343  
344 344  
345 345  Users can set UDP port.
... ... @@ -354,17 +354,20 @@
354 354  
355 355  [[image:image-20230810083934-1.png]]
356 356  
357 -[[image:image-20230810084048-2.png]]
369 +[[image:image-20230810084048-2.png||height="535" width="1052"]]
358 358  
371 +
359 359  === 3.5.3 Configure NB-IoT Sensors ===
360 360  
361 361  
362 -* (% style="color:blue" %)**AT+PRO=2,0(hex format) or 2,1(json format)  **(%%)** **~/~/  Set to UDP Server and  Payload
375 +* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
376 +* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
377 +* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
378 +* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
379 +* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
380 +* (% style="color:#037691" %)**AT+PWD=“Your device token”**
363 363  
364 -* (% style="color:blue" %)**AT+SERVADDR=xx.xx.xx.xx,port   **(%%)** **~/~/  Set Server IP and  port
365 365  
366 -
367 -
368 368  == 3.6 ThingsBoard.Cloud (via MQTT) ==
369 369  
370 370  === 3.6.1 Configure ThingsBoard ===
... ... @@ -374,7 +374,7 @@
374 374  
375 375  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
376 376  
377 -[[image:image-20230802112413-32.png]]
392 +[[image:image-20230802112413-32.png||height="583" width="1066"]]
378 378  
379 379  
380 380  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
... ... @@ -386,7 +386,7 @@
386 386  
387 387  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.
388 388  
389 -[[image:image-20230802112413-33.png||height="732" width="1302"]]
404 +[[image:image-20230802112413-33.png||height="597" width="1061"]]
390 390  
391 391  
392 392  (% style="color:blue" %)**Downlink Converter**
... ... @@ -393,7 +393,7 @@
393 393  
394 394  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
395 395  
396 -[[image:image-20230802112413-34.png||height="734" width="1305"]]
411 +[[image:image-20230802112413-34.png||height="598" width="1063"]]
397 397  
398 398  (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
399 399  
... ... @@ -403,14 +403,14 @@
403 403  
404 404  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**;
405 405  
406 -[[image:image-20230802112413-35.png||height="738" width="1312"]]
421 +[[image:image-20230802112413-35.png||height="597" width="1062"]]
407 407  
408 408  
409 409  * The next steps is to add the recently created uplink and downlink converters;
410 410  
411 -[[image:image-20230802112413-36.png||height="736" width="1308"]]
426 +[[image:image-20230802112413-36.png||height="598" width="1062"]]
412 412  
413 -[[image:image-20230802112413-37.png||height="735" width="1307"]]
428 +[[image:image-20230802112413-37.png||height="598" width="1064"]]
414 414  
415 415  
416 416  (% style="color:blue" %)**Add a topic filter:**
... ... @@ -419,7 +419,7 @@
419 419  
420 420  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
421 421  
422 -[[image:image-20230802112413-38.png||height="731" width="1300"]]
437 +[[image:image-20230802112413-38.png||height="598" width="1064"]]
423 423  
424 424  
425 425  === 3.6.2 Simulate with MQTT.fx ===
... ... @@ -427,7 +427,7 @@
427 427  
428 428  [[image:image-20230802112413-39.png]]
429 429  
430 -[[image:image-20230802112413-40.png]]
445 +[[image:image-20230802112413-40.png||height="525" width="980"]]
431 431  
432 432  
433 433  === 3.6.3 Configure NB-IoT Sensor ===
... ... @@ -449,11 +449,11 @@
449 449  
450 450  Test Uplink by click the button for 1 second
451 451  
452 -[[image:image-20230802112413-41.png]]
467 +[[image:image-20230802112413-41.png||height="496" width="828"]]
453 453  
454 454  [[image:image-20230802112413-42.png]]
455 455  
456 -[[image:image-20230802112413-43.png]]
471 +[[image:image-20230802112413-43.png||height="407" width="825"]]
457 457  
458 458  
459 459  == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
... ... @@ -510,7 +510,6 @@
510 510  * (% style="color:#037691" %)**AT+PWD=“Your device token”**
511 511  
512 512  
513 -
514 514  === 3.7.2 Simulate with MQTT.fx ===
515 515  
516 516  
... ... @@ -517,12 +517,12 @@
517 517  [[image:image-20230802112413-52.png]]
518 518  
519 519  
520 -[[image:image-20230808105300-2.png]]
534 +[[image:image-20230808105300-2.png||height="553" width="1026"]]
521 521  
522 522  
523 523  Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
524 524  
525 -[[image:image-20230808105217-1.png]]
539 +[[image:image-20230808105217-1.png||height="556" width="1031"]]
526 526  
527 527  [[image:image-20230808105329-3.png]]
528 528  
... ... @@ -530,7 +530,7 @@
530 530  === 3.7.3 tago data ===
531 531  
532 532  
533 -[[image:image-20230802112413-50.png]]
547 +[[image:image-20230802112413-50.png||height="242" width="1037"]]
534 534  
535 535  [[image:image-20230802112413-51.png||height="184" width="696"]]
536 536  
... ... @@ -546,6 +546,7 @@
546 546  
547 547  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
548 548  
563 +
549 549  (% style="color:blue" %)**Sensor Console Output when Uplink:**
550 550  
551 551  [[image:image-20230807233631-1.png]]