SUMMARY

Where things stand

The build is playable end to end : boot, matches, and — for the first time in this project — the return to Mode Select after an in-game Reset.

Three bugs handled : a boot regression (a workshop fix never sent upstream), a dead controller in-game (wrong pad mode), and the black screen on Reset — a long-standing framework bug, this time traced live and fixed.

01

Updating psxrecomp

The shared psxrecomp/ checkout went from a7c1fac (v0.3.1-alpha-625) to 00438851 — the v0.3.2-alpha tag, about 170 commits further on.

Uncommitted local changes (Beetle debug-server hooks, a setup_project.ps1 fix) were stashed cleanly : git stash + a backup-pre-v032-bump-2026-08-29 branch. Nothing lost.

02

Two Windows scaffold bugs

setup_project.ps1 no longer parses under PowerShell 5.1

The v0.3.2 script has three Write-Warning lines containing an em dash —. The file is UTF-8 with no BOM ; PowerShell 5.1 reads it as ANSI, and the mis-decoded bytes cascade into dozens of bogus parser errors. Second flaw : the probe_disc.py call still passes --description $Description positionally, so an empty optional flag shifts every following argument.

Fixed by hand : non-ASCII punctuation replaced, arguments built as an array and appended only when set.

The old BOM bug, still there

The --set-file substitutions inject BOM markers (U+FEFF) mid-file : 6 occurrences in CMakeLists.txt and symbols.toml, stripped before the first cmake.

03

SFEX2P scaffold and pipeline

New SFEX2P folder (display name "Street Fighter EX2 Plus" kept), 2 players, recomp-ui + wizard + CI, netplay off. Disc probe : SLUS-01105, boot SLUS_011.05, entry 0x801CA7D8, 995 seeds.

Gotcha : a "BIOS generated/ is STALE" warning. False positive — the psxrecomp_cli.py generate path doesn't drop the OpenBIOS.emitter.sha fingerprint the way regen_bios.sh does. Fingerprint written by hand.

04

game.toml settings

05 · BUG FIXED

Boot freeze — SR register regression

First launch on stock v0.3.2 : freeze at frame 1505, black screen, four freeze_dumps, cop0_sr = 0x40000400, iec = 0, epc = 0x801303E8.

This is exactly the SR/TCB bug the workshop fixed on 24 August 2026. That fix was never sent upstream to mstan/psxrecomp : v0.3.2 still does a software push/pop double-transform of the SR at the three sites in traps.c. Raw copy re-applied :

// psx_save_context_to_tcb / psx_restore_context_from_tcb
- cpu->write_word(save + 140u, (sr & ~0x3Fu) | ((sr & 0x0Fu) << 2));
+ cpu->write_word(save + 140u, sr);            // raw copy, like the retail BIOS

After : runs past frame 9400, iec = 1, sr = 0x40000401, zero freeze_dump. Submodule commit 09ff2311.

06 · BUG FIXED

Dead controller in-game

The DualSense (USB) is detected fine — opened controller for slot: DualSense Wireless Controller — but zero input during a match. The launcher sees it perfectly (SDL layer).

Cause : the launcher had written settings.toml [controller] p1_mode = "analog" and multitap = true. Street Fighter EX2 Plus is a digital-pad-only game — in analog / DualShock mode it doesn't recognise the controller and ignores all input in-game.

Fix : p1_mode = "digital", multitap = false, multitap_analog = false. If the launcher rewrites the file, explicitly pick Digital mode and turn multitap off in its UI before launching.

07 · BUG FIXED

Return to Mode Select → black screen

The core bug : after an in-game Reset, instead of "Now Loading" then the menu, a permanent black screen. Documented across several sessions, never resolved.

The Plus Alpha lead

The repo guimaraf/plusalpha-recomp (Street Fighter EX Plus Alpha, a sibling game from the same Arika studio) uses a psxrecomp fork. That fork has no CD/thread/interrupt fix. Its one real lever : the retail SCPH-1001 BIOS instead of OpenBIOS.

Switching to the retail BIOS

• First tried with a SCPH-7502 EU dump → the generated BIOS C fails to compile (goto to an un-emitted label ; 651 skipped functions ; the recompiler expects a US image).
• With a genuine SCPH-1001 US (crc32 37157331) → compiles clean (1 skipped function). Banner image=SCPH-1001.
• Result : the retail BIOS does not fix the Reset. Freeze signature identical — epc = 0x8013038C, sr = 0x40000404, iec = 0. A psxrecomp runtime bug, not the BIOS.

08

Live investigation (debug server)

build-debugtools build (debug server on port 4370). The user drives the game to the Reset ; the frozen state is then queried.

The faulty transition

At frame 3897 : the main thread is saved with sr=0x40000401 (IEc=1, healthy), then the CD thread is restored with resume_pc=0x80130508 and sr=0x40000404. From then on, every save/restore of the CD thread carries 0x40000404. Then no thread switch ever again.

The mechanism

• A VBLANK interrupt hits the CD thread at 0x8013038C. Hardware pushes the SR : 0x40000401 → 0x40000404 (old IEc into IEp, new IEc becomes 0).
• The kernel saves the CD thread into its TCB with that pushed SR.
• On restore, the "raw copy" (bug #1's fix) makes cop0_sr = 0x40000404 → IEc stays 0 forever. No rfe ever pops it.
• IEc=0 → the CD-ROM ACK (INT3) is never serviced → process_pending() blocks the Pause command → false "CD timeout" → black screen, thread round-robin frozen.

09 · FIX

The conditional pop

Both go through the same psx_restore_context_from_tcb. Discriminator : the IEc bit of the saved SR.

uint32_t saved_sr = cpu->read_word(save + 140u);
if (saved_sr & 0x01u) {
    // IEc set: thread parked cleanly (cooperative yield / fresh thread)
    cpu->cop0[12] = saved_sr;                                // raw copy
} else {
    // IEc clear: suspended MID-EXCEPTION. The HLE scheduler restore stands
    // in for the kernel ReturnFromException, whose final rfe pops the stack.
    cpu->cop0[12] = (saved_sr & 0xFFFFFFC0u) | ((saved_sr >> 2) & 0x0Fu);
}

pop(0x40000404) = 0x40000401. The same rule applies to the syscall(3) ReturnFromException fallback.

Verified — live on the debug server and by the user : the menu returns after the Reset, the frame counter passes 26,000, wedge: None, zero freeze_dump. Submodule commit 36e124d3.

RECAP

Commits

TAKEAWAY

Two framework bugs to send upstream

Both SR fixes (09ff2311 and 36e124d3) live in the cooperative TCB scheduler carve-out in traps.c — code every recomp project shares. Neither is in mstan/psxrecomp upstream.

The retail SCPH-1001 BIOS is not required by this fix — kept because it's more faithful than OpenBIOS.

RESUMO

Situação atual

O build é jogável de ponta a ponta : boot, partidas, e — pela primeira vez neste projeto — a volta ao Mode Select depois de um Reset no jogo.

Três bugs tratados : uma regressão de boot (uma correção de bancada nunca enviada ao upstream), um controle morto no jogo (modo de pad errado) e a tela preta no Reset — um bug de framework antigo, desta vez rastreado ao vivo e corrigido.

01

Atualização da psxrecomp

O checkout compartilhado psxrecomp/ passou de a7c1fac (v0.3.1-alpha-625) para 00438851 — a tag v0.3.2-alpha, cerca de 170 commits à frente.

As mudanças locais não commitadas (hooks do servidor de debug do Beetle, uma correção do setup_project.ps1) foram guardadas com segurança : git stash + branch backup-pre-v032-bump-2026-08-29. Nada perdido.

02

Dois bugs do scaffold no Windows

setup_project.ps1 não é mais interpretado no PowerShell 5.1

A versão v0.3.2 do script tem três Write-Warning com um travessão —. O arquivo é UTF-8 sem BOM ; o PowerShell 5.1 o lê como ANSI, e os bytes mal decodificados quebram o parser em cascata. Segundo defeito : a chamada ao probe_disc.py ainda passa --description $Description por posição, então um flag opcional vazio desloca todos os argumentos seguintes.

Corrigidos à mão : pontuação não-ASCII substituída, argumentos montados como array e adicionados só quando definidos.

O antigo bug de BOM, ainda presente

As substituições --set-file injetam marcadores BOM (U+FEFF) no meio dos arquivos gerados : 6 ocorrências em CMakeLists.txt e symbols.toml, removidas antes do primeiro cmake.

03

Scaffold e pipeline SFEX2P

Nova pasta SFEX2P (nome de exibição "Street Fighter EX2 Plus" mantido), 2 jogadores, recomp-ui + wizard + CI, netplay desativado. Sondagem do disco : SLUS-01105, boot SLUS_011.05, entry 0x801CA7D8, 995 seeds.

Pegadinha : aviso "BIOS generated/ is STALE". Falso positivo — o caminho psxrecomp_cli.py generate não grava a impressão digital OpenBIOS.emitter.sha como o regen_bios.sh faz. Impressão digital escrita à mão.

04

Ajustes no game.toml

05 · BUG CORRIGIDO

Congelamento no boot — regressão do registrador SR

Primeiro lançamento na v0.3.2 pura : congela no frame 1505, tela preta, quatro freeze_dump, cop0_sr = 0x40000400, iec = 0, epc = 0x801303E8.

É exatamente o bug de SR/TCB que a bancada corrigiu em 24 de agosto de 2026. Essa correção nunca foi enviada ao upstream do mstan/psxrecomp : a v0.3.2 ainda faz um duplo transform (push/pop por software) do SR nos três pontos de traps.c. Cópia bruta reaplicada :

// psx_save_context_to_tcb / psx_restore_context_from_tcb
- cpu->write_word(save + 140u, (sr & ~0x3Fu) | ((sr & 0x0Fu) << 2));
+ cpu->write_word(save + 140u, sr);            // cópia bruta, como o BIOS retail

Depois : roda além do frame 9400, iec = 1, sr = 0x40000401, zero freeze_dump. Commit no submódulo 09ff2311.

06 · BUG CORRIGIDO

Controle morto no jogo

O DualSense (USB) é detectado normalmente — opened controller for slot: DualSense Wireless Controller — mas nenhuma entrada durante uma partida. O launcher o enxerga perfeitamente (camada SDL).

Causa : o launcher havia gravado settings.toml [controller] p1_mode = "analog" e multitap = true. Street Fighter EX2 Plus é um jogo somente de pad digital — em modo analógico / DualShock ele não reconhece o controle e ignora toda entrada no jogo.

Correção : p1_mode = "digital", multitap = false, multitap_analog = false. Se o launcher reescrever o arquivo, escolha explicitamente o modo Digital e desligue o multitap na interface dele antes de iniciar.

07 · BUG CORRIGIDO

Volta ao Mode Select → tela preta

O bug central : depois de um Reset no jogo, em vez de "Now Loading" e o menu, uma tela preta permanente. Documentado em várias sessões, nunca resolvido.

A pista do Plus Alpha

O repositório guimaraf/plusalpha-recomp (Street Fighter EX Plus Alpha, jogo irmão do mesmo estúdio Arika) usa um fork da psxrecomp. Esse fork não tem correção de CD/thread/interrupções. Sua única alavanca real : o BIOS retail SCPH-1001 em vez do OpenBIOS.

Troca para o BIOS retail

• Primeiro tentado com um dump SCPH-7502 EU → o C gerado do BIOS não compila (goto para um label não emitido ; 651 funções ignoradas ; o recompiler espera uma imagem US).
• Com um SCPH-1001 US genuíno (crc32 37157331) → compila limpo (1 função ignorada). Banner image=SCPH-1001.
• Resultado : o BIOS retail não corrige o Reset. Assinatura de congelamento idêntica — epc = 0x8013038C, sr = 0x40000404, iec = 0. Bug do runtime da psxrecomp, não do BIOS.

08

Investigação ao vivo (servidor de debug)

Build build-debugtools (servidor de debug na porta 4370). O usuário leva o jogo até o Reset ; o estado congelado é então consultado.

A transição defeituosa

No frame 3897 : a thread main é salva com sr=0x40000401 (IEc=1, saudável), depois a thread do CD é restaurada com resume_pc=0x80130508 e sr=0x40000404. A partir daí, todo save/restore da thread do CD carrega 0x40000404. Depois, nenhuma troca de thread nunca mais.

O mecanismo

• Uma interrupção de VBLANK atinge a thread do CD em 0x8013038C. O hardware empilha o SR : 0x40000401 → 0x40000404 (o IEc antigo vai para IEp, o novo IEc vira 0).
• O kernel salva a thread do CD no TCB dela com esse SR empilhado.
• No restore, a "cópia bruta" (correção do bug #1) faz cop0_sr = 0x40000404 → IEc fica em 0 para sempre. Nenhum rfe jamais desempilha.
• IEc=0 → o ACK do CD-ROM (INT3) nunca é atendido → process_pending() bloqueia o comando Pause → falso "CD timeout" → tela preta, round-robin de threads congelado.

09 · CORREÇÃO

O pop condicional

As duas passam pelo mesmo psx_restore_context_from_tcb. Discriminante : o bit IEc do SR salvo.

uint32_t saved_sr = cpu->read_word(save + 140u);
if (saved_sr & 0x01u) {
    // IEc setado: thread estacionada com limpeza (yield cooperativo / thread nova)
    cpu->cop0[12] = saved_sr;                                // cópia bruta
} else {
    // IEc zerado: suspensa NO MEIO DE UMA EXCEÇÃO. O restore do scheduler HLE
    // substitui o ReturnFromException do kernel, cujo rfe final desempilha.
    cpu->cop0[12] = (saved_sr & 0xFFFFFFC0u) | ((saved_sr >> 2) & 0x0Fu);
}

pop(0x40000404) = 0x40000401. A mesma regra vale para o fallback de ReturnFromException do syscall(3).

Verificado — ao vivo no servidor de debug e pelo usuário : o menu volta após o Reset, o contador de frames passa de 26.000, wedge: None, zero freeze_dump. Commit no submódulo 36e124d3.

RESUMO DOS COMMITS

Commits

O QUE FICA

Dois bugs de framework para enviar ao upstream

As duas correções de SR (09ff2311 e 36e124d3) ficam no carve-out do scheduler cooperativo de TCB em traps.c — código que todo projeto de recomp compartilha. Nenhuma está no upstream do mstan/psxrecomp.

O BIOS retail SCPH-1001 não é exigido por esta correção — mantido por ser mais fiel que o OpenBIOS.