Willkommen      Zaurus      Projekte      Dokumente      Kontakt   

  Mac OS X USB-Treiber  

  Mac OS X Cross-Compiler  

  Mac OS X Tools für Qtopia  

  Qtopia unter Mac OS X (Mini-Tutorial)  
    

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

Bitte beachten: Die weitere Entwicklung des Treibers findet bei DSITRI statt. Bitte informieren Sie sich dort über aktuelle Entwicklungen und neue Versionen: http://www.dsitri.de/wiki.php?page=AJZaurusUSB

Hier finden Sie einen USB-Treiber, um Linux-PDAs mit einem Rechner zu verbinden, auf dem Mac OS X läuft. Er erlaubt es, Daten per USB zu übertragen, so dass man keine Netzwerkkarte für den PDA braucht. Die folgenden Modelle werden unterstützt (mit den Problemen, die weiter unten erwähnt werden):

  • Sharp Zaurus SL-5500G, SL-5600, SL-6000, SL-A300, SL-B500, SL-C700, SL-C760 und SL-C860 (entweder mit dem Original Sharp ROM oder mit OpenZaurus)
  • Compaq iPaq H3635, H3760, H3870, H3950 unter Familiar Linux
  • YOPY YP3000 und YP3700
Auf dem Mac muss mindestens OS X 10.2.1 laufen.

Hinweis: Es handelt sich nicht um eine komplette Synchronisationslösung! Das einzige, was der Treiber ermöglicht, ist eine Netzwerk-Verbindung.

Dieser Treiber basiert auf dem USBCDCEthernet-Beispiel von Apple (dankeschön an Russ Winsper, der mir die neueste Version zur Verfügung gestellt hat). Teile wurden portiert von usbdnet.c (Linux-Treiber), der von Stuart Lynne und Tom Rushworth geschrieben wurde, wobei einige Algorithmen aus usbnet.c von David Brownell übernommen wurden. Die eMail-Adressen dieser Autoren sind im Quelltext des Treibers zu finden (Download am Ende dieser Seite).

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

27.09.2004

Neue Version 0.2.8 des Treibers:
  • Unterstützung für den Zaurus SL-6000.
  • Korrekturen für mögliche Probleme aufgrund uninitialisierter Variablen (Dank an Dr H. Nikolaus Schaller für den Patch).

12.09.2004

Neue Version 0.2.7 des Treibers:
  • Bugfix für Mac OS X 10.3.5. Mit der Vorversion kamen sich Apple-eigene Treiber mit dem Zaurus-Treiber ins Gehege. Achtung: Ich habe diese Version weder mit OS X 10.2.x noch mit anderer Hardware als einem Zaurus SL-5500 getestet! Bitte melden Sie sich, wenn es Probleme gibt.
  • Vor der Installation sollten Sie die alte Version von "AJZaurusUSB.kext" im Verzeichnis "/System/Library/Extensions" löschen.

31.10.2003

Neue Version 0.2.5 des Treibers:
  • Bugfix für Mac OS X 10.3 (Panther). Wenn der Zaurus in schneller Folge an- und ausgeschaltet wird, können die vorherigen Versionen dazu führen, dass das USB-Subsystem auf dem Mac einfriert. Eventuell kann der Effekt auch unter OS X 10.2 (Jaguar) auftreten, so dass ein Update auf die Treiberversion 0.2.5 auf jeden Fall zu empfehlen ist.

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

Achtung: Dieser Treiber könnte Ihr Betriebssystem beschädigen oder es am Booten hindern (obwohl beides sehr unwahrscheinlich ist). Sie benutzen diese Software auf eigenes Risiko! (Allerdings sagt diese Seite, dass der Treiber, zumindest für den SL-5600, "von Sharp zertifiziert" ist; er scheint also nicht allzu kaputt zu sein ;-))

Die Installation ist sehr einfach:

  1. Laden Sie das komprimierte Installer-Paket herunter (zu finden am Ende dieser Seite). Doppelklicken Sie auf die heruntergeladene Datei, um das enthaltene Installer-Paket zu extrahieren.
  2. Doppelklicken Sie auf das entpackte Paket ("AJZaurusUSB.pkg") und folgen Sie den Anweisungen auf dem Bildschirm. Der Installer kopiert das Verzeichnis "AJZaurusUSB.kext" nach "/System/Library/Extensions".
  3. Starten Sie den Rechner am Ende der Installation neu (der Installer wird Sie dazu auffordern).
  4. Schließen Sie die Basisstation des Zaurus an einen freien USB-Port an, stecken Sie den Zaurus in die Basisstation und schalten Sie ihn ein.
  5. Starten Sie die Anwendung "Systemeinstellungen" und wählen Sie "Netzwerk" aus. Daraufhin erscheint eine Meldung, dass ein neuer Netzwerkanschluss gefunden wurde.
  6. Stellen Sie die Konfiguration des neuen Netzwerk-Anschlusses auf "Manuell" und geben Sie als IP-Adresse 192.168.129.1 ein. Klicken Sie anschließend auf "Jetzt aktivieren".
  7. Öffnen Sie die Terminal-Anwendung und versuchen Sie, den Zaurus anzupingen. Normalerweise ist die Adresse 192.168.129.201, aber das kann am Zaurus geändert werden (ich habe allerdings alle Tests mit dieser Adresse durchgeführt). Wenn der Ping funktioniert, dann war die Installation erfolgreich. Wenn nicht, lesen Sie bitte den FAQ-Abschnitt weiter unten. Sollte das auch nicht helfen, können Sie mir eine eMail schicken, damit ich versuchen kann, die Ursache des Problems zu finden.
Auf dem Zaurus SL-5500 läuft ein FTP-Server auf Port 4242, der benutzt werden kann, um Dateien hin und her zu schicken (Benutzer "root", leeres Passwort). Die Kommandozeilen-Syntax, um eine solche FTP-Verbindung aufzubauen, sieht folgendermaßen aus:
  ftp -P 4242 192.168.129.201
Auf den neueren Zaurus-Modellen (und auf dem SL-5500 mit ROM-Version 3.x) läuft ein SMB-Server, so dass Sie den Befehl "Mit Server verbinden" im Finder benutzen können. Als URL können Sie "smb://192.168.129.201" angeben - alternativ funktioniert auch "smb://sla300" für den SL-A300 und "smb://zaurus" für den SL-5600 (die URLs für andere Modelle kenne ich nicht). Geben Sie "guest" als Benutzername ein und lassen Sie das Passwort leer - in meinen Tests hat allerdings auch jede andere Kombination von Benutzername und Passwort funktioniert.

Um den Treiber zu entfernen, löschen Sie einfach den Ordner "AJZaurusUSB.kext" im Verzeichnis "/System/Library/Extensions".

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

Die folgenden Probleme und Fehler sind bekannt:

  • Es gibt einen Bug in OS X 10.2.2 bis 10.2.6 (und möglicherweise 10.2.8, aber nicht 10.3), der zu Netzwerk-Problemen führt, wenn der Treiber benutzt wird. Beispielsweise kann Apple Mail unter Umständen keine eMail mehr empfangen. Es gibt allerdings Möglichkeiten, dieses Problem zuverlässig zu umgehen:
    1. Wenn Sie eine Wählverbindung ins Internet benutzen, trennen Sie diese und bauen Sie sie anschließend neu auf.
    2. Wenn Ihre Internet-Verbindung über Ethernet läuft (z. B. DSL) müssen Sie das entsprechende Netzwerk-Interface neu starten (Danke an Geoff Beier, der auf diese Idee kam). Öffnen Sie dazu die Terminal-Anwendung und geben Sie die folgenden Kommandos ein (jeweils mit <Enter> abgeschlossen):
        sudo ifconfig en0 down
        sudo ifconfig en0 up
      Sie werden dabei nach einem Passwort gefragt. Dabei handelt es sich um Ihr Administrator-Passwort (das gleiche, das Sie bei der Treiber-Installation angeben mussten). Wenn Ihre Internet-Verbindung nicht über das primäre Netzwerk-Interface läuft, müssen Sie en0 in den Kommandos entsprechend ersetzen.
    3. Wenn Ihr Internet-Zugang über AirPort läuft, können Sie auch AirPort deaktivieren und wieder aktivieren (Danke an Matthew Hixson für diesen Tip).
    Anschließend können Sie Mail wieder benutzen, bis sich der Status des Zaurus ändert (z. B. wenn Sie ihn einschalten).
  • Wenn Sie auf der Bildschirmtastatur tippen, während Daten übertragen werden, hängt sich der Treiber auf. Um das zu beheben, entfernen Sie den Zaurus (oder schalten Sie ihn aus) und schließen Sie ihn anschließend wieder an.
  • Die USB-Verbindung ist von der Zaurus-Seite her recht instabil. Dafür sind wahrscheinlich Probleme im USB-Controller verantwortlich, die nicht ohne weiteres umgangen werden können. Die Übertragung kleiner Datenmengen funktiniert üblicherweise problemlos, aber ich bin auf verschiedene Probleme gestoßen bei dem Versuch, mehrfach eine 16 MB große Datei zu übertragen (plötzlicher Zaurus-Reboot, eingefrorener Zaurus, kaputte Datei). Unter Windows passiert genau das gleiche, es ist also kein Mac-spezifisches Phänomen. Ausserdem hatte ich für meine Tests nur einen Zaurus SL-5500G zur Verfügung - andere Modelle sind möglicherweise stabiler.

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

F   Es funktioniert nicht. Was nun?

A   Prüfen Sie als erstes, ob die folgenden Bedingungen erfüllt sind:

  1. Der Zaurus ist ein Modell SL-5x00, SL-A300, SL-B500, SL-C700, SL-C760 oder SL-C860. Wenn das nicht der Fall ist, müssen Sie die Info.plist von /System/Library/Extensions/AJZaurusUSB.kext manuell um eine IOKit-Personality mit passender Product- und Vendor-ID ergänzen.
  2. Auf dem Mac läuft mindestens OS X Version 10.2.
  3. Der Treiber ist korrekt installiert. Das ist dann der Fall, wenn die Kernel-Extensions AJZaurusUSB.kext in /System/Library/Extensions vorhanden ist.
  4. Sie haben den Mac nach der Treiber-Installation neu gestartet.

 

F   Es erscheint keine neue Netzwerk-Schnittstelle in den Systemeinstellungen.

A   Die neue Schnittstelle wird nur erkannt, wenn die Systemeinstellungen-Anwendung gestartet wird, nachdem der Zaurus angeschlossen und eingeschaltet wurde. Die folgenden Schritte sollten funktionieren:

  1. Wenn die Systemeinstellungen bereits gestartet sind, beenden Sie sie.
  2. Wenn der Zaurus bereits angeschlossen und eingeschaltet ist, schalten Sie ihn aus.
  3. Schließen Sie anschließend den Zaurus an und schalten Sie ihn ein.
  4. Warten Sie einige Sekunden.
  5. Starten Sie die Systemeinstellungen.
  6. Klicken Sie auf "Netzwerk".
Sie sollten jetzt eine Nachricht bekommen, dass eine neue Netzwerk-Schnittstelle gefunden wurde. Selbst wenn diese Nachricht nicht erscheint, sollten Sie nachsehen, ob die Schnittstelle vorhanden ist (normalerweise ist ihr Name "Ethernet (en1)" oder "Ethernet (en2)"). Wenn es keine solche Schnittstelle gibt, lesen Sie bitte die nächste Frage.

 

F   Mein Mac ist abgestürzt (mit einer Meldung, ich solle den Computer ausschalten).

A   Ich habe versucht, alle Probleme zu beseitigen, die zu einem Absturz führen könnten, aber es gibt natürlich keine Garantie, dass ich an alles gedacht habe. Bitte senden Sie mir im Fall eines Absturzes die Datei /Library/Logs/panic.log. Sie enthält Daten über den Absturz, die es mir erlauben sollten, festzustellen, ob der Treiber für den Absturz verantwortlich war und wo genau die Ursache liegt.

 

F   Ich habe die Antworten oben gelesen und keine Lösung für mein Problem gefunden. Was für Informationen kann ich beisteuern, um die Ursache zu finden?

A   Schließen Sie den Zaurus an schalten Sie ihn ein, dann warten Sie einige Sekunden. Anschließend führen Sie bitte die folgenden Kommandos in der Terminal-Anwendung aus und schicken Sie mir die ausgegebenen Daten:

  • ifconfig
  • grep -E "AppleUSBCDC|org_lucidcake_driver_AJZaurusUSB" /var/log/system.log

  Überblick    Neuigkeiten    Installation    Einschränkungen/Fehler    FAQ    Download   

Installer-Paket für den Treiber (gepackt mit tar und gzip, Version 0.2.8 (27.09.2004), 168 KB - getestet mit OS X 10.3.5, sollte auch mit allen anderen Versionen ab 10.2.1 funktionieren).AJZaurusUSB_0_2_8.tgz
Quelltext (gepackt mit tar und gzip, Version 0.2.8 (27.09.2004), 212 KB). Das fertige Installer-Paket ist hierin mit enthalten.AJZaurusUSB_src_0_2_8.tgz
Installer-Paket für den Treiber (gepackt mit tar und gzip, Version 0.2.5 (31.10.2003), 104 KB - getestet mit OS X 10.2.1 bis 10.3.4). AJZaurusUSB_0_2_5.tgz
Quelltext (gepackt mit tar und gzip, Version 0.2.5 (31.10.2003), 144 KB). Das fertige Installer-Paket ist hierin mit enthalten.AJZaurusUSB_src_0_2_5.tgz


Letzte Änderung: 10.05.2006