The goal of this document is to enable a PROTOS miniHIL user to run an example project and to build up a basic understanding of the PROTOS miniHIL hardware and software.
Included in the PROTOS miniHIL package you should find:
the PROTOS miniHIL board
a 24V power supply
You should also have received login details for the PROTOS download site where you can download the latest version of the miniHIL software packages (https://dl.protossoftware.de).
The picture below gives an overview over the PROTOS miniHIL hardware.
Connect the ST-Link debugger to the SWD port on the miniHIL board and the PC
Connect the USB-1 port on the miniHIL board to the PC
Connect the power supply to the miniHIL board and plug it in to a power socket.
The correct hardware configuration is shown in the image below. Notice the two green LED’s on the top left of the board, which will turn on when the miniHIL board is powered correctly.
Firstly navigate to the PROTOS miniHIL download page (https://dl.protossoftware.de/minihil) and download the following zip files:
Now create a folder called "miniHIL" in your computer’s root directory. The path of this folder should be
C:\miniHIL. Then extract the contents of each .zip file into the newly created miniHIL directory and copy the .zip files of the
Example Project, the
WorkingLight Project and the
Template Project into this folder as well. Ensure, that you haven’t created subfolders inside
miniHILCubeIDE after extracting the zip files.
Create a new empty folder named
workspaces, which is where the workspace data from your projects will be stored.
C:\miniHIL directory you should now see this:
| While following this user Guide you will apply changes to the
To be able to use the run configurations from within the cubeIDE it is necessary to install the STLinkServer Component. You can find the installer in the IDE directory (e.g.
C:\miniHIL\miniHILCubeIDE_X.X.X\STLinkServer). Run the installer once. Note that the installer window will only popup briefly and will close itself quite quickly. This is normal. You can find more information about the STLinkServer on the official ST website: https://www.st.com/en/development-tools/st-link-server.html.
Launch the IDE (located at
C:\miniHIL\miniHILCubeIDE_X.X.X\stm32cubeide.exe) and when prompted, create a new workspace folder inside the
C:\miniHIL\workspaces folder (i.e. select
C:\miniHIL\workspaces\ExampleWS as our workspace directory)
When the CUBE IDE is launched for the first time close the
Information Center tab. Then go to
Existing Projects into Workspace and select
C:\miniHIL\MiniHilProject_Examples as the root directory. You should see the following projects appear in the main window. Click
Finish and allow the import process to finish.
Your Project Explorer should look something like this:
Now your example project is ready to be used.
Connect up the ST-Link debugger and the USB-1 port on the miniHIL to your PC.
In the IDE, select
build-debug-STLinkin the run configuration dropdown menu. Then click the button to launch the debug mode.
|During the first build a popup dialog might prompt you to upgrade the debugger firmware. After you hit OK the update tool will be launched. Just follow the instructions given. (Click on 'Open in update mode', then on upgrade; don’t select the checkbox to change the debugger mode). After you have closed the upgrade tool you have to restart the run configuration.|
If building and flashing succeeded, the CUBE IDE switches to the
Debugperspective and stops execution at the breakpoint in the
mainfunction. Press F8 or hit
resumein the toolbar to let the program execute (otherwise there will be no COM port available).
Go to the HilSimGUI folder in the Project Explorer and double click on runGUI.bat to start up the GUI. A command line window should open up followed by the GUI.
At the top left corner of the newly opened window, ensure that the "Serial" Connection is selected and that the Port selection dropdown window next to it has "Automatic" selected.
Click connect and you should see the elements on the GUI changing to reflect what’s happening on the miniHIL board. For instance, you should notice that the LedBlue element is switching between on and off, to reflect the blinky heartbeat selftest.
We can verify this formally by running its test suite. To run the test suite, navigate to the CaGe menu on the left, select Heartbeat_TestSuite and click on Run Tests.
If the tests ran successfully, you will see
passedafter each of the tests executed. You have now verified that your miniHIL installation is setup correctly.
Included in your miniHIL package, you should find an STM32F303 Nucleo-64 board. We will use this board to demonstrate the Target Device functionality of the miniHIL board.
Connect up the Nucleo board to the miniHIL as per the picture below.
When connecting a Nucleo board to the miniHIL, you should change the power mode of the Nucleo board, so that it gets its 5V via the miniHIL and not via the USB connector.
The STM32F303 also uses an ST-Link debugger. If you have the miniHil-ST-Link and the DUT-ST-Link connected to your PC at the same time, the IDE won’t know which debugger to choose if you want to flash your Project.
You can either disconnect the device you don’t want to flash right now, or you can edit specific Serial Numbers for flashing under
How to find out the SN of your ST-Links:
C:\miniHIL\tools\st-link in your console, then enter
The cmd-tool will then List all the connected ST-Links with their respective SN.