Commits

Ben Bass committed eb34474

update documentation

  • Participants
  • Parent commits fc58736

Comments (0)

Files changed (2)

doc/installation.rst

 
 .. _homebrew: http://mxcl.github.com/homebrew/
 
+On OS X Mavericks (and presumably future versions) Apple include a driver for
+FTDI devices. This needs unloading before ``libftdi`` can access FTDI devices
+directly. See the Troubleshooting_ section for instructions.
+
+.. _Troubleshooting: troubleshooting.html#os-x-mavericks
+
 Linux
 -----
 

doc/troubleshooting.rst

 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 This indicates a conflict with FTDI's own drivers, and is (as far as I know)
-mainly a problem on Mac OS X, where they can be disabled (until reboot) with
-the following::
+mainly a problem on Mac OS X, where they can be disabled (until reboot) by
+unloading the appropriate kernel module.
+
+OS X Mountain Lion and earlier
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Unload the kernel driver::
 
     sudo kextunload /System/Library/Extensions/FTDIUSBSerialDriver.kext
 
 
     sudo rm /System/Library/Extensions/FTDIUSBSerialDriver.kext
 
+OS X Mavericks
+~~~~~~~~~~~~~~
+
+Whereas earlier versions of OS X didn't include an FTDI driver directly -
+it would typically be installed as part of some other program - Mavericks
+includes this in the operating system itself. For this reason, it's probably
+a bad idea to delete it, but it can be unloaded as follows::
+
+    sudo kextunload -bundle-id com.apple.driver.AppleUSBFTDI
 
 Diagnosis
 ---------