Controles

Os dois botões modificadores

O ArchR usa dois modificadores diferentes, e eles pertencem a camadas diferentes.

SELECT é o modificador das ações de sistema e do RetroArch. L1 é o modificador de um punhado de ações de nível de desktop. Os dois vêm de configurações (key.function.a e key.hotkey.a em /storage/.config/system/configs/system.cfg), e um quirk de dispositivo pode trocá-los, mas todas as placas RK3326 usam os valores acima a menos que você os edite.

Hotkeys de sistema

São tratadas pelo serviço input_sense, então funcionam tanto no EmulationStation quanto dentro de um jogo.

VOL+ / VOL-               Volume, 5 pontos por toque, repete enquanto segurar
SELECT + VOL+ / VOL-      Brilho, 5 pontos por toque, piso em 5%
SELECT + START + VOL+     Liga o WiFi
SELECT + START + VOL-     Desliga o WiFi
L1 + SELECT + START       Encerra à força o que estiver rodando
L1 + X                    Abre a ferramenta de guias de jogo
L1 + Y                    Alterna o overlay do MangoHud
L1 + A                    Captura de tela (desligada por padrão, veja abaixo)
POWER                     Sono leve, aperte de novo para acordar

O brilho anda de 5 em 5 e nunca desce abaixo de 5%, então são 20 níveis úteis. O volume anda de 5 em 5 entre 0 e 100.

A hotkey de captura de tela fica inativa até você definir archr.screenshot.enabled=1, e é ignorada enquanto o RetroArch estiver rodando, porque o RetroArch tem a função dele. Os arquivos vão para /storage/roms/screenshots/.

O POWER não desliga o console. Ele coloca o aparelho em sono leve: tela e backlight apagados, tudo ainda na RAM, e um segundo toque acorda. Se você deixar dormindo, o sistema se desliga sozinho depois de 15 minutos (system.shutdown_delay). Para desligar na hora, use o menu do EmulationStation.

Hotkeys do RetroArch

São escritas no retroarch.cfg a cada lançamento pelo setsettings.sh, a partir do perfil de controle em /tmp/joypads. No R36S a hotkey é o SELECT:

SELECT + START            Sai do emulador e volta ao EmulationStation
SELECT + X                Quick menu do RetroArch
SELECT + Y                Overlay de FPS e desempenho
SELECT + R1               Salva estado
SELECT + L1               Carrega estado
SELECT + R2               Avanço rápido
SELECT + L2               Rebobinar

Nada além disso está ligado a um botão. Troca de slot de save, reset e captura de tela existem no RetroArch, mas só nos atalhos de teclado, então você chega neles pelo quick menu.

Se você quiser outro conjunto, desligue system.autohotkeys em /storage/.config/system/configs/system.cfg e o RetroArch passa a manter o que você configurar à mão.

Layouts de joypad

Há duas maneiras de os analógicos serem ligados nessas placas, e a diferença é decidida pelo overlay de painel, não pela imagem que você gravou nem por uma configuração no console.

• Fiação K36: os dois analógicos compartilham o ADC multiplexado que também lê os botões.
• Fiação My Mini: cada eixo tem o próprio canal do SARADC, o que exige outro conjunto de io-channels no nó do joypad.

O Gerador de Overlay escolhe entre as duas. Se o seu .dtb de fábrica traz um nó /adc-keys presente mas explicitamente desativado, o gerador lê isso como hardware My Mini e troca o nó do joypad. Caso contrário, mantém a fiação compartilhada. A lista Layout do joypad no gerador sobrepõe o palpite: auto, K36 (2 analógicos) ou My Mini (1 analógico), que aparecem na string de opções como JPk36 e JPmm.

A mesma página tem dois interruptores para o sentido dos analógicos, LSi e RSi, para placas em que o analógico esquerdo ou direito lê invertido.

Se os analógicos se comportarem errado, gere o overlay de novo com o layout forçado, em vez de procurar uma configuração no console. Não existe chave joypad.variant.

Layout dos botões

O controller_layout decide como os quatro botões frontais são reportados aos emuladores e ao PortMaster. Ele é lido por plataforma e por jogo, e aceita três valores:

O EmulationStation tem um interruptor próprio, Switch confirm & cancel buttons in EmulationStation, em UI Settings. Esse só afeta a navegação nos menus, não o que o jogo recebe.

RetroArch durante o jogo

Aperte SELECT + X para o Quick Menu. Submenus comuns:

Resume                    Volta ao jogo
State Slot                Escolhe o slot de save, 0 a 9
Save State / Load State   Save no lugar (mais rápido que o save da ROM)
Take Screenshot           PNG em /storage/roms/screenshots/
Options                   Ajustes por core (resolução, frameskip, BIOS)
Controls                  Remapeia na hora
Cheats                    Lista de cheats (se houver .cht para a ROM)
Disk Control              Troca de disco em PSX multidisco
Information               Core / sistema / autores

SELECT + START sai sem passar pelo menu.

Emuladores standalone

Cada emulador standalone traz os próprios atalhos, e a maioria fica com o padrão de fábrica do projeto. O que o ArchR configura por inteiro é o Mednafen, que segue o mesmo formato do RetroArch:

SELECT + START            Sai
SELECT + R1               Salva estado
SELECT + L1               Carrega estado
SELECT + Y                Alterna o FPS
SELECT + A                Captura de tela
SELECT + L2               Rebobinar
SELECT + R2               Avanço rápido
START + esquerda/direita  Slot de save anterior / próximo
START + L1 / R1           Escolhe disco / insere ou ejeta disco
START + R2                Insere ficha
START + L2                Abre a configuração de controles

Para os outros (PPSSPP, Flycast, DraStic, melonDS, Yabasanshiro, DuckStation, ScummVM), abra o menu do próprio emulador e leia a página de controles: a combinação muda de um para outro. O L1 + SELECT + START encerra qualquer um deles e devolve você ao EmulationStation.

Remapeamentos personalizados

Os overrides do RetroArch por core ficam em /storage/.config/retroarch/config/, uma pasta por core, e são escritos pelo próprio RetroArch quando você salva um override pelo quick menu.

Os remapeamentos de entrada por jogo ficam em /storage/remappings/. Abra o jogo, SELECT + X → Controls → Save Game Remap File.

Atalhos personalizados: edite /storage/.config/retroarch/retroarch.cfg e procure as chaves input_*_btn. Lembre que o setsettings.sh reescreve o bloco de hotkeys a cada lançamento enquanto system.autohotkeys=1.

Ports do PortMaster

Os ports usam outra camada de entrada, o gptokeyb, que traduz o joypad em eventos de teclado e mouse para o binário original. O mapeamento padrão é /storage/roms/ports/PortMaster/control.txt, copiado para lá pelo start_portmaster.sh; a maioria dos ports sobrescreve com a configuração própria.

A combinação de saída faz parte da configuração de cada port, então leia a descrição dele no PortMaster. O L1 + SELECT + START funciona como recurso de último caso.