Skip to content

Extend NetworkInterface status with firmware version and other details #983

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
afritzler wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Extend NetworkInterface status with firmware version and other details #983

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8f3d400
Extend `NetworkInterface` status with firmware version and other details
afritzler Jul 3, 2026
a1cf8e2
Add additional NIC information
afritzler Jul 3, 2026
22d65d2
Add channel info
afritzler Jul 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
94 changes: 94 additions & 0 deletions api/v1alpha1/applyconfiguration/api/v1alpha1/networkinterface.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

33 changes: 33 additions & 0 deletions api/v1alpha1/applyconfiguration/internal/internal.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

36 changes: 36 additions & 0 deletions api/v1alpha1/server_types.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -329,6 +329,42 @@ type NetworkInterface struct {
// +optional
CarrierStatus string `json:"carrierStatus,omitempty"`

// PCIAddress is the PCI bus address of the underlying NIC (e.g. "0000:01:00.0").
// +optional
PCIAddress string `json:"pciAddress,omitempty"`

// Speed is the link speed reported by the NIC driver.
// +optional
Speed string `json:"speed,omitempty"`

// LinkModes is the list of link modes supported by the NIC.
// +optional
LinkModes []string `json:"linkModes,omitempty"`

// SupportedPorts is the list of port types supported by the NIC (e.g. TP, FIBRE).
// +optional
SupportedPorts []string `json:"supportedPorts,omitempty"`

// FirmwareVersion is the firmware version reported by the NIC driver.
// +optional
FirmwareVersion string `json:"firmwareVersion,omitempty"`

// NUMANode is the NUMA node ID as reported by the NIC driver.
// +optional
NUMANode int32 `json:"numaNode,omitempty"`

// Vendor is the PCI vendor ID (e.g. "0x8086") as reported by the NIC driver.
// +optional
Vendor string `json:"vendor,omitempty"`

// SubsystemVendor is the PCI subsystem vendor ID as reported by the NIC driver.
// +optional
SubsystemVendor string `json:"subsystemVendor,omitempty"`

// Device is the PCI device ID (e.g. "0x1533") as reported by the NIC driver.
// +optional
Device string `json:"device,omitempty"`

// Neighbors contains the LLDP neighbors discovered on this interface.
// +optional
Neighbors []LLDPNeighbor `json:"neighbors,omitempty"`
Expand Down
10 changes: 10 additions & 0 deletions api/v1alpha1/zz_generated.deepcopy.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

40 changes: 40 additions & 0 deletions config/crd/bases/metal.ironcore.dev_servers.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -377,6 +377,14 @@ spec:
description: CarrierStatus is the operational carrier status
of the network interface.
type: string
device:
description: Device is the PCI device ID (e.g. "0x1533") as
reported by the NIC driver.
type: string
firmwareVersion:
description: FirmwareVersion is the firmware version reported
by the NIC driver.
type: string
ip:
description: |-
IP is the IP address assigned to the network interface.
Expand All @@ -389,6 +397,12 @@ spec:
format: ip
type: string
type: array
linkModes:
description: LinkModes is the list of link modes supported by
the NIC.
items:
type: string
type: array
macAddress:
description: MACAddress is the MAC address of the network interface.
type: string
Expand Down Expand Up @@ -423,6 +437,32 @@ spec:
type: string
type: object
type: array
numaNode:
description: NUMANode is the NUMA node ID as reported by the
NIC driver.
format: int32
type: integer
pciAddress:
description: PCIAddress is the PCI bus address of the underlying
NIC (e.g. "0000:01:00.0").
type: string
speed:
description: Speed is the link speed reported by the NIC driver.
type: string
subsystemVendor:
description: SubsystemVendor is the PCI subsystem vendor ID
as reported by the NIC driver.
type: string
supportedPorts:
description: SupportedPorts is the list of port types supported
by the NIC (e.g. TP, FIBRE).
items:
type: string
type: array
vendor:
description: Vendor is the PCI vendor ID (e.g. "0x8086") as
reported by the NIC driver.
type: string
required:
- macAddress
- name
Expand Down
40 changes: 40 additions & 0 deletions dist/chart/templates/crd/metal.ironcore.dev_servers.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -383,6 +383,14 @@ spec:
description: CarrierStatus is the operational carrier status
of the network interface.
type: string
device:
description: Device is the PCI device ID (e.g. "0x1533") as
reported by the NIC driver.
type: string
firmwareVersion:
description: FirmwareVersion is the firmware version reported
by the NIC driver.
type: string
ip:
description: |-
IP is the IP address assigned to the network interface.
Expand All @@ -395,6 +403,12 @@ spec:
format: ip
type: string
type: array
linkModes:
description: LinkModes is the list of link modes supported by
the NIC.
items:
type: string
type: array
macAddress:
description: MACAddress is the MAC address of the network interface.
type: string
Expand Down Expand Up @@ -429,6 +443,32 @@ spec:
type: string
type: object
type: array
numaNode:
description: NUMANode is the NUMA node ID as reported by the
NIC driver.
format: int32
type: integer
pciAddress:
description: PCIAddress is the PCI bus address of the underlying
NIC (e.g. "0000:01:00.0").
type: string
speed:
description: Speed is the link speed reported by the NIC driver.
type: string
subsystemVendor:
description: SubsystemVendor is the PCI subsystem vendor ID
as reported by the NIC driver.
type: string
supportedPorts:
description: SupportedPorts is the list of port types supported
by the NIC (e.g. TP, FIBRE).
items:
type: string
type: array
vendor:
description: Vendor is the PCI vendor ID (e.g. "0x8086") as
reported by the NIC driver.
type: string
required:
- macAddress
- name
Expand Down
9 changes: 9 additions & 0 deletions docs/api-reference/api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1213,6 +1213,15 @@ _Appears in:_
| `ips` _[IP](#ip) array_ | IPs is a list of IP addresses (both IPv4 and IPv6) assigned to the network interface. | | Format: ip <br />Type: string <br /> |
| `macAddress` _string_ | MACAddress is the MAC address of the network interface. | | |
| `carrierStatus` _string_ | CarrierStatus is the operational carrier status of the network interface. | | |
| `pciAddress` _string_ | PCIAddress is the PCI bus address of the underlying NIC (e.g. "0000:01:00.0"). | | |
| `speed` _string_ | Speed is the link speed reported by the NIC driver. | | |
| `linkModes` _string array_ | LinkModes is the list of link modes supported by the NIC. | | |
| `supportedPorts` _string array_ | SupportedPorts is the list of port types supported by the NIC (e.g. TP, FIBRE). | | |
| `firmwareVersion` _string_ | FirmwareVersion is the firmware version reported by the NIC driver. | | |
| `numaNode` _integer_ | NUMANode is the NUMA node ID as reported by the NIC driver. | | |
| `vendor` _string_ | Vendor is the PCI vendor ID (e.g. "0x8086") as reported by the NIC driver. | | |
| `subsystemVendor` _string_ | SubsystemVendor is the PCI subsystem vendor ID as reported by the NIC driver. | | |
| `device` _string_ | Device is the PCI device ID (e.g. "0x1533") as reported by the NIC driver. | | |
| `neighbors` _[LLDPNeighbor](#lldpneighbor) array_ | Neighbors contains the LLDP neighbors discovered on this interface. | | |


Expand Down
4 changes: 4 additions & 0 deletions internal/api/registry/nic.go
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,8 @@ type NIC struct {
LinkModes []string `json:"linkModes"`
SupportedPorts []string `json:"supportedPorts"`
FirmwareVersion string `json:"firmwareVersion"`
NUMANode int `json:"numaNode"`
Vendor string `json:"vendor"`
SubsystemVendor string `json:"subsystemVendor"`
Device string `json:"device"`
}
Loading
Loading