diff --git a/README.md b/README.md index e06241b..0a967a6 100644 --- a/README.md +++ b/README.md @@ -21,6 +21,19 @@ on your device. ![Mender logo](https://github.com/mendersoftware/mender/raw/master/mender_logo.png) +## Requisites + +`mender-convert` is supported on the following development platform(s): + + - Ubuntu 18.04 x86, 64bit + +Other platforms may work, but are not under active testing. Patches to add additional +platforms or fix compatibility issues are welcome. + +The storage used during the process, specifically the work directories (usually below the clone of +`mender-convert`) and the output directory should be located on local, Unix-style filesystem. +Using network storage or emulated filesystems might cause permission or owner issues. + ## Getting started @@ -31,9 +44,39 @@ For more detailed information about `mender-convert` please visit the [Debian family](https://docs.mender.io/artifacts/debian-family) section in [the Mender documentation](https://docs.mender.io/). +## Included configurations + +### Core configurations + +These configurations are officially supported. + +| Configuration | Supported OS / hardware | +| :------------ | :---------------------- | +| generic_x86-64_config | Generic x86, 64bit distribtion *use this as a starting point only!* | +| raspberrypi0w_config | RaspberryPi 0w, Raspbian 32bit | +| raspberrypi3_config | RaspberryPi 3, Raspbian 32bit | +| raspberrypi4_config | RaspberryPi 4, Raspbian 32bit | +| raspberrypi4_ubuntu_config | RaspberryPi 4, Ubuntu 32bit | + +### Contributed configurations + +These configurations have been submitted by community contributors. + +| Configuration | Supported OS / hardware | +| :------------ | :---------------------- | +| beaglebone_black_debian_emmc_config | BeagleBone Black 4GB, Debian 32bit on internal eMMC storage | +| beaglebone_black_debian_sdcard_config | BeagleBone Black, Debian 32bit on external SD card storage | +| comfile_pi_config | Comfile Pi, Raspbian 32bit | +| rockpro64_emmc_config | RockPro64, Debian 32bit on internal eMMC storage | +| rockpro64_sd_config | BeagleBone Black, Debian 32bit on external SD card storage | + +## Example usage: Raspberry Pi 3, Raspbian 32bit ### Prepare image and configuration +The following steps give a quick start using Raspbian. For a more detailed guide, +especially concerning version compatibilities, please visit [the the corresponding thread](https://hub.mender.io/t/raspberry-pi-3-model-b-b-raspbian/140) on the Mender Hub. + Download the raw Raspberry Pi disk image into a subdirectory input: ```bash