Freifunk Dresden

Aus C3D2
Version vom 12. Dezember 2014, 11:13 Uhr von Ddmesh (Diskussion | Beiträge) (Link zum Anwender Wiki (Firmware Beschreibung) hinzugenommen)
Zur Navigation springen Zur Suche springen
b0rk3d

Teile des folgenden Inhalts sind nicht korrekt. Begründung: Technische Details depubliziert unter Intern:Freifunk_Dresden. Nicht überall wo Freifunk draufsteht ist auch freies Wissen drin. :-(

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

Die aktuelle Versionsnummer der Dresdner Freifunk-Firmware lautet 2.1.5 (vom 03.12.2014). Die entsprechende Datei kann hier heruntergeladen werden. Die Firmware-Dateien sind nach den unterstützten Geräten benannt. Der Name einer Firmware-Datei setzt sich wie folgt zusammen:

openwrt-ar71xx-generic-ROUTERNAME-squashfs-ZUSATZ.bin

So ist die Datei

openwrt-ar71xx-generic-tl-wr841n-v8-squashfs-factory.bin

für einen Router mit der Bezeichnung TL-WR841N in der Hardware-Version 8 (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 Firmware finden sich im Anwender Wiki (wiki.freifunk-dresden.de).

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:

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

Original-Firmware

Die Firmware basiert auf OpenWrt mit BMX (Vorläufer von batman-adv) und einer custom Weboberfläche.

Nutzung der wenig dokumentierten 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

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. Eine komplette Öffnung des Projektes ist bisher nicht vorgesehen gewesen, sodass u.a. eine Anleitung zum Selbstbau der Firmware fehlt und die Dokumentation so gut wie nicht vorhanden ist.

Da zu [Freier Software|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 derzeit diskutiert um die jetzigen Betreiber in Blick auf offenem Zugang zu Informationen zu überzeugen.

Links

WLAN-Einstellungen

Wird derzeit Intern beschrieben.

Adressvergabe

IP-Adressberechnungs mit Shell- und Lua Script

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.

Die Scripte deren Algorithmus formalisiert werden soll:

usr/bin/ddmesh-ipcalc.sh
#!/bin/sh

if [ "$1" = "" ]
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
	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
usr/lib/lua/ddmesh.lua
--[[----------------------------------------------------------------------------------------
ddmesh.lua
library for different freifunk functions
version: 6
-------------------------------------------------------------------------------------------]]

----------------- ipcalc ---------------
ipcalc={}
ipcalc.data={}
ipcalc.data.max=2048

function split(str, delim, maxNb)
    -- 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)
    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]
    if a[2]=="201" then middle = middle + 256 end
    minor = math.floor(a[4]/64) --x>>6
    node = middle*4+minor	--x<<2
    if node < 0 or node > ipcalc.data.max then return -1 end
    return node
end

function ipcalc.calc(node)
    --node has to be a number n \in N_0, 0 <= n <= 2048
    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"

    --Ternary Operator in use
    -- 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"
    local nodeip  	= meshnet .. "." .. major .. "." .. middle .. "." .. minor + 1
    local meshnetmask	= "255.0.0.0"
    local meshpre 	= 15
    local meshbroadcast = "10.255.255.255"
    local meshnetwork   = "10.200.0.0"

    local dhcpstart     = meshnet .. "." .. major .. "." .. middle .. "." .. minor + 2
    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
    local mesh6pre	= "48"
    local mesh6net	= "fd11:11ae:7466::"
    -- client range
    local mesh6nodenet= "fd11:11ae:7466:" .. string.format("%x", node) .. "::"
    local mesh6ip	= mesh6nodenet .. "1"
    local mesh6nodepre= "64"

    -- preparing variabled to be expoted
    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)

    if node==nil or node=="" then print("ERROR"); return -1 end
    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
        print("export _ddmesh_"..k.."="..v)
    end
end

--not needed for ip address calculation
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
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

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.cgi an. Es enthält Versionsstände, Geokoordinaten, Kontaktinfo, Auslastung und alle Routen.

Einzelnachweise

  1. Seite des Freifunk Dresden

Siehe auch

Weblinks