Last modified by Mengting Qiu on 2025/03/08 11:33
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 5 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. David1 +XWiki.Xiaoling - Content
-
... ... @@ -1,8 +1,10 @@ 1 -== **Table of Contents:** == 1 +(% class="wikigeneratedid" %) 2 +**Table of Contents:** 2 2 3 3 {{toc/}} 4 4 5 5 7 + 6 6 = 1. The use of this guideline = 7 7 8 8 ... ... @@ -9,31 +9,20 @@ 9 9 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. 10 10 11 11 12 -= 2. AttachNetwork =14 += 2. Network Connection = 13 13 14 14 15 -T o attache NB-IoTsensorsto NB-IoTNetwork,Youneedto: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. 16 16 17 -1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone) 18 -1. Insert the SIM card to Sensor 19 -1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (% class="mark" %)(补充 APN 指令(%%)) 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 +|China Mobile| | | 20 20 21 - (% class="mark"%)插入SIM卡图片24 +== 2.1 1NCE SIM Card. == 22 22 23 -After doing above, the NB-IoT Sensors should be able to attach to NB-IoT network . 24 24 25 -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. 26 26 27 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %) 28 -|(% 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** 29 -|(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:474px" %)((( 30 -**[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]** 31 - 32 -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 33 -)))|(% style="width:135px" %) 34 -|(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %) 35 -|(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:474px" %)China Mainland|(% style="width:135px" %) 36 - 37 37 = 3. Configure to connect to different servers = 38 38 39 39 == 3.1 General UDP Connection == ... ... @@ -114,9 +114,9 @@ 114 114 [[image:image-20230802112413-7.png]] 115 115 116 116 117 -== =3.3.2 Simulate with MQTT.fx ===108 +== 3.3.2 Simulate with MQTT.fx == 118 118 119 -=== =3.3.2.1 Establish MQTT Connection ====110 +=== 3.3.2.1 Establish MQTT Connection === 120 120 121 121 122 122 After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine. ... ... @@ -133,14 +133,13 @@ 133 133 134 134 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password> 135 135 136 -==== 3.3.2.2 Publish Data to ThingSpeak Channel ==== 137 137 128 +=== 3.3.2.2 Publish Data to ThingSpeak Channel === 138 138 139 139 [[image:image-20230802112413-9.png]] 140 140 141 141 [[image:image-20230802112413-10.png]] 142 142 143 - 144 144 (% style="color:blue" %)**In MQTT.fx, we can publish below info:** 145 145 146 146 * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish ... ... @@ -155,28 +155,29 @@ 155 155 [[image:image-20230802112413-11.png]] 156 156 157 157 158 -== =3.3.3Configure NB-IoT Sensor for connection ===148 +== 3.3 Configure NB-IoT Sensor for connection == 159 159 160 -=== =3.3.3.1 AT Commands: ====150 +=== 3.3.1 AT Commands: === 161 161 162 162 163 163 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx 164 164 165 -* (% style="color:blue" %)**AT+PRO=3,1**(%%)~/~/ Set to use ThingSpeak Server and Related Payload155 +* **AT+PRO=3,1** ~/~/ Set to use ThingSpeak Server and Related Payload 166 166 167 -* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**157 +* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 168 168 169 -* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**159 +* **AT+UNAME=<Your ThingSpeak MQTT User Name>** 170 170 171 -* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**161 +* **AT+PWD=<Your ThingSpeak MQTT Password>** 172 172 173 -* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**163 +* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 174 174 175 -* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**165 +* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 176 176 177 -==== 3.3.3.2 Uplink Examples ==== 178 178 168 +=== 3.3.2 Uplink Examples === 179 179 170 + 180 180 For S31-NB 181 181 182 182 For SE01-NB ... ... @@ -202,7 +202,7 @@ 202 202 For SN50V3-NB 203 203 204 204 205 -=== =3.3.3.3Map fields to sensor value ====196 +=== 3.3.3 Map fields to sensor value === 206 206 207 207 208 208 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,238 +215,334 @@ 215 215 216 216 Below is the NB-IoT Product Table show the mapping. 217 217 218 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1386px" %) 219 -|(% style="background-color:#4f81bd; width:124px" %) |(% style="background-color:#4f81bd; color:white; width:91px" %)Field1|(% style="background-color:#4f81bd; color:white; width:102px" %)Field2|(% style="background-color:#4f81bd; color:white; width:159px" %)Field3|(% style="background-color:#4f81bd; color:white; width:153px" %)Field4|(% style="background-color:#4f81bd; color:white; width:152px" %)Field5|(% style="background-color:#4f81bd; color:white; width:148px" %)Field6|(% style="background-color:#4f81bd; color:white; width:164px" %)Field7|(% style="background-color:#4f81bd; color:white; width:152px" %)Field8|(% style="background-color:#4f81bd; color:white; width:66px" %)Field9|(% style="background-color:#4f81bd; color:white; width:66px" %)Field10 220 -|(% style="background-color:#4f81bd; color:white; width:124px" %)S31x-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 221 -|(% style="background-color:#4f81bd; color:white; width:124px" %)SE01-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)conduct|(% style="width:153px" %)dielectric_constant|(% style="width:152px" %)Battery|(% style="width:148px" %)RSSI|(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 222 -|(% style="background-color:#4f81bd; color:white; width:124px" %)DDS20-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 223 -|(% style="background-color:#4f81bd; color:white; width:124px" %)DDS45-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 224 -|(% style="background-color:#4f81bd; color:white; width:124px" %)DDS75-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 225 -|(% style="background-color:#4f81bd; color:white; width:124px" %)NMDS120-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 226 -|(% rowspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SPH01-NB|(% style="width:91px" %)ph|(% style="width:102px" %)Temperature|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 227 -|(% style="background-color:#4f81bd; color:white; width:124px" %)NLM01-NB|(% style="width:91px" %)Humidity|(% style="width:102px" %)Temperature|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 228 -|(% style="background-color:#4f81bd; color:white; width:124px" %)NMDS200-NB|(% style="width:91px" %)distance1|(% style="width:102px" %)distance2|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 229 -|(% style="background-color:#4f81bd; color:white; width:124px" %)CPN01-NB|(% style="width:91px" %)alarm|(% style="width:102px" %)count|(% style="width:159px" %)door open duration|(% style="width:153px" %)calc flag|(% style="width:152px" %)Battery|(% style="width:148px" %)RSSI|(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 230 -|(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:124px" %)DS03A-NB|(% colspan="1" rowspan="1" style="width:91px" %)level|(% colspan="1" rowspan="1" style="width:102px" %)alarm|(% colspan="1" rowspan="1" style="width:159px" %)pb14door open num|(% colspan="1" rowspan="1" style="width:153px" %)pb14 last open time|(% colspan="1" rowspan="1" style="width:152px" %)pb15 level status|(% colspan="1" rowspan="1" style="width:148px" %)pb15 alarm status|(% colspan="1" rowspan="1" style="width:164px" %)pb15 door open num|(% colspan="1" rowspan="1" style="width:152px" %)pb15 last open time|(% colspan="1" rowspan="1" style="width:66px" %)Battery|(% colspan="1" rowspan="1" style="width:66px" %)RSSI 231 -|(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod1|(% colspan="1" rowspan="1" style="width:91px" %)mod|(% colspan="1" rowspan="1" style="width:102px" %)Battery|(% colspan="1" rowspan="1" style="width:159px" %)RSSI|(% colspan="1" rowspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" rowspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" rowspan="1" style="width:148px" %)adc0|(% colspan="1" rowspan="1" style="width:164px" %)Temperature |(% colspan="1" rowspan="1" style="width:152px" %)Humidity|(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 232 -|(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod2|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc0|(% colspan="1" style="width:164px" %)distance|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 233 -|(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod3|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc1|(% colspan="1" style="width:164px" %)Temperature|(% colspan="1" style="width:152px" %)Humidity|(% colspan="1" style="width:66px" %)adc4|(% colspan="1" style="width:66px" %) 234 -|(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod4|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)DS18B20 Temp2|(% colspan="1" style="width:152px" %)DS18B20 Temp3|(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 235 -|(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod5|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 236 -|(% colspan="1" style="background-color:#4f81bd; color:white; width:124px" %)SN50V3-NB mod6|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)count|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:148px" %) |(% colspan="1" style="width:164px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 209 +(% border="1" cellspacing="4" style="width:1386px;background-color:#F2F2F2" %) 210 +|(% style="width:124px;background-color:#4F81BD" %) |(% style="width:91px;background-color:#4F81BD;color:white" %)Field1|(% style="width:102px;background-color:#4F81BD;color:white" %)Field2|(% style="width:159px;background-color:#4F81BD;color:white" %)Field3|(% style="width:153px;background-color:#4F81BD;color:white" %)Field4|(% style="width:152px;background-color:#4F81BD;color:white" %)Field5|(% style="width:148px;background-color:#4F81BD;color:white" %)Field6|(% style="width:164px;background-color:#4F81BD;color:white" %)Field7|(% style="width:152px;background-color:#4F81BD;color:white" %)Field8|(% style="width:66px;background-color:#4F81BD;color:white" %)Field9|(% style="width:66px;background-color:#4F81BD;color:white" %)Field10 211 +|(% style="width:124px;background-color:#4F81BD;color:white" %)S31x-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 212 +|(% style="width:124px;background-color:#4F81BD;color:white" %)SE01-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)conduct|(% style="width:153px" %)dielectric_constant|(% style="width:152px" %)Battery|(% style="width:148px" %)RSSI|(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 213 +|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS20-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 214 +|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS45-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 215 +|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS75-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 216 +|(% style="width:124px;background-color:#4F81BD;color:white" %)NMDS120-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 217 +|(% rowspan="1" style="width:124px;background-color:#4F81BD;color:white" %)SPH01-NB|(% style="width:91px" %)ph|(% style="width:102px" %)Temperature|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 218 +|(% style="width:124px;background-color:#4F81BD;color:white" %)NLM01-NB|(% style="width:91px" %)Humidity|(% style="width:102px" %)Temperature|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 219 +|(% style="width:124px;background-color:#4F81BD;color:white" %)NMDS200-NB|(% style="width:91px" %)distance1|(% style="width:102px" %)distance2|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 220 +|(% style="width:124px;background-color:#4F81BD;color:white" %)CPN01-NB|(% style="width:91px" %)alarm|(% style="width:102px" %)count|(% style="width:159px" %)door open duration|(% style="width:153px" %)calc flag|(% style="width:152px" %)Battery|(% style="width:148px" %)RSSI|(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 221 +|(% colspan="1" rowspan="1" style="width:124px;background-color:#4F81BD;color:white" %)DS03A-NB|(% colspan="1" rowspan="1" style="width:91px" %)level|(% colspan="1" rowspan="1" style="width:102px" %)alarm|(% colspan="1" rowspan="1" style="width:159px" %)pb14door open num|(% colspan="1" rowspan="1" style="width:153px" %)pb14 last open time|(% colspan="1" rowspan="1" style="width:152px" %)pb15 level status|(% colspan="1" rowspan="1" style="width:148px" %)pb15 alarm status|(% colspan="1" rowspan="1" style="width:164px" %)pb15 door open num|(% colspan="1" rowspan="1" style="width:152px" %)pb15 last open time|(% colspan="1" rowspan="1" style="width:66px" %)Battery|(% colspan="1" rowspan="1" style="width:66px" %)RSSI 222 +|(% colspan="1" rowspan="1" style="width:124px;background-color:#4F81BD;color:white" %)SN50V3-NB|(% colspan="1" rowspan="1" style="width:91px" %) |(% colspan="1" rowspan="1" style="width:102px" %) |(% colspan="1" rowspan="1" style="width:159px" %) |(% colspan="1" rowspan="1" style="width:153px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:148px" %) |(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 223 +|(% colspan="1" rowspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod1|(% colspan="1" rowspan="1" style="width:91px" %)mod|(% colspan="1" rowspan="1" style="width:102px" %)Battery|(% colspan="1" rowspan="1" style="width:159px" %)RSSI|(% colspan="1" rowspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" rowspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" rowspan="1" style="width:148px" %)adc0|(% colspan="1" rowspan="1" style="width:164px" %)Temperature |(% colspan="1" rowspan="1" style="width:152px" %)Humidity|(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 224 +|(% colspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod2|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc0|(% colspan="1" style="width:164px" %)distance|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 225 +|(% colspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod3|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc1|(% colspan="1" style="width:164px" %)Temperature|(% colspan="1" style="width:152px" %)Humidity|(% colspan="1" style="width:66px" %)adc4|(% colspan="1" style="width:66px" %) 226 +|(% colspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod4|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)DS18B20 Temp2|(% colspan="1" style="width:152px" %)DS18B20 Temp3|(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 227 +|(% colspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod5|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 228 +|(% colspan="1" style="width:124px;background-color:#4F81BD;color:white" %)mod6|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)count|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:148px" %) |(% colspan="1" style="width:164px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 237 237 230 + 231 + 238 238 == 3.4 Datacake == 239 239 234 +== 3.4.1 Define Product == 240 240 241 241 237 +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. 242 242 243 -== 3.5 Node-Red (via MQTT) == 244 244 245 - === 3.5.1Configure[[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] ===240 +By chosing to add the device under a (% style="color:blue" %)**"New Product"**(%%) you are required to give a name for this product. You can name it something like "My First MQTT Product". 246 246 242 +[[image:image-20230802112413-14.png]] 247 247 248 -[[image:image-20230802112413-29.png]] 249 249 245 +=== 3.4.2 Create Device === 250 250 251 -[[image:image-20230802112413-30.png]] 252 252 248 +In the second step you have to define the device which should be added to the product. 253 253 254 - === 3.5.2 SimulateConnection===250 +[[image:image-20230802112413-15.png]] 255 255 252 +Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the "Next" button. 256 256 257 -[[image:image-20230802112413-31.png]] 258 258 255 +=== 3.4.3 Create Database Fields === 259 259 260 -=== 3.5.3 Configure NB-IoT Sensors === 261 261 258 +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. 262 262 263 - * (% style="color:blue" %)**AT+PRO=3,0(hexformat)or3,5(jsonformat)**(%%)~/~/Set tomqttServerandPayload260 +You will then see a device view with an empty dashboard. Now, the first thing we want to do is navigate to the Device configuration. To do this, use the tab bar and click on "Configuration". 264 264 265 - * (% style="color:blue" %)**AT+CLIENT=any value**262 +[[image:image-20230802112413-16.png]] 266 266 267 - * (% style="color:blue" %)**AT+UNAME=any value**264 +[[image:image-20230802112413-17.png]] 268 268 269 - * (%style="color:blue"%)**AT+PWD=anyvalue**266 +To create a first database field, please click on the "Add Field" button as marked in the screenshot above. 270 270 271 - * (%style="color:blue" %)**AT+PUBTOPIC=anyvalue**268 +This will open another modal asking for some required input for your first field. 272 272 273 - * (% style="color:blue" %)**AT+SUBTOPIC=any value**270 +[[image:image-20230802112413-18.png]] 274 274 275 - == 3.6 ThingsBoard.Cloud (viaMQTT) ==272 +[[image:image-20230802112413-19.png]] 276 276 277 -=== 3.6.1 Configure ThingsBoard === 278 278 279 -=== =3.6.1.1CreateDevice====275 +=== 3.4.4 Set up Broker === 280 280 281 281 282 - Create aNewDevicein[[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Namewhich isforMQTT connection.278 +The broker is running on mqtt.datacake.co on ports 1883 and 8883. Port 1883 is unsecured and should not be used in production environments. Port 8883 uses a CA signed server certificate. 283 283 284 - [[image:image-20230802112413-32.png]]280 +You will need an access token to log into the Datacake MQTT Broker. You can use your own personal token or create a token explicitly for individual devices or groups of devices. 285 285 282 +View your Personal Access Token 286 286 287 - ==== 3.6.1.2Create Uplink& DownlinkConverter====284 +You can view your own token via the User-Settings-Menu. You can reach this menu by clicking on "Edit Profile" at the end of the list using the Workspace Selector: 288 288 286 +[[image:image-20230802112413-20.png]] 289 289 290 -(% style="color:blue" %)** UplinkConverter**288 +(% style="color:blue" %)**MQTT Client-ID** 291 291 292 -The purposeofthedecoder functionis to parsethe incomingdataandmetadatatoa formatthatThingsBoardcanconsume.deviceName anddeviceTypearerequired,whilettributesand telemetryareoptional.Attributes andtelemetryareflatkey-value objects.Nested objectsarenotsupported.290 +The Datacake Broker manages the client IDs internally. You do not need to worry about a client ID. If your client optionally supports the specification of a client ID, please leave this specification blank. Your client then creates a randomly generated ID. 293 293 294 - 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" %)**“MQTTUplink Converter”**(%%)and select type (% style="color:blue" %)"**Uplink"**(%%). Use debug mode for now.292 +(% style="color:blue" %)**AT+CLIENT=“Any value”** 295 295 296 - [[image:image-20230802112413-33.png||height="732"width="1302"]]294 +(% style="color:blue" %)**AT+UNAME=Token** 297 297 296 +(% style="color:blue" %)**AT+PWD=Token** 298 298 299 - (% style="color:blue" %)**Downlink Converter**298 +[[image:image-20230802112413-21.png]] 300 300 301 -The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 302 302 303 - [[image:image-20230802112413-34.png||height="734" width="1305"]]301 +=== 3.4.5 Create your first Subscription === 304 304 305 -(% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.** 306 306 304 +(% style="color:blue" %)**Subscribe** 307 307 308 - ==== 3.6.1.3MQTTIntegrationSetup ====306 +Data is published according to the following structure: 309 309 308 +dtck~/~// 310 310 311 - Goto the (% style="color:blue" %)**Integrations center**(%%)**->** (% style="color:blue" %)**Integrationspage**(%%)andclick**“(% style="color:blue" %)plus(%%)”**icontoaddanewintegration. Nameit(%style="color:blue" %)**“MQTTIntegration”**(%%), selecttype(%style="color:blue" %)**MQTT**;310 +Subscribe to topics using this structure to receive messages via MQTT when readings (via API or MQTT) arrive in the Datacake Cloud. Messages are published whenever there is a change to a corresponding database field. 312 312 313 -[[image:image-20230802112413-35.png||height="738" width="1312"]] 314 314 313 +[[image:image-20230802112413-22.png]] 315 315 316 -* The next steps is to add the recently created uplink and downlink converters; 317 317 318 -[[image:image-20230802112413-3 6.png||height="736" width="1308"]]316 +[[image:image-20230802112413-23.png]] 319 319 320 -[[image:image-20230802112413-37.png||height="735" width="1307"]] 321 321 319 +[[image:image-20230802112413-24.png]] 322 322 323 -(% style="color:blue" %)**Add a topic filter:** 324 324 325 -t b/mqtt-integration-tutorial/sensors~/~/temperature~-~-> Temperature**固定的? 对的。**322 +(% style="color:blue" %)**example:** 326 326 327 - Youcanlso selectn MQTT QoS level. We use MQTT QoS level 0 (Atmost once) by default;324 +AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 328 328 329 -[[image:image-20230802112413- 38.png||height="731" width="1300"]]326 +[[image:image-20230802112413-25.png]] 330 330 331 331 332 -=== 3. 6.2SimulatewithMQTT.fx===329 +=== 3.4.6 Define Publish Topic === 333 333 334 334 335 - [[image:image-20230802112413-39.png]]332 +(% style="color:blue" %)**Publish** 336 336 337 - [[image:image-20230802112413-40.png]]334 +To upload data into the Datacake Cloud and into a specific device, you publish the data to the respective topic structure. 338 338 336 +Due to the nature of MQTT, the topic prefix differs as follows: 339 339 340 - === 3.6.3 Configure NB-IoT Sensor ===338 +dtck-pub~/~// 341 341 340 +(% style="color:blue" %)**example:** 342 342 343 - (%style="color:blue" %)**ATCommands**342 +AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 344 344 345 -* (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 346 346 347 -* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>** (%%) 348 -* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>** 349 -* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined** 350 -* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 351 -* (% style="color:#037691" %)**AT+PWD=<device name> or User Defined** 345 +=== 3.4.7 upload data === 352 352 353 -Test Uplink by click the button for 1 second 354 354 355 -[[image:image-20230802112413- 41.png]]348 +[[image:image-20230802112413-26.png]] 356 356 357 -[[image:image-20230802112413- 42.png]]350 +[[image:image-20230802112413-27.png]] 358 358 359 -[[image:image-20230802112413- 43.png]]352 +[[image:image-20230802112413-28.png]] 360 360 361 361 362 -== 3. 7[[Tago.io>>url:https://admin.tago.io/]](via MQTT) ==355 +== 3.5 Node-Red (via MQTT) == 363 363 364 -=== 3. 7.1 Createdevice& Get Credentials===357 +=== 3.5.1 Configure Node-Red === 365 365 359 +[[image:image-20230802112413-29.png]] 366 366 367 - We use MQTT Connection to send data to[[Tago.io>>url:https://admin.tago.io/]]. Weneed to Create Deviceand Get MQTT Credentials first.361 +[[image:image-20230802112413-30.png]] 368 368 369 - [[image:image-20230802112413-44.png]]363 +=== 3.5.2 Simulate Connection === 370 370 371 -[[image:image-20230802112413-45.png]] 372 372 366 +[[image:image-20230802112413-31.png]] 373 373 374 -Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 375 375 376 - [[image:image-20230802112413-46.png]]369 +=== 3.5.3 Configure NB-IoT Sensors === 377 377 378 378 379 - The device needs to enable the TLS mode and set the(% style="color:blue" %)**AT+TLSMOD=1,0**(%%)command.372 +* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%) ~/~/Set to mqtt Server and Payload 380 380 381 - OntheConnection Profilewindow,set the following information:374 +* (% style="color:blue" %)**AT+CLIENT=any value**(%%) 382 382 383 -* (% style="color:blue" %)** ProfileName: “Anyname”**376 +* (% style="color:blue" %)**AT+UNAME=any value**(%%) 384 384 385 -* (% style="color:blue" %)** BrokerAddress:mqtt.tago.io**378 +* (% style="color:blue" %)**AT+PWD=any value**(%%) 386 386 387 -* (% style="color:blue" %)**B rokerPort:8883**380 +* (% style="color:blue" %)**AT+PUBTOPIC=any value**(%%) 388 388 389 -* (% style="color:blue" %)**C lient ID: “Any value”**382 +* (% style="color:blue" %)**AT+SUBTOPIC=any value**(%%) 390 390 391 -On the section User credentials, set the following information: 392 392 393 - * (% style="color:blue"%)**UserName: “Any value”** (%%) ~/~/ Tago validatesyour user by the token only385 +== 3.6 ThingsBoard.Cloud (via MQTT) == 394 394 395 - * (% style="color:blue"%)**Password:“Yourdevicetoken”**387 +=== 3.6.1 Configure ThingsBoard === 396 396 397 - * (% style="color:blue"%)**PUBTOPIC:“Anyvalue”**389 +==== 3.6.1.1 Create Device ==== 398 398 399 - * (% style="color:blue" %)**SUBTOPIC:“Any value”**391 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. 400 400 401 - (% style="color:blue" %)**AT command:**393 +[[image:image-20230802112413-32.png]] 402 402 403 - * **AT+PRO=3,0or3,5 **~/~/ hex formatr jsonformat395 +==== 3.6.2.2 Create Uplink & Downlink Converter ==== 404 404 405 -* **AT+SUBTOPIC=<device name>** **or User Defined** 406 -* **AT+PUBTOPIC=<device name>or User Defined** 407 -* **AT+CLIENT=<device name> or User Defined** 408 -* **AT+UNAME=<device name> or User Defined** 409 -* **AT+PWD=“Your device token”** 397 +(% style="color:blue" %)**Uplink Converter** 410 410 411 - === 3.7.2SimulatewithMQTT.fx ===399 +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. 412 412 413 - [[image:image-20230802112413-52.png]]401 +To create an uplink converter go to the Integrations center -> Data converters page and click “plus” button. Name it “MQTT Uplink Converter” and select type Uplink. Use debug mode for now. 414 414 403 +[[image:image-20230802112413-33.png]] 415 415 416 -[[image:image-20230808105300-2.png]] 417 417 418 - Users can run the(% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload willbe converted to **JSON format**.406 +(% style="color:blue" %)**Downlink Converter** 419 419 420 - [[image:image-20230808105217-1.png]]408 +The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 421 421 422 -[[image:image-2023080 8105329-3.png]]410 +[[image:image-20230802112413-34.png]] 423 423 412 +(% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.** 424 424 425 -=== 3.7.3 tago data === 426 426 415 +=== 1.1.3 MQTT Integration Setup === 427 427 428 - [[image:image-20230802112413-50.png]]417 +Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 429 429 430 -[[image:image-20230802112413-5 1.png||height="184" width="696"]]419 +[[image:image-20230802112413-35.png]] 431 431 421 +* The next steps is to add the recently created uplink and downlink converters; 432 432 423 +[[image:image-20230802112413-36.png]] 433 433 434 - ==3.8TCP Connection ==425 +[[image:image-20230802112413-37.png]] 435 435 427 +Add a topic filter: 436 436 437 -* **AT+PRO=4,0 ** ~/~/ Set to use TCP protocol to uplink(HEX format) 438 -* **AT+PRO=4,1 ** ~/~/ Set to use TCP protocol to uplink(JSON format) 439 -* **AT+SERVADDR=120.24.4.116,5600 **~/~/ to set TCP server address and port 440 440 441 - **SensorConsoleOutputwhenUplink**430 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。 442 442 443 - [[image:image-20230807233631-1.png]]432 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 444 444 434 +[[image:image-20230802112413-38.png]] 445 445 446 - **SeeresultnTCPServer**436 +== 1.2 Simulate with MQTT.fx == 447 447 448 -[[image:image-2023080 7233631-2.png]]438 +[[image:image-20230802112413-39.png]] 449 449 440 +[[image:image-20230802112413-40.png]] 450 450 442 +== 1.3 Configure NB-IoT Sensor == 451 451 444 +AT Commands 445 + 446 +AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 447 + 448 +AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 449 + 450 +AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 451 + 452 + 453 +Users do not need to fill in the client, username, and password. But the configuration information of the device requires setting the client, username, and password, which can be entered freely. (软件自动填充为 Device Name 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性) 454 + 455 +CLIENT :“Any value” 456 + 457 +User Name:“Any value” 458 + 459 +Password:“Any value” 460 + 461 + 462 +Test Uplink by click the button for 1 second 463 + 464 +[[image:image-20230802112413-41.png]] 465 + 466 +[[image:image-20230802112413-42.png]] 467 + 468 +[[image:image-20230802112413-43.png]] 469 + 470 + 471 += 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) = 472 + 473 +== 5.1 Create device & Get Credentials == 474 + 475 +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. 476 + 477 +[[image:image-20230802112413-44.png]] 478 + 479 +[[image:image-20230802112413-45.png]] 480 + 481 += = 482 + 483 +Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 484 + 485 +[[image:image-20230802112413-46.png]] 486 + 487 + 488 +On the Connection Profile window, set the following information: (这边加一个截图) 489 + 490 +* Profile Name: “Any name” 491 +* Broker Address: mqtt.tago.io 492 +* Broker Port: 1883 493 +* Client ID: “Any value” 494 + 495 +On the section User credentials, set the following information:(这边加一个截图) 496 + 497 +* User Name: “Any value” Tago validates your user by the token only 498 +* Password: “Your device token” 499 +* PUBTOPIC: “Any value” 500 +* SUBTOPIC: “Any value” 501 + 502 +== 5.2 Simulate with MQTT.fx == 503 + 504 +[[image:image-20230802112413-47.png]] 505 + 506 +[[image:image-20230802112413-48.png]] 507 + 508 +Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format. 509 + 510 +[[image:image-20230802112413-49.png]] 511 + 512 +== 1.4. tago data == 513 + 514 + 515 +[[image:image-20230802112413-50.png]] 516 + 517 +[[image:image-20230802112413-51.png]] 518 + 519 +== 1.4. TLS mode == 520 + 521 +Users can choose to use SSL/TLS mode. 522 + 523 +On the SSL/TLS section, check the option Enable SSL/TLS, and click OK. 524 + 525 +The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command. 526 + 527 +* Profile Name: “Any name” 528 +* Broker Address: mqtt.tago.io 529 +* Broker Port: 8883 530 +* Client ID: “Any value” 531 +* User Name: “Any value” Tago validates your user by the token only 532 +* Password: “Your device token” 533 +* PUBTOPIC: “Any value” 534 +* SUBTOPIC: “Any value” 535 + 536 +[[image:image-20230802112413-52.png]] 537 + 538 + 452 452
- image-20230807233631-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.9 KB - Content
- image-20230807233631-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -9.6 KB - Content
- image-20230808105217-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.David - Size
-
... ... @@ -1,1 +1,0 @@ 1 -68.5 KB - Content
- image-20230808105300-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.David - Size
-
... ... @@ -1,1 +1,0 @@ 1 -70.1 KB - Content
- image-20230808105329-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.David - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.1 KB - Content