CajuOS GB300 4.1

CajuOS GB300 4.1

Resumo

O CajuOS GB300 4.1 mantém as funções de desempenho da versão anterior e atualiza a apresentação do sistema no cartão SD. Os diretórios públicos agora são Caju OS/ e Caju OS Data/, e o firmware distribuído é Caju OS/firmware/cajuos.bin.

A alteração foi implementada no firmware MIPS/HCRTOS, no primeiro estágio de boot, no frontend nativo, no host Libretro, no runtime JS2300, nos scripts de diagnóstico, no empacotador e nos testes de distribuição. Não foi feita apenas uma troca cosmética no ZIP.

Novidades

Área	Alteração
Identidade pública	Diretórios visíveis Caju OS/ e Caju OS Data/
Firmware	Nome público cajuos.bin
Boot	Fastboot recompilado para carregar Caju OS/firmware/cajuos.bin
Runtime	Raízes de firmware, cores, scripts, saves, logs, temas e idiomas atualizadas
Frontend	Navegação e mensagens atualizadas para os nomes CajuOS
Instalação	Tutorial completo em docs/INSTALL-CajuOS-GB300.md
Desempenho	Menu pré-jogo e Performance Manager preservados

Instalação

Leia docs/INSTALL-CajuOS-GB300.md antes de instalar. Baixe o arquivo CajuOS-GB300-v4.1-sdcard.zip na página de release, verifique o SHA-256, faça backup integral do cartão original e extraia o conteúdo diretamente na raiz de uma cópia do cartão.

A raiz deve conter Caju OS/, Caju OS Data/, ROMS/ e bios/. Não coloque o conteúdo dentro de uma pasta intermediária e não use Rufus, Etcher ou dd, pois o ZIP é um pacote de arquivos e não uma imagem de disco.

Build e validação

A árvore fonte está em source/CajuOS-GB300-v4.1. Os alvos principais são:

cd source/CajuOS-GB300-v4.1
make doctor
make deps
make quick-check
make check
make sd-zip

O script scripts/build-cajuos-release.sh copia o estágio interno do build para uma área temporária e renomeia as pastas para os nomes públicos antes de criar o ZIP final. Essa separação evita ambiguidades de shell durante a compilação e garante que o usuário receba somente Caju OS/ e Caju OS Data/.

Desempenho

O menu pré-jogo oferece Compatibility, Balanced, Performance e Ultra, além de CPU, GPU/GE, frameskip, áudio e Skip duplicate frames. O perfil Balanced é recomendado para o primeiro boot. Os perfis agressivos devem ser avaliados por jogo, especialmente em SNES, GBA, PCE e PS1.

Limitações

A compilação MIPS, os smoke tests, a auditoria de ZIP e os testes de ROM no host não substituem a validação no GB300 físico. LCD, áudio, controles, clocks, FPS, consumo, compatibilidade de cartão e o boot efetivo precisam ser confirmados com um aparelho real.

CajuOS GB300 4.0

CajuOS GB300 4.0

Resumo

O CajuOS GB300 4.0 é uma distribuição independente de firmware, frontend, cores, configurações e ferramentas para o console GB300. O projeto possui sua própria árvore de source e seu próprio processo de build. Outros sistemas podem ser usados como referência técnica de compatibilidade, mas não definem a identidade do CajuOS.

A distribuição final é um overlay de cartão SD, não uma imagem bruta. O usuário deve extrair o conteúdo do ZIP diretamente na raiz de uma cópia FAT32 do cartão original.

Menu pré-jogo e desempenho

Depois de selecionar uma ROM, o frontend mostra o menu antes do lançamento. O usuário pode escolher o perfil Compatibility, Balanced, Performance ou Ultra, além de CPU, GPU/GE, frameskip, áudio e descarte de frames repetidos. As configurações ficam salvas no cartão.

O CajuOS aplica apenas opções de desempenho registradas pelo core selecionado. O mecanismo de frames repetidos usa uma assinatura amostrada do framebuffer para evitar reapresentar uma imagem que não mudou. Esse mecanismo reduz trabalho do presenter/GE em telas estáticas, mas não elimina o custo da CPU emulada nem substitui o teste no console físico.

Instalação

Faça uma cópia integral do cartão original. Extraia os arquivos dentro de CajuOS-GB300-v4.0-sdcard.zip diretamente na raiz da cópia. Após a extração, os diretórios unifrog/, unifrog_data/, ROMS/ e bios/ devem estar na raiz do cartão. Esses nomes de diretório são contratos de compatibilidade do boot/runtime do GB300; não significam que o projeto CajuOS seja outro sistema.

Não use Rufus, Etcher ou dd para gravar o ZIP como imagem. Não coloque o ZIP dentro de outra pasta. Preserve ROMs, saves e BIOS legítimas. Caso o aparelho não inicialize, desligue, restaure o backup e não continue usando o pacote naquela variante sem coletar diagnóstico.

Source e build

A árvore pública está em source/CajuOS-GB300-v4.0. Para compilar:

cd source/CajuOS-GB300-v4.0
make deps-sdk
make deps
make ci-toolchain
make quick-check
make verify
make
cd ../..
CAJUOS_VERSION=4.0 ./scripts/build-cajuos-release.sh

O pacote fonte separado é release/CajuOS-GB300-source-v4.0.zip. O pacote SD é release/CajuOS-GB300-v4.0-sdcard.zip.

Validação

A validação host inclui doctor do ambiente, core smoke, frontend nativo, JS2300, boot logo, link layout, fastboot, compilação dos cores, geração do firmware, teste de integridade do ZIP, inspeção do layout extraído em uma pasta vazia e comparação dos caminhos técnicos com o pacote de referência usado no desenvolvimento.

Essa validação não substitui o teste físico. Boot real, tela, áudio, controles, estabilidade térmica, autonomia, clocks e desempenho de cada jogo precisam ser confirmados em um GB300 físico.

CajuOS GB300 v0.3.3-beta

CajuOS GB300 v0.3.3-beta

Resumo

Primeira release pública beta do CajuOS para o console portátil GB300. O download é um overlay de cartão SD, não uma imagem bruta. A versão é baseada no UniFrog v0.5.2 e adiciona tema CajuOS, português, diagnósticos, perfil SNES documentado e correção de seleção de imagens PS1.

Autor/mantenedor: @melo._.071 no Instagram

Correções e mudanças

• Corrige o driver QPSX para priorizar .cue quando .cue e .bin coexistem.
• Mantém snes9x2002 como core SNES padrão e snes9x2005 como fallback.
• Mantém perfil de armazenamento conservador e opções de áudio/frameskip documentadas.
• Inclui 11 cores OCFU: Gambatte, Gearboy, QuickNES, FCEUmm, Snes9x 2002, Snes9x 2005, PicoDrive, gpSP, gpSP GBAC+Prosty, PCE Fast e QPSX.
• Inclui tema CajuOS em 320×240, português e scripts JS2300 de diagnóstico.
• Registra firmware_dirty=0, commit de firmware e checksum verificável.

Validação

• ZIP testado com unzip -t.
• Firmware conferido com checksums/FIRMWARE-SHA256SUMS.txt.
• JavaScript validado com node --check.
• OCFU validado em todos os 11 cores.
• Controles compilados com warnings estritos, GCC analyzer, ASan e UBSan.
• Health-check virtual: 8/8 passes, sem warnings.
• Driver virtual selecionou ROMS/PS/compilation.cue em cenário com .cue e .bin.
• Boot físico e desempenho no GB300 permanecem pendentes.

Hashes

ZIP
1776bb01a2c2d98b6bb1b27aa075292d44685bf601962a003a10170347036bd8  CajuOS-GB300-v0.3.3-beta-overlay.zip

FIRMWARE
904884a8a5ace55645367f0d62145b3403f83041d9f9f96775f592512dddf77a  unifrog/firmware/unifrog.bin

Aviso importante

Este é um beta exclusivo para GB300. O mantenedor não possui um GB300 físico neste momento; portanto, a release não deve ser tratada como confirmação de boot, desempenho, áudio, controles, autonomia ou compatibilidade total. Faça backup integral do cartão original, use uma cópia e restaure o backup se houver tela preta ou falha de boot. Não use o ZIP em outro console e não o grave diretamente como imagem de disco.

Leia BETA-NOTICE.md e docs/CajuOS-v0.3.3-beta-audit.md antes da instalação.

FrogOS/UniFrog

FrogOS/UniFrog continua sendo a referência conservadora e pública. O CajuOS não promete ser mais rápido: sua diferença está na personalização para GB300, localização em português, tema Caju, instrumentação de diagnóstico, perfil SNES explícito e prioridade CUE no PS1. Métricas reais de FPS, latência e autonomia aguardam teste físico.

Source e componentes

A base UniFrog v0.5.2 é pública. O overlay beta distribui binários e metadata; o source/patch completo específico da build CajuOS ainda não acompanha este artefato. Consulte overlay/unifrog/THIRD_PARTY.md, NOTICE-THIRD-PARTY.md e os avisos de cada core antes de redistribuir componentes.

Tópicos

gb300 cajuos unifrog frogos retro-gaming retro-handheld emulation firmware mipsel homebrew playstation snes gba megadrive pc-engine beta

English summary

CajuOS GB300 v0.3.3-beta is an experimental SD-card overlay for the DataFrog GB300. It is based on UniFrog v0.5.2, adds a Portuguese CajuOS interface and diagnostics, and fixes QPSX file selection by preferring .cue over .bin when both are present. It has passed structural and virtual-card checks, but it has not been boot-tested on a physical GB300. Back up the original card, use a copy, and do not install it on other consoles.