Changes for page Armbian OS instruction

Last modified by Kilight Cao on 2024/10/08 09:35
<
From version < 70.6 >
edited by Xiaoling
on 2022/08/24 10:35
To version < 90.3 >
edited by Xiaoling
on 2023/03/27 17:08
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -15,7 +15,9 @@
15 15  * LPS8v2
16 16  * MS20
17 17  
18 +(% style="display:none" %)
18 18  
20 +
19 19  = 2.  Development Guide =
20 20  
21 21  
... ... @@ -22,11 +22,9 @@
22 22  For advanced users to develop Driver/ Linux etc.
23 23  
24 24  
25 -
26 26  == 2.1  How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
27 27  
28 28  
29 -
30 30  === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) ===
31 31  
32 32  
... ... @@ -43,13 +43,11 @@
43 43  [[image:image-20220527151010-1.png]]
44 44  
45 45  
46 -
47 47  === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) ===
48 48  
49 49  
50 50  **After cloning is complete, Run the command starts compiling:**
51 51  
52 -
53 53  (% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd:  ./hp0z-make-deb.sh c**
54 54  
55 55  
... ... @@ -64,7 +64,6 @@
64 64  [[image:image-20220527154311-4.png||height="385" width="773"]]
65 65  
66 66  
67 -
68 68  === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) ===
69 69  
70 70  
... ... @@ -76,7 +76,6 @@
76 76  [[image:image-20220527154811-5.png]]
77 77  
78 78  
79 -
80 80  === (% style="color:blue" %)**Step 4. Test**(%%) ===
81 81  
82 82  
... ... @@ -95,13 +95,10 @@
95 95  (% style="background-color:yellow; color:green" %)**systemctl stop draginofwd**
96 96  
97 97  
98 -
99 99  == 2.2  How to clone Complete OS on the EMMC to SD card ==
100 100  
101 -
102 102  == 2.3  How to flash SD card to (eMMC) device's built-in Memory ==
103 103  
104 -
105 105  === 2.3.1 Prepare an SD card with OS ===
106 106  
107 107  
... ... @@ -111,7 +111,7 @@
111 111  
112 112  2. Formatting the SD card (//Make sure the SD card is empty//)
113 113  
114 -3. //Download the OS image from **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )//
107 +3. //Download the OS image from the **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )//
115 115  
116 116  4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )//
117 117  
... ... @@ -135,24 +135,30 @@
135 135  [[image:image-20220602112051-1.png]]
136 136  
137 137  
138 -Select the "Boot from eMMC - system on eMMC"
139 139  
132 +Select the (% style="color:red" %)**"Boot from eMMC - system on eMMC".**
133 +
140 140  [[image:image-20220602112058-2.png||height="292" width="646"]]
141 141  
136 +
142 142  [[image:image-20220602112106-3.png||height="301" width="643"]]
143 143  
144 144  
145 -Select the "1  ext4"
146 146  
141 +Select the (% style="color:red" %)**"1  ext4"**
142 +
147 147  [[image:image-20220602112113-4.png||height="271" width="642"]]
148 148  
149 149  
146 +
150 150  It takes 4-5 minutes to burn from SD card to eMMC
151 151  
152 152  [[image:image-20220602112119-5.png||height="309" width="641"]]
153 153  
151 +
154 154  [[image:image-20220602112125-6.png||height="281" width="640"]]
155 155  
154 +
156 156  [[image:image-20220602112131-7.png||height="241" width="638"]]
157 157  
158 158  
... ... @@ -159,16 +159,229 @@
159 159  (% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.**
160 160  
161 161  
161 +== 2.4 Default Built Version ==
162 162  
163 -= 3. Package Maintain Note =
164 164  
164 +[[image:image-20220902155621-1.png]]
165 165  
166 -== 3.1 Default Package Maintain System ==
167 167  
167 +== 2.5 How to upgrade the nodejs version to the latest. ==
168 168  
169 -=== 3.1.1 How Package-Auto-Update works? ===
170 170  
170 +By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old.
171 171  
172 +[[image:image-20221112145029-2.png]]
173 +
174 +**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.**
175 +
176 +
177 +#install n, which is an Interactively Manage Your Node.js Versions
178 +
179 +[[image:image-20221112154230-3.png||height="89" width="689"]]
180 +
181 +(% class="box infomessage" %)
182 +(((
183 +**npm install -g n**
184 +)))
185 +
186 +
187 +#Install the latest LTS Node.js release (downloading if necessary)
188 +
189 +[[image:image-20221112154418-4.png||height="184" width="893"]]
190 +
191 +(% class="box infomessage" %)
192 +(((
193 +**n lts**
194 +)))
195 +
196 +
197 +#Remove all downloaded versions except the installed version
198 +
199 +[[image:image-20221112154456-5.png||height="139" width="899"]]
200 +
201 +(% class="box infomessage" %)
202 +(((
203 +**n prune**
204 +)))
205 +
206 +
207 +(% class="box infomessage" %)
208 +(((
209 +**apt remove nodejs -y && apt autoremove -y && reboot**
210 +)))
211 +
212 +
213 +Check the current version
214 +
215 +[[image:image-20221112154724-6.png]]
216 +
217 +(% class="box infomessage" %)
218 +(((
219 +**node -v**
220 +)))
221 +
222 +
223 +== 2.6 How to install Grafana and influxdb ==
224 +
225 +
226 +=== **Grafana:** ===
227 +
228 +
229 +(% class="box infomessage" %)
230 +(((
231 +curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null
232 +echo "deb [signed-by=/usr/share/keyrings/grafana-archive-keyrings.gpg] https:~/~/packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
233 +apt update && apt install grafana
234 +)))
235 +
236 +
237 +Check the running status:
238 +
239 +
240 +(% class="box infomessage" %)
241 +(((
242 +systemctl status grafana-server
243 +)))
244 +
245 +
246 +configuration path:
247 +
248 +
249 +(% class="box infomessage" %)
250 +(((
251 +/etc/grafana/grafana.ini
252 +)))
253 +
254 +
255 +=== **Influxdb:** ===
256 +
257 +
258 +(% class="box infomessage" %)
259 +(((
260 +curl https:~/~/repos.influxdata.com/influxdb.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null
261 +echo "deb [signed-by=/usr/share/keyrings/influxdb-archive-keyring.gpg] https:~/~/repos.influxdata.com/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
262 +apt update && apt install influxdb
263 +)))
264 +
265 +
266 +Check the running status:
267 +
268 +
269 +(% class="box infomessage" %)
270 +(((
271 +systemctl status influxdb
272 +)))
273 +
274 +
275 +configuration path:
276 +
277 +
278 +(% class="box infomessage" %)
279 +(((
280 +/etc/influxdb/influxdb.conf
281 +)))
282 +
283 +
284 +== 2.7 How to install BACnet ==
285 +
286 +
287 +(% class="box infomessage" %)
288 +(((
289 +wget [[http:~~/~~/dragino.vicp.io:6080/bacnet/dragino-bacnet-apps-hp0c-2023-03-01.deb>>url:http://dragino.vicp.io:6080/bacnet/dragino-bacnet-apps-hp0c-2023-03-01.deb]]
290 +dpkg -i dragino-bacnet-apps-hp0c-2023-03-01.deb
291 +)))
292 +
293 +[[image:image-20230327152105-1.png||height="163" width="933"]]
294 +
295 +
296 +=== 2.7.1 Configure BACnet ===
297 +
298 +
299 +After BACnet is installed, run commands to modify BACnet configurations
300 +
301 +Note: device_port and bacnet_ip_port are not set to the same
302 +
303 +(% class="box infomessage" %)
304 +(((
305 +nano /etc/config/bacnet
306 +)))
307 +
308 +Examples:
309 +
310 +(% class="box infomessage" %)
311 +(((
312 +config settings 'general'
313 + option bacnet_ip '10.130.2.80'  #The IP address of the BACnetIP network, here basically the same IP as the bbmd address below
314 + option bacnet_ip_port '47808'  #As with bbmd_port, the purpose of this is to register a Bacnet Server application as a bbmd registration server
315 + option bbmd_address '10.130.2.80'  #bbmd is the BACnet registration server. Only one bbmd server is required in the same ip network
316 + option bbmd_port '47808'  #In general, 47808 is used as the default port
317 + option bacnet_dev_count '2'  #Here is the number of BACnet devices that need to be simulated, if the number is 2, then the following settings must have 2, which are bacdev_1, bacdev_2
318 +
319 +config settings 'bacdev_1'
320 + option device_name 'LHT65N-1'  #The identification name of the bacnet device
321 + option device_id '10001'  #The unique identification code in the same network segment of BACnet,Scope is(1 - 4194302)
322 + option device_port '47912'  #The IP port occupied by Bacnet when it starts, Scope is (1024 - 65535)
323 +
324 +config settings 'bacdev_2'
325 + option device_name 'LHT65N-2'
326 + option device_id '10002'
327 + option device_port '47913'  
328 +)))
329 +
330 +
331 +=== 2.7.2 Run BACnet ===
332 +
333 +
334 +After the configuration is complete, run the following command to start BACnet, The following are two ways to run BACnet:
335 +
336 +(1)With /etc/config/bacnet configuration, and to run the registration server on the current machine, start it with the following command (configure the /etc/config/bacnet file correctly):
337 +
338 +(% class="box infomessage" %)
339 +(((
340 +bacserver -c -s
341 +)))
342 +
343 +(2)Without /etc/config/bacnet, and to run the registration server on the current machine, start it with the following command:
344 +
345 +(% class="box infomessage" %)
346 +(((
347 +bacserver -s -a 10.130.2.80 -p 47808
348 +)))
349 +
350 +This command simulates two devices, with device IDs 47910 and 47911
351 +
352 +Enter bacserver -h to output help
353 +
354 +(% class="box infomessage" %)
355 +(((
356 +bacserver -h
357 +)))
358 +
359 +[[image:image-20230327154700-3.png]]
360 +
361 +
362 +=== 2.7.3 Read devices and modify devices ===
363 +
364 +
365 +Enter baccli -h to output help
366 +
367 +(% class="box infomessage" %)
368 +(((
369 +baccli -h
370 +)))
371 +
372 +[[image:image-20230327165836-1.png]]
373 +
374 +Examples:
375 +
376 +
377 += 4. Package Maintain Note =
378 +
379 +== 4.1 Default Package Maintain System ==
380 +
381 +=== 4.1.1 How Package-Auto-Update works? ===
382 +
383 +
172 172  By default, LPS8v2 / MS20 series products have an auto-update feature for main packages. The device will connect to Dragino's auto-update server and check for updates. 
173 173  
174 174  
... ... @@ -190,6 +190,7 @@
190 190  draginoups   ~-~- Miscellaneous between different versions
191 191  
192 192  
405 +
193 193  (% style="color:blue" %)**Location and changelog for packages**:
194 194  
195 195  * Location: http:~/~/repo.dragino.com/release/tool/
... ... @@ -203,52 +203,47 @@
203 203  [[image:1661305025451-220.png]]
204 204  
205 205  
419 +
206 206  (% style="color:blue" %)**Can I disable package-auto-update?**
207 207  
208 -You can check the checkbox and click the(% style="color:#037691" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.
422 +You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.
209 209  
210 210  
211 211  [[image:1661305258501-636.png]]
212 212  
213 213  
428 +=== 4.1.2 How to manually update core packages? ===
214 214  
215 -=== 3.1.2 How to manually update core packages? ===
216 216  
431 +You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages.
217 217  
218 -You can click the (% style="color:#037691" %)**‘Manual Update’**(%%) to update the dragino's packages.
219 219  
220 -
221 221  [[image:1661305328295-218.png]]
222 222  
223 223  
437 +=== 4.1.3 How to manually update other packages? ===
224 224  
225 -=== 3.1.3 How to manually update other packages? ===
226 226  
227 -
228 228  For the other packages, you have to access the device's CLI to do it via the apt command.
229 229  
230 230  
443 +== 4.2 Set up a 3^^rd^^ party package maintain server ==
231 231  
232 -== 3.2 Set up a 3^^rd^^ party package maintain server ==
445 +=== 4.2.1 Overview ===
233 233  
234 234  
235 -=== 3.2.1 Overview ===
236 -
237 -
238 238  Customers can use their own package maintenance system instead of using the default one from Dragino. They need to set up a package maintenance system for Debian. Lots of instructions are available in Internet, below is a reference instruction.
239 239  
240 240  
451 +=== 4.2.2 Install Apache2 HTTP server ===
241 241  
242 -=== 3.2.2 Install Apache2 HTTP server ===
243 243  
244 -
245 245  (% style="background-color:yellow; color:green" %)**apt install apache2**
246 246  
247 247  
457 +=== 4.2.3 Creating Package Directories ===
248 248  
249 -=== 3.2.3 Creating Package Directories ===
250 250  
251 -
252 252  **~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)**
253 253  
254 254  **~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)**
... ... @@ -282,10 +282,9 @@
282 282   └── dragino   ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**
283 283  
284 284  
493 +=== 4.2.4 Get deb packages ===
285 285  
286 -=== 3.2.4 Get deb packages ===
287 287  
288 -
289 289  The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)**
290 290  
291 291  Below is an example package(testing-0808.deb) for test purpose:
... ... @@ -296,10 +296,9 @@
296 296  **~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**
297 297  
298 298  
506 +=== 4.2.5 Generate Package Index file ===
299 299  
300 -=== 3.2.5 Generate Package Index file ===
301 301  
302 -
303 303  (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/**
304 304  
305 305  (% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages**
... ... @@ -310,13 +310,12 @@
310 310  (% style="color:red" %)**Note: Every time a package has been update, above comments need to be executed in the server to get the up-to-date package list.**
311 311  
312 312  
519 +=== 4.2.6 Generate Release file ===
313 313  
314 -=== 3.2.6 Generate Release file ===
315 315  
522 +==== (% style="color:blue" %)**Create the generated script:**(%%) ====
316 316  
317 -==== (% style="color:blue" %)Create the generated script:(%%) ====
318 318  
319 -
320 320  (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
321 321  
322 322  
... ... @@ -327,29 +327,27 @@
327 327  (% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**
328 328  
329 329  
535 +=== 4.2.7 Sign the Release file with gpg and generating Inrelease file ===
330 330  
331 -=== 3.2.7 Sign the Release file with gpg and generating Inrelease file ===
332 332  
538 +==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====
333 333  
334 334  
335 -==== (% style="color:blue" %)Make sure auto-update server has gnupg(%%) ====
336 -
337 -
338 338  (% style="background-color:yellow; color:green" %)**apt install gnupg**
339 339  
340 340  
341 341  
342 -==== (% style="color:blue" %)generate gpg key(%%) ====
545 +==== (% style="color:blue" %)**generate gpg key**(%%) ====
343 343  
344 344  
345 345  (% style="background-color:yellow; color:green" %)**gpg -gen-key**
346 346  
347 347  
348 -**((% style="color:red" %)Note: Fill in the content as required and remember the name and email address)(%%)**
551 +(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.**
349 349  
350 350  
351 351  
352 -==== (% style="color:blue" %)Check the gen-key(%%) ====
555 +==== (% style="color:blue" %)**Check the gen-key**(%%) ====
353 353  
354 354  
355 355  (% style="background-color:yellow; color:green" %)**gen -list-key**
... ... @@ -356,7 +356,7 @@
356 356  
357 357  
358 358  
359 -==== (% style="color:blue" %)Generate the release.gpg(%%) ====
562 +==== (% style="color:blue" %)**Generate the release.gpg**(%%) ====
360 360  
361 361  
362 362  (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
... ... @@ -368,7 +368,7 @@
368 368  
369 369  
370 370  
371 -==== (% style="color:blue" %)Generate the public key(%%) ====
574 +==== (% style="color:blue" %)**Generate the public key**(%%) ====
372 372  
373 373  
374 374  (% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>**
... ... @@ -378,20 +378,21 @@
378 378  
379 379  
380 380  
381 -=== 3.2.8 Add url as apt source in LPS8v2 / MS20 ===
584 +=== 4.2.8 Add url as apt source in LPS8v2 / MS20 ===
382 382  
383 383  
384 384  
385 -==== (% style="color:blue" %)Add the public key(%%) ====
588 +==== (% style="color:blue" %)**Add the public key**(%%) ====
386 386  
387 387  
388 388  (% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/**
389 389  
593 +
390 390  (% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.**
391 391  
392 392  
393 393  
394 -==== (% style="color:blue" %)Add the apt source list(%%) ====
598 +==== (% style="color:blue" %)**Add the apt source list**(%%) ====
395 395  
396 396  
397 397  Add the apt source list url and name this as test_server.list
... ... @@ -400,7 +400,7 @@
400 400  
401 401  
402 402  
403 -==== (% style="color:blue" %)Validate the apt repository(%%) ====
607 +==== (% style="color:blue" %)**Validate the apt repository**(%%) ====
404 404  
405 405  
406 406  Get and install the testing package (download testing-0808.deb and test)
... ... @@ -413,13 +413,12 @@
413 413  [[image:1661306420449-569.png]]
414 414  
415 415  
620 +=== 4.2.9 Configure the gateway's auto-upgrade rules ===
416 416  
417 -=== 3.2.9 Configure the gateway's auto-upgrade rules ===
418 418  
623 +==== (% style="color:blue" %)**Remove dragino apt source**(%%) ====
419 419  
420 -==== (% style="color:blue" %)Remove dragino apt source(%%) ====
421 421  
422 -
423 423  (% style="background-color:yellow; color:green" %)**/etc/apt/sources.list**
424 424  
425 425  
... ... @@ -427,7 +427,7 @@
427 427  
428 428  
429 429  
430 -==== (% style="color:blue" %)Set up automatic updates(%%) ====
633 +==== (% style="color:blue" %)**Set up automatic updates**(%%) ====
431 431  
432 432  
433 433  (% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates**
... ... @@ -439,5 +439,3 @@
439 439  
440 440  
441 441  [[image:1661306487761-768.png]]
442 -
443 -
image-20220902155621-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Edwin
Size
... ... @@ -1,0 +1,1 @@
1 +27.7 KB
Content
image-20221112145017-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +1.9 KB
Content
image-20221112145029-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +3.3 KB
Content
image-20221112154230-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +5.2 KB
Content
image-20221112154418-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +18.2 KB
Content
image-20221112154456-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +14.6 KB
Content
image-20221112154724-6.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +3.2 KB
Content
image-20230327152105-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +27.5 KB
Content
image-20230327152431-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +47.5 KB
Content
image-20230327154700-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +26.7 KB
Content
image-20230327165836-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +17.1 KB
Content

Applications

Navigation

Copyright ©2010-2022 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0