⚠️ EXPERIMENTAL · UNSUPPORTED · USE AT YOUR OWN RISK

This is an unofficial, experimental CoreELEC 22 build. It is NOT an official
CoreELEC release and it is NOT a supported CE22 port. I am not a CoreELEC 22
port maintainer, and I will not be providing support, bug fixes, updates, or
ongoing maintenance for this build.

The only purpose of this build is to give Amlogic AM9 Pro-class users a more
complete Dolby Vision experience than stock CoreELEC 22, by carrying a set of
custom Kodi features I built for my own device. That is the entire scope.

READ THIS BEFORE YOU FLASH ANYTHING

• USE ENTIRELY AT YOUR OWN RISK. There is no warranty of any kind, express
  or implied. It may fail to boot, misbehave, break Dolby Vision, or do nothing
  useful on your hardware.
• BACK UP YOUR CURRENT INSTALLATION FIRST. Take a full CoreELEC backup
  (Settings → CoreELEC → Backup) and/or image your existing boot media before
  you install anything from here. Assume you may have to restore it.
• Prefer a SEPARATE SD card or USB stick you can boot from, instead of
  overwriting a working internal (eMMC) install.
• Do NOT report problems with this build to the CoreELEC team or forums.
  This is not their build; it is not their responsibility. Do not ask them to
  support it.
• I am also not offering support. If it breaks, you keep both pieces.

By downloading or using any file in this release you accept all of the above.

Install

• Clean install (recommended): flash the *.img.gz to an SD card or USB with
  balenaEtcher (or the Amlogic USB Burning Tool for eMMC), then boot from it.
• In-place update: copy the *.tar to the /storage/.update folder on an
  existing CoreELEC install and reboot. (Back up first — see above.)
• Verify your download against the SHA256 sums below before flashing.

What's changed in this update

⚠️ READ THIS FIRST — Ugoos firmware 2.2.0 is now REQUIRED

If your AM9 or AM9 Pro is on firmware 2.1.0 or older, do not install this build.
You will get no picture.

This has been flagged before, but it lands for real in this release, so it is worth
repeating in full.

Upstream CoreELEC has reverted the S6 device-tree workaround that kept older Ugoos
firmware working. Every S6 interrupt — video vsync, HDMI, the video decoder, i2c,
RDMA, deinterlacer and GE2D — is now declared level-triggered instead of
edge-triggered, which is what Amlogic's own device tree has always specified. That
only works when the bootloader underneath programs the interrupt controller to
match, and only firmware 2.2.0 does.

Upstream's own words on the change: "Fixes Ugoos AM9 and AM9 PRO with firmware
v. 2.2.0. Doesn't work anymore with older firmware — needs to be updated."

This is not a choice this fork made — it comes straight from upstream CoreELEC,
and upstream is no longer supporting the older firmware. Carrying a second device
tree forever to work around it is not something this build is going to do.

Update in this order — this part matters

You do not have to choose between a working box and a working build. Do it in this
order and the box carries the update across the firmware change for you:

1. Copy this release into your update folder the way you normally would — the
   Update network share, or /storage/.update. Do not reboot into CoreELEC yet.
2. Power menu → Reboot from eMMC/NAND. The box boots Android. Your update is
   left sitting where you put it, untouched — CoreELEC only installs an update when
   CoreELEC itself starts up, and it did not start up.
3. Update the box to firmware 2.2.0 from Android, following Ugoos's instructions.
4. Reboot. You do not need to change anything back: booting from eMMC/NAND is a
   one-shot, and the box returns to your SD card or USB stick on its own.
5. CoreELEC starts, finds the update waiting, installs it, and comes up on 2.2.0.

The point of that order is that this build's first boot is already on the firmware
it needs. You never see a black screen, and you never have to get a file onto the
card from a PC.

If you install this on older firmware anyway

You will get a black screen or a boot loop. The box is not damaged. Go back to
the previous release, or update the firmware, and this build will come up normally.

This is an incremental update to
v22.0-samurihl-20260908213005
(see that release and its predecessors for the standing feature set: Blu-ray disc
menus, HDR10+ → Dolby Vision conversion, DV → HDR10 that stays in HDR10, FEL
profile-7 reconstruction on non-DV displays, VS10 output on non-DV displays, VSVDB
override, tone-mapping target controls, disc-stated menu detection and episode
lists).

⚠️ Still experimental and completely unsupported — see the disclaimer above.
Back up your current install before flashing.

Dolby Vision still requires dovi.ko (the CE22 5.15 build) installed on your
device — it is not bundled; install it yourself exactly as on stock CoreELEC 22,
unmodified.

This release is an upstream sync

There is no new feature work from this fork in this build. Every fork feature from
the previous release is carried forward unchanged. What you are getting is the whole
of current upstream CoreELEC underneath them, which had moved a long way ahead.

Dolby Vision / HDR

• S6 interrupt handling now matches Amlogic's device tree (the firmware
  requirement above). Amlogic's fix addresses interrupts being lost when the CPU
  cluster changes frequency.

Subtitles

• PG (Blu-ray) subtitle colour on HDR discs is now handled by upstream. Upstream
  added their own mechanism — the PGS decoder is told the video's colorimetry
  directly, with a matching ffmpeg change letting the caller choose the palette
  matrix. This replaces the palette pre-inversion this fork carried, and covers
  subtitles in HDR files as well as on disc.

  Menu graphics on PQ-authored discs — BD-J overlays and HDMV pop-up menus — continue
  to use this fork's own colour handling, which upstream does not have.

  If PG subtitle colour looks wrong to you on an HDR disc, please report it: this is
  the one behaviour in this release that changed hands.

Also from upstream

• libnfs 7.0.2 — worth knowing if you stream from NFS.
• ffmpeg PGS palette patch (see above).
• tee-loader gains Android 9 NO_TEE support.
• Library refresh: libxml2 2.15.4, taglib 2.3.2, libpcap 1.10.7, xmlstarlet 1.7.0.
• pvr.mythtv 22.3.14-Piers.
• Fire TV Cube 3rd gen reboot handling (unrelated to Ugoos hardware).

Source

• CoreELEC (distro): SamuriHL/CoreELEC tag v22.0-samurihl-20260909114220
• Kodi: SamuriHL/coreelec-xbmc tag v22.0-samurihl-20260909114220

Checksums (SHA256)

30e69dcaafc02cbe6e114ecd8994cb2627b9a65f0e31efcfbb189feaa7097d85  CoreELEC-Amlogic-no.aarch64-22.0-Piers-samurihl-EXPERIMENTAL_20260909114220.tar
88aa5f92e8db51acc49b2cf0686e40153643825ce67493339d09eeff77d1fef8  CoreELEC-Amlogic-no.aarch64-22.0-Piers-samurihl-EXPERIMENTAL_20260909114220-Generic.img.gz