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