ZEReader is a Zephyr based firmware for an open hardware eBook reader approach. See https://github.com/Allegra42/ZEReader-KiCad for more information about the hardware design.
The firmware is currently in a really early PoC stage. Nevertheless, due to Zephyr, it is easily portable and adaptable to different hardware platforms which provide the essential components and a proper device tree (overlay) configuration.
The ZEReader firmware is, based on Zephyr, highly flexible and can be adopted to a wide range of different hardware with a proper device tree (overlay). In general, the development and testing is based on the following components:
- Raspberry Pi Pico 1/2
- Waveshare ePaper Display 7,5" (Gooddisplay GDEW075T7, GDEY075T7) with UC8179 controller
- SD Card Reader (SPI)
- 4 Buttons for navigation
The ZEReader PCB itself is developed in a seperated git repository available here.
west init -m [email protected]:Allegra42/ZEReader.git zereader-workspace
cd zereader-workspace
python3 -m venv .venv
source .venv/bin/activate
west update
pip install -r zephyr-rtos/scripts/requirements.txt
cd zephyr-rtos
west sdk install
Always source the venv environment first!
cd zereader-workspace
source .venv/bin/activate
cd ZEReader
west build -b rpi_pico app -p always
west build -b rpi_pico2/rp2350a/m33 app -p always
west build -b zereader_rev1/rp2350a/m33 app -p always
# Update Zephyr and external modules
# The west.yml of this project uses potentially unstable main branches from Zephyr and the modules.
# This was needed as neighter Pi Pico 2 nor LVGL v9 were included in the 4.0 release, but more or less important for this project.
# Be aware this can break!
west update
# May check if patches in this repo are (still) needed or new ones needed or new issues showed up.
# Generate SBoM
west spdx
- disconnect USB
- press the 'BOOTSEL' button during reconnect
- the device shows up as a mass storage
- copy 'build/zephyr/zephyr.uf2' to the device
- it flashes itself and restarts running the firmware
Logs are printed via the Pi Pico default UART pins with 115200 bauds.
With Blackmagic Debug Probe using the SWD interface:
-
connect the Blackmagic Debug Probe to the Pi Pico's SWD header
-
west debug --runner blackmagicprobe-> Connects to a GDB session -
set breakpoint with
break <full/source/code/file/path>:<linenumber> -
step through / step in with GDB commands (next/n, step in/si, ..)
This is still a work-in-process. The firmware shows a proof-of-concept that reading EPUBs as they are is possible with the available resources of a cheap microcontroller unit like the RP2040/RP2350. (Right now, without unzipping the EPUB files directly from Zephyr.)
The firmware supports showing the contents of a book in correct order while jumping over pictures and leave (X)HTML formatting untouched.
The UI implementation is still very basic. The display orientation is still landscape and refresh configurations need to be tuned for an actually usable reading experience.
Config options for EPUB handling are still part of epub.h and should move to an own KConfig definition as the project proceeds in order to keep these configurations in a central location adopt Zephyr idioms.
See the GitHub issue page for a closer look on planned tasks.