Lecteur EPUB SF32 à écran e-paper¶

Qu'est-ce qu'EPD Reader ?¶

OpenSiFli EPD Reader adapte atomic14/diy-esp32-epub-reader au matériel SiFli SF32-OED-EPD. Le traitement repose sur le SF32LB52x. L'application lit les fichiers EPUB depuis le système de fichiers intégré ou une carte TF, analyse ZIP/XML/XHTML, met en page avec les polices FreeType et des décodeurs d'image, puis pilote une dalle à papier électronique avec des formes d'onde de rafraîchissement complet ou partiel.

L'application actuelle propose des vues pour la bibliothèque, la table des matières, la lecture, les réglages de lecture et de fonctions, l'accueil/l'écran éteint, la batterie faible, la charge et l'arrêt. Elle prend en charge les touches et le tactile, le chinois et l'anglais, les polices TTF/OTF dynamiques, la taille et la graisse, l'interligne, les marges et la persistance des réglages sur la carte TF. Pour réduire l'utilisation des ressources, la police chinoise fournie n'active pas par défaut de variantes grasses ou italiques distinctes. Vérifiez donc le rendu réel des options de graisse avec la police cible. Le projet constitue une référence complète de terminal de lecture à rafraîchissement peu fréquent, mais ne prouve ni la conformité générale à EPUB ni qu'il s'agit d'une liseuse prête pour la production.

Pourquoi l'implémentation SF32 ?¶

Ce parcours réunit dans une application le stockage du SF32LB52, l'accélération d'affichage EPIC/LCDC, le tactile, les touches, la surveillance de la batterie et la gestion basse consommation. Pour une équipe produit, l'intérêt ne se limite pas à afficher une page : sur le matériel pris en charge, il permet d'évaluer conjointement la mémoire nécessaire à la mise en page, les images rémanentes après rafraîchissement complet ou partiel, l'adaptation des formes d'onde, la gestion de l'alimentation de la carte TF, l'accès aux polices, le parcours d'interaction et le comportement en veille.

Le guide SiFli de la carte renvoie vers une page de vente d'échantillons, mais ne confirme pas que la carte, la dalle et le matériel tactile proposés correspondent à la base logicielle V1.1 du projet. Il n'identifie pas non plus un ensemble de référence précis ni une source distincte pour la dalle. Le projet amont ne publie pas non plus de taux de compatibilité EPUB, de plage de température de fonctionnement de la dalle, de durée de vie en production ni de consommation pour chaque mode. Cette page considère donc la révision matérielle, l'association dalle/tactile et le commit logiciel comme des éléments à figer dans la base technique. Les autres modules à papier électronique ne sont pas directement interchangeables.

Vérification de la configuration source : Le guide SiFli du SF32LB52-OED-6'-EPD décrit une dalle OPM060DA de 6 pouces, en 758 × 1024. Son schéma fonctionnel montre également les interfaces de la carte : EPD parallèle 8 bits en 8080, tactile I²C, carte TF en SPI1, microphone analogique/PA audio, USB-UART et alimentation par batterie/chargeur. La configuration V1.1 figée d'EPD Reader sélectionne plutôt une YZC085 V1.05 en 1032 × 758, tandis que la photo de la carte dans le Wiki porte la mention V1.2. Ces sources ne démontrent ni l'interchangeabilité d'OPM060DA et de YZC085 ni la fourniture de la dalle du Wiki avec V1.1. Vérifiez les marquages de la carte et de la dalle réelles, puis utilisez la cible du projet, la forme d'onde et les réglages VCOM correspondant à cet ensemble.

Exigence d'alimentation : le guide de la carte SiFli exige que la batterie reste connectée pendant le fonctionnement ; le VBUS USB-C sert à la charge et ne peut pas alimenter la carte seul. Le guide indique une batterie de 1 000 à 1 500 mAh et recommande une batterie Li-Po monocellulaire de 1 500 mAh avec connecteur MX1.25. La carte photographiée dans le guide porte la mention V1.2, alors que la base du projet cible V1.1 : vérifiez donc le connecteur d'alimentation, la polarité et les limites de charge de la carte exacte avant de choisir la batterie.

Résultat, portée et critères d'entrée¶

Résultat : sur une carte SF32-OED-EPD_V1.1 figée, utilisant une dalle YZC085 V1.05 à la résolution configurée de 1032 × 758, reproduire la compilation et le flashage, le parcours bibliothèque/sommaire/lecture, les entrées par touches et tactile, la persistance des réglages, les rafraîchissements complet/partiel, la batterie faible, la veille et l'arrêt, puis conserver les preuves nécessaires à une décision produit.

Hors portée : cette page ne démontre ni la compatibilité complète avec EPUB/CSS/polices, ni la prise en charge des DRM, ni la compatibilité des formes d'onde avec n'importe quelle dalle, ni une qualité de lecture commerciale, ni la distribution sans fil de contenu, ni la certification, ni la fiabilité en production. Le code figé expose des paramètres Bluetooth/PAN et une interface d'état, mais le README amont ne décrit aucun parcours de distribution de contenu par cette connexion. La base reproductible se limite aux fichiers locaux ; le transfert réseau n'est pas vérifié et reste hors périmètre.

Critères d'entrée : l'équipe sait compiler et flasher des applications avec SiFli-SDK et peut identifier la révision de la carte, le modèle de dalle, l'orientation du câble flexible, la polarité de la batterie et le système de fichiers de la carte TF. Si l'origine de la carte/dalle ou sa documentation matérielle n'est pas claire, ne vous engagez pas à l'achat avant confirmation par SiFli ou le fournisseur du matériel.

Spécifications matérielles et logicielles¶

Spécification matérielle¶

Spécification logicielle¶

Choisir une configuration de référence prise en charge¶

Pour la première reproduction, utilisez SF32-OED-EPD V1.1 + YZC085 V1.05 + FT5446U. Le dépôt décrit un parcours dédié de compilation et de flashage pour sf32-oed-epd_v11, et Kconfig en fait la combinaison par défaut de V1.1. Épinglez le commit principal 7d72223 et le sous-module SDK 8a1eb8a ; ne modifiez pas simultanément carte, dalle, contrôleur tactile et forme d'onde lors du premier essai.

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

Le script Windows de flashage est build_sf32-oed-epd_v11_hcpu\uart_download.bat. Exécutez-le et saisissez le port COM lorsqu'il le demande. Pour consulter les options :

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

Étapes du projet¶

Architecture système et dépendances¶

flowchart LR
    FS["Système de fichiers Flash intégré"] --> EL["Liste EPUB / ZIP / XML / XHTML"]
    SD["Carte TF : EPUB, polices, settings.cfg"] --> EL
    SD --> FM["Gestionnaire de polices FreeType"]
    EL --> LO["Pagination et état de lecture"]
    FM --> LO
    IM["Décodage PNG/JPEG"] --> LO
    BTN["Touches"] --> UI["Machine à états de l'interface"]
    TP["Tactile FT5446U"] --> UI
    UI --> LO
    LO --> FB["Framebuffer 1 bpp / 4 bpp"]
    FB --> EPD["EPIC/LCDC + formes d'onde complètes/partielles"]
    EPD --> PANEL["Dalle électronique YZC085 1032 × 758"]
    BAT["ADC batterie / charge / politique de délai"] --> UI
    UI --> PM["Veille carte TF / page d'accueil / arrêt"]

Les principaux domaines de panne sont l'analyse de l'archive et du XHTML, les fichiers de polices et la mémoire, la détection et l'alimentation de la carte TF, le mappage tactile/des touches, le modèle de dalle/la forme d'onde/le VCOM, les images rémanentes après rafraîchissement complet/partiel, l'ADC et l'état de charge de la batterie, ainsi que l'arrêt et le réveil. Tant que la documentation du projet n'a pas confirmé la prise en charge des fonctions sans fil ni décrit leur mode de transfert de contenu, gardez-les hors de la base de validation des fichiers locaux, de l'affichage et de l'alimentation.

Étape 1 — Fixer la référence physique et source¶

Objectif : vérifier que la carte, la dalle, le contrôleur tactile et le code source décrivent une même combinaison prise en charge.

1. Relevez les références de la carte V1.1, le composant SF32, le modèle de dalle, le contrôleur tactile, l'orientation de la nappe flexible et la source d'alimentation.
2. Épinglez le commit principal et le sous-module SDK, puis conservez l'état complet des sous-modules.
3. Compilez et flashez depuis un environnement propre ; calculez l'empreinte de chaque image et script de flashage générés.

Preuves à conserver : photos de l'assemblage, références des composants, état Git, configuration, journaux de compilation/flashage, empreintes des images et journal de démarrage.

Critère de sortie du point de contrôle 1 : l'assemblage correspond à la configuration par défaut sf32-oed-epd_v11 ; les entrées figées permettent de générer et de démarrer la même image de façon reproductible.

Étape 2 — Valider le flux de lecture intact¶

Objectif : valider le parcours utilisateur principal avant toute modification.

1. Recherchez séparément les fichiers EPUB dans le stockage intégré et sur la carte TF ; le firmware donne la priorité à cette dernière.
2. Suivez Accueil → Bibliothèque → Table des matières → Lecture, en vérifiant quatre livres par page, six entrées de sommaire par page et le fonctionnement « sélectionner, puis confirmer » avec les touches/le tactile.
3. Vérifiez le changement de page gauche/droite, le volet ouvert par balayage vers le haut, les sauts -5/-1/+1/+5, le retour au sommaire/à la bibliothèque et l'accès aux réglages de lecture.
4. Testez le chinois, l'anglais, les images PNG/JPEG et la navigation entre chapitres ; consignez les structures de contenu non prises en charge ou mal formées.

Preuves à conserver : source et empreintes des EPUB de test, photos des pages, chronologie des interactions, journaux, marge mémoire et classification des erreurs.

Critère de sortie du point de contrôle 2 : le parcours principal est répétable sur l'ensemble d'échantillons cible et chaque panne est classée comme liée au contenu, aux polices, au stockage, à la mémoire, aux entrées ou à l'affichage, plutôt que simplement attribuée à un problème « intermittent ».

Étape 3 — Valider les paramètres, le stockage et la récupération¶

Objectif : garantir que les contenus et réglages réels ne peuvent pas laisser l'utilisateur dans un état irrécupérable après des événements de stockage.

1. Placez les fichiers .ttf/.otf dans /fonts sur la carte TF ; vérifiez la détection et la sélection de jusqu'à 64 polices externes, ainsi que le recours à une solution de remplacement lorsqu'une police devient indisponible.
2. Testez les tailles de police de 24 à 48 px, la graisse, l'interligne de 1,0× à 2,0×, les marges de 5 à 20 px et la persistance après redémarrage via /settings.cfg.
3. À des moments sûrs sans écriture en cours, testez l'absence de carte, son retrait et sa réinsertion, des réglages corrompus et des polices indisponibles. Ne retirez pas la carte à chaud d'une manière qui corromprait intentionnellement le système de fichiers.
4. Vérifiez la limite actuelle : pendant l'exécution, « Continuer la lecture » conserve l'index du dernier livre ouvert et son chapitre ; ne présentez pas cette fonction comme une synchronisation complète de la progression après redémarrage.

Preuves à conserver : spécification et format de la carte, manifeste des ressources, fichier de réglages, résultats des redémarrages, journaux d'erreur et actions de récupération.

Critère de sortie du point de contrôle 3 : les contenus et réglages cibles se chargent de façon répétée ; l'absence de carte, une configuration invalide ou une police manquante déclenchent des solutions de repli compréhensibles qui permettent toujours de revenir à l'accueil.

Étape 4 — Évaluer la qualité d'affichage e-paper et la consommation électrique¶

Objectif : déterminer si le pilote de dalle et la politique basse consommation conviennent à l'expérience de lecture visée.

1. Validez les périodes de rafraîchissement complet de 5, 10 et 20, ainsi que le rafraîchissement complet à chaque fois (0) ; notez les images rémanentes, le clignotement, la durée et la cohérence des pages.
2. Validez forme d'onde, VCOM et minutage de la dalle cible sur la plage de température prévue. Ne reprenez pas les valeurs d'une autre configuration de dalle.
3. Validez les délais sélectionnables de 5/10/30 minutes, 1 heure et « jamais », ainsi que la politique par défaut indépendante qui affiche la page d'arrêt après cinq heures sans interaction dans la boucle principale.
4. Vérifiez le pourcentage de batterie et l'icône d'éclair de charge dans la barre d'état, y compris la disparition de l'icône à 98 %. Mesurez le courant pendant la pagination, les rafraîchissements partiel et complet, le repos, le réveil/la veille de la carte TF, la batterie faible, la charge et l'arrêt.

Preuves à conserver : versions de la dalle et des formes d'onde, température, images des pages, statistiques de rafraîchissement, traces de courant, état de la batterie et résultats du réveil/de l'arrêt.

Critère de sortie du point de contrôle 4 : des seuils sont définis et respectés pour la qualité d'affichage, le délai de rafraîchissement, la température, l'alimentation et la récupération ; chaque écart fait l'objet d'une décision explicite.

Étape 5 — Effectuer une adaptation contrôlée et vérifier la préparation¶

Objectif : démontrer que l'équipe peut adapter un élément précis sans dégrader la référence.

Les changements appropriés incluent l'ajout d'une police sous licence, l'ajustement d'une page, une correction limitée de compatibilité EPUB ou un pilote distinct pour une nouvelle dalle. L'intégration d'une nouvelle dalle doit couvrir Kconfig, résolution/DPI, tactile, bus, forme d'onde, plages de température, LUT, minutage et VCOM, tout en conservant la cible d'origine pour les tests de régression.

La revue produit doit répondre au minimum aux questions suivantes :

• Quel taux de compatibilité et quelle limite mémoire s'appliquent au corpus EPUB/XHTML/CSS/images/langues visé ?
• Qui contrôle et spécifie l'approvisionnement de la dalle, sa forme d'onde, VCOM, sa plage de température et sa durée de vie ?
• Les licences des contenus, polices, application principale et bibliothèques tierces autorisent-elles la distribution prévue ?
• Comment l'appareil récupère-t-il après corruption de la carte TF ou des réglages, batterie faible, arrêt anormal, firmware corrompu ou mise à jour interrompue ?
• Si Bluetooth/PAN est retenu, comment sont définis son objectif, l'appairage, la sécurité, la confidentialité et la conformité radio ?
• Comment les tests de production couvriront-ils les défauts d'affichage/images rémanentes, le tactile, les touches, le stockage, l'ADC batterie, la charge et le courant de veille ?

Preuves à conserver : revue de la modification, diff, matrice de régression, registre des risques, responsables et décision produit.

Critère de sortie du point de contrôle 5 : la modification contrôlée réussit tous les tests de régression applicables. Les risques résiduels liés au contenu, à l'affichage, à l'alimentation, à la sécurité, aux licences, à l'approvisionnement et à la réglementation ont des responsables et des mesures d'atténuation ; la décision de poursuivre, différer ou arrêter est consignée.

Passage à la conception du produit¶

Le dossier de transfert doit inclure les révisions de la carte, de la dalle et du tactile, les versions figées du code et du SDK, la mémoire et les partitions, les systèmes de fichiers, les ressources de polices et de contenu, la forme d'onde/VCOM/la temporisation, la politique de rafraîchissement complet/partiel, le mappage des entrées, la courbe de batterie, les mesures d'alimentation, la récupération après panne, le manifeste des licences et le plan de test en production. Utilisez le parcours d'intégration SF32LB52x pour choisir le circuit, le module, la carte, le guide de conception matérielle et la liste de contrôle, puis reconcevez le matériel personnalisé à partir du périmètre fonctionnel validé.

Sources de référence¶

• OpenSiFli/EPD_Reader
• Commit de revue du projet 7d72223
• README officiel en chinois d'EPD Reader
• Commit figé du sous-module SiFli-SDK 8a1eb8a
• Kconfig de la carte et de la dalle EPD Reader
• Configuration de la carte EPD Reader V1.1
• Licence MIT de l'application principale EPD Reader
• atomic14/diy-esp32-epub-reader
• Guide SiFli de compilation et de flashage pour SF32LB52x
• Guide matériel SiFli en chinois pour SF32LB52-OED-6'-EPD

Dernière mise à jour: 2026-10-19