Wiki source code of TCP Connection Instruction
Last modified by Xiaoling on 2024/01/22 10:31
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | **Table of Contents:** | ||
2 | |||
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 | ))) | ||
7 | |||
8 | {{toc/}} | ||
9 | |||
10 | |||
11 | |||
12 | = 1. Introduction = | ||
13 | |||
14 | |||
15 | In the TCP IP Client mode, LoRa Gateway can accept LoRa or LoRaWAN packets and send it to the TCP/IP server. | ||
16 | |||
17 | |||
18 | = 2. LoRaWAN Mode TCP Connection = | ||
19 | |||
20 | == 2.1 Support Hardware == | ||
21 | |||
22 | |||
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]] | ||
25 | |||
26 | == 2.2 Typology & Instruction == | ||
27 | |||
28 | |||
29 | (% aria-label="image-20220527144058-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144058-1.png||data-widget="image"]] | ||
30 | |||
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 | |||
33 | Network Structure | ||
34 | |||
35 | |||
36 | = 3. Raw LoRa Mode TCP Connection = | ||
37 | |||
38 | == 3.1 Support Hardware == | ||
39 | |||
40 | |||
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]] | ||
43 | |||
44 | == 3.2 Typology == | ||
45 | |||
46 | |||
47 | The working topology is as below. In this mode, The Uplink LoRa packets should use a customized format. | ||
48 | |||
49 | |||
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 | |||
52 | TCP/IP Forward working topology | ||
53 | |||
54 | |||
55 | == 3.3 Instruction Before Firmware lgw~-~-build-v5.4.1606631585-20201129-1434 == | ||
56 | |||
57 | === 3.3.1 Select TCP-IP Client mode === | ||
58 | |||
59 | |||
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 | |||
62 | Select TCP-IP Client mode | ||
63 | |||
64 | |||
65 | === 3.3.2 Configure the Radio channel === | ||
66 | |||
67 | |||
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 | |||
70 | Configure the Radio channel with the match radio settings frequency as the LoRa End Node | ||
71 | |||
72 | |||
73 | === 3.3.3 Configure TCP Server Info === | ||
74 | |||
75 | |||
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.** | ||
77 | |||
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" %) | ||
79 | |||
80 | Configure TCP Server Info | ||
81 | |||
82 | |||
83 | === 3.3.4 About uplink data format from End Node === | ||
84 | |||
85 | |||
86 | The LoRa end node should upload the data with below format: | ||
87 | |||
88 | (% class="box" %) | ||
89 | ((( | ||
90 | Uplink Format:** (% style="color:#4f81bd" %)<Channel_ID>data(%%)** | ||
91 | For example, if we have configured 2 channels 12345 and 34567. | ||
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 | ||
94 | |||
95 | |||
96 | (% style="color:blue" %)**Case 1**:(%%) | ||
97 | Node 12345 send <12345>field1=0.0&field2=1102.0 | ||
98 | Node 34567 doesn’t send anyting | ||
99 | The TCP/IP server will get {"12345":"field1=0.0&field2=1102.0"} | ||
100 | |||
101 | |||
102 | (% style="color:blue" %)**Case 2**:(%%) | ||
103 | Node 12345 send <12345>field1=0.0&field2=1102.0 | ||
104 | Node 34567 send <34567>temp=34 | ||
105 | The TCP/IP server will get {"34567":"temp=34","12345":"field1=0.0&field2=1102.0"} | ||
106 | ))) | ||
107 | |||
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" %) | ||
109 | |||
110 | Configure TCP Server Info | ||
111 | |||
112 | |||
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]]. | ||
114 | |||
115 | |||
116 | == 3.4 Instruction After Firmware lgw~-~-build~-~-v5.4.1612428704~-~-20210204-1653 == | ||
117 | |||
118 | === 3.4.1 Configure the Radio channel === | ||
119 | |||
120 | |||
121 | (% aria-label="image-20220527145111-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145111-7.png||data-widget="image"]] | ||
122 | |||
123 | (% title="Click and drag to resize" %) | ||
124 | |||
125 | Configure the Radio channel with the match radio settings frequency as the LoRa End Node | ||
126 | |||
127 | |||
128 | === 3.4.2 Configure TCP Server Info === | ||
129 | |||
130 | |||
131 | (% style="color:red" %)**Note: Gateway will transfer the packet if they arrive in the right format .** | ||
132 | |||
133 | (% aria-label="image-20220527145151-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145151-8.png||data-widget="image"]] | ||
134 | |||
135 | (% title="Click and drag to resize" %) | ||
136 | |||
137 | Configure TCP Server Info | ||
138 | |||
139 | |||
140 | === 3.4.3 About uplink data format from End Node === | ||
141 | |||
142 | |||
143 | The LoRa end node should upload the data with below format: | ||
144 | |||
145 | (% class="box" %) | ||
146 | ((( | ||
147 | Uplink Format: (% style="color:#4f81bd" %)**<Channel_ID>data**(%%) | ||
148 | And there is a LoRa End node sending below packets: | ||
149 | *<12345>Hello From Sensor1 | ||
150 | ))) | ||
151 | |||
152 | |||
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 | ))) | ||
168 | |||
169 | |||
170 | and TCP server get: | ||
171 | |||
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" %) | ||
173 | |||
174 | TCP Server | ||
175 | |||
176 | |||
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]]. | ||
178 | |||
179 | |||
180 | == 3.5 Instruction After Firmware lgw~-~-build-v5.4.1668567157-20221116-1054 == | ||
181 | |||
182 | === 3.5.1 Configure the Frequency Plan === | ||
183 | |||
184 | |||
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 | |||
206 | === 3.5.4 About uplink data format from End Node === | ||
207 | |||
208 | |||
209 | [[image:image-20230105171605-5.png||height="513" width="1084"]] | ||
210 | |||
211 | |||
212 | [[image:image-20230105171235-4.png||height="480" width="523"]] | ||
213 | |||
214 | |||
215 | == 3.6 Example: Use TCP in LPS8v2 == | ||
216 | |||
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 | |||
226 | === 3.6.1 Link Node-Red to Local ChirpStack === | ||
227 | |||
228 | |||
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 | |||
269 | = 4. Reference = | ||
270 | |||
271 | |||
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]] | ||
273 | |||
274 | |||
275 |