Khadas Docs

Amazing Khadas, always amazes you!

User Tools

Site Tools


Sidebar

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

This is an old revision of the document!


OOWOW Online-installation images

Basic Requirements

WIP:

  • System must workable for any board revision
  • Image writing size small as possible, no need to rewrite the whole eMMC content, same as writing unused empty spaces
  • Image writing size not be bigger what's possible smallest storage board configurations
  • Any private data not allowed
  • Any malware spyware etc … will be banned
  • Clean trash, logs, cache, etc … before packing installation image
  • Use optimal compression via xze
  • Use meta descriptions for images via xze
  • Basic Khadas file-name format for installation images
  • WIP:

Image Size

Try to make the installation image size small as possible

The simple dump from EMMC is the wrong way. Yes we can do it but, this image will have negative parts like:

  • some garbage in unused space
  • same fill EMMC size which will be written as is

It's possible to improve by dump-optimization, but don't have any warranty to get quality results

Partitions

Fenix Builds

for Fenix builds need to use normal partitions (like GPT or DOS ) please don’t use Amlogic partitions variant (just if its really necessary)

...
Choose install type:
2. SD-USB - Image For Writing to SD/USB Storage
...
Compress image:
Yes

Compress image option, automatically build image suitable for OOWOW

WIP:

Dump optimization

  • Prepare all content on eMMC (clean cached, temp, logs, files manually by hand)
  • Boot into OOWOW
  • 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
  • Repack it by xze, if need to use it for online installation

Be sure your system must resize root-fs back to maximal size automatically at 1st boot, for example resize2fs /dev/rootfs

Basic Khadas file-name format

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/

See also

Last modified: 2023/07/05 22:32 by hyphop