Quick Start Basic

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.

Prerequisites

Included in the PROTOS miniHIL package you should find:

  • the PROTOS miniHIL board

  • a 24V power supply

  • Wire jumpers

  • USB cable

  • The PROTOS miniHIL software package

Overview over the hardware

The picture below gives an overview over the PROTOS miniHIL hardware.

SimulatorCommented

Installing the hardware

Watch the following video and follow its instructions on how to install the hardware.

miniHIL Hardware Setup

Installing the software

Firstly navigate to the PROTOS miniHIL download page (https://dl.protossoftware.de/minihil) and download the following zip files:

  • Template Project

  • Example Project

  • MiniHil IDE

  • External Tools

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.

The C:\miniHIL directory should now appear as follows. Ensure that the folder hierarchies of tools and minihil-*-eclipse match and that you haven’t created subfolders after extracting the zip files.

miniHIL Directory

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. MiniHilProject_Examples_Copy).

ExampleCopy

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)

WorkspaceIDE

When the Atollic Studio is launched for the first time close the Information Center tab. Then go to FileImportGeneralExisting 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.

Import0

Your Project Explorer should look something like this.

ExampleProjectEclipse

Now your example project is ready to be used.

Verifying the miniHIL installation

  • 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-JLink or build-debug-STLink depending on your debugger in the run configuration dropdown menu. Then click the LaunchBar debug 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 Debug perspective and stops execution at the breakpoint in the main function. Press F8 or hit resume in 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.

runGUI
  • 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.

HilSimConnection
  • 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.

HilGUI
  • 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.

heartbeatTest
  • If the tests ran successfully, you will see passed after each of the tests executed. You have now verified that your miniHIL installation is setup correctly.

Connecting a Device Under Test (DUT)

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.

DUT 1