ALTERA_ATSE(4)

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

💖 ALTERA_ATSE 💖 — the atse driver, bestie edition

okay so this is the manual page for atse from the Kernel Interfaces Manual, and yes it's a whole vibe, let's get into it 🦋

✨ NAME ✨

atse — the driver for the Altera Triple-Speed Ethernet MegaCore 💅

🌸 SYNOPSIS 🌸

device atse
options ATSE_CFI_HACK

and then in /boot/device.hints you're gonna have all of this, no cap:

hint.atse.0.at="nexus0"
hint.atse.0.maddr=0x7f007000
hint.atse.0.msize=0x540
hint.atse.0.rc_irq=1
hint.atse.0.rx_maddr=0x7f007500
hint.atse.0.rx_msize=0x8
hint.atse.0.rxc_maddr=0x7f007520
hint.atse.0.rxc_msize=0x20
hint.atse.0.tx_irq=2
hint.atse.0.tx_maddr=0x7f007400
hint.atse.0.tx_msize=0x8
hint.atse.0.txc_maddr=0x7f007420
hint.atse.0.txc_msize=0x20
hint.e1000phy.0.at="miibus0"
hint.e1000phy.0.phyno=0

like… look at all those hints. she's thorough. we love a thorough queen 👑

🎀 DESCRIPTION 🎀

The atse device driver provides support for the Altera Triple-Speed Ethernet MegaCore. that's it, that's the whole job, and she does it 💖

👑 HARDWARE 👑

The current version of the atse driver supports the Ethernet MegaCore as described in version 11.1 of Altera's documentation when the device is configured with internal FIFOs. iykyk — if it's not set up with internal FIFOs, this is not your girl 🙈

🌈 MAC SELECTION 🌈

The default MAC address for each atse interface is derived from a value stored in cfi(4) flash. that value is managed by the atsectl(8) utility — she's the one holding the keys 🔑

Only a single MAC address may be stored in flash. so here's the tea:

  • if the address begins with the Altera prefix 00:07:ed and ends in 00, then up to 16 addresses will be derived from it by adding the unit number of the interface to the stored address ✨
  • for other prefixes, the address will be assigned to atse0 and random addresses will be used for other interfaces 🎲
  • if the stored address is invalid — for example all zero's, multicast, or the default address shipped on all DE4 boards (00:07:ed:ff:ed:15) — then a random address is generated when the device is attached 🫶

🦋 SEE ALSO 🦋

also, the Triple-Speed Ethernet MegaCore Function User Guide, Altera Corporation, November 2011 📚

💜 HISTORY 💜

The atse device driver first appeared in FreeBSD 10.0. a classic, an icon, a legend ⭐

🌸 AUTHORS 🌸

The atse device driver and this manual page were developed by SRI International and the University of Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237) ("CTSRD"), as part of the DARPA CRASH research programme. This device driver was written by Bjoern A. Zeeb. absolute main character energy, we stan 🫶👑

💀 BUGS 💀

okay bestie, listen up, these are real:
  • The atse driver only supports a single configuration of the MegaCore as installed on the Terasic Technologies Altera DE4 Development and Education Board. one board. that's the whole range 🎯
  • Only gigabit Ethernet speeds are currently supported. no 10/100 crumbs for you, it's gigabit or nothing 💅

and that's the page, fr fr 🌈 this one came from the Debian build, dated May 21, 2014 — so yeah, she's been serving since way back, and she still ate 💖✨🎀

📦 where this page comes from