Manage Models¶

How to list and inspect IoT models, including their associated firmware and release history.

A model defines the firmware profile for a class of devices. Models are used when assigning firmware configurations to parts (tlm-cli pms parts set-model) and devices (tlm-cli pms devices set-model).

List models¶

tlm-cli pms models list

Returns the first 25 models sorted by name.

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

tlm-cli pms models list --name "gateway"

Filter by tag (exact match):

tlm-cli pms models list --tag "v2"

Filter by customer code:

tlm-cli pms models list --customer ACME

Combine filters:

tlm-cli pms models list --name "sensor" --customer ACME

Filtered results return up to 100 matches.

Inspect a model¶

tlm-cli pms models show "gateway-v2"

Output includes:

Model details: Name, Description, Tags, Customers
Firmware details: Architecture, Active Release, Description
Releases table: Version, Mandatory, Active (marked with ✓)

Find a model name to use in other commands¶

set-model (for parts and devices) requires an exact model name. Use list to find it:

tlm-cli pms models list --name "gateway"

Then use the exact name returned:

tlm-cli pms parts set-model PART-XYZ-001 --model "gateway-v2"
tlm-cli pms devices set-model SN-001234 --model "gateway-v2"