[Armbian build PR] - extensions: `image-output-oowow`: creates Khadas oowow compatible images

extensions: image-output-oowow: creates Khadas oowow compatible images

• extensions: image-output-oowow: creates Khadas oowow compatible images
  • requires KHADAS_OOWOW_BOARD_ID set in board file (see next commit)
  • always produces xz-compressed images, so this automatically disables COMPRESS_OUTPUTIMAGE
  • uses xze script from Khadas, forcing IN and OUT env vars so it's not confused by fd 1
  • to use, add EXT=image-output-oowow parameter to build
  • to get into oowow:
    • VIM3/VIM3L:
      • download oowow SD card image from Khadas:
        • VIM3: https://dl.khadas.com/products/oowow/system/vim3-oowow-latest-sd.img.gz
        • VIM3L: https://dl.khadas.com/products/oowow/system/vim3l-oowow-latest-sd.img.gz
      • write image to SD card, use BalenaEtcher or similar
      • insert SD card into board (and remove NVMe if present and bootable)
      • boot board into Upgrade mode, see https://docs.khadas.com/products/sbc/vim3/install-os/boot-into-upgrade-mode
      • oowow should be running now
      • recommended: go into Advanced and reset to factory defaults, so MCU, PCIe/USB3 etc is reset to defaults
    • VIM4/VIM4N/VIM1S/Edge2: those have oowow in SPI from factory, check out the manual
  • there's a few ways to use these images with oowow:
    • Using External media
      • prepare media (USB), format it with ext4 or fat, copy produced oowow.img.xz to it
        • for ease of use, rename the image file, so it begins with the board-id (vim1s-/vim4-/edge2- etc)
      • boot board into oowow (see oowow's manual)
      • insert media into board
      • exit wizard, use "Write image to eMMC", browse to "../"
        • change from "XXXX only" to "All" if you didn't rename the image
      • choose image file and write
      • (remove SD card if using one) and reboot
    • Via network (Ethernet or Wi-Fi)
      • boot board into oowow
      • plug in Ethernet cable or connect to Wi-Fi (see oowow's manual)
      • set the firewall mode to "allow" in oowow's Network Settings (see oowow's manual)
      • obtain the IP address of the board in oowow (usually shown on top of the screen, or see manual)
      • from a remote machine, use curl to upload and write the image to oowow's eMMC, example:
        • curl -L <ip_address>/shell/write | sh -s - <image_filename>.oowow.img.xz
      • reboot board
    • From the Internet (one day)
      • when Khadas publishes Armbian oowow images to their HTTP server
• khadas boards: VIM1S/3/3L/4/Edge2: add KHADAS_OOWOW_BOARD_ID definition for use with oowow (EXT=image-output-oowow)

View the full article