Skip to content

Support⚓︎

Wie kann ich Freetz-NG unterstützen?

UNTESTED⚓︎

Im menuconfig und in FIRMWARES sind verschieden Geräte als UNTESTED markiert.
Mangels Hardware konnte auf diesen nicht ausprobiert werden ob Freetz-NG funktioniert.
Falls jemand so ein Gerät erfolgreich mit Freetz-NG betreibt, bitte Rückmeldung geben.
Am besten gleich mit einem Screenshot von Box-Info und Flashspeicher.

Quellcode⚓︎

Um ein modifiziertes Image zu erstellen, ist von AVM der passende Quellcode notwendig.
Da AVM Software nutzt die zB unter der GPL steht, muss dieser Sourcecode herausgegeben
werden - allerdings nur auf Anfrage!
Dazu sollte jeder für jedes seiner Geräte eine E-Mail an fritzbox_info@avm.de schicken.
Dies zu jeder veröffentlichten FritzOS Version, auch für die sogenannten "Labor".
AVM veröffentlicht das Paket dann früher oder später auf osp.avm.de/.

Pull request⚓︎

Eigene Änderungen zu Freetz-NG "pushen":

  • Auf github.com/Freetz-NG/freetz-ng/ oben mit Fork einen Fork im eigenen Account erstellen.
  • Eigenen Fork auschecken: git clone https://github.com/BENUTZERNAME/freetz-ng.git
  • Einen Branch erstellen: git branch BRANCHNAME ; git checkout BRANCHNAME ; git push -u origin BRANCHNAME
  • Geänderte/hinzugefügte Dateien hochladen: git add . ; git commit -m "BESCHREIBUNG" ; git push
  • Auf github.com/Freetz-NG/freetz-ng/ mit New pull request die eigenen Änderungen abschicken.

Mailbox Format⚓︎

Falls ein pull request zu aufwändig ist kann auch ein Patch erstellt werden:

  • Auschecken: git clone https://github.com/Freetz-NG/freetz-ng.git
  • Sicherstellen dass der Name gesetzt ist: git config --global user.name "GITHUB-NAME"
  • Sicherstellen dass die eMail gesetzt ist: git config --global user.email GITHUB-NAME@users.noreply.github.com
  • Veränderungen vornehmen, Dateien löschen oder hinzufügen.
  • Alle Veränderungen hinzufügen: git add .
  • Einen Commit erstellen: git commit -m "BESCHREIBUNG"
  • Die Patchdatei erstellen: git format-patch origin/HEAD
  • Alle lokalen Veränderungen wieder löschen git reset --hard origin/HEAD

Package bump⚓︎

Minimale Schritte um die Version eines Packages/Library zu aktualisieren:

  • Changelog lesen, es kann sich etwas geändert haben das beachtet werden muss.
  • Hinweis: Libraries befinden sich nicht in make/pkgs/$PKG/ sondern: make/libs/$PKG/
  • Die Datei docs/CHANGELOG.md anpassen.
  • Die Version in make/pkgs/$PKG/Config.in anpassen.
  • Die Version in make/pkgs/$PKG/$PKG.mk anpassen.
  • Die Prüfsumme in make/pkgs/$PKG/$PKG.mk anpassen.
  • Falls der Dateiname die Version enthält, make/pkgs/$PKG/external.* anpassen.
  • Vorhandene Patches in make/pkgs/$PKG/patches/ aktualisieren durch ausführen von: make $PKG-autofix
  • Compilieren testen mit: make $PKG-recompile
  • Am besten noch auf eine Fritzbox flashen und testen.

Wiki⚓︎

Viele Teile des unter freetz-ng.github.io/ zu erreichenden Wikis sind veraltet und bedürfen einer
Überarbeitung. Alle Datein des Wikis sind im Checkout unter docs/wiki/ zu finden.