Updated README for STLink-v1 setup on macOS
-###
# Installation instructions for STLINK/v1 driver
-###
When connecting to the STLINK/v1 on macOS via USB, the system claims the programmer as a SCSI device. Thus libusb is not able to initialise and establish a connection to it. To solve this issue Marco Cassinerio (marco.cassinerio@gmail.com) has created a so called "codeless driver" which claims the device. It is of higher priority then the default apple mass storage driver, what allows the device to be accessed through libusb.
To make use of this alternative approach one needs to go through the following steps:
-1) Install the macOS Kernel Extension (kext):
- - Open a terminal console and navigate to this subdirectory `/stlinkv1_macos_driver`
- - Use the command ```sudo sh ./install.sh``` to install the appropiate kext for your system version.
-
-2) Install the ST-Link-v1 driver from this subdirectory `/stlinkv1_macos_driver` by executing: ```sudo make osx_stlink_shield```. This should result in the following output:
-
-```
-Requesting load of /System/Library/Extensions/stlink_shield.kext.
-/System/Library/Extensions/stlink_shield.kext loaded successfully (or already loaded).
-```
-
-3) Configure System Integrity Protection (SIP)
+1) Configure System Integrity Protection (SIP)
The above system security setting introduced by Apple with OS X El Capitan (10.11) in 2015 is active per default
and prevents the operating system amongst other things to load unsigned Kernel Extension Modules (kext).
Thus the STLINK/v1 driver supplied with the tools, which installs as a kext, remains not functional,
-until SIP is fully deactivated.
+until SIP is fully deactivated. Without SIP-deactivation, st-util would fail to detect a STLINK/v1 device later on.
-Without SIP-deactivation, st-util fails to detect a STLINK/v1 device:
+In order to deactivate SIP, boot into the recovery mode and run ```csrutil disable``` in a terminal console window.
-```
-st-util -1
-st-util $VERSION-STRING$
-WARN src/sg.c: Failed to find an stlink v1 by VID:PID
-ERROR src/sg.c: Could not open stlink device
-```
+2) Reboot the system.
-In order to deactivate SIP, boot into the recovery mode and run ```csrutil disable``` in a terminal console window.
+3) Install the macOS Kernel Extension (kext) (ST-Link-v1 driver):
+ - Open a terminal console and navigate to this subdirectory `/stlinkv1_macos_driver`
+ - Use the command ```sudo sh ./install.sh``` to install the appropiate kext for your system version.
+ This should result in the following output:
-4) Reboot the system.
+```
+Requesting load of /System/Library/Extensions/stlink_shield.kext.
+/System/Library/Extensions/stlink_shield.kext loaded successfully (or already loaded).
+```
-5) Verify correct detection of the STLINK/v1 device with the following input: `st-util -1`
+4) Verify correct detection of the STLINK/v1 device with the following input: `st-util -1`
You should then see a similar output like in this example:
```
