IOCrest (Aquantia) USB4 10G NIC: how do I get this working?

[starkruzr]

It's this one: https://www.amazon.com/dp/B0DHSWSSBY?

A lot of searches I've done imply that the "atlantic.ko" driver is not by default in the Proxmox kernel. Does anyone know how to get one of these NICs installed and running correctly?

 

[homma_classact]

I’m using that NIC myself.
It works under certain conditions, though there are some issues.

• Kernel version: 6.8.4-2-pve
• ASPM disabled:
  Edit /etc/default/grub and set
  

  GRUB_CMDLINE_LINUX_DEFAULT="quiet pcie_aspm=off"

  Then run update-grub and reboot.

It was recognized even without disabling ASPM, but in that case it became very unstable. When pushing a lot of traffic, I saw tons of logs like:
PCIe Bus Error: severity=Uncorrectable (Fatal), type=Transaction Layer, (Receiver ID)

Eventually the NIC stopped being recognized.

Once you get it working on 6.8.4-2-pve, it may also run fine on later 6.8.x kernels. However, I couldn’t get it stable on the 6.14 series.

I recommend installing 6.8.4-2-pve explicitly, then pinning it with:

proxmox-boot-tool kernel pin 6.8.4-2-pve

and rebooting.

By the way, with the ORICO Thunderbolt 3 10GbE, it worked fine on `6.14.11-1-pve` with the default ASPM settings.

Hope this helps!

 

[starkruzr]

it got me part of the way there, but https://www.reddit.com/r/Proxmox/comments/1azwc2l/thunderbolt_drivers_for_proxmox_8_linux_65118/ it seems like a lot of things are missing? installing thunderbolt-utils only got me one executable instead of the whole suite of tools.

 

[homma_classact]

If you already have the correct kernel version and ASPM settings applied, try the following:

# apt install bolt

Then use `boltctl list` to verify that the device is recognized. For example:

# boltctl list
 ○ IOCREST 40Gbps
   ├─ type:          peripheral
   ├─ name:          40Gbps
   ├─ vendor:        IOCREST
   ├─ uuid:          d0010000-0091-9f08-2230-ad1c70e42923
   ├─ generation:    Thunderbolt 3
   ├─ status:        disconnected
   ├─ authorized:    Tue 02 Sep 2025 12:36:22 PM UTC
   ├─ connected:     Tue 02 Sep 2025 12:36:22 PM UTC
   └─ stored:        Tue 02 Sep 2025 12:35:10 PM UTC
      ├─ policy:     auto
      └─ key:        no

This should give you the full `bolt` toolset and allow you to confirm the Thunderbolt device is being detected and authorized properly.

 

[starkruzr]

If you already have the correct kernel version and ASPM settings applied, try the following:

# apt install bolt

Then use `boltctl list` to verify that the device is recognized. For example:

# boltctl list
 ○ IOCREST 40Gbps
   ├─ type:          peripheral
   ├─ name:          40Gbps
   ├─ vendor:        IOCREST
   ├─ uuid:          d0010000-0091-9f08-2230-ad1c70e42923
   ├─ generation:    Thunderbolt 3
   ├─ status:        disconnected
   ├─ authorized:    Tue 02 Sep 2025 12:36:22 PM UTC
   ├─ connected:     Tue 02 Sep 2025 12:36:22 PM UTC
   └─ stored:        Tue 02 Sep 2025 12:35:10 PM UTC
      ├─ policy:     auto
      └─ key:        no

This should give you the full `bolt` toolset and allow you to confirm the Thunderbolt device is being detected and authorized properly.

thanks. just want you to know that this was a PEBCAK situation. this machine doesn't actually have USB4, it just looks like it does. ‍