Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools

Home / software / oowow / dev / oowow-online-installation-images
software:oowow:dev:oowow-online-installation-images

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Last revision Both sides next revision
software:oowow:dev:oowow-online-installation-images [2023/07/05 22:15]
hyphop [See also] 		software:oowow:dev:oowow-online-installation-images [2023/09/26 00:01]
hyphop [Armbian external mirrors usage]
Line 1: Line 1:
-~~tag>oowow develop online-installation images ~~+~~tag>oowow develop online-installation images xze ~~
  
 ====== OOWOW Online-installation images ====== ====== OOWOW Online-installation images ======
Line 13: Line 13:
   * Any malware spyware etc ... will be banned   * Any malware spyware etc ... will be banned
   * Clean trash, logs, cache, etc ... before packing installation image   * Clean trash, logs, cache, etc ... before packing installation image
-  * Use optimal compression via ''xze'' +  * Use optimal compression via [[#xze]] 
-  * Use meta descriptions for images via ''xze'' +  * Use meta descriptions for images via [[#xze]] 
-  * Basic Khadas file-name format for installation images+  * Use [[#basic-khadas-file-name-format|Basic Khadas file-name format]] for installation images
   * WIP: ...    * WIP: ... 
  
Line 61: Line 61:
   * Before make dump from eMMC need make some optimization via __ OOWOW => shell __ ''RESIZE=1 mmc_optimize''   * Before make dump from eMMC need make some optimization via __ OOWOW => shell __ ''RESIZE=1 mmc_optimize''
   * Make an eMMC dump to SD/USB it will be automatically decreased as possible   * Make an eMMC dump to SD/USB it will be automatically decreased as possible
-  * Repack it by ''xze'', if need to use it for online installation +  * Repack it by [[#xze]], if need to use it for online installation 
  
 <WRAP important > <WRAP important >
Line 71: Line 71:
  
 WIP: ... WIP: ...
 +```
 +SYNTAX:  boardname-system[-info]+.img[.xz|gz|zst]
 +```
 +
 +All in lowercase only, use '-' as splitter, no spaces, no Unicode only basic Latin ... chars, file-name size less 80 symbols.  
  
 Examples: https://dl.khadas.com/.images/vim4/ Examples: https://dl.khadas.com/.images/vim4/
 +
 +===== XZE =====
 +
 +We recommend using [[https://github.com/khadas/krescue/blob/master/tools/xze|xze]] features for image developers, to provide better service for users like as:
 +
 +  * Provide additional meta information about images
 +  * Its fully compatible with the common xz format, and same possible to use anywhere 
 +  * Fast-checking image integrity before writing it
 +  * Make a warranty it will be suitable for the current board installation
 +  * Fast optimal compression for fastest decompression on SBC
 +  * Image signup
 +  * etc...
 +
 +==== XZE usage examples ====
 +
 +The packing process is very simple just need to add some additional meta information ...
 +
 +```sh pack raw image 
 +xze "vim1s-ha-supervised-debian-11-minimal-linux-5.4-fenix-1.5.1-230623.img" \
 + --meta \
 + label="Home Assistant" \
 + builder="Repack" \
 + date="$(LANG=C TZ= date)" \
 + match=BOARD=VIM1S \
 + link=https://www.home-assistant.io/ \
 + duration=180 \
 + desc="Home Assistant / debian 11 / linux 5.4 / fenix 1.5.1 / 230623"
 +```
 +
 +Also, we can get full information about xze-packed image
 +
 +```sh check image meta info
 +
 +./xze YOUR-IMAGE.img.xz 
 +
 +```
 +
 +Just one more example 
 +
 +```shell 
 +~$ ./xze edge2-openfyde-r114.img.xz 
 +Strms  Blocks   Compressed Uncompressed  Ratio  Check   Filename
 +    2     110  1,456.4 MiB  9,786.1 MiB  0.149  CRC64   edge2-openfyde-r114.img.xz
 +[i] blocks: 110 // 1,456.4*MiB // 9,786.1*MiB
 +##META_FILE##
 +FILE: edge2-openfyde-r114.img.xz
 +UNPACKED_SIZE: 10261445120
 +PACKED_SIZE: 1527136256
 +FILE_SIZE: 1527140352
 +##META-FILE##
 +
 +##KRESCUE_META##
 +type:xz
 +label: openFyde
 +date: Sat Jul 15 04:18:38 UTC 2023
 +match: BOARD=Edge2
 +builder: openFyde
 +link: https://openfyde.io/
 +desc: openFyde for Khadas Edge2
 +duration: 60
 +image: edge2-openfyde-r114.img
 +##KRESCUE-META##
 +##KRESCUE##END
 +```
 +
 +Last one is web usage
 +
 +```shell get meta info 
 +~$ IMAGE_LINK=https://github.com/openFyde/overlay-edge2-openfyde/releases/download/r114/edge2-openfyde-r114.img.xz
 +
 +~$ curl -s -jkLf -r-4096 "$IMAGE_LINK" | xz -dc 
 +
 +##META_FILE##
 +FILE: edge2-openfyde-r114.img.xz
 +UNPACKED_SIZE: 10261445120
 +PACKED_SIZE: 1527136256
 +FILE_SIZE: 1527140352
 +##META-FILE##
 +
 +##KRESCUE_META##
 +type:xz
 +label: openFyde
 +date: Sat Jul 15 04:18:38 UTC 2023
 +match: BOARD=Edge2
 +builder: openFyde
 +link: https://dl.khadas.com/
 +desc: openFyde for Khadas Edge2
 +duration: 60
 +image: edge2-openfyde-r114.img
 +##KRESCUE-META##
 +##KRESCUE##END
 +
 +```
 +
 +
 +
 +===== Armbian external mirrors usage =====
 +
 +[[armbian-images]]
 +
 +^ Khadas image name                               ^ external link                                                   ^
 +| edge2-armbian-jammy-legacy-cli.img.xz           | https://redirect.armbian.com/khadas-edge2/Jammy_legacy          |
 +| edge2-armbian-jammy-legacy-desktop-xfce.img.xz  | https://redirect.armbian.com/khadas-edge2/Jammy_legacy_xfce     |
 +| edge2-armbian-jammy-legacy-minimal.img.xz       | https://redirect.armbian.com/khadas-edge2/Jammy_legacy_minimal  |
 +
 +
 +```shell link setup
 +@web:/storage/.images/edge2$ grep "" edge2-armbian*
 +edge2-armbian-jammy-legacy-cli.img.xz:https://redirect.armbian.com/khadas-edge2/Jammy_legacy.oowow
 +edge2-armbian-jammy-legacy-desktop-xfce.img.xz:https://redirect.armbian.com/khadas-edge2/Jammy_legacy_xfce.oowow
 +edge2-armbian-jammy-legacy-minimal.img.xz:https://redirect.armbian.com/khadas-edge2/Jammy_legacy_minimal.oowow
 +
 +@web:/storage/.images/edge2$ chmod 0667 edge2-armbian*
 +
 +
 +```
  
 ===== See also ===== ===== See also =====
Last modified: 2023/09/26 00:12 by hyphop

Page Tools

Khadas Site

Khadas Community

Khadas GitHub

Khadas Downloads