Expansion Modules¶

The catalog includes 151 expansion modules (WICs, HWICs, NIMs, NMs, SFPs, wireless/cellular adapters, …). Use pt_list_modules to discover exact names — optionally filtered by router_model or category — then pt_add_module (one) or pt_install_modules_batch (many).

Critical rules¶

slot is a STRING, not an integer

PT compares the slot with === against its internal map. Passing 0 (int) does not match "0/0" and addModule() silently returns false. Always use a string literal.

Slot type	Format	Example
HWIC on 1941 / 2901 / 2911	`"0/0"`, `"0/1"`, `"0/2"`, `"0/3"`	`pt_add_module("R1", "0/0", "HWIC-2T")`
NIM on ISR4321 / ISR4331	`"0"`, `"1"`	`pt_add_module("R1", "0", "NIM-2T")`
Cloud / hosts	`"0"`, `"1"`, … `"7"`	`pt_add_module("Cloud", "0", "PT-CLOUD-NM-1S")`

Compatibility¶

2911 / 2901 / 1941 (ISR G2) → HWIC/WIC only (no NM). For 4 serial ports, install 2× HWIC-2T in slots "0/0" and "0/1".
ISR4321 / ISR4331 → NIM only (NIM-2T for serial, NIM-ES2-4 for GigE).
Router-PT → PT-ROUTER-NM-* in slots "0".."6".

Port naming¶

Ports are named <type><chassis>/<subslot>/<port>:

HWIC-2T in slot "0/0" → Serial0/0/0, Serial0/0/1
HWIC-2T in slot "0/1" → Serial0/1/0, Serial0/1/1

Installing several at once¶

Prefer pt_install_modules_batch

It powers off → adds all modules → powers on in one runCode. Multiple individual pt_add_module calls each power-cycle the device, which is slower and can make a single call report a (false) timeout while the reboot finishes.

pt_install_modules_batch([
  {"device": "R1", "slot": "0/0", "module": "HWIC-2T"},
  {"device": "R1", "slot": "0/1", "module": "HWIC-2T"}
])
# → Serial0/0/0, 0/0/1, 0/1/0, 0/1/1