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