Version 8.1 by David Huang on 2024/06/07 14:59

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 7.1 26 [[image:image-20240602220856-1.png]]
Edwin Chen 1.1 27
28
Edwin Chen 7.1 29 放一张如何插卡图片。
30
31
Edwin Chen 3.1 32 After doing above, the end nodes should be able to attach to NB-IoT network .
Edwin Chen 1.1 33
Edwin Chen 3.1 34 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 35
Edwin Chen 5.1 36 ~-~-(% 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 37
Edwin Chen 5.1 38 ~-~-(% 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 39
Edwin Chen 4.1 40 Make sure you use a the NB-IoT or LTE-M SIM card.
Edwin Chen 3.1 41
Edwin Chen 4.1 42 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1134px" %)
43 |(% 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**
44 |(% style="width:117px" %)**[[1NCE>>https://1nce.com]]**|(% style="width:151px" %)iot.1nce.net|(% style="width:406px" %)(((
Edwin Chen 2.1 45 **[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]**
Edwin Chen 1.1 46
Edwin Chen 4.1 47 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
48 )))|(% style="width:351px" %)(((
49 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.
50 )))|(% style="width:120px" %)UK: Band20
51 |(% style="width:117px" %)China Mobile|(% style="width:151px" %)No need configure|(% style="width:406px" %)China Mainland, HongKong|(% style="width:351px" %) |(% style="width:120px" %)
52 |(% style="width:117px" %)China Telecom|(% style="width:151px" %)ctnb|(% style="width:406px" %)China Mainland|(% style="width:351px" %) |(% style="width:120px" %)
Edwin Chen 1.1 53
Edwin Chen 2.1 54 == 2.2 Speed Up Network Attach time ==
Edwin Chen 1.1 55
Edwin Chen 4.1 56 **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 57
58
Edwin Chen 4.1 59 Attache to 1NCE card for Australia use:
Edwin Chen 1.1 60
Edwin Chen 4.1 61 * AT+COPS=1,2,"50501",8
62 * AT+QCFG="band",0,0x8000000,0x8000000,1
Edwin Chen 1.1 63
Edwin Chen 4.1 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
David Huang 8.1 103 == 3.2 General COAP Connection ==
104
105 The NB-IoT Sensor can send packet to server use COAP protocol.
106
107 Below are the commands.
108
109 (% style="color:blue" %)**AT Commands:**
110
111 * (% style="color:#037691" %)**AT+PRO=1,0**   (%%) ~/~/ Set to use COAP protocol to uplink, Payload Type select Hex payload.
112
113 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5683** (%%) ~/~/ Set COAP server address and port
114
115 * (% style="color:#037691" %)**AT+URI1=11,"I"**  (%%) ~/~/  Configure CoAP Message Options
116 * (% style="color:#037691" %)**AT+URI2=11,"aaa05e26-4d6d-f01b-660e-1d8de4a3bfe1"**  (%%) ~/~/ Configure CoAP Message Options
117
118 (% class="wikigeneratedid" %)
119 === 3.2.1 Uplink Example ===
120
121
122
Edwin Chen 2.1 123 == 3.2 General MQTT Connection ==
Edwin Chen 1.1 124
Edwin Chen 2.1 125 The NB-IoT Sensor can send packet to server use MQTT protocol.
Edwin Chen 1.1 126
Edwin Chen 2.1 127 Below are the commands.
Edwin Chen 1.1 128
Edwin Chen 2.1 129 (% style="color:blue" %)**AT Commands:**
Edwin Chen 1.1 130
Edwin Chen 3.1 131 * (% style="color:#037691" %)**AT+PRO=3,0**   (%%) ~/~/ Set to use MQTT protocol to uplink, Payload Type select Hex payload.
Edwin Chen 1.1 132
Edwin Chen 3.1 133 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,1883**  (%%) ~/~/ Set MQTT server address and port
Edwin Chen 1.1 134
Edwin Chen 3.1 135 * (% style="color:#037691" %)**AT+CLIENT=CLIENT**     (%%) ~/~/ Set up the CLIENT of MQTT
Edwin Chen 1.1 136
Edwin Chen 3.1 137 * (% style="color:#037691" %)**AT+UNAME=UNAME**        (%%) ~/~/ Set the username of MQTT
Edwin Chen 1.1 138
Edwin Chen 3.1 139 * (% style="color:#037691" %)**AT+PWD=PWD**             (%%) ~/~/ Set the password of MQTT
Edwin Chen 1.1 140
Edwin Chen 3.1 141 * (% style="color:#037691" %)**AT+PUBTOPIC=NSE01_PUB**  (%%) ~/~/ Set the sending topic of MQTT
Edwin Chen 1.1 142
Edwin Chen 3.1 143 * (% style="color:#037691" %)**AT+SUBTOPIC=NSE01_SUB**  (%%) ~/~/ Set the subscription topic of MQTT
Edwin Chen 1.1 144
Edwin Chen 2.1 145 [[image:image-20230802112413-4.png]]
Edwin Chen 1.1 146
Edwin Chen 2.1 147 [[image:image-20230802112413-5.png||height="530" width="987"]]
Edwin Chen 1.1 148
Edwin Chen 2.1 149 (% 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 150
Edwin Chen 2.1 151 == 3.3 [[ThingSpeak>>url:https://thingspeak.com/]] (via MQTT) ==
Edwin Chen 1.1 152
Edwin Chen 2.1 153 === 3.3.1 Get MQTT Credentials ===
Edwin Chen 1.1 154
Edwin Chen 2.1 155 [[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 156
Edwin Chen 2.1 157 [[image:image-20230802112413-6.png||height="336" width="925"]]
Edwin Chen 1.1 158
Edwin Chen 2.1 159 [[image:image-20230802112413-7.png]]
Edwin Chen 1.1 160
Edwin Chen 2.1 161 === 3.3.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 162
Edwin Chen 2.1 163 ==== 3.3.2.1 Establish MQTT Connection ====
Edwin Chen 1.1 164
Edwin Chen 2.1 165 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 166
Edwin Chen 2.1 167 [[image:image-20230802112413-8.png]]
Edwin Chen 1.1 168
Edwin Chen 2.1 169 * (% style="color:#037691" %)**Broker Address:**(%%) mqtt3.thingspeak.com
Edwin Chen 1.1 170
Edwin Chen 2.1 171 * (% style="color:#037691" %)**Broker Port:**(%%) 1883
Edwin Chen 1.1 172
Edwin Chen 2.1 173 * (% style="color:#037691" %)**Client ID:**(%%) <Your ThingSpeak MQTT ClientID>
Edwin Chen 1.1 174
Edwin Chen 2.1 175 * (% style="color:#037691" %)**User Name:**(%%) <Your ThingSpeak MQTT User Name>
Edwin Chen 1.1 176
Edwin Chen 2.1 177 * (% style="color:#037691" %)**Password:**(%%) <Your ThingSpeak MQTT Password>
Edwin Chen 1.1 178
Edwin Chen 2.1 179 ==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
Edwin Chen 1.1 180
Edwin Chen 2.1 181 [[image:image-20230802112413-9.png]]
Edwin Chen 1.1 182
Edwin Chen 2.1 183 [[image:image-20230802112413-10.png]]
Edwin Chen 1.1 184
Edwin Chen 2.1 185 (% style="color:blue" %)**In MQTT.fx, we can publish below info:**
Edwin Chen 1.1 186
Edwin Chen 2.1 187 * (% style="color:#037691" %)**Topic:**(%%) channels/YOUR_CHANNEL_ID/publish
Edwin Chen 1.1 188
Edwin Chen 2.1 189 * (% style="color:#037691" %)**Payload:**(%%) field1=63&field2=67&status=MQTTPUBLISH
Edwin Chen 1.1 190
Edwin Chen 2.1 191 Where 63 and 67 are the value to be published to field1 & field2.
Edwin Chen 1.1 192
Edwin Chen 2.1 193 (% style="color:blue" %)**Result: **
Edwin Chen 1.1 194
Edwin Chen 2.1 195 [[image:image-20230802112413-11.png||height="539" width="901"]]
Edwin Chen 1.1 196
Edwin Chen 2.1 197 === 3.3.3 Configure NB-IoT Sensor for connection ===
Edwin Chen 1.1 198
Edwin Chen 2.1 199 ==== 3.3.3.1 AT Commands: ====
Edwin Chen 1.1 200
Edwin Chen 2.1 201 In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
Edwin Chen 1.1 202
Edwin Chen 2.1 203 * (% style="color:blue" %)**AT+PRO=3,1** (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
Edwin Chen 1.1 204
Edwin Chen 2.1 205 * (% style="color:blue" %)**AT+CLIENT=<Your ThingSpeak MQTT ClientID>**
Edwin Chen 1.1 206
Edwin Chen 2.1 207 * (% style="color:blue" %)**AT+UNAME=<Your ThingSpeak MQTT User Name>**
Edwin Chen 1.1 208
Edwin Chen 2.1 209 * (% style="color:blue" %)**AT+PWD=<Your ThingSpeak MQTT Password>**
Edwin Chen 1.1 210
Edwin Chen 2.1 211 * (% style="color:blue" %)**AT+PUBTOPIC=<YOUR_CHANNEL_ID>**
Edwin Chen 1.1 212
Edwin Chen 2.1 213 * (% style="color:blue" %)**AT+SUBTOPIC=<YOUR_CHANNEL_ID>**
Edwin Chen 1.1 214
Edwin Chen 2.1 215 ==== 3.3.3.2 Uplink Examples ====
Edwin Chen 1.1 216
Edwin Chen 2.1 217 [[image:image-20230816201942-1.png]]
Edwin Chen 1.1 218
Edwin Chen 2.1 219 For SE01-NB
Edwin Chen 1.1 220
Edwin Chen 2.1 221 For DDS20-NB
Edwin Chen 1.1 222
Edwin Chen 2.1 223 For DDS45-NB
Edwin Chen 1.1 224
Edwin Chen 2.1 225 For DDS75-NB
Edwin Chen 1.1 226
Edwin Chen 2.1 227 For NMDS120-NB
Edwin Chen 1.1 228
Edwin Chen 2.1 229 For SPH01-NB
Edwin Chen 1.1 230
Edwin Chen 2.1 231 For NLM01-NB
Edwin Chen 1.1 232
Edwin Chen 2.1 233 For NMDS200-NB
Edwin Chen 1.1 234
Edwin Chen 2.1 235 For CPN01-NB
Edwin Chen 1.1 236
Edwin Chen 2.1 237 For DS03A-NB
Edwin Chen 1.1 238
Edwin Chen 2.1 239 For SN50V3-NB
Edwin Chen 1.1 240
Edwin Chen 2.1 241 ==== 3.3.3.3 Map fields to sensor value ====
Edwin Chen 1.1 242
Edwin Chen 2.1 243 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 244
Edwin Chen 2.1 245 [[image:image-20230802112413-12.png||height="504" width="1011"]]
Edwin Chen 1.1 246
Edwin Chen 2.1 247 [[image:image-20230802112413-13.png||height="331" width="978"]]
Edwin Chen 1.1 248
Edwin Chen 2.1 249 Below is the NB-IoT Product Table show the mapping.
Edwin Chen 1.1 250
Edwin Chen 2.1 251 (% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1424px" %)
252 |(% 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 253 |(% 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" %)
254 |(% 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" %)
255 |(% 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" %)
256 |(% 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" %)
257 |(% 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" %)
258 |(% 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" %)
259 |(% 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" %)
260 |(% 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" %)
261 |(% 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" %)
262 |(% 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 263 |(% 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 264 |(% 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" %)
265 |(% 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" %)
266 |(% 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" %)
267 |(% 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" %)
268 |(% 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" %)
269 |(% 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 270
Edwin Chen 2.1 271 == 3.4 [[Datacake>>https://datacake.co/]] ==
Edwin Chen 1.1 272
Edwin Chen 2.1 273 (% class="wikigeneratedid" %)
274 Dragino NB-IoT sensors has its template in **[[Datacake>>https://datacake.co/]]** Platform. There are two version for NB Sensor,
Edwin Chen 1.1 275
Edwin Chen 2.1 276 (% class="wikigeneratedid" %)
277 As example for S31B-NB. there are two versions: **S31B-NB-1D and S31B-NB-GE.**
Edwin Chen 1.1 278
Edwin Chen 2.1 279 * (% 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 280
Edwin Chen 2.1 281 * (% 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 282
Edwin Chen 2.1 283 === 3.4.1 For device Already has template ===
Edwin Chen 1.1 284
Edwin Chen 2.1 285 ==== 3.4.1.1 Create Device ====
Edwin Chen 1.1 286
Edwin Chen 2.1 287 (% style="color:blue" %)**Add Device**(%%) in DataCake.
Edwin Chen 1.1 288
Edwin Chen 2.1 289 [[image:image-20230808162301-1.png||height="453" width="952"]]
Edwin Chen 1.1 290
Edwin Chen 2.1 291 [[image:image-20230808162342-2.png||height="541" width="952"]]
Edwin Chen 1.1 292
Edwin Chen 2.1 293 (% style="color:blue" %)**Choose the correct model**(%%) from template.
Edwin Chen 1.1 294
Edwin Chen 2.1 295 [[image:image-20230808162421-3.png]]
Edwin Chen 1.1 296
Edwin Chen 3.1 297 (% 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 298
Edwin Chen 2.1 299 [[image:image-20230808163612-7.png||height="549" width="952"]]
Edwin Chen 1.1 300
Edwin Chen 2.1 301 [[image:image-20230808163035-5.png]]
Edwin Chen 1.1 302
Edwin Chen 2.1 303 [[image:image-20230808163049-6.png||height="544" width="926"]]
Edwin Chen 1.1 304
Edwin Chen 2.1 305 === 3.4.2 For Device already registered in DataCake before shipped ===
Edwin Chen 1.1 306
Edwin Chen 2.1 307 ==== 3.4.2.1 Scan QR Code to get the device info ====
Edwin Chen 1.1 308
309 Users can use their phones or computers to scan QR codes to obtain device data information.
310
Edwin Chen 2.1 311 [[image:image-20230808170051-8.png||height="255" width="259"]]
Edwin Chen 1.1 312
Edwin Chen 2.1 313 [[image:image-20230808170548-9.png]]
Edwin Chen 1.1 314
Edwin Chen 2.1 315 ==== 3.4.2.2 Claim Device to User Account ====
Edwin Chen 1.1 316
317 By Default, the device is registered in Dragino's DataCake Account. User can Claim it to his account.
318
Edwin Chen 2.1 319 === 3.4.3 Manual Add Decoder in DataCake ( don't use the template in DataCake) ===
Edwin Chen 1.1 320
Edwin Chen 2.1 321 **Step1: Add a device**
Edwin Chen 1.1 322
Edwin Chen 2.1 323 [[image:image-20240129170024-1.png||height="330" width="900"]]
Edwin Chen 1.1 324
Edwin Chen 2.1 325 **Step2: Choose your device type,please select dragino NB-IOT device**
Edwin Chen 1.1 326
Edwin Chen 2.1 327 [[image:image-20240129170216-2.png||height="534" width="643"]]
Edwin Chen 1.1 328
Edwin Chen 2.1 329 **Step3: Choose to create a new device**
Edwin Chen 1.1 330
Edwin Chen 2.1 331 [[image:image-20240129170539-3.png||height="459" width="646"]]
Edwin Chen 1.1 332
Edwin Chen 2.1 333 **Step4: Fill in the device ID of your NB device**
Edwin Chen 1.1 334
Edwin Chen 2.1 335 [[image:image-20240202111546-1.png||height="378" width="651"]]
Edwin Chen 1.1 336
Edwin Chen 2.1 337 **Step5: Please select your device plan according to your needs and complete the creation of the device**
Edwin Chen 1.1 338
Edwin Chen 2.1 339 [[image:image-20240129171236-6.png||height="450" width="648"]]
Edwin Chen 1.1 340
Edwin Chen 2.1 341 **Step6: Please add the decoder at the payload decoder of the device configuration.**
Edwin Chen 1.1 342
Edwin Chen 2.1 343 **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 344
Edwin Chen 2.1 345 [[image:image-20240129172056-7.png||height="457" width="816"]]
Edwin Chen 1.1 346
Edwin Chen 2.1 347 [[image:image-20240129173116-9.png||height="499" width="814"]]
Edwin Chen 1.1 348
Edwin Chen 2.1 349 **Step7: Add the output of the decoder as a field**
Edwin Chen 1.1 350
Edwin Chen 2.1 351 [[image:image-20240129173541-10.png||height="592" width="968"]]
Edwin Chen 1.1 352
Edwin Chen 2.1 353 **Step8: Customize the dashboard and use fields as parameters of the dashboard**
Edwin Chen 1.1 354
Edwin Chen 2.1 355 [[image:image-20240129174518-11.png||height="147" width="1042"]]
Edwin Chen 1.1 356
Edwin Chen 2.1 357 [[image:image-20240129174657-12.png||height="538" width="916"]]
Edwin Chen 1.1 358
Edwin Chen 2.1 359 [[image:image-20240129174840-13.png||height="536" width="750"]]
Edwin Chen 1.1 360
Edwin Chen 2.1 361 === 3.4.4 For device have not configured to connect to DataCake ===
Edwin Chen 1.1 362
Edwin Chen 2.1 363 (% class="lead" %)
Edwin Chen 1.1 364 Use AT command for connecting to DataCake
365
Edwin Chen 2.1 366 (% style="color:blue" %)**AT+PRO=2,0**
Edwin Chen 1.1 367
Edwin Chen 2.1 368 (% style="color:blue" %)**AT+SERVADDR=67.207.76.90,4445**
Edwin Chen 1.1 369
Edwin Chen 2.1 370 == 3.5 Node-Red (via MQTT) ==
Edwin Chen 1.1 371
Edwin Chen 2.1 372 === 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] ===
Edwin Chen 1.1 373
374 Take S31-NB UDP protocol as an example.
375
376 Dragino provides input flow examples for the sensors.
377
378 User can download the required JSON file through Dragino Node-RED input flow template.
379
Edwin Chen 2.1 380 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 381
382 We can directly import the template.
383
384 The templates for S31-NB and NB95S31B are the same.
385
Edwin Chen 2.1 386 [[image:image-20230809173127-4.png]]
Edwin Chen 1.1 387
388 Please select the NB95S31B template.
389
Edwin Chen 2.1 390 [[image:image-20230809173310-5.png||height="558" width="926"]]
Edwin Chen 1.1 391
Edwin Chen 2.1 392 [[image:image-20230809173438-6.png]]
Edwin Chen 1.1 393
Edwin Chen 2.1 394 [[image:image-20230809173800-7.png]]
Edwin Chen 1.1 395
396 Successfully imported template.
397
Edwin Chen 2.1 398 [[image:image-20230809173835-8.png||height="515" width="860"]]
Edwin Chen 1.1 399
400 Users can set UDP port.
401
Edwin Chen 2.1 402 [[image:image-20230809174053-9.png]]
Edwin Chen 1.1 403
Edwin Chen 2.1 404 === 3.5.2 Simulate Connection ===
Edwin Chen 1.1 405
406 We have completed the configuration of UDP. We can try sending packets to node red.
407
Edwin Chen 2.1 408 [[image:image-20230810083934-1.png]]
Edwin Chen 1.1 409
Edwin Chen 2.1 410 [[image:image-20230810084048-2.png||height="535" width="1052"]]
Edwin Chen 1.1 411
Edwin Chen 2.1 412 === 3.5.3 Configure NB-IoT Sensors ===
Edwin Chen 1.1 413
Edwin Chen 2.1 414 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
415 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
416 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
417 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
418 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
419 * (% style="color:#037691" %)**AT+PWD=“Your device token”**
Edwin Chen 1.1 420
Edwin Chen 2.1 421 == 3.6 ThingsBoard.Cloud (via MQTT) ==
Edwin Chen 1.1 422
Edwin Chen 2.1 423 === 3.6.1 Configure ThingsBoard ===
Edwin Chen 1.1 424
Edwin Chen 2.1 425 ==== 3.6.1.1 Create Device ====
Edwin Chen 1.1 426
Edwin Chen 2.1 427 Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
Edwin Chen 1.1 428
Edwin Chen 2.1 429 [[image:image-20230802112413-32.png||height="583" width="1066"]]
Edwin Chen 1.1 430
Edwin Chen 2.1 431 ==== 3.6.1.2 Create Uplink & Downlink Converter ====
Edwin Chen 1.1 432
Edwin Chen 2.1 433 (% style="color:blue" %)**Uplink Converter**
Edwin Chen 1.1 434
Edwin Chen 2.1 435 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 436
Edwin Chen 2.1 437 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 438
Edwin Chen 2.1 439 [[image:image-20230802112413-33.png||height="597" width="1061"]]
Edwin Chen 1.1 440
Edwin Chen 2.1 441 (% style="color:blue" %)**Downlink Converter**
Edwin Chen 1.1 442
Edwin Chen 2.1 443 The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
Edwin Chen 1.1 444
Edwin Chen 2.1 445 [[image:image-20230802112413-34.png||height="598" width="1063"]]
Edwin Chen 1.1 446
Edwin Chen 2.1 447 (% 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 448
Edwin Chen 2.1 449 ==== 3.6.1.3 MQTT Integration Setup ====
Edwin Chen 1.1 450
Edwin Chen 2.1 451 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 452
Edwin Chen 2.1 453 [[image:image-20230802112413-35.png||height="597" width="1062"]]
Edwin Chen 1.1 454
Edwin Chen 2.1 455 * The next steps is to add the recently created uplink and downlink converters;
Edwin Chen 1.1 456
Edwin Chen 2.1 457 [[image:image-20230802112413-36.png||height="598" width="1062"]]
Edwin Chen 1.1 458
Edwin Chen 2.1 459 [[image:image-20230802112413-37.png||height="598" width="1064"]]
Edwin Chen 1.1 460
Edwin Chen 2.1 461 (% style="color:blue" %)**Add a topic filter:**
Edwin Chen 1.1 462
463 Consistent with the theme of the node setting.
464
Edwin Chen 2.1 465 You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
Edwin Chen 1.1 466
Edwin Chen 2.1 467 [[image:image-20230802112413-38.png||height="598" width="1064"]]
Edwin Chen 1.1 468
Edwin Chen 2.1 469 === 3.6.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 470
Edwin Chen 2.1 471 [[image:image-20230802112413-39.png]]
Edwin Chen 1.1 472
Edwin Chen 2.1 473 [[image:image-20230802112413-40.png||height="525" width="980"]]
Edwin Chen 1.1 474
Edwin Chen 2.1 475 === 3.6.3 Configure NB-IoT Sensor ===
Edwin Chen 1.1 476
Edwin Chen 2.1 477 (% style="color:blue" %)**AT Commands**
Edwin Chen 1.1 478
Edwin Chen 3.1 479 * (% style="color:#037691" %)**AT+PRO=3,3  **(%%)** **~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3.
Edwin Chen 1.1 480
Edwin Chen 2.1 481 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>**
Edwin Chen 1.1 482
Edwin Chen 2.1 483 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>**
Edwin Chen 1.1 484
Edwin Chen 2.1 485 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
Edwin Chen 1.1 486
Edwin Chen 2.1 487 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 488
Edwin Chen 2.1 489 * (% style="color:#037691" %)**AT+PWD=<device name> or User Defined**
Edwin Chen 1.1 490
Edwin Chen 2.1 491 Test Uplink by click the button for 1 second
Edwin Chen 1.1 492
Edwin Chen 2.1 493 [[image:image-20230802112413-41.png||height="496" width="828"]]
Edwin Chen 1.1 494
Edwin Chen 2.1 495 [[image:image-20230802112413-42.png]]
Edwin Chen 1.1 496
Edwin Chen 2.1 497 [[image:image-20230802112413-43.png||height="407" width="825"]]
Edwin Chen 1.1 498
Edwin Chen 2.1 499 == 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
Edwin Chen 1.1 500
Edwin Chen 2.1 501 === 3.7.1 Create device & Get Credentials ===
Edwin Chen 1.1 502
Edwin Chen 2.1 503 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 504
Edwin Chen 2.1 505 [[image:image-20230802112413-44.png]]
Edwin Chen 1.1 506
Edwin Chen 2.1 507 [[image:image-20230802112413-45.png]]
Edwin Chen 1.1 508
Edwin Chen 2.1 509 Go to the Device section and create a device. Then, go to the section tokens and copy your device-token.
Edwin Chen 1.1 510
Edwin Chen 2.1 511 [[image:image-20230802112413-46.png]]
Edwin Chen 1.1 512
Edwin Chen 2.1 513 The device needs to enable the TLS mode and set the (% style="color:blue" %)**AT+TLSMOD=1,0**(%%) command.
Edwin Chen 1.1 514
Edwin Chen 2.1 515 (% style="color:blue" %)**On the Connection Profile window, set the following information:**
Edwin Chen 1.1 516
Edwin Chen 2.1 517 * (% style="color:#037691" %)**Profile Name: “Any name”**
Edwin Chen 1.1 518
Edwin Chen 2.1 519 * (% style="color:#037691" %)**Broker Address: mqtt.tago.io**
Edwin Chen 1.1 520
Edwin Chen 2.1 521 * (% style="color:#037691" %)**Broker Port: 8883**
Edwin Chen 1.1 522
Edwin Chen 2.1 523 * (% style="color:#037691" %)**Client ID: “Any value”**
Edwin Chen 1.1 524
Edwin Chen 2.1 525 (% style="color:blue" %)**On the section User credentials, set the following information:**
Edwin Chen 1.1 526
Edwin Chen 2.1 527 * (% style="color:#037691" %)**User Name: “Any value”** (%%) **~/~/ Tago validates your user by the token only**
Edwin Chen 1.1 528
Edwin Chen 2.1 529 * (% style="color:#037691" %)**Password: “Your device token”**
Edwin Chen 1.1 530
Edwin Chen 2.1 531 * (% style="color:#037691" %)**PUBTOPIC: “Any value”**
Edwin Chen 1.1 532
Edwin Chen 2.1 533 * (% style="color:#037691" %)**SUBTOPIC: “Any value”**
Edwin Chen 1.1 534
Edwin Chen 2.1 535 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 536
Edwin Chen 2.1 537 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%) **~/~/ hex format or json format**
Edwin Chen 1.1 538
Edwin Chen 2.1 539 * (% style="color:#037691" %)**AT+SUBTOPIC=<device name>or User Defined**
Edwin Chen 1.1 540
Edwin Chen 2.1 541 * (% style="color:#037691" %)**AT+PUBTOPIC=<device name>or User Defined**
Edwin Chen 1.1 542
Edwin Chen 2.1 543 * (% style="color:#037691" %)**AT+CLIENT=<device name> or User Defined**
Edwin Chen 1.1 544
Edwin Chen 2.1 545 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 546
Edwin Chen 2.1 547 * (% style="color:#037691" %)**AT+PWD=“Your device token”**
Edwin Chen 1.1 548
Edwin Chen 2.1 549 === 3.7.2 Simulate with MQTT.fx ===
Edwin Chen 1.1 550
Edwin Chen 2.1 551 [[image:image-20230802112413-52.png]]
Edwin Chen 1.1 552
Edwin Chen 2.1 553 [[image:image-20230808105300-2.png||height="553" width="1026"]]
Edwin Chen 1.1 554
Edwin Chen 2.1 555 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 556
Edwin Chen 2.1 557 [[image:image-20230808105217-1.png||height="556" width="1031"]]
Edwin Chen 1.1 558
Edwin Chen 2.1 559 [[image:image-20230808105329-3.png]]
Edwin Chen 1.1 560
Edwin Chen 2.1 561 === 3.7.3 tago data ===
Edwin Chen 1.1 562
Edwin Chen 2.1 563 [[image:image-20230802112413-50.png||height="242" width="1037"]]
Edwin Chen 1.1 564
Edwin Chen 2.1 565 [[image:image-20230802112413-51.png||height="184" width="696"]]
Edwin Chen 1.1 566
Edwin Chen 2.1 567 == 3.8 TCP Connection ==
Edwin Chen 1.1 568
Edwin Chen 2.1 569 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 570
Edwin Chen 3.1 571 * (% style="color:#037691" %)**AT+PRO=4,0   ** (%%) ~/~/ Set to use TCP protocol to uplink(HEX format)
Edwin Chen 1.1 572
Edwin Chen 3.1 573 * (% style="color:#037691" %)**AT+PRO=4,1   ** (%%) ~/~/ Set to use TCP protocol to uplink(JSON format)
Edwin Chen 1.1 574
Edwin Chen 2.1 575 * (% style="color:#037691" %)**AT+SERVADDR=120.24.4.116,5600 ** (%%) ~/~/ to set TCP server address and port
Edwin Chen 1.1 576
Edwin Chen 2.1 577 (% style="color:blue" %)**Sensor Console Output when Uplink:**
Edwin Chen 1.1 578
Edwin Chen 2.1 579 [[image:image-20230807233631-1.png]]
Edwin Chen 1.1 580
Edwin Chen 2.1 581 (% style="color:blue" %)**See result in TCP Server:**
Edwin Chen 1.1 582
Edwin Chen 2.1 583 [[image:image-20230807233631-2.png]]
Edwin Chen 1.1 584
Edwin Chen 2.1 585 == 3.9 AWS Connection ==
Edwin Chen 1.1 586
Edwin Chen 2.1 587 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 588
Edwin Chen 2.1 589 = 4. MQTT/UDP/TCP downlink =
Edwin Chen 1.1 590
Edwin Chen 2.1 591 == 4.1 MQTT (via MQTT.fx) ==
Edwin Chen 1.1 592
Edwin Chen 2.1 593 Configure MQTT connections properly and send downlink commands to configure nodes through the Publish function of MQTT.fx//.//
Edwin Chen 1.1 594
Edwin Chen 2.1 595 **1.** Configure node MQTT connection (via MQTT.fx):
Edwin Chen 1.1 596
Edwin Chen 2.1 597 (% style="color:blue" %)**AT command:**
Edwin Chen 1.1 598
Edwin Chen 2.1 599 * (% style="color:#037691" %)**AT+PRO=3,0 or 3,5 ** (%%)~/~/ hex format or json format
Edwin Chen 1.1 600
Edwin Chen 2.1 601 * (% style="color:#037691" %)**AT+SUBTOPIC=User Defined**
Edwin Chen 1.1 602
Edwin Chen 2.1 603 * (% style="color:#037691" %)**AT+PUBTOPIC=User Defined**
Edwin Chen 1.1 604
Edwin Chen 2.1 605 * (% style="color:#037691" %)**AT+UNAME=<device name> or User Defined**
Edwin Chen 1.1 606
Edwin Chen 2.1 607 * (% style="color:#037691" %)**AT+PWD=<device name> or User Defined**
Edwin Chen 1.1 608
Edwin Chen 2.1 609 * (% style="color:#037691" %)**AT+SERVADDR=8.217.91.207,1883 ** (%%) ~/~/ to set MQTT server address and port
Edwin Chen 1.1 610
Edwin Chen 2.1 611 (% 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 612
Edwin Chen 3.1 613 [[image:image-20240417180145-2.png||height="434" width="587"]][[ width="584">> width="584"]]
Edwin Chen 1.1 614
Edwin Chen 2.1 615 **2. **When the node uplink packets, we can observe the data in MQTT.fx.
Edwin Chen 1.1 616
Edwin Chen 2.1 617 [[image:image-20240418144337-1.png||height="709" width="802"]]
Edwin Chen 1.1 618
Edwin Chen 2.1 619 **3. **The downlink command can be successfully sent only when the downlink port is open.
Edwin Chen 1.1 620
621 The downlink port is opened for about 3 seconds after uplink packets are sent.
622
Edwin Chen 2.1 623 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 624
Edwin Chen 2.1 625 [[image:image-20240418150435-3.png||height="582" width="659"]]
Edwin Chen 1.1 626
Edwin Chen 2.1 627 [[image:image-20240418150932-4.png||height="492" width="1061"]]
Edwin Chen 1.1 628
Edwin Chen 2.1 629 (% 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 630
Edwin Chen 2.1 631 = 5. FAQ =
Edwin Chen 1.1 632
Edwin Chen 2.1 633 == 5.1 What is the usage of Multi Sampling and One Uplink? ==
Edwin Chen 1.1 634
635 The NB series has the feature for Multi Sampling and one uplink. See one of them
636
Edwin Chen 2.1 637 [[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 638
639 User can use this feature for below purpose:
640
Edwin Chen 2.1 641 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.
642 1. Give more sampling data points.
643 1. Increase reliable in transmission. For example. If user set
644 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)
645 1*. **AT+NOUD=24** ~/~/ The device uploads 24 sets of recorded data by default. Up to 32 sets of record data can be uploaded.
646 1*. **AT+TDC=7200** ~/~/ Uplink every 2 hours.
647 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 648
Edwin Chen 2.1 649 == 5.2 Why the uplink JSON format is not standard? ==
Edwin Chen 1.1 650
651 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.
652
653 The firmware version released after 2024, Mar will use change back to use Json format. Detail please check changelog.
654
Edwin Chen 2.1 655 [[image:image-20240229233154-1.png]]
Edwin Chen 1.1 656
Edwin Chen 2.1 657 = 6. Trouble Shooting: =
Edwin Chen 1.1 658
Edwin Chen 2.1 659 == 6.1 Checklist for debuging Network Connection issue. Signal Strenght:99 issue. ==
Edwin Chen 1.1 660
661 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.
662
Edwin Chen 2.1 663 If end device successfully attached NB-IoT Network, User can normally see the signal strengh as below (between 0~~31)
Edwin Chen 1.1 664
Edwin Chen 2.1 665 [[image:image-20240207002003-1.png]]
Edwin Chen 1.1 666
667 If fail to attach network, it will shows signal 99. as below:
668
Edwin Chen 2.1 669 [[image:image-20240207002129-2.png]]
Edwin Chen 1.1 670
Edwin Chen 2.1 671 (% class="lead" %)
Edwin Chen 1.1 672 When see this issue, below are the checklist:
673
Edwin Chen 2.1 674 * 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.
675 * 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]].
676 * 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]].
677 * Check if the device is attached to Carrier network but reject. (need to check with operator).
678 * Check if the antenna is connected firmly.
Edwin Chen 1.1 679
Edwin Chen 2.1 680 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 681
682
Edwin Chen 2.1 683 == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.4 Why sometime the AT Command is slow in reponse?(%%) ==
Edwin Chen 1.1 684
685 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.
686
Edwin Chen 2.1 687 [[image:image-20240226111928-1.png]]
Edwin Chen 1.1 688
Edwin Chen 2.1 689 == (% data-sider-select-id="765eceff-93b1-40ee-800b-b7b7d022ef8a" %)6.5 What is the Downlink Command by the NB device?(%%) ==
Edwin Chen 1.1 690
Edwin Chen 2.1 691 (% data-sider-select-id="bb6e9353-0c3f-473c-938d-4b416c9a03e6" %)
692 === UDP: ===
Edwin Chen 1.1 693
Edwin Chen 2.1 694 (% data-sider-select-id="14a4790e-7faa-4508-a4dd-7605a53f1cb3" %)
Edwin Chen 1.1 695 Its downlink command is the same as the AT command, but brackets are required.
696 Example:
697
698 {AT+TDC=300}
699
Edwin Chen 2.1 700 (% data-sider-select-id="90b80f1a-e924-4c8a-afc5-4429e019a657" %)
701 === MQTT: ===
Edwin Chen 1.1 702
703 Json:
704
705 The Json format in MQTT mode needs to be configured with all commands.
706 If you have configurations that need to be changed, please change them in the template below.
707 Template:
708
709 {
710 "AT+SERVADDR":"119.91.62.30,1882",
711 "AT+CLIENT":"JwcXKjQBNhQ2JykDDAA5Ahs",
712 "AT+UNAME":"usenamedragino",
713 "AT+PWD":"passworddragino",
714 "AT+PUBTOPIC":"123",
715 "AT+SUBTOPIC":"321",
716 "AT+TDC":"7200",
717 "AT+INTMOD":"0",
718 "AT+APN":"NULL",
719 "AT+5VT":"0",
720 "AT+PRO":"3,5",
721 "AT+TR":"900",
722 "AT+NOUD":"0",
723 "AT+CSQTIME":"5",
724 "AT+DNSTIMER":"0",
725 "AT+TLSMOD":"0,0",
726 "AT+MQOS":"0",
727 "AT+TEMPALARM1":"0",
728 "AT+TEMPALARM2":"10",
729 "AT+TEMPALARM3":"0"
730 }
731
732 Hex:
733
734 MQTT's hex format. Since many commands need to support strings, only a few commands are supported.
735
736 The supported commands are consistent with LoRaWAN's hex commands.
737 Please refer to the following link to obtain the hex format:
738
Edwin Chen 2.1 739 [[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 740
741
Edwin Chen 2.1 742