Deutsch (Deutschland) 
English (United Kingdom) Du benötigst eine Micro SDHC Class 4 Speicherkarte mit einer Grösse von 8GB.
Darauf wird nun ein Firmware-Image aufgespielt.
Wähle eines der beiden Images passend für deinen Bedarf aus (Version 1.1.0, build 08.07.2025):
Image für die Standard-Variante mit 21 Matrix-Modulen: 
Image für die Mini-Variante mit 9 Matrix-Modulen und optionalem MiniBoss DAC:
Das Betriebssystem der RoonMatrix basiert auf Linux raspberrypi 6.1.21-v7+, OS Nickname: raspbian bullseye.
Das Zip muss nun entpackt werden. Danach erfolgt das kopieren des Image auf die 8GB Micro SD Speicherkarte.
Unter macOS geht das folgendermassen:
- Stecke die Speicherkarte in einen USB Kartenleser deiner Wahl.
- Verbinde nun den Kartenleser mit einem freien USB-Port des Computers.
- Öffne ein Terminal.
- Zeige alle Laufwerke mit ihren Bezeichnern an:
diskutil list. - Suche hier nach einem passenden Laufwerk mit 8GB Grösse.
- Den Bezeichner (z.B.
/dev/disk21) verwenden wir nun im nächsten Befehl. - Navigiere zum Ordner mit dem Image, z.B:
cd /Users/benutzer/Downloads/ - Der Befehl um das Image auf die Karte zu schreiben:
sudo dd if=roonmatrix-std-distribution-20241025.img of=//dev/disk21 bs=4M - Das kopieren kann einige Minuten dauern. Wenn der Befehl abgeschlossen ist, erscheint im Terminal eine neue Befehlszeile.
- Danach sollte der Befehl '
diskutil list' die Speicherkarte anzeigen. Diese sollte nun eine Linux-Partition enthalten und in etwas so aussehen:
- Die Vorgehensweise um das Image auf die Speicherkarte zu bekommen, sollte unter Linux sehr ähnlich funktionieren. Unter Windows benötigt man ein Programm oder einen passenden Kommadozeilenbefehl, welches ein Image auf eine Speicherkarte schreiben kann.
Nun muss noch der Name (ssid) und das Passwort deines WLANs angegeben werden, damit die roonmatrix sich mit deinem WLAN verbinden kann.
Hierfür gibt es bereits eine vorbereitete Datei, die du auf der Speicherkarte im Hauptverzeichnis des Laufwerks boot finden kannst.
Diese Datei wird nach dem ersten Start der RoonMatrix von der Speicherkarte automatisch in ein anderes Verzeichnis verschoben. Für mögliche nachfolgende Änderungen am WLAN Namen, oder des Passwortes, musst du daher die Datei wpa_supplicant.conf im Hauptverzeichnis von boot neu anlegen.
Der Inhalt der Datei sieht folgendermassen aus:
ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
update_config=1
country=DE
network={
ssid="replace-here-your-wlan-ssid-name"
psk="replace-here-your-wlan-password"
}
An den Stellen die mit "replace-here" anfangen, hier bitte die entsprechenden Daten für das WLAN eintragen.
Danach die Datei wpa_supplicant.conf auf der Speicherkarte im Hauptverzeichnis der SD-Karte speichern.
Nun kann die Speicherkarte ausgeworfen, und in die Roonmatrix eingesteckt werden. Danach kann die RoonMatrix zum ersten Mal eingeschaltet werden.
Das Gerät sollte sich nun per DHCP eine IP-Adresse vom WLAN Router abholen, und im Router in der Liste der WLAN-Geräte sichtbar sein.
Hier ein Beispiel wie das auf einer FritzBox aussieht:
Das Python Script und die Konfigurationsdatei
Die Roonmatrix wird im wesentlichen über ein Python 3 Script gesteuert, welches sich bereits vorkonfiguriert auf der Speicherkarte befindet.
Wer sich dafür interessiert, und es vielleicht mit weiteren nützlichen Funktionen erweitern möchte, kann sich hier gerne austoben.
Die Datei roonmatrix.py befindet sich im FTP-Ordner. Um dorthin zu navigieren, gebe nach dem SSH Login folgendes im Terminal ein: cd FTP
Wer sich an der Weiterentwicklung beteiligen möchte, ist hiermit herzlich eingeladen dies zu tun.
Das Script befindet sich auf Github: roonmatrixdevice