Work with PMS Devices¶

How to list, inspect, and update manufacturing devices in the Product Management System.

List devices¶

tlm-cli pms devices list

Navigate with Enter (next page), D (toggle detail view), Esc / Q (quit).

Filter by serial number (fuzzy match — partial values are accepted):

tlm-cli pms devices list --serial "SN-001"

Filter by part number (exact match):

tlm-cli pms devices list --part "PART-XYZ"

Inspect a device¶

tlm-cli pms devices show SN-001234

Press D to expand the view with Batch ID, Production Date, Production Data JSON, and the last 10 public and internal events.

List sub-devices¶

Some devices are composed of sub-devices (e.g. a gateway with attached modules):

tlm-cli pms devices subdevices SN-001234

Assign a model to a single device¶

tlm-cli pms devices set-model SN-001234 --model "gateway-v2"

Preview the change:

tlm-cli pms devices set-model SN-001234 --model "gateway-v2" --dry-run

Use tlm-cli pms models list to find available model names.

Assign a model to all devices in a batch¶

This updates every device in a batch that matches a given part number. The batch ID is a positional argument; --part and --model are required options:

# Preview
tlm-cli pms devices set-model-batch B2024-01 --part "PART-XYZ" --model "gateway-v2" --dry-run

# Apply (with confirmation prompt)
tlm-cli pms devices set-model-batch B2024-01 --part "PART-XYZ" --model "gateway-v2"

# Apply without prompt (useful in scripts)
tlm-cli pms devices set-model-batch B2024-01 --part "PART-XYZ" --model "gateway-v2" --yes

The summary table reports ok (green) or error: ... for each device.