MacOS

Authors

Leo Wong, Wesley Leung

Download & Install

First download the STM32CubeIDE installer from our Github.

⚠️ Warning: NEVER place the PCB on top of your computer, it may kill your computer.

Click Agree on the bottom right

Double click the box icon on the top left.

Click OK

Go to System Preferences>Security&Privacy, search near the bottom right region, click "Open Anyway" for "st-stlink-server.2.1.0-1.pkg"

Click "Open"

You will now proceed to install st-stlink-server.2.1.0-1.pkg

Click, continue/ install to complete the installation process

After you have done installing the st-stlink-server.2.1.0-1.pkg, install STM32CubeIDE by dragging the Application icon to the Application folder

CubeIDE is not malware

Go to System Preferences>Security&Privacy, search near the bottom right region, click "Open Anyway" for "STM32CubelDE"

Press "Open"

After you have installed the IDE, please follow the steps below to properly setup your Integrated Development Environment.

Import the project files

Download the sw-tutorial.zip we prepared for you below.

Note that we may have some library changes from time to time. So always follow what the tutorial notes say.

11MB

sw-tutorial.zip

archive

You can choose whichever directory you like to place the project files. Just make sure you can find it afterwards.

If the application ask for permission to accept incoming network connections, click "Allow"

Click Import in File tab

Under General choose "Existing Projects into Workspace"

Extract the entire code boilerplate file (unzipped) you have downloaded and select that as root directory. Click finish afterwards.

Tada! You have successfully imported the code boilerplate.

Configure ST-Linkv2 (Mac)

On the top left click the red cross to close the Information Center page

You should now see this

Switch build option from Debug to Release

Click the arrow besides Run and click Run Configurations...

Choose STM32 Application the left and select Debugger Tab.

Change Debug probe to ST-LINK (OpenOCD). Also double check that the OpenOCD command is the same as the one in the image above.

Click Show generator options... under Configuration Scripts to reveal more options.

In Mode Setup, select Software system reset in Reset Mode.

If you see this, you should be good to go. Ask someone to give you a mainboard and a ST-LINK (the USB like thingy we use to flash code onto the board) and see if it works.

You should get something similar to this once you connect everything and actually flash the code. The LEDs should be blinking.