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,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,252 +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 - OntheConnection Profilewindow, set thefollowing information: **(这边加一个截图)**423 +== 1.1 Configure Node-Red == 380 380 381 - * (% style="color:blue" %)**Profile Name:“Any name”**425 +[[image:image-20230802112413-29.png]] 382 382 383 - * (% style="color:blue" %)**Broker Address:mqtt.tago.io**427 +[[image:image-20230802112413-30.png]] 384 384 385 - *(% style="color:blue" %)**BrokerPort: 1883**429 +== 1.2 Simulate Connection == 386 386 387 - * (% style="color:blue" %)**Client ID:“Any value”**431 +[[image:image-20230802112413-31.png]] 388 388 389 - Onthe sectionUsercredentials,setthefollowing information:**(这边加一个截图)**433 +== 1.3 Configure NB-IoT Sensors == 390 390 391 -* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only 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"%)**Password: “Yourdevicetoken”**442 += 6. ThingsBoard.Cloud (via MQTT) = 394 394 395 - * (% style="color:blue" %)**PUBTOPIC:“Any value”**444 +== 1.1 Configure ThingsBoard == 396 396 397 - * (% style="color:blue"%)**SUBTOPIC:“Anyvalue”**446 +=== 1.1.1 Create Device === 398 398 399 - === 3.7.2 Simulate withMQTT.fx===448 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. 400 400 450 +[[image:image-20230802112413-32.png]] 401 401 402 - [[image:image-20230802112413-47.png]]452 +=== 1.1.2 Create Uplink & Downlink Converter === 403 403 404 - [[image:image-20230802112413-48.png]]454 +Uplink Converter 405 405 406 - Userscanrun the(%style="color:blue" %)**AT+PRO=3,5**(%%)command, and the payloadwillbeconvertedto**JSONformat**.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. 407 407 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. 408 408 409 -[[image:image-20230802112413- 49.png]]460 +[[image:image-20230802112413-33.png]] 410 410 411 411 412 - === 3.7.3 tagodata ===463 +Downlink Converter 413 413 465 +The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 414 414 415 -[[image:image-20230802112413- 50.png]]467 +[[image:image-20230802112413-34.png]] 416 416 417 - [[image:image-20230802112413-51.png||height="184"width="696"]]469 +Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default. 418 418 471 +=== 1.1.3 MQTT Integration Setup === 419 419 420 - === 3.7.4TLSmode===473 +Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 421 421 475 +[[image:image-20230802112413-35.png]] 422 422 423 - Userscanchoose touse(% style="color:blue" %)**SSL/TLS**(%%)mode.477 +* The next steps is to add the recently created uplink and downlink converters; 424 424 425 - On the SSL/TLS section, check the option **EnableSSL/TLS**, and click OK.479 +[[image:image-20230802112413-36.png]] 426 426 427 - The device needs to enable the TLSmodeand set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command.481 +[[image:image-20230802112413-37.png]] 428 428 429 - * (% style="color:blue" %)**ProfileName:“Any name”**483 +Add a topic filter: 430 430 431 -* (% style="color:blue" %)**Broker Address: mqtt.tago.io** 432 432 433 - * (% style="color:blue" %)**BrokerPort:8883**486 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。 434 434 435 - * (%style="color:blue" %)**ClientID:“Anyvalue”**488 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 436 436 437 - * (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the tokenonly490 +[[image:image-20230802112413-38.png]] 438 438 439 - * (% style="color:blue"%)**Password:“Your devicetoken”**492 +== 1.2 Simulate with MQTT.fx == 440 440 441 - * (% style="color:blue" %)**PUBTOPIC: “Any value”**494 +[[image:image-20230802112413-39.png]] 442 442 443 - * (% style="color:blue" %)**SUBTOPIC: “Any value”**496 +[[image:image-20230802112413-40.png]] 444 444 445 - [[image:image-20230802112413-52.png]]498 +== 1.3 Configure NB-IoT Sensor == 446 446 500 +AT Commands 447 447 448 -= =3.8TCP Connection==502 +AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 449 449 504 +AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 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 506 +AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 454 454 455 -**Sensor Console Output when Uplink** 456 456 457 - [[image:image-20230807233631-1.png]]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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性) 458 458 511 +CLIENT :“Any value” 459 459 460 - **Seeresult inTCP Server**513 +User Name:“Any value” 461 461 462 - [[image:image-20230807233631-2.png]]515 +Password:“Any value” 463 463 464 464 518 +Test Uplink by click the button for 1 second 465 465 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 + 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