renaming the README file to README.md
[fw/stlink] / stlinkv1_macosx_driver / README.md
1 from: marco.cassinerio@gmail.com
2 to: texane@gmail.com
3
4 Hi,
5
6 i managed to get the stlink v1 working under os x and i would like to share the solution so maybe you can
7 add it in your package.
8 The problem is that os x claims the device as scsi and libusb won't be able to connect to it.
9 I've created what is called a codeless driver which claims the device and has a higher priority then the
10 default apple mass storage driver, so the device can be accessed through libusb.
11
12 I tested this codeless driver under OS X 10.6.8 and 10.7.2. I assume it works with any 10.6.x and 10.7.x
13 version as well.
14
15 Attached to this mail you'll find the osx folder with the source code of the driver, both drivers (for
16 10.6.x and 10.7.x), an install.sh script and the modified Makefile, i only added a line at the end which
17 invoke the install.sh.
18
19 First, unpack the osx.tar.gz contents:
20 ```bash
21 tar xzvf osx.tar.gz
22 ```
23
24 Then, install the driver using:
25 ```bash
26 sudo make osx_stlink_shield
27 ```
28
29 no reboot required.
30
31 P.S. If error `OS X version not supported` occurs. For the latest versions of Mac OS X you may need to change the `osx/install.sh` as follows:
32 ```bash
33 < ISOSXLION=$(sw_vers -productVersion)
34 ---
35 > ISOSXLION=$(sw_vers -productVersion | sed -e 's:.[[:digit:]]*$::')
36 ```
37
38 FOR OS X 10.10 Yosemite you must force the system to load unsigned kernelextensions
39
40 ```bash
41 sudo nvram boot-args="kext-dev-mode=1“
42 ```
43
44 reboot the system!
45
46 (Update from another user) FOR OS X 10.11 El Capitan: the Yosemite kext works for my 10.11.4.