Do botão ao pixel.
Escolha uma etapa para ver responsabilidade, evidência e falha típica. Use as setas do teclado para percorrer o fluxo.
Entrada física
Botões, analógicos e painel começam no hardware descrito pelo perfil correto.
- Responsabilidade
- Entregar ao kernel sinais e parâmetros compatíveis com a variante física.
- Evidência
- Modelo, DTB, hash, revisão e observação no aparelho.
- Falha típica
- Entrada ausente, painel incorreto ou comportamento diferente entre clones.
Kernel e display
Drivers transformam o perfil em dispositivos disponíveis para o espaço de usuário.
- Responsabilidade
- Expor entrada, armazenamento, áudio e uma sessão de display utilizável.
- Evidência
- Logs do kernel, conector, modo, DRM master e primeiro scanout observado.
- Falha típica
- O sistema inicia, mas não existe sessão de tela válida ou o painel permanece preto.
Runtime
O sistema de arquivos sobe somente o necessário para entregar a experiência.
- Responsabilidade
- Montar dados, iniciar serviços e manter dependências reproduzíveis.
- Evidência
- Rootfs inspecionado, serviços ativos e versões fixadas.
- Falha típica
- Biblioteca indisponível, serviço ausente ou configuração divergente da imagem.
Eventos e estado
O loop lê eventos, move o foco e atualiza apenas o estado necessário.
- Responsabilidade
- Manter entrada, telas e integrações em fronteiras pequenas e testáveis.
- Evidência
- Teste de foco, contrato da tela, recursos limitados e retorno previsível.
- Falha típica
- Foco perdido, bloqueio por I/O ou regra de negócio escondida em componente visual.
Composição
Textos, capas, ícones e superfícies formam o quadro dentro do orçamento de tempo.
- Responsabilidade
- Reutilizar texturas, limitar trabalho visível e apresentar estados completos.
- Evidência
- Frametime, cache limitado, tela vazia, carregamento e erro verificáveis.
- Falha típica
- Quadros irregulares, memória crescente ou interface que não explica seu estado.
Apresentação
O quadro é entregue ao DRM e precisa, por fim, aparecer no vidro.
- Responsabilidade
- Apresentar o frame no modo e no painel associados ao perfil.
- Evidência
- Captura técnica ajuda, mas a prova final é visual no hardware.
- Falha típica
- O processo termina sem erro e ainda assim nenhuma imagem fica visível.
O fluxo não substitui o teste físico. Ele serve para localizar a pergunta certa antes de mudar o sistema.
Sintoma não é diagnóstico.
- 01Observar
Descreva o que aconteceu sem atribuir causa.
- 02Localizar
Encontre a última camada que produziu uma prova confiável.
- 03Medir
Escolha o menor sinal capaz de separar as hipóteses.
- 04Validar
Repita no aparelho e registre escopo, resultado e limite.
Aprofunde uma parte do sistema.
Diagnóstico
Comece pela última evidência confiável e altere uma variável por vez.
Interface e renderização
Entenda as fronteiras entre entrada, estado, desenho e display.
Desempenho e FPS
Meça ritmo, custo e estabilidade antes de ativar um ajuste.
C e shell
Use cada linguagem onde sua natureza reduz risco e complexidade.
IA local e RAG
Veja quando a busca responde, quando Gemma entra e onde o sistema deve recusar.