{"id":4954,"date":"2026-09-06T01:37:50","date_gmt":"2026-09-06T04:37:50","guid":{"rendered":"https:\/\/tucumandevelopers.com\/index.php\/2026\/09\/06\/openbsd-stories-strange-medieval-devices\/"},"modified":"2026-09-06T01:37:50","modified_gmt":"2026-09-06T04:37:50","slug":"openbsd-stories-strange-medieval-devices","status":"publish","type":"post","link":"https:\/\/tucumandevelopers.com\/index.php\/2026\/09\/06\/openbsd-stories-strange-medieval-devices\/","title":{"rendered":"OpenBSD Stories: Strange Medieval Devices"},"content":{"rendered":"
\n
<\/div>\n
\n

<\/a> The Problem & Industry Shift <\/h3>\n

The OpenBSD project is renowned for its security focus, but its hardware support philosophy is equally distinctive: it actively supports a vast array of obscure and obsolete devices, some of which feel like relics from a medieval technological era. While mainstream OSes drop support for legacy hardware to reduce maintenance costs, OpenBSD’s driver architecture and coding standards allow it to keep these strange devices functional. This article explores the engineering behind OpenBSD’s support for such devices, the challenges involved, and the trade-offs the project makes to preserve this unique capability.<\/p>\n

In an industry that pushes rapid hardware obsolescence, OpenBSD’s approach is a contrarian shift. The project’s commitment to “portability” isn’t just about running on many platforms; it’s about ensuring that even the strangest hardware\u2014like ancient SCSI controllers or obscure network cards\u2014can be used reliably. This is achieved through a clean abstraction layer, rigorous code review, and a driver model that separates bus handling from device logic.<\/p>\n

<\/a> Architecture & Core Mechanics <\/h3>\n

OpenBSD’s device driver framework is built on a layered architecture that decouples hardware discovery from device operation. The core is the bus_space<\/code> and bus_dma<\/code> APIs, which abstract memory-mapped I\/O and DMA operations across different bus types (PCI, ISA, etc.). This allows a single driver to work on multiple platforms without modification.<\/p>\n

For example, consider a hypothetical driver for a “medieval” device\u2014say, a 1980s-era SCSI controller. The driver registers itself with the system via a cfattach<\/code> structure, which defines the match and attach functions. During autoconfiguration, the kernel walks the device tree, calling match functions to determine if a device is present. Once matched, the attach function initializes the device and registers it with the appropriate subsystem.<\/p>\n

Below is a simplified ASCII diagram of the autoconfiguration process: <\/p>\n

\n
+----------------+ +----------------+ +----------------+ | mainbus | --> | pci* | --> | scsi* | | (root bus) | | (PCI bus) | | (SCSI bus) | +----------------+ +----------------+ +----------------+ | | | | match\/attach | match\/attach | match\/attach v v v +---------+ +---------+ +---------+ | device | | device | | device | +---------+ +---------+ +---------+ <\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
Each bus driver iterates over its children, calling their match<\/code> functions. If a match returns success, the attach<\/code> function is invoked. This recursive process builds a device tree that reflects the physical topology.<\/p>\n
For strange devices, the match function often relies on device IDs or even probing heuristics. For instance, some legacy devices lack proper PCI configuration registers, so drivers must perform risky I\/O probes. OpenBSD mitigates this by requiring careful probe routines that avoid system crashes.<\/p>\n
  <\/a> Production Code Example <\/h3>\n
Let’s look at a simplified driver skeleton for a fictional “medieval” device\u2014a 16-bit ISA sound card with a proprietary interface. The code below demonstrates key engineering decisions: using bus_space for I\/O, handling interrupts, and implementing a minimal match<\/code> function. <\/p>\n
\n
\/* * Example driver for a fictional medieval ISA device. * This is not a real driver but illustrates OpenBSD driver patterns. *\/<\/span> #include<\/span> <sys\/param.h><\/span> #include<\/span> <sys\/systm.h><\/span> #include<\/span> <sys\/device.h><\/span> #include<\/span> <sys\/bus.h><\/span> <\/span> struct<\/span> medieval_softc<\/span> {<\/span> struct<\/span> device<\/span> sc_dev<\/span>;<\/span> bus_space_tag_t<\/span> sc_iot<\/span>;<\/span> \/* I\/O space tag *\/<\/span> bus_space_handle_t<\/span> sc_ioh<\/span>;<\/span> \/* I\/O space handle *\/<\/span> int<\/span> sc_irq<\/span>;<\/span> \/* IRQ number *\/<\/span> };<\/span> int<\/span> medieval_match<\/span>(<\/span>struct<\/span> device<\/span> *<\/span>,<\/span> struct<\/span> cfdata<\/span> *<\/span>,<\/span> void<\/span> *<\/span>);<\/span> void<\/span> medieval_attach<\/span>(<\/span>struct<\/span> device<\/span> *<\/span>,<\/span> struct<\/span> device<\/span> *<\/span>,<\/span> void<\/span> *<\/span>);<\/span> struct<\/span> cfattach<\/span> medieval_ca<\/span> =<\/span> {<\/span> sizeof<\/span>(<\/span>struct<\/span> medieval_softc<\/span>),<\/span> medieval_match<\/span>,<\/span> medieval_attach<\/span> };<\/span> struct<\/span> cfdriver<\/span> medieval_cd<\/span> =<\/span> {<\/span> NULL<\/span>,<\/span> \"medieval\"<\/span>,<\/span> DV_DULL<\/span> };<\/span> \/* * Match function: check if the device is present at the given ISA I\/O port. * We use bus_space_map to probe the port and read a signature. *\/<\/span> int<\/span> medieval_match<\/span>(<\/span>struct<\/span> device<\/span> *<\/span>parent<\/span>,<\/span> struct<\/span> cfdata<\/span> *<\/span>cf<\/span>,<\/span> void<\/span> *<\/span>aux<\/span>)<\/span> {<\/span> struct<\/span> isa_attach_args<\/span> *<\/span>ia<\/span> =<\/span> aux<\/span>;<\/span> bus_space_tag_t<\/span> iot<\/span> =<\/span> ia<\/span>-><\/span>ia_iot<\/span>;<\/span> bus_space_handle_t<\/span> ioh<\/span>;<\/span> int<\/span> rv<\/span> =<\/span> 0<\/span>;<\/span> \/* Map the I\/O port range (e.g., 0x300-0x307) *\/<\/span> if<\/span> (<\/span>bus_space_map<\/span>(<\/span>iot<\/span>,<\/span> 0x300<\/span>,<\/span> 8<\/span>,<\/span> 0<\/span>,<\/span> &<\/span>ioh<\/span>)<\/span> !=<\/span> 0<\/span>)<\/span> return<\/span> 0<\/span>;<\/span> \/* Read a signature register; if it matches, the device is present *\/<\/span> if<\/span> (<\/span>bus_space_read_1<\/span>(<\/span>iot<\/span>,<\/span> ioh<\/span>,<\/span> 0<\/span>)<\/span> ==<\/span> 0x5A<\/span>)<\/span> rv<\/span> =<\/span> 1<\/span>;<\/span> bus_space_unmap<\/span>(<\/span>iot<\/span>,<\/span> ioh<\/span>,<\/span> 8<\/span>);<\/span> return<\/span> rv<\/span>;<\/span> }<\/span> void<\/span> medieval_attach<\/span>(<\/span>struct<\/span> device<\/span> *<\/span>parent<\/span>,<\/span> struct<\/span> device<\/span> *<\/span>self<\/span>,<\/span> void<\/span> *<\/span>aux<\/span>)<\/span> {<\/span> struct<\/span> medieval_softc<\/span> *<\/span>sc<\/span> =<\/span> (<\/span>struct<\/span> medieval_softc<\/span> *<\/span>)<\/span>self<\/span>;<\/span> struct<\/span> isa_attach_args<\/span> *<\/span>ia<\/span> =<\/span> aux<\/span>;<\/span> \/* Save bus tag and map I\/O space for the device *\/<\/span> sc<\/span>-><\/span>sc_iot<\/span> =<\/span> ia<\/span>-><\/span>ia_iot<\/span>;<\/span> if<\/span> (<\/span>bus_space_map<\/span>(<\/span>sc<\/span>-><\/span>sc_iot<\/span>,<\/span> 0x300<\/span>,<\/span> 8<\/span>,<\/span> 0<\/span>,<\/span> &<\/span>sc<\/span>-><\/span>sc_ioh<\/span>)<\/span> !=<\/span> 0<\/span>)<\/span> {<\/span> printf<\/span>(<\/span>\"medieval: can't map I\/O space<\/span>\\n<\/span>\"<\/span>);<\/span> return<\/span>;<\/span> }<\/span> \/* Set up interrupt *\/<\/span> sc<\/span>-><\/span>sc_irq<\/span> =<\/span> ia<\/span>-><\/span>ia_irq<\/span>;<\/span> if<\/span> (<\/span>sc<\/span>-><\/span>sc_irq<\/span> !=<\/span> -<\/span>1<\/span>)<\/span> {<\/span> isa_intr_establish<\/span>(<\/span>ia<\/span>-><\/span>ia_ic<\/span>,<\/span> sc<\/span>-><\/span>sc_irq<\/span>,<\/span> IST_EDGE<\/span>,<\/span> IPL_BIO<\/span>,<\/span> medieval_intr<\/span>,<\/span> sc<\/span>,<\/span> sc<\/span>-><\/span>sc_dev<\/span>.<\/span>dv_xname<\/span>);<\/span> }<\/span> printf<\/span>(<\/span>\"medieval: found strange device at 0x300<\/span>\\n<\/span>\"<\/span>);<\/span> }<\/span> int<\/span> medieval_intr<\/span>(<\/span>void<\/span> *<\/span>arg<\/span>)<\/span> {<\/span> struct<\/span> medieval_softc<\/span> *<\/span>sc<\/span> =<\/span> arg<\/span>;<\/span> \/* Handle interrupt: read status, clear, etc. *\/<\/span> return<\/span> 1<\/span>;<\/span> \/* handled *\/<\/span> }<\/span> <\/code><\/pre>\n
\n<\/p><\/div>\n<\/p><\/div>\n
Critical engineering decisions:<\/strong><\/p>\n