An open API service indexing awesome lists of open source software.

https://github.com/infothrill/ansible-role-rpi_boot_config

Configure raspberry pi /boot/config.txt
https://github.com/infothrill/ansible-role-rpi_boot_config

ansible ansible-role raspberry-pi

Last synced: 4 months ago
JSON representation

Configure raspberry pi /boot/config.txt

Awesome Lists containing this project

README

          

# Ansible role: rpi_boot_config

![Build status](https://github.com/infothrill/ansible-role-rpi_boot_config/actions/workflows/tests.yml/badge.svg)
[![Ansible Role](https://img.shields.io/ansible/role/d/infothrill/rpi_boot_config)](https://galaxy.ansible.com/infothrill/rpi_boot_config/)

Minimal role to manage config entries in a Raspberry Pi
[boot config](http://www.raspberrypi.org/documentation/configuration/config-txt.md).
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:

```yaml
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:

```yaml
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:

```yaml
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:

```yaml
rpi_boot_config_reboot: false
```

## Dependencies

None.

## Example Playbook

```yaml
- 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.