Build Firmware

To build firmware, you need Ubuntu 20.04 LTS. Other distributions may work but are not officially supported. Building firmware directly on a Windows platform is not supported. However, if only a Windows machine is available, we recommend setting up a Linux-based virtual machine.

Note: The following build was tested on Ubuntu 20.04.6 LTS running the 6.17 kernel.

Note: Please build with non-root privileges!


Install Packages on Your Computer

To build OpenWrt firmware, you will need several software packages on your host build machine. Let's prepare the build environment based on OpenWrt instructions: https://openwrt.org/docs/guide-developer/toolchain/install-buildsystem

sudo apt update
sudo apt install build-essential clang flex bison g++ gawk \
gcc-multilib g++-multilib gettext git libncurses5-dev libssl-dev \
python3-setuptools rsync swig unzip zlib1g-dev file wget


Get Latest Sources

1. Get the latest sources from the official OpenWrt upstream main branch and enter the cloned directory:

git clone https://github.com/openwrt/openwrt.git
cd openwrt

2. ATTENTION! This step is currently highly advised, but will not be needed in the future. The Kiwi DVK firmware is included in the OpenWrt upstream main branch. However, since the main branch is under active development, the firmware currently is not released by OpenWrt and has issues with Ethernet interfaces (no Ethernet link due to dropped packets). To avoid these problems, we recommend using ''git checkout'' to switch to a specific commit that has been tested by our team and confirmed to work correctly on the Kiwi DVK board:

git checkout d324d6f07e687c3d89b0737bef091f9e1d151486


Build Image

1. If you are building firmware for the first time, run the following commands to update/install the feeds manually:

./scripts/feeds update -a
./scripts/feeds install -a

2. Enter the configuration menu:

make menuconfig

3. Set Target System, Subtarget, and Target Profile correctly:

Target System - Qualcomm Atheros 802.11be WiSoC-s
Subtarget - Qualcomm Atheros IPQ95xx
Target Profile - 8devices Kiwi-DVK

4. After configuration, proceed to build the firmware:

make defconfig download clean world -j16


Note that building OpenWrt firmware takes some time. On a moderate computer, it might take 1 to 3 hours. CPU load during this process is typically close to 100%. The build environment requires approximately 12GB of hard disk space.

You should see a build log like this:

Once finished, the compiled firmware will be named openwrt-qualcommbe-ipq95xx-8devices_kiwi-dvk-squashfs-<factory OR sysupgrade>.bin and will be placed in the ./bin/targets/qualcommbe/ipq95xx directory. Both images can be used to upgrade the firmware; however, the *factory* image is used with a TFTP server if the previously flashed firmware is different from the official OpenWrt. See Flash Firmware and Recover Firmware for more information.