ITU Channel Plans¶

netbox-wdm ships with three built-in channel grids. The grid is set on each WDM profile and propagated to every WdmNode created from that profile. The grid drives both the channel labels (e.g. C32, CWDM-1310) and the wavelength assigned to each grid position.

Grids supported¶

The constants are defined in netbox_wdm/wdm_constants.py. Wavelengths are computed from frequency for DWDM grids and held as a fixed list for CWDM.

How grid_position maps to a channel¶

The grid_position field on WdmChannelPlan and WdmChannel is a 1-based integer that indexes into the grid's channel list. The plugin uses get_channel_info(grid, position) to look up the matching (label, wavelength_nm) tuple.

grid_position also drives the rear_port_position value used in PortMappings. This is what lets multiple channels share a single COM rear port: each channel's PortMapping points at the same rear_port but carries a different rear_port_position. EXP and 1310 pass-through ports are positioned after the channel positions on the same COM rear port.

DWDM 100 GHz¶

44 channels starting from 192.10 THz, with 100 GHz spacing. Labels are C21 through C64 (the ITU C-band convention).

Wavelengths are computed as c / freq_thz and rounded to two decimal places using Decimal arithmetic so values are stable across processes.

DWDM 50 GHz¶

88 channels, 50 GHz spacing, labels alternate between C{n} and C{n}.5. Position 1 starts at 192.10 THz (label C21), position 2 is 192.15 THz (label C21.5), and so on through position 88.

CWDM¶

18 channels with a fixed 20 nm spacing.

Picking the grid for a profile¶

The grid you set on a profile should describe what the hardware actually is. The data sheet or front-panel labelling on the device tells you which of the three grids to pick:

• CWDM: front ports labelled by 20 nm wavelengths (typically 1270 through 1610). 18 fixed wavelengths, no temperature stabilisation.
• DWDM 100 GHz: ports labelled with ITU C-band channel numbers (C21 through C64) on a 100 GHz spacing.
• DWDM 50 GHz: 88 wavelengths on a 50 GHz spacing, with labels alternating C{n} and C{n}.5. Common on newer coherent line systems.

If the device does not fit any of these, the bundled grids cannot represent it; see Adding a new grid below.

The grid is locked once channel plans exist. Changing it later requires clearing the channel plans first or creating a new profile. In practice this only comes up when a profile was set up with the wrong grid by mistake -- the device's grid itself does not change.

Adding a new grid¶

The grid list is hard-coded in wdm_constants.py and the WdmGridChoices ChoiceSet. To add another (for example L-band 100 GHz), extend both: append the grid to WDM_GRIDS, add a key to WdmGridChoices, and update the migrations if you keep CHOICES literals in models.py. There is no runtime customisation hook for grids today.