Last modified by Hera Guo on 2025/09/25 09:23
From version 20.1
edited by Hera Guo
on 2025/02/18 09:14
Change comment: There is no comment for this version
To version 22.1
edited by Hera Guo
on 2025/09/25 09:10
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -7,8 +7,9 @@
7 7  
8 8  = 1. Overview =
9 9  
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.
10 +This instructions will show you how to connect a device that has been registered to the server to the Thingseye platform.
11 11  
12 +
12 12  = 2. UDP Procotol  ~-~- Directly Connection =
13 13  
14 14  == 2.1 UDP Interface ==
... ... @@ -20,26 +20,15 @@
20 20  
21 21  Please contact ThingsEye team for detail how to forward data to client.
22 22  
23 -== 2.2 Test UDP Interface via Socket Tool ==
24 +**Note：Currently udp connections require port forwarding, please contact the ThingsEye team to inform them of your device's IMEI before connecting.**
24 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 26  
27 -[[image:1728566363151-470.png]]
27 +----
28 28  
29 -In server side, Tenant Administrator can check this in Tenant UDP Server location.
29 +== 2.2 Test with Dragino NB device ==
30 30  
31 -[[image:1728362834430-749.png||height="510" width="1667"]]
31 +=== 2.2.1 Configure NB-IoT End Node ===
32 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 -
39 -== 2.3 Test with Dragino NB device ==
40 -
41 -=== 2.3.1 Configure NB-IoT End Node ===
42 -
43 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 44  
45 45  * Set to use ThingsEye UDP server: **AT+SERVADDR=server1.thingseye.io,11560**
... ... @@ -48,19 +48,30 @@
48 48  
49 49  The S31-NB's cellular module has the IMEI: **863663062789483**
50 50  
51 -=== 2.3.2 Check Uplink Data ===
41 +=== 2.2.2 Check Uplink Data ===
52 52  
43 +Turn on debug mod
44 +
45 +[[image:1758762334133-608.png||height="494" width="1003"]]
46 +
47 +----
48 +
53 53  Re-activate the S31-NB, and we can see it in the debug window:
54 54  
55 -[[image:1728378218744-800.png||height="431" width="1003"]]
51 +[[image:1758762371290-726.png||height="528" width="1005"]]
56 56  
53 +[[image:1728378218744-800.png||_mstalt="295269" height="431" width="1003"]]
54 +
55 +
56 +----
57 +
57 57  === 2.3.3 Auto-Create Device ===
58 58  
59 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 60  
61 -[[image:1728378968101-683.png||height="273" width="1307"]]
62 +[[image:1728378968101-683.png||_mstalt="297154" height="210" width="1005"]]
62 62  
63 -[[image:1728379050044-764.png||height="424" width="1312"]]
64 +[[image:1728379050044-764.png||_mstalt="295282" height="326" width="1009"]]
64 64  
65 65  
66 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.**
... ... @@ -71,7 +71,7 @@
71 71  
72 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.
73 73  
74 -[[image:1732679444539-853.jpg||height="388" width="1452"]]
75 +[[image:1732679444539-853.jpg||_mstalt="296933" height="388" width="1452"]]
75 75  
76 76  == 3.2 Creat Integration for The Things Stack. ==
77 77  
... ... @@ -78,19 +78,19 @@
78 78  (% class="lead" %)
79 79  Add Integration
80 80  
81 -[[image:1728535775119-971.png||height="456" width="1087"]]
82 +[[image:1728535775119-971.png||_mstalt="297661" height="456" width="1087"]]
82 82  
83 83  
84 84  (% class="lead" %)
85 85  Choose Connection Type
86 86  
87 -[[image:1728535857345-950.png]]
88 +[[image:1728535857345-950.png||_mstalt="297154"]]
88 88  
89 89  
90 90  (% class="lead" %)
91 91  Input Uplink Data Converter Code
92 92  
93 -[[image:1728535941851-388.png||height="466" width="398"]]
94 +[[image:1728535941851-388.png||_mstalt="297856" height="466" width="398"]]
94 94  
95 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]]
96 96  
... ... @@ -98,7 +98,7 @@
98 98  (% class="lead" %)
99 99  Input Downlink Converter
100 100  
101 -[[image:1728536142721-488.png||height="470" width="407"]]
102 +[[image:1728536142721-488.png||_mstalt="296127" height="470" width="407"]]
102 102  
103 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]]
104 104  
... ... @@ -106,7 +106,7 @@
106 106  (% class="lead" %)
107 107  Set up Connection to The Things Network application
108 108  
109 -[[image:1728536305503-380.png||height="510" width="1206"]]
110 +[[image:1728536305503-380.png||_mstalt="293254" height="510" width="1206"]]
110 110  
111 111  
112 112  
... ... @@ -113,11 +113,11 @@
113 113  (% class="lead" %)
114 114  Test Connection & Add iIntegration
115 115  
116 -[[image:1728536374214-962.png]]
117 +[[image:1728536374214-962.png||_mstalt="295893"]]
117 117  
118 118  After add , we can see the integration here:
119 119  
120 -[[image:1728536420275-153.png||height="208" width="1404"]]
121 +[[image:1728536420275-153.png||_mstalt="293748" height="208" width="1404"]]
121 121  
122 122  
123 123  == 3.3 Test Uplink ==
... ... @@ -124,10 +124,10 @@
124 124  
125 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 126  
127 -[[image:1728536524638-768.png||height="493" width="1071"]]
128 +[[image:1728536524638-768.png||_mstalt="298870" height="493" width="1071"]]
128 128  
129 129  
130 -[[image:1728536541040-814.png]]
131 +[[image:1728536541040-814.png||_mstalt="293215"]]
131 131  
132 132  = 4.Connect chirpstack to Thingseye by way of MQTT =
133 133  
... ... @@ -137,19 +137,19 @@
137 137  
138 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 139  
140 -[[image:1732679647697-982.jpg||height="399" width="1492"]]
141 +[[image:1732679647697-982.jpg||_mstalt="299884" height="399" width="1492"]]
141 141  
142 142  == 4.2 Thingseye adds MQTT integration ==
143 143  
144 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 145  
146 -[[image:图片1.png]]
147 +[[image:1758762634175-353.png]]
147 147  
148 148  == 4.3 Add an uplink and downlink data converter ==
149 149  
150 150  In the function decoder field, specify the script to parse and transform the data.
151 151  
152 -[[image:图片2.png]]
153 +[[image:图片2.png||_mstalt="5131503"]]
153 153  
154 154  * **Uplink——JavaScript：**
155 155  
... ... @@ -231,7 +231,7 @@
231 231  
232 232  return result;
233 233  
234 -[[image:图片3.png]]
235 +[[image:图片3.png||_mstalt="5131620"]]
235 235  
236 236  * **Dowblink——JavaScript：**
237 237  
... ... @@ -289,9 +289,9 @@
289 289  
290 290  They correspond to the CA certificate file, Certificate file, and Private key file on thingseye
291 291  
292 -[[image:图片4.png]]
293 +[[image:图片4.png||_mstalt="5131737"]]
293 293  
294 -[[image:图片5.png||height="630" width="1269"]]
295 +[[image:图片5.png||_mstalt="5131854" height="630" width="1269"]]
295 295  
296 296  * Copy the contents of the certificates and paste them into the linked file below, a total of three certificates are required
297 297  
... ... @@ -307,28 +307,28 @@
307 307  
308 308  Upload the certificate and key file
309 309  
310 -[[image:图片6.png]]
311 +[[image:图片6.png||_mstalt="5131971"]]
311 311  
312 -[[image:图片7.png]]
313 +[[image:图片7.png||_mstalt="5132088"]]
313 313  
314 314  The default for Topic is:
315 315  
316 316  application/**chirpstack application id**/device/+/event/up
317 317  
318 -[[image:图片8.png]]
319 +[[image:图片8.png||_mstalt="5132205"]]
319 319  
320 320  
321 321  (% class="wikigeneratedid" %)
322 -[[image:屏幕截图 2024-11-25 095805.png||height="374" width="1272"]]
323 +[[image:屏幕截图 2024-11-25 095805.png||_mstalt="10831028" height="374" width="1272"]]
323 323  
324 324  == 4.5 Check the connection ==
325 325  
326 -[[image:图片9.png]]
327 +[[image:图片9.png||_mstalt="5132322"]]
327 327  
328 -[[image:图片10.png]]
329 +[[image:图片10.png||_mstalt="5142449"]]
329 329  
330 330  = 5. Check Data Uplink Log =
331 331  
332 332  User can check the devices log in Intergration.
333 333  
334 -[[image:1729562069134-315.png||height="587" width="723"]]
335 +[[image:1729562069134-315.png||_mstalt="294190" height="587" width="723"]]
1758762334133-608.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hera
Size
... ... @@ -1,0 +1,1 @@
1 +161.4 KB
Content
1758762371290-726.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hera
Size
... ... @@ -1,0 +1,1 @@
1 +215.2 KB
Content
1758762634175-353.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.hera
Size
... ... @@ -1,0 +1,1 @@
1 +213.8 KB
Content