Installation¶

Falls noch nicht vorinstalliert, werden die folgenden Pakete benötigt ^[1]:

• usb-modeswitch

• usb-modeswitch-data

Befehl zum Installieren der Pakete:

sudo apt-get install usb-modeswitch usb-modeswitch-data 

Oder mit apturl installieren, Link: apt://usb-modeswitch,usb-modeswitch-data

Welche Version in Ubuntu enthalten ist, erfährt man über die Ubuntu Paketsuche 🇬🇧. Das kann insbesondere hilfreich sein, wenn Systeme mit nicht funktionierendem Internetzugang mit manuell heruntergeladenen Paketen versorgt werden müssen.

Da sich das Programm in ständiger Weiterentwicklung befindet, sollte bei Problemen mit der eigenen Hardware das Programm unter Umständen selbst aus dem Quelltext übersetzt (kompiliert) werden.

sudo apt-get install build-essential libusb-dev 

Funktionsweise¶

Für die automatische Erkennung werden folgende Bestandteile verwendet:

• /usr/sbin/usb_modeswitch - Das eigentliche Programm

• /lib/udev/usb_modeswitch - Ein Wrapper-Skript, welches das eigentliche Programm verwendet, um weitere ID-Prüfungen vorzunehmen und den Treiber zu laden

• /lib/udev/rules.d/40-usb_modeswitch.rules - Die udev-Regel, die das Wrapper-Skript startet, wenn eine bekannte USB-ID erkannt wird

• /etc/usb_modeswitch.conf - Globale Einstellungsdatei; hier kann das ausführliche Mitloggen des Umschaltvorganges aktiviert oder die Umschaltung komplett deaktiviert werden (falls man auf den Windows-Installationsspeicher zugreifen möchte).

• /etc/usb_modeswitch.d und /usr/share/usb_modeswitch (ab Ubuntu 11.04) - Ein Verzeichnis, welches die spezifischen Setup-Informationen für die Geräte beinhaltet, jeweils nach den USB-IDs benannt, ggf. mit weiteren Merkmalen, wenn es zu bekannten Überschneidungen bei gleicher ID kommt. Wenn die USB-ID eines Gerätes in einem Namen dieser Liste auftaucht, bestehen gute Chancen, dass das Gerät unterstützt wird, selbst wenn dort ein anderer Hersteller/anderes Modell angegeben ist. Eine Zusammenstellung aller Konfigurationen wird unter dem Namen device_reference.txt 🇬🇧 auf der Projektseite zur Verfügung gestellt.

Die Bestandteile arbeiten folgendermaßen zusammen:

Wenn ein Gerät eingesteckt wird, sucht, und ggf. findet, das udev-System das Gerät in den Regeln der 40-usb_modeswitch.rules. Es startet das Wrapper-Skript über ein weiteres bash-Skript im Hintergrund. Dieses Wrapper-Skript extrahiert einige Parameter zur Beschreibung des Geräts aus udev und sammelt einige weitere Informationen, um sicherzustellen, dass das Gerät richtig erkannt wird. Leider reichen die USB-IDs alleine dafür nicht aus. Das Programm wird dann vom Wrapper-Skript mit dem (hoffentlich) richtigen Konfigurationsdateinamen als Parameter gestartet und führt den eigentlichen Modus-Wechsel durch. Bei Erfolg wird die (neue) Ziel-ID an das Wrapper-Skript übergeben, welches daraufhin überprüft, ob mit dem umgeschalteten Gerät Treiber/Module verbunden gewesen sind, indem es nach "ttyUSB" oder "ttyACM"-Einträgen in /dev sucht. Wenn keine solchen gefunden wurden, wird das "option"-Modul mit "modprobe" geladen (Fehler werden, weil sie hinein kompiliert sein könnten, ignoriert). Dann wird die USB-ID des umgeschalteten Geräts dem Treiber als "new_id" übergeben.

Danach sollte das System das neue serielle Gerät automatisch erkennen. Nach Angaben des Entwicklers entsteht kein Schaden an der Hardware, wenn der Prozess fehlschlägt. Das Umschalten bzw. die Erkennung des umgeschalteten Gerätes kann allerdings einige Zeit (teilweise bis zu einer Minute) in Anspruch nehmen. Das ist alleine von der eingebauten Firmware abhängig.

Bekannte Probleme¶

Bei WLAN-Geräten kam es in der Vergangenheit zu Problemen mit dem NetworkManager, insbesondere der ModemManager-Komponente, die in Verbindung mit USB-Modems nicht sonderlich zuverlässig war. Vernünftige Resultate wurden dagegen mit dem Kommandozeilenprogramm wvdial erzielt, sowie mit verschiedenen Anwendungen, die eine Benutzerschnittstelle über PPP bereitstellen. Die Verwendung einiger der Programme erfordert allerdings etwas Vorwissen.

Die größte Hürde zur vollautomatischen Verwendung eines "umgeschalteten" Gerätes ist es, den richtigen Port für die Verbindung zu finden. Oft werden mehrere serielle Ports erstellt (teilweise bis zu fünf). Welches der richtige ist, lässt sich entweder über "Versuch und Irrtum" herausfinden, oder man findet den Port, der mit Interrupt-Transfer arbeitet. Das schaffte der NetworkManager leider nicht, und eine manuelle Wahl des Ports liess er auch nicht zu.

Beispiel¶

sudo usb_modeswitch -v 12d1 -p 1c0b -M '55534243123456780000000000000011062000000100000000000000000000' 

sudo modprobe option
echo "12d1 1c05" | sudo tee /sys/bus/usb-serial/drivers/option1/new_id 

# eigene udev-Regeln für UMTS-Sticks 
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="12d1", ATTRS{idProduct}=="1c0b", RUN+="/usr/sbin/usb_modeswitch -v 12d1 -p 1c0b -M '55534243123456780000000000000011062000000100000000000000000000'"
ACTION=="add", SUBSYSTEM=="usb", ATTRS{idVendor}=="12d1", ATTRS{idProduct}=="1c05", RUN+="/bin/bash -c 'modprobe option && echo 12d1 1c05 > /sys/bus/usb-serial/drivers/option1/new_id'"

Unterstützte Geräte¶

Die Liste bitte um andere unter Ubuntu getestete Geräte erweitern! Auch der Entwickler von USB ModeSwitch bittet darum, bisher nicht unterstützte Hardware zu melden. Er gibt außerdem Hilfestellung zur Ermittlung des Umschaltkommandos, wenn es noch nicht bekannt ist (siehe Link zum Support-Forum).

Links¶

• Projektseite 🇬🇧

  • Support-Forum 🇬🇧