Changes for page Armbian OS instruction

Last modified by Edwin Chen on 2025/02/26 08:18
<
From version < 86.1 >
edited by Kilight Cao
on 2023/03/27 15:21
To version < 115.1 >
edited by Kilight Cao
on 2024/11/05 16:24
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -15,7 +15,9 @@
15 15  * LPS8v2
16 16  * MS20
17 17  
18 +(% style="display:none" %)
18 18  
20 +
19 19  = 2.  Development Guide =
20 20  
21 21  
... ... @@ -91,78 +91,246 @@
91 91  
92 92  == 2.2  How to clone Complete OS on the EMMC to SD card ==
93 93  
94 -== 2.3  How to flash SD card to (eMMC) device's built-in Memory ==
95 95  
96 -=== 2.3.1 Prepare an SD card with OS ===
97 +**2.2.1 Prepare a USB flash drive/SD card and plug it into the USB port of the gateway.**
97 97  
98 98  
99 - (% style="background-color:yellow" %)//**Preparations:**//
100 100  
101 -~1. Prepare an SD card and a// card reader device//
102 102  
103 -2. Formatting the SD card (//Make sure the SD card is empty//)
102 +**2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI**
104 104  
105 -3. //Download the OS image from the **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )//
106 106  
107 -4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )//
108 108  
109 109  
107 +**2.2.3 Using the dd command, copy Emmc as an img file**
110 110  
111 -=== 2.3.2 Flash SD card to device's eMMC ===
112 112  
110 +dd if=/etc/sidmem of=/dev/mmcblk2p2 bs=1M count=1
113 113  
114 -//1. Open the device's enclosure, and put the SD card into the SD card slot//
115 115  
116 -//2. Power on the device and access the gateway's CLI via the serial port.//
117 117  
118 -//3. Login and run the below command to flash.//
114 +**2.2.4 Export the img file and follow the steps in 2.3 for burning**
119 119  
120 120  
117 +== 2.3  How to flash a new image(OS) to the gateway(LPS8V2) ==
118 +
119 +
120 +Since the gateway has a large system, you need to use the sd card to reflash the system for the gateway
121 +
122 +
123 +//2.3.1: Making an SD card with the new image//
124 +
125 +//2.3.2: Instal the SD card to the gateway//
126 +
127 +//2.3.3: Flash the image to the gateway's built memory from the SD card//
128 +
129 +//2.3.4: Finished the process of flash and power cycle the gateway//
130 +
131 +
132 +==== (% style="background-color:yellow" %)**//Preparations~://**(%%) ====
133 +
134 +1. Prepare an SD card
135 +1. Prepare a card reader device
136 +1. Download the OS image from the release.image~: **[[draginolps8v2-release-v1.7>>http://repo.dragino.com/release/hp0c-image/]]**
137 +1. A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] )
138 +1. SD Card [[format>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]] tool
139 +
140 +=== **2.3.1 Making an SD Card with the new image** ===
141 +
142 +
143 +==== Step 1.  Formatting the SD Card ====
144 +
145 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609111027-9.png?rev=1.1||alt="image-20220609111027-9.png" height="318" width="292"]]
146 +
147 +
148 +==== Step 2. Select the OS image ====
149 +
150 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104907-8.png?rev=1.1||alt="image-20220609104907-8.png" height="435" width="689"]]
151 +
152 +
153 +==== Step 3. Select the target ====
154 +
155 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104637-2.png?rev=1.1||alt="image-20220609104637-2.png" height="436" width="690"]]
156 +
157 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104701-3.png?rev=1.1||alt="image-20220609104701-3.png" height="436" width="690"]]
158 +
159 +
160 +==== Step 4. Flash start ====
161 +
162 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104727-4.png?rev=1.1||alt="image-20220609104727-4.png" height="435" width="689"]]
163 +
164 +[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104741-5.png?rev=1.1||alt="image-20220609104741-5.png" height="434" width="687"]]
165 +
166 +
167 +
168 +=== **2.3.2 Instal the SD card to the gateway** ===
169 +
170 +1. Open the device's enclosure, and put the SD card into the SD card slot
171 +
172 +[[image:image-20230712201032-1.png]]
173 +
174 +
175 +2. Power the gateway with 5V2A, and access the gateway's Ethernet port to your PC
176 +
177 +[[image:image-20230712201458-3.png||height="649" width="832"]]
178 +
179 +
180 +Note: The PWR LED on red
181 +
182 + The  LAN LED blink
183 +
184 + The SYS LED on red
185 +
186 +
187 +
188 +=== **3.2.3 Flash the image to the gateway's built memory from the SD card(LPS8v2)** ===
189 +
190 +
191 +Access the gateway Linux CLI to flash the image to the gateway's built memory
192 +
193 +
194 +* **Use the IP address to access the gateway CLI**
195 +
196 +Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.
197 +
198 +
199 +IP address:  IP address of gateway or **Fallback IP**(172.31.255.254)
200 +
201 +Port:  22
202 +
203 +User Name:      (% style="color:blue" %)**root**
204 +
205 +Password:         (% style="color:blue" %)**dragino**(%%) (default)
206 +
207 +//After logging in, you will be in the gateway CLI and can enter commands as shown below.//
208 +
209 +
210 +[[image:image-20230508155357-1.png||height="225" width="634"]]
211 +
212 +
121 121  **Run command:**
122 122  
123 -(% style="background-color:yellow; color:green" %)**nand-sata-install**
215 +draginolps8v2-release-chirpsrtack-v1.7-240725 image :
124 124  
217 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img **
125 125  
126 -[[image:image-20220602112051-1.png]]
219 +draginolps8v2-release-ttnstack-v1.7-240712 image :
127 127  
221 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img**
128 128  
223 +[[image:image-20241008091850-2.png]]
129 129  
130 -Select the (% style="color:red" %)**"Boot from eMMC - system on eMMC".**
225 +(% style="color:red" %)**Note: Note: After the flash is completed, please power off the device (run the command halt) and disconnect the power supply, and then unplug the SD card.**
131 131  
132 -[[image:image-20220602112058-2.png||height="292" width="646"]]
133 133  
228 +== **3.2.4 Flash the image to the gateway's built memory from the SD card(MS48-LR)** ==
134 134  
135 -[[image:image-20220602112106-3.png||height="301" width="643"]]
136 136  
231 +Download the OS image from the release.image~: **[[MS48-LR-image>>https://www.dropbox.com/scl/fi/ug25bbwyk6gnqjnsee2m1/dragino-MS48-LR-231124.rar?rlkey=bqva7hkeft0m3haiui5uj12sv&st=ii6mp2g7&dl=0]]**
137 137  
233 +=== ===
138 138  
139 -Select the (% style="color:red" %)**"1  ext4"**
235 +Access the gateway Linux CLI to flash the image to the gateway's built memory
140 140  
141 -[[image:image-20220602112113-4.png||height="271" width="642"]]
237 +* **Use the IP address to access the gateway CLI**
142 142  
239 +Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.
143 143  
241 +IP address:  IP address of gateway or **Fallback IP**(172.31.255.254)
144 144  
243 +Port:  22
244 +
245 +User Name:      **root**
246 +
247 +Password:         **dragino** (default)
248 +
249 +//After logging in, you will be in the gateway CLI and can enter commands as shown below.//
250 +
251 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20230508155357-1.png?rev=1.1&width=634&height=225||alt="image-20230508155357-1.png" height="225" width="634"]]
252 +
253 +**Run command:**
254 +
255 +**nand-sata-install**
256 +
257 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112051-1.png?rev=1.1||alt="image-20220602112051-1.png"]]
258 +
259 +Select the **"Boot from eMMC - system on eMMC".**
260 +
261 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112058-2.png?rev=1.1&width=646&height=292||alt="image-20220602112058-2.png" height="292" width="646"]]
262 +
263 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112106-3.png?rev=1.1&width=643&height=301||alt="image-20220602112106-3.png" height="301" width="643"]]
264 +
265 +Select the **"1  ext4"**
266 +
267 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112113-4.png?rev=1.1&width=642&height=271||alt="image-20220602112113-4.png" height="271" width="642"]]
268 +
145 145  It takes 4-5 minutes to burn from SD card to eMMC
146 146  
147 -[[image:image-20220602112119-5.png||height="309" width="641"]]
271 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112119-5.png?rev=1.1&width=641&height=309||alt="image-20220602112119-5.png" height="309" width="641"]]
148 148  
273 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112125-6.png?rev=1.1&width=640&height=281||alt="image-20220602112125-6.png" height="281" width="640"]]
149 149  
150 -[[image:image-20220602112125-6.png||height="281" width="640"]]
275 +[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112131-7.png?rev=1.1&width=638&height=241||alt="image-20220602112131-7.png" height="241" width="638"]]
151 151  
277 +**Note: After the flash is complete, power off the device and then remove the SD card.**
152 152  
153 -[[image:image-20220602112131-7.png||height="241" width="638"]]
154 154  
280 +== 2.4 How to extend the gateway size of memory with SD card ==
155 155  
156 -(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.**
157 157  
283 +Users can use the SD card slot to expand the gateway memory size by following the steps below
158 158  
159 -== 2.4 Default Built Version ==
160 160  
286 +=== 2.4.1 View SD card information ===
161 161  
288 +(% class="box infomessage" %)
289 +(((
290 +fdisk -l
291 +)))
292 +
293 +[[image:image-20230831150518-3.png]]
294 +
295 +
296 +=== 2.4.2 Displays the current file system disk usage statistics on Linux systems ===
297 +
298 +
299 +(% class="box infomessage" %)
300 +(((
301 +df -h
302 +)))
303 +
304 +[[image:image-20230831150341-2.png]]
305 +
306 +
307 +=== 2.4.3 Mount SD card ===
308 +
309 +
310 +(% class="box infomessage" %)
311 +(((
312 +mkdir /mnt/sd
313 +
314 +mount /dev/mmcblk0p1 /mnt/sd
315 +)))
316 +
317 +After the mount is successful to check the file system disk usage on the Linux system again:
318 +
319 +[[image:image-20230831151432-4.png]]
320 +
321 +
322 +If the mount fails, you can format the file system and try the mount again
323 +
324 +(% class="box infomessage" %)
325 +(((
326 +mkfs.ext4 /dev/mmcblk0p1
327 +)))
328 +
329 +== 2.5 Default Built Version ==
330 +
331 +
162 162  [[image:image-20220902155621-1.png]]
163 163  
164 164  
165 -== 2.5 How to upgrade the nodejs version to the latest. ==
335 +== 2.6 How to upgrade the nodejs version to the latest. ==
166 166  
167 167  
168 168  By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old.
... ... @@ -218,7 +218,7 @@
218 218  )))
219 219  
220 220  
221 -== 2.6 How to install Grafana and influxdb ==
391 +== 2.7 How to install Grafana and influxdb ==
222 222  
223 223  
224 224  === **Grafana:** ===
... ... @@ -255,7 +255,7 @@
255 255  
256 256  (% class="box infomessage" %)
257 257  (((
258 -curl https:~/~/repos.influxdata.com/influxdb.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null
428 +curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null
259 259  echo "deb [signed-by=/usr/share/keyrings/influxdb-archive-keyring.gpg] https:~/~/repos.influxdata.com/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
260 260  apt update && apt install influxdb
261 261  )))
... ... @@ -278,16 +278,14 @@
278 278  /etc/influxdb/influxdb.conf
279 279  )))
280 280  
281 -= 3. How to install ChirpStack =
282 282  
452 += 3.  Package Management =
283 283  
284 -= 4. Package Maintain Note =
454 +== 3.1 Default Package Maintain System ==
285 285  
286 -== 4.1 Default Package Maintain System ==
456 +=== 3.1.1  How Package-Auto-Update works? ===
287 287  
288 -=== 4.1.1 How Package-Auto-Update works? ===
289 289  
290 -
291 291  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. 
292 292  
293 293  
... ... @@ -332,10 +332,9 @@
332 332  [[image:1661305258501-636.png]]
333 333  
334 334  
503 +=== 3.1.2 How to manually update core packages? ===
335 335  
336 -=== 4.1.2 How to manually update core packages? ===
337 337  
338 -
339 339  You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages.
340 340  
341 341  
... ... @@ -342,29 +342,27 @@
342 342  [[image:1661305328295-218.png]]
343 343  
344 344  
512 +=== 3.1.3 How to manually update other packages? ===
345 345  
346 -=== 4.1.3 How to manually update other packages? ===
347 347  
348 -
349 349  For the other packages, you have to access the device's CLI to do it via the apt command.
350 350  
351 351  
518 +== 3.2 Set up a 3^^rd^^ party package maintain server ==
352 352  
353 -== 4.2 Set up a 3^^rd^^ party package maintain server ==
520 +=== 3.2.1 Overview ===
354 354  
355 -=== 4.2.1 Overview ===
356 356  
357 -
358 358  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.
359 359  
360 360  
361 -=== 4.2.2 Install Apache2 HTTP server ===
526 +=== 3.2.2 Install Apache2 HTTP server ===
362 362  
363 363  
364 364  (% style="background-color:yellow; color:green" %)**apt install apache2**
365 365  
366 366  
367 -=== 4.2.3 Creating Package Directories ===
532 +=== 3.2.3 Creating Package Directories ===
368 368  
369 369  
370 370  **~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)**
... ... @@ -400,7 +400,7 @@
400 400   └── dragino   ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**
401 401  
402 402  
403 -=== 4.2.4 Get deb packages ===
568 +=== 3.2.4 Get deb packages ===
404 404  
405 405  
406 406  The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)**
... ... @@ -413,7 +413,7 @@
413 413  **~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**
414 414  
415 415  
416 -=== 4.2.5 Generate Package Index file ===
581 +=== 3.2.5 Generate Package Index file ===
417 417  
418 418  
419 419  (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/**
... ... @@ -426,7 +426,7 @@
426 426  (% 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.**
427 427  
428 428  
429 -=== 4.2.6 Generate Release file ===
594 +=== 3.2.6 Generate Release file ===
430 430  
431 431  
432 432  ==== (% style="color:blue" %)**Create the generated script:**(%%) ====
... ... @@ -442,7 +442,7 @@
442 442  (% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**
443 443  
444 444  
445 -=== 4.2.7 Sign the Release file with gpg and generating Inrelease file ===
610 +=== 3.2.7 Sign the Release file with gpg and generating Inrelease file ===
446 446  
447 447  
448 448  ==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====
... ... @@ -491,7 +491,7 @@
491 491  
492 492  
493 493  
494 -=== 4.2.8 Add url as apt source in LPS8v2 / MS20 ===
659 +=== 3.2.8 Add url as apt source in LPS8v2 / MS20 ===
495 495  
496 496  
497 497  
... ... @@ -527,7 +527,7 @@
527 527  [[image:1661306420449-569.png]]
528 528  
529 529  
530 -=== 4.2.9 Configure the gateway's auto-upgrade rules ===
695 +=== 3.2.9 Configure the gateway's auto-upgrade rules ===
531 531  
532 532  
533 533  ==== (% style="color:blue" %)**Remove dragino apt source**(%%) ====
... ... @@ -552,3 +552,6 @@
552 552  
553 553  
554 554  [[image:1661306487761-768.png]]
720 +
721 +
722 +
image-20230327152431-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +47.5 KB
Content
image-20230327154700-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +26.7 KB
Content
image-20230327165836-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +17.1 KB
Content
image-20230327171824-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +46.1 KB
Content
image-20230327174537-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +8.8 KB
Content
image-20230327174556-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +16.0 KB
Content
image-20230327174853-5.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +20.0 KB
Content
image-20230508155357-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +24.3 KB
Content
image-20230712201032-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +872.4 KB
Content
image-20230712201424-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +872.4 KB
Content
image-20230712201458-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoye
Size
... ... @@ -1,0 +1,1 @@
1 +854.1 KB
Content
image-20230831144800-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +86.9 KB
Content
image-20230831150341-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +30.7 KB
Content
image-20230831150518-3.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +89.9 KB
Content
image-20230831151432-4.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +37.7 KB
Content
image-20241008091544-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +36.1 KB
Content
image-20241008091850-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +36.2 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0