https://github.com/basilfx/riot-ubuntu-image
Tools to create an Ubuntu image with RIOT-OS dependencies.
https://github.com/basilfx/riot-ubuntu-image
Last synced: about 1 year ago
JSON representation
Tools to create an Ubuntu image with RIOT-OS dependencies.
- Host: GitHub
- URL: https://github.com/basilfx/riot-ubuntu-image
- Owner: basilfx
- License: mit
- Created: 2017-11-02T08:12:16.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-02T08:25:37.000Z (over 8 years ago)
- Last Synced: 2025-01-14T01:14:19.815Z (over 1 year ago)
- Language: Shell
- Size: 5.86 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Image Customizer
This utility can customize an Ubuntu Image. It unpacks, customizes and repacks it.
## Installation
Requirements:
* A Ubuntu machine.
* `sudo apt-get install squashfs-tools`
* `sudo apt-get install git`
## Usage
First, download a Ubuntu-base image. For instance, the default Ubuntu x64 desktop image.
* To unpack: `customizer.sh unpack -i -t `
* To customize: `customizer.sh customize -t `
* To repack: `customizer.sh repack -t -o `
This script may ask for credentials (for `sudo` commands). There is no error handling, so enter it right otherwise the script will fail.
Ensure you run this script with the shell locale set to `en_US.UTF-8`, because this is the default live CD locale. If not, run this before any other commands:
```
export LC_ALL=en_US.UTF-8
export LANG=en_US.UTF-8
```
To start from scratch, clear the target directory.
The resulting ISO can be burned on DVD, or on a USB stick (don't use cheap ones!).
## Development
Jobs are stored in the `jobs/` folder. They are executed alphabetically.
The jobs ending with `*.chroot` are executed within the chroot. After that, the jobs ending with `*.sh` are executed globally.
## Testing
To ensure the image is complete and working, try the following things:
* Boot the image.
* Check if Eclipse is working. Under Help -> Installation Details, verify if the ARM plugins are available.
* Check if the ARM GCC Embedded tools are available.