Add CIRCUITPY_TERMINAL_SCALE settings.toml parameter

Author: RetiredWizard

docs/environment.rst

@@ -174,3 +174,11 @@ Example: Configure the display to 640x480 black and white (1 bit per pixel):
 
 `Adafruit Feather RP2350 <https://circuitpython.org/board/adafruit_feather_rp2350/>`_
 `Adafruit Metro RP2350 <https://circuitpython.org/board/adafruit_metro_rp2350/>`_
+
+CIRCUITPY_TERMINAL_SCALE
+~~~~~~~~~~~~~~~~~~~~~~~~
+Allows the entry of a display scaling factor used during the terminalio console construction.
+The entered scaling factor only affects the terminalio console and has no impact on
+the UART, Web Workflow, BLE Workflow, etc consoles.
+
+`boards that the terminalio core module is available on <https://docs.circuitpython.org/en/latest/shared-bindings/terminalio/>`

supervisor/shared/display.c

@@ -36,6 +36,7 @@
 
 #if CIRCUITPY_TERMINALIO
 #include "supervisor/port.h"
+#include "shared-module/os/__init__.h"
 #endif
 
 #if CIRCUITPY_REPL_LOGO
@@ -55,7 +56,7 @@ void supervisor_start_terminal(uint16_t width_px, uint16_t height_px) {
     }
     // Default the scale to 2 because we may show blinka without the terminal for
     // languages that don't have font support.
-    uint8_t scale = 2;
+    mp_int_t scale = 2;
 
     #if CIRCUITPY_TERMINALIO
     displayio_tilegrid_t *scroll_area = &supervisor_terminal_scroll_area_text_grid;
@@ -66,6 +67,7 @@ void supervisor_start_terminal(uint16_t width_px, uint16_t height_px) {
     if (width_in_tiles <= 80) {
         scale = 1;
     }
+    (void)common_hal_os_getenv_int("CIRCUITPY_TERMINAL_SCALE", &scale);
 
     width_in_tiles = MAX(1, width_px / (scroll_area->tile_width * scale));
     uint16_t height_in_tiles = MAX(2, height_px / (scroll_area->tile_height * scale));