MAKE for Zaurus USB driver for Mac OS X
=======================================

0. About
--------

This is an experimental driver (or technically speaking a "kernel extension")
that allows Mac OS X to communicate with a Sharp Zaurus over USB.


1. How to compile
-----------------

- Load "AJZaurusUSBCommDummy/AJZaurusUSBCommDummy.xcode" with Xcode and build
it.
- In a Terminal, cd to the "AJZaurusUSBCommDummy" directory and run the
"fixbuild.sh" script. This will change owner and group to "root" and "wheel"
so OS X doesn't complain when loading the driver. You need to be logged in to
an administrative account and provide your password for this step.
- Load "AJZaurusUSBDataDummy/AJZaurusUSBDataDummy.xcode" with Xcode and build
it.
- In a Terminal, cd to the "AJZaurusUSBDataDummy" directory and run the
"fixbuild.sh" script.
- Load "AJZaurusUSB.pbproj" with Xcode and build it.
- In a Terminal, cd to the directory containing this MAKE and run the
"fixbuild.sh" script.

This is simplified by the makefile. So, you can just type 'make' in a Terminal.

2. Testing
----------

For testing source code modifications, DON'T install the driver (if you
already have, delete the folder "AJZaurusUSB.kext" located at
"/System/Library/Extensions" and reboot). To test a freshly built
version, connect the USB cradle to your Mac, place the Zaurus inside the
cradle and turn it on. Then type

  sudo kextload /Some/Directory/AJZaurusUSB/pkg/AJZaurusUSB.kext

inside a terminal window to load the driver. After you're finished, type

  sudo kextunload /Some/Directory/AJZaurusUSB/pkg/AJZaurusUSB.kext

and afterwards turn off or disconnect the Zaurus. To see what's going on,
you should have an open console window during testing or a terminal window
executing "tail -f /var/log/system.log".


3. Creating an installer package
--------------------------------

Load the file "AJZaurusUSB.pmsp" with the Package Maker application (included
in Apple's developer tools). Choose "Create Package" from the Tools menu to
create an installer package.

