A little more partial work

Author: tannewt

locale/circuitpython.pot

@@ -1757,6 +1757,10 @@ msgstr ""
 msgid "Parameter error"
 msgstr ""
 
+#: shared-module/epaperdisplay/EPaperDisplay.c
+msgid "Partial display not supported"
+msgstr ""
+
 #: ports/espressif/common-hal/audiobusio/__init__.c
 msgid "Peripheral in use"
 msgstr ""

shared-bindings/epaperdisplay/EPaperDisplay.c

@@ -313,7 +313,10 @@ MP_DEFINE_CONST_FUN_OBJ_KW(epaperdisplay_epaperdisplay_update_refresh_mode_obj,
 
 //|     def refresh(self, partial: bool = False) -> None:
 //|         """Refreshes the display immediately or raises an exception if too soon. Use
-//|         ``time.sleep(display.time_to_refresh)`` to sleep until a refresh can occur."""
+//|         ``time.sleep(display.time_to_refresh)`` to sleep until a refresh can occur.
+//|
+//|           When partial is True, only the changed displayio areas are updated in black and white
+//|           mode."""
 //|         ...
 //|
 static mp_obj_t epaperdisplay_epaperdisplay_obj_refresh(size_t n_args, const mp_obj_t *pos_args, mp_map_t *kw_args) {

shared-module/epaperdisplay/EPaperDisplay.c

@@ -439,8 +439,18 @@ static bool _clean_area(epaperdisplay_epaperdisplay_obj_t *self) {
     return true;
 }
 
-bool common_hal_epaperdisplay_epaperdisplay_refresh(epaperdisplay_epaperdisplay_obj_t *self) {
-
+bool common_hal_epaperdisplay_epaperdisplay_refresh(epaperdisplay_epaperdisplay_obj_t *self, bool partial) {
+    #if CIRCUITPY_EPAPERDISPLAY_PARTIAL
+    if (partial && (self->partial_window_command == NO_COMMAND ||
+                    self->partial_start_command == NO_COMMAND ||
+                    self->partial_end_command == NO_COMMAND)) {
+        mp_raise_RuntimeError(MP_ERROR_TEXT("Partial display not supported"));
+    }
+    #else
+    if (partial) {
+        mp_raise_RuntimeError(MP_ERROR_TEXT("Partial display not supported"));
+    }
+    #endif
     if (self->refreshing && self->busy.base.type == &digitalio_digitalinout_type) {
         if (common_hal_digitalio_digitalinout_get_value(&self->busy) != self->busy_state) {
             supervisor_disable_tick();

shared-module/epaperdisplay/EPaperDisplay.h

@@ -37,6 +37,14 @@ typedef struct {
     bool grayscale;
     bool acep;
     bool two_byte_sequence_length;
+    #if CIRCUITPY_EPAPERDISPLAY_PARTIAL
+    bool save_full_framebuffer;
+    uint8_t *full_framebuffer;
+    uint16_t full_framebuffer_size;
+    uint16_t partial_window_command;
+    uint16_t partial_start_command;
+    uint16_t partial_stop_command;
+    #endif
     display_chip_select_behavior_t chip_select;
 } epaperdisplay_epaperdisplay_obj_t;