Version 5.1 by Edwin Chen on 2024/06/02 22:06

Hide last authors
Edwin Chen 2.1 1
Edwin Chen 1.1 2
3
Edwin Chen 2.1 4 (% class="wikigeneratedid" id="HTableofContents:" %)
5 **Table of Contents:**
Edwin Chen 1.1 6
Edwin Chen 2.1 7 {{toc/}}
Edwin Chen 1.1 8
Edwin Chen 2.1 9 = 1. The use of this guideline =
Edwin Chen 1.1 10
Edwin Chen 3.1 11 This configure instruction is for Dragino NB-IoT models with -CB or -CS suffix, for example DDS75-CB. These models use the same NB-IoT Module **[[BG95-M2>>https://www.dropbox.com/sh/3ilyaswz4odgaru/AADR86cAgL9UGlmLuEH-UZgla?st=x1ry6v5j&dl=0]]** 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.
Edwin Chen 1.1 12
Edwin Chen 3.1 13
Edwin Chen 2.1 14 = 2. Attach Network =
Edwin Chen 1.1 15
Edwin Chen 2.1 16 == 2.1 General Configure to attach network ==
Edwin Chen 1.1 17
Edwin Chen 3.1 18 To attache end nodes to NB-IoT or LTE-M Network, You need to:
Edwin Chen 1.1 19
Edwin Chen 3.1 20 1. Get a NB-IoT or LTE-M SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone)
Edwin Chen 2.1 21 1. Power Off End Node ( See below for the power off/on position)
22 1. Insert the SIM card to Sensor. ( See below for direction)
23 1. Power On End Node
24 1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (AT+APN=<APN>), example AT+APN=iot.1nce.net
Edwin Chen 1.1 25
Edwin Chen 2.1 26 [[image:image-20240208102804-1.png||height="286" width="696"]]
Edwin Chen 1.1 27
Edwin Chen 2.1 28 [[image:image-20230808205045-1.png||height="293" width="438"]]
Edwin Chen 1.1 29
Edwin Chen 3.1 30 After doing above, the end nodes should be able to attach to NB-IoT network .
Edwin Chen 1.1 31
Edwin Chen 3.1 32 The -CB and -CS models support (% style="color:blue" %)**LTE Cat NB2 and LTE-M (CAT-M1)**(%%), with below frequency band: multiple frequency bands of
Edwin Chen 1.1 33
Edwin Chen 5.1 34 ~-~-(% style="color:blue" %)** CAT-NB2: B1/B2/B3/B4/B5/B8/B12/B13/B18/B19/B20/B25/B28/B66/B71/B85 **(%%).
Edwin Chen 3.1 35
Edwin Chen 5.1 36 ~-~-(% style="color:blue" %)** CAT-M1: B1/B2/B3/B4/B5/B8/B12/B13/B18/B19/B20/B25/B26/B27/B28/B66/B85 **(%%).
Edwin Chen 3.1 37
Edwin Chen 4.1 38 Make sure you use a the NB-IoT or LTE-M SIM card.
Edwin Chen 3.1 39
Edwin Chen 4.1 40 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1134px" %)
41 |(% style="background-color:#4f81bd; color:white; width:117px" %)**SIM Provider**|(% style="background-color:#4f81bd; color:white; width:151px" %)**AT+APN=**|(% style="background-color:#4f81bd; color:white; width:406px" %)**NB-IoT Coverage**|(% style="background-color:#4f81bd; color:white; width:351px" %)**LTE-M Coverage**|(% style="background-color:#4f81bd; color:white; width:120px" %)**Comments**
42 |(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:406px" %)(((
Edwin Chen 2.1 43 **[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]**
Edwin Chen 1.1 44
Edwin Chen 4.1 45 Austria, Belgium, Bulgaria, China, Croatia, Czech Republic, Denmark, Estonia, Finland, Germany, Great Britain, Greece, Hungary, Ireland,Italy, Latvia, Malta, Netherlands, Norway, Portugal, Puerto Rico, Russia, Slovak,Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
46 )))|(% style="width:351px" %)(((
47 Argentina, Austria, Australia, Belgium, Canada, Denmark,Estonia, Finland, France, Germany, Great Britain, Hungary, Ireland, Japan,Jersey, Korea, Repiblic of, Latvia, Luxembourg, Mexico, Netherlands, New Zealand, Norway, Poland, Puerto Rico, Romania, Spain, Sweden, Switzerland,Taiwan, USA, US Virgin Islands.
48 )))|(% style="width:120px" %)UK: Band20
49 |(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:406px" %)China Mainland, HongKong|(% style="width:351px" %) |(% style="width:120px" %)
50 |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:406px" %)China Mainland|(% style="width:351px" %) |(% style="width:120px" %)
Edwin Chen 1.1 51
Edwin Chen 4.1 52
Edwin Chen 2.1 53 == 2.2 Speed Up Network Attach time ==
Edwin Chen 1.1 54
Edwin Chen 4.1 55 **BG95-M2** supports multi bands (% style="color:blue" %)**in NB-IoT and LTE-M. **(%%) It will search one by one and try to attach, this will take a lot of time and even cause attach fail and show **Signal Strenght:99**.
Edwin Chen 1.1 56
57
Edwin Chen 4.1 58 Attache to 1NCE card for Australia use:
Edwin Chen 1.1 59
Edwin Chen 4.1 60 * AT+COPS=1,2,"50501",8
61 * AT+QCFG="band",0,0x8000000,0x8000000,1
Edwin Chen 1.1 62
Edwin Chen 4.1 63
64 After connection is successful, user can use (% style="color:#037691" %)**AT+QENG="servingcell"**(%%) to check which band is actually in used.
65
66 AT+QENG="servingcell"
67 +QENG: "servingcell","NOCONN","eMTC","FD
68 D",505,01,90D2C0B,258,9410,28,5,5,901A,-112,-17,-80,10,27
69
70
Edwin Chen 2.1 71 See bands used for different provider:** [[NB-IoT Deployment , Bands, Operator list>>http://wiki.dragino.com/xwiki/bin/view/Main/NB-IoT%20Deployment%20%2C%20Bands%2C%20Operator%20list/]]**
Edwin Chen 1.1 72
Edwin Chen 5.1 73
74
Edwin Chen 2.1 75 = 3. Configure to connect to different servers =
Edwin Chen 1.1 76
Edwin Chen 2.1 77 == 3.1 General UDP Connection ==
Edwin Chen 1.1 78
Edwin Chen 2.1 79 The NB-IoT Sensor can send packet to server use UDP protocol.
Edwin Chen 1.1 80
Edwin Chen 2.1 81 === 3.1.1 Simulate UDP Connection by PC tool ===
Edwin Chen 1.1 82
Edwin Chen 2.1 83 We can use PC tool to simulate UDP connection to make sure server works ok.
Edwin Chen 1.1 84
Edwin Chen 2.1 85 [[image:image-20230802112413-1.png||height="468" width="1024"]]
Edwin Chen 1.1 86
Edwin Chen 2.1 87 === 3.1.2 Configure NB-IoT Sensor ===
Edwin Chen 1.1 88
Edwin Chen 2.1 89 ==== 3.1.2.1 AT Commands ====
Edwin Chen 1.1 90
Edwin Chen 2.1 91 (% style="color:blue" %)**AT Commands:**
Edwin Chen 1.1 92
Edwin Chen 3.1 93 * (% style="color:#037691" %)**AT+PRO=2,0**  (%%) ~/~/ Set to use UDP protocol to uplink ,Payload Type select Hex payload
Edwin Chen 1.1 94
Edwin Chen 3.1 95 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5601**  (%%) ~/~/ Set UDP server address and port
Edwin Chen 1.1 96
Edwin Chen 2.1 97 [[image:image-20230802112413-2.png]]
Edwin Chen 1.1 98
Edwin Chen 2.1 99 ==== 3.1.2.2 Uplink Example ====
Edwin Chen 1.1 100
Edwin Chen 2.1 101 [[image:image-20230802112413-3.png]]
Edwin Chen 1.1 102
Edwin Chen 2.1 103 == 3.2 General MQTT Connection ==
Edwin Chen 1.1 104
Edwin Chen 2.1 105 The NB-IoT Sensor can send packet to server use MQTT protocol.
Edwin Chen 1.1 106
Edwin Chen 2.1 107 Below are the commands.
Edwin Chen 1.1 108
Edwin Chen 2.1 109 (% style="color:blue" %)**AT Commands:**
Edwin Chen 1.1 110
Edwin Chen 3.1 111 * (% style="color:#037691" %)**AT+PRO=3,0**   (%%) ~/~/ Set to use MQTT protocol to uplink, Payload Type select Hex payload.
Edwin Chen 1.1 112
Edwin Chen 3.1 113 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883**  (%%) ~/~/ Set MQTT server address and port
Edwin Chen 1.1 114
Edwin Chen 3.1 115 * (% style="color:#037691" %)**AT+CLIENT=CLIENT**     (%%) ~/~/ Set up the CLIENT of MQTT
Edwin Chen 1.1 116
Edwin Chen 3.1 117 * (% style="color:#037691" %)**AT+UNAME=UNAME**        (%%) ~/~/ Set the username of MQTT
Edwin Chen 1.1 118
Edwin Chen 3.1 119 * (% style="color:#037691" %)**AT+PWD=PWD**             (%%) ~/~/ Set the password of MQTT
Edwin Chen 1.1 120
Edwin Chen 3.1 121 * (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB**  (%%) ~/~/ Set the sending topic of MQTT
Edwin Chen 1.1 122
Edwin Chen 3.1 123 * (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB**  (%%) ~/~/ Set the subscription topic of MQTT
Edwin Chen 1.1 124
Edwin Chen 2.1 125 [[image:image-20230802112413-4.png]]
Edwin Chen 1.1 126
Edwin Chen 2.1 127 [[image:image-20230802112413-5.png||height="530" width="987"]]
Edwin Chen 1.1 128
Edwin Chen 2.1 129 (% style="color:red" %)**Notice: MQTT protocol has a much higher power consumption compare with UDP/CoAP protocol. Please check the power analyze document and adjust the uplink period to a suitable interval.**
Edwin Chen 1.1 130
Edwin Chen 2.1 131 == 3.3 [[ThingSpeak>>url:https://thingspeak.com/]] (via MQTT) ==
Edwin Chen 1.1 132
Edwin Chen 2.1 133 === 3.3.1 Get MQTT Credentials ===
Edwin Chen 1.1 134
Edwin Chen 2.1 135 [[ThingSpeak>>url:https://thingspeak.com/]] connection uses MQTT Connection. So we need to get MQTT Credentials first. You need to point MQTT Devices to ThingSpeak Channel as well.
Edwin Chen 1.1 136
Edwin Chen 2.1 137 [[image:image-20230802112413-6.png||height="336" width="925"]]
Edwin Chen 1.1 138
Edwin Chen 2.1 139 [[image:image-20230802112413-7.png]]
Edwin Chen 1.1 140
Edwin Chen 2.1 141 === 3.3.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 142
Edwin Chen 2.1 143 ==== 3.3.2.1 Establish MQTT Connection ====
Edwin Chen 1.1 144
Edwin Chen 2.1 145 After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine.
Edwin Chen 1.1 146
Edwin Chen 2.1 147 [[image:image-20230802112413-8.png]]
Edwin Chen 1.1 148
Edwin Chen 2.1 149 * (% style="color:#037691" %)**Broker Address:**(%%) mqtt3.thingspeak.com
Edwin Chen 1.1 150
Edwin Chen 2.1 151 * (% style="color:#037691" %)**Broker Port:**(%%) 1883
Edwin Chen 1.1 152
Edwin Chen 2.1 153 * (% style="color:#037691" %)**Client ID:**(%%) <Your ThingSpeak MQTT ClientID>
Edwin Chen 1.1 154
Edwin Chen 2.1 155 * (% style="color:#037691" %)**User Name:**(%%) <Your ThingSpeak MQTT User Name>
Edwin Chen 1.1 156
Edwin Chen 2.1 157 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
Edwin Chen 1.1 158
Edwin Chen 2.1 159 ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
Edwin Chen 1.1 160
Edwin Chen 2.1 161 [[image:image-20230802112413-9.png]]
Edwin Chen 1.1 162
Edwin Chen 2.1 163 [[image:image-20230802112413-10.png]]
Edwin Chen 1.1 164
Edwin Chen 2.1 165 (% style="color:blue" %)**In MQTT.fx, we can publish below info:**
Edwin Chen 1.1 166
Edwin Chen 2.1 167 * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish
Edwin Chen 1.1 168
Edwin Chen 2.1 169 * (% style="color:#037691" %)**Payload:**(%%) field1=63&field2=67&status=MQTTPUBLISH
Edwin Chen 1.1 170
Edwin Chen 2.1 171 Where 63 and 67 are the value to be published to field1 & field2.
Edwin Chen 1.1 172
Edwin Chen 2.1 173 (% style="color:blue" %)**Result: **
Edwin Chen 1.1 174
Edwin Chen 2.1 175 [[image:image-20230802112413-11.png||height="539" width="901"]]
Edwin Chen 1.1 176
Edwin Chen 2.1 177 === 3.3.3 Configure NB-IoT Sensor for connection ===
Edwin Chen 1.1 178
Edwin Chen 2.1 179 ==== 3.3.3.1 AT Commands: ====
Edwin Chen 1.1 180
Edwin Chen 2.1 181 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
Edwin Chen 1.1 182
Edwin Chen 2.1 183 * (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
Edwin Chen 1.1 184
Edwin Chen 2.1 185 * (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
Edwin Chen 1.1 186
Edwin Chen 2.1 187 * (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**
Edwin Chen 1.1 188
Edwin Chen 2.1 189 * (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**
Edwin Chen 1.1 190
Edwin Chen 2.1 191 * (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
Edwin Chen 1.1 192
Edwin Chen 2.1 193 * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
Edwin Chen 1.1 194
Edwin Chen 2.1 195 ==== 3.3.3.2 Uplink Examples ====
Edwin Chen 1.1 196
Edwin Chen 2.1 197 [[image:image-20230816201942-1.png]]
Edwin Chen 1.1 198
Edwin Chen 2.1 199 For SE01-NB
Edwin Chen 1.1 200
Edwin Chen 2.1 201 For DDS20-NB
Edwin Chen 1.1 202
Edwin Chen 2.1 203 For DDS45-NB
Edwin Chen 1.1 204
Edwin Chen 2.1 205 For DDS75-NB
Edwin Chen 1.1 206
Edwin Chen 2.1 207 For NMDS120-NB
Edwin Chen 1.1 208
Edwin Chen 2.1 209 For SPH01-NB
Edwin Chen 1.1 210
Edwin Chen 2.1 211 For NLM01-NB
Edwin Chen 1.1 212
Edwin Chen 2.1 213 For NMDS200-NB
Edwin Chen 1.1 214
Edwin Chen 2.1 215 For CPN01-NB
Edwin Chen 1.1 216
Edwin Chen 2.1 217 For DS03A-NB
Edwin Chen 1.1 218
Edwin Chen 2.1 219 For SN50V3-NB
Edwin Chen 1.1 220
Edwin Chen 2.1 221 ==== 3.3.3.3 Map fields to sensor value ====
Edwin Chen 1.1 222
Edwin Chen 2.1 223 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.
Edwin Chen 1.1 224
Edwin Chen 2.1 225 [[image:image-20230802112413-12.png||height="504" width="1011"]]
Edwin Chen 1.1 226
Edwin Chen 2.1 227 [[image:image-20230802112413-13.png||height="331" width="978"]]
Edwin Chen 1.1 228
Edwin Chen 2.1 229 Below is the NB-IoT Product Table show the mapping.
Edwin Chen 1.1 230
Edwin Chen 2.1 231 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1424px" %)
232 |(% style="background-color:#4f81bd; width:143px" %) |(% style="background-color:#4f81bd; color:white; width:103px" %)Field1|(% style="background-color:#4f81bd; color:white; width:102px" %)Field2|(% style="background-color:#4f81bd; color:white; width:157px" %)Field3|(% style="background-color:#4f81bd; color:white; width:154px" %)Field4|(% style="background-color:#4f81bd; color:white; width:153px" %)Field5|(% style="background-color:#4f81bd; color:white; width:151px" %)Field6|(% style="background-color:#4f81bd; color:white; width:160px" %)Field7|(% style="background-color:#4f81bd; color:white; width:152px" %)Field8|(% style="background-color:#4f81bd; color:white; width:67px" %)Field9|(% style="background-color:#4f81bd; color:white; width:69px" %)Field10
Edwin Chen 3.1 233 |(% style="background-color:#4f81bd; color:white; width:143px" %)S31x-NB|(% style="width:103px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
234 |(% style="background-color:#4f81bd; color:white; width:143px" %)SE01-NB|(% style="width:103px" %)Temperature |(% style="width:102px" %)Humidity|(% style="width:157px" %)conduct|(% style="width:154px" %)dielectric_constant|(% style="width:153px" %)Battery|(% style="width:151px" %)RSSI|(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
235 |(% style="background-color:#4f81bd; color:white; width:143px" %)DDS20-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
236 |(% style="background-color:#4f81bd; color:white; width:143px" %)DDS45-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
237 |(% style="background-color:#4f81bd; color:white; width:143px" %)DDS75-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
238 |(% style="background-color:#4f81bd; color:white; width:143px" %)NMDS120-NB|(% style="width:103px" %)distance|(% style="width:102px" %)Battery|(% style="width:157px" %)RSSI|(% style="width:154px" %) |(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
239 |(% rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SPH01-NB|(% style="width:103px" %)ph|(% style="width:102px" %)Temperature|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% colspan="1" rowspan="1" style="width:69px" %)
240 |(% style="background-color:#4f81bd; color:white; width:143px" %)NLM01-NB|(% style="width:103px" %)Humidity|(% style="width:102px" %)Temperature|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
241 |(% style="background-color:#4f81bd; color:white; width:143px" %)NMDS200-NB|(% style="width:103px" %)distance1|(% style="width:102px" %)distance2|(% style="width:157px" %)Battery|(% style="width:154px" %)RSSI|(% style="width:153px" %) |(% style="width:151px" %) |(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
242 |(% style="background-color:#4f81bd; color:white; width:143px" %)CPN01-NB|(% style="width:103px" %)alarm|(% style="width:102px" %)count|(% style="width:157px" %)door open duration|(% style="width:154px" %)calc flag|(% style="width:153px" %)Battery|(% style="width:151px" %)RSSI|(% style="width:160px" %) |(% style="width:152px" %) |(% style="width:67px" %) |(% style="width:69px" %)
Edwin Chen 2.1 243 |(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)DS03A-NB|(% colspan="1" rowspan="1" style="width:103px" %)level|(% colspan="1" rowspan="1" style="width:102px" %)alarm|(% colspan="1" rowspan="1" style="width:157px" %)pb14door open num|(% colspan="1" rowspan="1" style="width:154px" %)pb14 last open time|(% colspan="1" rowspan="1" style="width:153px" %)pb15 level status|(% colspan="1" rowspan="1" style="width:151px" %)pb15 alarm status|(% colspan="1" rowspan="1" style="width:160px" %)pb15 door open num|(% colspan="1" rowspan="1" style="width:152px" %)pb15 last open time|(% colspan="1" rowspan="1" style="width:67px" %)Battery|(% colspan="1" rowspan="1" style="width:69px" %)RSSI
Edwin Chen 3.1 244 |(% colspan="1" rowspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod1|(% colspan="1" rowspan="1" style="width:103px" %)mod|(% colspan="1" rowspan="1" style="width:102px" %)Battery|(% colspan="1" rowspan="1" style="width:157px" %)RSSI|(% colspan="1" rowspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" rowspan="1" style="width:153px" %)exit_state/input PA4|(% colspan="1" rowspan="1" style="width:151px" %)adc0|(% colspan="1" rowspan="1" style="width:160px" %)Temperature |(% colspan="1" rowspan="1" style="width:152px" %)Humidity|(% colspan="1" rowspan="1" style="width:67px" %) |(% colspan="1" rowspan="1" style="width:69px" %)
245 |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod2|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" style="width:153px" %)exit_state/input PA4|(% colspan="1" style="width:151px" %)adc0|(% colspan="1" style="width:160px" %)distance|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
246 |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod3|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)adc0|(% colspan="1" style="width:153px" %)exit_state/input PA4|(% colspan="1" style="width:151px" %)adc1|(% colspan="1" style="width:160px" %)Temperature|(% colspan="1" style="width:152px" %)Humidity|(% colspan="1" style="width:67px" %)adc4|(% colspan="1" style="width:69px" %)
247 |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod4|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:151px" %)exit_state/input PA4|(% colspan="1" style="width:160px" %)DS18B20 Temp2|(% colspan="1" style="width:152px" %)DS18B20 Temp3|(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
248 |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod5|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)DS18B20 Temp|(% colspan="1" style="width:153px" %)adc0|(% colspan="1" style="width:151px" %)exit_state/input PA4|(% colspan="1" style="width:160px" %)Weight|(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
249 |(% colspan="1" style="background-color:#4f81bd; color:white; width:143px" %)SN50V3-NB mod6|(% colspan="1" style="width:103px" %)mod|(% colspan="1" style="width:102px" %)Battery|(% colspan="1" style="width:157px" %)RSSI|(% colspan="1" style="width:154px" %)count|(% colspan="1" style="width:153px" %) |(% colspan="1" style="width:151px" %) |(% colspan="1" style="width:160px" %) |(% colspan="1" style="width:152px" %) |(% colspan="1" style="width:67px" %) |(% colspan="1" style="width:69px" %)
Edwin Chen 1.1 250
Edwin Chen 2.1 251 == 3.4 [[Datacake>>https://datacake.co/]] ==
Edwin Chen 1.1 252
Edwin Chen 2.1 253 (% class="wikigeneratedid" %)
254 Dragino NB-IoT sensors has its template in **[[Datacake>>https://datacake.co/]]** Platform. There are two version for NB Sensor,
Edwin Chen 1.1 255
Edwin Chen 2.1 256 (% class="wikigeneratedid" %)
257 As example for S31B-NB. there are two versions: **S31B-NB-1D and S31B-NB-GE.**
Edwin Chen 1.1 258
Edwin Chen 2.1 259 * (% style="color:blue" %)**S31B-NB-1D**(%%): This version have pre-configure DataCake connection. User just need to Power on this device, it will auto connect send data to DataCake Server.
Edwin Chen 1.1 260
Edwin Chen 2.1 261 * (% style="color:blue" %)**S31B-NB-GE**(%%): This verson doesn't have pre-configure Datacake connection. User need to enter the AT Commands to connect to Datacake. See below for instruction.
Edwin Chen 1.1 262
Edwin Chen 2.1 263 === 3.4.1 For device Already has template ===
Edwin Chen 1.1 264
Edwin Chen 2.1 265 ==== 3.4.1.1 Create Device ====
Edwin Chen 1.1 266
Edwin Chen 2.1 267 (% style="color:blue" %)**Add Device**(%%) in DataCake.
Edwin Chen 1.1 268
Edwin Chen 2.1 269 [[image:image-20230808162301-1.png||height="453" width="952"]]
Edwin Chen 1.1 270
Edwin Chen 2.1 271 [[image:image-20230808162342-2.png||height="541" width="952"]]
Edwin Chen 1.1 272
Edwin Chen 2.1 273 (% style="color:blue" %)**Choose the correct model**(%%) from template.
Edwin Chen 1.1 274
Edwin Chen 2.1 275 [[image:image-20230808162421-3.png]]
Edwin Chen 1.1 276
Edwin Chen 3.1 277 (% style="color:blue" %)**Fill Device ID**(%%). The device ID needs to be filled in with IMEI, and a prefix of(% style="color:blue" %)** 'f' **(%%)needs to be added.
Edwin Chen 1.1 278
Edwin Chen 2.1 279 [[image:image-20230808163612-7.png||height="549" width="952"]]
Edwin Chen 1.1 280
Edwin Chen 2.1 281 [[image:image-20230808163035-5.png]]
Edwin Chen 1.1 282
Edwin Chen 2.1 283 [[image:image-20230808163049-6.png||height="544" width="926"]]
Edwin Chen 1.1 284
Edwin Chen 2.1 285 === 3.4.2 For Device already registered in DataCake before shipped ===
Edwin Chen 1.1 286
Edwin Chen 2.1 287 ==== 3.4.2.1 Scan QR Code to get the device info ====
Edwin Chen 1.1 288
289 Users can use their phones or computers to scan QR codes to obtain device data information.
290
Edwin Chen 2.1 291 [[image:image-20230808170051-8.png||height="255" width="259"]]
Edwin Chen 1.1 292
Edwin Chen 2.1 293 [[image:image-20230808170548-9.png]]
Edwin Chen 1.1 294
Edwin Chen 2.1 295 ==== 3.4.2.2 Claim Device to User Account ====
Edwin Chen 1.1 296
297 By Default, the device is registered in Dragino's DataCake Account. User can Claim it to his account.
298
Edwin Chen 2.1 299 === 3.4.3 Manual Add Decoder in DataCake ( don't use the template in DataCake) ===
Edwin Chen 1.1 300
Edwin Chen 2.1 301 **Step1: Add a device**
Edwin Chen 1.1 302
Edwin Chen 2.1 303 [[image:image-20240129170024-1.png||height="330" width="900"]]
Edwin Chen 1.1 304
Edwin Chen 2.1 305 **Step2: Choose your device type,please select dragino NB-IOT device**
Edwin Chen 1.1 306
Edwin Chen 2.1 307 [[image:image-20240129170216-2.png||height="534" width="643"]]
Edwin Chen 1.1 308
Edwin Chen 2.1 309 **Step3: Choose to create a new device**
Edwin Chen 1.1 310
Edwin Chen 2.1 311 [[image:image-20240129170539-3.png||height="459" width="646"]]
Edwin Chen 1.1 312
Edwin Chen 2.1 313 **Step4: Fill in the device ID of your NB device**
Edwin Chen 1.1 314
Edwin Chen 2.1 315 [[image:image-20240202111546-1.png||height="378" width="651"]]
Edwin Chen 1.1 316
Edwin Chen 2.1 317 **Step5: Please select your device plan according to your needs and complete the creation of the device**
Edwin Chen 1.1 318
Edwin Chen 2.1 319 [[image:image-20240129171236-6.png||height="450" width="648"]]
Edwin Chen 1.1 320
Edwin Chen 2.1 321 **Step6: Please add the decoder at the payload decoder of the device configuration.**
Edwin Chen 1.1 322
Edwin Chen 2.1 323 **Decoder location:**[[dragino-end-node-decoder/Datacake-Dragino_NB at main · dragino/dragino-end-node-decoder (github.com)>>url:https://github.com/dragino/dragino-end-node-decoder/tree/main/Datacake-Dragino_NB]]
Edwin Chen 1.1 324
Edwin Chen 2.1 325 [[image:image-20240129172056-7.png||height="457" width="816"]]
Edwin Chen 1.1 326
Edwin Chen 2.1 327 [[image:image-20240129173116-9.png||height="499" width="814"]]
Edwin Chen 1.1 328
Edwin Chen 2.1 329 **Step7: Add the output of the decoder as a field**
Edwin Chen 1.1 330
Edwin Chen 2.1 331 [[image:image-20240129173541-10.png||height="592" width="968"]]
Edwin Chen 1.1 332
Edwin Chen 2.1 333 **Step8: Customize the dashboard and use fields as parameters of the dashboard**
Edwin Chen 1.1 334
Edwin Chen 2.1 335 [[image:image-20240129174518-11.png||height="147" width="1042"]]
Edwin Chen 1.1 336
Edwin Chen 2.1 337 [[image:image-20240129174657-12.png||height="538" width="916"]]
Edwin Chen 1.1 338
Edwin Chen 2.1 339 [[image:image-20240129174840-13.png||height="536" width="750"]]
Edwin Chen 1.1 340
Edwin Chen 2.1 341 === 3.4.4 For device have not configured to connect to DataCake ===
Edwin Chen 1.1 342
Edwin Chen 2.1 343 (% class="lead" %)
Edwin Chen 1.1 344 Use AT command for connecting to DataCake
345
Edwin Chen 2.1 346 (% style="color:blue" %)**AT+PRO=2,0**
Edwin Chen 1.1 347
Edwin Chen 2.1 348 (% style="color:blue" %)**AT+SERVADDR=67.207.76.90,4445**
Edwin Chen 1.1 349
Edwin Chen 2.1 350 == 3.5 Node-Red (via MQTT) ==
Edwin Chen 1.1 351
Edwin Chen 2.1 352 === 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] ===
Edwin Chen 1.1 353
354 Take S31-NB UDP protocol as an example.
355
356 Dragino provides input flow examples for the sensors.
357
358 User can download the required JSON file through Dragino Node-RED input flow template.
359
Edwin Chen 2.1 360 Download sample JSON file link: [[https:~~/~~/www.dropbox.com/sh/mduw85jcuwsua22/AAAvwPhg9z6dLjJhmZjqBf_ma?dl=0>>url:https://www.dropbox.com/sh/mduw85jcuwsua22/AAAvwPhg9z6dLjJhmZjqBf_ma?dl=0]]
Edwin Chen 1.1 361
362 We can directly import the template.
363
364 The templates for S31-NB and NB95S31B are the same.
365
Edwin Chen 2.1 366 [[image:image-20230809173127-4.png]]
Edwin Chen 1.1 367
368 Please select the NB95S31B template.
369
Edwin Chen 2.1 370 [[image:image-20230809173310-5.png||height="558" width="926"]]
Edwin Chen 1.1 371
Edwin Chen 2.1 372 [[image:image-20230809173438-6.png]]
Edwin Chen 1.1 373
Edwin Chen 2.1 374 [[image:image-20230809173800-7.png]]
Edwin Chen 1.1 375
376 Successfully imported template.
377
Edwin Chen 2.1 378 [[image:image-20230809173835-8.png||height="515" width="860"]]
Edwin Chen 1.1 379
380 Users can set UDP port.
381
Edwin Chen 2.1 382 [[image:image-20230809174053-9.png]]
Edwin Chen 1.1 383
Edwin Chen 2.1 384 === 3.5.2 Simulate Connection ===
Edwin Chen 1.1 385
386 We have completed the configuration of UDP. We can try sending packets to node red.
387
Edwin Chen 2.1 388 [[image:image-20230810083934-1.png]]
Edwin Chen 1.1 389
Edwin Chen 2.1 390 [[image:image-20230810084048-2.png||height="535" width="1052"]]
Edwin Chen 1.1 391
Edwin Chen 2.1 392 === 3.5.3 Configure NB-IoT Sensors ===
Edwin Chen 1.1 393
Edwin Chen 2.1 394 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
395 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
396 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
397 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
398 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
399 * (% style="color:#037691" %)**AT+PWD=“Your device token”**
Edwin Chen 1.1 400
Edwin Chen 2.1 401 == 3.6 ThingsBoard.Cloud (via MQTT) ==
Edwin Chen 1.1 402
Edwin Chen 2.1 403 === 3.6.1 Configure ThingsBoard ===
Edwin Chen 1.1 404
Edwin Chen 2.1 405 ==== 3.6.1.1 Create Device ====
Edwin Chen 1.1 406
Edwin Chen 2.1 407 Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
Edwin Chen 1.1 408
Edwin Chen 2.1 409 [[image:image-20230802112413-32.png||height="583" width="1066"]]
Edwin Chen 1.1 410
Edwin Chen 2.1 411 ==== 3.6.1.2 Create Uplink & Downlink Converter ====
Edwin Chen 1.1 412
Edwin Chen 2.1 413 (% style="color:blue" %)**Uplink Converter**
Edwin Chen 1.1 414
Edwin Chen 2.1 415 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.
Edwin Chen 1.1 416
Edwin Chen 2.1 417 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.
Edwin Chen 1.1 418
Edwin Chen 2.1 419 [[image:image-20230802112413-33.png||height="597" width="1061"]]
Edwin Chen 1.1 420
Edwin Chen 2.1 421 (% style="color:blue" %)**Downlink Converter**
Edwin Chen 1.1 422
Edwin Chen 2.1 423 The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
Edwin Chen 1.1 424
Edwin Chen 2.1 425 [[image:image-20230802112413-34.png||height="598" width="1063"]]
Edwin Chen 1.1 426
Edwin Chen 2.1 427 (% style="color:red" %)**Note: Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.**
Edwin Chen 1.1 428
Edwin Chen 2.1 429 ==== 3.6.1.3 MQTT Integration Setup ====
Edwin Chen 1.1 430
Edwin Chen 2.1 431 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**;
Edwin Chen 1.1 432
Edwin Chen 2.1 433 [[image:image-20230802112413-35.png||height="597" width="1062"]]
Edwin Chen 1.1 434
Edwin Chen 2.1 435 * The next steps is to add the recently created uplink and downlink converters;
Edwin Chen 1.1 436
Edwin Chen 2.1 437 [[image:image-20230802112413-36.png||height="598" width="1062"]]
Edwin Chen 1.1 438
Edwin Chen 2.1 439 [[image:image-20230802112413-37.png||height="598" width="1064"]]
Edwin Chen 1.1 440
Edwin Chen 2.1 441 (% style="color:blue" %)**Add a topic filter:**
Edwin Chen 1.1 442
443 Consistent with the theme of the node setting.
444
Edwin Chen 2.1 445 You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
Edwin Chen 1.1 446
Edwin Chen 2.1 447 [[image:image-20230802112413-38.png||height="598" width="1064"]]
Edwin Chen 1.1 448
Edwin Chen 2.1 449 === 3.6.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 450
Edwin Chen 2.1 451 [[image:image-20230802112413-39.png]]
Edwin Chen 1.1 452
Edwin Chen 2.1 453 [[image:image-20230802112413-40.png||height="525" width="980"]]
Edwin Chen 1.1 454
Edwin Chen 2.1 455 === 3.6.3 Configure NB-IoT Sensor ===
Edwin Chen 1.1 456
Edwin Chen 2.1 457 (% style="color:blue" %)**AT Commands**
Edwin Chen 1.1 458
Edwin Chen 3.1 459 * (% style="color:#037691" %)**AT+PRO=3,3  **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3.
Edwin Chen 1.1 460
Edwin Chen 2.1 461 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>**
Edwin Chen 1.1 462
Edwin Chen 2.1 463 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>**
Edwin Chen 1.1 464
Edwin Chen 2.1 465 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
Edwin Chen 1.1 466
Edwin Chen 2.1 467 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 468
Edwin Chen 2.1 469 * (% style="color:#037691" %)**AT+PWD=<device name> or User Defined**
Edwin Chen 1.1 470
Edwin Chen 2.1 471 Test Uplink by click the button for 1 second
Edwin Chen 1.1 472
Edwin Chen 2.1 473 [[image:image-20230802112413-41.png||height="496" width="828"]]
Edwin Chen 1.1 474
Edwin Chen 2.1 475 [[image:image-20230802112413-42.png]]
Edwin Chen 1.1 476
Edwin Chen 2.1 477 [[image:image-20230802112413-43.png||height="407" width="825"]]
Edwin Chen 1.1 478
Edwin Chen 2.1 479 == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
Edwin Chen 1.1 480
Edwin Chen 2.1 481 === 3.7.1 Create device & Get Credentials ===
Edwin Chen 1.1 482
Edwin Chen 2.1 483 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.
Edwin Chen 1.1 484
Edwin Chen 2.1 485 [[image:image-20230802112413-44.png]]
Edwin Chen 1.1 486
Edwin Chen 2.1 487 [[image:image-20230802112413-45.png]]
Edwin Chen 1.1 488
Edwin Chen 2.1 489 Go to the Device section and create a device. Then, go to the section tokens and copy your device-token.
Edwin Chen 1.1 490
Edwin Chen 2.1 491 [[image:image-20230802112413-46.png]]
Edwin Chen 1.1 492
Edwin Chen 2.1 493 The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command.
Edwin Chen 1.1 494
Edwin Chen 2.1 495 (% style="color:blue" %)**On the Connection Profile window, set the following information:**
Edwin Chen 1.1 496
Edwin Chen 2.1 497 * (% style="color:#037691" %)**Profile Name: “Any name”**
Edwin Chen 1.1 498
Edwin Chen 2.1 499 * (% style="color:#037691" %)**Broker Address: mqtt.tago.io**
Edwin Chen 1.1 500
Edwin Chen 2.1 501 * (% style="color:#037691" %)**Broker Port: 8883**
Edwin Chen 1.1 502
Edwin Chen 2.1 503 * (% style="color:#037691" %)**Client ID: “Any value”**
Edwin Chen 1.1 504
Edwin Chen 2.1 505 (% style="color:blue" %)**On the section User credentials, set the following information:**
Edwin Chen 1.1 506
Edwin Chen 2.1 507 * (% style="color:#037691" %)**User Name: “Any value”** (%%) **~/~/ Tago validates your user by the token only**
Edwin Chen 1.1 508
Edwin Chen 2.1 509 * (% style="color:#037691" %)**Password: “Your device token”**
Edwin Chen 1.1 510
Edwin Chen 2.1 511 * (% style="color:#037691" %)**PUBTOPIC: “Any value”**
Edwin Chen 1.1 512
Edwin Chen 2.1 513 * (% style="color:#037691" %)**SUBTOPIC: “Any value”**
Edwin Chen 1.1 514
Edwin Chen 2.1 515 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 516
Edwin Chen 2.1 517 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
Edwin Chen 1.1 518
Edwin Chen 2.1 519 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
Edwin Chen 1.1 520
Edwin Chen 2.1 521 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
Edwin Chen 1.1 522
Edwin Chen 2.1 523 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
Edwin Chen 1.1 524
Edwin Chen 2.1 525 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 526
Edwin Chen 2.1 527 * (% style="color:#037691" %)**AT+PWD=“Your device token”**
Edwin Chen 1.1 528
Edwin Chen 2.1 529 === 3.7.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 530
Edwin Chen 2.1 531 [[image:image-20230802112413-52.png]]
Edwin Chen 1.1 532
Edwin Chen 2.1 533 [[image:image-20230808105300-2.png||height="553" width="1026"]]
Edwin Chen 1.1 534
Edwin Chen 2.1 535 Users can run the (% style="color:blue" %)**AT+PRO=3,5**(%%) command, and the payload will be converted to **JSON format**.
Edwin Chen 1.1 536
Edwin Chen 2.1 537 [[image:image-20230808105217-1.png||height="556" width="1031"]]
Edwin Chen 1.1 538
Edwin Chen 2.1 539 [[image:image-20230808105329-3.png]]
Edwin Chen 1.1 540
Edwin Chen 2.1 541 === 3.7.3 tago data ===
Edwin Chen 1.1 542
Edwin Chen 2.1 543 [[image:image-20230802112413-50.png||height="242" width="1037"]]
Edwin Chen 1.1 544
Edwin Chen 2.1 545 [[image:image-20230802112413-51.png||height="184" width="696"]]
Edwin Chen 1.1 546
Edwin Chen 2.1 547 == 3.8 TCP Connection ==
Edwin Chen 1.1 548
Edwin Chen 2.1 549 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 550
Edwin Chen 3.1 551 * (% style="color:#037691" %)**AT+PRO=4,0   ** (%%) ~/~/ Set to use TCP protocol to uplink(HEX format)
Edwin Chen 1.1 552
Edwin Chen 3.1 553 * (% style="color:#037691" %)**AT+PRO=4,1   ** (%%) ~/~/ Set to use TCP protocol to uplink(JSON format)
Edwin Chen 1.1 554
Edwin Chen 2.1 555 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
Edwin Chen 1.1 556
Edwin Chen 2.1 557 (% style="color:blue" %)**Sensor Console Output when Uplink:**
Edwin Chen 1.1 558
Edwin Chen 2.1 559 [[image:image-20230807233631-1.png]]
Edwin Chen 1.1 560
Edwin Chen 2.1 561 (% style="color:blue" %)**See result in TCP Server:**
Edwin Chen 1.1 562
Edwin Chen 2.1 563 [[image:image-20230807233631-2.png]]
Edwin Chen 1.1 564
Edwin Chen 2.1 565 == 3.9 AWS Connection ==
Edwin Chen 1.1 566
Edwin Chen 2.1 567 Users can refer to [[Dragino NB device connection to AWS platform instructions>>http://wiki.dragino.com/xwiki/bin/view/Dragino%20NB%20device%20connection%20to%20AWS%20platform%20instructions/#H1.LogintotheplatformandfindIoTcore]]
Edwin Chen 1.1 568
Edwin Chen 2.1 569 = 4. MQTT/UDP/TCP downlink =
Edwin Chen 1.1 570
Edwin Chen 2.1 571 == 4.1 MQTT (via MQTT.fx) ==
Edwin Chen 1.1 572
Edwin Chen 2.1 573 Configure MQTT connections properly and send downlink commands to configure nodes through the Publish function of MQTT.fx//.//
Edwin Chen 1.1 574
Edwin Chen 2.1 575 **1.** Configure node MQTT connection (via MQTT.fx):
Edwin Chen 1.1 576
Edwin Chen 2.1 577 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 578
Edwin Chen 2.1 579 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%)~/~/ hex format or json format
Edwin Chen 1.1 580
Edwin Chen 2.1 581 * (% style="color:#037691" %)**AT+SUBTOPIC=User Defined**
Edwin Chen 1.1 582
Edwin Chen 2.1 583 * (% style="color:#037691" %)**AT+PUBTOPIC=User Defined**
Edwin Chen 1.1 584
Edwin Chen 2.1 585 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 586
Edwin Chen 2.1 587 * (% style="color:#037691" %)**AT+PWD=<device name> or User Defined**
Edwin Chen 1.1 588
Edwin Chen 2.1 589 * (% style="color:#037691" %)**AT+SERVADDR=8.217.91.207,1883 ** (%%) ~/~/ to set MQTT server address and port
Edwin Chen 1.1 590
Edwin Chen 2.1 591 (% style="color:red" %)**Note: To uplink and downlink via MQTT.fx, we need set the publish topic and subscribe topic different, for example: AT+SUBTOPIC=SE01_SUB & AT+PUBTOPIC=SE01_PUB.**
Edwin Chen 1.1 592
Edwin Chen 3.1 593 [[image:image-20240417180145-2.png||height="434" width="587"]][[ width="584">> width="584"]]
Edwin Chen 1.1 594
Edwin Chen 2.1 595 **2. **When the node uplink packets, we can observe the data in MQTT.fx.
Edwin Chen 1.1 596
Edwin Chen 2.1 597 [[image:image-20240418144337-1.png||height="709" width="802"]]
Edwin Chen 1.1 598
Edwin Chen 2.1 599 **3. **The downlink command can be successfully sent only when the downlink port is open.
Edwin Chen 1.1 600
601 The downlink port is opened for about 3 seconds after uplink packets are sent.
602
Edwin Chen 2.1 603 Therefore, when we see the node uplink packets in the **Subscribe** window, we need to immediately switch to the **publish** window to publish the **hex format** command.
Edwin Chen 1.1 604
Edwin Chen 2.1 605 [[image:image-20240418150435-3.png||height="582" width="659"]]
Edwin Chen 1.1 606
Edwin Chen 2.1 607 [[image:image-20240418150932-4.png||height="492" width="1061"]]
Edwin Chen 1.1 608
Edwin Chen 2.1 609 (% style="color:red" %)**Note: Users can edit the hex command in advance. When the node uplink, directly click the publish button several times to increase the success rate of command configuration.**
Edwin Chen 1.1 610
Edwin Chen 2.1 611 = 5. FAQ =
Edwin Chen 1.1 612
Edwin Chen 2.1 613 == 5.1 What is the usage of Multi Sampling and One Uplink? ==
Edwin Chen 1.1 614
615 The NB series has the feature for Multi Sampling and one uplink. See one of them
616
Edwin Chen 2.1 617 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink>>http://wiki.dragino.com/xwiki/bin/view/Main/User%20Manual%20for%20LoRaWAN%20End%20Nodes/SN50v3-NB_BN-IoT_Sensor_Node_User_Manual/#H2.5Multi-SamplingsandOneuplink]]
Edwin Chen 1.1 618
619 User can use this feature for below purpose:
620
Edwin Chen 2.1 621 1. **Reduce power consumption**. The NB-IoT transmit power is much more higher than the sensor sampling power. To save battery life, we can sampling often and send in one uplink.
622 1. Give more sampling data points.
623 1. Increase reliable in transmission. For example. If user set
624 1*. **AT+TR=1800** ~/~/ The unit is seconds, and the default is to record data once every 1800 seconds (30 minutes, the minimum can be set to 180 seconds)
625 1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
626 1*. **AT+TDC=7200** ~/~/ Uplink every 2 hours.
627 1*. this will mean each uplink will actually include the 6 uplink data (24 set data which cover 12 hours). So if device doesn't lost 6 continue data. There will not data lost.
Edwin Chen 1.1 628
Edwin Chen 2.1 629 == 5.2 Why the uplink JSON format is not standard? ==
Edwin Chen 1.1 630
631 The json format in uplink packet is not standard Json format. Below is the example. This is to make the payload as short as possible, due to NB-IoT transmit limition, a standard Json is not able to include 32 sets of sensors data with timestamp.
632
633 The firmware version released after 2024, Mar will use change back to use Json format. Detail please check changelog.
634
Edwin Chen 2.1 635 [[image:image-20240229233154-1.png]]
Edwin Chen 1.1 636
Edwin Chen 2.1 637 = 6. Trouble Shooting: =
Edwin Chen 1.1 638
Edwin Chen 2.1 639 == 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. ==
Edwin Chen 1.1 640
641 There are many different providers provide NB-IoT service in the world. They might use different band, different APN & different operator configuration. Which makes connection to NB-IoT network is complicate.
642
Edwin Chen 2.1 643 If end device successfully attached NB-IoT Network, User can normally see the signal strengh as below (between 0~~31)
Edwin Chen 1.1 644
Edwin Chen 2.1 645 [[image:image-20240207002003-1.png]]
Edwin Chen 1.1 646
647 If fail to attach network, it will shows signal 99. as below:
648
Edwin Chen 2.1 649 [[image:image-20240207002129-2.png]]
Edwin Chen 1.1 650
Edwin Chen 2.1 651 (% class="lead" %)
Edwin Chen 1.1 652 When see this issue, below are the checklist:
653
Edwin Chen 2.1 654 * Does your SIM card support NB-IoT network? If SIM card doesn't not specify support NB-IoT clearly, normally it doesn't support. You need to confirm with your operator.
655 * Do you configure the correct APN? [[Check here for APN settings>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.1GeneralConfiguretoattachnetwork]].
656 * Do you lock the frequency band? This is the most case we see. [[Explain and Instruction>>http://wiki.dragino.com/xwiki/bin/view/Main/General%20Configure%20to%20Connect%20to%20IoT%20server%20for%20-NB%20%26%20-NS%20NB-IoT%20models/#H2.2SpeedUpNetworkAttachtime]].
657 * Check if the device is attached to Carrier network but reject. (need to check with operator).
658 * Check if the antenna is connected firmly.
Edwin Chen 1.1 659
Edwin Chen 2.1 660 If you have check all above and still fail. please send console log files (as many as possible) to [[support@dragino.com>>mailto:support@dragino.com]] so we can check.
Edwin Chen 1.1 661
662
Edwin Chen 2.1 663 == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.4 Why sometime the AT Command is slow in reponse?(%%) ==
Edwin Chen 1.1 664
665 When the MCU is communicating with the NB-IoT module, the MCU response of AT Command will become slower, it might takes several seconds to response.
666
Edwin Chen 2.1 667 [[image:image-20240226111928-1.png]]
Edwin Chen 1.1 668
Edwin Chen 2.1 669 == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 What is the Downlink Command by the NB device?(%%) ==
Edwin Chen 1.1 670
Edwin Chen 2.1 671 (% data-sider-select-id="bb6e9353-0c3f-473c-938d-4b416c9a03e6" %)
672 === UDP: ===
Edwin Chen 1.1 673
Edwin Chen 2.1 674 (% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %)
Edwin Chen 1.1 675 Its downlink command is the same as the AT command, but brackets are required.
676 Example:
677
678 {AT+TDC=300}
679
Edwin Chen 2.1 680 (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %)
681 === MQTT: ===
Edwin Chen 1.1 682
683 Json:
684
685 The Json format in MQTT mode needs to be configured with all commands.
686 If you have configurations that need to be changed, please change them in the template below.
687 Template:
688
689 {
690 "AT+SERVADDR":"119.91.62.30,1882",
691 "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs",
692 "AT+UNAME":"usenamedragino",
693 "AT+PWD":"passworddragino",
694 "AT+PUBTOPIC":"123",
695 "AT+SUBTOPIC":"321",
696 "AT+TDC":"7200",
697 "AT+INTMOD":"0",
698 "AT+APN":"NULL",
699 "AT+5VT":"0",
700 "AT+PRO":"3,5",
701 "AT+TR":"900",
702 "AT+NOUD":"0",
703 "AT+CSQTIME":"5",
704 "AT+DNSTIMER":"0",
705 "AT+TLSMOD":"0,0",
706 "AT+MQOS":"0",
707 "AT+TEMPALARM1":"0",
708 "AT+TEMPALARM2":"10",
709 "AT+TEMPALARM3":"0"
710 }
711
712 Hex:
713
714 MQTT's hex format. Since many commands need to support strings, only a few commands are supported.
715
716 The supported commands are consistent with LoRaWAN's hex commands.
717 Please refer to the following link to obtain the hex format:
718
Edwin Chen 2.1 719 [[http:~~/~~/wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/>>http://wiki.dragino.com/xwiki/bin/view/Main/End%20Device%20AT%20Commands%20and%20Downlink%20Command/]]
Edwin Chen 1.1 720
721
Edwin Chen 2.1 722