Skip to content

tlm-cli pms models firmwares

Commands for managing IoT firmware in the Product Management System (PMS).

tlm-cli pms models firmwares [COMMAND] [OPTIONS]

Each IoT model has at most one associated firmware. The firmware defines the target hardware architecture and tracks all versioned releases. To view firmware details, use tlm-cli pms models show MODEL_NAME — it displays the model and its firmware together.

create

Create a new IoT firmware and link it to an existing model.

tlm-cli pms models firmwares create NAME --model MODEL --architecture ARCH [OPTIONS]

Resolves the model by name to obtain its ID, then creates a firmware entity in the IoT layer. Each model can have at most one firmware.

Argument / Option Type Required Description
NAME string yes Firmware name.
--model TEXT / -m string yes Exact model name to link the firmware to.
--architecture TEXT / -a string yes Target hardware architecture (e.g. ARM, x86_64, x86).
--description TEXT / -d string no Firmware description.
--dry-run flag no Print the request payload without sending it.

Example

# Create a firmware linked to a model
tlm-cli pms models firmwares create "fw-sensor-x" --model "sensor-x" --architecture ARM

# With description
tlm-cli pms models firmwares create "fw-gateway" --model "gateway-v2" --architecture x86_64 \
  --description "Main gateway firmware"

# Preview
tlm-cli pms models firmwares create "fw-sensor-x" --model "sensor-x" --architecture ARM --dry-run

delete

Delete the firmware linked to a model.

tlm-cli pms models firmwares delete MODEL [OPTIONS]

Resolves the model by name, fetches its associated firmware, shows the details, then prompts for confirmation before deleting.

Argument / Option Type Required Description
MODEL string yes Exact model name whose firmware to delete.
--yes / -y flag no Skip the confirmation prompt.
--dry-run flag no Show resolved details without deleting.

Warning: Deleting a firmware is permanent and cannot be undone. Ensure the model has no active devices relying on firmware releases before proceeding.

Example

# Delete with confirmation prompt
tlm-cli pms models firmwares delete "sensor-x"

# Skip confirmation
tlm-cli pms models firmwares delete "sensor-x" --yes

# Preview what would be deleted
tlm-cli pms models firmwares delete "sensor-x" --dry-run