diff options
| author | Devin Bayer <dev@doubly.so> | 2020-12-02 17:38:28 +0100 |
|---|---|---|
| committer | Devin Bayer <dev@doubly.so> | 2020-12-02 19:35:49 +0100 |
| commit | b820812b38a9cfc1ae59280576296cb657cc78a7 (patch) | |
| tree | bd107eb6f8bd0852a63627f7450fb4701e1527fb | |
| parent | 0273002859f4228bf24d06081fbb4d8b55996ad2 (diff) | |
| download | vyos-documentation-b820812b38a9cfc1ae59280576296cb657cc78a7.tar.gz vyos-documentation-b820812b38a9cfc1ae59280576296cb657cc78a7.zip | |
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 ---------------------------- |