eeprog(8)

📦
version 4.4 · 2 versions
, in arch rolling, fedora 43, fedora 44

💖 eeprog(8) — the girlies' guide to poking at EEPROMs 💖

okay so real talk: eeprog is a System Administration manual page, and it's the one you want when you need to read and write 24Cxx EEPROMs connected to the I2C serial bus. She's small, she's mighty, she's giving hardware whisperer. Let's get into it bestie 🫶

✨ SYNOPSIS ✨

eeprog [-fqxdh] [-16|-8] [-r addr[:count]|-w addr] <device> <i2c-addr>

that's the whole vibe in one line, no cap 💅

🌸 DESCRIPTION 🌸

eeprog uses the SMBus protocol — which is lowkey the protocol most of the recent chipsets are running on. That's the tea. 🍓

🎀 NOTE 🎀

Don't forget to load your i2c chipset and the i2c-dev drivers. fr fr, if you skip this step nothing works and you'll be sitting there like 😭.

Also!! these environment variables can be set instead of the command line arguments:

  • EEPROG_DEV — stands in for device
  • EEPROG_I2C_ADDR — stands in for i2c-addr

👑 PARAMETERS 👑

🦋 Address modes 🦋

  • -8 — use 8bit address mode for 24c0x...24C16. this is the [default] btw, so if you say nothing she picks this one 💫
  • -16 — use 16bit address mode for 24c32...24C256

💅 Actions 💅

  • -r addr[:count] — read count bytes (1 if you omit it) starting from addr, and print them to the standard output
  • -w addr — write whatever's coming in on stdin to address addr of the EEPROM
  • -h — print this help. the classic "bestie explain" button 🫶

⭐ Options ⭐

  • -x — set hex output mode
  • -d — Dummy mode: display what would have been done. it's the rehearsal, not the performance ✨
  • -f — disable warnings and don't ask confirmation. she just goes. no questions asked 💀
  • -q — quiet mode 🤫

🌈 Bus 🌈

  • device — the device file representing the I2C bus (eg. /dev/i2c-0)
  • i2c-addr — the I2C bus address of the EEPROM (eg. 0x3A)

🧚 EXAMPLES 🧚

Read 64 bytes from the EEPROM at address 0x54 on bus 0 starting at address 123 (decimal)

eeprog /dev/i2c-0 0x54 -r 123:64

Print the hex codes of the first 32 bytes read from bus 1 at address 0x22

eeprog /dev/i2c-1 0x51 -x -r 0x22:0x20

Write the current timestamp at address 0x200 of the EEPROM on bus 0 at address 0x33

date | eeprog -f /dev/i2c-0 0x33 -w 0x200

see how the pipe just hands her the timestamp? iconic behaviour, she ate that 🍽️

💜 AUTHOR 💜

Stefano Barbato — the mastermind, the moment, the main character 👑

and that's the whole page bestie!! this one ships with i2c-tools, dated Jul 2013, and lives at section 8 of the manual. slay, go read some EEPROMs 💖✨🎀

📦 where this page comes from