|
| 1 | +"""Configurable startup sequence and compact hardware-information screen.""" |
| 2 | + |
| 3 | +import time |
| 4 | + |
| 5 | + |
| 6 | +BOARD_VENDOR = "Waveshare" |
| 7 | +BOARD_MODEL = "Touch LCD 1.28" |
| 8 | +UNKNOWN_VALUE = "Unknown" |
| 9 | + |
| 10 | +HARDWARE_SPLASH_BACKGROUND = "black" |
| 11 | +HARDWARE_SPLASH_TEXT_COLOUR = "white" |
| 12 | + |
| 13 | + |
| 14 | +class DeviceDetails: |
| 15 | + """Display-safe device metadata collected without requiring hardware.""" |
| 16 | + |
| 17 | + def __init__( |
| 18 | + self, |
| 19 | + firmware, |
| 20 | + cpu, |
| 21 | + os_name, |
| 22 | + os_version, |
| 23 | + platform, |
| 24 | + vendor=BOARD_VENDOR, |
| 25 | + model=BOARD_MODEL, |
| 26 | + ): |
| 27 | + self.vendor = vendor |
| 28 | + self.model = model |
| 29 | + self.firmware = firmware |
| 30 | + self.cpu = cpu |
| 31 | + self.os_name = os_name |
| 32 | + self.os_version = os_version |
| 33 | + self.platform = platform |
| 34 | + |
| 35 | + |
| 36 | +def _runtime_value(source, attribute): |
| 37 | + try: |
| 38 | + value = getattr(source, attribute) |
| 39 | + except Exception: |
| 40 | + return UNKNOWN_VALUE |
| 41 | + if value is None: |
| 42 | + return UNKNOWN_VALUE |
| 43 | + value = str(value).strip() |
| 44 | + return value if value else UNKNOWN_VALUE |
| 45 | + |
| 46 | + |
| 47 | +def _short_value(value, maximum=18): |
| 48 | + value = str(value) |
| 49 | + if len(value) <= maximum: |
| 50 | + return value |
| 51 | + return value[: maximum - 1] + "." |
| 52 | + |
| 53 | + |
| 54 | +def _runtime_name(implementation): |
| 55 | + name = _runtime_value(implementation, "name") |
| 56 | + known_names = { |
| 57 | + "micropython": "MicroPython", |
| 58 | + "cpython": "CPython", |
| 59 | + } |
| 60 | + return known_names.get(name.lower(), _short_value(name)) |
| 61 | + |
| 62 | + |
| 63 | +def _cpu_name(uname_info): |
| 64 | + machine = _runtime_value(uname_info, "machine") |
| 65 | + if "RP2040" in machine.upper(): |
| 66 | + return "RP2040" |
| 67 | + return _short_value(machine, maximum=12) |
| 68 | + |
| 69 | + |
| 70 | +def collect_device_details(firmware_version, uname_info=None, implementation=None): |
| 71 | + """Collect normalized details with safe fallbacks for missing fields.""" |
| 72 | + if uname_info is None: |
| 73 | + try: |
| 74 | + try: |
| 75 | + import uos as os |
| 76 | + except ImportError: |
| 77 | + import os |
| 78 | + uname_info = os.uname() |
| 79 | + except Exception: |
| 80 | + uname_info = object() |
| 81 | + |
| 82 | + if implementation is None: |
| 83 | + try: |
| 84 | + import sys |
| 85 | + implementation = sys.implementation |
| 86 | + except Exception: |
| 87 | + implementation = object() |
| 88 | + |
| 89 | + return DeviceDetails( |
| 90 | + firmware=_short_value(firmware_version, maximum=10), |
| 91 | + cpu=_cpu_name(uname_info), |
| 92 | + os_name=_runtime_name(implementation), |
| 93 | + os_version=_short_value( |
| 94 | + _runtime_value(uname_info, "release"), |
| 95 | + maximum=10, |
| 96 | + ), |
| 97 | + platform=_short_value( |
| 98 | + _runtime_value(uname_info, "sysname"), |
| 99 | + maximum=12, |
| 100 | + ), |
| 101 | + ) |
| 102 | + |
| 103 | + |
| 104 | +def hardware_splash_lines(details): |
| 105 | + """Build a circular-display-safe hardware summary.""" |
| 106 | + return [ |
| 107 | + ["Hardware", None, 24, 3, HARDWARE_SPLASH_TEXT_COLOUR], |
| 108 | + ["Board " + details.vendor, None, 70, 1, HARDWARE_SPLASH_TEXT_COLOUR], |
| 109 | + ["Model " + details.model, None, 94, 1, HARDWARE_SPLASH_TEXT_COLOUR], |
| 110 | + ["Type " + details.cpu, None, 118, 1, HARDWARE_SPLASH_TEXT_COLOUR], |
| 111 | + ["Firmware v" + details.firmware, None, 142, 1, HARDWARE_SPLASH_TEXT_COLOUR], |
| 112 | + [ |
| 113 | + "OS " + details.os_name + " " + details.os_version, |
| 114 | + None, |
| 115 | + 166, |
| 116 | + 1, |
| 117 | + HARDWARE_SPLASH_TEXT_COLOUR, |
| 118 | + ], |
| 119 | + ["Platform " + details.platform, None, 190, 1, HARDWARE_SPLASH_TEXT_COLOUR], |
| 120 | + ] |
| 121 | + |
| 122 | + |
| 123 | +def run_startup_screens( |
| 124 | + touch, |
| 125 | + lcd, |
| 126 | + firmware_version, |
| 127 | + startup_duration_sec, |
| 128 | + hardware_duration_sec, |
| 129 | + clock=time, |
| 130 | + details=None, |
| 131 | +): |
| 132 | + """Show artwork, then hardware details, for their configured durations.""" |
| 133 | + touch.BootScreen(lcd, version_number=firmware_version) |
| 134 | + clock.sleep(startup_duration_sec) |
| 135 | + |
| 136 | + if details is None: |
| 137 | + details = collect_device_details(firmware_version) |
| 138 | + touch.ControlScreen( |
| 139 | + lcd, |
| 140 | + text_array=hardware_splash_lines(details), |
| 141 | + back_colour=HARDWARE_SPLASH_BACKGROUND, |
| 142 | + ) |
| 143 | + clock.sleep(hardware_duration_sec) |
| 144 | + return details |
0 commit comments