====== Is your device supported ? ======

  * USB devices version 1 (with a NET2280 and an ISL3880 or ISL3886 chip) should work out of the box
  * USB devices version 2 (with a GW3887 chip) are unsupported - work is in progress
  * PCI devices are supported (all chips), but under Linux only

====== Installation instructions ======

===== FreeBSD =====

Only USB devices are supported.

  * Download the latest FreeMAC binary build on [[FreeMAC|this page]]
  * Download and install p54u 0.6.1 or newer from http://www.prism54.org/. Before compiling, edit driver/config.h and uncomment the line saying "#define WITH_FREEMAC"
  * Put the FreeMAC binary as a drop-in replacement for the SoftMAC firmware, ie in /boot/firmware/isl3886_usb
  * Plug your device, and type "p54term /dev/p54u0" (just like you'd do to get the LMAC prompt)

You should have something like this :

{{re:freemac_prompt.png}}

The commands available are on [[FreeMAC|this page]]. Happy hacking !

===== Linux =====

All devices (PCI, PCI+net2280, 3887) are supported. Multiple devices are supported.

  * Download and install the driver as outlined in http://jbnote.free.fr/prism54usb/
  * Go to the freemac subdirectory and type make; install the freemac binary you need in the appropriate 'firmware_agent' directory
  * insmod the driver (make load from the root directory should be okay)
  * go to the ''src/utils/islsm-ctrl'' directory; do a  ''islsmctrl --dev /dev/islsm0 --setfwname --fwname freemac'' or whatever you named the file to reflect the filename change
  * go to ''src/utils/islsm-term''; then execute ''islsm-term /dev/islsm0'' Read the message, then have fun. disclaimer : on the 3887, triggering firmware upload will make the uart go awry.

  * As of islsm-20060424 implementation, there is NO --setfwname --fwname option. and also islsm-term is named as term. 
  * Looks like it doesn't support USB device. (Fix me)

====== Rebuilding FreeMAC ======

FreeMAC compiles with the plain GNU ARM toolchain. Just install it according to the instructions at http://www.gnuarm.com. No patches are required.

To compile FreeMAC, just type "make" in its source directory. This will create the ready to use "freemac.arm" file.