dtourolle/dreader-hal
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add logging of screen events
Some checks failed
Python CI / test (3.12) (push) Failing after 42s
Details
Python CI / test (3.13) (push) Failing after 41s
Details

Browse Source
This commit is contained in:
Duncan Tourolle 2025-11-23 14:21:24 +01:00
parent e5e9f62e31
commit bfa51c1439
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
src/dreader_hal/display/it8951.py
View File

@ -12,6 +12,7 @@ Hardware: IT8951 controller (used in Waveshare 6" e-Paper HAT and similar)
""" """
import asyncio import asyncio
import logging
import sys import sys
import os import os
from typing import Optional from typing import Optional
@ -25,6 +26,8 @@ from IT8951.constants import DisplayModes
from ..types import RefreshMode from ..types import RefreshMode
logger = logging.getLogger(__name__)
class IT8951DisplayDriver: class IT8951DisplayDriver:
""" """
@ -93,6 +96,7 @@ class IT8951DisplayDriver:
"""Blocking initialization of display (runs in thread pool).""" """Blocking initialization of display (runs in thread pool)."""
if self.virtual: if self.virtual:
# Virtual display for testing # Virtual display for testing
logger.info(f"Initializing IT8951 virtual display: {self.width}x{self.height}")
self.display = VirtualEPDDisplay( self.display = VirtualEPDDisplay(
dims=(self.width, self.height), dims=(self.width, self.height),
rotate=self.rotate, rotate=self.rotate,
@ -100,6 +104,7 @@ class IT8951DisplayDriver:
) )
else: else:
# Real e-ink display # Real e-ink display
logger.info(f"Initializing IT8951 e-ink display: {self.width}x{self.height}, VCOM={self.vcom}V")
self.display = AutoEPDDisplay( self.display = AutoEPDDisplay(
vcom=self.vcom, vcom=self.vcom,
bus=self.bus, bus=self.bus,
@ -110,7 +115,9 @@ class IT8951DisplayDriver:
) )
# Clear screen # Clear screen
logger.info("Clearing IT8951 display to white")
self.display.clear() self.display.clear()
logger.info("IT8951 display initialized successfully")
async def cleanup(self) -> None: async def cleanup(self) -> None:
""" """
@ -162,6 +169,9 @@ class IT8951DisplayDriver:
# Determine refresh mode # Determine refresh mode
display_mode = self._determine_refresh_mode(mode) display_mode = self._determine_refresh_mode(mode)
mode_name = self._get_mode_name(display_mode)
logger.info(f"[IT8951] Displaying image {image.size} {image.mode} | Refresh #{self._refresh_count + 1} | Mode: {mode_name}")
# Prepare image for e-ink # Prepare image for e-ink
prepared_image = self._prepare_image(image) prepared_image = self._prepare_image(image)
@ -180,6 +190,8 @@ class IT8951DisplayDriver:
display_mode display_mode
) )
logger.info(f"[IT8951] Display update completed (refresh #{self._refresh_count})")
# Automatically put display to sleep after update to save power # Automatically put display to sleep after update to save power
# E-ink displays only need power during refresh, not for static display # E-ink displays only need power during refresh, not for static display
if self.auto_sleep: if self.auto_sleep:
@ -279,6 +291,17 @@ class IT8951DisplayDriver:
# Default to DU (fast) # Default to DU (fast)
return DisplayModes.DU return DisplayModes.DU
def _get_mode_name(self, display_mode: int) -> str:
"""Get human-readable name for display mode."""
if display_mode == DisplayModes.INIT:
return "INIT (full refresh)"
elif display_mode == DisplayModes.DU:
return "DU (fast)"
elif display_mode == DisplayModes.GC16:
return "GC16 (quality)"
else:
return f"Mode {display_mode}"
def _update_display(self, display_mode: int) -> None: def _update_display(self, display_mode: int) -> None:
""" """
Update the physical display (blocking). Update the physical display (blocking).