- A list of supported devices can be found here
- This is tool generates guides (GitHub markdown format) for devices supported by Droidian, based on a YAML configuration file.
- The latest version of the devices file is the
devices.yml
. - An empty device template is also provided as
device_template.yml
. - The script depends on the
yaml
andschema
Python packages, you need to install them before using running the script.
These are the parameters used in devices.yml
. Start each device entry with a -
.
manufacturer
: manufacturer of the devicename
: name of the devicecodename
: codename of the devicesupport
:official
orcommunity
device_type
: phone, tablet, etchalium_version
: 9, 10, or 11fastboot_mode
: button combination for booting in fastboot moderecovery_mode
: button combination for booting in recovery modeab_slot
:True
if the device has A/B slots, leave empty if notapi_version
: version of the android API used for the devicearch
: device architecturedroidian_release
: a link to the correspodning Droidian releasedroidian_required_build
: some devices might need a specific build, links to the files can be specified here, otherwise leave emoptyandroid
*: base android version to install before Droidianvendor_zip
*: a vendor package to be flashed as zipvendor_image
*: a vendor image to be flashed as an imageboot
*: Droidian boot imagerecovery
**: recommended recovery for the deviceadaptation
*: adaptation package to be flashed as zipstatuspage
: a link to the porting status page of the device, leave empty if there is no pagecontact
: each contact should start with a-
, as it becomes a list.text
: what the text should say,link
: where the hyperlink should point tocredit
: also a list, each entry should start with a-
.name
: the name of the maintainer,link
: maintainer's pagecommand
: a list of commands that need to be run after first boot, start each line of the commands with a-
notes
: additional considerations for the device, start each note with a-
. A note contains atitle
entry and atext
that contains the note itselfport_status
: please, see thedevice_template.yml
file for details
* android
, vendor_zip
, vendor_image
, and boot
have multiple parts. The link
contains the actual link to the file or release page; the text
contains the string what the download link should say in the page; and the filename
specifies the name of the file that identifies the file when flashing.
** recovery
has two further entry called name
and must_flash
. name
specifies the name of the recovery, e. g., TWRP
or Orange Fox Recovery
; if must_flash
is set to True
, the user will be prompted to flash the recovery instead of just booting it (some devices have been reported to not support directly booting to the recovery image)