diff options
| author | Christian Poessinger <christian@poessinger.com> | 2020-12-03 08:12:08 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2020-12-03 08:12:08 +0100 |
| commit | 08cb4dfe5739860e7e5ed6d0cb955bac67e0f013 (patch) | |
| tree | c026e8261cd74e08722f8526558770ba2441b81b | |
| parent | 1220ad3dab7d0ec486ba61facb2ca64aa2eff2d0 (diff) | |
| parent | b820812b38a9cfc1ae59280576296cb657cc78a7 (diff) | |
| download | vyos-documentation-08cb4dfe5739860e7e5ed6d0cb955bac67e0f013.tar.gz vyos-documentation-08cb4dfe5739860e7e5ed6d0cb955bac67e0f013.zip | |
Merge pull request #382 from akvadrako/firmware
Document how to build firmware
| -rw-r--r-- | docs/contributing/build-vyos.rst | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/contributing/build-vyos.rst b/docs/contributing/build-vyos.rst index 627d79d0..2fe2d3c0 100644 --- a/docs/contributing/build-vyos.rst +++ b/docs/contributing/build-vyos.rst @@ -429,6 +429,28 @@ In the end you will be presented with the Kernel binary packages which you can then use in your custom ISO build process, by placing all the `*.deb` files in the vyos-build/packages folder where they will be used automatically when building VyOS as documented above. +Firmware +^^^^^^^^ + +If you upgrade your kernel or include new drivers you may need new firmware. +Build a new ``vyos-linux-firmware`` package with the included helper scripts. + +.. code-block:: none + + $ cd vyos-build/packages/linux-kernel + $ git clone https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git + $ ./build-linux-firmware.sh + $ cp vyos-linux-firmware_*.deb ../ + +This tries to automatically detect which blobs are needed based on which drivers +were built. If it fails to find the correct files you can add them manually to +``vyos-build/packages/linux-kernel/build-linux-firmware.sh``: + +.. code-block:: bash + + ADD_FW_FILES="iwlwifi* ath11k/QCA6390/*/*.bin" + + Building Out-Of-Tree Modules ---------------------------- |