Add documentation

[blocktrron]

Considering installing on this Devices might still be pretty complicated for people who are not doing this stuff day in and day out, we should try to provide detailed documentation.

This includes adding separate documentation

• [ ] setting static IPv4 address
• [ ] disabling all other interfaces
• [ ] restoring original IP configuration afterwards

as well as improving instructions fritzflash.sh currently gives while performing it's tasks. My personal wishlist would be

• [ ] adding multi-language support
• [ ] improve error handling (and give detailed information how to fix it)

For the separate Documentation, the whole A-Z process would be great including screenshots. This, naturally, has to be done for every OS separately. On my wishlist would be

• [ ] Windows 10
• [x] MacOS X
• [x] Ubuntu

I chose Ubuntu as it is probably the most convenient way for using the script from a live environment (and it's pretty common also).

[Marwe]

For Ubuntu with network-manager I needed some tries. With a bit of additional commandline foo the timing was finally correct for network settings, script start and router power up. It might need some retries...

0. set up a connection with the name fritzflash in nm (IPs as proposed by script, see resulting nm config file below)
1. unplug/depower fritz box
2. power fritz box
3. and start the commandline ASAP (at same time)
4. if the fritzflash.py does not start the flashing, the timing might be the issue, retry from 2

adapt to your values (network name, IP and .bin)

while true ; do for i in 1 2 3 ; do nmcli connection up fritzflash; ifconfig;done; ./fritzflash.py --ip 192.168.178.1 --image gluon-ffka-0.6.2-stable.0-20181214-avm-fritz-box-4020-sysupgrade.bin; sleep 1; done

The attached file contains the config in /etc/NetworkManager/system-connections/fritzflash fritzflash.txt

[jensileinchen]

based on different documentations from several websites some month ago i prepared a PDF file with detailed description how to bring the Freifunk OS onto Fritzbox 4020. Our local community is Freifunk-Hennef -- but the step-by-step manual should work for every site. Just take a look in my repository if interested --- at the moment its only German language but with screenshots. Let me know your opinion ! Thanx for watching.

https://github.com/jensileinchen/MANUAL-Fritz-Box-4020-with-gluon-lede

[rubo77]

direct link

It would be helpful, if you add a site to the wiki too, linked at https://wiki.freifunk.net/Kategorie:Flash-Anleitungen