Skip to content

Commit f572197

Browse files
committed
docs: refresh Extensions List (new extensions, behavior updates)
Add entries for extensions introduced since the initial list: brostrend-aic8800-dkms, gateway-dk-ask, image-output-arduino, photonicat-pm, uboot-binman-fix-pkg-resources. Rewrite grub/grub-riscv64 description to cover the recent framebuffer/splash cmdline changes (GRUB_GFXPAYLOAD_LINUX=text, splash plymouth.ignore-serial-consoles, no quiet/loglevel=3, Ubuntu vt.handoff=7 disabled). Tighten jethub-burn description to match the actual behavior (converts .img to burn image after build). Assisted-by: Claude:claude-opus-4-7
1 parent c3f6f0d commit f572197

1 file changed

Lines changed: 33 additions & 3 deletions

File tree

docs/Developer-Guide_Extensions-List.md

Lines changed: 33 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,12 @@ Sets up Bluetooth via `hciattach` for boards that require serial attachment.
6868

6969
---
7070

71+
## brostrend-aic8800-dkms
72+
73+
Installs the AIC8800 WiFi/BT DKMS driver for BroStrend USB adapters. Fetches the latest `aic8800-dkms` release from `Shadowrom2020/aic8800-dkms` GitHub and builds the kernel module in the chroot. Forces `INSTALL_HEADERS=yes` — requires a kernel with working headers package.
74+
75+
---
76+
7177
## c-plus-plus-compiler
7278

7379
Adds a C++ compiler to host build dependencies. The C++ compiler is no longer included by default; enable this extension when the build requires it.
@@ -136,6 +142,12 @@ Adds XFS filesystem support. Auto-enabled when `ROOTFS_TYPE=xfs`.
136142

137143
---
138144

145+
## gateway-dk-ask
146+
147+
NXP ASK (Application Solutions Kit) integration for the Mono Gateway Development Kit (LS1046A). Builds ASK kernel modules (CDX, FCI, auto-bridge, sfp-led, lp5812) in-tree with the kernel and packages userspace tools (`fmlib`, `fmc`, `libfci`, `libcli`, `dpa-app`, `cmm`) plus patched system libraries and configs into a single `.deb`. Requires iptables at runtime.
148+
149+
---
150+
139151
## gen-sample-extension-docs
140152

141153
Generates extension hook documentation and a sample extension file. Useful for extension developers.
@@ -144,13 +156,13 @@ Generates extension hook documentation and a sample extension file. Useful for e
144156

145157
## grub
146158

147-
Standard GRUB bootloader setup for UEFI-capable boards. Supports `DISTRO_GENERIC_KERNEL` mode.
159+
Standard GRUB bootloader setup for UEFI-capable boards. Supports `DISTRO_GENERIC_KERNEL` mode (uses distro kernel instead of Armbian's). Sets `GRUB_GFXPAYLOAD_LINUX=text` to keep the framebuffer console bound to `fbcon` (prevents a black local console after Plymouth quits on CLI installs), passes `splash plymouth.ignore-serial-consoles` so kernel boot messages remain visible while Plymouth draws the splash on the framebuffer. Deliberately omits `quiet` and `loglevel=3`, and disables Ubuntu's `vt.handoff=7` injection.
148160

149161
---
150162

151163
## grub-riscv64
152164

153-
GRUB bootloader setup for RISC-V 64-bit boards.
165+
GRUB bootloader setup for RISC-V 64-bit boards. Mirrors the console/splash cmdline conventions of the `grub` extension.
154166

155167
---
156168

@@ -172,6 +184,12 @@ Converts the output image to ABL (Android Boot Loader) format using `mkbootimg`.
172184

173185
---
174186

187+
## image-output-arduino
188+
189+
Converts the Armbian image into a QDL-flashable archive for Arduino UNO Q (Qualcomm QRB2210). Fetches Qualcomm flash binaries during image creation.
190+
191+
---
192+
175193
## image-output-oowow
176194

177195
Creates an image compatible with the OOWOW recovery system for Khadas boards.
@@ -216,7 +234,7 @@ Adds USB Mass Storage (UMS) gadget support to the initramfs, allowing the board
216234

217235
## jethub-burn
218236

219-
Adds JetHub device flashing support to the build.
237+
Automatically converts the Armbian `.img` into a JetHub burn image after the main build.
220238

221239
---
222240

@@ -320,6 +338,12 @@ Applies preset first-run configuration specific to the Odin2 gaming device.
320338

321339
---
322340

341+
## photonicat-pm
342+
343+
Installs the `photonicat-pm` DKMS power-management driver for the Ariaboard Photonicat router. Fetches the latest release from `HackingGate/photonicat-pm` GitHub and builds the kernel module in chroot. Skipped on kernels ≥ 6.20. Requires working kernel headers.
344+
345+
---
346+
323347
## preset-firstrun
324348

325349
Applies preset network and first-run configuration to the image (writes `.not_logged_in_yet`).
@@ -368,6 +392,12 @@ Configures the U-Boot boot menu for boards that support it.
368392

369393
---
370394

395+
## uboot-binman-fix-pkg-resources
396+
397+
Patches U-Boot's `binman` tool to use `importlib.resources` instead of `pkg_resources`, restoring build compatibility on hosts with `setuptools >= 82` (which removed `pkg_resources`). Covers U-Boot v2024.x–v2025.04.
398+
399+
---
400+
371401
## uboot-btrfs
372402

373403
Enables Btrfs filesystem support in U-Boot (`CONFIG_CMD_BTRFS`).

0 commit comments

Comments
 (0)