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