DOCS: Add odroid-stamper
This commit is contained in:
@@ -17,6 +17,7 @@
|
||||
<toc-element toc-title="Odroid">
|
||||
<toc-element topic="Change-kernel-version.md"/>
|
||||
</toc-element>
|
||||
<toc-element topic="Use-ODROID-STAMPER.md"/>
|
||||
<toc-element toc-title="About">
|
||||
</toc-element>
|
||||
</instance-profile>
|
||||
116
Writerside/topics/Use-ODROID-STAMPER.md
Normal file
116
Writerside/topics/Use-ODROID-STAMPER.md
Normal 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`
|
||||
|
||||
Reference in New Issue
Block a user