View source for Mac OS X

From Openmoko

Jump to: navigation, search

You do not have permission to edit this page, for the following reasons:

  • The action you have requested is limited to users in the group: Administrators.
  • You must confirm your email address before editing pages. Please set and validate your email address through your user preferences.

You can view and copy the source of this page:

Return to Mac OS X.

Personal tools

Welcome to the OpenMoko page devoted to MacOS X users!

Here you can find notes of using Neo1973 (and maybe other OM devices) with Mac.

Flashing to your device

To operate the Phase 1 devices, you need to flash a root file system first.

Here is a detailled instruction:

  1. download AJZaurusUSB-0.5.2 (or later) from
  2. install
  3. reboot your Mac so that the driver becomes active (you do not yet need to configure the network interface)
  4. download OpenMoko Flasher from
  5. (V1.0 only: create a new Folder at "~/Library/Caches/OpenMoko Flasher")
  6. press the Refresh button (which loads the list of packages on the server)
  7. select and load the rootfs (takes some minutes for approx. 40 MByte)
  8. open the Console application and show the console.log
  9. Now, on your OpenMoko, hold the AUX button while pressing the Power button for 5 seconds
  10. the BOOT menu should appear
  11. connect the USB cable
  12. Flash
  13. the BOOT menu screen on the OM should show an indication that it has been switched to DFU mode
  14. if it fails (console.log should show the reasons), unplug the OpenMoko shortly and replug
  15. if it successfully flashed, you should be able to boot the OpenMoko and continue configuring AJZaurusUSB

Alternatively, you can compile and run dfu-util manually as described at

Connecting to your device


You can telnet, SSH, SMB or do whatever you want if you install software that enables you to set up TCP/IP network over your USB connection.

MacOS X does not provide such a driver for RNDIS/Ethernet Gadget. But you can use an open source (GPL) universal driver which is developed for handheld devices like iPAQ, Sharp Zaurus, and Motorola A760. Download it and install according to manual found inside of the package.

After reboot, you should have a new Ethernet interface in your System Preferences/Network. Set up the network manually for that interface by using these addresses:

IP-V4: manual

This might conflict with some WLAN routers which also use the network.

You should be able to connect to your Neo! Try using ping and the roundtrip time should be between 1 and 2 ms.

NOTE: it appears that after each reboot of the OpenMoko you get a new interface on the Mac (this is under investigation - AJZaurusUSB appears to deliver a random MAC address to the IONetworking stack).

NOTE: the software is sometimes a bit flaky, and a reboot of the Mac seems to bring it back. It is especially critical about hot unplugging the OM and sleep modes of MacBooks. This may even result in a Kernel Panic.

Telnet, ssh, SMB

To Be Done.


After making the USB connection work, start ssh:

ssh -l root

If you don't have installed the key, it will ask for a "yes" on the first connection and for a password on each other. This is "root" unless you change it.

MacBook-hns:~ hns$ ssh -l root
root@'s password: 
root@fic-gta01:~$ hostname


To Be Done.


To Be Done.


This is not done yet. Possible solutions are SyncML or

Sharing connection

Mac as a server

Here is described how to enable your Mac to serve as a internet router for your OpenMoko device.


This could help:


If you install AJZaurusUSB driver you should be able to set up your Mac as a router (not tested).

Neo1973 as a server

To Be Done.

Developing software

Using virtualization software

You can use Parallels or VMWare to install your favourite Linux distribution and then develop just as on Linux.

There are some drawback since AFAIK dfu-util may not work correctly in such environments.


There are some efforts to get through process of compiling OE and OpenMoko under mac: OpenMoko_under_QEMU_on_MacOSX