How jona-walpert/piclock works
PiClock is a Raspberry Pi e-paper clock. Its main workflow schedules minute and midnight updates, renders clock or day-banner images, and refreshes the selected display; periodic time synchronization and power optimization support that loop. The README also documents Waveshare V2/V3/V4 panels, a mock driver, anti-ghosting cleans, and systemd autostart. Source excerpts show the main orchestration and driver stack; power-management internals and some display behavior were not sampled, so their detailed connections are omitted.
Main entry points: main.py Clock loop · display.py Display manager · driver_waveshare.py Waveshare adapter · time_sync.py Time synchronizer
Components 19
Clock runtime
- systemd service
piclock.service - Clock loop
main.py - Configuration
config.py
Display rendering
- Display manager
display.py - Clock and banner
display.py - Refresh and cleaning
display.py
Display drivers
- Driver factory
drivers/__init__.py - Driver interface
drivers/base.py - Waveshare adapter
drivers/driver_waveshare.py - Mock display
drivers/mock.py - Waveshare V2
drivers/waveshare/epd2in13_V2.py - Waveshare V3
drivers/waveshare/epd2in13_V3.py - Waveshare V4
drivers/waveshare/epd2in13_V4.py - GPIO and SPI
drivers/waveshare/epdconfig.py
Time and power
- Time synchronizer
time_sync.py - Power manager
power.py
Other components
- NTP servers
- systemd-timesyncd
- E-paper panel
Connections 25
- systemd service → Clock loop: starts
README.md - Clock loop → Display manager: initializes and updates
main.py - Clock loop → Time synchronizer: starts and checks
main.py - Clock loop → Power manager: invokes
main.py - Clock loop → Configuration: reads settings
main.py - Display manager → Configuration: reads settings
display.py - Display manager → Driver factory: selects driver
display.py - Display manager → Clock and banner: renders images
display.py - Display manager → Refresh and cleaning: performs refreshes
display.py - Refresh and cleaning → Driver interface: uses driver
- Driver factory → Mock display: selects mock
drivers/__init__.py - Driver factory → Waveshare adapter: selects Waveshare
drivers/__init__.py - Waveshare adapter → Driver interface: implements
drivers/driver_waveshare.py - Mock display → Driver interface: implements
drivers/mock.py - Waveshare adapter → Waveshare V2: loads revision
drivers/driver_waveshare.py - Waveshare adapter → Waveshare V3: loads revision
drivers/driver_waveshare.py - Waveshare adapter → Waveshare V4: loads revision
drivers/driver_waveshare.py - Waveshare V2 → GPIO and SPI: uses GPIO/SPI
drivers/waveshare/epd2in13_V2.py - Waveshare V3 → GPIO and SPI: uses GPIO/SPI
drivers/waveshare/epd2in13_V3.py - Waveshare V4 → GPIO and SPI: uses GPIO/SPI
drivers/waveshare/epd2in13_V4.py - GPIO and SPI → E-paper panel: controls
- Time synchronizer → Configuration: reads settings
time_sync.py - Time synchronizer → NTP servers: queries
time_sync.py - Time synchronizer → systemd-timesyncd: requests resync
time_sync.py - Power manager → Configuration: reads settings
power.py