Ansible Role rtl_nic_firmware

This is an Ansible role designed to install missing rtl_nic firmware for APU systems.

When It Runs

This role will only run if the following conditions are met:

when:
  - ansible_board_name == 'APU'
  - ansible_product_name == 'APU'

What It Does

• It downloads the specified firmware files from the rtl_nic__firmware variable.
• It then updates the initial RAM file system using the command: update-initramfs -k all -u.

You can change the names of the firmware files that get downloaded by adjusting the default variables.

Version Check (Optional)

You can perform a simple version check to avoid using an older version of this role by accident.

Variables

---
# Base URL for downloading firmware
rtl_nic__download_prefix: 'https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain'

# List of firmware files to download
rtl_nic__firmware:
  - 'rtl_nic/rtl8107e-2.fw'
  - 'rtl_nic/rtl8107e-1.fw'
  - 'rtl_nic/rtl8168h-2.fw'
  - 'rtl_nic/rtl8168h-1.fw'
  - 'rtl_nic/rtl8168g-3.fw'
  - 'rtl_nic/rtl8168g-2.fw'
  - 'rtl_nic/rtl8106e-2.fw'
  - 'rtl_nic/rtl8106e-1.fw'
  - 'rtl_nic/rtl8411-2.fw'
  - 'rtl_nic/rtl8411-1.fw'
  - 'rtl_nic/rtl8402-1.fw'
  - 'rtl_nic/rtl8168f-2.fw'
  - 'rtl_nic/rtl8168f-1.fw'
  - 'rtl_nic/rtl8105e-1.fw'
  - 'rtl_nic/rtl8168e-3.fw'
  - 'rtl_nic/rtl8168e-2.fw'
  - 'rtl_nic/rtl8168e-1.fw'
  - 'rtl_nic/rtl8168d-2.fw'
  - 'rtl_nic/rtl8168d-1.fw'

# Paths for firmware storage
rtl_nic__path_prefix: '/lib/firmware'
rtl_nic__path_suffix: 'rtl_nic'

# Enable version check? (true recommended)
submodules_versioncheck: false