Changes for page Armbian OS instruction

Last modified by Edwin Chen on 2025/02/26 08:18
<
From version < 83.1 >
edited by Xiaoye
on 2022/11/12 15:47
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
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Xiaoye
1 +XWiki.Kilight
Content
... ... @@ -15,6 +15,9 @@
15 15  * LPS8v2
16 16  * MS20
17 17  
18 +(% style="display:none" %)
19 +
20 +
18 18  = 2.  Development Guide =
19 19  
20 20  
... ... @@ -21,11 +21,9 @@
21 21  For advanced users to develop Driver/ Linux etc.
22 22  
23 23  
24 -
25 25  == 2.1  How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
26 26  
27 27  
28 -
29 29  === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) ===
30 30  
31 31  
... ... @@ -42,7 +42,6 @@
42 42  [[image:image-20220527151010-1.png]]
43 43  
44 44  
45 -
46 46  === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) ===
47 47  
48 48  
... ... @@ -62,7 +62,6 @@
62 62  [[image:image-20220527154311-4.png||height="385" width="773"]]
63 63  
64 64  
65 -
66 66  === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) ===
67 67  
68 68  
... ... @@ -74,7 +74,6 @@
74 74  [[image:image-20220527154811-5.png]]
75 75  
76 76  
77 -
78 78  === (% style="color:blue" %)**Step 4. Test**(%%) ===
79 79  
80 80  
... ... @@ -93,87 +93,250 @@
93 93  (% style="background-color:yellow; color:green" %)**systemctl stop draginofwd**
94 94  
95 95  
96 -
97 97  == 2.2  How to clone Complete OS on the EMMC to SD card ==
98 98  
99 99  
100 -== 2.3  How to flash SD card to (eMMC) device's built-in Memory ==
97 +**2.2.1 Prepare a USB flash drive/SD card and plug it into the USB port of the gateway.**
101 101  
102 102  
103 -=== 2.3.1 Prepare an SD card with OS ===
104 104  
105 105  
106 - (% style="background-color:yellow" %)//**Preparations:**//
102 +**2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI**
107 107  
108 -~1. Prepare an SD card and a// card reader device//
109 109  
110 -2. Formatting the SD card (//Make sure the SD card is empty//)
111 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 113  
114 -4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )//
107 +**2.2.3 Using the dd command, copy Emmc as an img file**
115 115  
116 116  
110 +dd if=/etc/sidmem of=/dev/mmcblk2p2 bs=1M count=1
117 117  
118 -=== 2.3.2 Flash SD card to device's eMMC ===
119 119  
120 120  
121 -//1. Open the device's enclosure, and put the SD card into the SD card slot//
114 +**2.2.4 Export the img file and follow the steps in 2.3 for burning**
122 122  
123 -//2. Power on the device and access the gateway's CLI via the serial port.//
124 124  
125 -//3. Login and run the below command to flash.//
117 +== 2.3  How to flash a new image(OS) to the gateway(LPS8V2) ==
126 126  
127 127  
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 +
128 128  **Run command:**
129 129  
130 -(% style="background-color:yellow; color:green" %)**nand-sata-install**
215 +draginolps8v2-release-chirpsrtack-v1.7-240725 image :
131 131  
217 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img **
132 132  
133 -[[image:image-20220602112051-1.png]]
219 +draginolps8v2-release-ttnstack-v1.7-240712 image :
134 134  
221 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img**
135 135  
223 +[[image:image-20241008091850-2.png]]
136 136  
137 -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.**
138 138  
139 -[[image:image-20220602112058-2.png||height="292" width="646"]]
140 140  
228 +== **3.2.4 Flash the image to the gateway's built memory from the SD card(MS48-LR)** ==
141 141  
142 -[[image:image-20220602112106-3.png||height="301" width="643"]]
143 143  
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]]**
144 144  
233 +=== ===
145 145  
146 -Select the (% style="color:red" %)**"1  ext4"**
235 +Access the gateway Linux CLI to flash the image to the gateway's built memory
147 147  
148 -[[image:image-20220602112113-4.png||height="271" width="642"]]
237 +* **Use the IP address to access the gateway CLI**
149 149  
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.
150 150  
241 +IP address:  IP address of gateway or **Fallback IP**(172.31.255.254)
151 151  
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 +
152 152  It takes 4-5 minutes to burn from SD card to eMMC
153 153  
154 -[[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"]]
155 155  
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"]]
156 156  
157 -[[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"]]
158 158  
277 +**Note: After the flash is complete, power off the device and then remove the SD card.**
159 159  
160 -[[image:image-20220602112131-7.png||height="241" width="638"]]
161 161  
280 +== 2.4 How to extend the gateway size of memory with SD card ==
162 162  
163 -(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.**
164 164  
283 +Users can use the SD card slot to expand the gateway memory size by following the steps below
165 165  
166 166  
167 -== 2.4 Default Built Version ==
286 +=== 2.4.1 View SD card information ===
168 168  
288 +(% class="box infomessage" %)
289 +(((
290 +fdisk -l
291 +)))
169 169  
170 -[[image:image-20220902155621-1.png]]
293 +[[image:image-20230831150518-3.png]]
171 171  
172 172  
296 +=== 2.4.2 Displays the current file system disk usage statistics on Linux systems ===
173 173  
174 -== 2.5: How to upgrade the nodejs version to the latest. ==
175 175  
299 +(% class="box infomessage" %)
300 +(((
301 +df -h
302 +)))
176 176  
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 +
332 +[[image:image-20220902155621-1.png]]
333 +
334 +
335 +== 2.6 How to upgrade the nodejs version to the latest. ==
336 +
337 +
177 177  By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old.
178 178  
179 179  [[image:image-20221112145029-2.png]]
... ... @@ -227,15 +227,74 @@
227 227  )))
228 228  
229 229  
230 -= 3. Package Maintain Note =
391 +== 2.7 How to install Grafana and influxdb ==
231 231  
232 232  
233 -== 3.1 Default Package Maintain System ==
394 +=== **Grafana:** ===
234 234  
235 235  
236 -=== 3.1.1 How Package-Auto-Update works? ===
397 +(% class="box infomessage" %)
398 +(((
399 +curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null
400 +echo "deb [signed-by=/usr/share/keyrings/grafana-archive-keyrings.gpg] https:~/~/packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
401 +apt update && apt install grafana
402 +)))
237 237  
238 238  
405 +Check the running status:
406 +
407 +
408 +(% class="box infomessage" %)
409 +(((
410 +systemctl status grafana-server
411 +)))
412 +
413 +
414 +configuration path:
415 +
416 +
417 +(% class="box infomessage" %)
418 +(((
419 +/etc/grafana/grafana.ini
420 +)))
421 +
422 +
423 +=== **Influxdb:** ===
424 +
425 +
426 +(% class="box infomessage" %)
427 +(((
428 +curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null
429 +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
430 +apt update && apt install influxdb
431 +)))
432 +
433 +
434 +Check the running status:
435 +
436 +
437 +(% class="box infomessage" %)
438 +(((
439 +systemctl status influxdb
440 +)))
441 +
442 +
443 +configuration path:
444 +
445 +
446 +(% class="box infomessage" %)
447 +(((
448 +/etc/influxdb/influxdb.conf
449 +)))
450 +
451 +
452 += 3.  Package Management =
453 +
454 +== 3.1 Default Package Maintain System ==
455 +
456 +=== 3.1.1  How Package-Auto-Update works? ===
457 +
458 +
239 239  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. 
240 240  
241 241  
... ... @@ -280,7 +280,6 @@
280 280  [[image:1661305258501-636.png]]
281 281  
282 282  
283 -
284 284  === 3.1.2 How to manually update core packages? ===
285 285  
286 286  
... ... @@ -290,7 +290,6 @@
290 290  [[image:1661305328295-218.png]]
291 291  
292 292  
293 -
294 294  === 3.1.3 How to manually update other packages? ===
295 295  
296 296  
... ... @@ -297,10 +297,8 @@
297 297  For the other packages, you have to access the device's CLI to do it via the apt command.
298 298  
299 299  
300 -
301 301  == 3.2 Set up a 3^^rd^^ party package maintain server ==
302 302  
303 -
304 304  === 3.2.1 Overview ===
305 305  
306 306  
... ... @@ -307,7 +307,6 @@
307 307  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.
308 308  
309 309  
310 -
311 311  === 3.2.2 Install Apache2 HTTP server ===
312 312  
313 313  
... ... @@ -314,7 +314,6 @@
314 314  (% style="background-color:yellow; color:green" %)**apt install apache2**
315 315  
316 316  
317 -
318 318  === 3.2.3 Creating Package Directories ===
319 319  
320 320  
... ... @@ -351,7 +351,6 @@
351 351   └── dragino   ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**
352 352  
353 353  
354 -
355 355  === 3.2.4 Get deb packages ===
356 356  
357 357  
... ... @@ -365,7 +365,6 @@
365 365  **~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**
366 366  
367 367  
368 -
369 369  === 3.2.5 Generate Package Index file ===
370 370  
371 371  
... ... @@ -379,7 +379,6 @@
379 379  (% 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.**
380 380  
381 381  
382 -
383 383  === 3.2.6 Generate Release file ===
384 384  
385 385  
... ... @@ -396,11 +396,9 @@
396 396  (% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**
397 397  
398 398  
399 -
400 400  === 3.2.7 Sign the Release file with gpg and generating Inrelease file ===
401 401  
402 402  
403 -
404 404  ==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====
405 405  
406 406  
... ... @@ -483,7 +483,6 @@
483 483  [[image:1661306420449-569.png]]
484 484  
485 485  
486 -
487 487  === 3.2.9 Configure the gateway's auto-upgrade rules ===
488 488  
489 489  
... ... @@ -509,3 +509,6 @@
509 509  
510 510  
511 511  [[image:1661306487761-768.png]]
720 +
721 +
722 +
image-20230327152105-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +27.5 KB
Content
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