amdgpu515 - video driver for AMD Radeon cards and Ryzen graphics, from
GCN 1 (Radeon HD 7000) to RDNA 2 (RX 6000, Ryzen 6000, Steam Deck).
Port of the Linux 5.15 amdgpu driver with its display core (DC).

Families: Southern Islands (HD 7000, R7/R9 200), Sea Islands (R7 260X,
R9 290, Kaveri/Kabini APUs), Volcanic Islands (R9 285/380, Fury, Carrizo),
Polaris (RX 400/500), Vega (RX Vega, Radeon VII), Ryzen APUs with Vega
graphics (Ryzen 2000-5000), Navi 1x (RX 5000), Navi 2x (RX 6000).
The full PCI ID list is in SUPPORTED.md of the sources.

Tested on real hardware: Ryzen 5000U (Lucienne, 1002:164C) only.
On everything else this driver has not run yet.

Files:
  amdgpu515        the loader
  amdgpu515.dll    the driver (same folder as the loader)
  firmware/amdgpu/ <chip>_*.bin (linux-firmware)

The firmware is looked for in /colibrios/drivers/gpu/firmware,
/colibrios/drivers/amdgpu515/firmware and /sys/drivers/firmware, or only
in the folder given with -f.

Usage: <path>/amdgpu515 <command line>

Command line options:
 -l<full path to a log file>  where the driver writes its log.
    No log file without it (messages still go to the debug board).
 -m<width>x<height>[x<refresh>]  initial video mode; the monitor's
    preferred mode when omitted
 -f<folder>  firmware folder (it must contain amdgpu/*.bin)
 -v<0-8>  how much to log, 6 by default, 7 adds debug messages
 -d<hex>  DRM debug categories, e.g. -d1f6 together with -v7

Example:
/colibrios/drivers/gpu/amdgpu515 -l/usbhd0/1/amdgpu515.log -v7

Video decoding (UVD/VCE/VCN) is not used.  The hardware cursor needs the
display core: GCN 1 and Bonaire/Kaveri/Kabini/Mullins use the older
display code and keep the software cursor.  Video modes can be changed in
SYSPANEL -> VideoMode.

If the screen stays black or the system hangs, please keep the log (-l)
and the debug board, and report what happens with your card's PCI ID.
