DOCS: Add odroid-stamper

This commit is contained in:
2025-01-13 17:01:04 +09:00
parent 8814f12be4
commit e2fd2fd3d6
2 changed files with 117 additions and 0 deletions

View File

@@ -17,6 +17,7 @@
<toc-element toc-title="Odroid"> <toc-element toc-title="Odroid">
<toc-element topic="Change-kernel-version.md"/> <toc-element topic="Change-kernel-version.md"/>
</toc-element> </toc-element>
<toc-element topic="Use-ODROID-STAMPER.md"/>
<toc-element toc-title="About"> <toc-element toc-title="About">
</toc-element> </toc-element>
</instance-profile> </instance-profile>

View File

@@ -0,0 +1,116 @@
# Use ODROID-STAMPER
[`odroid-stamper`](https://github.com/tobetter/odroid-stamper) is Odroid Image Generation Tool.
## Basic usage
```Bash
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
```
```Plain Text
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
```Bash
$ ./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.
```Bash
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.
```Bash
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.
```Plain Text
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.
```Bash
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.
```Plain Text
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`