Files
public-docs/Writerside/topics/Use-ODROID-STAMPER.md

4.1 KiB

Use ODROID-STAMPER

odroid-stamper is Odroid Image Generation Tool.

Basic usage

sudo apt install git wget dialog pv lynx qemu-user-static\
 dialog rsync squashfs-tools uuid-runtime
 
git clone https://github.com/tobetter/odroid-stamper.git
cd odroid-stamper
export ODROID_STAMPER_CHECKOUT=$PWD
sudo -E ./odroid-stamper
 ODROID-STAMPER
┌───────────────────────Custom Ubuntu Recipe─────────────────────────┐
│ Please customize the installation.                                 │
│ ┌────────────────────────────────────────────────────────────────┐ │
│ │                  0  Target ()                                  │ │
│ │                  1  Board ()                                   │ │
│ │                  2  Distro (focal)                             │ │
│ │                  3  Flavour (server)                           │ │
│ │                  4  Default user                               │ │
│ │                  5  Password of default user                   │ │
│ └────────────────────────────────────────────────────────────────┘ │
├────────────────────────────────────────────────────────────────────┤
│             <  OK  >       < Done >       <Cancel>                 │
└────────────────────────────────────────────────────────────────────┘

Once you select the board and other settings you want, the image will be built.

In the command line

$ ./odroid-stamper --help
Usage: odroid-stamper [--help] [--output=<path>] [--live]

    --help: this help message
    --output=<path>: output directory for image files.
    --iso: build target OS image as ISO format.
    --live: enforce to build live boot system image.
    --compress: compress the final OS image using 'xz'.
    --keep-builddir: prevent removing temporary directory
                     after building an image.
    --kernel: kernel package name to use
    --linuxfactory: alternative server IP address of 'ppa.linuxfactory.or.kr'

You can use it from the command line as below.

export ODROID_STAMPER_CHECKOUT=$PWD
sudo -E ./odroid-stamper --compress --board=odroidm2 --distro=focal\
 --flavour=server --username=odroid --password=odroid

Use custom

If you want to add the packages you want during odroid-stamper operation, Use custom directory.

For example, if you want build custom/npu image, use command below.

export ODROID_STAMPER_CHECKOUT=$PWD
sudo -E ./odroid-stamper --custom=npu

Custom/npu is structured as follows.

  • config
  • fixups
  • overlay
  • packages

config

config Defines the default settings for the image.

BOARD=odroidm1
ARCH=arm64
DISTRO=focal
FLAVOUR=gnome-desktop
DEFAULT_USER=odroid
DEFAULT_PASSWD=odroid
ALLOW_ROOT_LOGIN=false

You can override it on the command line.

export ODROID_STAMPER_CHECKOUT=$PWD
sudo -E ./odroid-stamper --custom=npu --board=odroidm2 --distro=noble

package

package is a list of packages to be installed during image generation.

cmake
g++
git
libopencv-dev
librga-dev
python3-dev
python3-pip
python3-venv
python3.9
python3.9-dev
python3.9-venv

fixup

The script in the fixup directory is executed during image generation. It also runs the fixup script located in the custom/npu/fixup directory.

overlay

The file to add based on the / path. custom/etc/udev/rules.d/99-odroid-video.rules file will be copied in /etc/udev/rules.d/99-odroid-video.rules