Skip to content

Port definition notation

Port definition notation is used to specify the ports available on a network switch, including their types, capabilities, and ranges.

For various common switch models, predefined port specifications are available. Such presets are applied automatically when selecting a "known" model in the hardware model field. Users can also define custom port specifications using the notation described below.

Basic syntax

  • Tags in square brackets [] that specify port attributes (optional)
  • Port identifiers any identifier that ends in a number, though it is recommended to follow standard networking conventions (e.g., Gi1/0/1, Fa0/1)
  • Ranges using hyphens (e.g., Gi1/0/1-24, port1-12)
  • Separators using commas , to separate different segments

Tags

Tags modify the default port attributes. Available tags are defined in the port specification configuration:

Tag Description Effect
P0 No PoE Sets maximum PoE output to 0 watts
P1 PoE output: 15.4w Sets maximum PoE output to 15.4 watts
P2 PoE output: 30w Sets maximum PoE output to 30 watts (default)
P3 PoE output: 60w Sets maximum PoE output to 60 watts
P4 PoE output: 90w Sets maximum PoE output to 90 watts
ND Non-device port Marks port as non-device (e.g. switch-to-switch connections)
TC Copper Sets port type to copper (default)
TF Fiber Sets port type to fiber, also sets PoE output to 0 watts

Examples

Simple port range

Gi1/0/1-24
Defines 24 ports from Gi1/0/1 to Gi1/0/24 with default attributes (device ports, copper, 30W PoE).

Mixed port types

[P2] Gi1/0/1-24, [ND] Gi1/1/1-4
Defines 24 device ports with 30W PoE capability (Gi1/0/1 to Gi1/0/24) and 4 non-device ports (Gi1/1/1 to Gi1/1/4) for network topology connections.

Range using custom identifier notation

ii1-12, ii20-24
Defines ports ii1 to ii12 and ii20 to ii24.

Different PoE ratings

[P3] Gi1/0/1-12, [P1] Gi1/0/13-24
Defines 12 ports with 60W PoE capability and 12 ports with 15.4W PoE capability.

[P0] Gi1/0/1-48, [TF][ND] Te1/0/1-4
Defines 48 copper device ports with no PoE and 4 fiber non-device ports for high-speed uplinks.

Default behavior

When no tags are specified, ports default to: - Device ports (suitable for connecting 'regular' devices) - Copper type - 30 watts maximum PoE output