Add 2.5GBASE-X SFP modular interface type #104

New Issue

MrUnknownDE · 2026-04-05T16:21:42+02:00

MrUnknownDE commented

2026-04-05 16:21:42 +02:00

Originally created by @emersonbpc on 3/22/2026

NetBox version

v4.5.4

Feature type

Data model extension

Proposed functionality

Add the following interface type to InterfaceTypeChoices under Ethernet (modular) / Pluggable transceivers:

Constant	Value	Display	Group
`TYPE_2GE_SFP`	`2.5gbase-x-sfp`	SFP (2.5GE)	Ethernet (modular)

This fills a gap in the current modular Ethernet type coverage. The schema currently has:

Speed	Fixed (copper)	Backplane	Modular (SFP)
100M	`100base-tx`	—	`100base-x-sfp`
1G	`1000base-t`	`1000base-kx`	`1000base-x-sfp`
2.5G	`2.5gbase-t`	`2.5gbase-kx`	missing
10G	`10gbase-t`	`10gbase-kr`	`10gbase-x-sfpp`

2.5G is the only speed tier where both fixed and backplane types exist but the SFP modular variant is absent — and where dedicated 2.5G SFP transceiver hardware exists at that speed.

Use case

Industrial Ethernet switches increasingly ship with dedicated 2.5G SFP uplink ports. Examples include:

EtherWAN EX78900G, EX71900G, and other G series (tri-rate 100M/1G/2.5G SFP uplinks)
Planet Technology IGS-6329-8UP2S2X (8x GbE PoE + 2x 2.5G SFP + 2x 10G SFP+)
UTEPO UTP7310S-PSD240-W (8x GbE PoE + 2x 2.5G SFP)
FS.com IES3110-8TF-R (8x GbE + 2x 2.5G SFP)

Dedicated 2.5G ports use standard SFP form factor slots and cannot be accurately represented by existing options:

1000base-x-sfp — understates the port capability
2.5gbase-t — wrong physical medium (copper, not SFP)
2.5gbase-kx — wrong physical medium (backplane, not SFP)
10gbase-x-sfpp — wrong speed, overstates the port capability

Database changes

Addition of one value to InterfaceTypeChoices in netbox/dcim/choices.py:

# Under the type constants, in the 2.5/5 Gbps Ethernet section:
TYPE_2GE_SFP = '2.5gbase-x-sfp'

# Under the CHOICES tuple, in the Ethernet (modular) group:
(TYPE_2GE_SFP, 'SFP (2.5GE)'),

### External dependencies

None.

*Originally created by @emersonbpc on 3/22/2026* ### NetBox version v4.5.4 ### Feature type Data model extension ### Proposed functionality Add the following interface type to `InterfaceTypeChoices` under **Ethernet (modular) / Pluggable transceivers**: | Constant | Value | Display | Group | |---|---|---|---| | `TYPE_2GE_SFP` | `2.5gbase-x-sfp` | SFP (2.5GE) | Ethernet (modular) | This fills a gap in the current modular Ethernet type coverage. The schema currently has: | Speed | Fixed (copper) | Backplane | Modular (SFP) | |---|---|---|---| | 100M | `100base-tx` | — | `100base-x-sfp` | | 1G | `1000base-t` | `1000base-kx` | `1000base-x-sfp` | | **2.5G** | **`2.5gbase-t`** | **`2.5gbase-kx`** | **missing** | | 10G | `10gbase-t` | `10gbase-kr` | `10gbase-x-sfpp` | 2.5G is the only speed tier where both fixed and backplane types exist but the SFP modular variant is absent — and where dedicated 2.5G SFP transceiver hardware exists at that speed. ### Use case Industrial Ethernet switches increasingly ship with dedicated 2.5G SFP uplink ports. Examples include: - EtherWAN EX78900G, EX71900G, and other G series (tri-rate 100M/1G/2.5G SFP uplinks) - Planet Technology IGS-6329-8UP2S2X (8x GbE PoE + 2x 2.5G SFP + 2x 10G SFP+) - UTEPO UTP7310S-PSD240-W (8x GbE PoE + 2x 2.5G SFP) - FS.com IES3110-8TF-R (8x GbE + 2x 2.5G SFP) Dedicated 2.5G ports use standard SFP form factor slots and cannot be accurately represented by existing options: - `1000base-x-sfp` — understates the port capability - `2.5gbase-t` — wrong physical medium (copper, not SFP) - `2.5gbase-kx` — wrong physical medium (backplane, not SFP) - `10gbase-x-sfpp` — wrong speed, overstates the port capability ### Database changes Addition of one value to `InterfaceTypeChoices` in `netbox/dcim/choices.py`: ```python # Under the type constants, in the 2.5/5 Gbps Ethernet section: TYPE_2GE_SFP = '2.5gbase-x-sfp' # Under the CHOICES tuple, in the Ethernet (modular) group: (TYPE_2GE_SFP, 'SFP (2.5GE)'), ### External dependencies None.

MrUnknownDE closed this issue

2026-04-05 16:21:42 +02:00

Sign in to join this conversation.

Branches Tags

main

21455-sql-indexes-audit

21357-register-model-actions

feature

20924-plugin-ui-components

21766-improve-test-coverage-for-sortable-table-columns

21157-export-template-public-models

21025-pre-render-config-contexts

21364-swagger

feature-ip-prefix-link

20911-dropdown-3

fix_module_substitution

21160-filterset

20911-dropdown-2

20044-elevation-stuck-lightmode

7604-filter-modifiers-v3

20660-script-load

19724-graphql

14884-script

19720-macaddress-interface-generic-relation

fix-19669-api-image-download

7604-filter-modifiers

19275-fixes-interface-bulk-edit

fix-17794-get_field_value_return_list

11507-show-aggregate-and-rir-on-api

9583-add_column_specific_search_field_to_tables

No Label complexity: low complexity: low complexity: low complexity: low complexity: low complexity: low netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox netbox status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted status: accepted type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature type: feature

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/netbox#104