How to get the firmware onto the router
After you selected a Freifunk router, you will now need to equip it with the suitable firmware. This process is called "router flashing".
Attention: The OS of the router can be damaged irreparably when flashing it with the incorrect firmware or if a power shutdown occurs while flashing. In most cases, this can be fixed via the serial console, but not always. Therefore, you have to be extremely careful and must not carelessly unplug the router from the power supply while it copies the firmware to its memory.
There are different firmware files for each router which are divided into FACTORY
and SYSUPGRADE
.
FACTORY
firmware files are suitable for the initial installation of a router, i.e. to change from the manufacturer's firmware (freshly from the factory in which it was produced) to a Freifunk firmware. SYSUPGRADE
firmware is necessary for routers that already have an OpenWRT-based firmware such as a Freifunk router from another Freifunk community or another Freifunk Bodensee router. In order to find the suitable firmware for your router, there is either the Firmware Wizard as well as a List of all firmware files. It is extremely important to know the exact version of your Freifunk router. You will find it (as also described in the pictures below) at the back side of the router. As most routers can differ immensely from one version number to the other, it is extremely important that the version number matches exactly. For models with many different version numbers, these are not always well sorted in the Firmware Wizard and it might therefore happen that the latest version shows up in the middle of the list and not at the beginning or the end.
We frequently mention that we use Open Source firmware. That means with a little bit of Linux experience and knowledge in using the Shelly you can easily compile the firmware from the source code. This is exactly what we did and then we made the finished result available as download on the Internet.
You can find the firmware as well as instructions on how to compile it yourself on GitHub.
Tip: Most Freifunk routers can be found in the ar71xx category.
There are basically to options to equip a router with a Freifunk firmware: The easiest way is to upload a file via the web interface of the router and to wait for the router to install it on its own. The other way would be to provide the firmware via a TFTP server and convince the router to download and install it.
For several router models, the installation via the web interface is deactivated in the original firmware of the manufacturer which is why the firmware can only be installed via the TFTP server. So, if you encounter problems installing via the web interface then you should try using the TFTP server method. Also, a seemingly damaged Freifunk router can often be revived with the help of the TFTP server.