Leitor de EPUB com e-paper SF32¶

O que é o EPD Reader?¶

OpenSiFli EPD Reader adapta o projeto atomic14/diy-esp32-epub-reader ao hardware SiFli SF32-OED-EPD. O SF32LB52x atua como processador. O sistema lê arquivos EPUB do sistema de arquivos integrado ou de um cartão TF, analisa ZIP/XML/XHTML, usa fontes FreeType e decodificadores de imagem para compor as páginas e, em seguida, controla um display de tinta eletrônica com formas de onda de atualização completa e parcial.

O aplicativo atual oferece telas de biblioteca, sumário, leitura, configurações de leitura e de funções, boas-vindas/tela apagada, bateria fraca, carregamento e desligamento. Aceita teclas e toque, textos em chinês e inglês, fontes TTF/OTF carregadas dinamicamente, ajustes no tamanho e no peso da fonte, espaçamento entre linhas e margens, além de salvar as configurações de leitura no cartão TF. Para economizar recursos, a fonte chinesa incluída não habilita estilos separados de negrito e itálico por padrão; valide o resultado real das opções de peso com a fonte escolhida. É uma referência completa para um terminal de leitura com baixa frequência de atualização do display, mas não comprova conformidade geral com EPUB nem constitui um leitor eletrônico pronto para produção.

Por que usar SF32 nesta implementação?¶

Este roteiro reúne em um único aplicativo o armazenamento do SF32LB52, a aceleração de display EPIC/LCDC, o toque, as teclas, o monitoramento da bateria e o gerenciamento de baixo consumo. Para uma equipe de produto, o valor não está apenas em exibir uma página: o exemplo permite avaliar em conjunto o uso de memória durante a composição, o efeito fantasma nas atualizações completas/parciais, a adaptação das formas de onda, o gerenciamento de energia do cartão TF, o acesso às fontes, o fluxo de interação e o comportamento de suspensão no hardware compatível.

A documentação da placa da SiFli inclui um link para uma página que anuncia a placa para venda, mas não confirma que a placa, o painel e o hardware de toque oferecidos correspondam à base de software V1.1 do projeto. Também não especifica uma configuração de referência completa nem uma fonte separada para o painel. O upstream não informa a taxa de cobertura de EPUB, a faixa de temperatura de operação do painel, a vida útil em produção nem a corrente em cada modo. Por isso, esta página trata a revisão do hardware, a combinação de painel e toque e o commit do software como uma base de engenharia obrigatória. Outros módulos de tinta eletrônica não são substitutos diretos.

Verificação da base documental: O guia da SiFli para o SF32LB52-OED-6'-EPD descreve um painel OPM060DA de 6 polegadas com resolução de 758 × 1024. O diagrama de blocos também mostra os caminhos da placa: interface EPD 8080 de 8 bits, toque por I²C, cartão TF por SPI1, microfone analógico/PA de áudio, USB-UART e alimentação por bateria/carregador. Já a configuração V1.1 fixada do EPD Reader seleciona o YZC085 V1.05, de 1032 × 758, e a foto da placa na Wiki está identificada como V1.2. Essas fontes não comprovam que OPM060DA e YZC085 sejam intercambiáveis nem que a V1.1 seja fornecida com o painel da Wiki. Confira as marcações da placa e do painel reais e, em seguida, use o alvo do projeto, a forma de onda e os ajustes VCOM correspondentes.

Requisito de alimentação: o guia da placa da SiFli exige que a bateria permaneça conectada durante o funcionamento; o VBUS USB-C serve para carregar e não consegue alimentar a placa sozinho. O guia especifica uma bateria de 1000–1500 mAh e recomenda uma Li-Po de uma célula, 1500 mAh, com conector MX1.25. Como a placa fotografada no guia está identificada como V1.2 e a base do projeto aponta para V1.1, confirme o conector de alimentação, a polaridade e os limites de carga da placa exata antes de escolher a bateria.

Resultado, escopo e critérios de entrada¶

Resultado esperado: em uma placa SF32-OED-EPD_V1.1 fixada, usando o painel YZC085 V1.05 com resolução configurada de 1032 × 758, reproduzir compilação e gravação, biblioteca/sumário/leitura, entrada por tecla e toque, persistência das configurações, atualização completa/parcial, bateria fraca, suspensão e desligamento; depois, registrar as evidências necessárias para decidir sobre o produto.

Fora do escopo: esta página não comprova compatibilidade completa com EPUB/CSS/fontes, suporte a DRM, compatibilidade das formas de onda com painéis arbitrários, qualidade de leitura comercial, distribuição sem fio de conteúdo, certificação nem confiabilidade em produção. O código fixado inclui opções de configuração e uma interface de status para Bluetooth/PAN, mas o README upstream não descreve um fluxo de distribuição de conteúdo por essa conexão. Trate os arquivos locais como a base reproduzível; a transferência pela rede não foi verificada e fica fora do escopo.

Critérios de entrada: a equipe consegue compilar e gravar aplicativos do SiFli-SDK e identificar a revisão da placa, o modelo do painel, a orientação do cabo flexível, a polaridade da bateria e o sistema de arquivos do cartão TF. Se a origem da placa/painel e a documentação de hardware não estiverem claras, suspenda qualquer compromisso de compra até que a SiFli ou o fornecedor do hardware confirme esses dados.

Especificações de hardware e software¶

Especificação de hardware¶

Especificação de software¶

Escolher uma configuração de referência suportada¶

Na primeira reprodução, use SF32-OED-EPD V1.1 + YZC085 V1.05 + FT5446U. O upstream documenta um caminho explícito de compilação e gravação para sf32-oed-epd_v11, e o Kconfig define essa combinação como padrão da V1.1. Fixe o commit principal 7d72223 e o submódulo do SDK 8a1eb8a; na primeira rodada, não altere ao mesmo tempo a placa, o painel, o controlador de toque e a forma de onda.

git clone --recursive https://github.com/OpenSiFli/EPD_Reader.git
cd EPD_Reader/epdiy-epub/project
scons --board=sf32-oed-epd_v11 --board_search_path=.. -j8

No Windows, o script de gravação é build_sf32-oed-epd_v11_hcpu\uart_download.bat. Execute-o e informe a porta COM quando solicitado. Para consultar as opções:

scons --board=sf32-oed-epd_v11 --board_search_path=.. --menuconfig

Etapas do projeto¶

Arquitetura do sistema e dependências¶

flowchart LR
    FS["Sistema de arquivos Flash integrado"] --> EL["Lista EPUB / ZIP / XML / XHTML"]
    SD["Cartão TF: EPUB, fontes, settings.cfg"] --> EL
    SD --> FM["Gerenciador de fontes FreeType"]
    EL --> LO["Paginação e estado de leitura"]
    FM --> LO
    IM["Decodificação PNG / JPEG"] --> LO
    BTN["Teclas"] --> UI["Máquina de estados da interface"]
    TP["Toque FT5446U"] --> UI
    UI --> LO
    LO --> FB["Framebuffer de 1 bpp / 4 bpp"]
    FB --> EPD["EPIC/LCDC + formas de onda completas/parciais"]
    EPD --> PANEL["Painel de tinta eletrônica YZC085 1032 × 758"]
    BAT["ADC da bateria / carregamento / política de timeout"] --> UI
    UI --> PM["Suspensão do cartão TF / tela de boas-vindas / desligamento"]

Os principais domínios de falha são a análise do arquivo compactado e do XHTML, os arquivos de fonte e a memória, a detecção e alimentação do cartão TF, o mapeamento de toque/teclas, o modelo do painel e sua forma de onda/VCOM, o efeito fantasma na atualização completa/parcial, o ADC da bateria e o estado de carga, além do desligamento e da retomada. Mantenha qualquer recurso sem fio futuro fora da configuração de referência para arquivos locais, display e alimentação até que a documentação do projeto confirme seu suporte e descreva como o conteúdo será transferido.

Etapa 1 — Fixar a base física e de código-fonte¶

Objetivo: comprovar que placa, painel, controlador de toque e código-fonte correspondem a uma combinação compatível.

1. Registre as marcações da placa V1.1, o dispositivo SF32, o modelo do painel, o controlador de toque, a orientação do cabo flexível e a fonte de alimentação.
2. Fixe o commit principal e o submódulo do SDK e guarde o estado completo dos submódulos.
3. Compile e grave em um ambiente limpo; calcule o hash de cada imagem gerada e do script de gravação.

Evidências a registrar: fotos do conjunto, identificadores dos componentes, estado do Git, configuração, logs de compilação/gravação, hashes das imagens e log de inicialização.

Critério de saída do ponto de controle 1: o conjunto corresponde à combinação padrão sf32-oed-epd_v11, e os insumos fixados geram e inicializam de forma reproduzível a mesma imagem.

Etapa 2 — Validar o fluxo de leitura sem alterações¶

Objetivo: comprovar o fluxo principal do usuário antes de fazer qualquer alteração.

1. Localize os arquivos EPUB separadamente no armazenamento integrado e no cartão TF; o firmware dá prioridade ao cartão TF.
2. Conclua o fluxo Home (Início) → Library (Biblioteca) → Contents (Sumário) → Reading (Leitura). Verifique quatro itens de biblioteca por página, seis itens de sumário por página e o comportamento de teclas/toque “selecionar e confirmar”.
3. Valide a mudança de página para a esquerda/direita, a sobreposição acionada pelo gesto para cima, os saltos -5/-1/+1/+5, o retorno ao sumário/biblioteca e o acesso às configurações de leitura.
4. Teste chinês, inglês, PNG/JPEG e navegação entre capítulos; registre estruturas de conteúdo não suportadas ou malformadas.

Evidências a registrar: origem e hash dos EPUBs de teste, fotos das páginas, sequência de interação, logs, memória disponível e falhas classificadas.

Critério de saída do ponto de controle 2: o fluxo principal se repete no conjunto de amostras previsto, e cada falha é classificada como conteúdo, fonte, armazenamento, memória, entrada ou display, em vez de ser descrita apenas como “intermitente”.

Etapa 3 — Validar configurações, armazenamento e recuperação¶

Objetivo: garantir que eventos de armazenamento não deixem o usuário sem possibilidade de recuperação ao usar conteúdo e configurações reais.

1. Coloque arquivos .ttf/.otf em /fonts no cartão TF; valide a descoberta de até 64 fontes externas, a seleção e a alternativa usada quando uma fonte deixa de estar disponível.
2. Teste tamanhos de fonte de 24–48 px, peso da fonte, espaçamento entre linhas de 1,0×–2,0×, margens de 5–20 px e persistência após reinicialização por meio de /settings.cfg.
3. Em pontos seguros, sem gravação em andamento, teste ausência, remoção e reinserção do cartão, configurações corrompidas e fontes indisponíveis; não remova o cartão durante uma gravação de modo a corromper intencionalmente o sistema de arquivos.
4. Confirme o limite atual: “Continue Reading” (“Continuar lendo”) mantém o índice do livro e o capítulo abertos mais recentemente durante a execução atual; não descreva isso como sincronização completa do progresso de leitura entre reinicializações.

Evidências a registrar: especificação e formato do cartão, manifesto de arquivos, arquivo de configurações, resultados após reinicialização, logs de erro e ações de recuperação.

Critério de saída do ponto de controle 3: o conteúdo e as configurações previstos carregam de forma repetível; ausência do cartão, configuração inválida ou fonte ausente acionam alternativas compreensíveis sem impedir o retorno à tela Início.

Etapa 4 — Avaliar a qualidade do display de tinta eletrônica e o consumo de energia¶

Objetivo: determinar se o driver do display e a política de baixo consumo atendem à experiência de leitura pretendida.

1. Valide os períodos de atualização completa 5, 10, 20 e sempre (0), registrando efeito fantasma, piscadas, tempo de atualização e consistência das páginas.
2. Valide a forma de onda, o VCOM e a temporização do painel previsto em toda a faixa de temperatura esperada; não copie valores de outra configuração de painel.
3. Valide as opções de timeout escolhidas pelo usuário: 5/10/30 minutos, 1 hora e nunca. Verifique também a política padrão independente, que abre a tela de desligamento após cinco horas sem interação no loop principal.
4. Valide a porcentagem da bateria na barra de status e o ícone de carregamento, inclusive a remoção do ícone quando a carga chega a 98%; meça a corrente durante paginação, atualização parcial/completa, inatividade, ativação/suspensão do cartão TF, bateria fraca, carregamento e desligamento.

Evidências a registrar: versão do painel e da forma de onda, temperatura, imagens das páginas, estatísticas de atualização, traços de corrente, condições da bateria e resultados de ativação/desligamento.

Critério de saída do ponto de controle 4: os limites de qualidade do display, latência de atualização, temperatura, consumo e recuperação estão definidos e foram atendidos; cada desvio tem um encaminhamento explícito.

Etapa 5 — Fazer uma adaptação controlada e revisar a prontidão¶

Objetivo: comprovar que a equipe consegue adaptar um aspecto delimitado sem comprometer a configuração de referência.

Alterações adequadas incluem adicionar uma fonte licenciada, ajustar uma página, implementar uma correção delimitada de compatibilidade EPUB ou adicionar um driver separado para um novo painel. O trabalho com outro painel deve abranger Kconfig, resolução/DPI, toque, barramento, forma de onda, faixas de temperatura, LUT, temporização e VCOM, mantendo o alvo original da placa para os testes de regressão.

Na revisão do produto, responda pelo menos às seguintes perguntas:

• Qual taxa de compatibilidade e limite de memória se aplicam ao conjunto de EPUB/XHTML/CSS/imagens/idiomas previsto?
• Quem controla e especifica o fornecimento do painel, a forma de onda, o VCOM, a faixa de temperatura e a vida útil?
• Como as licenças do conteúdo, das fontes, do aplicativo principal e de cada biblioteca de terceiros permitem a distribuição?
• Como o dispositivo se recupera de corrupção do cartão TF ou das configurações, bateria fraca, desligamento anormal, firmware corrompido ou atualização interrompida?
• Se Bluetooth/PAN fizer parte do escopo, como serão definidos seu propósito, pareamento, segurança, privacidade e conformidade de rádio?
• Como os testes de produção cobrirão defeitos/efeito fantasma no display, toque, teclas, armazenamento, ADC da bateria, carregamento e corrente em suspensão?

Evidências a registrar: revisão da alteração, diff, matriz de regressão, registro de riscos, responsáveis e decisão sobre o produto.

Critério de saída do ponto de controle 5: a alteração controlada passa por todos os testes de regressão aplicáveis, e os riscos restantes de conteúdo, display, alimentação, segurança, licenciamento, fornecimento e regulamentação têm responsáveis, medidas de mitigação e uma decisão de prosseguir, adiar ou interromper.

Transição para o projeto do produto¶

O pacote de transição deve incluir as revisões da placa, do painel e do toque; código-fonte e SDK fixados; memória e partições; sistemas de arquivos; fontes e conteúdo; forma de onda/VCOM/temporização; política de atualização completa/parcial; mapa de entradas; curva da bateria; medições de consumo; recuperação de falhas; manifesto de licenças e plano de testes de produção. Use o caminho de integração do SF32LB52x para selecionar chip, módulo, placa, guia de projeto de hardware e checklist; em seguida, projete o hardware próprio com base nos limites funcionais já validados.

Fontes de referência¶

• OpenSiFli/EPD_Reader
• Commit analisado do projeto: 7d72223
• README oficial do EPD Reader em chinês
• Commit fixado do submódulo SiFli-SDK: 8a1eb8a
• Kconfig de placa e painel do EPD Reader
• Configuração da placa EPD Reader V1.1
• Licença MIT do aplicativo principal EPD Reader
• atomic14/diy-esp32-epub-reader
• Guia SiFli para compilar e gravar o SF32LB52x
• Guia de hardware em chinês da SiFli para SF32LB52-OED-6'-EPD

Última atualização: 2026-10-19