CYD_OS

Cheap Yellow Display Operational System CYDos

Firmware de escrita sem distrações para a placa ESP32-2432S028R, conhecida como CYD. O projeto usa ESP-IDF com Arduino-ESP32 como componente, tela touch, teclado Bluetooth HID Classic/BLE, editor de texto, gerenciador de arquivos, armazenamento interno LittleFS e cartão microSD. Baseado no 3OS Writer — ESP32 CYD.

Estado da versão

Versão: 1.11

Esta versão consolida:

• conexão de teclado Bluetooth Classic HID Host;
• protocolo BOOT para teclados Classic compatíveis;
• editor com tamanho de fonte ajustável;
• criação, abertura, renomeação e exclusão de arquivos e diretórios;
• salvamento atômico com .tmp e .bak;
• fallback automático do microSD para LittleFS interno;
• aproximadamente 832 KiB reservados para arquivos internos;
• menu Config em botões touch;
• diagnóstico na tela e logs estruturados;
• correção do erro de compilação -Werror=format-truncation em appLog;
• correção do subtipo da partição littlefs;
• remoção da opção obsoleta CONFIG_BT_SSP_ENABLED.

O pacote foi consolidado e revisado estaticamente. A correção v1.11 ainda precisa ser compilada e validada fisicamente na placa pelo mantenedor.

Hardware previsto

• ESP32-D0WD-V3;
• ESP32-2432S028R/CYD com tela 320 × 240;
• flash de 4 MB;
• cartão microSD opcional;
• teclado Bluetooth Classic ou BLE HID.

Ambiente de software

• ESP-IDF 5.5.5;
• Arduino-ESP32 3.3.11 como componente;
• Arduino_GFX 1.6.5;
• LittleFS via dependência do ecossistema ESP-IDF/Arduino.

Instalação rápida no macOS

chmod +x *.sh *.command
./INSTALAR_COMPILAR_GRAVAR.command

O script instala ou reutiliza o ESP-IDF em:

~/esp/esp-idf-v5.5.5

Na primeira compilação, o Arduino-ESP32 e outras dependências são baixados pelo IDF Component Manager. O script preparar_dependencias.sh baixa Arduino_GFX 1.6.5.

Primeira gravação da v1.11

A tabela de partições mudou para incluir LittleFS. Portanto, a primeira gravação precisa ser completa:

source "$HOME/esp/esp-idf-v5.5.5/export.sh"
idf.py build
idf.py -p /dev/cu.usbserial-140 flash monitor

Depois disso, mudanças normais no código podem ser compiladas e gravadas apenas na partição do aplicativo:

./COMPILAR_RAPIDO.command

Armazenamento

O modo padrão é AUTO:

1. o firmware monta o microSD;
2. testa criação, escrita, releitura e exclusão de um arquivo temporário;
3. usa o SD somente quando o teste é bem-sucedido;
4. em caso de falha, salva os documentos no LittleFS interno.

A tabela de partições está em partitions.csv.

Documentação

• Compilação e gravação
• Uso da aplicação
• Arquitetura
• Diagnóstico e logs
• Solução de problemas
• Licenciamento
• Histórico de versões

Atalhos principais do editor

• Tab ou Ctrl+S: salvar;
• F1: diminuir fonte;
• F2: aumentar fonte;
• F3: renomear;
• F4: salvar como;
• Esc: salvar e sair.

Saída do monitor serial

No idf.py monitor, pressione:

Ctrl + ]

Contribuições

Antes de abrir o repositório para contribuições externas, escolha e publique uma licença. Consulte docs/LICENSING.md.