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, 6 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,14 @@ 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 138 138 129 +=== 3.3.2.2 Publish Data to ThingSpeak Channel === 130 + 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,30 @@ 155 155 [[image:image-20230802112413-11.png]] 156 156 157 157 158 -== =3.3.3Configure NB-IoT Sensor for connection ===149 +== 3.3 Configure NB-IoT Sensor for connection == 159 159 160 -=== =3.3.3.1 AT Commands: ====151 +=== 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 Payload156 +* **AT+PRO=3,1** ~/~/ Set to use ThingSpeak Server and Related Payload 166 166 167 -* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**158 +* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 168 168 169 -* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**160 +* **AT+UNAME=<Your ThingSpeak MQTT User Name>** 170 170 171 -* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**162 +* **AT+PWD=<Your ThingSpeak MQTT Password>** 172 172 173 -* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**164 +* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 174 174 175 -* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**166 +* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 176 176 177 -==== 3.3.3.2 Uplink Examples ==== 178 178 179 179 170 +=== 3.3.2 Uplink Examples === 171 + 172 + 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 ====198 +=== 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,388 @@ 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" %) 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 237 237 238 -== 3.4 Datacake == 214 + 215 +)))|(% colspan="1" rowspan="1" %)((( 216 +Field10 239 239 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 240 240 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 241 241 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 242 242 243 -== 3.5 Node-Red (via MQTT) == 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 244 244 245 -=== 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] === 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 246 246 252 + 253 +)))|(% colspan="1" rowspan="1" %)((( 254 +exit_state/input PA4 247 247 248 -[[image:image-20230802112413-29.png]] 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 249 249 261 + 262 +)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 263 +exit_state/input PA4 250 250 251 -[[image:image-20230802112413-30.png]] 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 252 252 270 + 271 +)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 272 +DS18B20 Temp 253 253 254 -=== 3.5.2 Simulate Connection === 274 + 275 +)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 276 +exit_state/input PA4 255 255 278 + 279 +)))|(% colspan="1" rowspan="1" %)((( 280 +DS18B20 Temp2 256 256 257 -[[image:image-20230802112413-31.png]] 282 + 283 +)))|(% colspan="1" rowspan="1" %)((( 284 +DS18B20 Temp3 258 258 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 259 259 260 -=== 3.5.3 Configure NB-IoT Sensors === 291 + 292 +)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 293 +DS18B20 Temp 261 261 295 + 296 +)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 297 +exit_state/input PA4 262 262 263 -* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%) ~/~/ Set to mqtt Server and Payload 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 264 264 265 -* (% style="color:blue" %)**AT+CLIENT=any value** 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" %) 266 266 267 - *(% style="color:blue"%)**AT+UNAME=any value**307 += 4. Datacake = 268 268 269 - * (% style="color:blue"%)**AT+PWD=anyvalue**309 +== 1.1 Define Product == 270 270 271 - * (%style="color:blue" %)**AT+PUBTOPIC=anyvalue**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. 272 272 273 -* (% style="color:blue" %)**AT+SUBTOPIC=any value** 274 274 275 - == 3.6ThingsBoard.Cloud(via MQTT) ==314 +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". 276 276 277 - === 3.6.1 ConfigureThingsBoard ===316 +[[image:image-20230802112413-14.png]] 278 278 279 -== ==3.6.1.1Create Device ====318 +== 1.2 Create Device == 280 280 320 +In the second step you have to define the device which should be added to the product. 281 281 282 - Create a New Device in[[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Namewhich is used for MQTT connection.322 +[[image:image-20230802112413-15.png]] 283 283 284 - [[image:image-20230802112413-32.png]]324 +Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the "Next" button. 285 285 286 286 287 -== ==3.6.1.2CreateUplink &Downlink Converter====327 +== 1.3 Create Database Fields == 288 288 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. 289 289 290 - (%style="color:blue" %)**Uplink Converter**331 +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". 291 291 292 - The purpose of the decoder function is to parse the incoming data and metadata to a format that ThingsBoard can consume. deviceNameand deviceType are required, while attributes and telemetry are optional. Attributes and telemetry are flat key-value objects.Nested objects are not supported.333 +[[image:image-20230802112413-16.png]] 293 293 294 - To create an uplink convertergo to the(% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) pageand click (% style="color:blue" %)**“plus”** (%%)button.Name it (% style="color:blue" %)**“MQTT Uplink Converter”**(%%) and select type (% style="color:blue" %)"**Uplink"**(%%). Use debugmode for now.335 +[[image:image-20230802112413-17.png]] 295 295 296 - [[image:image-20230802112413-33.png||height="732" width="1302"]]337 +To create a first database field, please click on the "Add Field" button as marked in the screenshot above. 297 297 339 +This will open another modal asking for some required input for your first field. 298 298 299 - (% style="color:blue" %)**Downlink Converter**341 +[[image:image-20230802112413-18.png]] 300 300 301 - The Downlink converter transformingoutgoing RPCmessageand then the Integration sends it to external MQTT broke343 +[[image:image-20230802112413-19.png]] 302 302 303 - [[image:image-20230802112413-34.png||height="734"width="1305"]]345 +== 1.4 Set up Broker == 304 304 305 - (% style="color:red" %)**Note:Ourdevice payload isalreadyhumanreadable data.Therefore,usersdonotneedto writedecoders. Simplycreateby default.**347 +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. 306 306 349 +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. 307 307 308 - ==== 3.6.1.3MQTTIntegrationSetup ====351 +View your Personal Access Token 309 309 353 +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: 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**;355 +[[image:image-20230802112413-20.png]] 312 312 313 - [[image:image-20230802112413-35.png||height="738" width="1312"]]357 +MQTT Client-ID 314 314 359 +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. 315 315 316 - *Thenext steps is to add the recentlycreated uplink and downlink converters;361 +AT+CLIENT=“Any value” 317 317 318 - [[image:image-20230802112413-36.png||height="736" width="1308"]]363 +AT+UNAME=Token 319 319 320 - [[image:image-20230802112413-37.png||height="735" width="1307"]]365 +AT+PWD=Token 321 321 367 +[[image:image-20230802112413-21.png]] 322 322 323 -(% style="color:blue" %)**Add a topic filter:** 324 324 325 - tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature **固定的? 对的。**370 +== 1.6 Create your first Subscription == 326 326 327 - You can also select an MQTT QoSlevel. Weuse MQTT QoS level 0 (At most once)by default;372 +Subscribe 328 328 329 - [[image:image-20230802112413-38.png||height="731"width="1300"]]374 +Data is published according to the following structure: 330 330 376 +dtck~/~// 331 331 332 - === 3.6.2Simulatewith MQTT.fx ===378 +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. 333 333 334 334 335 -[[image:image-20230802112413- 39.png]]381 +[[image:image-20230802112413-22.png]] 336 336 337 -[[image:image-20230802112413-40.png]] 338 338 384 +[[image:image-20230802112413-23.png]] 339 339 340 -=== 3.6.3 Configure NB-IoT Sensor === 341 341 387 +[[image:image-20230802112413-24.png]] 342 342 343 -(% style="color:blue" %)**AT Commands** 344 344 345 - * (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Typeset to 3.390 +example: 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** 392 +AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 352 352 353 - Test Uplink by click thebutton for1second394 +[[image:image-20230802112413-25.png]] 354 354 355 - [[image:image-20230802112413-41.png]]396 +== 1.7 Define Publish Topic == 356 356 357 - [[image:image-20230802112413-42.png]]398 +Publish 358 358 359 - [[image:image-20230802112413-43.png]]400 +To upload data into the Datacake Cloud and into a specific device, you publish the data to the respective topic structure. 360 360 402 +Due to the nature of MQTT, the topic prefix differs as follows: 361 361 362 - == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==404 +dtck-pub~/~// 363 363 364 - === 3.7.1 Create device & Get Credentials ===406 +example: 365 365 408 +AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 366 366 367 - Weuse MQTT Connection to send data to [[Tago.io>>url:https://admin.tago.io/]]. We need to Create Device andGet MQTT Credentials first.410 +== 1.8 upload data == 368 368 369 -[[image:image-20230802112413- 44.png]]412 +[[image:image-20230802112413-26.png]] 370 370 371 -[[image:image-20230802112413- 45.png]]414 +[[image:image-20230802112413-27.png]] 372 372 416 +[[image:image-20230802112413-28.png]] 373 373 374 - Go to the Device section and create a device. Then, go to the section tokens and copy your device-token.418 += = 375 375 376 - [[image:image-20230802112413-46.png]]420 += 5. Node-Red (via MQTT) = 377 377 378 378 379 - Thedevice needs toenablethe TLS modeand set the (%style="color:blue" %)**AT+TLSMOD=1,0**(%%) command.423 +== 1.1 Configure Node-Red == 380 380 381 - On the Connection Profilewindow, set the following information:425 +[[image:image-20230802112413-29.png]] 382 382 383 - * (% style="color:blue" %)**Profile Name:“Any name”**427 +[[image:image-20230802112413-30.png]] 384 384 385 - * (% style="color:blue"%)**BrokerAddress:mqtt.tago.io**429 +== 1.2 Simulate Connection == 386 386 387 - * (% style="color:blue" %)**Broker Port:8883**431 +[[image:image-20230802112413-31.png]] 388 388 389 - * (% style="color:blue"%)**ClientID:“Any value”**433 +== 1.3 Configure NB-IoT Sensors == 390 390 391 -On the section User credentials, set the following information: 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 392 392 393 - * (% style="color:blue"%)**UserName: “Any value”** (%%) ~/~/ Tago validatesyour user by the token only442 += 6. ThingsBoard.Cloud (via MQTT) = 394 394 395 - * (% style="color:blue"%)**Password:“Yourdevicetoken”**444 +== 1.1 Configure ThingsBoard == 396 396 397 - * (% style="color:blue"%)**PUBTOPIC:“Anyvalue”**446 +=== 1.1.1 Create Device === 398 398 399 - * (% style="color:blue" %)**SUBTOPIC:“Any value”**448 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. 400 400 401 - (% style="color:blue" %)**AT command:**450 +[[image:image-20230802112413-32.png]] 402 402 403 - * **AT+PRO=3,0or3,5 **~/~/ hex formatr jsonformat452 +=== 1.1.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”** 454 +Uplink Converter 410 410 411 - === 3.7.2SimulatewithMQTT.fx ===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. 412 412 413 - [[image:image-20230802112413-52.png]]458 +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 460 +[[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**.463 +Downlink Converter 419 419 420 - [[image:image-20230808105217-1.png]]465 +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]]467 +[[image:image-20230802112413-34.png]] 423 423 469 +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 tagodata===471 +=== 1.1.3 MQTT Integration Setup === 426 426 473 +Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 427 427 428 -[[image:image-20230802112413-5 0.png]]475 +[[image:image-20230802112413-35.png]] 429 429 430 - [[image:image-20230802112413-51.png||height="184" width="696"]]477 +* The next steps is to add the recently created uplink and downlink converters; 431 431 479 +[[image:image-20230802112413-36.png]] 432 432 481 +[[image:image-20230802112413-37.png]] 433 433 434 - == 3.8 TCP Connection ==483 +Add a topic filter: 435 435 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 486 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。 440 440 441 - **Sensor ConsoleOutputwhenUplink**488 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 442 442 443 -[[image:image-2023080 7233631-1.png]]490 +[[image:image-20230802112413-38.png]] 444 444 492 +== 1.2 Simulate with MQTT.fx == 445 445 446 - **See resultin TCP Server**494 +[[image:image-20230802112413-39.png]] 447 447 448 -[[image:image-2023080 7233631-2.png]]496 +[[image:image-20230802112413-40.png]] 449 449 498 +== 1.3 Configure NB-IoT Sensor == 450 450 500 +AT Commands 451 451 502 +AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 503 + 504 +AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 505 + 506 +AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 507 + 508 + 509 +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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性) 510 + 511 +CLIENT :“Any value” 512 + 513 +User Name:“Any value” 514 + 515 +Password:“Any value” 516 + 517 + 518 +Test Uplink by click the button for 1 second 519 + 520 +[[image:image-20230802112413-41.png]] 521 + 522 +[[image:image-20230802112413-42.png]] 523 + 524 +[[image:image-20230802112413-43.png]] 525 + 526 + 527 += 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) = 528 + 529 +== 5.1 Create device & Get Credentials == 530 + 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 + 533 +[[image:image-20230802112413-44.png]] 534 + 535 +[[image:image-20230802112413-45.png]] 536 + 537 += = 538 + 539 +Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 540 + 541 +[[image:image-20230802112413-46.png]] 542 + 543 + 544 +On the Connection Profile window, set the following information: (这边加一个截图) 545 + 546 +* Profile Name: “Any name” 547 +* Broker Address: mqtt.tago.io 548 +* Broker Port: 1883 549 +* Client ID: “Any value” 550 + 551 +On the section User credentials, set the following information:(这边加一个截图) 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” 557 + 558 +== 5.2 Simulate with MQTT.fx == 559 + 560 +[[image:image-20230802112413-47.png]] 561 + 562 +[[image:image-20230802112413-48.png]] 563 + 564 +Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format. 565 + 566 +[[image:image-20230802112413-49.png]] 567 + 568 +== 1.4. tago data == 569 + 570 + 571 +[[image:image-20230802112413-50.png]] 572 + 573 +[[image:image-20230802112413-51.png]] 574 + 575 +== 1.4. TLS mode == 576 + 577 +Users can choose to use SSL/TLS mode. 578 + 579 +On the SSL/TLS section, check the option Enable SSL/TLS, and click OK. 580 + 581 +The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command. 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” 591 + 592 +[[image:image-20230802112413-52.png]] 593 + 594 + 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
- image-20230808162301-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.David - Size
-
... ... @@ -1,1 +1,0 @@ 1 -76.9 KB - Content