Last modified by Kilight Cao on 2025/07/23 16:27
From version 53.10
edited by Xiaoling
on 2023/08/02 12:04
on 2023/08/02 12:04
Change comment:
There is no comment for this version
To version 134.1
edited by Edwin Chen
on 2024/02/08 00:17
on 2024/02/08 00:17
Change comment:
Uploaded new attachment "image-20240208001740-1.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 45 added, 0 removed)
- image-20230807233631-1.png
- image-20230807233631-2.png
- image-20230808105217-1.png
- image-20230808105300-2.png
- image-20230808105329-3.png
- image-20230808162301-1.png
- image-20230808162342-2.png
- image-20230808162421-3.png
- image-20230808162727-4.png
- image-20230808163035-5.png
- image-20230808163049-6.png
- image-20230808163612-7.png
- image-20230808170051-8.png
- image-20230808170548-9.png
- image-20230808205045-1.png
- 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
- image-20240129170024-1.png
- image-20240129170216-2.png
- image-20240129170539-3.png
- image-20240129171029-4.png
- image-20240129171113-5.png
- image-20240129171236-6.png
- image-20240129172056-7.png
- image-20240129172136-8.png
- image-20240129173116-9.png
- image-20240129173541-10.png
- image-20240129174518-11.png
- image-20240129174657-12.png
- image-20240129174840-13.png
- image-20240202111546-1.png
- image-20240207002003-1.png
- image-20240207002129-2.png
- image-20240208001740-1.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - Content
-
... ... @@ -1,4 +1,4 @@ 1 -(% class="wikigeneratedid" %) 1 +(% class="wikigeneratedid" id="HTableofContents:" %) 2 2 **Table of Contents:** 3 3 4 4 {{toc/}} ... ... @@ -5,6 +5,9 @@ 5 5 6 6 7 7 8 + 9 + 10 + 8 8 = 1. The use of this guideline = 9 9 10 10 ... ... @@ -11,20 +11,55 @@ 11 11 This configure instruction is for Dragino NB-IoT models with -NB or -NS suffix, for example DDS75-NB. These models use the same NB-IoT Module **[[BC660K-GL>>https://www.quectel.com/product/lpwa-bc660k-gl-nb2]]** and has the same software structure. The have the same configure instruction to different IoT servers. Use can follow the instruction here to see how to configure to connect to those servers. 12 12 13 13 14 -= 2. Network Connection=17 += 2. Attach Network = 15 15 19 +== 2.1 General Configure to attach network == 16 16 21 + 22 +To attache NB-IoT sensors to NB-IoT Network, You need to: 23 + 24 +1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone) 25 +1. Insert the SIM card to Sensor 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>) 27 + 28 +[[image:image-20230808205045-1.png||height="293" width="438"]] 29 + 30 +After doing above, the NB-IoT Sensors should be able to attach to NB-IoT network . 31 + 17 17 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. 18 18 19 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width: 510px" %)20 -|(% style="background-color:#4f81bd; color:white" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white" %)**APN**|(% style="background-color:#4f81bd; color:white" %)**NB-IoT Coverage**|(% style="background-color:#4f81bd; color:white" %)**Comments** 21 -|1NCE| ||22 - |ChinaMobile| | |34 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %) 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** 36 +|(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:474px" %)((( 37 +**[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]** 23 23 24 -== 2.1 1NCE SIM Card. == 39 +Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands 40 +)))|(% style="width:135px" %) 41 +|(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %) 42 +|(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %) 25 25 44 +== 2.2 Speed Up Network Attach time == 26 26 27 27 47 +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 and show Signal Strenght:99. User can lock the band to specify band for its operator to make this faster. 48 + 49 +(% style="color:#037691" %)**AT+QBAND? **(%%) ~/~/ Check what is the current used frequency band 50 + 51 +(% style="color:#037691" %)**AT+QBAND=1,4 **(%%) ~/~/ Set to use 1 frequency band. Band4 52 + 53 +(% style="color:#037691" %)**Europe General**(%%) **AT+QBAND=2,8,20 ** ~/~/ Set to use 2 frequency bands. Band 8 and Band 20 54 + 55 +(% style="color:#037691" %)**Verizon**(%%)** ** AT+QBAND=1,13 56 +(% style="color:#037691" %)**AT&T**(%%) AT+QBAND=3,12,4,2 57 +(% style="color:#037691" %)**Telstra**(%%) AT+QBAND=1,28 58 +(% style="color:#037691" %)**Softband**(%%) AT+QBAND=2,3,8 59 + 60 +After connection is successful, user can use (% style="color:#037691" %)**AT+QENG=0 **(%%) to check which band is actually in used. 61 + 62 + 63 +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/]]** 64 + 65 + 28 28 = 3. Configure to connect to different servers = 29 29 30 30 == 3.1 General UDP Connection == ... ... @@ -38,7 +38,7 @@ 38 38 39 39 We can use PC tool to simulate UDP connection to make sure server works ok. 40 40 41 -[[image:image-20230802112413-1.png]] 79 +[[image:image-20230802112413-1.png||height="468" width="1024"]] 42 42 43 43 44 44 === 3.1.2 Configure NB-IoT Sensor === ... ... @@ -88,7 +88,7 @@ 88 88 89 89 [[image:image-20230802112413-4.png]] 90 90 91 -[[image:image-20230802112413-5.png]] 129 +[[image:image-20230802112413-5.png||height="530" width="987"]] 92 92 93 93 (% 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.** 94 94 ... ... @@ -100,14 +100,14 @@ 100 100 101 101 [[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. 102 102 103 -[[image:image-20230802112413-6.png]] 141 +[[image:image-20230802112413-6.png||height="336" width="925"]] 104 104 105 105 [[image:image-20230802112413-7.png]] 106 106 107 107 108 -== 3.3.2 Simulate with MQTT.fx == 146 +=== 3.3.2 Simulate with MQTT.fx === 109 109 110 -=== 3.3.2.1 Establish MQTT Connection === 148 +==== 3.3.2.1 Establish MQTT Connection ==== 111 111 112 112 113 113 After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine. ... ... @@ -124,14 +124,14 @@ 124 124 125 125 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password> 126 126 165 +==== 3.3.2.2 Publish Data to ThingSpeak Channel ==== 127 127 128 128 129 -=== 3.3.2.2 Publish Data to ThingSpeak Channel === 130 - 131 131 [[image:image-20230802112413-9.png]] 132 132 133 133 [[image:image-20230802112413-10.png]] 134 134 172 + 135 135 (% style="color:blue" %)**In MQTT.fx, we can publish below info:** 136 136 137 137 * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish ... ... @@ -143,35 +143,33 @@ 143 143 144 144 (% style="color:blue" %)**Result: ** 145 145 146 -[[image:image-20230802112413-11.png]] 184 +[[image:image-20230802112413-11.png||height="539" width="901"]] 147 147 148 148 149 -== 3.3 187 +=== 3.3.3 Configure NB-IoT Sensor for connection === 150 150 151 -=== 3.3.1 AT Commands: === 189 +==== 3.3.3.1 AT Commands: ==== 152 152 153 153 154 154 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx 155 155 156 -* **AT+PRO=3,1** 194 +* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload 157 157 158 -* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 196 +* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 159 159 160 -* **AT+UNAME=<Your ThingSpeak MQTT User Name>** 198 +* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>** 161 161 162 -* **AT+PWD=<Your ThingSpeak MQTT Password>** 200 +* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>** 163 163 164 -* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 202 +* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 165 165 166 -* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 204 +* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 167 167 206 +==== 3.3.3.2 Uplink Examples ==== 168 168 169 169 170 - === 3.3.2 Uplink Examples ===209 +[[image:image-20230816201942-1.png]] 171 171 172 - 173 -For S31-NB 174 - 175 175 For SE01-NB 176 176 177 177 For DDS20-NB ... ... @@ -195,339 +195,305 @@ 195 195 For SN50V3-NB 196 196 197 197 198 -=== 3.3.3 234 +==== 3.3.3.3 Map fields to sensor value ==== 199 199 200 200 201 201 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. 202 202 203 203 204 -[[image:image-20230802112413-12.png]] 240 +[[image:image-20230802112413-12.png||height="504" width="1011"]] 205 205 206 -[[image:image-20230802112413-13.png]] 242 +[[image:image-20230802112413-13.png||height="331" width="978"]] 207 207 208 208 209 209 Below is the NB-IoT Product Table show the mapping. 210 210 211 -|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %)Field1|(% colspan="1" rowspan="1" %)Field2|(% colspan="1" rowspan="1" %)Field3|(% colspan="1" rowspan="1" %)Field4|(% colspan="1" rowspan="1" %)Field5|(% colspan="1" rowspan="1" %)Field6|(% colspan="1" rowspan="1" %)Field7|(% colspan="1" rowspan="1" %)Field8|(% colspan="1" rowspan="1" %)((( 212 -Field9 247 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1424px" %) 248 +|(% style="background-color:#4f81bd; width:143px" %) |(% style="background-color:#4f81bd; color:white; width:103px" %)Field1|(% style="background-color:#4f81bd; color:white; width:102px" %)Field2|(% style="background-color:#4f81bd; color:white; width:157px" %)Field3|(% style="background-color:#4f81bd; color:white; width:154px" %)Field4|(% style="background-color:#4f81bd; color:white; width:153px" %)Field5|(% style="background-color:#4f81bd; color:white; width:151px" %)Field6|(% style="background-color:#4f81bd; color:white; width:160px" %)Field7|(% style="background-color:#4f81bd; color:white; width:152px" %)Field8|(% style="background-color:#4f81bd; color:white; width:67px" %)Field9|(% style="background-color:#4f81bd; color:white; width:69px" %)Field10 249 +|(% style="background-color:#4f81bd; color:white; width:143px" %)S31x-NB|(% style="width:103px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 250 +|(% style="background-color:#4f81bd; color:white; width:143px" %)SE01-NB|(% style="width:103px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:157px" %)conduct|(% style="width:154px" %)dielectric_constant|(% style="width:153px" %)Battery|(% style="width:151px" %)RSSI|(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 251 +|(% style="background-color:#4f81bd; color:white; width:143px" %)DDS20-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 252 +|(% style="background-color:#4f81bd; color:white; width:143px" %)DDS45-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 253 +|(% style="background-color:#4f81bd; color:white; width:143px" %)DDS75-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 254 +|(% style="background-color:#4f81bd; color:white; width:143px" %)NMDS120-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 255 +|(% rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SPH01-NB|(% style="width:103px" %)ph|(% style="width:102px" %)Temperature|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% colspan="1" rowspan="1" style="width:69px" %) 256 +|(% style="background-color:#4f81bd; color:white; width:143px" %)NLM01-NB|(% style="width:103px" %)Humidity|(% style="width:102px" %)Temperature|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 257 +|(% style="background-color:#4f81bd; color:white; width:143px" %)NMDS200-NB|(% style="width:103px" %)distance1|(% style="width:102px" %)distance2|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 258 +|(% style="background-color:#4f81bd; color:white; width:143px" %)CPN01-NB|(% style="width:103px" %)alarm|(% style="width:102px" %)count|(% style="width:157px" %)door open duration|(% style="width:154px" %)calc flag|(% style="width:153px" %)Battery|(% style="width:151px" %)RSSI|(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %) 259 +|(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)DS03A-NB|(% colspan="1" rowspan="1" style="width:103px" %)level|(% colspan="1" rowspan="1" style="width:102px" %)alarm|(% colspan="1" rowspan="1" style="width:157px" %)pb14door open num|(% colspan="1" rowspan="1" style="width:154px" %)pb14 last open time|(% colspan="1" rowspan="1" style="width:153px" %)pb15 level status|(% colspan="1" rowspan="1" style="width:151px" %)pb15 alarm status|(% colspan="1" rowspan="1" style="width:160px" %)pb15 door open num|(% colspan="1" rowspan="1" style="width:152px" %)pb15 last open time|(% colspan="1" rowspan="1" style="width:67px" %)Battery|(% colspan="1" rowspan="1" style="width:69px" %)RSSI 260 +|(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod1|(% colspan="1" rowspan="1" style="width:103px" %)mod|(% colspan="1" rowspan="1" style="width:102px" %)Battery|(% colspan="1" rowspan="1" style="width:157px" %)RSSI|(% colspan="1" rowspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" rowspan="1" style="width:153px" %)exit_state/input PA4|(% colspan="1" rowspan="1" style="width:151px" %)adc0|(% colspan="1" rowspan="1" style="width:160px" %)Temperature |(% colspan="1" rowspan="1" style="width:152px" %)Humidity|(% colspan="1" rowspan="1" style="width:67px" %) |(% colspan="1" rowspan="1" style="width:69px" %) 261 +|(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod2|(% 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" %)exit_state/input PA4|(% colspan="1" style="width:151px" %)adc0|(% colspan="1" style="width:160px" %)distance|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %) 262 +|(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod3|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)adc0|(% colspan="1" style="width:153px" %)exit_state/input PA4|(% colspan="1" style="width:151px" %)adc1|(% colspan="1" style="width:160px" %)Temperature|(% colspan="1" style="width:152px" %)Humidity|(% colspan="1" style="width:67px" %)adc4|(% colspan="1" style="width:69px" %) 263 +|(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod4|(% 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" %)DS18B20 Temp2|(% colspan="1" style="width:152px" %)DS18B20 Temp3|(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %) 264 +|(% 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" %) 265 +|(% 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" %) 213 213 214 - 215 -)))|(% colspan="1" rowspan="1" %)((( 216 -Field10 267 +== 3.4 [[Datacake>>https://datacake.co/]] == 217 217 218 - 219 -))) 220 -|(% colspan="1" rowspan="1" %)S31x-NB|(% colspan="1" rowspan="1" %)Temperature |(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 221 -|(% colspan="1" rowspan="1" %)SE01-NB|(% colspan="1" rowspan="1" %)Temperature |(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %)conduct|(% colspan="1" rowspan="1" %)dielectric_constant|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 222 -|(% colspan="1" rowspan="1" %)DDS20-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 223 -Battery 224 224 225 - 226 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 227 -|(% colspan="1" rowspan="1" %)DDS45-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 228 -Battery 270 +(% class="wikigeneratedid" %) 271 +Dragino NB-IoT sensors has its template in **[[Datacake>>https://datacake.co/]]** Platform. There are two version for NB Sensor, 229 229 230 - 231 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 232 -|(% colspan="1" rowspan="1" %)DDS75-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 233 -Battery 234 234 235 - 236 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 237 -|(% colspan="1" rowspan="1" %)NMDS120-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 238 -Battery 274 +(% class="wikigeneratedid" %) 275 +As example for S31B-NB. there are two versions: **S31B-NB-1D and S31B-NB-GE.** 239 239 240 - 241 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 242 -|(% colspan="1" rowspan="1" %)SPH01-NB|(% colspan="1" rowspan="1" %)ph|(% colspan="1" rowspan="1" %)Temperature|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 243 -|(% colspan="1" rowspan="1" %)NLM01-NB|(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %)Temperature|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 244 -|(% colspan="1" rowspan="1" %)NMDS200-NB|(% colspan="1" rowspan="1" %)distance1|(% colspan="1" rowspan="1" %)distance2|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 245 -|(% colspan="1" rowspan="1" %)CPN01-NB|(% colspan="1" rowspan="1" %)alarm|(% colspan="1" rowspan="1" %)count|(% colspan="1" rowspan="1" %)door open duration|(% colspan="1" rowspan="1" %)calc flag|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 246 -|(% colspan="1" rowspan="1" %)DS03A-NB|(% colspan="1" rowspan="1" %)level|(% colspan="1" rowspan="1" %)alarm|(% colspan="1" rowspan="1" %)pb14door open num|(% colspan="1" rowspan="1" %)pb14 last open time|(% colspan="1" rowspan="1" %)pb15 level status|(% colspan="1" rowspan="1" %)pb15 alarm status|(% colspan="1" rowspan="1" %)pb15 door open num|(% colspan="1" rowspan="1" %)pb15 last open time|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI 247 -|(% colspan="1" rowspan="1" %)SN50V3-NB|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 248 -|(% colspan="1" rowspan="1" %)mod1|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)DS18B20 Temp|(% colspan="1" rowspan="1" %)exit_state/input PA4|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)Temperature |(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 249 -|(% colspan="1" rowspan="1" %)mod2|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 250 -DS18B20 Temp 277 +* (% 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. 251 251 252 - 253 -)))|(% colspan="1" rowspan="1" %)((( 254 -exit_state/input PA4 279 +* (% 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. 255 255 256 - 257 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 258 -|(% colspan="1" rowspan="1" %)mod3|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 259 -Battery 281 +=== 3.4.1 For device Already has template === 260 260 261 - 262 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 263 -exit_state/input PA4 283 +==== 3.4.1.1 Create Device ==== 264 264 265 - 266 -)))|(% colspan="1" rowspan="1" %)adc1|(% colspan="1" rowspan="1" %)Temperature|(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %)adc4|(% colspan="1" rowspan="1" %) 267 -|(% colspan="1" rowspan="1" %)mod4|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 268 -Battery 285 +(% style="color:blue" %)**Add Device**(%%) in DataCake. 269 269 270 - 271 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 272 -DS18B20 Temp 287 +[[image:image-20230808162301-1.png||height="453" width="952"]] 273 273 274 - 275 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 276 -exit_state/input PA4 277 277 278 - 279 -)))|(% colspan="1" rowspan="1" %)((( 280 -DS18B20 Temp2 290 +[[image:image-20230808162342-2.png||height="541" width="952"]] 281 281 282 - 283 -)))|(% colspan="1" rowspan="1" %)((( 284 -DS18B20 Temp3 285 285 286 - 287 -)))|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 288 -|(% colspan="1" rowspan="1" %)mod5|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 289 -Battery 293 +(% style="color:blue" %)**Choose the correct model**(%%) from template. 290 290 291 - 292 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 293 -DS18B20 Temp 295 +[[image:image-20230808162421-3.png]] 294 294 295 - 296 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 297 -exit_state/input PA4 298 298 299 - 300 -)))|(% colspan="1" rowspan="1" %)Weight|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 301 -|(% colspan="1" rowspan="1" %)mod6|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 302 -Battery 298 +(% 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. 303 303 304 - 305 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)count|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 300 +[[image:image-20230808163612-7.png||height="549" width="952"]] 306 306 307 - = 4. Datacake=302 +[[image:image-20230808163035-5.png]] 308 308 309 - == 1.1 DefineProduct ==304 +[[image:image-20230808163049-6.png||height="544" width="926"]] 310 310 311 -Firstly, we need to set the MQTT mode to datacake, and we need to run AT+PRO=3,2. This command is set to datacake. After running the command, the device automatically sets the server address, port. 312 312 307 +=== 3.4.2 For Device already registered in DataCake before shipped === 313 313 314 - Bychosing toadd the device under a "New Product" you arerequiredtoivea name forthis product. You can namet something like "My First MQTT Product".309 +==== 3.4.2.1 Scan QR Code to get the device info ==== 315 315 316 - [[image:image-20230802112413-14.png]]311 +Users can use their phones or computers to scan QR codes to obtain device data information. 317 317 318 - == 1.2 CreateDevice==313 +[[image:image-20230808170051-8.png||height="255" width="259"]] 319 319 320 - In the second step you haveto define the device which should beadded to the product.315 +[[image:image-20230808170548-9.png]] 321 321 322 -[[image:image-20230802112413-15.png]] 323 323 324 - Enteraname here (such as "My First MQTTDevice") and complete the creation of thedevice byclickingon the "Next" button.318 +==== 3.4.2.2 Claim Device to User Account ==== 325 325 320 +By Default, the device is registered in Dragino's DataCake Account. User can Claim it to his account. 326 326 327 -== 1.3 Create Database Fields == 328 328 329 -After creating the device, it is listed in the table of the fleet view. Now open the device by clicking on the entry in the list. 330 330 331 - You will thenseeavice view with an empty dashboard. Now, thefirst thing we wantto do is navigatetothe Device configuration. To do this,useab bar and click on "Configuration".324 +=== 3.4.3 Manual Add Decoder in DataCake ( don't use the template in DataCake) === 332 332 333 - [[image:image-20230802112413-16.png]]326 +**Step1:Add a device** 334 334 335 -[[image:image-202 30802112413-17.png]]328 +[[image:image-20240129170024-1.png||height="330" width="900"]] 336 336 337 - To createa firstdatabasefield,click onthe "Add Field" button as markedinthescreenshot above.330 +**Step2:Choose your device type,please select dragino NB-IOT device** 338 338 339 - This will openanothermodal askingfor somerequired inputfor your first field.332 +[[image:image-20240129170216-2.png||height="534" width="643"]] 340 340 341 - [[image:image-20230802112413-18.png]]334 +**Step3:Choose to create a new device** 342 342 343 -[[image:image-202 30802112413-19.png]]336 +[[image:image-20240129170539-3.png||height="459" width="646"]] 344 344 345 - == 1.4Setp Broker==338 +**Step4:Fill in the device ID of your NB device** 346 346 347 - The brokeris runningonmqtt.datacake.co onports 1883 and 8883. Port 1883 is unsecured and should not beusedin production environments. Port 8883uses a CA signedserver certificate.340 +[[image:image-20240202111546-1.png||height="378" width="651"]] 348 348 349 - You will needan access token tolog intotheDatacake MQTT Broker. You canuseyourownpersonal tokenorcreateatoken explicitly forindividual devicesor groups ofs.342 +**Step5:Please select your device plan according to your needs and complete the creation of the device** 350 350 351 - View your Personal Access Token344 +[[image:image-20240129171236-6.png||height="450" width="648"]] 352 352 353 - You can view your owntoken via theUser-Settings-Menu. Youcan reachthis menu byclickingon "Edit Profile" attheendof thelist using theWorkspace Selector:346 +**Step6:Please add the decoder at the payload decoder of the device configuration.** 354 354 355 -[[image:image- 20230802112413-20.png]]348 +**Decoder location:**[[dragino-end-node-decoder/Datacake-Dragino_NB at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB]] 356 356 357 - MQTT Client-ID350 +[[image:image-20240129172056-7.png||height="457" width="816"]] 358 358 359 - The Datacake Brokermanages the client IDs internally. You do not need to worry about a client ID.If your client optionally supports thespecification of a client ID, please leave this specification blank. Your client then creates a randomly generated ID.352 +[[image:image-20240129173116-9.png||height="499" width="814"]] 360 360 361 -A T+CLIENT=“Any value”354 +**Step6:Add the output of the decoder as a field** 362 362 363 - AT+UNAME=Token356 +[[image:image-20240129173541-10.png||height="592" width="968"]] 364 364 365 - AT+PWD=Token358 +**Step7:Customize the dashboard and use fields as parameters of the dashboard** 366 366 367 -[[image:image-202 30802112413-21.png]]360 +[[image:image-20240129174518-11.png||height="147" width="1042"]] 368 368 362 +[[image:image-20240129174657-12.png||height="538" width="916"]] 369 369 370 - == 1.6 Createyour firstSubscription==364 +[[image:image-20240129174840-13.png||height="536" width="750"]] 371 371 372 -Subscribe 373 373 374 - Data is published according tohe followingstructure:367 +=== 3.4.4 For device have not configured to connect to DataCake === 375 375 376 -dtck~/~// 369 +(% class="lead" %) 370 +Use AT command for connecting to DataCake 377 377 378 - Subscribeto topics using this structureto receive messages via MQTT when readings (via APIor MQTT) arrive in the Datacake Cloud. Messages are published whenever there is a change to a corresponding database field.372 +(% style="color:blue" %)**AT+PRO=2,0** 379 379 374 +(% style="color:blue" %)**AT+SERVADDR=67.207.76.90,4445** 380 380 381 -[[image:image-20230802112413-22.png]] 382 382 377 +== 3.5 Node-Red (via MQTT) == 383 383 384 -[[i mage:image-20230802112413-23.png]]379 +=== 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] === 385 385 386 386 387 - [[image:image-20230802112413-24.png]]382 +Take S31-NB UDP protocol as an example. 388 388 384 +Dragino provides input flow examples for the sensors. 389 389 390 -e xample:386 +User can download the required JSON file through Dragino Node-RED input flow template. 391 391 392 - AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature388 +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]] 393 393 394 - [[image:image-20230802112413-25.png]]390 +We can directly import the template. 395 395 396 - ==1.7 DefinePublishTopic==392 +The templates for S31-NB and NB95S31B are the same. 397 397 398 -Publish 399 399 400 - To upload datainto the DatacakeCloud andintoaspecific device, you publish the data to the respective topic structure.395 +[[image:image-20230809173127-4.png]] 401 401 402 -Due to the nature of MQTT, the topic prefix differs as follows: 403 403 404 - dtck-pub~/~//398 +Please select the NB95S31B template. 405 405 406 - example:400 +[[image:image-20230809173310-5.png||height="558" width="926"]] 407 407 408 - AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature402 +[[image:image-20230809173438-6.png]] 409 409 410 - ==1.8upload data ==404 +[[image:image-20230809173800-7.png]] 411 411 412 -[[image:image-20230802112413-26.png]] 413 413 414 - [[image:image-20230802112413-27.png]]407 +Successfully imported template. 415 415 416 -[[image:image-2023080 2112413-28.png]]409 +[[image:image-20230809173835-8.png||height="515" width="860"]] 417 417 418 -= = 419 419 420 - = 5. Node-Red (viaMQTT)=412 +Users can set UDP port. 421 421 414 +[[image:image-20230809174053-9.png]] 422 422 423 -== 1.1 Configure Node-Red == 424 424 425 - [[image:image-20230802112413-29.png]]417 +=== 3.5.2 Simulate Connection === 426 426 427 -[[image:image-20230802112413-30.png]] 428 428 429 - ==1.2 SimulateConnection==420 +We have completed the configuration of UDP. We can try sending packets to node red. 430 430 431 -[[image:image-202308 02112413-31.png]]422 +[[image:image-20230810083934-1.png]] 432 432 433 - == 1.3 ConfigureNB-IoT Sensors==424 +[[image:image-20230810084048-2.png||height="535" width="1052"]] 434 434 435 -* AT+PRO=3,0(hex format) or 3,5(json format) ~/~/Set to mqtt Server and Payload 436 -* AT+CLIENT=any value 437 -* AT+UNAME=any value 438 -* AT+PWD=any value 439 -* AT+PUBTOPIC=any value 440 -* AT+SUBTOPIC=any value 441 441 442 -= 6.ThingsBoard.Cloud(via MQTT)=427 +=== 3.5.3 Configure NB-IoT Sensors === 443 443 444 -== 1.1 Configure ThingsBoard == 445 445 446 -=== 1.1.1 Create Device === 430 +* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format** 431 +* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined** 432 +* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined** 433 +* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined** 434 +* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 435 +* (% style="color:#037691" %)**AT+PWD=“Your device token”** 447 447 448 - Createa New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]].437 +== 3.6 ThingsBoard.Cloud (via MQTT) == 449 449 450 - [[image:image-20230802112413-32.png]]439 +=== 3.6.1 Configure ThingsBoard === 451 451 452 -=== 1.1.2CreateUplink &Downlink Converter===441 +==== 3.6.1.1 Create Device ==== 453 453 454 -Uplink Converter 455 455 444 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection. 445 + 446 +[[image:image-20230802112413-32.png||height="583" width="1066"]] 447 + 448 + 449 +==== 3.6.1.2 Create Uplink & Downlink Converter ==== 450 + 451 + 452 +(% style="color:blue" %)**Uplink Converter** 453 + 456 456 The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume. deviceName and deviceType are required, while attributes and telemetry are optional. Attributes and telemetry are flat key-value objects. Nested objects are not supported. 457 457 458 -To create an uplink converter go to the Integrations center -> Data converters page and click “plus” 456 +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. 459 459 460 -[[image:image-20230802112413-33.png]] 458 +[[image:image-20230802112413-33.png||height="597" width="1061"]] 461 461 462 462 463 -Downlink Converter 461 +(% style="color:blue" %)**Downlink Converter** 464 464 465 465 The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 466 466 467 -[[image:image-20230802112413-34.png]] 465 +[[image:image-20230802112413-34.png||height="598" width="1063"]] 468 468 469 -Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default. 467 +(% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.** 470 470 471 -=== 1.1.3 MQTT Integration Setup === 472 472 473 - Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration.Name it “MQTT Integration”,selecttype MQTT;470 +==== 3.6.1.3 MQTT Integration Setup ==== 474 474 475 -[[image:image-20230802112413-35.png]] 476 476 473 +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**; 474 + 475 +[[image:image-20230802112413-35.png||height="597" width="1062"]] 476 + 477 + 477 477 * The next steps is to add the recently created uplink and downlink converters; 478 478 479 -[[image:image-20230802112413-36.png]] 480 +[[image:image-20230802112413-36.png||height="598" width="1062"]] 480 480 481 -[[image:image-20230802112413-37.png]] 482 +[[image:image-20230802112413-37.png||height="598" width="1064"]] 482 482 483 -Add a topic filter: 484 484 485 +(% style="color:blue" %)**Add a topic filter:** 485 485 486 - tb/mqtt-integration-tutorial/sensors~/~/temperature~-~-> Temperature 固定的? 对的。487 +Consistent with the theme of the node setting. 487 487 488 488 You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 489 489 490 -[[image:image-20230802112413-38.png]] 491 +[[image:image-20230802112413-38.png||height="598" width="1064"]] 491 491 492 -== 1.2 Simulate with MQTT.fx == 493 493 494 - [[image:image-20230802112413-39.png]]494 +=== 3.6.2 Simulate with MQTT.fx === 495 495 496 -[[image:image-20230802112413-40.png]] 497 497 498 - == 1.3 ConfigureNB-IoT Sensor ==497 +[[image:image-20230802112413-39.png]] 499 499 500 - AT Commands499 +[[image:image-20230802112413-40.png||height="525" width="980"]] 501 501 502 -AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 503 503 504 - AT+SUBTOPIC=devicename ~-~-> 只需要 Device Name吗?对的502 +=== 3.6.3 Configure NB-IoT Sensor === 505 505 506 -AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 507 507 505 +(% style="color:blue" %)**AT Commands** 508 508 509 - Users do notneed to fill in theient, username,andpassword.Buttheconfigurationinformation of thedevice requires settingtheclient, username, andpassword, which can be enteredfreely. (软件自动填充为 DeviceName 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性)507 +* (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 510 510 511 - CLIENT:“Anyvalue”509 +* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>** 512 512 513 - UserName:“Anyvalue”511 +* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>** 514 514 515 - Password:“Anyvalue”513 +* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined** 516 516 515 +* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 517 517 517 +* (% style="color:#037691" %)**AT+PWD=<device name> or User Defined** 518 + 518 518 Test Uplink by click the button for 1 second 519 519 520 -[[image:image-20230802112413-41.png]] 521 +[[image:image-20230802112413-41.png||height="496" width="828"]] 521 521 522 522 [[image:image-20230802112413-42.png]] 523 523 524 -[[image:image-20230802112413-43.png]] 525 +[[image:image-20230802112413-43.png||height="407" width="825"]] 525 525 526 526 527 -= 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) =528 +== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) == 528 528 529 -== 5.1 Create device & Get Credentials ==530 +=== 3.7.1 Create device & Get Credentials === 530 530 532 + 531 531 We use MQTT Connection to send data to [[Tago.io>>url:https://admin.tago.io/]]. We need to Create Device and Get MQTT Credentials first. 532 532 533 533 [[image:image-20230802112413-44.png]] ... ... @@ -534,7 +534,6 @@ 534 534 535 535 [[image:image-20230802112413-45.png]] 536 536 537 -= = 538 538 539 539 Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 540 540 ... ... @@ -541,55 +541,131 @@ 541 541 [[image:image-20230802112413-46.png]] 542 542 543 543 544 - On theConnectionProfilewindow,set thefollowinginformation: (这边加一个截图)545 +The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command. 545 545 546 -* Profile Name: “Any name” 547 -* Broker Address: mqtt.tago.io 548 -* Broker Port: 1883 549 -* Client ID: “Any value” 547 +(% style="color:blue" %)**On the Connection Profile window, set the following information:** 550 550 551 - Onthesection Usercredentials, setthefollowinginformation:(这边加一个截图)549 +* (% style="color:#037691" %)**Profile Name: “Any name”** 552 552 553 -* User Name: “Any value” Tago validates your user by the token only 554 -* Password: “Your device token” 555 -* PUBTOPIC: “Any value” 556 -* SUBTOPIC: “Any value” 551 +* (% style="color:#037691" %)**Broker Address: mqtt.tago.io** 557 557 558 - ==5.2 SimulatewithMQTT.fx ==553 +* (% style="color:#037691" %)**Broker Port: 8883** 559 559 560 - [[image:image-20230802112413-47.png]]555 +* (% style="color:#037691" %)**Client ID: “Any value”** 561 561 562 - [[image:image-20230802112413-48.png]]557 +(% style="color:blue" %)**On the section User credentials, set the following information:** 563 563 564 - UserscanruntheAT+PRO=3,5 command,andhepayloadwillbeconvertedtoJSON format.559 +* (% style="color:#037691" %)**User Name: “Any value”** (%%) **~/~/ Tago validates your user by the token only** 565 565 566 - [[image:image-20230802112413-49.png]]561 +* (% style="color:#037691" %)**Password: “Your device token”** 567 567 568 - ==1.4.tagodata ==563 +* (% style="color:#037691" %)**PUBTOPIC: “Any value”** 569 569 565 +* (% style="color:#037691" %)**SUBTOPIC: “Any value”** 570 570 571 - [[image:image-20230802112413-50.png]]567 +(% style="color:blue" %)**AT command:** 572 572 573 - [[image:image-20230802112413-51.png]]569 +* (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format** 574 574 575 - ==1.4.TLS mode==571 +* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined** 576 576 577 - Userscan chooseto useSSL/TLSmode.573 +* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined** 578 578 579 - OntheSSL/TLS section,checktheptionEnableSSL/TLS, andclick OK.575 +* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined** 580 580 581 - Theeeds to enable the TLSmodeandset the AT+TLSMOD=1,0 command.577 +* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 582 582 583 -* Profile Name: “Any name” 584 -* Broker Address: mqtt.tago.io 585 -* Broker Port: 8883 586 -* Client ID: “Any value” 587 -* User Name: “Any value” Tago validates your user by the token only 588 -* Password: “Your device token” 589 -* PUBTOPIC: “Any value” 590 -* SUBTOPIC: “Any value” 579 +* (% style="color:#037691" %)**AT+PWD=“Your device token”** 591 591 581 +=== 3.7.2 Simulate with MQTT.fx === 582 + 583 + 592 592 [[image:image-20230802112413-52.png]] 593 593 594 594 587 +[[image:image-20230808105300-2.png||height="553" width="1026"]] 588 + 589 + 590 +Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**. 591 + 592 +[[image:image-20230808105217-1.png||height="556" width="1031"]] 593 + 594 +[[image:image-20230808105329-3.png]] 595 + 596 + 597 +=== 3.7.3 tago data === 598 + 599 + 600 +[[image:image-20230802112413-50.png||height="242" width="1037"]] 601 + 602 +[[image:image-20230802112413-51.png||height="184" width="696"]] 603 + 604 + 605 +== 3.8 TCP Connection == 606 + 607 + 608 +(% style="color:blue" %)**AT command:** 609 + 610 +* (% style="color:#037691" %)**AT+PRO=4,0 ** (%%) ~/~/ Set to use TCP protocol to uplink(HEX format) 611 + 612 +* (% style="color:#037691" %)**AT+PRO=4,1 ** (%%) ~/~/ Set to use TCP protocol to uplink(JSON format) 613 + 614 +* (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port 615 + 616 +(% style="color:blue" %)**Sensor Console Output when Uplink:** 617 + 618 +[[image:image-20230807233631-1.png]] 619 + 620 + 621 +(% style="color:blue" %)**See result in TCP Server:** 622 + 623 +[[image:image-20230807233631-2.png]] 624 + 625 + 626 += 4. FAQ = 627 + 628 +== 4.1 What is the usage of Multi Sampling and One Uplink? == 629 + 630 +The NB series has the feature for Multi Sampling and one uplink. See one of them 631 + 632 +[[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink]] 633 + 634 +User can use this feature for below purpose: 635 + 636 +1. **Reduce power consumption**. The NB-IoT transmit power is much more higher than the sensor sampling power. To save battery life, we can sampling often and send in one uplink. 637 +1. Give more sampling data points. 638 +1. Increase reliable in transmission. For example. If user set 639 +1*. **AT+TR=1800** ~/~/ The unit is seconds, and the default is to record data once every 1800 seconds (30 minutes, the minimum can be set to 180 seconds) 640 +1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded. 641 +1*. **AT+TDC=7200** ~/~/ Uplink every 2 hours. 642 +1*. this will mean each uplink will actually include the 6 uplink data (24 set data which cover 12 hours). So if device doesn;t lost 6 continue data. There will not data lost. 643 + 644 + 645 += 5. Trouble Shooting: = 646 + 647 +== 5.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. == 648 + 649 +There are many different providers provide NB-IoT service in the world. They might use different band, different APN & different operator configuration. Which makes connection to NB-IoT network is complicate. 650 + 651 +If end device successfully attached NB-IoT Network, User can normally see the signal strengh as below (between 0~~31) 652 + 653 +[[image:image-20240207002003-1.png]] 654 + 655 + 656 +If fail to attach network, it will shows signal 99. as below: 657 + 658 +[[image:image-20240207002129-2.png]] 659 + 660 + 661 +(% class="lead" %) 662 +When see this issue, below are the checklist: 663 + 664 +* Does your SIM card support NB-IoT network? If SIM card doesn't not specify support NB-IoT clearly, normally it doesn't support. You need to confirm with your operator. 665 +* Do you configure the correct APN? [[Check here for APN settings>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.1GeneralConfiguretoattachnetwork]]. 666 +* Do you lock the frequency band? This is the most case we see. [[Explain and Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.2SpeedUpNetworkAttachtime]]. 667 +* Check if the device is attached to Carrier network but reject. (need to check with operator). 668 +* Check if the antenna is connected firmly. 669 + 670 +If you have check all above and still fail. please send console log files (as many as possible) to [[support@dragino.com>>mailto:support@dragino.com]] so we can check. 671 + 595 595
- image-20230807233631-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.9 KB - Content
- image-20230807233631-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +9.6 KB - Content
- image-20230808105217-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +68.5 KB - Content
- image-20230808105300-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +70.1 KB - Content
- image-20230808105329-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.1 KB - Content
- image-20230808162301-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +76.9 KB - Content
- image-20230808162342-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +63.8 KB - Content
- image-20230808162421-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +59.2 KB - Content
- image-20230808162727-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.2 KB - Content
- image-20230808163035-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +71.6 KB - Content
- image-20230808163049-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +61.5 KB - Content
- image-20230808163612-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +53.4 KB - Content
- image-20230808170051-8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.5 KB - Content
- image-20230808170548-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.David - Size
-
... ... @@ -1,0 +1,1 @@ 1 +54.1 KB - Content
- image-20230808205045-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +373.9 KB - Content
- 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
- image-20240129170024-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +52.3 KB - Content
- image-20240129170216-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +56.0 KB - Content
- image-20240129170539-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +55.0 KB - Content
- image-20240129171029-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +36.1 KB - Content
- image-20240129171113-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +47.2 KB - Content
- image-20240129171236-6.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +49.8 KB - Content
- image-20240129172056-7.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +69.8 KB - Content
- image-20240129172136-8.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +80.4 KB - Content
- image-20240129173116-9.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +110.8 KB - Content
- image-20240129173541-10.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +95.4 KB - Content
- image-20240129174518-11.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +23.2 KB - Content
- image-20240129174657-12.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +141.9 KB - Content
- image-20240129174840-13.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +92.9 KB - Content
- image-20240202111546-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Bei - Size
-
... ... @@ -1,0 +1,1 @@ 1 +33.3 KB - Content
- image-20240207002003-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +22.3 KB - Content
- image-20240207002129-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +17.9 KB - Content
- image-20240208001740-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Edwin - Size
-
... ... @@ -1,0 +1,1 @@ 1 +487.1 KB - Content