Project

General

Profile

RTSystemsCablesAndMavericks » History » Version 2

Jens Jensen, 08/08/2014 05:53 PM

1 1 Jens Jensen
h1. RTSystemsCablesAndMavericks
2
3
RTSystems usb cables are a branded (i.e., customized) FTDI cable. They simply have different USB Vendor (VID) and Product IDs (PID) from generic FTDI USB adapters.
4
5
Apple OSX 10.9.x aka Mavericks now has a built in FTDI Driver, com.apple.driver.AppleUSBFTDI.
6
However, it does not load by default because it does not recognized the custom VID/PID combos that RTSystems cables use.
7
8 2 Jens Jensen
Many folks have been simply loading the FTDI OEM driver, com.FTDI.driver.FTDIUSBSerialDriver (2.2.18), and this works, but I have been able to reproduce a nasty hang when uploading from chirp to some Yaesu radios, e.g., VX-6.
9
10
The workaround is to disable the OEM driver, and modify and load the Apple FTDI driver.
11
12
Warning you take all responsibility for mucking with your system files. Know what you are doing and how to undo it before you proceed. We do not take any responsibility for issues arising from this.
13
14
Also, if you do not have any issues with your RTSystems FTDI cables, Chirp, Mavericks, and the FTDI OEM driver, then don't bother with this procedure. 
15
16
This is a workaround only for people who have been having these issues.
17 1 Jens Jensen
18
19
h2. Steps
20
21
stop using and unplug all FTDI usb adapters
22
23
unload existing FTDI OEM driver (if applicable):
24
@
25
sudo kextunload -b com.FTDI.driver.FTDIUSBSerialDriver
26
@
27
28
Disable FTDI OEM driver (if applicable):
29
@
30
sudo mv -v /System/Library/Extensions/FTDIUSBSerialDriver.kext/ /System/Library/Extensions/FTDIUSBSerialDriver.kext_disabled
31
@
32
33
check to see that there are no FTDI drivers loaded:
34
@
35
kextstat |grep -i ftdi
36
@
37
(should not show anything)
38
39
Add RTSystems VID/PIDs to Apple FTDI driver:
40
@
41
sudo nano /System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBFTDI.kext/Contents/Info.plist
42
@
43
44
add following to *IOKitPersonalities* section:
45
@          <key>AppleUSBFTDI-RTSystems</key>
46
               <dict>
47
                       <key>CFBundleIdentifier</key>
48
                       <string>com.apple.driver.AppleUSBFTDI</string>
49
                       <key>IOClass</key>
50
                       <string>AppleUSBFTDI</string>
51
                       <key>IOProviderClass</key>
52
                       <string>IOUSBInterface</string>
53
                       <key>InputBuffers</key>
54
                       <integer>8</integer>
55
                       <key>OutputBuffers</key>
56
                       <integer>16</integer>
57
                       <key>bConfigurationValue</key>
58
                       <integer>1</integer>
59
                       <key>bInterfaceNumber</key>
60
                       <integer>0</integer>
61
                       <key>idProduct</key>
62
                       <integer>0x9000</integer>
63
                       <key>idProductMask</key>
64
                       <integer>0x9000</integer>
65
                       <key>idVendor</key>
66
                       <integer>0x2100</integer>
67
               </dict>
68
@
69
               
70
71
72
plug in your rtsystems ftdi usb adapter
73
74
Force load of Apple FTDI driver:
75
@
76
sudo kextload -b com.apple.driver.AppleUSBFTDI
77
@
78
79
verify Apple FTDI driver is loaded:
80
@
81
hackpro:~ jens$ kextstat |grep -i ftdi
82
  129    0 0xffffff7f826d0000 0x7000     0x7000     com.apple.driver.AppleUSBFTDI (1.0.1b3) <77 36 5 4 3>
83
hackpro:~ jens$ 
84
@
85
86
Verify Apple FTDI device node is created:
87
@
88
ls -l /dev/cu.usbserial-*
89
@
90
91
*good result*: should list a device file
92
*bad result*: "no such file or directory"
93
94
95
h3. Note
96
97
*You may need to repeat these steps if Apple updates FTDI driver (such as in a Combo Update aka Minor update release)*