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

From version 99.3
edited by Xiaoling
on 2023/08/11 11:48
Change comment: There is no comment for this version
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.Xiaoling
1 +XWiki.Saxer
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,7 +12,9 @@
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)
... ... @@ -36,7 +36,21 @@
36 36  |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %)
37 37  
38 38  
45 +== 2.2 Speed Up Network Attach time ==
39 39  
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 +
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]]
73 +[[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]]
123 +[[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]]
135 +[[image:image-20230802112413-6.png||height="336" width="925"]]
116 116  
117 117  [[image:image-20230802112413-7.png]]
118 118  
... ... @@ -137,7 +137,6 @@
137 137  * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
138 138  
139 139  
140 -
141 141  ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
142 142  
143 143  
... ... @@ -157,7 +157,7 @@
157 157  
158 158  (% style="color:blue" %)**Result: **
159 159  
160 -[[image:image-20230802112413-11.png]]
179 +[[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,11 +180,10 @@
180 180  * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
181 181  
182 182  
183 -
184 184  ==== 3.3.3.2 Uplink Examples ====
185 185  
186 186  
187 -For S31-NB
205 +[[image:image-20230816201942-1.png]]
188 188  
189 189  For SE01-NB
190 190  
... ... @@ -215,9 +215,9 @@
215 215  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.
216 216  
217 217  
218 -[[image:image-20230802112413-12.png]]
236 +[[image:image-20230802112413-12.png||height="504" width="1011"]]
219 219  
220 -[[image:image-20230802112413-13.png]]
238 +[[image:image-20230802112413-13.png||height="331" width="978"]]
221 221  
222 222  
223 223  Below is the NB-IoT Product Table show the mapping.
... ... @@ -243,28 +243,44 @@
243 243  |(% 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" %)
244 244  
245 245  
264 +== 3.4 [[Datacake>>https://datacake.co/]] ==
246 246  
247 -== 3.4 Datacake ==
248 248  
267 +(% class="wikigeneratedid" %)
268 +Dragino NB-IoT sensors has its template in **[[Datacake>>https://datacake.co/]]** Platform. There are two version for NB Sensor,
269 +
270 +
271 +(% class="wikigeneratedid" %)
272 +As example for S31B-NB. there are two versions: **S31B-NB-1D and S31B-NB-GE.**
273 +
274 +* (% 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.
275 +
276 +* (% 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.
277 +
278 +
249 249  === 3.4.1 Create device ===
250 250  
251 251  
252 -[[image:image-20230808162301-1.png]]
282 +(% style="color:blue" %)**Add Device**(%%) in DataCake.
253 253  
284 +[[image:image-20230808162301-1.png||height="453" width="952"]]
254 254  
255 -[[image:image-20230808162342-2.png]]
256 256  
287 +[[image:image-20230808162342-2.png||height="541" width="952"]]
257 257  
289 +
290 +(% style="color:blue" %)**Choose the correct model**(%%) from template.
291 +
258 258  [[image:image-20230808162421-3.png]]
259 259  
260 260  
261 -The device ID needs to be filled in with IMEI, and a prefix of** 'f' **needs to be added.
295 +(% 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.
262 262  
263 -[[image:image-20230808163612-7.png]]
297 +[[image:image-20230808163612-7.png||height="549" width="952"]]
264 264  
265 265  [[image:image-20230808163035-5.png]]
266 266  
267 -[[image:image-20230808163049-6.png]]
301 +[[image:image-20230808163049-6.png||height="544" width="926"]]
268 268  
269 269  
270 270  === 3.4.2 Scan QR code to obtain data ===
... ... @@ -272,7 +272,7 @@
272 272  
273 273  Users can use their phones or computers to scan QR codes to obtain device data information.
274 274  
275 -[[image:image-20230808170051-8.png]]
309 +[[image:image-20230808170051-8.png||height="255" width="259"]]
276 276  
277 277  [[image:image-20230808170548-9.png]]
278 278  
... ... @@ -308,7 +308,7 @@
308 308  
309 309  Please select the NB95S31B template.
310 310  
311 -[[image:image-20230809173310-5.png]]
345 +[[image:image-20230809173310-5.png||height="558" width="926"]]
312 312  
313 313  [[image:image-20230809173438-6.png]]
314 314  
... ... @@ -317,7 +317,7 @@
317 317  
318 318  Successfully imported template.
319 319  
320 -[[image:image-20230809173835-8.png]]
354 +[[image:image-20230809173835-8.png||height="515" width="860"]]
321 321  
322 322  
323 323  Users can set UDP port.
... ... @@ -332,17 +332,20 @@
332 332  
333 333  [[image:image-20230810083934-1.png]]
334 334  
335 -[[image:image-20230810084048-2.png]]
369 +[[image:image-20230810084048-2.png||height="535" width="1052"]]
336 336  
371 +
337 337  === 3.5.3 Configure NB-IoT Sensors ===
338 338  
339 339  
340 -* (% 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”**
341 341  
342 -* (% style="color:blue" %)**AT+SERVADDR=xx.xx.xx.xx,port   **(%%)** **~/~/  Set Server IP and  port
343 343  
344 -
345 -
346 346  == 3.6 ThingsBoard.Cloud (via MQTT) ==
347 347  
348 348  === 3.6.1 Configure ThingsBoard ===
... ... @@ -352,7 +352,7 @@
352 352  
353 353  Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
354 354  
355 -[[image:image-20230802112413-32.png]]
392 +[[image:image-20230802112413-32.png||height="583" width="1066"]]
356 356  
357 357  
358 358  ==== 3.6.1.2 Create Uplink & Downlink Converter ====
... ... @@ -364,7 +364,7 @@
364 364  
365 365  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.
366 366  
367 -[[image:image-20230802112413-33.png||height="732" width="1302"]]
404 +[[image:image-20230802112413-33.png||height="597" width="1061"]]
368 368  
369 369  
370 370  (% style="color:blue" %)**Downlink Converter**
... ... @@ -371,7 +371,7 @@
371 371  
372 372  The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
373 373  
374 -[[image:image-20230802112413-34.png||height="734" width="1305"]]
411 +[[image:image-20230802112413-34.png||height="598" width="1063"]]
375 375  
376 376  (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
377 377  
... ... @@ -381,14 +381,14 @@
381 381  
382 382  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**;
383 383  
384 -[[image:image-20230802112413-35.png||height="738" width="1312"]]
421 +[[image:image-20230802112413-35.png||height="597" width="1062"]]
385 385  
386 386  
387 387  * The next steps is to add the recently created uplink and downlink converters;
388 388  
389 -[[image:image-20230802112413-36.png||height="736" width="1308"]]
426 +[[image:image-20230802112413-36.png||height="598" width="1062"]]
390 390  
391 -[[image:image-20230802112413-37.png||height="735" width="1307"]]
428 +[[image:image-20230802112413-37.png||height="598" width="1064"]]
392 392  
393 393  
394 394  (% style="color:blue" %)**Add a topic filter:**
... ... @@ -397,7 +397,7 @@
397 397  
398 398  You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
399 399  
400 -[[image:image-20230802112413-38.png||height="731" width="1300"]]
437 +[[image:image-20230802112413-38.png||height="598" width="1064"]]
401 401  
402 402  
403 403  === 3.6.2 Simulate with MQTT.fx ===
... ... @@ -405,7 +405,7 @@
405 405  
406 406  [[image:image-20230802112413-39.png]]
407 407  
408 -[[image:image-20230802112413-40.png]]
445 +[[image:image-20230802112413-40.png||height="525" width="980"]]
409 409  
410 410  
411 411  === 3.6.3 Configure NB-IoT Sensor ===
... ... @@ -427,11 +427,11 @@
427 427  
428 428  Test Uplink by click the button for 1 second
429 429  
430 -[[image:image-20230802112413-41.png]]
467 +[[image:image-20230802112413-41.png||height="496" width="828"]]
431 431  
432 432  [[image:image-20230802112413-42.png]]
433 433  
434 -[[image:image-20230802112413-43.png]]
471 +[[image:image-20230802112413-43.png||height="407" width="825"]]
435 435  
436 436  
437 437  == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
... ... @@ -488,7 +488,6 @@
488 488  * (% style="color:#037691" %)**AT+PWD=“Your device token”**
489 489  
490 490  
491 -
492 492  === 3.7.2 Simulate with MQTT.fx ===
493 493  
494 494  
... ... @@ -495,12 +495,12 @@
495 495  [[image:image-20230802112413-52.png]]
496 496  
497 497  
498 -[[image:image-20230808105300-2.png]]
534 +[[image:image-20230808105300-2.png||height="553" width="1026"]]
499 499  
500 500  
501 501  Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
502 502  
503 -[[image:image-20230808105217-1.png]]
539 +[[image:image-20230808105217-1.png||height="556" width="1031"]]
504 504  
505 505  [[image:image-20230808105329-3.png]]
506 506  
... ... @@ -508,7 +508,7 @@
508 508  === 3.7.3 tago data ===
509 509  
510 510  
511 -[[image:image-20230802112413-50.png]]
547 +[[image:image-20230802112413-50.png||height="242" width="1037"]]
512 512  
513 513  [[image:image-20230802112413-51.png||height="184" width="696"]]
514 514  
... ... @@ -524,6 +524,7 @@
524 524  
525 525  * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
526 526  
563 +
527 527  (% style="color:blue" %)**Sensor Console Output when Uplink:**
528 528  
529 529  [[image:image-20230807233631-1.png]]
image-20230816201942-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +99.8 KB
Content