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, 4 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,252 +215,316 @@ 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 **"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]]244 +== 1.2 Create Device == 249 249 246 +In the second step you have to define the device which should be added to the product. 250 250 251 -[[image:image-20230802112413- 30.png]]248 +[[image:image-20230802112413-15.png]] 252 252 250 +Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the "Next" button. 253 253 254 -=== 3.5.2 Simulate Connection === 255 255 253 +== 1.3 Create Database Fields == 256 256 257 - [[image:image-20230802112413-31.png]]255 +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. 258 258 257 +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". 259 259 260 - === 3.5.3 ConfigureNB-IoT Sensors ===259 +[[image:image-20230802112413-16.png]] 261 261 261 +[[image:image-20230802112413-17.png]] 262 262 263 - * (% style="color:blue" %)**AT+PRO=3,0(hexformat)or 3,5(jsonformat)**(%%)~/~/ SettomqttServerandPayload263 +To create a first database field, please click on the "Add Field" button as marked in the screenshot above. 264 264 265 - * (%style="color:blue" %)**AT+CLIENT=anyvalue**265 +This will open another modal asking for some required input for your first field. 266 266 267 - * (% style="color:blue" %)**AT+UNAME=any value**267 +[[image:image-20230802112413-18.png]] 268 268 269 - * (% style="color:blue" %)**AT+PWD=any value**269 +[[image:image-20230802112413-19.png]] 270 270 271 - *(% style="color:blue"%)**AT+PUBTOPIC=any value**271 +== 1.4 Set up Broker == 272 272 273 - * (%style="color:blue" %)**AT+SUBTOPIC=anyvalue**273 +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. 274 274 275 - == 3.6ThingsBoard.Cloud(via MQTT) ==275 +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. 276 276 277 - === 3.6.1ConfigureThingsBoard ===277 +View your Personal Access Token 278 278 279 - ==== 3.6.1.1CreateDevice====279 +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: 280 280 281 +[[image:image-20230802112413-20.png]] 281 281 282 - Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used forMQTTconnection.283 +MQTT Client-ID 283 283 284 - [[image:image-20230802112413-32.png]]285 +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. 285 285 287 +AT+CLIENT=“Any value” 286 286 287 - ==== 3.6.1.2 CreateUplink & DownlinkConverter ====289 +AT+UNAME=Token 288 288 291 +AT+PWD=Token 289 289 290 - (% style="color:blue" %)**Uplink Converter**293 +[[image:image-20230802112413-21.png]] 291 291 292 -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. 293 293 294 - Tocreatean uplink converter go to the (% style="color:blue" %)**Integrationscenter**(%%) -> (%style="color:blue" %)**Dataconverters**(%%) 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 fornow.296 +== 1.6 Create your first Subscription == 295 295 296 - [[image:image-20230802112413-33.png||height="732" width="1302"]]298 +Subscribe 297 297 300 +Data is published according to the following structure: 298 298 299 - (% style="color:blue" %)**DownlinkConverter**302 +dtck~/~// 300 300 301 - TheDownlinkconverter transforming outgoingRPCmessage andthen theIntegrationsendsitto external MQTTbroke304 +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. 302 302 303 -[[image:image-20230802112413-34.png||height="734" width="1305"]] 304 304 305 - (% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply createby default.**307 +[[image:image-20230802112413-22.png]] 306 306 307 307 308 - ====3.6.1.3MQTT Integration Setup ====310 +[[image:image-20230802112413-23.png]] 309 309 310 310 311 - Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”**icon toadd a new integration. Nameit (% style="color:blue" %)**“MQTT Integration”**(%%), select type (% style="color:blue" %)**MQTT**;313 +[[image:image-20230802112413-24.png]] 312 312 313 -[[image:image-20230802112413-35.png||height="738" width="1312"]] 314 314 316 +example: 315 315 316 - *Thenextstepsisto add therecentlycreated uplink and downlink converters;318 +AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 317 317 318 -[[image:image-20230802112413- 36.png||height="736" width="1308"]]320 +[[image:image-20230802112413-25.png]] 319 319 320 - [[image:image-20230802112413-37.png||height="735" width="1307"]]322 +== 1.7 Define Publish Topic == 321 321 324 +Publish 322 322 323 - (% style="color:blue" %)**Adda topicfilter:**326 +To upload data into the Datacake Cloud and into a specific device, you publish the data to the respective topic structure. 324 324 325 - tb/mqtt-integration-tutorial/sensors~/~/temperature~-~->Temperature**固定的?对的。**328 +Due to the nature of MQTT, the topic prefix differs as follows: 326 326 327 - You can also selectan MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;330 +dtck-pub~/~// 328 328 329 - [[image:image-20230802112413-38.png||height="731" width="1300"]]332 +example: 330 330 334 +AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 331 331 332 -== =3.6.2Simulatewith MQTT.fx===336 +== 1.8 upload data == 333 333 338 +[[image:image-20230802112413-26.png]] 334 334 335 -[[image:image-20230802112413- 39.png]]340 +[[image:image-20230802112413-27.png]] 336 336 337 -[[image:image-20230802112413- 40.png]]342 +[[image:image-20230802112413-28.png]] 338 338 344 += = 339 339 340 -= ==3.6.3 ConfigureNB-IoT Sensor===346 += 5. Node-Red (via MQTT) = 341 341 342 342 343 - (% style="color:blue"%)**ATCommands**349 +== 1.1 Configure Node-Red == 344 344 345 - * (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard.Payload Type set to 3.351 +[[image:image-20230802112413-29.png]] 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** 353 +[[image:image-20230802112413-30.png]] 352 352 353 - TestUplink by clickthebuttonfor 1 second355 +== 1.2 Simulate Connection == 354 354 355 -[[image:image-20230802112413- 41.png]]357 +[[image:image-20230802112413-31.png]] 356 356 357 - [[image:image-20230802112413-42.png]]359 +== 1.3 Configure NB-IoT Sensors == 358 358 359 -[[image:image-20230802112413-43.png]] 361 +* AT+PRO=3,0(hex format) or 3,5(json format) ~/~/Set to mqtt Server and Payload 362 +* AT+CLIENT=any value 363 +* AT+UNAME=any value 364 +* AT+PWD=any value 365 +* AT+PUBTOPIC=any value 366 +* AT+SUBTOPIC=any value 360 360 368 += 6. ThingsBoard.Cloud (via MQTT) = 361 361 362 -== 3.7[[Tago.io>>url:https://admin.tago.io/]] (viaMQTT)==370 +== 1.1 Configure ThingsBoard == 363 363 364 -=== 3.7.1 Createdevice& Get Credentials===372 +=== 1.1.1 Create Device === 365 365 374 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. 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.376 +[[image:image-20230802112413-32.png]] 368 368 369 - [[image:image-20230802112413-44.png]]378 +=== 1.1.2 Create Uplink & Downlink Converter === 370 370 371 - [[image:image-20230802112413-45.png]]380 +Uplink Converter 372 372 382 +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. 373 373 374 - Goto the Device section and create adevice. Then,go to thesection tokens and copyyour device-token.384 +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. 375 375 376 -[[image:image-20230802112413- 46.png]]386 +[[image:image-20230802112413-33.png]] 377 377 378 378 379 - On the ConnectionProfile window, setthefollowing information: **(这边加一个截图)**389 +Downlink Converter 380 380 381 - * (% style="color:blue" %)**ProfileName:“Anyname”**391 +The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 382 382 383 - * (% style="color:blue" %)**Broker Address:mqtt.tago.io**393 +[[image:image-20230802112413-34.png]] 384 384 385 - * (% style="color:blue" %)**BrokerPort:1883**395 +Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default. 386 386 387 - *(% style="color:blue" %)**ClientID: “Any value”**397 +=== 1.1.3 MQTT Integration Setup === 388 388 389 - OnthesectionUsercredentials,setthefollowing information: **(这边加一个截图)**399 +Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 390 390 391 - * (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the tokenonly401 +[[image:image-20230802112413-35.png]] 392 392 393 -* (%style="color:blue" %)**Password:“Yourdeviceoken”**403 +* The next steps is to add the recently created uplink and downlink converters; 394 394 395 - * (% style="color:blue" %)**PUBTOPIC: “Any value”**405 +[[image:image-20230802112413-36.png]] 396 396 397 - * (% style="color:blue" %)**SUBTOPIC: “Any value”**407 +[[image:image-20230802112413-37.png]] 398 398 399 - === 3.7.2SimulatewithMQTT.fx ===409 +Add a topic filter: 400 400 401 401 402 - [[image:image-20230802112413-47.png]]412 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。 403 403 404 - [[image:image-20230802112413-48.png]]414 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 405 405 406 - Users can run the(% style="color:blue" %)**AT+PRO=3,5**(%%) command, and theayload will be converted to **JSON format**.416 +[[image:image-20230802112413-38.png]] 407 407 418 +== 1.2 Simulate with MQTT.fx == 408 408 409 -[[image:image-20230802112413- 49.png]]420 +[[image:image-20230802112413-39.png]] 410 410 422 +[[image:image-20230802112413-40.png]] 411 411 412 -== =3.7.3tagodata===424 +== 1.3 Configure NB-IoT Sensor == 413 413 426 +AT Commands 414 414 415 - [[image:image-20230802112413-50.png]]428 +AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 416 416 417 - [[image:image-20230802112413-51.png||height="184" width="696"]]430 +AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 418 418 432 +AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 419 419 420 -=== 3.7.4 TLS mode === 421 421 435 +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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性) 422 422 423 - Userscanchoose to use (% style="color:blue" %)**SSL/TLS**(%%) mode.437 +CLIENT :“Any value” 424 424 425 - On the SSL/TLSsection,check the option**EnableSSL/TLS**, and click OK.439 +User Name:“Any value” 426 426 427 - The device needs to enable the TLS mode andset the (%style="color:blue" %)**AT+TLSMOD=1,0**(%%)command.441 +Password:“Any value” 428 428 429 -* (% style="color:blue" %)**Profile Name: “Any name”** 430 430 431 - * (%style="color:blue" %)**BrokerAddress:mqtt.tago.io**444 +Test Uplink by click the button for 1 second 432 432 433 - * (% style="color:blue" %)**Broker Port:8883**446 +[[image:image-20230802112413-41.png]] 434 434 435 - * (% style="color:blue" %)**Client ID:“Any value”**448 +[[image:image-20230802112413-42.png]] 436 436 437 - * (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the tokenonly450 +[[image:image-20230802112413-43.png]] 438 438 439 -* (% style="color:blue" %)**Password: “Your device token”** 440 440 441 - * (% style="color:blue" %)**PUBTOPIC:“Anyvalue”**453 += 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) = 442 442 443 - *(% style="color:blue" %)**SUBTOPIC:“Anyvalue”**455 +== 5.1 Create device & Get Credentials == 444 444 445 -[[ image:image-20230802112413-52.png]]457 +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. 446 446 459 +[[image:image-20230802112413-44.png]] 447 447 448 - ==3.8TCP Connection ==461 +[[image:image-20230802112413-45.png]] 449 449 463 += = 450 450 451 -* **AT+PRO=4,0 ** ~/~/ Set to use TCP protocol to uplink(HEX format) 452 -* **AT+PRO=4,1 ** ~/~/ Set to use TCP protocol to uplink(JSON format) 453 -* **AT+SERVADDR=120.24.4.116,5600 **~/~/ to set TCP server address and port 465 +Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 454 454 455 - **Sensor ConsoleOutput whenUplink**467 +[[image:image-20230802112413-46.png]] 456 456 457 -[[image:image-20230807233631-1.png]] 458 458 470 +On the Connection Profile window, set the following information: (这边加一个截图) 459 459 460 -**See result in TCP Server** 472 +* Profile Name: “Any name” 473 +* Broker Address: mqtt.tago.io 474 +* Broker Port: 1883 475 +* Client ID: “Any value” 461 461 462 - [[image:image-20230807233631-2.png]]477 +On the section User credentials, set the following information:(这边加一个截图) 463 463 479 +* User Name: “Any value” Tago validates your user by the token only 480 +* Password: “Your device token” 481 +* PUBTOPIC: “Any value” 482 +* SUBTOPIC: “Any value” 464 464 484 +== 5.2 Simulate with MQTT.fx == 465 465 486 +[[image:image-20230802112413-47.png]] 487 + 488 +[[image:image-20230802112413-48.png]] 489 + 490 +Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format. 491 + 492 +[[image:image-20230802112413-49.png]] 493 + 494 +== 1.4. tago data == 495 + 496 + 497 +[[image:image-20230802112413-50.png]] 498 + 499 +[[image:image-20230802112413-51.png]] 500 + 501 +== 1.4. TLS mode == 502 + 503 +Users can choose to use SSL/TLS mode. 504 + 505 +On the SSL/TLS section, check the option Enable SSL/TLS, and click OK. 506 + 507 +The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command. 508 + 509 +* Profile Name: “Any name” 510 +* Broker Address: mqtt.tago.io 511 +* Broker Port: 8883 512 +* Client ID: “Any value” 513 +* User Name: “Any value” Tago validates your user by the token only 514 +* Password: “Your device token” 515 +* PUBTOPIC: “Any value” 516 +* SUBTOPIC: “Any value” 517 + 518 +[[image:image-20230802112413-52.png]] 519 + 520 + 466 466
- 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