Welcome to fritz-tools

This is a collection of useful scripts, primarily for use with the bootloader of AVM networking devices.

General information

Selecting the right Image

Gluon builds by default factory and sysupgrade images. AVM devices don’t need special factory-images, so most of them are flashed via the sysupgrade images.

Note

In case your community uses a tool for providing firmware, factory-images are often referenced as “First-installation-images” and sysupgrade-images are often called “update-” or “upgrade-images”.

Exceptions apply for the FRITZ!Box 4040. This device needs a special bootloader-image for use with the flash-script. Flashing with a sysupgrade image won’t work.

Flash Gluon using Windows 10

Your router can be flashed in a few easy step from Windows 10.

Preperation

First you need to download the image for your device from your local Freifunk community. This is important to do right now as you will have no ability to do so later on.

Download Python 3 for Windows

Download and install the latest version of Python 3. It can be obtained from the website of the Python project.

Download the flash-script

Download the latest version of the flash-script fritzflash.py at the link below. In case you are prompted whether you want to save or open this file, select save.

fritzflash.py

Disable WiFi

In case your computer is connected via WiFi, make sure to disable this connection by opening the Quick-settings in the lower right corner. Make sure WiFi is disabled there.

_images/windows10_step_1.png

Configuring a static IP-address

Open the network settings by opening Quick-settings and navigate to the Network and Sharing Center.

_images/windows10_step_2.png

Go to the Network Adapter Settings.

_images/windows10_step_3.png

Select the adapter called Ethernet.

_images/windows10_step_4.png

In the adapter-status window, select properties.

_images/windows10_step_4a.png

Double-click on Internet Protocol Version 4.

_images/windows10_step_5.png

Fill out all fields as seen on the image below. Close afterwards both windows by clicking OK.

_images/windows10_step_6.png

Install Gluon

Now move both fritzflash.py and the Gluon image in an empty directory.

Note

It is important both files are located in the same directory. Otherwise the process won’t work.

_images/windows10_step_7.png

Connect the router with your computer. In case it has multiple ports, use the yellow LAN-ports.

Execute the flash-script by double-clicking on fritzflash.py.

In case Windows Firewall asks you whether you want to allow or deny network activity, select Allow.

_images/windows10_step_8.png

Revert network settings

Before you are able to reach the Config-mode of your new node you have to reconfigure your network interface to automatically obtain an IP-address using DHCP.

Configure your network interface interface as pictured on the screenshot below and confirm by selecting OK in both windows.

_images/windows10_step_9.png

Also remember to turn on your WiFi again.

Flash Gluon using MacOS X

Your router can be flashed in a few easy step from MacOS X.

Preperation

To execute the fritzflash.py script you need to have Python 3 installed. You can obtain the latest version from the Python project here.

You also need to download the image for your device from your local Freifunk community. This is important to make right now as you will have no ability to do so later on.

Download the flash-script

Open a terminal by pressing cmd+Space.

Next, go to the directory you saved the Image you downloaded in the preperation step. In most cases this is done by èxecuting cd Downloads.

Now you want to download the script by executing curl -O https://raw.githubusercontent.com/freifunk-darmstadt/fritz-tools/master/fritzflash.py.

Confirm both the Gluon image you want to flash and the script are present in the current directory by executing ls.

_images/macos_step_1.png

Keep the Terminal window open.

Configuring a static IP-address

Open System Preferences and select Network.

_images/macos_step_2.png

Make sure to disable your Wireless connection now.

_images/macos_step_3.png

Select Ethernet from the left menu and in case input fields are grayed out, unlock settings by clicking on the Lock in the bottom left corner.

_images/macos_step_4.png

Configure your settings as seen in following screenshot and confirm by clicking on Apply. Keep the window opened.

_images/macos_step_5.png

Install Gluon

Connect the router with your computer. In case it has multiple ports, use the yellow LAN-ports.

Execute the flash-script by executing python3 fritzflash.py in the Terminal window you left open.

_images/macos_step_6.png

In case you’re asked to allow incoming connection or not select Allow.

_images/macos_step_7.png

Revert network settings

Before you are able to reach the Config-mode of your new node you have to reconfigure your network interface to automatically obtain an IP-address using DHCP.

Configure your Ethernet interface as pictured on the screenshot below and confirm by selecting Apply.

_images/macos_step_8.png

Flash Gluon using Ubuntu 18.04

Your router can be flashed in a few easy step from Ubuntu 18.04.

Preperation

First you need to download the image for your device from your local Freifunk community. This is important to do right now as you will have no ability to do so later on.

Download the flash-script

Open a terminal by pressing Ctrl+Alt+T or open the application-drawer (bottom left) and search for Terminal.

_images/ubuntu1804_step_1.png

Next, go to the directory you saved the image you downloaded in the preperation step. In most cases this is done by executing cd Downloads.

Now you want to download the script by executing wget https://raw.githubusercontent.com/freifunk-darmstadt/fritz-tools/master/fritzflash.py.

_images/ubuntu1804_step_2.png

Confirm both the Gluon image you want to flash and the script are present in the current directory by executing ls.

Keep the Terminal window open.

Configuring a static IP-address

Open the settings application.

If your computer has WiFi, make sure to disable it now.

_images/ubuntu1804_step_3.png

Select Network from the left menu and open the settings by clicking on the gear button.

_images/ubuntu1804_step_4.png

Configure your Settings as seen in the following screenshot and confirm by clicking on Apply in the top right corner.

_images/ubuntu1804_step_5.png

Now you will need to deactivate and reactivate the network interface to correctly apply the settings. Do so by turning the connection from On to Off. Wait two seconds and turn the connection back On again.

_images/ubuntu1804_step_6.png

Keep the settings window open.

Install Gluon

Connect the router with your computer. In case it has multiple ports, use the yellow LAN-ports.

Execute the flash-script by executing python3 fritzflash.py in the Terminal window you left open.

_images/ubuntu1804_step_7.png

Revert network settings

Before you are able to reach the Config-mode of your new node you have to reconfigure your network interface to automatically obtain an IP-address using DHCP.

Configure your network interface interface as pictured on the screenshot below and confirm by selecting Apply.

_images/ubuntu1804_step_8.png

You will (again) need to deactivate and reactivate the Network interface to correctly apply the settings. Do so by turning the connection from On to Off. Wait two seconds and turn the connection back On again.

_images/ubuntu1804_step_6.png

Supported Devices

These devices are confirmed working using the tools provided in this repository.

  • FRITZ!Box 4020
  • FRITZ!Box 4040
  • FRITZ!WLAN Repeater 300E
  • FRITZ!WLAN Repeater 450E
  • FRITZ!WLAN Repeater 1750E

License

See LICENCE

Indices and tables