GBS-Control agora fala português
A versão brasileira e aprimorada do firmware para o upscaler Tvia Trueview5725, com interface web traduzida e seletor de idioma.
[Abertura da matéria: por que você fez a versão brasileira, o que muda para quem usa e para quem ela é.]
O que mudou
- Interface web totalmente traduzida, com seletor de idioma PT/EN
- Sistema de arquivos migrado de SPIFFS para LittleFS
- Firmware com cerca de 903 KB, 86% do limite do ESP8266
- Backup automático antes de atualizar e restauração com um clique (GBSC Updater)
- Aviso de atualização disponível na WebUI e no visor OLED
- Checksums SHA-256 publicados em cada versão
O passo a passo completo está na documentação do GitHub, logo abaixo.
Em números
Histórico de versões
direto do GitHubv1.0.4 · 20 de setembro de 2026
O que mudou nesta versão
Esta versão não traz correções de bug no firmware — as correções críticas (menu OLED, Wi-Fi, presets) já foram lançadas na v1.0.3. O foco da v1.0.4 é consolidar o recurso de backup automático + restauração com um clique, lançado logo após a v1.0.3, e manter o checador de atualização (/gbs/version, ícone de alerta no OLED, banner na webui) consistente com o número da versão publicada.
🛡️ Segurança: ninguém perde a própria GBS
- O GBSC Updater agora faz um backup completo e automático (presets,
preferencesv2.txt,slots.bin, ícones/conectores/entradas por slot, e o firmware anterior quando disponível no GitHub) antes de qualquer gravação — seja por Wi-Fi ou por USB (quando o IP é informado). - Se o backup falhar, a atualização é cancelada. O programa nunca grava “no escuro”.
- Nova aba “Restaurar backup”: escolha um backup salvo e restaure tudo — firmware antigo + presets — com um clique. Sem precisar guardar nada manualmente.
- Os backups ficam numa pasta
backups/do lado doGBSC-Updater.exe, organizados por data e versão.
Isso é uma segunda camada de proteção, além do backup manual que a webui já oferece (Sistema → Cópia). Ideia central: se algo der errado, ou se você simplesmente preferir a versão anterior, é possível voltar exatamente para como estava, sem perder nada.
Outras mudanças
- Firmware: bump de versão para
1.0.4(endpoint/gbs/versione checagem de atualização). - Webui: nova seção “Sobre” no topo da aba Sistema, mostrando a versão do firmware que está rodando na GBS (
Versão do firmware: 1.0.4) — sem precisar abrir o console de desenvolvedor pra saber. - Documentação (
README.md,docs/TUTORIAL_INSTALACAO.md,docs/MANUAL_DE_USO.md,docs/DESCRITIVO_DETALHADO.md,docs/RECURSOS.md,tools/gbsc-updater/README.md) atualizada para descrever o novo fluxo de segurança do GBSC Updater.
🔒 Verificação de integridade (novo)
A partir deste release, todo .bin/.exe publicado vem acompanhado de um SHA256SUMS.txt com o checksum oficial de cada arquivo. Antes de gravar, confira se o hash bate:
Get-FileHash .\GBSC-PTBR-v1.0.4.bin -Algorithm SHA256
Se o valor não for exatamente igual ao que está em SHA256SUMS.txt (assets deste release), não use o arquivo — pode ter sido alterado por terceiros. Baixe direto daqui, da página oficial de releases.
Arquivos deste release
GBSC-PTBR-v1.0.4.bin— firmware para gravação via OTA ou USB (também embutido no.exeabaixo).GBSC-Updater-Windows.zip— programa gráfico para Windows (GBSC-Updater.exe), já com o firmware acima embutido e o novo sistema de backup/restauração.SHA256SUMS.txt— checksums oficiais dos dois arquivos acima, para conferência de integridade.
Veja o Tutorial de Instalação para o passo a passo.
Licença: este projeto é GPLv3 (herdado do gbs-control original). Qualquer fork, redistribuição ou uso comercial do código deve manter a licença GPLv3, o código-fonte aberto e a atribuição aos autores originais. Não é permitido fechar o código ou remover os créditos numa versão redistribuída.
v1.0.3 · 20 de setembro de 2026
GBS-Control PT-BR v1.0.3
Auditoria completa do firmware, da WebUI e das ferramentas de atualização, com correção de bugs críticos que causavam reinicializações e perda de dados, além de duas novidades: checagem de atualização e um alerta visual no OLED.
Faça backup dos seus perfis antes de atualizar (webui → Sistema → Cópia → Baixar).
🐞 Correções críticas (testadas na GBS de testes)
- Menu OLED travava e reiniciava o aparelho ao abrir “Presets” com 17 ou mais perfis nomeados. Uma proteção de memória (correta) acabava entrando num estado de erro que travava o firmware, e o watchdog do ESP8266 reiniciava o aparelho sozinho.
- A GBS não reconectava ao Wi-Fi sozinha depois de uma queda de conexão (roteador reiniciou, sinal caiu). Antes disso só acontecia na inicialização; agora ela detecta a queda e tenta reconectar automaticamente, inclusive voltando do modo Ponto de Acesso quando a rede salva reaparece.
- Apagar presets podia deixar dados inconsistentes (nomes duplicados, contador de perfis errado, “removido” no log mas o preset continuava lá) — consequência direta do bug do menu OLED acima: um reinício no meio da gravação dos arquivos de preset deixava o índice de nomes dessincronizado dos arquivos reais.
- Falha de segurança (XSS) na aba Wi-Fi da webui: o nome de uma rede escaneada entrava direto na página sem ser filtrado, permitindo que uma rede com nome malicioso executasse código na sua sessão da webui. Corrigido escapando o nome antes de exibir.
- Ponteiro nulo em
/slot/removee estouro de pilha (stack overflow) em/bin/slots.bine/gbs/restore-filters, ambos podendo reiniciar o aparelho.
🔧 Outras correções
- Contador de perfis salvos podia ficar incorreto na webui.
- Validação quebrada ao salvar preset com nome vazio, e falha silenciosa (sem aviso) quando o salvamento dava errado.
- Botão “Cancelar” do GBSC Updater não fazia nada de verdade durante gravação por USB — agora fica desabilitado nesse momento em vez de enganar.
- Vazamento de sockets e ordenação de versão incorreta (ex.: v1.0.10 antes de v1.0.9) no GBSC Updater.
- Gerador de boot logo corrompia imagens PNG com fundo transparente.
- Duas funções de sincronismo de vídeo (vsync) que eram cópias idênticas foram unificadas; falhas de comunicação I2C com o gerador de clock agora são registradas em vez de ignoradas silenciosamente.
- Diversos hardenings menores (limites de buffer, checagens de slot inválido,
sprintf→snprintf, etc.) e ~600 linhas de código morto (menu OLED antigo, nunca mais usado) removidas.
✨ Novidades
Checagem de atualização pelo GitHub
- A webui compara sua versão com o release mais recente deste repositório e mostra um aviso discreto quando há algo novo.
- O GBSC Updater ganhou um botão “Verificar atualização no GitHub”: busca o
.binmais recente automaticamente, sem precisar baixar manualmente.
Alerta de atualização no visor OLED
- Quando a webui encontra uma atualização, ela também avisa a GBS: um ícone de triângulo de alerta piscando aparece no menu e por cima do protetor de tela, pra você não deixar passar.
Como instalar
- Baixe GBSC-Updater-Windows.zip abaixo, extraia e abra
GBSC-Updater.exe. - Já tem GBS-Control? Aba Atualizar por Wi-Fi: digite o IP da GBS e clique em Enviar. Ou clique em Verificar atualização no GitHub pra já buscar esta versão automaticamente da próxima vez.
- Primeira instalação ou Wi-Fi não liga mais? Aba Gravar por USB, com cabo de dados.
Quem usa outra ferramenta pode gravar o GBSC-PTBR-v1.0.3.bin diretamente.
Compatível com GBS + Wemos D1 mini (ESP8266, 4 MB).
v1.0.2 · 19 de setembro de 2026
v1.0 · 19 de setembro de 2026
GBS-Control PT-BR v1.0 — by Maniaco Game Room
Primeira versão publicada do firmware GBS-Control totalmente em português, com sistema de perfis avançado, 56 ícones de console e uma interface web redesenhada.
Destaques
- Tradução completa (webui + menu OLED) e seletor de idioma Português / English na webui
- Perfis (até 72) com origem de vídeo (SCART / VGA / Componente / RGBS), ícone do console, paginação, busca e Perfil de Inicialização
- 56 ícones de console com arte real e 51 animações no protetor de tela do OLED
- Interface redesenhada com 6 temas de cor
- Correção de vários bugs (slots acima do 26º, reinícios ao salvar, ganho ADC, nomes cortados no OLED e outros)
Como instalar
- Baixe
GBSC-Updater-Windows.zipabaixo, extraia e abraGBSC-Updater.exe. - Já tem GBS-Control? Aba Atualizar por Wi-Fi: digite o IP da GBS e clique em Enviar / Gravar.
- Primeira instalação? Aba Gravar por USB, com cabo USB de dados.
Antes, faça um backup: webui → Sistema → Cópia → Baixar. Se o Windows perguntar sobre o Firewall, clique em Permitir acesso.
Guia completo: Tutorial de Instalação · Manual de Uso · Descritivo Detalhado
Arquivos
GBSC-Updater-Windows.zip— programa de atualização (firmware já incluído)GBSC-PTBR-v1.0.bin— firmware avulso, para quem usa outra ferramenta
Compatível com GBS + Wemos D1 mini (ESP8266, 4 MB). A gravação por USB ainda não foi validada em muitos aparelhos — relate problemas em Issues.
Documentação completa README do GitHub
Versão brasileira e aprimorada do firmware do upscaler Tvia Trueview5725 (ESP8266 / Wemos D1 mini)
Mantida por Willian Nascimento (Maniaco Game Room)
Tradução completa para PT-BR, sistema de perfis com automações avançadas, novos ícones para o display OLED e correções profundas no sistema de arquivos. Desenvolvido para a comunidade de hardware retro no Brasil.
📊 Números da Versão (v1.0.4)
- Firmware Otimizado: ~903 KB (86% do limite de 1.044.464 bytes)
- Customização: 56 ícones de console, 51 animações de protetor de tela
- Capacidade: 72 slots de perfil
- Visual: 6 temas de cor, 2 idiomas integrados na WebUI
🛡️ Segurança: ninguém perde a própria GBS
Uma auditoria completa do firmware, da webui e das ferramentas de atualização (~20 bugs corrigidos, incluindo um que podia travar/reiniciar o aparelho) deixou claro que corrigir bugs não bastava — o próprio processo de atualizar precisava ser à prova de imprevisto. Por isso:
- Backup automático antes de atualizar: o GBSC Updater baixa sozinho seus presets e configurações (e, quando encontra no GitHub, o firmware anterior também) antes de gravar qualquer coisa. Se o backup falhar, a atualização é cancelada.
- Restaurar com um clique: não gostou da versão nova, ou algo deu errado? A aba "Restaurar backup" regrava o firmware anterior e reenvia seus presets, sem precisar guardar nada manualmente.
- Aviso de atualização disponível: a WebUI e o ícone piscando no visor OLED avisam quando há uma versão nova, comparando com os releases publicados aqui no GitHub.
- Verificação de integridade: todo
.bin/.exepublicado nos releases vem com umSHA256SUMS.txtcom o checksum oficial de cada arquivo — confira antes de gravar, pra ter certeza de que baixou o arquivo genuíno e não uma versão adulterada por terceiros.
Veja a seção 12 do descritivo técnico para os detalhes de como isso funciona por baixo dos panos.
✨ Novidades Checagem de atualização pelo GitHubA webui compara sua versão com o release mais recente deste repositório e mostra um aviso discreto quando há algo novo. O GBSC Updater ganhou um botão “Verificar atualização no GitHub”: busca o .bin mais recente automaticamente, sem precisar baixar manualmente. Alerta de atualização no visor OLED
Quando a webui encontra uma atualização, ela também avisa a GBS: um ícone de triângulo de alerta piscando aparece no menu e por cima do protetor de tela, pra você não deixar passar.
🌍 Tradução e Redesign da Interface (WebUI)
Todo o ecossistema do firmware foi localizado e redesenhado, entregando uma experiência 100% nativa e agradável:
- Tradução e Seletor de Idioma: WebUI (abas, textos de ajuda, alertas e erros) e menu OLED traduzidos. O seletor (Português/English) aplica o inglês sobre o texto em português via dicionário exato (~110 entradas).
- Boot Logo Customizado: Arte própria do projeto no lugar da tela de inicialização padrão.
- Design Aprimorado: Cabeçalho novo, painéis escuros com títulos em barra metálica e botões com LED que acendem na cor do tema. Paginação adaptativa com base na altura da tela, facilitando o uso no celular.
- Temas de Cor: 6 opções baseadas em variáveis CSS (Padrão, Verde Fósforo, Synthwave, Âmbar CRT, Rubi Famicom, Roxo GameCube).
- Cards de Perfil: Arte do console ao fundo com contorno neon no perfil selecionado, sistema de busca inteligente (ignora acentos e maiúsculas) e contador de perfis.
⚙️ Base Técnica & Sistema de Arquivos
- Migração de SPIFFS para LittleFS: O sistema de arquivos foi modernizado para o formato atual do ESP8266, garantindo maior confiabilidade. Atenção: A primeira inicialização formata a área de dados (é necessário backup prévio).
- Persistência Segura: O arquivo
/preferencesv2.txté sequencial. Novos campos foram acrescentados com valores padrão seguros para não quebrar backups existentes. Arquivos auxiliares por slot mantêm o mesmo padrão.
💾 Sistema de Perfis (Presets) e Automações
O gerenciamento foi reescrito para suportar até 72 slots (A-Z, a-z, 0-9 e símbolos), ordenados alfabeticamente tanto na WebUI quanto no OLED.
| Recurso | Como Funciona |
|---|---|
| Origem de Vídeo por Preset | Ao salvar, você escolhe a entrada (SCART / VGA / Componente / RGBS). É uma etiqueta informativa exibida no card (o chip não distingue eletricamente). |
| Perfil de Inicialização | Força um slot específico a ser carregado sempre que o aparelho liga, ignorando o "último usado". |
| Aviso de Mudança | O display OLED exibe "Formato mudou" seguido da nova resolução por 3 segundos ao alternar presets. |
📺 Menu OLED & Ícones de Console
Nova funcionalidade criada, seletor de icone para presets, ideal para quem gerencia coleções grandes com switches de vídeo.
- Diponiveis 56 ícones: O seletor permite escolher entre (controles, logos e gabinetes) de sistemas Nintendo, Sega, NEC, SNK, Sony, Microsoft, Atari, Panasonic 3DO, entre outros.
- Processamento de Imagem: Cada arte teve recorte de bordas, fundo transparente e redimensionamento exato (40x40px). Na WebUI, um fundo claro atrás do ícone garante contraste no tema escuro.
- Protetor de Tela Inteligente:
- Modo Nome: O nome do preset passeia pela tela. A fonte diminui dinamicamente (URW Gothic 20/14, DejaVu Mono 12/10) usando a largura do texto para evitar cortes (ex: "Super Nintendo").
- Modo Ícone (Bounce): 51 dos 56 ícones ganharam animação de "quicar" de 4 quadros (32x32px, 1-bit). Conversão feita com threshold adaptativo (método de Otsu) e contorno automático de silhueta para não sumir no fundo preto. (5 ícones complexos usam o Modo Nome como fallback).
- Status Ativo: Nome e ícone do preset ativo ficam fixos na tela principal, com rolagem alinhada à esquerda para nomes longos.
🛠️ Correções de Bugs (Bugfixes)
Clique para expandir as correções técnicas aplicadas
| Bug Original | Causa Raiz | Solução Aplicada |
|---|---|---|
| OLED não achava presets | Dessincronia de sistema de arquivos (OLED lia SPIFFS, WebUI lia LittleFS). | Unificação total no LittleFS. |
| Slot quebrava no 27º perfil | Código calculava slot por 'A' + índice (limitado a 26 posições). | Implementada tabela estática de 72 caracteres (slotIndexMap) no firmware inteiro. |
| Origem de vídeo falhava no card | 3 requisições paralelas excediam o limite de conexões do ESP8266. | Requisições sequenciadas com rotina de retry. |
| Ganho ADC "sem efeito" | O resync restaurava o padrão de fábrica se não houvesse preset carregado. | Valores ajustados de ganho agora sobrevivem e são restaurados após o reset. |
| Overflow horizontal mobile | A tag <fieldset> ignorava propriedades grid/flex e passava da tela. | CSS ajustado na interface (min-width: 0 + grid minmax). |
| Menu OLED travava e reiniciava (v1.0.3) | Com 17+ presets nomeados, faltava reservar espaço pro aviso de "muitos presets" numa lista limitada a 16 posições. | Menu reserva a última posição pro aviso quando não cabem todos. |
| Wi-Fi não reconectava sozinho (v1.0.3) | A supervisão de reconexão só existia na inicialização; uma queda depois disso deixava a GBS desconectada até reboot manual. | Detecção de queda + reconexão automática, com retentativa periódica. |
| XSS no scan de Wi-Fi da webui (v1.0.3) | Nome de rede escaneada entrava direto no HTML sem ser filtrado. | Nome da rede escapado antes de entrar na página. |
💻 Ferramentas e Documentação
- GBSC Updater: Programa próprio para Windows (ou Python em qualquer OS), com três abas: Atualizar por Wi-Fi (informando o IP), Gravar por USB (primeira instalação) e Restaurar backup (desfaz uma atualização com um clique). Faz backup automático dos presets antes de gravar, verifica atualizações no GitHub, lida sozinho com o serviço OTA do ESP8266 e contorna o Firewall do Windows.
- Pipeline de Mídia: Script
make_icon_animation.pyque gera automaticamente o código em C++ (OLEDIconAnimations.cpp) a partir dos assets. - Documentação Inclusa: Manual de Uso, Tutorial de Instalação passo a passo (Wi-Fi/USB) e este descritivo técnico.
📌 Pendências Conhecidas (Roadmap)
- Offset por Canal (Nível de Preto): A ideia de ajustar o offset por canal ADC está mapeada (registradores já existem no código), mas a interação com a rotina de auto-calibração precisa de mais testes.
- Automação para Switches SCART / Componente: Em fase de mapeamento/desenvolvimento.
- Menu OLED: Atualmente restrito ao PT-BR (textos baseados em bitmaps pré-desenhados).
📜 Licença e Atribuição
Este projeto é distribuído sob a GNU General Public License v3.0 (GPLv3), a mesma licença do gbs-control original do qual este é um fork. Isso significa, na prática:
- Você pode usar, estudar, modificar e redistribuir este firmware livremente — inclusive para fins comerciais.
- Mas: qualquer fork, modificação ou redistribuição (comercial ou não) precisa continuar sob a GPLv3, manter o código-fonte aberto e disponível a quem recebe o binário, e preservar os avisos de copyright e créditos aos autores originais e a este fork.
- Não é permitido "fechar" o código, vender uma versão proprietária sem disponibilizar o fonte, ou remover a atribuição — isso violaria os termos da GPLv3 e os direitos dos autores originais.
Veja o arquivo LICENSE para o texto completo.
Cartas dos leitores
Comente com a sua conta do GitHub. Dúvidas, bugs e elogios são bem-vindos.