TCP Connection Instruction

**Table of Contents:**

(% aria-label="macro:toc widget" contenteditable="false" role="region" tabindex="-1" %)

(((

(% 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"]]

)))

= 1. Introduction =

In the TCP IP Client mode, LoRa Gateway can accept LoRa or LoRaWAN packets and send it to the TCP/IP server.

= 2. LoRaWAN Mode TCP Connection =

20

21

== 2.1 Support Hardware ==

22

23

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]]

== 2.2 Typology & Instruction ==

30

31

32

(% aria-label="image-20220527144058-1.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527144058-1.png||data-widget="image"]]

33

34

(% 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" %)

Network Structure

= 3. Raw LoRa Mode TCP Connection =

40

41

== 3.1 Support Hardware ==

42

43

44

* [[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]]

45

* [[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]]

== 3.2 Typology ==

The working topology is as below. In this mode, The Uplink LoRa packets should use a customized format.

53

54

55

(% 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" %)

56

57

TCP/IP Forward working topology

58

59

60

== 3.3 Instruction Before Firmware lgw~-~-build-v5.4.1606631585-20201129-1434 ==

61

62

=== 3.3.1 Select TCP-IP Client mode ===

63

64

65

(% 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" %)

66

67

Select TCP-IP Client mode

68

69

70

=== 3.3.2 Configure the Radio channel ===

71

72

73

(% 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" %)

74

75

Configure the Radio channel with the match radio settings frequency as the LoRa End Node

76

77

78

=== 3.3.3 Configure TCP Server Info ===

79

80

81

(% 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.**

82

83

(% 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" %)

84

85

Configure TCP Server Info

86

87

88

=== 3.3.4 About uplink data format from End Node ===

89

90

91

The LoRa end node should upload the data with below format:

(% class="box" %)

(((

Uplink Format:** (% style="color:#4f81bd" %)<Channel_ID>data(%%)**

96

For example, if we have configured 2 channels 12345 and 34567.

97

And there is are three LoRa End nodes sending: 12345,34567,78

98

The LG02 will accept the data from 12345 and 34567, it will ignore the data from Node 78

99

100

101

(% style="color:blue" %)**Case 1**:(%%)

102

Node 12345 send <12345>field1=0.0&field2=1102.0

103

Node 34567 doesn’t send anyting

104

The TCP/IP server will get {"12345":"field1=0.0&field2=1102.0"}

105

106

107

(% style="color:blue" %)**Case 2**:(%%)

108

Node 12345 send <12345>field1=0.0&field2=1102.0

109

Node 34567 send <34567>temp=34

110

The TCP/IP server will get {"34567":"temp=34","12345":"field1=0.0&field2=1102.0"}

111

)))

112

113

(% 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" %)

114

115

Configure TCP Server Info

116

117

118

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]].

119

120

121

== 3.4 Instruction After Firmware lgw~-~-build~-~-v5.4.1612428704~-~-20210204-1653 ==

122

123

=== 3.4.1 Configure the Radio channel ===

124

125

126

(% aria-label="image-20220527145111-7.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145111-7.png||data-widget="image"]]

127

128

(% title="Click and drag to resize" %)

129

130

Configure the Radio channel with the match radio settings frequency as the LoRa End Node

131

132

133

=== 3.4.2 Configure TCP Server Info ===

134

135

136

(% style="color:red" %)**Note: Gateway will transfer the packet if they arrive in the right format .**

137

138

(% aria-label="image-20220527145151-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145151-8.png||data-widget="image"]]

139

140

(% title="Click and drag to resize" %)

141

142

Configure TCP Server Info

143

144

145

=== 3.4.3 About uplink data format from End Node ===

146

147

148

The LoRa end node should upload the data with below format:

(% class="box" %)

(((

Uplink Format: (% style="color:#4f81bd" %)**<Channel_ID>data**(%%)

153

And there is a LoRa End node sending below packets:

154

*<12345>Hello From Sensor1

)))

(% class="box" %)

(((

LG01/LG02 will uplink 12345:Hello From Sensor1 and usr can use logread -f to check the log.

161

Thu Feb 4 08:21:49 2021 user.notice iot_keep_alive: use WAN or WiFi for internet access now

162

Thu Feb 4 08:21:53 2021 daemon.info tcp_process.sh[18564]: /var/iot/channels/ CREATE 12345

163

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]: Check for sensor update

164

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]: Found Data at Local Channels: 12345

165

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:

166

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:~-~-~-~--

167

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:server: 10.130.2.149

168

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:port: 60000

169

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:decoder: LG01/LG02 Raw Data

170

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:tcp_data: 12345:Hello From Sensor1;

171

Thu Feb 4 08:21:53 2021 user.notice root: [IoT.TCP]:~-~-~-~-~-~-

)))

and TCP server get:

(% 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" %)

TCP Server

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]].

183

184

185

== 3.5 Instruction After Firmware lgw~-~-build-v5.4.1668567157-20221116-1054 ==

186

187

=== 3.5.1 Configure the Frequency Plan ===

188

189

190

[[image:image-20230105114141-1.png||height="539" width="1128"]]

191

192

Configure the Frequency Plan with the match radio settings frequency as the LoRa End Node

193

194

195

=== 3.5.2 Configure TCP Server Info ===

196

197

198

(% style="color:red" %)**Note: Gateway will transfer the packet if they arrive in the right format.**

199

200

(% aria-label="image-20220527145151-8.png image widget" contenteditable="false" role="region" tabindex="-1" %)[[image:image-20220527145151-8.png||data-widget="image"]]

201

202

203

=== 3.5.3 Configure ABP Decryption ===

204

205

206

(% style="color:red" %)**Note: The End Node devices must use ABP join network mode.**

207

208

[[image:image-20230105170545-2.png||height="577" width="1087"]]

209

210

211

=== 3.5.3 About uplink data format from End Node ===

212

213

214

[[image:image-20230105171605-5.png||height="513" width="1084"]]

215

216

217

[[image:image-20230105171235-4.png||height="480" width="523"]]

= 4. Reference =

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]]

Wiki source code of TCP Connection Instruction

Applications

Navigation