arillso.system.thermal role – Manage thermal and sensor monitoring on Linux systems

Note

This role is part of the arillso.system collection (version 1.0.5).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install arillso.system.

To use it in a playbook, specify: arillso.system.thermal.

Entry point main – Manage thermal and sensor monitoring on Linux systems

Synopsis

  • Installs and configures thermal management tools including thermald, lm-sensors, and fancontrol

  • Manages temperature thresholds and thermal zones for CPU and ACPI

  • Configures thermal preferences for performance, quiet, or balanced operation

  • arillso

Parameters

Parameter

Comments

thermal_acpitz_active_temp

integer

ACPI thermal zone active cooling threshold in millidegrees Celsius (e.g., 80000 = 80°C)

Default: 80000

thermal_acpitz_passive_temp

integer

ACPI thermal zone passive cooling threshold in millidegrees Celsius (e.g., 70000 = 70°C)

Default: 70000

thermal_active_sampling_period

integer

ACPI active sampling period in seconds

Default: 8

thermal_cpu_active_sampling_period

integer

CPU active sampling period in seconds

Default: 6

thermal_cpu_active_temp

integer

CPU package active cooling threshold in millidegrees Celsius (e.g., 85000 = 85°C)

Default: 85000

thermal_cpu_passive_sampling_period

integer

CPU passive sampling period in seconds

Default: 10

thermal_cpu_passive_temp

integer

CPU package passive cooling threshold in millidegrees Celsius (e.g., 75000 = 75°C)

Default: 75000

thermal_enable_acpitz

boolean

Enable ACPI thermal zone monitoring

Choices:

  • false

  • true ← (default)

thermal_enable_cpu_temp

boolean

Enable CPU temperature monitoring

Choices:

  • false

  • true ← (default)

thermal_enabled

boolean

Enable or disable thermal management configuration

Choices:

  • false

  • true ← (default)

thermal_packages

list / elements=string

List of thermal management packages to install

Default: ["lm-sensors", "fancontrol", "thermald"]

thermal_passive_sampling_period

integer

ACPI passive sampling period in seconds

Default: 12

thermal_platform_name

string

Platform name for thermal configuration (auto-detected if not set)

Default: "{{ ansible_product_name | default('Generic') }}"

thermal_preference

string

Thermal management preference mode

Choices:

  • "QUIET" ← (default)

  • "PERFORMANCE"

  • "BALANCED"

thermal_run_sensors_detect

boolean

Run sensors-detect automatically to detect hardware sensors

Choices:

  • false ← (default)

  • true