Ansible role: rpi_boot_config

Minimal role to manage config entries in a Raspberry Pi boot config. After changing the boot config, it will restart the Raspberry Pi and wait for it to come back.

Requirements

Nothing specific so far.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

boot_config_lines, optional

List of verbatim config lines to be put into /boot/config.txt (no assertions about uniqueness are made). Example:

boot_config_lines:
    - "gpu_mem=196"
    - "dtoverlay=pi3-disable-wifi"
    - "dtoverlay=pi3-disable-bt"

boot_config, optional

Dictionary where every key translates to a unique setting in /boot/config.txt. Example:

boot_config:
    gpu_mem: '196'

rpi_boot_config_file, optional

Path of the Raspberry Pi boot configuration file to manage, default: /boot/config.txt. Example:

rpi_boot_config_file: /boot/config.txt

rpi_boot_config_reboot, optional

Boolean to specify if a reboot should be performed if the config changes (default: true). /boot/config.txt. Example:

rpi_boot_config_reboot: false

Dependencies

None.

Example Playbook

- hosts: raspberrypis
  roles:
      - { role: rpi_boot_config, boot_config_lines: ['gpu_mem=196'] }

Changelog

4.4.0

• Add new role variable rpi_boot_config_reboot: bool
• Update molecule and CI testing

4.3.0

• drop support for ansible older than 5.0
• add test for Debian bullseye

4.2.0

• moved CI to GitHub Actions
• drop support for ansible 2.9, python3.7

4.1.0

• upgraded CI tests to use python3.7+
• upgraded molecule to version 3.x
• drop support for ansible 2.8
• add configurable path to boot config file

4.0.0

• renamed role to rpi_boot_config
• drop support for ansible 2.7

3.0.0

• use ansible reboot module
• drop support for ansible 2.5, 2.6

2.0.0

• drop support for python2
• add support for ansible 2.9
• add support for debian buster
• upgraded ansible-lint

1.1.1

• introduce semver release numbering
• expand tested OS to raspbian jessie, buster
• switch to molecule testing framework

1.1

• added new, optional variable boot_config_lines

1.0

• initial release

License

MIT / BSD

Author Information

This role was created in 2016 by Paul Kremer.