Inhaltsverzeichnis
Willkommen bei Freetz
Freetz ist eine Firmware-Erweiterung und Modifikation für Fritz!Box Router und kompatible Geräte. Die Original-Firmware des Herstellers wird um zusätzliche Funktionen erweitert und mit einer individuellen Zusammenstellung von Programmen ergänzt. Mehr zum Namen "Freetz" und zur Historie siehe FAQ.
Freetz ist freie Software und wird von Oliver Metz, Alexander Kriegisch und Team entwickelt.
WARNUNG: Die Installation einer modifizierten Firmware führt zum Verlust der Gewährleistung des Herstellers!
Download
Das aktuelle Release ist v1.1.5 und kann hier heruntergeladen werden. Eine komplette Liste aller Releases findet sich auf der Download Seite.
Um die 1.2 (Vorabversion) oder den Trunk (Entwicklerversion) zu nutzen der Anleitung zum Auschecken und Aktualisieren des Quellcodes aus dem Freetz-Repository folgen.
Diese Versionen unterscheiden sich in der unterstützen AVM-Firmware (Datei 'FIRMWARES') und den Erweiterungen durch Freetz (Datei 'CHANGELOG').
Erste Schritte
Diese Anleitung richtet sich in erster Linie an neue Benutzer, welche sich erst mit Freetz vertraut machen wollen. Der Benutzer wird schrittweise begleitet bis zur Erstellung und Flashen eines ersten Firmware-Images.
Installation
Für die Freetz-Installation wird Linux als Betriebssystem empfohlen. Wer kein Linux dauerhaft auf seinem Rechner installieren will, kann sich mit einem Linux-Live-System oder einem sog. Image für eine "virtuellen Maschine" (VM) seiner Wahl behelfen.
Wiki, Forum und IRC
- Wiki:
- Installation
- Pakete, Addons und CGI-Erweiterungen
- Patches, Aussehen
- Bibliotheken, Module, FAQ
- Hintergrund-Infos
- Howtos, und Hilfe
- Forum: Diskussion, Fragen und Ankündigungen
- IRC-Themenkanal zu FritzBox und (inoffiziell) Freetz
Weitere Informationen rund um FritzBox & Co. außerdem bei WeHaveMoreFun (WHMF):
- Fritz!Box-Wiki: Tipps & Tricks, Hintergrund-Infos u.v.m.
Presse und Berichte
Mach mit!
Interessierte Benutzer und potentielle Entwickler, die aktiv an der Verbesserung von Freetz und deren Entwicklung mitwirken wollen, werden durch das Trac-Systems hinreichend unterstützt. So können der komplette Quellcode eingesehen, Änderungen verfolgt und über das Ticket-System Fehler und Feature-Wünsche gemeldet werden. Ein aktuelles Wiki hilft allen Beteiligten!
- Zeitachse: Chronologie der Änderungen
- Roadmap: Stand und Planung der Entwicklung (in Arbeit)
- Quellcode-Browser: SVN-Repository durchsuchen
- Ticket-System: Probleme, Fehler und neue Feature-Wünsche (bitte hier nachlesen und evtl. im Forum Fragen, bevor ein Ticket eröffnet wird!)
- Developer Information: Informationen für Entwickler und Howtos (englisch)
- Interner Entwicklerbereich: Nur für Entwickler: Interner Bereich zur Abstimmung.
Das Bearbeiten des Wikis und Eröffnen von Tickets ist zur Vermeidung von Spam nur nach vorheriger Registrierung möglich.
Troubleshooting
Troubleshooting .config
Je nach Änderungen am Buildsystem und Config-Variablen kann eine existierende (alte) .config Datei eingeschränkt oder garnicht mehr verwendet werden.
Mögliche Abhilfe:
$ yes "" || make oldconfig <--- Alte .config Datei auffrischen oder $ make menuconfig <--- Ggf. .config Datei neu erstellen
Troubleshooting Build-Abbruch
Sollte während des Build-Prozesses ein Abbruch auftreten, so kann man versuchen diese Strategien anzuwenden:
$ make iptables-dirclean <--- Source-Verzeichnis eines problematischen Package löschen (hier: iptables) und/oder $ make dirclean <--- Source-Verzeichnisse aller bisher erstellter Software löschen weiter mit $ make <--- Versuchen problematische(s) Package/Software von Anfang neu zu bauen
Bei Nicht-Erfolg können Wiki, Forum und IRC genutzt werden, um das Problem weiter zu behandeln.
Trac-Links
- TracGuide — Trac Benutzer- und Administrator-Dokumentation (englisch)
- Formatierungssyntax — Syntax zur Formatierung von Tickets und Wiki
- TitleIndex — Liste aller vorhandenen Wiki Einträge
