Work with Fleet Devices¶

How to list, inspect, claim, and bulk-claim devices in the Fleet Manager.

A device must be provisioned in PMS before it can be claimed. Claiming transfers the device from the manufacturing system into the operational fleet where it can be monitored.

List fleet devices¶

tlm-cli fm devices list

Navigate with Enter (next page), D (toggle detail view), Esc / Q (quit). The detail view adds FW Version and Last Seen columns.

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

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

Filter by name (fuzzy match):

tlm-cli fm devices list --name "Gateway"

Inspect a fleet device¶

tlm-cli fm devices show SN-001234

Displays: Serial Number, Name, Status, FW Version, and Last Seen.

Claim a single device¶

tlm-cli fm devices claim SN-001234

Assign a friendly name at claim time:

tlm-cli fm devices claim SN-001234 --name "Gateway-001234"

If the device is already claimed the command exits with an error.

Bulk-claim all unclaimed PMS devices¶

The claim-bulk command computes the difference between all serial numbers in PMS and those already in the Fleet Manager, then claims the missing ones.

Preview what would be claimed (no changes made):

tlm-cli fm devices claim-bulk --dry-run

Claim with the confirmation prompt:

tlm-cli fm devices claim-bulk

Skip the confirmation prompt (useful in CI/automation):

tlm-cli fm devices claim-bulk --yes

The summary table reports ok (green), dry-run (dim), or error: ... for each device.