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

Прокомментировать Просмотры: 3

Цветовые затёки в Super Mario Sunshine и The Legend of Zelda: Skyward Sword на увеличенном изображении. Слева от персонажей заметен зелёный ореол. Изображение: Rulumi

Wii U поддерживает игры для Wii благодаря режиму обратной совместимости, который обычно называют vWii. Казалось бы, это прекрасная возможность запускать старые игры на современном телевизоре через 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 микроконтроллер, похоже, не используется. У него есть собственная выделенная RAM и доступ как к внутренней стороне фиктивного VI, так и к области регистров Radeon. […]

Чтобы выяснить причину проблем, я решил провести обратную разработку прошивки DMCU. Она хранится во встроенной памяти Wii U и загружается в RAM микроконтроллера перед запуском cafe2wii. К сожалению, мой любимый инструмент для реверс-инжиниринга, Ghidra, не поддерживает HC11, поэтому в 2024 году я написал для него собственную спецификацию процессора. К счастью, в Ghidra уже поддерживались HCS08 и HCS12, которые послужили хорошей основой.

Затем я несколько дней изучал прошивку DMCU. Устроена она довольно просто: микроконтроллер обращается к 32-битным регистрам контроллера дисплея через специальный интерфейс. Аппаратная прослойка фиктивного VI вызывает прерывания, а прошивка реагирует на них, настраивая контроллер дисплея.

Причину обрезания изображения удалось найти быстро. DMCU настраивает viewport контроллера дисплея так, чтобы воспроизвести overscan — выход картинки за границы экрана старого телевизора. В результате теряется до 16 пикселей, что в некоторых играх выглядит неудачно. Исправить это несложно: достаточно изменить байты прошивки, отвечающие за значения регистров viewport.

DMCU у AMD

В своё время fail0verflow не знали или, по крайней мере, не упомянули, что DMCU — не эксклюзивный микроконтроллер Wii U: он встречается и в других видеочипах AMD. В патче, отправленном сотрудником AMD в рассылку amd-gfx в 2018 году, говорится:

DMCU (Display Microcontroller Unit) — блок графического процессора, задействованный в функциях 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 этот блок по-прежнему основан на 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);
}

Похоже, при создании прошивки DMCU для Wii U компания AMD или Nintendo — я не знаю наверняка, кто именно занимался разработкой, — использовала тот самый порт 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 устанавливает бит CBCR_SWAP в блоке регистров DEINT в зависимости от горизонтального начала изображения (код):

// 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, поэтому не исключено, что его функции перенесли туда после обнаружения проблемы.

Как опробовать исправления

До и после в Super Mario Sunshine, изображение увеличено. Изображение: Rulumi
Super Mario Sunshine до и после исправления, изображение увеличено. Изображение: Rulumi
До и после в The Legend of Zelda: Skyward Sword, изображение увеличено. Изображение: Rulumi
The Legend of Zelda: Skyward Sword до и после исправления, изображение увеличено. Изображение: Rulumi

Исправления доступны в ветке custom репозитория OpenDMCUFirm. Загрузить эту версию прошивки можно с помощью последнего релиза evWii. Расскажите, как выглядит изображение у вас!

 

Источник

Похожие статьи

Поиск по играм, новостям и статьям…

Введите не менее двух символов

Введите не менее двух символов