Skip to Content

Changes for page Armbian OS instruction

Last modified by Edwin Chen on 2025/02/26 08:18
From version 73.1
edited by Xiaoye
on 2022/09/19 10:44
Change comment: There is no comment for this version
To version 26.1
edited by Kilight Cao
on 2022/06/02 11:59
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoye
1 +XWiki.Kilight
Content
... ... @@ -2,457 +2,139 @@
2 2  
3 3  {{toc/}}
4 4  
5 += Overview =
5 5  
6 -
7 -
8 -= 1.  Overview =
9 -
10 -
11 11  This is a general instruction for the use of Armbian base OS of Dragino devices. Current models include:
12 12  
13 13  * HP0A
14 14  * HP0C
15 15  * LPS8v2
16 -* MS20
17 17  
13 += Development Guide =
18 18  
19 -= 2.  Development Guide =
15 +For advanced users to develop Driver/ Linux etc
20 20  
21 21  
22 -For advanced users to develop Driver/ Linux etc.
18 += Advance =
23 23  
20 +== SSH Access for Linux console ==
24 24  
22 +Connect the HP0C Ethernet port to your router and HP0C will obtain an IP address from your router. In the router’s management portal, you should be able to find what IP address the router has assigned to the HP0C. You can use this IP to connect the SSH access of HP0C.
25 25  
26 -== 2.1  How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
24 +IP address:  IP address of HP0C
27 27  
26 +Port:         22
28 28  
28 +User Name:      **root**
29 29  
30 -=== (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) ===
30 +Password:  **draginohp** (default)
31 31  
32 +After logging in, you will be in the Linux console and can enter commands as shown below.
32 32  
33 -**Requirements:**
34 34  
35 -**~ (% style="background-color:yellow; color:green" %)sudo apt install -y libsqlite3-dev(%%)**
35 +== How to flash SD card to eMMC ==
36 36  
37 -**~ (% style="background-color:yellow; color:green" %)sudo apt install -y libftdi1-dev(%%)**
38 38  
38 +Run command:
39 39  
40 -**Run command clone dragino-fwd package: (% style="background-color:yellow; color:green" %)git clone https:~/~/github.com/dragino/dragino_fwd_src.git(%%)**
40 +(% class="box infomessage" %)
41 +(((
42 +nand-sata-install
43 +)))
41 41  
42 -
43 -[[image:image-20220527151010-1.png]]
44 -
45 -
46 -
47 -=== (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) ===
48 -
49 -
50 -**After cloning is complete, Run the command starts compiling:**
51 -
52 -(% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd:  ./hp0z-make-deb.sh c**
53 -
54 -
55 -The following example compilers HP0C fwd.
56 -
57 -[[image:image-20220527153913-3.png]]
58 -
59 -
60 -
61 -When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated.
62 -
63 -[[image:image-20220527154311-4.png||height="385" width="773"]]
64 -
65 -
66 -
67 -=== (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) ===
68 -
69 -
70 -**Run command:**
71 -
72 -(% style="background-color:yellow; color:green" %)**dpkg -i draginofwd-*.deb **
73 -
74 -
75 -[[image:image-20220527154811-5.png]]
76 -
77 -
78 -
79 -=== (% style="color:blue" %)**Step 4. Test**(%%) ===
80 -
81 -
82 -**Check the dragino_fwd log:**
83 -
84 -(% style="background-color:yellow; color:green" %)**journalctl -u draginofwd -f**
85 -
86 -
87 -[[image:image-20220527165221-7.png||height="182" width="931"]]
88 -
89 -
90 -**Start/stop dragino_fwd via systemctl:**
91 -
92 -(% style="background-color:yellow; color:green" %)**systemctl start draginofwd**
93 -
94 -(% style="background-color:yellow; color:green" %)**systemctl stop draginofwd**
95 -
96 -
97 -
98 -== 2.2  How to clone Complete OS on the EMMC to SD card ==
99 -
100 -
101 -== 2.3  How to flash SD card to (eMMC) device's built-in Memory ==
102 -
103 -
104 -=== 2.3.1 Prepare an SD card with OS ===
105 -
106 -
107 - (% style="background-color:yellow" %)//**Preparations:**//
108 -
109 -~1. Prepare an SD card and a// card reader device//
110 -
111 -2. Formatting the SD card (//Make sure the SD card is empty//)
112 -
113 -3. //Download the OS image from the **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )//
114 -
115 -4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )//
116 -
117 -
118 -
119 -=== 2.3.2 Flash SD card to device's eMMC ===
120 -
121 -
122 -//1. Open the device's enclosure, and put the SD card into the SD card slot//
123 -
124 -//2. Power on the device and access the gateway's CLI via the serial port.//
125 -
126 -//3. Login and run the below command to flash.//
127 -
128 -
129 -**Run command:**
130 -
131 -(% style="background-color:yellow; color:green" %)**nand-sata-install**
132 -
133 -
134 134  [[image:image-20220602112051-1.png]]
135 135  
47 +**Select the "Boot from eMMC - system on eMMC"**
136 136  
137 -
138 -Select the (% style="color:red" %)**"Boot from eMMC - system on eMMC".**
139 -
140 140  [[image:image-20220602112058-2.png||height="292" width="646"]]
141 141  
142 -
143 143  [[image:image-20220602112106-3.png||height="301" width="643"]]
144 144  
145 145  
54 +**Select the "1  ext4"**
146 146  
147 -Select the (% style="color:red" %)**"1  ext4"**
148 -
149 149  [[image:image-20220602112113-4.png||height="271" width="642"]]
150 150  
151 151  
59 +**It takes 4-5 minutes to burn from SD card to eMMC**
152 152  
153 -It takes 4-5 minutes to burn from SD card to eMMC
154 -
155 155  [[image:image-20220602112119-5.png||height="309" width="641"]]
156 156  
157 -
158 158  [[image:image-20220602112125-6.png||height="281" width="640"]]
159 159  
160 -
161 161  [[image:image-20220602112131-7.png||height="241" width="638"]]
162 162  
163 163  
164 -(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.**
68 +(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card**
165 165  
70 +== How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
166 166  
72 +=== Step 1. Clone dragino-fwd package ===
167 167  
168 -== 2.4 Default Built Version ==
169 169  
75 +Run command clone dragino-fwd package:
170 170  
171 -[[image:image-20220902155621-1.png]]
77 +(% class="box infomessage" %)
78 +(((
79 +git clone https:~/~/github.com/dragino/dragino_fwd_src.git
80 +)))
172 172  
82 +[[image:image-20220527151010-1.png]]
173 173  
174 174  
175 -= 3. Package Maintain Note =
85 +=== Step 2. Compile dragino_fwd ===
176 176  
177 177  
178 -== 3.1 Default Package Maintain System ==
88 +After cloning is complete, Run the command starts compiling:
179 179  
90 +(% class="box infomessage" %)
91 +(((
92 +Compile HP0D/rasspberrypi fwd：  ./hp0z-make-deb.sh d
93 +Compile HP0C/HP0A fwd：  ./hp0z-make-deb.sh c
94 +)))
180 180  
181 -=== 3.1.1 How Package-Auto-Update works? ===
96 +The following example compilers HP0C fwd.
182 182  
98 +[[image:image-20220527153913-3.png]]
183 183  
184 -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. 
185 185  
101 +**When the compilation is complete a draginofwd-*.deb package is generated.**
186 186  
187 -(% style="color:blue" %)**When devices will check for updates**?
103 +[[image:image-20220527154311-4.png||height="385" width="773"]]
188 188  
189 -* Devices will check for updates for every boot.
190 -* Devices will check for updates on every day midnight.
191 191  
106 +=== Step 3. Install the dragino_fwd ===
192 192  
193 -(% style="color:blue" %)**What packages will be checked for updates**?
194 194  
195 -dragino-httpd ~-~- Main Web UI http configuration
109 +Run command:
196 196  
197 -dragino-sid  ~-~- SN write and read tool
111 +(% class="box infomessage" %)
112 +(((
113 +dpkg -i draginofwd-*.deb
114 +)))
198 198  
199 -dragino-ui  ~-~- Gateway Web UI package
116 +[[image:image-20220527154811-5.png]]
200 200  
201 -draginofwd   ~-~- UDP packet forwarder, LoRa Base Station
202 202  
203 -draginoups   ~-~- Miscellaneous between different versions
119 +=== Step 4. Test ===
204 204  
205 205  
122 +Check the dragino_fwd log:
206 206  
207 -(% style="color:blue" %)**Location and changelog for packages**:
124 +(% class="box infomessage" %)
125 +(((
126 +journalctl -u draginofwd -f
127 +)))
208 208  
209 -* Location: http:~/~/repo.dragino.com/release/tool/
210 -* Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]]
129 +[[image:image-20220527165221-7.png||height="182" width="931"]]
211 211  
131 +Start/stop dragino_fwd via systemctl:
212 212  
213 -(% style="color:blue" %)**How to view auto-updated log**
133 +(% class="box infomessage" %)
134 +(((
135 +systemctl start draginofwd
136 +systemctl stop draginofwd
137 +)))
214 214  
215 -You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.**
216 216  
217 -
218 -[[image:1661305025451-220.png]]
219 -
220 -
221 -
222 -(% style="color:blue" %)**Can I disable package-auto-update?**
223 -
224 -You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.
225 -
226 -
227 -[[image:1661305258501-636.png]]
228 -
229 -
230 -
231 -=== 3.1.2 How to manually update core packages? ===
232 -
233 -
234 -You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages.
235 -
236 -
237 -[[image:1661305328295-218.png]]
238 -
239 -
240 -
241 -=== 3.1.3 How to manually update other packages? ===
242 -
243 -
244 -For the other packages, you have to access the device's CLI to do it via the apt command.
245 -
246 -
247 -
248 -== 3.2 Set up a 3^^rd^^ party package maintain server ==
249 -
250 -
251 -=== 3.2.1 Overview ===
252 -
253 -
254 -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.
255 -
256 -
257 -
258 -=== 3.2.2 Install Apache2 HTTP server ===
259 -
260 -
261 -(% style="background-color:yellow; color:green" %)**apt install apache2**
262 -
263 -
264 -
265 -=== 3.2.3 Creating Package Directories ===
266 -
267 -
268 -**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)**
269 -
270 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)**
271 -
272 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)**
273 -
274 -
275 -**Tree Structure:**
276 -
277 -(% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.**
278 -
279 -
280 -└── debian
281 -
282 - └── release
283 -
284 - ├── dists
285 -
286 - │   └── stable
287 -
288 - │       └── main
289 -
290 - │           └── binary-armhf
291 -
292 - └── pool
293 -
294 - └── main
295 -
296 - └── d
297 -
298 - └── dragino   ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**
299 -
300 -
301 -
302 -=== 3.2.4 Get deb packages ===
303 -
304 -
305 -The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)**
306 -
307 -Below is an example package(testing-0808.deb) for test purpose:
308 -
309 -
310 -**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)**
311 -
312 -**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**
313 -
314 -
315 -
316 -=== 3.2.5 Generate Package Index file ===
317 -
318 -
319 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/**
320 -
321 -(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages**
322 -
323 -(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz**
324 -
325 -
326 -(% 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.**
327 -
328 -
329 -
330 -=== 3.2.6 Generate Release file ===
331 -
332 -
333 -==== (% style="color:blue" %)**Create the generated script:**(%%) ====
334 -
335 -
336 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
337 -
338 -
339 -(% style="background-color:yellow; color:green" %)**wget [[http:~~/~~/repo.dragino.com/release/tool/unimportant/generate-release.sh>>url:http://repo.dragino.com/release/tool/unimportant/generate-release.sh]]**
340 -
341 -(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh**
342 -
343 -(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**
344 -
345 -
346 -
347 -=== 3.2.7 Sign the Release file with gpg and generating Inrelease file ===
348 -
349 -
350 -
351 -==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====
352 -
353 -
354 -(% style="background-color:yellow; color:green" %)**apt install gnupg**
355 -
356 -
357 -
358 -==== (% style="color:blue" %)**generate gpg key**(%%) ====
359 -
360 -
361 -(% style="background-color:yellow; color:green" %)**gpg -gen-key**
362 -
363 -
364 -(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.**
365 -
366 -
367 -
368 -==== (% style="color:blue" %)**Check the gen-key**(%%) ====
369 -
370 -
371 -(% style="background-color:yellow; color:green" %)**gen -list-key**
372 -
373 -
374 -
375 -==== (% style="color:blue" %)**Generate the release.gpg**(%%) ====
376 -
377 -
378 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
379 -
380 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release**
381 -
382 -
383 -(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release**
384 -
385 -
386 -
387 -==== (% style="color:blue" %)**Generate the public key**(%%) ====
388 -
389 -
390 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>**
391 -
392 -
393 -**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]]
394 -
395 -
396 -
397 -=== 3.2.8 Add url as apt source in LPS8v2 / MS20 ===
398 -
399 -
400 -
401 -==== (% style="color:blue" %)**Add the public key**(%%) ====
402 -
403 -
404 -(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/**
405 -
406 -
407 -(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.**
408 -
409 -
410 -
411 -==== (% style="color:blue" %)**Add the apt source list**(%%) ====
412 -
413 -
414 -Add the apt source list url and name this as test_server.list
415 -
416 -(% style="background-color:yellow; color:green" %)**echo "deb http:~/~/<IP_address or hostname>/debian/release stable main" | tee /etc/apt/sources.list.d/test_server.list**
417 -
418 -
419 -
420 -==== (% style="color:blue" %)**Validate the apt repository**(%%) ====
421 -
422 -
423 -Get and install the testing package (download testing-0808.deb and test)
424 -
425 -(% style="background-color:yellow; color:green" %)**apt update && apt install testing**
426 -
427 -
428 -Example output:
429 -
430 -[[image:1661306420449-569.png]]
431 -
432 -
433 -
434 -=== 3.2.9 Configure the gateway's auto-upgrade rules ===
435 -
436 -
437 -==== (% style="color:blue" %)**Remove dragino apt source**(%%) ====
438 -
439 -
440 -(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list**
441 -
442 -
443 -[[image:1661306460134-112.png]]
444 -
445 -
446 -
447 -==== (% style="color:blue" %)**Set up automatic updates**(%%) ====
448 -
449 -
450 -(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates**
451 -
452 -
453 -The device performs automatic updates from this script,
454 -
455 -But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword.
456 -
457 -
458 -[[image:1661306487761-768.png]]
140 +
1661305025451-220.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -247.0 KB
Content
1661305258501-636.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -115.4 KB
Content
1661305321820-965.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -78.3 KB
Content
1661305328295-218.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -78.3 KB
Content
1661306420449-569.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -237.0 KB
Content
1661306460134-112.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -146.8 KB
Content
1661306487761-768.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -291.9 KB
Content
image-20220609101627-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -14.7 KB
Content
image-20220609101638-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -16.3 KB
Content
image-20220609101748-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -26.1 KB
Content
image-20220609101820-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -20.4 KB
Content
image-20220609101843-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -18.7 KB
Content
image-20220609101905-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -19.8 KB
Content
image-20220609101944-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -46.2 KB
Content
image-20220609102257-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -22.9 KB
Content
image-20220609102320-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -22.9 KB
Content
image-20220609102911-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -63.7 KB
Content
image-20220609103538-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -17.7 KB
Content
image-20220609103619-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -17.6 KB
Content
image-20220609104104-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -45.3 KB
Content
image-20220902155621-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Edwin
Size
... ... @@ -1,1 +1,0 @@
1 -27.7 KB
Content