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