Wiki source code of General Configure/Commands to Connect to IoT server for -NB & -NS NB-IoT models

Version 83.7 by Xiaoling on 2023/08/09 10:50

version	line-number	content
83.3	1	(% class="wikigeneratedid" id="HTableofContents:" %)
	2	Table of Contents:
53.3	3
	4	{{toc/}}
	5
	6
1.1	7	= 1. The use of this guideline =
	8
1.2	9
1.1	10	This configure instruction is for Dragino NB-IoT models with -NB or -NS suffix, for example DDS75-NB. These models use the same NB-IoT Module [[BC660K-GL>>https://www.quectel.com/product/lpwa-bc660k-gl-nb2]] and has the same software structure. The have the same configure instruction to different IoT servers. Use can follow the instruction here to see how to configure to connect to those servers.
	11
	12
55.1	13	= 2. Attach Network =
1.1	14
	15
54.1	16	To attache NB-IoT sensors to NB-IoT Network, You need to:
	17
	18	1. Get a NB-IoT SIM card from Service Provider. (Not the same as the SIM card we use in mobile phone)
	19	1. Insert the SIM card to Sensor
57.1	20	1. [[Configure APN>>http://wiki.dragino.com/xwiki/bin/view/Main/How%20to%20configure%20APN%20in%20the%20node/]] in the sensor (% class="mark" %)(补充 APN 指令(%%))
54.1	21
83.1	22	[[image:image-20230808205045-1.png\|\|height="293" width="438"]]
60.1	23
54.1	24	After doing above, the NB-IoT Sensors should be able to attach to NB-IoT network .
	25
1.3	26	The -NB and -NS models support (% style="color:blue" %)LTE Cat NB2(%%), with below frequency band: multiple frequency bands of (% style="color:blue" %)B1/B2/B3/B4/B5/B8/B12/B13/B14/B17/B18/B19/B20/B25/B28/B66/B70/B85(%%) . Make sure you use a the NB-IoT SIM card.
1.1	27
54.1	28	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:878px" %)
56.2	29	\|(% style="background-color:#4f81bd; color:white; width:117px" %)SIM Provider\|(% style="background-color:#4f81bd; color:white; width:151px" %)APN\|(% style="background-color:#4f81bd; color:white; width:474px" %)NB-IoT Coverage\|(% style="background-color:#4f81bd; color:white; width:135px" %)Comments
	30	\|(% style="width:117px" %)[[1NCE>>https://1nce.com]]\|(% style="width:151px" %)iot.1nce.net\|(% style="width:474px" %)(((
54.1	31	[[Coverage Reference Link>>https://1nce.com/en-ap/1nce-connect]]
1.1	32
54.1	33	Austria, Belgium, Bulgaria, Croatia, Czech Republic, Denmark, Finland, Germany, Great Britain, Greece, Hungary, Ireland, Italy, Latvia, Malta, Netherlands, Norway, Puerto Rico, Russia, Slovak , Republic, Slovenia, Spain, Sweden, Switzerland, Taiwan, USA, US Virgin Islands
	34	)))\|(% style="width:135px" %)
57.1	35	\|(% style="width:117px" %)China Mobile\|(% style="width:151px" %)No need configure\|(% style="width:474px" %)China Mainland, HongKong\|(% style="width:135px" %)
66.1	36	\|(% style="width:117px" %)China Telecom\|(% style="width:151px" %)ctnb\|(% style="width:474px" %)China Mainland\|(% style="width:135px" %)
53.27	37
1.1	38	= 3. Configure to connect to different servers =
	39
53.3	40	== 3.1 General UDP Connection ==
53.2	41
	42
	43	The NB-IoT Sensor can send packet to server use UDP protocol.
	44
	45
53.3	46	=== 3.1.1 Simulate UDP Connection by PC tool ===
	47
	48
53.2	49	We can use PC tool to simulate UDP connection to make sure server works ok.
	50
	51	[[image:image-20230802112413-1.png]]
	52
	53
53.3	54	=== 3.1.2 Configure NB-IoT Sensor ===
53.2	55
53.3	56	==== 3.1.2.1 AT Commands ====
53.2	57
53.3	58
53.4	59	(% style="color:blue" %)AT Commands:
53.3	60
53.5	61	* (% style="color:#037691" %)AT+PRO=2,0 (%%) ~/~/ Set to use UDP protocol to uplink ,Payload Type select Hex payload
53.8	62
53.5	63	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,5601 (%%) ~/~/ Set UDP server address and port
53.8	64
53.5	65	* (% style="color:#037691" %)AT+CFM=1 (%%) ~/~/ If the server does not respond, this command is unnecessary
53.2	66
	67	[[image:image-20230802112413-2.png]]
	68
	69
53.3	70	==== 3.1.2.2 Uplink Example ====
53.2	71
53.3	72
53.2	73	[[image:image-20230802112413-3.png]]
	74
	75
53.7	76	== 3.2 General MQTT Connection ==
53.2	77
53.6	78
53.2	79	The NB-IoT Sensor can send packet to server use MQTT protocol.
	80
53.6	81	Below are the commands.
53.2	82
53.8	83	(% style="color:blue" %)AT Commands:
53.2	84
53.9	85	* (% style="color:#037691" %)AT+PRO=3,0 (%%) ~/~/ Set to use MQTT protocol to uplink, Payload Type select Hex payload.
53.2	86
53.9	87	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,1883 (%%) ~/~/ Set MQTT server address and port
53.8	88
53.9	89	* (% style="color:#037691" %)AT+CLIENT=CLIENT (%%) ~/~/ Set up the CLIENT of MQTT
53.8	90
53.9	91	* (% style="color:#037691" %)AT+UNAME=UNAME (%%) ~/~/ Set the username of MQTT
53.8	92
53.9	93	* (% style="color:#037691" %)AT+PWD=PWD (%%) ~/~/ Set the password of MQTT
53.8	94
	95	* (% style="color:#037691" %)AT+PUBTOPIC=NSE01_PUB (%%) ~/~/ Set the sending topic of MQTT
	96
	97	* (% style="color:#037691" %)AT+SUBTOPIC=NSE01_SUB (%%) ~/~/ Set the subscription topic of MQTT
	98
53.2	99	[[image:image-20230802112413-4.png]]
	100
	101	[[image:image-20230802112413-5.png]]
	102
53.9	103	(% 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.
53.2	104
	105
53.7	106	== 3.3 [[ThingSpeak>>url:https://thingspeak.com/]] (via MQTT) ==
53.2	107
53.9	108	=== 3.3.1 Get MQTT Credentials ===
53.2	109
53.9	110
53.2	111	[[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.
	112
	113	[[image:image-20230802112413-6.png]]
	114
	115	[[image:image-20230802112413-7.png]]
	116
	117
53.27	118	=== 3.3.2 Simulate with MQTT.fx ===
53.2	119
53.27	120	==== 3.3.2.1 Establish MQTT Connection ====
53.2	121
53.9	122
53.2	123	After we got MQTT Credentials, we can first simulate with PC tool MQTT.fx tool to see if the Credentials and settings are fine.
	124
	125	[[image:image-20230802112413-8.png]]
	126
53.9	127	* (% style="color:#037691" %)Broker Address:(%%) mqtt3.thingspeak.com
53.2	128
53.9	129	* (% style="color:#037691" %)Broker Port:(%%) 1883
53.10	130
53.9	131	* (% style="color:#037691" %)Client ID:(%%) <Your ThingSpeak MQTT ClientID>
53.10	132
53.9	133	* (% style="color:#037691" %)User Name:(%%) <Your ThingSpeak MQTT User Name>
53.10	134
53.9	135	* (% style="color:#037691" %)Password:(%%) <Your ThingSpeak MQTT Password>
53.2	136
53.28	137	==== 3.3.2.2 Publish Data to ThingSpeak Channel ====
	138
	139
53.2	140	[[image:image-20230802112413-9.png]]
	141
	142	[[image:image-20230802112413-10.png]]
	143
53.43	144
53.10	145	(% style="color:blue" %)In MQTT.fx, we can publish below info:
53.2	146
53.10	147	* (% style="color:#037691" %)Topic:(%%) channels/YOUR_CHANNEL_ID/publish
53.2	148
53.10	149	* (% style="color:#037691" %)Payload:(%%) field1=63&field2=67&status=MQTTPUBLISH
	150
53.2	151	Where 63 and 67 are the value to be published to field1 & field2.
	152
	153
53.10	154	(% style="color:blue" %)Result:
53.2	155
	156	[[image:image-20230802112413-11.png]]
	157
	158
53.28	159	=== 3.3.3 Configure NB-IoT Sensor for connection ===
53.2	160
53.28	161	==== 3.3.3.1 AT Commands: ====
53.2	162
53.10	163
53.2	164	In the NB-IoT, we can run below commands so to publish the channels like MQTT.fx
	165
53.27	166	* (% style="color:blue" %)AT+PRO=3,1 (%%) ~/~/ Set to use ThingSpeak Server and Related Payload
53.9	167
53.26	168	* (% style="color:blue" %)AT+CLIENT=<Your ThingSpeak MQTT ClientID>
53.9	169
53.26	170	* (% style="color:blue" %)AT+UNAME=<Your ThingSpeak MQTT User Name>
53.9	171
53.26	172	* (% style="color:blue" %)AT+PWD=<Your ThingSpeak MQTT Password>
53.9	173
53.26	174	* (% style="color:blue" %)AT+PUBTOPIC=<YOUR_CHANNEL_ID>
53.9	175
53.26	176	* (% style="color:blue" %)AT+SUBTOPIC=<YOUR_CHANNEL_ID>
53.2	177
83.4	178
	179
53.28	180	==== 3.3.3.2 Uplink Examples ====
53.10	181
	182
53.2	183	For S31-NB
	184
	185	For SE01-NB
	186
	187	For DDS20-NB
	188
	189	For DDS45-NB
	190
	191	For DDS75-NB
	192
	193	For NMDS120-NB
	194
	195	For SPH01-NB
	196
	197	For NLM01-NB
	198
	199	For NMDS200-NB
	200
	201	For CPN01-NB
	202
	203	For DS03A-NB
	204
	205	For SN50V3-NB
	206
	207
53.28	208	==== 3.3.3.3 Map fields to sensor value ====
53.2	209
53.10	210
53.2	211	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.
	212
	213
	214	[[image:image-20230802112413-12.png]]
	215
	216	[[image:image-20230802112413-13.png]]
	217
	218
	219	Below is the NB-IoT Product Table show the mapping.
	220
83.4	221	(% border="1" cellspacing="4" style="background-color:#f2f2f2; width:1424px" %)
	222	\|(% 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
	223	\|(% 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" %)
	224	\|(% 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" %)
	225	\|(% 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" %)
	226	\|(% 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" %)
	227	\|(% 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" %)
	228	\|(% 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" %)
	229	\|(% 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" %)
	230	\|(% 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" %)
	231	\|(% 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" %)
	232	\|(% 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" %)
	233	\|(% 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
	234	\|(% 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" %)
	235	\|(% 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" %)
	236	\|(% 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" %)
	237	\|(% 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" %)
	238	\|(% 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" %)
	239	\|(% 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" %)
53.2	240
53.11	241	== 3.4 Datacake ==
53.2	242
81.1	243	=== 3.4.1 Create device ===
53.2	244
83.4	245
78.1	246	[[image:image-20230808162301-1.png]]
53.11	247
	248
78.1	249	[[image:image-20230808162342-2.png]]
	250
	251
	252	[[image:image-20230808162421-3.png]]
	253
83.4	254
81.1	255	The device ID needs to be filled in with IMEI, and a prefix of 'f' needs to be added.
78.1	256
	257	[[image:image-20230808163612-7.png]]
	258
	259	[[image:image-20230808163035-5.png]]
	260
	261	[[image:image-20230808163049-6.png]]
	262
83.4	263
81.1	264	=== 3.4.2 Scan QR code to obtain data ===
	265
83.4	266
81.1	267	Users can use their phones or computers to scan QR codes to obtain device data information.
	268
	269	[[image:image-20230808170051-8.png]]
	270
	271	[[image:image-20230808170548-9.png]]
	272
83.4	273
81.1	274	=== 3.4.2 AT command for connecting to DataCake ===
	275
	276
83.4	277	(% style="color:blue" %)AT+PRO=2,0
81.1	278
83.4	279	(% style="color:blue" %)AT+SERVADDR=67.207.76.90,4445
81.1	280
83.4	281
53.21	282	== 3.5 Node-Red (via MQTT) ==
53.2	283
53.48	284	=== 3.5.1 Configure [[Node-Red>>http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/]] ===
53.2	285
53.32	286
53.2	287	[[image:image-20230802112413-29.png]]
	288
53.32	289
53.2	290	[[image:image-20230802112413-30.png]]
	291
53.24	292
53.21	293	=== 3.5.2 Simulate Connection ===
53.2	294
53.21	295
53.2	296	[[image:image-20230802112413-31.png]]
	297
	298
53.21	299	=== 3.5.3 Configure NB-IoT Sensors ===
53.2	300
	301
53.32	302	* (% style="color:blue" %)AT+PRO=3,0(hex format) or 3,5(json format)(%%) ~/~/ Set to mqtt Server and Payload
53.2	303
53.25	304	* (% style="color:blue" %)AT+CLIENT=any value
53.21	305
53.25	306	* (% style="color:blue" %)AT+UNAME=any value
53.21	307
53.25	308	* (% style="color:blue" %)AT+PWD=any value
53.21	309
53.25	310	* (% style="color:blue" %)AT+PUBTOPIC=any value
53.21	311
53.25	312	* (% style="color:blue" %)AT+SUBTOPIC=any value
53.21	313
	314	== 3.6 ThingsBoard.Cloud (via MQTT) ==
	315
	316	=== 3.6.1 Configure ThingsBoard ===
	317
53.22	318	==== 3.6.1.1 Create Device ====
53.2	319
53.32	320
59.1	321	Create a New Device in [[ThingsBoard>>url:https://thingsboard.cloud/]]. Record Device Name which is used for MQTT connection.
53.2	322
	323	[[image:image-20230802112413-32.png]]
	324
	325
53.23	326	==== 3.6.1.2 Create Uplink & Downlink Converter ====
	327
53.32	328
53.22	329	(% style="color:blue" %)Uplink Converter
53.2	330
	331	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.
	332
53.42	333	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.
53.2	334
53.32	335	[[image:image-20230802112413-33.png\|\|height="732" width="1302"]]
53.2	336
	337
53.22	338	(% style="color:blue" %)Downlink Converter
53.2	339
	340	The Downlink converter transforming outgoing RPC message and then the Integration sends it to external MQTT broke
	341
53.32	342	[[image:image-20230802112413-34.png\|\|height="734" width="1305"]]
53.2	343
53.22	344	(% style="color:red" %)Note:Our device payload is already human readable data. Therefore, users do not need to write decoders. Simply create by default.
53.2	345
53.22	346
53.23	347	==== 3.6.1.3 MQTT Integration Setup ====
53.2	348
	349
53.44	350	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;
53.24	351
53.32	352	[[image:image-20230802112413-35.png\|\|height="738" width="1312"]]
53.2	353
53.32	354
53.2	355	* The next steps is to add the recently created uplink and downlink converters;
	356
53.32	357	[[image:image-20230802112413-36.png\|\|height="736" width="1308"]]
53.2	358
53.32	359	[[image:image-20230802112413-37.png\|\|height="735" width="1307"]]
53.2	360
53.33	361
53.24	362	(% style="color:blue" %)Add a topic filter:
53.2	363
53.44	364	tb/mqtt-integration-tutorial/sensors~/~/temperature ~-~-> Temperature 固定的? 对的。
53.2	365
	366	You can also select an MQTT QoS level. We use MQTT QoS level 0 (At most once) by default;
	367
53.32	368	[[image:image-20230802112413-38.png\|\|height="731" width="1300"]]
53.2	369
	370
53.23	371	=== 3.6.2 Simulate with MQTT.fx ===
	372
53.32	373
53.2	374	[[image:image-20230802112413-39.png]]
	375
	376	[[image:image-20230802112413-40.png]]
	377
	378
53.23	379	=== 3.6.3 Configure NB-IoT Sensor ===
53.2	380
53.25	381
53.23	382	(% style="color:blue" %)AT Commands
53.2	383
59.1	384	* (% style="color:#037691" %)AT+PRO=3,3 (%%) ~/~/ Use MQTT to connect to ThingsBoard. Payload Type set to 3.
53.2	385
83.4	386	* (% style="color:#037691" %)AT+SUBTOPIC=<device name>
	387
59.1	388	* (% style="color:#037691" %)AT+PUBTOPIC=<device name>
83.4	389
59.1	390	* (% style="color:#037691" %)AT+CLIENT=<device name> or User Defined
83.4	391
59.1	392	* (% style="color:#037691" %)AT+UNAME=<device name> or User Defined
83.4	393
59.1	394	* (% style="color:#037691" %)AT+PWD=<device name> or User Defined
53.2	395
	396	Test Uplink by click the button for 1 second
	397
	398	[[image:image-20230802112413-41.png]]
	399
	400	[[image:image-20230802112413-42.png]]
	401
	402	[[image:image-20230802112413-43.png]]
	403
	404
53.23	405	== 3.7 [[Tago.io>>url:https://admin.tago.io/]] (via MQTT) ==
53.2	406
53.23	407	=== 3.7.1 Create device & Get Credentials ===
53.2	408
53.23	409
53.2	410	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.
	411
	412	[[image:image-20230802112413-44.png]]
	413
	414	[[image:image-20230802112413-45.png]]
	415
	416
	417	Go to the Device section and create a device. Then, go to the section tokens and copy your device-token.
	418
	419	[[image:image-20230802112413-46.png]]
	420
	421
70.1	422	The device needs to enable the TLS mode and set the (% style="color:blue" %)AT+TLSMOD=1,0(%%) command.
53.2	423
70.1	424	On the Connection Profile window, set the following information:
	425
53.23	426	* (% style="color:blue" %)Profile Name: “Any name”
53.2	427
53.23	428	* (% style="color:blue" %)Broker Address: mqtt.tago.io
	429
70.1	430	* (% style="color:blue" %)Broker Port: 8883
53.23	431
	432	* (% style="color:blue" %)Client ID: “Any value”
	433
70.1	434	On the section User credentials, set the following information:
53.2	435
70.1	436	* (% style="color:blue" %)User Name: “Any value” (%%) ~/~/ Tago validates your user by the token only
53.2	437
53.34	438	* (% style="color:blue" %)Password: “Your device token”
53.2	439
53.34	440	* (% style="color:blue" %)PUBTOPIC: “Any value”
53.23	441
53.34	442	* (% style="color:blue" %)SUBTOPIC: “Any value”
53.23	443
70.1	444	(% style="color:blue" %)AT command:
	445
83.5	446	* (% style="color:#037691" %)AT+PRO=3,0 or 3,5 (%%) ~/~/ hex format or json format
70.1	447
83.5	448	* (% style="color:#037691" %)AT+SUBTOPIC=<device name>or User Defined
70.1	449
83.5	450	* (% style="color:#037691" %)AT+PUBTOPIC=<device name>or User Defined
	451
	452	* (% style="color:#037691" %)AT+CLIENT=<device name> or User Defined
	453
	454	* (% style="color:#037691" %)AT+UNAME=<device name> or User Defined
	455
	456	* (% style="color:#037691" %)AT+PWD=“Your device token”
	457
	458
	459
	460
53.23	461	=== 3.7.2 Simulate with MQTT.fx ===
	462
70.1	463	[[image:image-20230802112413-52.png]]
53.23	464
53.2	465
70.1	466	[[image:image-20230808105300-2.png]]
53.2	467
53.38	468	Users can run the (% style="color:blue" %)AT+PRO=3,5(%%) command, and the payload will be converted to JSON format.
53.2	469
70.1	470	[[image:image-20230808105217-1.png]]
53.44	471
70.1	472	[[image:image-20230808105329-3.png]]
53.2	473
	474
53.23	475	=== 3.7.3 tago data ===
53.2	476
53.23	477
53.2	478	[[image:image-20230802112413-50.png]]
	479
59.1	480	[[image:image-20230802112413-51.png\|\|height="184" width="696"]]
53.2	481
	482
	483
65.1	484	== 3.8 TCP Connection ==
63.1	485
83.6	486
83.5	487	(% style="color:blue" %)AT command:
63.1	488
83.5	489	* (% style="color:#037691" %)AT+PRO=4,0 (%%) ~/~/ Set to use TCP protocol to uplink(HEX format)
63.1	490
83.5	491	* (% style="color:#037691" %)AT+PRO=4,1 (%%) ~/~/ Set to use TCP protocol to uplink(JSON format)
63.1	492
83.5	493	* (% style="color:#037691" %)AT+SERVADDR=120.24.4.116,5600 (%%) ~/~/ to set TCP server address and port
	494
	495
	496
83.6	497	(% style="color:blue" %)Sensor Console Output when Uplink:
83.5	498
63.1	499	[[image:image-20230807233631-1.png]]
	500
	501
83.6	502	(% style="color:blue" %)See result in TCP Server:
63.1	503
	504	[[image:image-20230807233631-2.png]]
	505
	506
83.4	507

Wiki source code of General Configure/Commands to Connect to IoT server for -NB & -NS NB-IoT models

Applications

Navigation