Add native support for LVGL binary fonts on disk

This allows the terminal to use a font from the disk at
/fonts/terminal.lvfontbin for languages that need more
characters than we want to ship.

TileGrid now support 16bit indices as well.

Font files for use with it are generated by the GitHub actions
here:
https://github.com/adafruit/circuitpython-font-generator

Author: tannewt

.gitignore

@@ -97,3 +97,8 @@ TAGS
 # clangd cache
 ##############
 .cache
+
+**/CLAUDE.local.md
+
+# windsurf rules
+.windsurfrules

docs/environment.rst

@@ -189,4 +189,18 @@ This feature is not enabled on boards that the CIRCUITPY_OS_GETENV (os CIRCUIPTY
 flag has been set to 0. Currently this is primarily boards with limited flash including some
 of the Atmel_samd boards based on the SAMD21/M0 microprocessor.
 
+CIRCUITPY_TERMINAL_FONT
+~~~~~~~~~~~~~~~~~~~~~~~
+Specifies a custom font file path to use for the terminalio console instead of the default
+``/fonts/terminal.lvfontbin``. This allows users to create and use custom fonts for the
+CircuitPython console.
+
+This feature requires both CIRCUITPY_OS_GETENV and CIRCUITPY_LVFONTIO to be enabled.
+
+Example:
+
+.. code-block::
+
+    CIRCUITPY_TERMINAL_FONT="/fonts/myfont.lvfontbin"
+
 `boards that the terminalio core module is available on <https://docs.circuitpython.org/en/latest/shared-bindings/terminalio/>`_

locale/circuitpython.pot

@@ -1051,7 +1051,7 @@ msgstr ""
 msgid "File exists"
 msgstr ""
 
-#: shared-module/os/getenv.c
+#: shared-module/lvfontio/OnDiskFont.c shared-module/os/getenv.c
 msgid "File not found"
 msgstr ""
 
@@ -1247,6 +1247,7 @@ msgstr ""
 #: shared-bindings/digitalio/DigitalInOut.c
 #: shared-bindings/epaperdisplay/EPaperDisplay.c shared-bindings/pwmio/PWMOut.c
 #: shared-module/aurora_epaper/aurora_framebuffer.c
+#: shared-module/lvfontio/OnDiskFont.c
 msgid "Invalid %q"
 msgstr ""
 
@@ -1975,6 +1976,7 @@ msgstr ""
 #: shared-bindings/displayio/TileGrid.c
 #: shared-bindings/memorymonitor/AllocationSize.c
 #: shared-bindings/pulseio/PulseIn.c
+#: shared-bindings/tilepalettemapper/TilePaletteMapper.c
 msgid "Slices not supported"
 msgstr ""
 
@@ -2042,7 +2044,9 @@ msgstr ""
 msgid "Tile height must exactly divide bitmap height"
 msgstr ""
 
-#: shared-bindings/displayio/TileGrid.c shared-module/displayio/TileGrid.c
+#: shared-bindings/displayio/TileGrid.c
+#: shared-bindings/tilepalettemapper/TilePaletteMapper.c
+#: shared-module/displayio/TileGrid.c
 msgid "Tile index out of bounds"
 msgstr ""
 
@@ -4277,7 +4281,9 @@ msgstr ""
 msgid "unreadable attribute"
 msgstr ""
 
-#: shared-bindings/displayio/TileGrid.c shared-bindings/vectorio/VectorShape.c
+#: shared-bindings/displayio/TileGrid.c shared-bindings/terminalio/Terminal.c
+#: shared-bindings/tilepalettemapper/TilePaletteMapper.c
+#: shared-bindings/vectorio/VectorShape.c
 msgid "unsupported %q type"
 msgstr ""
 

ports/raspberrypi/common-hal/picodvi/__init__.c

@@ -74,11 +74,11 @@ static bool picodvi_autoconstruct_enabled(mp_int_t *default_width, mp_int_t *def
                     if ((established_timings & 0x80) != 0 &&
                         preferred_width % 1920 == 0 &&
                         preferred_height % 1080 == 0) {
-                        *default_width = 720 / 2;
-                        *default_height = 400 / 2;
+                        *default_width = 720;
+                        *default_height = 400;
                     } else {
-                        *default_width = 640 / 2;
-                        *default_height = 480 / 2;
+                        *default_width = 640;
+                        *default_height = 480;
                     }
                 }
             }
@@ -95,15 +95,15 @@ void picodvi_autoconstruct(void) {
         return;
     }
 
-    mp_int_t default_width = 320;
-    mp_int_t default_height = 240;
+    mp_int_t default_width = 640;
+    mp_int_t default_height = 480;
     if (!picodvi_autoconstruct_enabled(&default_width, &default_height)) {
         return;
     }
 
     mp_int_t width = default_width;
     mp_int_t height = 0;
-    mp_int_t color_depth = 16;
+    mp_int_t color_depth = 8;
     mp_int_t rotation = 0;
 
     (void)common_hal_os_getenv_int("CIRCUITPY_DISPLAY_WIDTH", &width);
@@ -113,6 +113,9 @@ void picodvi_autoconstruct(void) {
 
     if (height == 0) {
         switch (width) {
+            case 720:
+                height = 400;
+                break;
             case 640:
                 height = 480;
                 break;
@@ -134,7 +137,7 @@ void picodvi_autoconstruct(void) {
         // invalid configuration, set back to default
         width = default_width;
         height = default_height;
-        color_depth = 16;
+        color_depth = 8;
     }
 
     // construct framebuffer and display

ports/zephyr-cp/boards/nordic/nrf5340dk/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false

ports/zephyr-cp/boards/nordic/nrf54l15dk/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false

ports/zephyr-cp/boards/nordic/nrf7002dk/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false

ports/zephyr-cp/boards/renesas/ek_ra6m5/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false

ports/zephyr-cp/boards/renesas/ek_ra8d1/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false

ports/zephyr-cp/boards/st/nucleo_u575zi_q/autogen_board_info.toml

@@ -58,6 +58,7 @@ jpegio = false
 keypad = false
 keypad_demux = false
 locale = false
+lvfontio = false
 math = false
 max3421e = false
 mdns = false