Last modified by Mengting Qiu on 2025/07/03 18:55
From version 53.9
edited by Xiaoling
on 2023/08/02 11:57
on 2023/08/02 11:57
Change comment:
There is no comment for this version
To version 59.1
edited by Edwin Chen
on 2023/08/07 10:07
on 2023/08/07 10:07
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Xiaoling1 +XWiki.Edwin - Content
-
... ... @@ -4,7 +4,6 @@ 4 4 {{toc/}} 5 5 6 6 7 - 8 8 = 1. The use of this guideline = 9 9 10 10 ... ... @@ -11,20 +11,29 @@ 11 11 This configure instruction is for Dragino NB-IoT models with -NB or -NS suffix, for example DDS75-NB. These models use the same NB-IoT Module **[[BC660K-GL>>https://www.quectel.com/product/lpwa-bc660k-gl-nb2]]** and has the same software structure. The have the same configure instruction to different IoT servers. Use can follow the instruction here to see how to configure to connect to those servers. 12 12 13 13 14 -= 2. Network Connection=13 += 2. Attach Network = 15 15 16 16 17 -The -NBand-NS modelssupport (%style="color:blue"%)**LTE CatNB2**(%%), with belowfrequency band: multiple frequency bandsof (% style="color:blue" %)**B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85**(%%) . Makesure youusea theNB-IoT SIM card.16 +To attache NB-IoT sensors to NB-IoT Network, You need to: 18 18 19 -(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:510px" %) 20 -|(% style="background-color:#4f81bd; color:white" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white" %)**APN**|(% style="background-color:#4f81bd; color:white" %)**NB-IoT Coverage**|(% style="background-color:#4f81bd; color:white" %)**Comments** 21 -|1NCE| | | 22 -|China Mobile| | | 18 +1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone) 19 +1. Insert the SIM card to Sensor 20 +1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (% class="mark" %)(补充 APN 指令(%%)) 23 23 24 - ==2.11NCESIMCard.==22 +After doing above, the NB-IoT Sensors should be able to attach to NB-IoT network . 25 25 24 +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 26 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %) 27 +|(% 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** 28 +|(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:474px" %)((( 29 +**[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]** 27 27 31 +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 32 +)))|(% style="width:135px" %) 33 +|(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:474px" %)China Mainland, HongKong|(% style="width:135px" %) 34 +|(% style="width:117px" %)China Telecom|(% style="width:151px" %) |(% style="width:474px" %)China Mainland|(% style="width:135px" %) 35 + 28 28 = 3. Configure to connect to different servers = 29 29 30 30 == 3.1 General UDP Connection == ... ... @@ -105,9 +105,9 @@ 105 105 [[image:image-20230802112413-7.png]] 106 106 107 107 108 -== 3.3.2 Simulate with MQTT.fx == 116 +=== 3.3.2 Simulate with MQTT.fx === 109 109 110 -=== 3.3.2.1 Establish MQTT Connection === 118 +==== 3.3.2.1 Establish MQTT Connection ==== 111 111 112 112 113 113 After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine. ... ... @@ -117,49 +117,57 @@ 117 117 * (% style="color:#037691" %)**Broker Address:**(%%) mqtt3.thingspeak.com 118 118 119 119 * (% style="color:#037691" %)**Broker Port:**(%%) 1883 128 + 120 120 * (% style="color:#037691" %)**Client ID:**(%%) <Your ThingSpeak MQTT ClientID> 130 + 121 121 * (% style="color:#037691" %)**User Name:**(%%) <Your ThingSpeak MQTT User Name> 132 + 122 122 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password> 123 123 124 -=== 3.3.2.2 Publish Data to ThingSpeak Channel === 135 +==== 3.3.2.2 Publish Data to ThingSpeak Channel ==== 125 125 137 + 126 126 [[image:image-20230802112413-9.png]] 127 127 128 128 [[image:image-20230802112413-10.png]] 129 129 130 -In MQTT.fx, we can publish below info: 131 131 132 -* Topic: channels/YOUR_CHANNEL_ID/publish 133 -* Payload: field1=63&field2=67&status=MQTTPUBLISH 143 +(% style="color:blue" %)**In MQTT.fx, we can publish below info:** 134 134 145 +* (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish 146 + 147 +* (% style="color:#037691" %)**Payload:**(%%) field1=63&field2=67&status=MQTTPUBLISH 148 + 135 135 Where 63 and 67 are the value to be published to field1 & field2. 136 136 137 137 138 -Result: 152 +(% style="color:blue" %)**Result: ** 139 139 140 140 [[image:image-20230802112413-11.png]] 141 141 142 142 143 -== 1.3157 +=== 3.3.3 Configure NB-IoT Sensor for connection === 144 144 145 -=== 1.3.1 AT Commands: ===159 +==== 3.3.3.1 AT Commands: ==== 146 146 161 + 147 147 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx 148 148 149 -* AT+PRO=3,1 164 +* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload 150 150 151 -* AT+CLIENT=<Your ThingSpeak MQTT ClientID> 166 +* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 152 152 153 -* AT+UNAME=<Your ThingSpeak MQTT User Name> 168 +* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>** 154 154 155 -* AT+PWD=<Your ThingSpeak MQTT Password> 170 +* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>** 156 156 157 -* AT+PUBTOPIC=<YOUR_CHANNEL_ID> 172 +* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 158 158 159 -* AT+SUBTOPIC=<YOUR_CHANNEL_ID> 174 +* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 160 160 161 -=== 1.3.2 Uplink Examples ===176 +==== 3.3.3.2 Uplink Examples ==== 162 162 178 + 163 163 For S31-NB 164 164 165 165 For SE01-NB ... ... @@ -185,8 +185,9 @@ 185 185 For SN50V3-NB 186 186 187 187 188 -=== 1.3.2Map fields to sensor value ===204 +==== 3.3.3.3 Map fields to sensor value ==== 189 189 206 + 190 190 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. 191 191 192 192 ... ... @@ -197,387 +197,235 @@ 197 197 198 198 Below is the NB-IoT Product Table show the mapping. 199 199 200 -|(% 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" %)((( 201 -Field9 217 +(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1386px" %) 218 +|(% 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 219 +|(% 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" %) 220 +|(% 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" %) 221 +|(% 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" %) 222 +|(% 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" %) 223 +|(% 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" %) 224 +|(% 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" %) 225 +|(% 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" %) 226 +|(% 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" %) 227 +|(% 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" %) 228 +|(% 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" %) 229 +|(% 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 230 +|(% 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" %) 231 +|(% 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" %) 232 +|(% 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" %) 233 +|(% 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" %) 234 +|(% 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" %) 235 +|(% 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" %) 202 202 203 - 204 -)))|(% colspan="1" rowspan="1" %)((( 205 -Field10 237 +== 3.4 Datacake == 206 206 207 - 208 -))) 209 -|(% 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" %) 210 -|(% 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" %) 211 -|(% colspan="1" rowspan="1" %)DDS20-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 212 -Battery 213 213 214 - 215 -)))|(% 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" %) 216 -|(% colspan="1" rowspan="1" %)DDS45-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 217 -Battery 218 218 219 - 220 -)))|(% 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" %) 221 -|(% colspan="1" rowspan="1" %)DDS75-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 222 -Battery 223 223 224 - 225 -)))|(% 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" %) 226 -|(% colspan="1" rowspan="1" %)NMDS120-NB|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %)((( 227 -Battery 242 +== 3.5 Node-Red (via MQTT) == 228 228 229 - 230 -)))|(% 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" %) 231 -|(% 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" %) 232 -|(% 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" %) 233 -|(% 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" %) 234 -|(% 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" %) 235 -|(% 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 236 -|(% 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" %) 237 -|(% 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" %) 238 -|(% colspan="1" rowspan="1" %)mod2|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)Battery|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 239 -DS18B20 Temp 244 +=== 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] === 240 240 241 - 242 -)))|(% colspan="1" rowspan="1" %)((( 243 -exit_state/input PA4 244 244 245 - 246 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)distance|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 247 -|(% colspan="1" rowspan="1" %)mod3|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 248 -Battery 247 +[[image:image-20230802112413-29.png]] 249 249 250 - 251 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 252 -exit_state/input PA4 253 253 254 - 255 -)))|(% colspan="1" rowspan="1" %)adc1|(% colspan="1" rowspan="1" %)Temperature|(% colspan="1" rowspan="1" %)Humidity|(% colspan="1" rowspan="1" %)adc4|(% colspan="1" rowspan="1" %) 256 -|(% colspan="1" rowspan="1" %)mod4|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 257 -Battery 250 +[[image:image-20230802112413-30.png]] 258 258 259 - 260 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 261 -DS18B20 Temp 262 262 263 - 264 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 265 -exit_state/input PA4 253 +=== 3.5.2 Simulate Connection === 266 266 267 - 268 -)))|(% colspan="1" rowspan="1" %)((( 269 -DS18B20 Temp2 270 270 271 - 272 -)))|(% colspan="1" rowspan="1" %)((( 273 -DS18B20 Temp3 256 +[[image:image-20230802112413-31.png]] 274 274 275 - 276 -)))|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 277 -|(% colspan="1" rowspan="1" %)mod5|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 278 -Battery 279 279 280 - 281 -)))|(% colspan="1" rowspan="1" %)RSSI|(% colspan="1" rowspan="1" %)((( 282 -DS18B20 Temp 259 +=== 3.5.3 Configure NB-IoT Sensors === 283 283 284 - 285 -)))|(% colspan="1" rowspan="1" %)adc0|(% colspan="1" rowspan="1" %)((( 286 -exit_state/input PA4 287 287 288 - 289 -)))|(% colspan="1" rowspan="1" %)Weight|(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) |(% colspan="1" rowspan="1" %) 290 -|(% colspan="1" rowspan="1" %)mod6|(% colspan="1" rowspan="1" %)mod|(% colspan="1" rowspan="1" %)((( 291 -Battery 262 +* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%) ~/~/ Set to mqtt Server and Payload 292 292 293 - 294 -)))|(% 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" %) 264 +* (% style="color:blue" %)**AT+CLIENT=any value** 295 295 296 - =4. Datacake =266 +* (% style="color:blue" %)**AT+UNAME=any value** 297 297 298 - ==1.1 Define Product==268 +* (% style="color:blue" %)**AT+PWD=any value** 299 299 300 - Firstly, weneed to set the MQTT mode to datacake, and we need tonAT+PRO=3,2. This commandis set to datacake. After running the command, the deviceautomatically sets the server address, port.270 +* (% style="color:blue" %)**AT+PUBTOPIC=any value** 301 301 272 +* (% style="color:blue" %)**AT+SUBTOPIC=any value** 302 302 303 - Bychosingtodd the device undera "New Product" youare requiredto give a name for this product. You canname it something like "My First MQTTProduct".274 +== 3.6 ThingsBoard.Cloud (via MQTT) == 304 304 305 - [[image:image-20230802112413-14.png]]276 +=== 3.6.1 Configure ThingsBoard === 306 306 307 -== 1. 2Create Device ==278 +==== 3.6.1.1 Create Device ==== 308 308 309 -In the second step you have to define the device which should be added to the product. 310 310 311 -[[i mage:image-20230802112413-15.png]]281 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection. 312 312 313 - Enter a name here (suchas "My First MQTT Device") and complete the creation of the device by clickingon the"Next" button.283 +[[image:image-20230802112413-32.png]] 314 314 315 315 316 -== 1. 3CreateDatabaseFields==286 +==== 3.6.1.2 Create Uplink & Downlink Converter ==== 317 317 318 -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. 319 319 320 - You will thensee a device view with an emptydashboard. Now, thefirst thing we want to do is navigate to the Device configuration. To do this,usethe tab bar and clickon "Configuration".289 +(% style="color:blue" %)**Uplink Converter** 321 321 322 - [[image:image-20230802112413-16.png]]291 +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. 323 323 324 - [[image:image-20230802112413-17.png]]293 +To create an uplink converter go to the (% style="color:blue" %)**Integrations center**(%%) -> (% style="color:blue" %)**Data converters**(%%) page and click (% style="color:blue" %)**“plus”** (%%)button. Name it (% style="color:blue" %)**“MQTT Uplink Converter”**(%%) and select type (% style="color:blue" %)"**Uplink"**(%%). Use debug mode for now. 325 325 326 - To create a first databasefield, pleaseclick ontheAdd Field" button as marked in the screenshot above.295 +[[image:image-20230802112413-33.png||height="732" width="1302"]] 327 327 328 -This will open another modal asking for some required input for your first field. 329 329 330 - [[image:image-20230802112413-18.png]]298 +(% style="color:blue" %)**Downlink Converter** 331 331 332 - [[image:image-20230802112413-19.png]]300 +The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 333 333 334 - ==1.4Set upBroker==302 +[[image:image-20230802112413-34.png||height="734" width="1305"]] 335 335 336 - Thebrokerisrunningon mqtt.datacake.coonports 1883and8883. Port 1883isunsecuredandshouldnotbeusedin productionenvironments. Port8883usesaCAsignedservercertificate.304 +(% style="color:red" %)**Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.** 337 337 338 -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. 339 339 340 - ViewyourPersonalAccess Token307 +==== 3.6.1.3 MQTT Integration Setup ==== 341 341 342 -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: 343 343 344 - [[image:image-20230802112413-20.png]]310 +Go to the (% style="color:blue" %)**Integrations center**(%%) **->** (% style="color:blue" %)**Integrations page**(%%) and click **“(% style="color:blue" %)plus(%%)”** icon to add a new integration. Name it (% style="color:blue" %)**“MQTT Integration”**(%%), select type (% style="color:blue" %)**MQTT**; 345 345 346 - MQTT Client-ID312 +[[image:image-20230802112413-35.png||height="738" width="1312"]] 347 347 348 -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. 349 349 350 - AT+CLIENT=“Anyvalue”315 +* The next steps is to add the recently created uplink and downlink converters; 351 351 352 - AT+UNAME=Token317 +[[image:image-20230802112413-36.png||height="736" width="1308"]] 353 353 354 - AT+PWD=Token319 +[[image:image-20230802112413-37.png||height="735" width="1307"]] 355 355 356 -[[image:image-20230802112413-21.png]] 357 357 322 +(% style="color:blue" %)**Add a topic filter:** 358 358 359 - == 1.6 Create yourfirstSubscription ==324 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature **固定的? 对的。** 360 360 361 -Su bscribe326 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 362 362 363 - Dataispublished accordingto the following structure:328 +[[image:image-20230802112413-38.png||height="731" width="1300"]] 364 364 365 -dtck~/~// 366 366 367 -S ubscribe to topicsusingthis structureto receive messages via MQTTwhenreadings (via API orMQTT) arrive in the Datacake Cloud.Messages are published whenever there is a change to a corresponding databasefield.331 +=== 3.6.2 Simulate with MQTT.fx === 368 368 369 369 370 -[[image:image-20230802112413- 22.png]]334 +[[image:image-20230802112413-39.png]] 371 371 336 +[[image:image-20230802112413-40.png]] 372 372 373 -[[image:image-20230802112413-23.png]] 374 374 339 +=== 3.6.3 Configure NB-IoT Sensor === 375 375 376 -[[image:image-20230802112413-24.png]] 377 377 342 +(% style="color:blue" %)**AT Commands** 378 378 379 -e xample:344 +* (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3. 380 380 381 -AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 346 +* (% style="color:#037691" %)**AT+SUBTOPIC=<device name>** (%%) 347 +* (% style="color:#037691" %)**AT+PUBTOPIC=<device name>** 348 +* (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined** 349 +* (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined** 350 +* (% style="color:#037691" %)**AT+PWD=<device name> or User Defined** 382 382 383 - [[image:image-20230802112413-25.png]]352 + 384 384 385 - == 1.7 DefinePublishTopic==354 +Test Uplink by click the button for 1 second 386 386 387 - Publish356 +[[image:image-20230802112413-41.png]] 388 388 389 - To upload datainto the DatacakeCloud andintoaspecific device, you publish the data to the respective topic structure.358 +[[image:image-20230802112413-42.png]] 390 390 391 - Due to the natureof MQTT, the topic prefix differsas follows:360 +[[image:image-20230802112413-43.png]] 392 392 393 -dtck-pub~/~// 394 394 395 - example:363 +== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) == 396 396 397 - AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature365 +=== 3.7.1 Create device & Get Credentials === 398 398 399 -== 1.8 upload data == 400 400 401 -[[ image:image-20230802112413-26.png]]368 +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. 402 402 403 -[[image:image-20230802112413- 27.png]]370 +[[image:image-20230802112413-44.png]] 404 404 405 -[[image:image-20230802112413- 28.png]]372 +[[image:image-20230802112413-45.png]] 406 406 407 -= = 408 408 409 - = 5.Node-Red(viaMQTT) =375 +Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 410 410 377 +[[image:image-20230802112413-46.png]] 411 411 412 -== 1.1 Configure Node-Red == 413 413 414 - [[image:image-20230802112413-29.png]]380 +On the Connection Profile window, set the following information: **(这边加一个截图)** 415 415 416 - [[image:image-20230802112413-30.png]]382 +* (% style="color:blue" %)**Profile Name: “Any name”** 417 417 418 - ==1.2 SimulateConnection ==384 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io** 419 419 420 - [[image:image-20230802112413-31.png]]386 +* (% style="color:blue" %)**Broker Port: 1883** 421 421 422 -= =1.3ConfigureNB-IoTSensors ==388 +* (% style="color:blue" %)**Client ID: “Any value”** 423 423 424 -* AT+PRO=3,0(hex format) or 3,5(json format) ~/~/Set to mqtt Server and Payload 425 -* AT+CLIENT=any value 426 -* AT+UNAME=any value 427 -* AT+PWD=any value 428 -* AT+PUBTOPIC=any value 429 -* AT+SUBTOPIC=any value 390 +On the section User credentials, set the following information: **(这边加一个截图)** 430 430 431 -= 6.ThingsBoard.Cloud(viaMQTT) =392 +* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only 432 432 433 -= =1.1ConfigureThingsBoard ==394 +* (% style="color:blue" %)**Password: “Your device token”** 434 434 435 - ===1.1.1 CreateDevice===396 +* (% style="color:blue" %)**PUBTOPIC: “Any value”** 436 436 437 - Createa New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]].398 +* (% style="color:blue" %)**SUBTOPIC: “Any value”** 438 438 439 - [[image:image-20230802112413-32.png]]400 +=== 3.7.2 Simulate with MQTT.fx === 440 440 441 -=== 1.1.2 Create Uplink & Downlink Converter === 442 442 443 - Uplink Converter403 +[[image:image-20230802112413-47.png]] 444 444 445 - 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.405 +[[image:image-20230802112413-48.png]] 446 446 447 - Tocreate an uplinkconverter go to theIntegrationscenter -> Dataconverterspageandclick“plus” button. Nameit “MQTT UplinkConverter” andselecttype Uplink. Use debug modefornow.407 +Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**. 448 448 449 -[[image:image-20230802112413-33.png]] 450 450 410 +[[image:image-20230802112413-49.png]] 451 451 452 -Downlink Converter 453 453 454 - TheDownlink converter transformingutgoingRPC message andthen the Integration sends it to external MQTT broke413 +=== 3.7.3 tago data === 455 455 456 -[[image:image-20230802112413-34.png]] 457 457 458 - Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply createby default.416 +[[image:image-20230802112413-50.png]] 459 459 460 - ===1.1.3MQTT Integration Setup===418 +[[image:image-20230802112413-51.png||height="184" width="696"]] 461 461 462 -Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 463 463 464 - [[image:image-20230802112413-35.png]]421 +=== 3.7.4 TLS mode === 465 465 466 -* The next steps is to add the recently created uplink and downlink converters; 467 467 468 - [[image:image-20230802112413-36.png]]424 +Users can choose to use (% style="color:blue" %)**SSL/TLS**(%%) mode. 469 469 470 - [[image:image-20230802112413-37.png]]426 +On the SSL/TLS section, check the option **Enable SSL/TLS**, and click OK. 471 471 472 - Add a topicfilter:428 +The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command. 473 473 430 +* (% style="color:blue" %)**Profile Name: “Any name”** 474 474 475 -t b/mqtt-integration-tutorial/sensors~/~/temperature~-~->Temperature 固定的? 对的。432 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io** 476 476 477 - You can also select an MQTT QoSlevel. WeuseMQTT QoS level0 (At mostonce) by default;434 +* (% style="color:blue" %)**Broker Port: 8883** 478 478 479 - [[image:image-20230802112413-38.png]]436 +* (% style="color:blue" %)**Client ID: “Any value”** 480 480 481 -= =1.2SimulatewithMQTT.fx ==438 +* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only 482 482 483 - [[image:image-20230802112413-39.png]]440 +* (% style="color:blue" %)**Password: “Your device token”** 484 484 485 - [[image:image-20230802112413-40.png]]442 +* (% style="color:blue" %)**PUBTOPIC: “Any value”** 486 486 487 - ==1.3ConfigureNB-IoTSensor ==444 +* (% style="color:blue" %)**SUBTOPIC: “Any value”** 488 488 489 -AT Commands 490 - 491 -AT+PRO=3,3 ~/~/ Use MQTT to connect to ThingsBoard. 492 - 493 -AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 494 - 495 -AT+PUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 496 - 497 - 498 -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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性) 499 - 500 -CLIENT :“Any value” 501 - 502 -User Name:“Any value” 503 - 504 -Password:“Any value” 505 - 506 - 507 -Test Uplink by click the button for 1 second 508 - 509 -[[image:image-20230802112413-41.png]] 510 - 511 -[[image:image-20230802112413-42.png]] 512 - 513 -[[image:image-20230802112413-43.png]] 514 - 515 - 516 -= 7. [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) = 517 - 518 -== 5.1 Create device & Get Credentials == 519 - 520 -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. 521 - 522 -[[image:image-20230802112413-44.png]] 523 - 524 -[[image:image-20230802112413-45.png]] 525 - 526 -= = 527 - 528 -Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 529 - 530 -[[image:image-20230802112413-46.png]] 531 - 532 - 533 -On the Connection Profile window, set the following information: (这边加一个截图) 534 - 535 -* Profile Name: “Any name” 536 -* Broker Address: mqtt.tago.io 537 -* Broker Port: 1883 538 -* Client ID: “Any value” 539 - 540 -On the section User credentials, set the following information:(这边加一个截图) 541 - 542 -* User Name: “Any value” Tago validates your user by the token only 543 -* Password: “Your device token” 544 -* PUBTOPIC: “Any value” 545 -* SUBTOPIC: “Any value” 546 - 547 -== 5.2 Simulate with MQTT.fx == 548 - 549 -[[image:image-20230802112413-47.png]] 550 - 551 -[[image:image-20230802112413-48.png]] 552 - 553 -Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format. 554 - 555 -[[image:image-20230802112413-49.png]] 556 - 557 -== 1.4. tago data == 558 - 559 - 560 -[[image:image-20230802112413-50.png]] 561 - 562 -[[image:image-20230802112413-51.png]] 563 - 564 -== 1.4. TLS mode == 565 - 566 -Users can choose to use SSL/TLS mode. 567 - 568 -On the SSL/TLS section, check the option Enable SSL/TLS, and click OK. 569 - 570 -The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command. 571 - 572 -* Profile Name: “Any name” 573 -* Broker Address: mqtt.tago.io 574 -* Broker Port: 8883 575 -* Client ID: “Any value” 576 -* User Name: “Any value” Tago validates your user by the token only 577 -* Password: “Your device token” 578 -* PUBTOPIC: “Any value” 579 -* SUBTOPIC: “Any value” 580 - 581 581 [[image:image-20230802112413-52.png]] 582 582 583 583