Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -7,247 +7,4 @@
7	7
8	8	This document guides you on integrating Dragino -NB and -CB series devices with ThingsBoard. For this guide, we use ThingsBoard Cloud, which is one of the ThingsBoard versions that allows you to try it for free.
9	9
10		-
11		-= Add New Device =
12		-
13		-In the left navigation, click **Entities** and then click **Devices**.
14		-
15		-
16		-[[image:ThingsBoard-Device.png]]
17		-
18		-
19		-On the ‘**Devices**’ page, click on the ‘**+**’ button, and then click on the ‘**Add new device**’ from the dropdown menu.
20		-
21		-
22		-[[image:ThingsBoard-add-new-device.png||height="279" width="500"]]
23		-
24		-
25		-
26		-= Data Converters =
27		-
28		-
29		-== Uplink ==
30		-
31		-In the left navigation, click ‘Integrations center’, and then click ‘Data converters’.
32		-
33		-
34		-[[image:ThingsBoard-Data-Converters.png]]
35		-
36		-
37		-On the ‘Data converters’ page, click on the ‘+’ button, and then click on the ‘Create new converter’ from the dropdown menu.
38		-
39		-
40		-[[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
41		-
42		-
43		-The ‘Add data converter’ window will appear. Name it ‘**UDP Uplink Converter NB/CB**’ and select the Type as ‘Uplink’.
44		-
45		-Click on the ‘JavaScript’ button. Now copy and paste the following script to the ‘Decoder function’ section:
46		-
47		-{{code language="JavaScript"}}
48		-//Version: 0.1
49		-// decode payload to string
50		-var payloadStr = decodeToString(payload);
51		-
52		-// decode payload to JSON
53		-var objdata = {};
54		-var obj1 = {};
55		-var data = decodeToJson(payload);
56		-var deviceName = data.IMEI;
57		-delete data.IMEI;
58		-var modelname = "Dragino " + data.Model;
59		-//var mod = data.mod
60		-delete data.Model;
61		-//delete data.mod
62		-var timestamp = new Date().getTime();
63		-
64		-for (var key in data) {
65		-
66		- if (Number(key)) {
67		- obj1[key] = data[key];
68		- obj1[key][obj1[key].length - 1] = Number(new Date(
69		- obj1[key][obj1[key].length - 1]));
70		-
71		- }
72		-//Alec submitted25/02/25
73		-//turn old key into new
74		- else if (key === "Reading") {
75		- objdata["reading"] = data[key];
76		- } else if (key === "work mode") {
77		- objdata["work_mode"] = data[key];
78		- } else if (key === "hum") {
79		- objdata["humidity"] = data[key];
80		- }else if (key === "hum2") {
81		- objdata["humidity2"] = data[key];
82		- } else if (key === "hum3") {
83		- objdata["humidity3"] = data[key];
84		- } else if (key === "tem") {
85		- objdata["temperature"] = data[key];
86		- } else if (key === "tem2") {
87		- objdata["temperature2"] = data[key];
88		- } else if (key === "tem3") {
89		- objdata["temperature3"] = data[key];
90		- } else if (key === "DS18B20_Temp") {
91		- objdata["temperature_pro"] = data[key];
92		- } else if (key === "ds18b20_temperature") {
93		- objdata["temperature_pro"] = data[key];
94		- } else if (key === "DS18B20_temperature_pro") {
95		- objdata["temperature_pro"] = data[key];
96		- } else if (key === "tdc send flag") {
97		- objdata["tdc_send_flag"] = data[key];
98		- } else if (key === "trigger mode") {
99		- objdata["trigger_mode"] = data[key];
100		- } else if (key === "soil dielectric constant") {
101		- objdata["soil_dielectric_constant"] = data[key];
102		- } else if (key === "door open num") {
103		- objdata["door_open_num"] = data[key];
104		- } else if (key === "door duration") {
105		- objdata["door_duration"] = data[key];
106		- } else if (key === "count time") {
107		- objdata["count_time"] = data[key];
108		- } else if (key === "last open time2") {
109		- objdata["last_open_time2"] = data[key];
110		- } else if (key === "last open time3") {
111		- objdata["last_open_time3"] = data[key];
112		- }
113		-//Alec submitted25/02/25
114		- else {
115		- objdata[key] = data[key]
116		- }
117		-}
118		-var listdata = [{
119		- "ts": timestamp,
120		- "values": objdata
121		-}]
122		-for (var key1 in obj1) {
123		- if (modelname == "Dragino RS485-NB") {
124		- listdata.push({
125		- "ts": obj1[key1][obj1[key1].length - 1],
126		- "values": {
127		- "Payload": obj1[key1][0],
128		- }
129		- })
130		- } else {
131		- listdata.push({
132		- "ts": obj1[key1][obj1[key1].length - 1],
133		- "values": {
134		- "values": obj1[key1]
135		- },
136		- })
137		- }
138		-}
139		-var result = {
140		-
141		- deviceName: deviceName,
142		- deviceType: modelname,
143		- attributes: {
144		- model: modelname,
145		- //customerName: "NB-CB",
146		- //groupName: "NB-CB",
147		- //integrationName: metadata['integrationName']
148		-
149		- },
150		- telemetry: listdata
151		-}
152		-
153		-function decodeToString(payload) {
154		- return String.fromCharCode.apply(String, payload);
155		-}
156		-
157		-function decodeToJson(payload) {
158		- // covert payload to string.
159		- var str = decodeToString(payload);
160		-
161		- // parse string to JSON
162		- var data = JSON.parse(str);
163		- return data;
164		-}
165		-
166		-return result;
167		-
168		-{{/code}}
169		-
170		-Click on the ‘Add’ button.
171		-
172		-
173		-[[image:ThingsBoard-add-data-converter-uplink.png||width="500"]]
174		-
175		-
176		-The uplink data converter is added to ThingsBoard and appears on the ‘Data Converters’ page
177		-
178		-
179		-== Downlink ==
180		-
181		-On the ‘Data converters’ page, click on the ‘+’ button, and then click on the ‘Create new converter’ from the dropdown menu.
182		-
183		-
184		-[[image:ThingsBoard-new-data-converter.png||height="282" width="500"]]
185		-
186		-
187		-The ‘**Add data converter**’ window will appear. Name it ‘**UDP Downlink Converter NB/CB**’ and select the Type as ‘**Downlink**’.
188		-
189		-Click on the ‘**JavaScript**’ button. Now copy and paste the following script to the ‘**Encoder function**’ section:
190		-
191		-
192		-{{code language="JavaScript"}}
193		-function hexToBase64(hexString) {
194		- // 将16进制字符串两个字符转换为一个字节
195		- var bytes = hexString.match(/.{2}/g);
196		- // 对每个字节进行解析，并转换为对应的字符
197		- var binaryString = bytes.map(function(byte) {
198		- return String.fromCharCode(parseInt(byte, 16));
199		- }).join('');
200	200
201		- // 使用btoa进行base64编码
202		- return btoa(binaryString);
203		-}
204		-
205		-// Result object with encoded downlink payload
206		-var result = {
207		- // downlink data content type: JSON, TEXT or BINARY (base64 format)
208		- contentType: "BINARY",
209		-
210		- // downlink data
211		- data:hexToBase64(metadata.shared_value)
212		-
213		- // Optional metadata object presented in key/value format
214		- //metadata: {}
215		-
216		-};
217		-
218		-return result;
219		-{{/code}}
220		-
221		-
222		-Click on the **Add** button.
223		-
224		-
225		-[[image:ThingsBoard-add-data-converter-downlink.png||height="532" width="500"]]
226		-
227		-
228		-= Add Integration =
229		-
230		-In the left navigation, click ‘Integrations center’, and then click ‘Integrations’.
231		-
232		-On the ‘Integrations’ page, click on the “+” button.
233		-
234		-
235		-[[image:ThingsBoard-add-integration.png]]
236		-
237		-
238		-The ‘Add integration’ window appears.
239		-
240		-In the Add Integration window, configure the following settings:
241		-
242		-**Basic settings:**
243		-
244		-* **Integration type**: UDP
245		-* **Name**: UDP Integration NB/CB
246		-
247		-Click **Next** button.
248		-
249		-
250		-
251		-
252		-
253		-