The sudo mesh firmware builder.

The openwrt wiki has some examples of requirements per distro: http://wiki.openwrt.org/doc/howto/buildroot.exigence#examples.of.package.installations

If you'd like to build the firmware in a controlled/clean environment, you can use docker with the provided Dockerfile:

First clone this repository:

git clone https://github.com/sudomesh/sudowrt-firmware
cd sudowrt-firmware

To build and run the image (depending on your network connect and hardware, the build takes a couple of hours):

Collect all the sudowrt-firmware dependencies into a docker image using:

docker build --no-cache -t sudomesh/sudowrt-firmware:dev .

output should end with something like:

[...]
Step 7 : ENTRYPOINT ./build ar71xx
 ---> Running in 7ffb33764a73
 ---> 348c604d4b97
Removing intermediate container 7ffb33764a73
Successfully built 348c604d4b97

After building the image, run it using:

docker run -v $PWD/built_firmware:/usr/local/sudowrt-firmware/built_firmware -t sudomesh/sudowrt-firmware:dev

A successful run should put the built firmware image in ./built_firmware of the repo directory. The console output should look something like:

[...]
+ local build_dir=/usr/local/sudowrt-firmware/built_firmware/builder.ar71xx
+ echo 'Building ar71xx in dir: /usr/local/sudowrt-firmware/built_firmware/builder.ar71xx'
Building ar71xx in dir: /usr/local/sudowrt-firmware/built_firmware/builder.ar71xx
+ make V=s -C /usr/local/sudowrt-firmware/built_firmware/builder.ar71xx
+ '[' 0 '!=' 0 ']'

If the build fails, capture the console output, yell loudly, talk to someone or create a new issue.

Now go to https://sudoroom.org/wiki/Mesh/WalkThrough to flash the firmware onto your router.

If you'd rather build the firmware without Docker, please keep reading.

Unless you know what you are doing, you should build this on a Ubuntu 64bit box/container. At time of writing (Jan 2017), the build script does not appear to work on Ubuntu 16.04.

Be aware that it won't build as root, so if you need to, follow these instructions to create a non-root user, and give it the power to sudo.

Once you're logged in as a non-root user with sudo ability, install the neccesary dependencies:

sudo apt-get update
sudo apt-get install build-essential subversion libncurses5-dev zlib1g-dev gawk gcc-multilib flex git-core gettext quilt ccache libssl-dev xsltproc unzip python wget

Run:

 ./build <arch>

Where arch is either ar71xx or atheros e.g:

./build ar71xx

The build will happen in:

built_firmware/builder.ar71xx/

The firmware images will be available in:

built_firmware/builder.ar71xx/bin/ar71xx/

Make sure you've already built the home-node firmware as the extender-node firmware will not build otherwise.

Run:

./build_extender-node ar71xx

The build will happen in:

built_firmware/builder.ar71xx.extender-node/

The firmware images will be available in:

built_firmware/builder.ar71xx.extender-node/bin/ar71xx/

The rebuild script is untested!

You can use ./rebuild but we're not actually sure what you can safely change and still use the ./rebuild script successfully. Changing packages, feeds and stuff in files/ should work, but if you change the patches then you will have to do a full rebuild.