Wiki source code of TCP Connection Instruction

Last modified by Xiaoling on 2024/01/22 10:31

version	line-number	content
16.9	1	Table of Contents:
1.1	2
16.12	3	(% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)
	4	(((
	5	(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|height="15" role="presentation" title="Click and drag to move" width="15"]]
	6	)))
16.2	7
16.13	8	{{toc/}}
16.2	9
16.12	10
	11
1.2	12	= 1. Introduction =
1.1	13
16.16	14
1.2	15	In the TCP IP Client mode, LoRa Gateway can accept LoRa or LoRaWAN packets and send it to the TCP/IP server.
1.1	16
	17
1.2	18	= 2. LoRaWAN Mode TCP Connection =
1.1	19
1.2	20	== 2.1 Support Hardware ==
1.1	21
16.16	22
1.2	23	* [[LPS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/148-lps8.html]]
	24	* [[LG308>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/140-lg308.html]], [[DLOS8>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/160-dlos8.html]]
1.1	25
1.2	26	== 2.2 Typology & Instruction ==
1.1	27
16.16	28
25.3	29	(% aria-label="image-20220527144058-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144058-1.png\|\|data-widget="image"]]
1.1	30
25.3	31	(% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
	32
1.2	33	Network Structure
1.1	34
	35
1.2	36	= 3. Raw LoRa Mode TCP Connection =
1.1	37
1.3	38	== 3.1 Support Hardware ==
1.2	39
16.16	40
1.10	41	* [[LG01-N>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/143-lg01n.html]], [[OLG01-N>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/144-olg01n.html]]
	42	* [[LG02>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/135-lg02.html]], [[OLG02>>url:http://www.dragino.com/products/lora-lorawan-gateway/item/136-olg02.html]]
1.2	43
16.11	44	== 3.2 Typology ==
16.10	45
	46
1.2	47	The working topology is as below. In this mode, The Uplink LoRa packets should use a customized format.
	48
	49
16.16	50	(% aria-label="image-20220527144300-2.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144300-2.png\|\|data-widget="image"]](% title="Click and drag to resize" %)
	51
1.2	52	TCP/IP Forward working topology
	53
	54
1.3	55	== 3.3 Instruction Before Firmware lgw~-~-build-v5.4.1606631585-20201129-1434 ==
1.2	56
1.3	57	=== 3.3.1 Select TCP-IP Client mode ===
1.2	58
	59
16.16	60	(% aria-label="image-20220527144723-3.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144723-3.png\|\|data-widget="image"]](% title="Click and drag to resize" %)
	61
1.2	62	Select TCP-IP Client mode
	63
	64
1.3	65	=== 3.3.2 Configure the Radio channel ===
1.2	66
	67
16.16	68	(% aria-label="image-20220527144755-4.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144755-4.png\|\|data-widget="image"]](% title="Click and drag to resize" %)
	69
1.2	70	Configure the Radio channel with the match radio settings frequency as the LoRa End Node
	71
	72
1.3	73	=== 3.3.3 Configure TCP Server Info ===
1.2	74
	75
16.16	76	(% style="color:red" %)Note: Gateway may receive many LoRa packets, it will only transfer the packet with the same ID as specify in the channel.
16.11	77
16.16	78	(% aria-label="image-20220527144837-5.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144837-5.png\|\|data-widget="image"]](% title="Click and drag to resize" %)
1.2	79
	80	Configure TCP Server Info
	81
	82
1.6	83	=== 3.3.4 About uplink data format from End Node ===
1.2	84
16.11	85
1.2	86	The LoRa end node should upload the data with below format:
	87
1.5	88	(% class="box" %)
	89	(((
6.3	90	Uplink Format: (% style="color:#4f81bd" %)<Channel_ID>data(%%)
1.5	91	For example, if we have configured 2 channels 12345 and 34567.
1.2	92	And there is are three LoRa End nodes sending: 12345,34567,78
	93	The LG02 will accept the data from 12345 and 34567, it will ignore the data from Node 78
25.3	94
	95
16.11	96	(% style="color:blue" %)Case 1:(%%)
1.2	97	Node 12345 send <12345>field1=0.0&field2=1102.0
	98	Node 34567 doesn’t send anyting
1.5	99	The TCP/IP server will get {"12345":"field1=0.0&field2=1102.0"}
25.3	100
	101
16.11	102	(% style="color:blue" %)Case 2:(%%)
1.2	103	Node 12345 send <12345>field1=0.0&field2=1102.0
	104	Node 34567 send <34567>temp=34
1.5	105	The TCP/IP server will get {"34567":"temp=34","12345":"field1=0.0&field2=1102.0"}
	106	)))
1.2	107
16.16	108	(% aria-label="image-20220527144959-6.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144959-6.png\|\|data-widget="image"]](% title="Click and drag to resize" %)
1.2	109
	110	Configure TCP Server Info
	111
16.12	112
1.7	113	LoRa End Device reference source code: [[check this link>>url:https://github.com/dragino/Arduino-Profile-Examples/blob/master/libraries/Dragino/examples/IoTServer/ThingSpeak/MQTT_Client/MQTT_DHT11_Client_updata_to_ThingSpeak_/MQTT_DHT11_Client_updata_to_ThingSpeak_.ino]].
1.2	114
	115
1.3	116	== 3.4 Instruction After Firmware lgw~-~-build~-~-v5.4.1612428704~-~-20210204-1653 ==
1.2	117
1.3	118	=== 3.4.1 Configure the Radio channel ===
1.2	119
16.16	120
25.3	121	(% aria-label="image-20220527145111-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145111-7.png\|\|data-widget="image"]]
1.2	122
25.3	123	(% title="Click and drag to resize" %)
	124
1.2	125	Configure the Radio channel with the match radio settings frequency as the LoRa End Node
	126
	127
1.4	128	=== 3.4.2 Configure TCP Server Info ===
1.2	129
16.12	130
16.16	131	(% style="color:red" %)Note: Gateway will transfer the packet if they arrive in the right format .
1.2	132
25.3	133	(% aria-label="image-20220527145151-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145151-8.png\|\|data-widget="image"]]
1.2	134
25.3	135	(% title="Click and drag to resize" %)
	136
1.2	137	Configure TCP Server Info
	138
	139
1.4	140	=== 3.4.3 About uplink data format from End Node ===
1.2	141
16.16	142
1.2	143	The LoRa end node should upload the data with below format:
	144
1.8	145	(% class="box" %)
	146	(((
9.3	147	Uplink Format: (% style="color:#4f81bd" %)<Channel_ID>data(%%)
1.2	148	And there is a LoRa End node sending below packets:
	149	*<12345>Hello From Sensor1
1.8	150	)))
1.2	151
	152
1.8	153	(% class="box" %)
	154	(((
	155	LG01/LG02 will uplink 12345:Hello From Sensor1 and usr can use logread -f to check the log.
	156	Thu Feb 4 08:21:49 2021 user.notice iot_keep_alive: use WAN or WiFi for internet access now
	157	Thu Feb 4 08:21:53 2021 daemon.info tcp_process.sh[18564]: /var/iot/channels/ CREATE 12345
	158	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]: Check for sensor update
	159	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]: Found Data at Local Channels: 12345
	160	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:
	161	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:~-~-~-~--
	162	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:server: 10.130.2.149
	163	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:port: 60000
	164	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:decoder: LG01/LG02 Raw Data
	165	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:tcp_data: 12345:Hello From Sensor1;
	166	Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:~-~-~-~-~-~-
	167	)))
1.2	168
	169
	170	and TCP server get:
	171
16.12	172	(% aria-label="image-20220527145304-9.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145304-9.png\|\|data-widget="image"]](% style="background-image:url(http://wiki.dragino.com/xwiki/webjars/wiki%3Axwiki/application-ckeditor-webjar/1.61/plugins/widget/images/handle.png); background:rgba(220,220,220,0.5); display:none" %)[[image:data:image/gif;base64,R0lGODlhAQABAPABAP///wAAACH5BAEKAAAALAAAAAABAAEAAAICRAEAOw==\|\|draggable="true" height="15" role="presentation" title="Click and drag to move" width="15"]](% title="Click and drag to resize" %)
1.2	173
	174	TCP Server
	175
16.15	176
1.8	177	LoRa End Device reference source code: [[check this link>>url:https://github.com/dragino/Arduino-Profile-Examples/blob/master/libraries/Dragino/examples/IoTServer/ThingSpeak/MQTT_Client/MQTT_DHT11_Client_updata_to_ThingSpeak_/MQTT_DHT11_Client_updata_to_ThingSpeak_.ino]].
1.2	178
1.8	179
22.1	180	== 3.5 Instruction After Firmware lgw~-~-build-v5.4.1668567157-20221116-1054 ==
16.14	181
22.1	182	=== 3.5.1 Configure the Frequency Plan ===
	183
25.2	184
22.1	185	[[image:image-20230105114141-1.png\|\|height="539" width="1128"]]
	186
	187	Configure the Frequency Plan with the match radio settings frequency as the LoRa End Node
	188
	189
	190	=== 3.5.2 Configure TCP Server Info ===
	191
	192
	193	(% style="color:red" %)Note: Gateway will transfer the packet if they arrive in the right format.
	194
	195	(% aria-label="image-20220527145151-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145151-8.png\|\|data-widget="image"]]
	196
	197
	198	=== 3.5.3 Configure ABP Decryption ===
	199
	200
	201	(% style="color:red" %)Note: The End Node devices must use ABP join network mode.
	202
	203	[[image:image-20230105170545-2.png\|\|height="577" width="1087"]]
	204
	205
31.2	206	=== 3.5.4 About uplink data format from End Node ===
22.1	207
	208
25.1	209	[[image:image-20230105171605-5.png\|\|height="513" width="1084"]]
22.1	210
25.2	211
25.1	212	[[image:image-20230105171235-4.png\|\|height="480" width="523"]]
22.1	213
25.2	214
31.2	215	== 3.6 Example: Use TCP in LPS8v2 ==
31.1	216
31.4	217
31.1	218	LPS8v2 includes a local ChirpStack Server and Node-Red. This example shows how to configure LHT65N to use with the local Node-Red server. This example assumes users already have:
	219
	220	* LHT65N register on LPS8v2 Built-In ChirpStack server already
	221	* The user is able to see the data on the built-in ChirpStack server device page.
	222
	223	Below are steps for LPS8v2 to transfer data from a node to the TCP server.
	224
31.4	225
31.1	226	=== 3.6.1 Link Node-Red to Local ChirpStack ===
	227
31.4	228
31.1	229	Users can download the Node-Red decoder from this link and import it into the Node-Red platform:
	230
	231	For more information on importing Input Flow, check out this link: [[Import Input Flow for Dragino Sensors>>url:http://wiki.dragino.com/xwiki/bin/view/Main/Node-RED/#H3.A0ImportInputFlowforDraginoSensors]]
	232
	233	After importing the Input Flow is complete, the user needs to edit the MQTT in the node
	234
	235
	236	~1. Change the Topic
	237
	238	Topic modifies it to the following format:
	239
	240	application/Application ID/device/End device ID/event/up
	241
	242	Reference link: [[Node-RED integration >>url:https://www.chirpstack.io/docs/guides/node-red-integration.html]]
	243
	244	[[image:image-20240122094847-1.png\|\|height="756" width="1232"]]
	245
	246
	247	2. Enter the MQTT configuration information
	248
	249	[[image:image-20240122094930-2.png\|\|height="767" width="1251"]]
	250
	251
	252	3. Click "Update" and Deploy
	253
	254	"Connected" indicates that the Link Node-red to Local Chirpstack is normal.
	255
	256	[[image:image-20240122095122-3.png\|\|height="765" width="1247"]]
	257
	258
	259	4. Connect to the TCP server
	260
	261	[[image:image-20240122095313-4.png\|\|height="767" width="1250"]]
	262
	263
	264	5. Finally, check the data
	265
	266	[[image:image-20240122095424-5.png\|\|height="779" width="1269"]]
	267
	268
1.4	269	= 4. Reference =
1.2	270
16.16	271
1.2	272	Set up a TCP/IP server use node.js: [[Reference Link>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LG02-OLG02/Firmware/customized_script/&file=node_tcp_server.txt]]
25.2	273
	274
31.2	275

Wiki source code of TCP Connection Instruction

Applications

Navigation