Last modified by Mengting Qiu on 2025/07/03 18:55
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 13 added, 0 removed)
- image-20230809165928-1.png
- image-20230809170225-2.png
- image-20230809170532-3.png
- image-20230809173127-4.png
- image-20230809173310-5.png
- image-20230809173438-6.png
- image-20230809173800-7.png
- image-20230809173835-8.png
- image-20230809174053-9.png
- image-20230809180523-10.png
- image-20230810083934-1.png
- image-20230810084048-2.png
- image-20230816201942-1.png
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-NB208 +[[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** 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) or3,5(jsonformat)**(%%) **~/~/ Setto mqtt Server andPayload**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="7 32" 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="7 38" 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