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