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)
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. ... ... @@ -124,13 +124,14 @@ 124 124 125 125 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password> 126 126 135 +==== 3.3.2.2 Publish Data to ThingSpeak Channel ==== 127 127 128 -=== 3.3.2.2 Publish Data to ThingSpeak Channel === 129 129 130 130 [[image:image-20230802112413-9.png]] 131 131 132 132 [[image:image-20230802112413-10.png]] 133 133 142 + 134 134 (% style="color:blue" %)**In MQTT.fx, we can publish below info:** 135 135 136 136 * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish ... ... @@ -145,29 +145,28 @@ 145 145 [[image:image-20230802112413-11.png]] 146 146 147 147 148 -== 3.3 157 +=== 3.3.3 Configure NB-IoT Sensor for connection === 149 149 150 -=== 3.3.1 AT Commands: === 159 +==== 3.3.3.1 AT Commands: ==== 151 151 152 152 153 153 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx 154 154 155 -* **AT+PRO=3,1** 164 +* (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload 156 156 157 -* **AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 166 +* (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>** 158 158 159 -* **AT+UNAME=<Your ThingSpeak MQTT User Name>** 168 +* (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>** 160 160 161 -* **AT+PWD=<Your ThingSpeak MQTT Password>** 170 +* (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>** 162 162 163 -* **AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 172 +* (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>** 164 164 165 -* **AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 174 +* (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>** 166 166 176 +==== 3.3.3.2 Uplink Examples ==== 167 167 168 -=== 3.3.2 Uplink Examples === 169 169 170 - 171 171 For S31-NB 172 172 173 173 For SE01-NB ... ... @@ -193,7 +193,7 @@ 193 193 For SN50V3-NB 194 194 195 195 196 -=== 3.3.3 204 +==== 3.3.3.3 Map fields to sensor value ==== 197 197 198 198 199 199 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. ... ... @@ -206,315 +206,240 @@ 206 206 207 207 Below is the NB-IoT Product Table show the mapping. 208 208 209 -(% border="1" cellspacing="4" style="width:1386px;background-color:#F2F2F2" %) 210 -|(% style="width:124px;background-color:#4F81BD" %) |(% style="width:91px;background-color:#4F81BD;color:white" %)Field1|(% style="width:102px;background-color:#4F81BD;color:white" %)Field2|(% style="width:159px;background-color:#4F81BD;color:white" %)Field3|(% style="width:153px;background-color:#4F81BD;color:white" %)Field4|(% style="width:152px;background-color:#4F81BD;color:white" %)Field5|(% style="width:148px;background-color:#4F81BD;color:white" %)Field6|(% style="width:164px;background-color:#4F81BD;color:white" %)Field7|(% style="width:152px;background-color:#4F81BD;color:white" %)Field8|(% style="width:66px;background-color:#4F81BD;color:white" %)Field9|(% style="width:66px;background-color:#4F81BD;color:white" %)Field10 211 -|(% style="width:124px;background-color:#4F81BD;color:white" %)S31x-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)Battery|(% style="width:153px" %)RSSI|(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 212 -|(% style="width:124px;background-color:#4F81BD;color:white" %)SE01-NB|(% style="width:91px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:159px" %)conduct|(% style="width:153px" %)dielectric_constant|(% style="width:152px" %)Battery|(% style="width:148px" %)RSSI|(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 213 -|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS20-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 214 -|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS45-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 215 -|(% style="width:124px;background-color:#4F81BD;color:white" %)DDS75-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% style="width:159px" %)RSSI|(% style="width:153px" %) |(% style="width:152px" %) |(% style="width:148px" %) |(% style="width:164px" %) |(% style="width:152px" %) |(% style="width:66px" %) |(% style="width:66px" %) 216 -|(% style="width:124px;background-color:#4F81BD;color:white" %)NMDS120-NB|(% style="width:91px" %)distance|(% style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %) |(% 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" %) 217 -|(% colspan="1" rowspan="1" style="width:124px" %)SPH01-NB|(% colspan="1" rowspan="1" style="width:91px" %)ph|(% colspan="1" rowspan="1" style="width:102px" %)Temperature|(% colspan="1" rowspan="1" style="width:159px" %)Battery|(% colspan="1" rowspan="1" style="width:153px" %)RSSI|(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:148px" %) |(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 218 -|(% colspan="1" rowspan="1" style="width:124px" %)NLM01-NB|(% colspan="1" rowspan="1" style="width:91px" %)Humidity|(% colspan="1" rowspan="1" style="width:102px" %)Temperature|(% colspan="1" rowspan="1" style="width:159px" %)Battery|(% colspan="1" rowspan="1" style="width:153px" %)RSSI|(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:148px" %) |(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 219 -|(% colspan="1" rowspan="1" style="width:124px" %)NMDS200-NB|(% colspan="1" rowspan="1" style="width:91px" %)distance1|(% colspan="1" rowspan="1" style="width:102px" %)distance2|(% colspan="1" rowspan="1" style="width:159px" %)Battery|(% colspan="1" rowspan="1" style="width:153px" %)RSSI|(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:148px" %) |(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 220 -|(% colspan="1" rowspan="1" style="width:124px" %)CPN01-NB|(% colspan="1" rowspan="1" style="width:91px" %)alarm|(% colspan="1" rowspan="1" style="width:102px" %)count|(% colspan="1" rowspan="1" style="width:159px" %)door open duration|(% colspan="1" rowspan="1" style="width:153px" %)calc flag|(% colspan="1" rowspan="1" style="width:152px" %)Battery|(% colspan="1" rowspan="1" style="width:148px" %)RSSI|(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 221 -|(% colspan="1" rowspan="1" style="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 222 -|(% colspan="1" rowspan="1" style="width:124px" %)SN50V3-NB|(% colspan="1" rowspan="1" style="width:91px" %) |(% colspan="1" rowspan="1" style="width:102px" %) |(% colspan="1" rowspan="1" style="width:159px" %) |(% colspan="1" rowspan="1" style="width:153px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:148px" %) |(% colspan="1" rowspan="1" style="width:164px" %) |(% colspan="1" rowspan="1" style="width:152px" %) |(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 223 -|(% colspan="1" rowspan="1" style="width:124px" %)mod1|(% colspan="1" rowspan="1" style="width:91px" %)mod|(% colspan="1" rowspan="1" style="width:102px" %)Battery|(% colspan="1" rowspan="1" style="width:159px" %)RSSI|(% colspan="1" rowspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" rowspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" rowspan="1" style="width:148px" %)adc0|(% colspan="1" rowspan="1" style="width:164px" %)Temperature |(% colspan="1" rowspan="1" style="width:152px" %)Humidity|(% colspan="1" rowspan="1" style="width:66px" %) |(% colspan="1" rowspan="1" style="width:66px" %) 224 -|(% colspan="1" style="width:124px" %)mod2|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc0|(% colspan="1" style="width:164px" %)distance|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 225 -|(% colspan="1" style="width:124px" %)mod3|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:152px" %)exit_state/input PA4|(% colspan="1" style="width:148px" %)adc1|(% colspan="1" style="width:164px" %)Temperature|(% colspan="1" style="width:152px" %)Humidity|(% colspan="1" style="width:66px" %)adc4|(% colspan="1" style="width:66px" %) 226 -|(% colspan="1" style="width:124px" %)mod4|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)DS18B20 Temp2|(% colspan="1" style="width:152px" %)DS18B20 Temp3|(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 227 -|(% colspan="1" style="width:124px" %)mod5|(% colspan="1" style="width:91px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:159px" %)RSSI|(% colspan="1" style="width:153px" %)DS18B20 Temp|(% colspan="1" style="width:152px" %)adc0|(% colspan="1" style="width:148px" %)exit_state/input PA4|(% colspan="1" style="width:164px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:66px" %) |(% colspan="1" style="width:66px" %) 228 -|(% colspan="1" style="width:124px" %)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" %) 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" %) 229 229 230 - 231 - 232 232 == 3.4 Datacake == 233 233 234 -== 3.4.1 Define Product == 235 235 236 236 237 -Firstly, we need to set the MQTT mode to datacake, and we need to run** AT+PRO=3,2**. This command is set to datacake. After running the command, the device automatically sets the server address, port. 238 238 242 +== 3.5 Node-Red (via MQTT) == 239 239 240 - Bychosing to add the deviceundera **"NewProduct"** you arerequiredo giveaame for this product.Youcan name it something like"My First MQTT Product".244 +=== 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] === 241 241 242 -[[image:image-20230802112413-14.png]] 243 243 244 - == 1.2 CreateDevice==247 +[[image:image-20230802112413-29.png]] 245 245 246 -In the second step you have to define the device which should be added to the product. 247 247 248 -[[image:image-20230802112413- 15.png]]250 +[[image:image-20230802112413-30.png]] 249 249 250 -Enter a name here (such as "My First MQTT Device") and complete the creation of the device by clicking on the "Next" button. 251 251 253 +=== 3.5.2 Simulate Connection === 252 252 253 -== 1.3 Create Database Fields == 254 254 255 - After creatingthedevice, it is listed in the tableof the fleet view.Now openthe device by clickingon the entry in the list.256 +[[image:image-20230802112413-31.png]] 256 256 257 -You will then see a device view with an empty dashboard. Now, the first thing we want to do is navigate to the Device configuration. To do this, use the tab bar and click on "Configuration". 258 258 259 - [[image:image-20230802112413-16.png]]259 +=== 3.5.3 Configure NB-IoT Sensors === 260 260 261 -[[image:image-20230802112413-17.png]] 262 262 263 - Tocreateafirst databasefield,please clickon the"AddField"buttonasmarkedinthescreenshotabove.262 +* (% style="color:blue" %)**AT+PRO=3,0(hex format) or 3,5(json format)**(%%) ~/~/ Set to mqtt Server and Payload 264 264 265 - Thiswill open another modalasking forsome required input foryourfirst field.264 +* (% style="color:blue" %)**AT+CLIENT=any value** 266 266 267 - [[image:image-20230802112413-18.png]]266 +* (% style="color:blue" %)**AT+UNAME=any value** 268 268 269 - [[image:image-20230802112413-19.png]]268 +* (% style="color:blue" %)**AT+PWD=any value** 270 270 271 - ==1.4 Setup Broker ==270 +* (% style="color:blue" %)**AT+PUBTOPIC=any value** 272 272 273 - The broker isrunning on mqtt.datacake.coon ports 1883 and 8883. Port 1883 is unsecured and should notbeused in production environments.Port 8883 uses aCA signedserver certificate.272 +* (% style="color:blue" %)**AT+SUBTOPIC=any value** 274 274 275 - Youwillneed an access token to loginto the Datacake MQTTBroker. You can use yourown personal token or create a token explicitly for individualdevicesor groups ofdevices.274 +== 3.6 ThingsBoard.Cloud (via MQTT) == 276 276 277 - ViewyourPersonalAccessToken276 +=== 3.6.1 Configure ThingsBoard === 278 278 279 - You can view your own token via the User-Settings-Menu.You canreachthis menuby clicking on "Edit Profile" at the end of the list using the WorkspaceSelector:278 +==== 3.6.1.1 Create Device ==== 280 280 281 -[[image:image-20230802112413-20.png]] 282 282 283 - MQTTClient-ID281 +Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. 284 284 285 - The Datacake Brokermanages 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 randomlygenerated ID.283 +[[image:image-20230802112413-32.png]] 286 286 287 -AT+CLIENT=“Any value” 288 288 289 - AT+UNAME=Token286 +==== 3.6.1.2 Create Uplink & Downlink Converter ==== 290 290 291 -AT+PWD=Token 292 292 293 - [[image:image-20230802112413-21.png]]289 +(% style="color:blue" %)**Uplink Converter** 294 294 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. 295 295 296 - == 1.6Create yourfirstSubscription ==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. 297 297 298 - Subscribe295 +[[image:image-20230802112413-33.png||height="732" width="1302"]] 299 299 300 -Data is published according to the following structure: 301 301 302 - dtck~/~//298 +(% style="color:blue" %)**Downlink Converter** 303 303 304 - Subscribetotopics usingthis structure toreceive messages via MQTT wheneadings(via APIor MQTT) arrive inthe DatacakeCloud.Messagesare publishedwheneverthereis a changea correspondingdatabasefield.300 +The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke 305 305 302 +[[image:image-20230802112413-34.png||height="734" width="1305"]] 306 306 307 - [[image:image-20230802112413-22.png]]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.** 308 308 309 309 310 - [[image:image-20230802112413-23.png]]307 +==== 3.6.1.3 MQTT Integration Setup ==== 311 311 312 312 313 - [[image:image-20230802112413-24.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**; 314 314 312 +[[image:image-20230802112413-35.png||height="738" width="1312"]] 315 315 316 -example: 317 317 318 - AT+PUBTOPIC=dtck-pub/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature315 +* The next steps is to add the recently created uplink and downlink converters; 319 319 320 -[[image:image-20230802112413- 25.png]]317 +[[image:image-20230802112413-36.png||height="736" width="1308"]] 321 321 322 - == 1.7 DefinePublishTopic==319 +[[image:image-20230802112413-37.png||height="735" width="1307"]] 323 323 324 -Publish 325 325 326 - To upload data into theDatacake Cloud andintoa specificdevice, you publishthedata to therespective topic structure.322 +(% style="color:blue" %)**Add a topic filter:** 327 327 328 - Dueheof MQTT, thetopic prefixdiffersasfollows:324 +tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature **固定的? 对的。** 329 329 330 - dtck-pub~/~//326 +You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default; 331 331 332 - example:328 +[[image:image-20230802112413-38.png||height="731" width="1300"]] 333 333 334 -AT+SUBTOPIC=dtck/nbmattest/936c0db6-e9a5-4353-9fdb-3f63c8bfce7e/Temperature 335 335 336 -== 1.8uploaddata==331 +=== 3.6.2 Simulate with MQTT.fx === 337 337 338 -[[image:image-20230802112413-26.png]] 339 339 340 -[[image:image-20230802112413- 27.png]]334 +[[image:image-20230802112413-39.png]] 341 341 342 -[[image:image-20230802112413- 28.png]]336 +[[image:image-20230802112413-40.png]] 343 343 344 -= = 345 345 346 -= 5.Node-Red(via MQTT)=339 +=== 3.6.3 Configure NB-IoT Sensor === 347 347 348 348 349 - ==1.1 ConfigureNode-Red ==342 +(% style="color:blue" %)**AT Commands** 350 350 351 - [[image:image-20230802112413-29.png]]344 +* (% style="color:#037691" %)**AT+PRO=3,3 **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. 352 352 353 - [[image:image-20230802112413-30.png]]346 +* (% style="color:#037691" %)**AT+SUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的** 354 354 355 - ==1.2 SimulateConnection==348 +* (% style="color:#037691" %)**AT+PUBTOPIC=device name** (%%) **~-~-> 只需要 Device Name 吗?对的** 356 356 357 - [[image:image-20230802112413-31.png]]350 +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 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性)** 358 358 359 - ==1.3 ConfigureNB-IoTSensors ==352 +(% style="color:blue" %)**CLIENT :“Any value”** 360 360 361 -* AT+PRO=3,0(hex format) or 3,5(json format) ~/~/Set to mqtt Server and Payload 362 -* AT+CLIENT=any value 363 -* AT+UNAME=any value 364 -* AT+PWD=any value 365 -* AT+PUBTOPIC=any value 366 -* AT+SUBTOPIC=any value 354 +(% style="color:blue" %)**User Name:“Any value”** 367 367 368 - =6. ThingsBoard.Cloud(viaMQTT) =356 +(% style="color:blue" %)**Password:“Any value”** 369 369 370 -== 1.1 Configure ThingsBoard == 371 371 372 - === 1.1.1 CreateDevice===359 +Test Uplink by click the button for 1 second 373 373 374 - Create a New Device in[[ThingsBoard>>url:https://thingsboard.cloud/]].361 +[[image:image-20230802112413-41.png]] 375 375 376 -[[image:image-20230802112413- 32.png]]363 +[[image:image-20230802112413-42.png]] 377 377 378 - === 1.1.2 CreateUplink & Downlink Converter ===365 +[[image:image-20230802112413-43.png]] 379 379 380 -Uplink Converter 381 381 382 - Thepurpose of the decoder function is to parse the incomingdata and metadata toa format that ThingsBoard can consume. deviceName and deviceType are required, while attributesndtelemetry are optional.Attributesand telemetry are flat key-valueobjects.Nestedobjectsarenot supported.368 +== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) == 383 383 384 - Tocreatean uplink converter go to the Integrationscenter->Data converterspage and click “plus” button. Name it “MQTT UplinkConverter” andselecttype Uplink. Use debug mode for now.370 +=== 3.7.1 Create device & Get Credentials === 385 385 386 -[[image:image-20230802112413-33.png]] 387 387 373 +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. 388 388 389 - Downlink Converter375 +[[image:image-20230802112413-44.png]] 390 390 391 - The Downlink converter transformingoutgoing RPCmessageand then the Integration sends it to external MQTT broke377 +[[image:image-20230802112413-45.png]] 392 392 393 -[[image:image-20230802112413-34.png]] 394 394 395 - Note:Ourdevicepayload isalreadyhuman readabledata. Therefore,users donotneedtowrite decoders. Simplycreatebydefault.380 +Go to the Device section and create a device. Then, go to the section tokens and copy your device-token. 396 396 397 - ===1.1.3MQTT Integration Setup ===382 +[[image:image-20230802112413-46.png]] 398 398 399 -Go to the Integrations center -> Integrations page and click “plus” icon to add a new integration. Name it “MQTT Integration”, select type MQTT; 400 400 401 - [[image:image-20230802112413-35.png]]385 +On the Connection Profile window, set the following information: **(这边加一个截图)** 402 402 403 -* The nextsteps is toadd therecently createduplinkand downlink converters;387 +* (% style="color:blue" %)**Profile Name: “Any name”** 404 404 405 - [[image:image-20230802112413-36.png]]389 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io** 406 406 407 - [[image:image-20230802112413-37.png]]391 +* (% style="color:blue" %)**Broker Port: 1883** 408 408 409 - Add atopicfilter:393 +* (% style="color:blue" %)**Client ID: “Any value”** 410 410 395 +On the section User credentials, set the following information: **(这边加一个截图)** 411 411 412 -t b/mqtt-integration-tutorial/sensors~/~/temperature ~-~->Temperature固定的?对的。397 +* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only 413 413 414 - You can also select an MQTT QoSlevel. WeuseMQTT QoSlevel0 (Atmost once) by default;399 +* (% style="color:blue" %)**Password: “Your device token”** 415 415 416 - [[image:image-20230802112413-38.png]]401 +* (% style="color:blue" %)**PUBTOPIC: “Any value”** 417 417 418 - ==1.2 SimulatewithMQTT.fx ==403 +* (% style="color:blue" %)**SUBTOPIC: “Any value”** 419 419 420 - [[image:image-20230802112413-39.png]]405 +=== 3.7.2 Simulate with MQTT.fx === 421 421 422 -[[image:image-20230802112413-40.png]] 423 423 424 - == 1.3 ConfigureNB-IoT Sensor ==408 +[[image:image-20230802112413-47.png]] 425 425 426 - AT Commands410 +[[image:image-20230802112413-48.png]] 427 427 428 -AT+PRO=3, 3~/~/UseMQTT to connect toThingsBoard.412 +Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**. 429 429 430 -AT+SUBTOPIC=device name ~-~-> 只需要 Device Name 吗?对的 431 431 432 - AT+PUBTOPIC=device name~-~-> 只需要 Device Name吗?对的415 +[[image:image-20230802112413-49.png]] 433 433 434 434 435 - Users do not need to fill in the client, username, and password.Butthe configurationinformation of thedevice requires setting the client, username, and password, which can be entered freely. (软件自动填充为 Device Name 吧).这边不用提示了,客户不需要输入。(大部分客户还是会自己去设置这个的,提高安全性)418 +=== 3.7.3 tago data === 436 436 437 -CLIENT :“Any value” 438 438 439 - User Name:“Any value”421 +[[image:image-20230802112413-50.png]] 440 440 441 - Password:“Any value”423 +[[image:image-20230802112413-51.png]] 442 442 443 443 444 -T estUplink by click the button for 1 second426 +=== 3.7.4 TLS mode === 445 445 446 -[[image:image-20230802112413-41.png]] 447 447 448 - [[image:image-20230802112413-42.png]]429 +Users can choose to use (% style="color:blue" %)**SSL/TLS**(%%) mode. 449 449 450 - [[image:image-20230802112413-43.png]]431 +On the SSL/TLS section, check the option **Enable SSL/TLS**, and click OK. 451 451 433 +The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command. 452 452 453 - =7. [[Tago.io>>url:https://admin.tago.io/]](viaMQTT) =435 +* (% style="color:blue" %)**Profile Name: “Any name”** 454 454 455 - ==5.1 Createdevice& GetCredentials ==437 +* (% style="color:blue" %)**Broker Address: mqtt.tago.io** 456 456 457 - We useMQTT Connection tosend data to [[Tago.io>>url:https://admin.tago.io/]]. Weneed to Create Device and Get MQTT Credentialsfirst.439 +* (% style="color:blue" %)**Broker Port: 8883** 458 458 459 - [[image:image-20230802112413-44.png]]441 +* (% style="color:blue" %)**Client ID: “Any value”** 460 460 461 - [[image:image-20230802112413-45.png]]443 +* (% style="color:blue" %)**User Name: “Any value”** (%%) ~/~/ Tago validates your user by the token only 462 462 463 - =445 +* (% style="color:blue" %)**Password: “Your device token”** 464 464 465 - Goto theDevice section and create a device.Then,go to the sectiontokens and copyyour device-token.447 +* (% style="color:blue" %)**PUBTOPIC: “Any value”** 466 466 467 - [[image:image-20230802112413-46.png]]449 +* (% style="color:blue" %)**SUBTOPIC: “Any value”** 468 468 469 - 470 -On the Connection Profile window, set the following information: (这边加一个截图) 471 - 472 -* Profile Name: “Any name” 473 -* Broker Address: mqtt.tago.io 474 -* Broker Port: 1883 475 -* Client ID: “Any value” 476 - 477 -On the section User credentials, set the following information:(这边加一个截图) 478 - 479 -* User Name: “Any value” Tago validates your user by the token only 480 -* Password: “Your device token” 481 -* PUBTOPIC: “Any value” 482 -* SUBTOPIC: “Any value” 483 - 484 -== 5.2 Simulate with MQTT.fx == 485 - 486 -[[image:image-20230802112413-47.png]] 487 - 488 -[[image:image-20230802112413-48.png]] 489 - 490 -Users can run the AT+PRO=3,5 command, and the payload will be converted to JSON format. 491 - 492 -[[image:image-20230802112413-49.png]] 493 - 494 -== 1.4. tago data == 495 - 496 - 497 -[[image:image-20230802112413-50.png]] 498 - 499 -[[image:image-20230802112413-51.png]] 500 - 501 -== 1.4. TLS mode == 502 - 503 -Users can choose to use SSL/TLS mode. 504 - 505 -On the SSL/TLS section, check the option Enable SSL/TLS, and click OK. 506 - 507 -The device needs to enable the TLS mode and set the AT+TLSMOD=1,0 command. 508 - 509 -* Profile Name: “Any name” 510 -* Broker Address: mqtt.tago.io 511 -* Broker Port: 8883 512 -* Client ID: “Any value” 513 -* User Name: “Any value” Tago validates your user by the token only 514 -* Password: “Your device token” 515 -* PUBTOPIC: “Any value” 516 -* SUBTOPIC: “Any value” 517 - 518 518 [[image:image-20230802112413-52.png]] 519 519 520 520