Wiki source code of Connect Devices to ThingsEye

Version 18.1 by Hera Guo on 2024/11/27 11:54
Hide last authors
Chxy 1.1 1
2
Chxy 2.1 3 **Table of Contents:**
Chxy 1.1 4
Chxy 2.1 5 {{toc/}}
Chxy 1.1 6
Chxy 2.1 7
Chxy 3.1 8 = 1. Overview =
9
Hera Guo 17.1 10 The instructions in this chapter will show you how to connect a device that has been registered to the server to the Thingseye platform.
Chxy 3.1 11
Chxy 2.1 12 = 2. UDP Procotol  ~-~- Directly Connection =
13
14 == 2.1 UDP Interface ==
15
Chxy 1.1 16 * Server Address: server1.thingseye.io
Chxy 9.1 17 * Port: 11562
Chxy 1.1 18
19 The data sent to above UDP interface will not go directly to client's database.
20
21 Please contact ThingsEye team for detail how to forward data to client.
22
Chxy 2.1 23 == 2.2 Test UDP Interface via Socket Tool ==
Chxy 1.1 24
25 Download the UDP Test Tool from:  [[https:~~/~~/sourceforge.net/projects/sockettest/ >>https://sourceforge.net/projects/sockettest/]]. Run this tool, and input the server address and UDP port  as below and click send.
26
Chxy 9.1 27 [[image:1728566363151-470.png]]
Chxy 1.1 28
29 In server side, Tenant Administrator can check this in Tenant UDP Server location.
30
31 [[image:1728362834430-749.png||height="510" width="1667"]]
32
33 Click and see the debug info as below:
34
35 [[image:1728363020699-203.png]]
36
37 We can see the message arrives, but it shows ERROR because the message doesn't follow with the UDP Server format.
38
Chxy 5.1 39 == 2.3 Test with Dragino NB device ==
Chxy 1.1 40
Chxy 4.1 41 === 2.3.1 Configure NB-IoT End Node ===
42
43 Device here is **[[S31-NB>>https://www.dragino.com/products/temperature-humidity-sensor/item/288-s31-nb-s31b-nb.html]]** : and have been configure below
44
Chxy 12.1 45 * Set to use ThingsEye UDP server: **AT+SERVADDR=server1.thingseye.io,11562**
Chxy 8.1 46 * Use UDP Uplink & Json protocol:** AT+PRO=2,5**
Chxy 4.1 47 * Equip with a NB-IoT SIM Card to access to NB-IoT Network.
48
49 The S31-NB's cellular module has the IMEI: **863663062789483**
50
51 === 2.3.2 Check Uplink Data ===
52
53 Re-activate the S31-NB, and we can see it in the debug window:
54
55 [[image:1728378218744-800.png||height="431" width="1003"]]
56
57 === 2.3.3 Auto-Create Device ===
58
59 The default **Tenant UDP Server** has already been configured to decode the Dragino -NB / -CB NB-IoT node. So once each end node sends a data to server. Tenant will auto create the device in the server.
60
61 [[image:1728378968101-683.png||height="273" width="1307"]]
62
63 [[image:1728379050044-764.png||height="424" width="1312"]]
64
65
Chxy 6.1 66 **So we have this device in the Tenant Device List. The next step will be how to use these value to make a nice dashboard for user's application.**
Chxy 4.1 67
Chxy 10.1 68 = 3.  Connect to The Things Stack =
Chxy 8.1 69
Chxy 10.1 70 == 3.1 Network Structure ==
Chxy 8.1 71
Hera Guo 18.1 72 The network diagram below illustrates the connection between the devices and The Things Stack, as well as how the data can be integrated with the ThingsEye IoT platform.
Chxy 8.1 73
Hera Guo 18.1 74 [[image:1732679444539-853.jpg||height="388" width="1452"]]
75
Chxy 10.1 76 == 3.2 Creat Integration for The Things Stack. ==
Chxy 8.1 77
78 (% class="lead" %)
79 Add Integration
80
81 [[image:1728535775119-971.png||height="456" width="1087"]]
82
83
84 (% class="lead" %)
85 Choose Connection Type
86
87 [[image:1728535857345-950.png]]
88
89
90 (% class="lead" %)
91 Input Uplink Data Converter Code
92
93 [[image:1728535941851-388.png||height="466" width="398"]]
94
Chxy 11.1 95 Demo JavaScript Code: [[https:~~/~~/raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js >>https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Uplink_Converter.js]]
Chxy 8.1 96
97
98 (% class="lead" %)
99 Input Downlink Converter
100
101 [[image:1728536142721-488.png||height="470" width="407"]]
102
Chxy 11.1 103 Example Javascript Code as below: [[https:~~/~~/raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js>>https://raw.githubusercontent.com/ThingsEye-io/te-platform/refs/heads/main/Data%20Converters/The_Things_Network_MQTT_Downlink_Converter.js]]
Chxy 8.1 104
105
106 (% class="lead" %)
107 Set up Connection to The Things Network application
108
109 [[image:1728536305503-380.png||height="510" width="1206"]]
110
111
112
113 (% class="lead" %)
114 Test Connection & Add iIntegration
115
116 [[image:1728536374214-962.png]]
117
118 After add , we can see the integration here:
119
120 [[image:1728536420275-153.png||height="208" width="1404"]]
121
122
Chxy 10.1 123 == 3.3 Test Uplink ==
Chxy 8.1 124
125 We can use Simulate Uplink to simulate an uplink in the things stack. Then we should be able to see the message in ThingsEye
126
127 [[image:1728536524638-768.png||height="493" width="1071"]]
128
129
130 [[image:1728536541040-814.png]]
Chxy 13.1 131
Hera Guo 15.1 132 = 4.Connect chirpstack to Thingseye by way of MQTT =
Chxy 13.1 133
Hera Guo 15.1 134 * **How to connect chirpstack to Thingseye by way of MQTT? The following tutorial will show you**
Chxy 13.1 135
Hera Guo 18.1 136 == 4.1 Network Structure ==
Chxy 13.1 137
Hera Guo 18.1 138 The network diagram below illustrates the connection between the devices andchirpstack, as well as how the data can be integrated with the ThingsEye IoT platform.
139
140 [[image:1732679647697-982.jpg||height="399" width="1492"]]
141
142 == 4.2 Thingseye adds MQTT integration ==
143
Hera Guo 15.1 144 Go to the Integrations page in the Integrations center section. Click the plus button to start adding a new integration. Select the type "MQTT" integration and click "Next";
145
Hera Guo 16.1 146 [[image:图片1.png]]
Hera Guo 15.1 147
Hera Guo 18.1 148 == 4.3 Add an uplink and downlink data converter ==
Hera Guo 15.1 149
150 In the function decoder field, specify the script to parse and transform the data.
151
Hera Guo 16.1 152 [[image:图片2.png]]
Hera Guo 15.1 153
154 * **Uplink——JavaScript：**
155
156 var data = decodeToJson(payload);
157
158 var deviceName = data.deviceInfo.deviceName;
159
160 var deviceType = data.applicationName;
161
162 var devEui = data.deviceInfo.devEui
163
164 var label = data.deviceInfo.devEui
165
166 var model = {};
167
168 var data2 = data.object;
169
170 var flg = data.fPort
171
172 for (var key in data2) {
173
174 ~/~/ 将属性名存入新对象中
175
176 model[key] = data2[key];
177
178 }
179
180 ~/~/var obj = {"devid":deviceName}
181
182 var result = {
183
184 deviceName: deviceName,
185
186 deviceType: deviceType,
187
188 telemetry: model,
189
190 groupName: "Case Study",
191
192 ~/~/label:label,
193
194 attributes:{"devEui":devEui,
195
196 ~/~/"timevalue":"test",
197
198 "inactivityTimeout":1260000
199
200 ~/~/ "High_humidity_alarm":"not set",
201
202 ~/~/ "High_temperature_alarm":"not set",
203
204 ~/~/ "Low_humidity_alarm":"not set",
205
206 ~/~/ "Low_temperature_alarm":"not set",
207
208 ~/~/ "Low_voltage_alarm":"not set"
209
210 ~/~/"customerName": "Civionic Engineering & Consulting (2014) Inc."
211
212 }
213
214 };
215
216 function decodeToString(payload) {
217
218 return String.fromCharCode.apply(String, payload);
219
220 }
221
222 function decodeToJson(payload) {
223
224 var str = decodeToString(payload);
225
226 var data = JSON.parse(str);
227
228 return data;
229
230 }
231
232 return result;
233
Hera Guo 16.1 234 [[image:图片3.png]]
Hera Guo 15.1 235
236 * **Dowblink——JavaScript：**
237
238 ~/~/ Encode downlink data from incoming Rule Engine message
239
240 ~/~/ msg - JSON message payload downlink message json
241
242 ~/~/ msgType - type of message, for ex. 'ATTRIBUTES_UPDATED', 'POST_TELEMETRY_REQUEST', etc.
243
244 ~/~/ metadata - list of key-value pairs with additional data about the message
245
246 ~/~/ integrationMetadata - list of key-value pairs with additional data defined in Integration executing this converter
247
248 ~/~/ /~*~* Encoder ~*~*/
249
250 ~/~/var data = {"value":99};
251
252 ~/~/ ~/~/ Process data from incoming message and metadata
253
254 ~/~/ data.tempFreq = msg.temperatureUploadFrequency;
255
256 ~/~/ data.humFreq = msg.humidityUploadFrequency;
257
258 ~/~/ data.devSerialNumber = metadata['ss_serialNumber'];
259
260 ~/~/ ~/~/ Result object with encoded downlink payload
261
262 var result = {
263
264 ~/~/ downlink data content type: JSON, TEXT or BINARY (base64 format)
265
266 contentType: "TEXT",
267
268 ~/~/ downlink data
269
270 data: msg.shared_value ,~/~/JSON.stringify(data),
271
272 ~/~/ Optional metadata object presented in key/value format
273
274 metadata: {
275
276 topic: '/test/down/'+metadata.deviceName
277
278 }
279
280 };
281
282 return result;
283
Hera Guo 18.1 284 == 4.4 Configure the connection ==
Hera Guo 15.1 285
286 Generate MQTT certificate integrated on chirpstack
287
288 Chirpstack generates CA certificate, TLS certificate, and TLS key respectively
289
290 They correspond to the CA certificate file, Certificate file, and Private key file on thingseye
291
Hera Guo 16.1 292 [[image:图片4.png]]
Hera Guo 15.1 293
Hera Guo 16.1 294 [[image:图片5.png||height="630" width="1269"]]
Hera Guo 15.1 295
296 * Copy the contents of the certificates and paste them into the linked file below, a total of three certificates are required
297
298 **Integrated Certificate File demo Download Address：**
299
300 [[https:~~/~~/github.com/ThingsEye-io/te-platform/tree/main/chirpstack>>https://github.com/ThingsEye-io/te-platform/tree/main/chirpstack]]
301
302 Enter the server address Host: lns1.thingseye.io on the Connection configuration
303
304 Port: 8883
305
306 Credentials type: PEM
307
308 Upload the certificate and key file
309
Hera Guo 16.1 310 [[image:图片6.png]]
Hera Guo 15.1 311
Hera Guo 16.1 312 [[image:图片7.png]]
Hera Guo 15.1 313
314 The default for Topic is:
315
316 application/**chirpstack application id**/device/+/event/up
317
Hera Guo 16.1 318 [[image:图片8.png]]
Hera Guo 15.1 319
320
Hera Guo 16.1 321 (% class="wikigeneratedid" %)
322 [[image:屏幕截图 2024-11-25 095805.png||height="374" width="1272"]]
323
Hera Guo 18.1 324 == 4.5 Check the connection ==
Hera Guo 15.1 325
Hera Guo 16.1 326 [[image:图片9.png]]
Hera Guo 15.1 327
Hera Guo 16.1 328 [[image:图片10.png]]
Hera Guo 15.1 329
330 = 5. Check Data Uplink Log =
331
Chxy 13.1 332 User can check the devices log in Intergration.
333
334 [[image:1729562069134-315.png||height="587" width="723"]]