DOCS: Add odroid-stamper
This commit is contained in:
@@ -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>
|
||||||
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