Skip to main content

OSHE Framework Desktop Usage Display

The OSHE Framework Desktop Usage Display is a front display panel for the Framework Desktop, developed by the Open Source Hardware Enterprise (OSHE) team at Michigan Technological University12. The display mounts to the front panel of the Framework Desktop and shows real-time computer statistics such as CPU utilization, providing a simple, cheap, and good-looking proof of concept for a status display1.

The project was developed alongside OSHE's I2C expansion card and has evolved through two display technologies: an initial I2C LCD and a later SPI OLED with microcontroller-based architecture13.

In Development

The project has progressed through multiple iterations. The initial LCD version was feature-complete as of November 2025, and an updated OLED version was nearing completion as of April 20261.

Background

The Framework Desktop features a front panel with slots for 21 interchangeable tiles, and its CAD files enable creation of custom front tiles4. OSHE saw an opportunity to add a useful status display to the front panel, addressing the limited space available while providing at-a-glance system information1.

OSHE is a student team at Michigan Technological University that develops open-source hardware projects for the Framework ecosystem. Framework Computer supported their development by providing a Framework 13 mainboard and Cooler Master case for physical and electrical testing23.

Design Evolution

Version 1: I2C LCD Display (November 2025)

The initial version used an I2C LCD display from Freenove, chosen for its sleek design and ease of use through the I2C protocol1. A Python script was developed to be easily editable, allowing users to choose which computer statistics to display1. The display ran on Windows 11 and Linux Mint, and initially used a prototype of OSHE's I2C expansion card to drive the display1.

FeatureDetails
DisplayI2C LCD (Freenove)1
InterfaceI2C1
DriverOSHE I2C expansion card prototype1
SoftwarePython script (easily editable)1
PlatformsWindows 11, Linux Mint1
StatsCPU utilization and other configurable statistics1

Version 2: SPI OLED Display (March–April 2026)

OSHE later moved to a 128×64 SPI Black/White OLED display, which is significantly thinner than the LCD and enables a better-looking design1. The architecture shifted from direct I2C to a microcontroller-based approach, allowing more customization and independent sleep detection by checking when the last serial packet was received from the host1.

FeatureDetails
Display128×64 SPI Black/White OLED1
InterfaceSPI (via microcontroller)1
MicrocontrollerPico-based boards (RP2040), supporting Adafruit TinyUSB1
Sleep detectionChecks last received serial packet timestamp1
Burn-in mitigationAdded1
Auto-execWorks on Linux and Windows (no manual launch needed)1
Sleep screenDVD-style screensaver animation1

The microcontroller requirements are flexible — any board supporting Adafruit TinyUSB works, though OSHE prefers pico-based boards for their processing power in a small package1.

Technical Specifications

SpecificationDetails
OrganizationMichigan Technological University — OSHE1
TargetFramework Desktop front panel1
Display (v1)I2C LCD (Freenove)1
Display (v2)128×64 SPI OLED (Black/White)1
MicrocontrollerRP2040-based (pico boards)1
SoftwarePython script (editable statistics)1
PlatformsWindows 11, Linux Mint1
LicenseOpen source1
GitHubOSHE-Github/OSHE-Framework1
StatusOLED version nearing release (April 2026)1

OSHE Projects

OSHE has developed multiple Framework-related projects:

ProjectDescription
Desktop Usage DisplayFront panel status display for the Framework Desktop
I2C/UART CardExpansion card with I2C and UART interfaces
Mouse Dongle Hiding CardRecessed USB-A port for hiding wireless dongles
Magnetic Charger CardMagSafe-style magnetic charging via expansion card

Footnotes

  1. OSHE Desktop Display Progress Update — Framework Community (OSHE_Framework, November 2025 – April 2026) 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

  2. OSHE I2C Card Project — Framework Community (OSHE_Framework, November 2025) 2

  3. OSHE Framework Mouse Dongle Hiding Card — Framework Community (OSHE_Framework, April 2026) 2

  4. FrameworkComputer/Framework-Desktop — GitHub (Framework Desktop documentation and CAD)