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
The PROTOS miniHIL software package
The picture below gives an overview over the PROTOS miniHIL hardware.
Watch the following video and follow its instructions on how to install the hardware.
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. Following this, create a new empty folder named
workspaces, which is where the workspace data from your projects will be stored.
C:\miniHIL directory should now appear as follows. Ensure that the folder hierarchies of
minihil-*-eclipse match and that you haven’t created subfolders after extracting the zip files.
Now create a copy of the example project
MiniHilProject_Examples in the
C:\miniHIL folder (so you can edit the example without losing the original working copy) and give it an appropriate name (e.g.
Launch the IDE (located at
C:\miniHIL\minihil-eclipse-x.x\ide\TrueSTUDIO.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 Atollic Studio is launched for the first time close the
Information Center tab. Then go to
Existing Projects into Workspace and select
C:\miniHIL\MiniHilProject_Examples_Copy 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 J-Link/ST-Link debugger and the USB-1 port on the miniHIL to your PC.
In the IDE, select either
build-debug-STLinkdepending on your debugger in the run configuration dropdown menu. Then click the button to launch the debug mode.
Depending on your debugger (J-Link/ST-Link) the build will pop up a dialog that says that the debugger firmware has to be upgraded. After you hit OK the update tool will be launched. Just follow the instructions given.
If building and flashing succeeded, Atollic 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 diagram below.