Freifunk Dresden: Unterschied zwischen den Versionen

Aus C3D2
Zur Navigation springen Zur Suche springen
(12 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Broken|Reason=Technische Details depubliziert unter [[Intern:Freifunk Dresden]].|}}
[[Datei:1406FreifunkDresden-Logo.svg‎|rechts]]
[[Datei:1406FreifunkDresden-Logo.svg‎|rechts]]
[[Freifunk Dresden]] ist das Projekt in Dresden zu [[wikipedia:de:Freifunk]]. Das Freifunk-Netz Dresden ist ein von Freiwilligen betriebenes freies WLAN-Netzwerk. Ziel ist es, Dresden flächendeckend mit [[Freifunk]] zu versorgen.<ref>Seite des [http://www.freifunk-dresden.de Freifunk Dresden]</ref>
[[Freifunk Dresden]] ist das Projekt in Dresden zu [[wikipedia:de:Freifunk]]. Das Freifunk-Netz Dresden ist ein von Freiwilligen betriebenes freies WLAN-Netzwerk. Ziel ist es, Dresden flächendeckend mit [[Freifunk]] zu versorgen.<ref>Seite des [http://www.freifunk-dresden.de Freifunk Dresden]</ref>
Zeile 16: Zeile 14:
=== Firmware ===
=== Firmware ===


Seit {{#formatdate:2014-12-03}} steht die [http://download.ddmesh.de/firmware/2.1.5/ Firmware 2.1.5] zur Verfügung.
Seit {{#formatdate:2014-12-03}} steht die [http://download.ddmesh.de/firmware/ Firmware] zur Verfügung.


Die Firmware-Dateien sind nach den unterstützten Geräten benannt. Der Name einer Firmware-Datei setzt sich als <code>openwrt-ar71xx-generic-''ROUTERNAME''-squashfs-''ZUSATZ''.bin</code> zusammen.
Die Firmware-Dateien sind nach den unterstützten Geräten benannt. Der Name einer Firmware-Datei setzt sich als <code>openwrt-ar71xx-generic-''ROUTERNAME''-squashfs-''ZUSATZ''.bin</code> zusammen.
Zeile 26: Zeile 24:
: Beim Dateinamen <code>openwrt-ar71xx-generic-''tl-wr841n-v8''-squashfs-''sysupgrade''.bin</code> bedeutet der Zusatz ''Sysupgrade'' hingegen, dass diese Datei zum Updaten eines bereits für den Dresdner Freifunk im Einsatz befindlichen Routers ist.
: Beim Dateinamen <code>openwrt-ar71xx-generic-''tl-wr841n-v8''-squashfs-''sysupgrade''.bin</code> bedeutet der Zusatz ''Sysupgrade'' hingegen, dass diese Datei zum Updaten eines bereits für den Dresdner Freifunk im Einsatz befindlichen Routers ist.


Ausführliche Erklärungen zur Konfiguration der Firmware werden im [[freifunk-dresden:Hauptseite | Wiki]] (wiki.freifunk-dresden.de) gepflegt.
Ausführliche Erklärungen zur Konfiguration der Firmware sowie alle anderen Informationen bezüglich Freifunk Dresden, werden im [[freifunk-dresden:Hauptseite | Wiki]] (wiki.freifunk-dresden.de) gepflegt.


=== Router ===
=== Router ===


Wie der [http://download.ddmesh.de/firmware/2.1.5/ar71xx/ Firmware-Liste] zu entnehmen ist, gibt es eine Vielzahl an Freifunk-kompatiblen Routern. Allerdings erfreuen sich bestimmte Modelle in Dresden meist insbesondere wegen der günstigen Anschaffungskosten besonderer Beliebtheit:
Wie der [http://download.ddmesh.de/firmware/ Firmware-Liste] zu entnehmen ist, gibt es eine Vielzahl an Freifunk-kompatiblen Routern. Allerdings erfreuen sich bestimmte Modelle in Dresden meist insbesondere wegen der günstigen Anschaffungskosten besonderer Beliebtheit.<br>
Eine aktuelle Übersicht wird im Wiki von Freifunk Dresden gepflegt [https://wiki.freifunk-dresden.de/index.php/Router Router].


{| class="wikitable sortable zebra toptextcells"
{| class="wikitable sortable zebra toptextcells"
Zeile 77: Zeile 76:
|-
|-
|}
|}
Auch interessant für weitere Bastelarbeiten: [https://vocore.io/ vocore]


== Standorte ==
== Standorte ==
Zeile 110: Zeile 111:
Ideen dazu werden [[Diskussion:Freifunk Dresden|diskutiert]], um die jetzigen Betreibenden in Blick auf offenem Zugang zu Informationen zu überzeugen.
Ideen dazu werden [[Diskussion:Freifunk Dresden|diskutiert]], um die jetzigen Betreibenden in Blick auf offenem Zugang zu Informationen zu überzeugen.


== WLAN-Einstellungen ==
== Technische Informationen ==


Die detailierten Einstellungen werden [[Intern:Freifunk Dresden|derzeit intern]] beschrieben.
Grundsätzlich soll das [http://wiki.freifunk-dresden.de/ Wiki Freifunk Dresden] Informationen, insbesondere auch technische Informationen, bereitstellen. Das ist wohl aber noch nicht der Fall und soll wohl in Arbeit sein.


== Adressvergabe ==
=== Quellcode ===
----
<font color="red">'''Folgende Informationen sind veraltet und werden noch aktualisiert.'''</font>


==== IP-Adressberechnungs mit Shell- und Lua Script ====
Der Quellcode soll auf [[#GitHub]] verfügbar sein. Dies gilt insbesondere für die [[#Firmware]].<ref>https://github.com/ddmesh/firmware-freifunk-dresden</ref>


Die Berechnung kann sich in künftigen Versionen ändern, derzeit wird u.a. eine Aufteilung des Netzwerkes in "original"-FFF und "custom" erwogen. Deshalb ist Vorsicht geboten was die Aktualität des Inhaltes angeht - bitte überprüfen bevor ihr peert.
=== mögliche Probleme beim Betrieb der Technik ===


Die Scripte deren Algorithmus formalisiert werden soll:
== Metadaten ==


===== usr/bin/ddmesh-ipcalc.sh =====
=== Freifunk-API ===
<source lang="bash">
#!/bin/sh


if [ "$1" = "" ]
Es existiert eine Inter-Community-API analog zur SpaceAPI. Beispiel: [http://cholin.spline.de/freifunk/api-viewer/ Freifunk API Viewer]
then
echo ""
        echo "ddmesh-ipcalc.sh (lua) Stephan Enderlein (c) 2013 V1.7"
echo ""
        echo "Calculates all the addresses for the ddmesh freifunk node"
echo "usage: ddmesh-ipcalc.sh [-n node] | [ip]"
echo ""
        exit 1
fi


if [ "$1" = "-n" ]; then
[https://github.com/freifunk/directory.api.freifunk.net/blob/master/directory.json Directory.json], [http://info.ddmesh.de/info/freifunk.json Dresden]
node=`echo "$2" | sed 's/[\$\`\(\)]/0/g'`
lua -lddmesh -e "ipcalc.print($node)"
else
ip=`echo "$1" | sed 's/[\$\`\(\)]/0/g'`
lua -lddmesh -e "print(iplookup(\"$ip\"))"
fi


</source>
=== Knotenmetadaten ===
 
===== usr/lib/lua/ddmesh.lua =====
 
<source lang="lua">
--[[----------------------------------------------------------------------------------------
ddmesh.lua
library for different freifunk functions
version: 6
-------------------------------------------------------------------------------------------]]
 
----------------- ipcalc ---------------
ipcalc={}
ipcalc.data={}
ipcalc.data.max=2048


function split(str, delim, maxNb)
Jeder Knoten bietet ein JSON-Dokument unter http://10.200.../sysinfo.json an. Es enthält Versionsstände, Geokoordinaten, Kontaktinfo, Auslastung und alle Routen.
    -- Eliminate bad cases...
    if string.find(str, delim) == nil then
        return { str }
    end
    if maxNb == nil or maxNb < 1 then
        maxNb = 0    -- No limit
    end
    local result = {}
    local pat = "(.-)" .. delim .. "()"
    local nb = 0
    local lastPos
    for part, pos in string.gfind(str, pat) do
        nb = nb + 1
        result[nb] = part
        lastPos = pos
        if nb == maxNb then break end
    end
    -- Handle the last field
    if nb ~= maxNb then
        result[nb + 1] = string.sub(str, lastPos)
    end
    return result
end


function ipcalc.rCalcIp(ip)
== IPv4-Meshing mit bmxd ==
    if ip==nil or ip=="" then return -1 end
    a = split(ip, "[.]")
    if #a ~= 4 then return -1 end
    if a[1]==nil or a[1]=="" or tonumber(a[1]) ~= 10 then return -1 end
    if a[2]==nil or a[2]=="" or tonumber(a[2]) ~= 200 and tonumber(a[2]) ~= 201 then return -1 end
    if a[3]==nil or a[3]=="" or tonumber(a[3]) < 0 or tonumber(a[3]) > 255 then return -1 end
    if a[4]==nil or a[4]=="" or tonumber(a[4]) < 0 or tonumber(a[4]) > 255 then return -1 end


    middle = a[3]
BMXD is eine "expermientelle" Variante von b.a.t.m.a.n, welche rundsätzlich intern ähnlich funktioniert, aber zusätzliche
    if a[2]=="201" then middle = middle + 256 end
Konfigurationen des Routings erlauben. Zusätzlich nutzt diese Varinate drei Routing-Tabellen, wodurch ein geziehltes Definieren
    minor = math.floor(a[4]/64) --x>>6
von Routing-Regeln möglich ist. Dieses kann dazu verwendet werden, Angriffe auf das Routing und dann das Umleiten von Traffic
    node = middle*4+minor --x<<2
zu verhindern.
    if node < 0 or node > ipcalc.data.max then return -1 end
Das war auch das Entscheidungkriterium für dieses Protokoll.
    return node
end


function ipcalc.calc(node)
Allderdings wird dieses Protokoll (bmxd) nicht mehr vom Author weiterentwicklet oder verbessert. Eine Weiterentwicklung ist auch
    --node has to be a number n \in N_0, 0 <= n <= 2048
nicht nötig, wenn alle Funktionalitäten erfüllt werden.
    if node==nil or node=="" then return -1 end
    node=tonumber(node)
    if node==nil or node=="" then return -1 end
    if node < 0 or node > ipcalc.data.max then return -1 end


    local domain = "freifunk-dresden.de"
Während des Betriebs von Freifunk Dresden mit BMXD und der Testungsdurchläufen, sind allerdings einige Programmierfehler sichtbar geworden.
Diese wurden dann direkt in den Quellen von Freifunk Dresden, welches die Sourcen von bmxd enthält, korregiert.


    --Ternary Operator in use
Die letzten Änderungen betreffen sogar den Rausschmiss einiger Funktionalitäten, um Speicher zu sparen und Datendurchsätze zu verdreifachen.
    -- major network for nodes n < 1024: 200, for nodes > 1023: 201
    local major  = node >= 1024 and 201 or 200                    --a[2]
    -- etc.
    local middle  = node >= 1024 and math.floor((node-1024) / 4) or math.floor(node / 4)  --a[3]
    local minor  = (node % 4) * 64


    local meshnet = "10"
Sicherlich ist es möglich, eigene Firmwares mit dem Protokoll zu bauen und ins Freifunk Dresden Netzwerk einzubinden. Allerdings sind einige
    local nodeip  = meshnet .. "." .. major .. "." .. middle .. "." .. minor + 1
logische und organisatorische Bedingungen zu erfüllen und strickt einzuhalten.
    local meshnetmask = "255.0.0.0"
Wenn das nicht erfolgt, ist es garantiert, dass das Freifunk Netz damit gestört wird.
    local meshpre = 15
Einen Schutz dagegen, kann BMXD und deren Varianten nicht erfüllen.
    local meshbroadcast = "10.255.255.255"
https://wiki.freifunk-dresden.de/index.php/Knoten_Spezifikation
    local meshnetwork  = "10.200.0.0"
=== Bauen ===


    local dhcpstart    = meshnet .. "." .. major .. "." .. middle .. "." .. minor + 2
Code, letzte Commits im Feb 2011, gibts [https://github.com/axn/bmxd auf Github].
    local dhcpend      = meshnet .. "." .. major .. "." .. middle .. "." .. minor + 63
    local dhcpoffset    = 1 --used by config/dhcp
    local dhcplimit    = 62 --used by config/dhcp
    local dhcprangepre  = 26
    local dhcprangemask = "255.255.255.192"
    local dhcpnetmask  = "255.255.255.255"
    local dhcpbroadcast = "10.255.255.255" -- needed, else dnsmasq will not start
    local dhcpnetwork  = meshnet .. "." .. major .. "." .. middle .. "." .. minor


    local hna = meshnet .. "." .. major .. "." .. middle .. "." .. minor .. "/" .. dhcprangepre
<pre>
    local mesh6pre = "48"
git clone git://github.com/axn/bmxd.git
    local mesh6net = "fd11:11ae:7466::"
cd bmxd
    -- client range
make -j5
    local mesh6nodenet= "fd11:11ae:7466:" .. string.format("%x", node) .. "::"
strip bmxd  # Spart Platz
    local mesh6ip = mesh6nodenet .. "1"
</pre>
    local mesh6nodepre= "64"


    -- preparing variabled to be expoted
=== Voraussetzungen ===
    ipcalc.data.node              = node
    ipcalc.data.domain            = domain
    ipcalc.data.hostname          = "r" .. node
    ipcalc.data.ip                = nodeip
    ipcalc.data.network            = meshnetwork
    ipcalc.data.netpre            = meshpre
    ipcalc.data.netmask            = meshnetmask
    ipcalc.data.broadcast          = meshbroadcast
    ipcalc.data.dhcpstart          = dhcpstart
    ipcalc.data.dhcpend            = dhcpend
    ipcalc.data.dhcpoffset   = dhcpoffset
    ipcalc.data.dhcplimit        = dhcplimit
    ipcalc.data.dhcprangepre      = dhcprangepre
    ipcalc.data.dhcprangemask      = dhcprangemask
    ipcalc.data.dhcpnetwork        = dhcpnetwork
    ipcalc.data.dhcpbroadcast      = dhcpbroadcast
    ipcalc.data.dhcpnetmask        = dhcpnetmask
    ipcalc.data.clienthna          = hna
    ipcalc.data.mesh6ip   = mesh6ip
    ipcalc.data.mesh6net   = mesh6net
    ipcalc.data.mesh6pre   = mesh6pre
    ipcalc.data.mesh6nodenet   = mesh6nodenet
    ipcalc.data.mesh6nodepre   = mesh6nodepre
end


function ipcalc.print(node)
* Lies die [http://man7.org/linux/man-pages/man8/ip-rule.8.html ip-rule Manpage] um die Abarbeitung von Regeln mit mehreren Routing-Tabellen zu verstehen.
* Vergewisser dich ob der Broadcast-Adresse deines Adhoc-Interfaces. Mit ''ip addr add'' stimmte manchmal was nicht.


    if node==nil or node=="" then print("ERROR"); return -1 end
=== Starten ===
    node=tonumber(node)
    if node==nil then print("ERROR"); return -1 end
    if node < 0 or node > ipcalc.data.max then return -1 end
    ipcalc.calc(node)


    for k,v in pairs(ipcalc.data) do
<pre>bmxd dev=adhoc0</pre>
        print("export _ddmesh_"..k.."="..v)
    end
end


--not needed for ip address calculation
Der Routing-Daemon daemonisiert sofort und schreibt ins Syslog. Mit <code>bmxd -c</code> kann man sich nun zu ihm verbinden und Informationen entlocken (siehe [[#Nützliches]]).
function iplookup(ip)
if ip==nil then return -1 end
n=ipcalc.rCalcIp(ip)
if n == -1 then return -1 end
ipcalc.calc(n)
return ipcalc.data.hostname
end


--not needed for ip address calculation
Geht alles glatt, legt er seine Routen in den Tabellen 64 & 65 ab. Das bedeuetet, dass ein einfacher ''ip r''-Aufruf keine Meshadressen anzeigt. Erst ''ip route show table all'' bringt sie zum Vorschein. Diese Routing Tabellen werden bevorzugt, da bmxd entsprechende ''ip rule''-Regeln mit höherer Präferenz als der default-Tabelle anlegt.
function lookup(node)
if node==nil then return -1 end
if string.sub(node,1,1) == "r" then
n=tonumber(string.sub(node,2))
else
n=tonumber(node)
end
if n==nil then return -1 end
if n < 0 or n > ipcalc.data.max then return -1 end
ipcalc.calc(n)
return ipcalc.data.ip
end
</source>
----
== Metadaten ==


=== Freifunk-API ===
=== Nützliches ===
 
Es existiert eine Inter-Community-API analog zur SpaceAPI. Beispiel: [http://cholin.spline.de/freifunk/api-viewer/ Freifunk API Viewer]
 
[https://github.com/freifunk/directory.api.freifunk.net/blob/master/directory.json Directory.json], [http://info.ddmesh.de/info/freifunk.json Dresden]
 
=== Knotenmetadaten ===


Jeder Knoten bietet ein JSON-Dokument unter http://10.200.../sysinfo-json.cgi an. Es enthält Versionsstände, Geokoordinaten, Kontaktinfo, Auslastung und alle Routen.
;Ausführliche Hilfe:
:<pre>bmxd -x</pre>
;Aktuelle Routen
:<pre>bmxd -cid8</pre>
;Aktuelle empfangene HNAs (''Host and Network Association'', Subnetze)
:<pre>bmxd -c --hnas</pre>
;HNA ankündigen
:<pre>bmxd -c -a 172.22.99.0/24</pre>


== Wiki ==
== Wiki ==
Zeile 327: Zeile 196:
* [[wikipedia:de:Freifunk]]
* [[wikipedia:de:Freifunk]]
* [https://wiki.freifunk.net/Freifunk_Dresden freifunk:Freifunk Dresden]
* [https://wiki.freifunk.net/Freifunk_Dresden freifunk:Freifunk Dresden]
* [[Freifunk]]
* Planung zu [[Datenspuren 2014/Freifunk Dresden | Freifunk bei den Datenspuren 2014]]
* Planung zu [[Datenspuren 2014/Freifunk Dresden | Freifunk bei den Datenspuren 2014]]
* [[Freifunk Dresden]] bei den [[Datenspuren]]
* [[Freifunk Dresden]] bei den [[Datenspuren]]
Zeile 348: Zeile 218:


[[Kategorie:Projekt]]
[[Kategorie:Projekt]]
[[Kategorie:Dresden]]

Version vom 12. Dezember 2018, 09:42 Uhr

Freifunk Dresden ist das Projekt in Dresden zu wikipedia:de:Freifunk. Das Freifunk-Netz Dresden ist ein von Freiwilligen betriebenes freies WLAN-Netzwerk. Ziel ist es, Dresden flächendeckend mit Freifunk zu versorgen.[1]

Entstehung

Freifunk Dresden wurde ursprünglich unter dem Namen ddmesh von Stephan Enderlein gestartet und existiert bereits seit einigen Jahren.

Seit 2014 sind durchgängig mehr als 50 Knoten in Dresden erreichbar und auch Geschäfte in Dresden nehmen die Vorteile von Freifunk für sich und ihre Kunden wahr.

Mitmachen

Um Teil des Freifunk-Netzwerkes zu werden, braucht man sowohl einen handelsüblichen Router als auch die passende Freifunk-Firmware-Version dazu.

Firmware

Seit 2014-12-03 steht die Firmware zur Verfügung.

Die Firmware-Dateien sind nach den unterstützten Geräten benannt. Der Name einer Firmware-Datei setzt sich als openwrt-ar71xx-generic-ROUTERNAME-squashfs-ZUSATZ.bin zusammen.

So ist beispielsweise die Datei openwrt-ar71xx-generic-tl-wr841n-v8-squashfs-factory.bin für einen Router
  • des Modells TL-WR841N
  • in der Version 8 (der Hardware)
    siehe Etikett auf der Unterseite des Gerätes.
  • Factory bedeutet, dass diese Firmware-Datei für die Erstinstallation der Freifunk-Firmware auf einem Gerät verwendet werden muss, auf dem sich bisher noch eine andere Firmware befindet, meist die Original-Firmware des Herstellers.
Beim Dateinamen openwrt-ar71xx-generic-tl-wr841n-v8-squashfs-sysupgrade.bin bedeutet der Zusatz Sysupgrade hingegen, dass diese Datei zum Updaten eines bereits für den Dresdner Freifunk im Einsatz befindlichen Routers ist.

Ausführliche Erklärungen zur Konfiguration der Firmware sowie alle anderen Informationen bezüglich Freifunk Dresden, werden im Wiki (wiki.freifunk-dresden.de) gepflegt.

Router

Wie der Firmware-Liste zu entnehmen ist, gibt es eine Vielzahl an Freifunk-kompatiblen Routern. Allerdings erfreuen sich bestimmte Modelle in Dresden meist insbesondere wegen der günstigen Anschaffungskosten besonderer Beliebtheit.
Eine aktuelle Übersicht wird im Wiki von Freifunk Dresden gepflegt Router.

Geräte-Name Hersteller Preis (€) RAM (MB) ROM (MB) Beschreibung
TL-WR841N TP-Link 16-20 32 4 Im Unterschied zum Modell mit der Endung ND mit nicht abnehmbaren Antennen ausgestattet.
TL-WR841ND TP-Link 20-29 32 4 D steht für detachable, der Router besitzt also abnehmbare Antennen.
TL-WDR3600 TP-Link 40- 128 8 mehr Speicher, USB Anschlüsse, auch 5 GHz, 2 abnehmbare Antennen
TL-WDR4300 TP-Link 45- 128 8 mehr Speicher, USB Anschlüsse, auch 5 GHz, 3 abnehmbare Antennen
Nanostation M2 loco Ubiquiti 40- 32 8 2,4 GHz Richtfunk, Outdoor, 60° Öffnungswinkel, Power over Ethernet + Injector

Auch interessant für weitere Bastelarbeiten: vocore

Standorte

Das Netz von Freifunk Dresden erstreckt sich nicht nur über Dresden selbst, sondern ist mittlerweile vereinzelt u. a. in

  • Coswig,
  • Freital,
  • Meißen,
  • Radeberg und
  • Radebeul

zu finden. Detaillierte Standortinformationen sind auf der Freifunk-Karte einsehbar.

Neben den festen Standorten gibt es Freifunk auch auf Veranstaltungen, wie z. B. Weihnachtsmärkten.

Original-Firmware

Die Firmware basiert auf OpenWrt mit BMX (Alternativentwicklung basierend auf batmand) und einer custom Weboberfläche.
Das Routingprotokoll batman-adv wird hier nicht verwendet und wurde parallel zu BMX mit einem komplett anderen Ziel entwickelt.

Nutzung der Original-Firmware hat folgende Vorteile:

  • Konsistente Konfiguration mit fast allen anderen Teilnehmern
  • Anschluß ans Backbone-VPN (vtun)
  • Offenes WLAN, welches über das Backbone ins Internet kommt (alternativ durch zusätzliche Pakete ein eigener VPN-Dienst konfigurierbar)
  • Webserver der die Knotenmetadaten ausliefert (automatische Knotenregistrierung)

Freie Software und Peering

Die Software ist frei und kann durch die Quellen von OpenWRT und die Sourcen zu Änderungen von der Freifunk-Seite eingesehen werden. Konfiguration und Scripte sind in den Images zu finden oder auf GitHub (Licensen beachten).
Die Dokumentation zum Bau eigner Firmware Images und Alternativ-Knoten sind im Aufbau.

Da zu Freie Software für viele von uns auch der freie und möglichst barrierefreiem Zugang zu weiteren Informationen zählt, wollen wir diesen Umstand ändern - auch um Freifunk noch besser machen zu können. Im Widerspruch dazu steht das berechtigte Interesse der bisherigen Freifunk-Teilnehmer auf einen Störungsfreien Betrieb und infolgedessen Imageschaden bei den normalen Benutzern, der durch Experimente mit alternativer Firmware gefährdet sein könnte - das Marketing für Freie Software sowie für Freifunk selbst sind leider schwierig.

Ideen dazu werden diskutiert, um die jetzigen Betreibenden in Blick auf offenem Zugang zu Informationen zu überzeugen.

Technische Informationen

Grundsätzlich soll das Wiki Freifunk Dresden Informationen, insbesondere auch technische Informationen, bereitstellen. Das ist wohl aber noch nicht der Fall und soll wohl in Arbeit sein.

Quellcode

Der Quellcode soll auf #GitHub verfügbar sein. Dies gilt insbesondere für die #Firmware.[2]

mögliche Probleme beim Betrieb der Technik

Metadaten

Freifunk-API

Es existiert eine Inter-Community-API analog zur SpaceAPI. Beispiel: Freifunk API Viewer

Directory.json, Dresden

Knotenmetadaten

Jeder Knoten bietet ein JSON-Dokument unter http://10.200.../sysinfo.json an. Es enthält Versionsstände, Geokoordinaten, Kontaktinfo, Auslastung und alle Routen.

IPv4-Meshing mit bmxd

BMXD is eine "expermientelle" Variante von b.a.t.m.a.n, welche rundsätzlich intern ähnlich funktioniert, aber zusätzliche Konfigurationen des Routings erlauben. Zusätzlich nutzt diese Varinate drei Routing-Tabellen, wodurch ein geziehltes Definieren von Routing-Regeln möglich ist. Dieses kann dazu verwendet werden, Angriffe auf das Routing und dann das Umleiten von Traffic zu verhindern. Das war auch das Entscheidungkriterium für dieses Protokoll.

Allderdings wird dieses Protokoll (bmxd) nicht mehr vom Author weiterentwicklet oder verbessert. Eine Weiterentwicklung ist auch nicht nötig, wenn alle Funktionalitäten erfüllt werden.

Während des Betriebs von Freifunk Dresden mit BMXD und der Testungsdurchläufen, sind allerdings einige Programmierfehler sichtbar geworden. Diese wurden dann direkt in den Quellen von Freifunk Dresden, welches die Sourcen von bmxd enthält, korregiert.

Die letzten Änderungen betreffen sogar den Rausschmiss einiger Funktionalitäten, um Speicher zu sparen und Datendurchsätze zu verdreifachen.

Sicherlich ist es möglich, eigene Firmwares mit dem Protokoll zu bauen und ins Freifunk Dresden Netzwerk einzubinden. Allerdings sind einige logische und organisatorische Bedingungen zu erfüllen und strickt einzuhalten. Wenn das nicht erfolgt, ist es garantiert, dass das Freifunk Netz damit gestört wird. Einen Schutz dagegen, kann BMXD und deren Varianten nicht erfüllen.

https://wiki.freifunk-dresden.de/index.php/Knoten_Spezifikation

Bauen

Code, letzte Commits im Feb 2011, gibts auf Github.

git clone git://github.com/axn/bmxd.git
cd bmxd
make -j5
strip bmxd  # Spart Platz

Voraussetzungen

  • Lies die ip-rule Manpage um die Abarbeitung von Regeln mit mehreren Routing-Tabellen zu verstehen.
  • Vergewisser dich ob der Broadcast-Adresse deines Adhoc-Interfaces. Mit ip addr add stimmte manchmal was nicht.

Starten

bmxd dev=adhoc0

Der Routing-Daemon daemonisiert sofort und schreibt ins Syslog. Mit bmxd -c kann man sich nun zu ihm verbinden und Informationen entlocken (siehe #Nützliches).

Geht alles glatt, legt er seine Routen in den Tabellen 64 & 65 ab. Das bedeuetet, dass ein einfacher ip r-Aufruf keine Meshadressen anzeigt. Erst ip route show table all bringt sie zum Vorschein. Diese Routing Tabellen werden bevorzugt, da bmxd entsprechende ip rule-Regeln mit höherer Präferenz als der default-Tabelle anlegt.

Nützliches

Ausführliche Hilfe
bmxd -x
Aktuelle Routen
bmxd -cid8
Aktuelle empfangene HNAs (Host and Network Association, Subnetze)
bmxd -c --hnas
HNA ankündigen
bmxd -c -a 172.22.99.0/24

Wiki

Siehe auch

Weblinks

Einzelnachweise