Skip to Content

Wiki source code of TCP Connection Instruction

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