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

Version 102.2 by Xiaoling on 2023/09/07 16:14

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

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

Applications

Navigation