[Перевод] Цвет в Wii-режиме Wii U «плыл» 13 лет из-за двух опечаток в прошивке

Wii U умеет запускать игры для Wii в режиме обратной совместимости, его обычно называют vWii. В теории это отличный способ играть в старые игры на современном телевизоре: у Wii U есть HDMI-выход. На практике Wii-режим выглядит неважно. Забавно, но картинка с оригинальной Wii бывает лучше.
Главных проблем две: изображение принудительно обрезается по краям, а цвет «растекается» за пределы объектов.

Жалобы на это появились ещё в 2013 году, вскоре после выхода Wii U, но исправления так и не выпустили.
В этой статье разберём, как устроена графика Wii-режима, как две простые опечатки в прошивке привели к этим дефектам и что общего у Wii U с современными видеокартами AMD.
DMCU
Так кто же виноват? Один из подозреваемых — DMCU. Для краткого знакомства процитирую описание из поста fail0verflow о Wii U 2014 года:
Вы могли заметить, что старый добрый VI (контроллер дисплея, Video Interface, из GameCube и Wii) пропал. Как же так? Оказывается, его эмулируют программно и переводят его настройки в регистры CRTC от R7xx. Но где работает эта эмуляция? Хитро: в Latte добавили отдельный микроконтроллер ровно для этой задачи. DMCU — это 8-битный процессор, совместимый с 68HC11, и его единственное предназначение — эмуляция VI. Спереди у него аппаратная прослойка, которая для программ Wii выглядит как VI, а за кулисами он переводит эти регистры в регистры Radeon, включая настройки масштабирования. Прошивку DMCU загружает cafe2wii (в режиме Wii U DMCU, похоже, не работает). У него своя выделенная RAM и доступ как к обратной стороне фальшивого VI, так и к области регистров Radeon. […]
Чтобы докопаться до причины, я решил отреверсить прошивку DMCU. Она лежит во встроенной памяти Wii U и загружается в RAM микроконтроллера перед запуском cafe2wii. К сожалению, мой любимый инструмент для реверса Ghidra не поддерживает HC11, поэтому в 2024 году я написал для него собственную спецификацию процессора. К счастью, в Ghidra уже были HCS08 и HCS12, и на них можно было опереться.
Потом я несколько дней разбирал прошивку DMCU. Сама она довольно простая. У DMCU есть интерфейс доступа к 32-битным регистрам контроллера дисплея. Аппаратная прослойка фальшивого VI вызывает в прошивке прерывания, а прошивка в ответ настраивает контроллер дисплея.
Причина обрезанной картинки нашлась быстро. DMCU настраивает viewport контроллера дисплея так, чтобы имитировать overscan, то есть заход изображения за края экрана старого телевизора. Из-за этого срезается до 16 пикселей, и в некоторых играх это выглядит плохо. Лечится легко: достаточно пропатчить байты прошивки и поменять значения, которые пишутся в регистры viewport.
DMCU у AMD
Чего fail0verflow тогда не знали или по крайней мере не упомянули: DMCU — не специальный микроконтроллер для Wii U, он есть и в других видеочипах AMD. В патче, который сотрудник AMD отправил в рассылку amd-gfx в 2018 году, сказано:
DMCU (Display Microcontroller Unit) — блок GPU, который участвует в функциях eDP, таких как Adaptive Backlight Modulation и Panel Self Refresh.
Теперь хотя бы понятно, как расшифровывается DMCU. Но неужели это тот же самый блок, что и в Wii U? В репозитории linux-firmware лежит несколько бинарных прошивок DMCU для разных GPU, например, для Raven. Я скачал raven_dmcu.bin и navi12_dmcu.bin и написал небольшую утилиту, которая разбирает заголовки этих файлов и извлекает ту часть, что на самом деле загружается в ERAM.
Загрузив прошивки DMCU от Raven и Navi 12 в Ghidra, я убедился, что и в новых видеочипах AMD DMCU по-прежнему построен на M68HC11. Даже интерфейс к контроллеру дисплея почти такой же, как в Wii U.
Декомпиляция DMCU
Патчить байты в готовой прошивке мне надоело, и я решил декомпилировать её в C. Заодно это позволило бы глубже разобраться, как всё устроено.
Сначала нужен был подходящий тулчейн. Когда-то в основной ветке GCC была поддержка M68HC11 и M68HC12. Последний релиз с ней — GCC 3.3.5 2005 года. В следующих версиях поддержку сломали, а потом и вовсе удалили. В итоге я наткнулся на сборки 2006 года на личном сайте Стефана Карреза, автора исходного порта. Так у меня оказались GCC 3.3.6 и binutils 2.15. Пока сойдёт.
К моему удивлению, с этим компилятором удалось вручную добиться побайтового совпадения целых функций с оригинальной прошивкой DMCU из Wii U. Для подбора я сделал модифицированную версию decomp.me с поддержкой этого компилятора.
Например, следующая функция (собранная командой gcc3.3.6-m68hc1x-20060122 -Os -m68hc11 -fomit-frame-pointer -mshort) побайтово совпадает с кодом в прошивке DMCU из Wii U.
void FUN_0e3b(FVIVideoMode videoMode, FVIState* state)
{
uint32_t postBlanking = 0;
uint32_t preBlanking = 0;
uint32_t uVar2 = 0;
uint32_t uVar3 = 0;
if (videoMode == FVI_VIDEO_MODE_288P_312 ||
videoMode == FVI_VIDEO_MODE_240P_262) {
preBlanking = state->preBlanking;
postBlanking = state->postBlanking + 1;
uVar2 = state->unk0x0C - 1;
uVar3 = state->unk0x14 + 2;
} else if (videoMode == FVI_VIDEO_MODE_288P_313 ||
videoMode == FVI_VIDEO_MODE_240P_263) {
preBlanking = state->preBlanking;
postBlanking = state->postBlanking - 1;
uVar2 = state->unk0x0C + 1;
uVar3 = state->unk0x14 - 2;
}
DEINT_Lock();
FUN_1292();
DC_Write32(0x10A6, postBlanking | (preBlanking << 16) | 0x80008000ul);
DC_Write32(0x10A7, uVar3 | (uVar2 << 16) | 0x80008000ul);
DAT_0120 = 1;
FUN_133f();
DEINT_Unlock();
DEBUG_Write0x6(0x40);
}
Похоже, AMD или Nintendo (не знаю точно, кто писал прошивку DMCU для Wii U) при её разработке пользовались тем самым портом GCC Карреза 2006 года. Пользуются ли до сих пор? Добиться точного совпадения с прошивками DMCU для Raven и Navi 12 мне, увы, не удалось. Возможно, там какие-то хитрые флаги компилятора, которые я не подобрал, а может быть, и вовсе другой компилятор.
По ходу реверса я заметил любопытную вещь. Библиотека nn_cmpt.rpl, которая загружает прошивку DMCU, записывает текущее разрешение экрана прямо в середину ERAM микроконтроллера. Сама прошивка эти значения не использует, зато они затирают инструкции посреди её кода. По чистой случайности затёртые функции оказались неиспользуемыми, поэтому ничего не ломается. Свою прошивку я загружаю тем же способом, что и оригинальную, так что в декомпиляции это пришлось учесть отдельно: я выделил под разрешения отдельную «дыру», разместил секцию кода перед ней, а крупные функции вручную вынес в секцию за ней.
Вручную декомпилировав всю прошивку DMCU в C, я получил функционально эквивалентную прошивку. Не каждая функция совпадает побайтово, но мне этого достаточно. В 2025 году я выложил её под названием OpenDMCUFirm в надежде, что другие помогут присмотреться к ней внимательнее.
Откуда берутся цветовые затёки
Через несколько месяцев после выпуска OpenDMCUFirm я заметил в прошивке DMCU две ошибки, из-за которых в Wii-режиме и растекается цвет.
Прошивка DMCU обрабатывает события в главном цикле. События порождаются прерываниями от аппаратной прослойки фальшивого VI. В обработчике прерывания биты статуса из регистра FVI сопоставляются событиям, которые потом обрабатывает главный цикл. Код выглядит примерно так:
struct {
uint32_t inStatus;
uint16_t outEvent;
} irqEventMasks[4] = {
{ 0x00000003, DMCU_EVENT_0, },
{ 0x08007B1C, DMCU_EVENT_1, },
{ 0x07C084E0, DMCU_EVENT_2, },
{ 0x003C0000, DMCU_EVENT_3, },
};
uint32_t irqStatus = DC_Read32(0x1061);
uint32_t eventFlags = gDmcuState.eventFlags;
for (uint32_t i = 0; i < 4; i++) {
if (!(irqStatus & irqEventMasks[i].inStatus)) {
continue;
}
handledFlags |= irqStatus & irqEventMasks[i].inStatus;
flags = irqStatus >> DMCU_EVENT_ACTIVE_SHIFT;
if ((flags & irqEventMasks[i].outEvent & 0xf) != 0) {
eventFlags |= irqEventMasks[i].outEvent << DMCU_EVENT_RETRIGGER_SHIFT;
} else {
eventFlags |= irqEventMasks[i].outEvent;
}
}
gDmcuState.eventFlags = eventFlags;
Если событие уже обрабатывается главным циклом, оно помечено как «активное». Обработчик прерывания это проверяет и вместо постановки в очередь помечает событие для «повторного запуска». Тогда главный цикл сразу после возврата из обработчика вызывает его ещё раз:
getEventHandler(&eventHandler, &eventMask, gDmcuState.eventFlags & 0xF);
// ...
IRQ_Lock();
gDmcuState.eventFlags = (gDmcuState.eventFlags | (eventMask << DMCU_EVENT_ACTIVE_SHIFT)) & ~eventMask;
IRQ_Unlock();
do {
eventHandler(&gDmcuState);
if (((gDmcuState.eventFlags >> DMCU_EVENT_RERUN_SHIFT) & eventMask) != 0) {
gDmcuState.eventFlags &= ~(eventMask << DMCU_EVENT_RERUN_SHIFT);
} else if ((gDmcuState.eventFlags >> DMCU_EVENT_RETRIGGER_SHIFT) & eventMask & 0xf) {
gDmcuState.eventFlags &= ~(eventMask << DMCU_EVENT_RETRIGGER_SHIFT);
} else {
IRQ_Lock();
gDmcuState.eventFlags &= ~(eventMask << DMCU_EVENT_ACTIVE_SHIFT);
IRQ_Unlock();
goto loop_start;
}
} while (1);
Только вот в обработчике прерывания, похоже, кто-то опечатался. Вместо того чтобы проверять бит активности события в eventFlags, код проверяет его в irqStatus, то есть в аппаратном регистре статуса. Если в регистре статуса прерываний случайно взведён бит, соответствующий активности события, событие помечается для «повторного запуска» и так и не ставится в очередь. А значит, главный цикл его вообще никогда не обрабатывает. Исправление совсем простое:
-flags = irqStatus >> DMCU_EVENT_ACTIVE_SHIFT;
+flags = eventFlags >> DMCU_EVENT_ACTIVE_SHIFT;
Я проверил это на железе и убедился, что так происходит с событиями 2 и 3. Они выполняются один раз, после чего навсегда застревают в состоянии «повторного запуска» и больше не обрабатываются. И всё из-за простой опечатки.
Для чего же нужны события 2 и 3? Обработчик события 2 выставляет в блоке регистров DEINT бит CBCR_SWAP в зависимости от горизонтального начала изображения (код):
// This register consists of (HBS << 16) | HBE
// See YAGCD 5.3 VI - Video Interface: HTR1 - Horizontal Timing 1
DC_PerformRead(0x1082);
uint8_t hbe = DC_Get8(0);
DEINT_Lock();
if ((hbe & 0x1) == 0) {
DEINT_EnableCBCRSwap();
*outEnabled = TRUE;
} else {
DEINT_DisableCBCRSwap();
*outEnabled = FALSE;
}
DEINT_Unlock();
В этой функции, кстати, есть ещё одна опечатка. Вероятно, её никто не заметил, потому что обработчик ни разу не срабатывал. CBCR_SWAP нужно включать при нечётном начале строки, код же включает его при чётном. Исправление снова совсем простое:
-if ((hbe & 0x1) == 0) {
+if ((hbe & 0x1) != 0) {
Эти две правки устраняют цветовые затёки.
Для чего нужен обработчик события 3, я пока точно не знаю. Без него видимой разницы, кажется, нет. Он похож на обработчик события 1, так что, возможно, его функции перенесли туда, когда заметили, что он не работает.
Как попробовать


Исправления лежат в ветке custom репозитория OpenDMCUFirm. Эту версию прошивки можно загрузить с помощью свежего релиза evWii. Напишите, как у вас выглядит картинка!
KioskNews shows a cleaned-up reading view extracted from the publisher’s page — the original always lives on their site, not ours.