GLXIIC(4)

📦 version 12.2, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GLXIIC(4) 💖

okay bestie, buckle up — this is the glxiic page from the i386 Kernel Interfaces Manual, and it's literally the manual for the Geode LX CS5536 I2C controller driver. yes the title is all shouty caps, that's just how manpages are, they have main character energy 💅

✨ NAME ✨

glxiic — the Geode LX CS5536 I2C controller driver. that's it, that's the whole name section 🎀

🌸 SYNOPSIS 🌸

so you wanna get this driver into your kernel? bet. drop these lines into your kernel configuration file:

device pci
device isa
device glxiic
device iicbus

orrrr if you'd rather load it as a module at boot time (which, lowkey iconic), put this line in loader.conf(5):

glxiic_load="YES"

🦋 DESCRIPTION 🦋

okay so. the glxiic driver supports the System Management Bus controller of the Geode LX series CS5536 Companion Device. and the Geode LX? it's a member of the AMD Geode family of integrated x86 system chips. yes that's a lot of capital letters, no I did not make them up ✨

now here's the tea 🍵 — AMD calls this thing a System Management Bus (SMBus) controller, but fr fr it's really an I2C controller. it lacks SMBus ALERT# and Alert Response support, so the SMBus label is giving... a little bit of a stretch, iykyk 😭

and the glxiic driver? it supports both I2C master and slave mode. versatile queen 👑

⭐ SYSCTL VARIABLE ⭐

the glxiic driver supports this one variable as both a sysctl(8) and a loader(8) tunable:

  • dev.glxiic.0.timeout — this controls the I2C bus timeout in milliseconds. the default timeout is 35 milliseconds. and a value of zero disables the timeout entirely. (yes, zero = no timeout, no cap 🫶)

💀 CAVEAT 💀

okay this part matters, pay attention bestie.

by default, the glxiic driver uses the interrupt line number configured by the board firmware. but if the board firmware didn't configure one (or if you wanna override whatever it configured), put this line in device.hints(5):

hint.glxiic.0.irq="10"
⚠️ the interrupt line number must be between 1 and 15. like, must must. don't try anything cute outside that range 🙈

🌈 SEE ALSO 🌈

go read them, they're all part of the friend group 💜

👑 HISTORY 👑

the glxiic device driver and manual page first appeared in FreeBSD 9.0. vintage. iconic. a moment 🌟

🎀 AUTHORS 🎀

the glxiic device driver and manual page were written by Henrik Brix Andersen <brix@FreeBSD.org>. thank you for your service, king 🫡💖

and that's the whole page bestie!! this lil number comes from the Debian build of the manual, dated May 15, 2011 — so like, it's older than most of our entire personalities, but it still slays 💅✨🦋🌸

📦 where this page comes from