miniHIL UserGuide

Intro

To use the miniHIL Software you are required to have a valid license.

Currently there are 3 types of licenses for the PC Software:

MiniHIL developer tool license (Allows testcase development, code generation, compilation, flashing, test execution, IDE usage and report generation)
MiniHIL test execution license (Allows test execution and report generation as well as flashing pre-created test cases to any miniHIL hardware)
MiniHIL continuous integration license (small/large) (Allows code generation, compilation, flashing, test execution and report generation)

And one license for the software running on the miniHIL hardware: MiniHIL runtime license.

The miniHIL runtime license is tied to a specific miniHIL hardware board and comes as part of the hardware delivery. No user interaction is needed to setup the license.

For the PC Software node (host) specific license files are needed. A license file for your node can be requested if you have ordered a license by sending an email to minihil@protos.de. This email must include your node ID/machine key, your full name, your companies name as well as the type of license you want to request for the given node ID.

Node ID / Machine key

The node ID is a unique identifier for your PC (host node). You need to include it in your license request email.

Option 1 – From the IDE license error dialog (easiest)

If you launch the miniHIL IDE without a valid license installed, it will immediately show a license error dialog. This dialog displays your Host ID directly. Simply copy the value from the dialog and include it in your license request.

This is the quickest way to obtain your node ID and does not require any project or command line.

Option 2 – From the command line via Gradle

If the IDE is already running or you prefer the command line, you can obtain the node ID (and full license status) by running the following command in the root directory of any miniHIL project:

.\gradlew.bat showLicenseInfo

The node ID is printed at the bottom of the output, labelled machine key. In addition it is shown whenever a license check cannot find a valid license.

Getting information about installed licenses

Information about the installed licenses can be obtained using the showLicenseInfo task in any miniHIL project (.\gradlew.bat showLicenseInfo).

example output of showLicenseInfo task

MiniHIL License Information:
===============================
Host ID: eyJ2IjoiMCIsImlkIj[...]lMjU2MDUzNGVmMiJ9
Build Date: 2025-08-26
Search Paths:
 - C:\minihil\protosLicense
 - C:\Users\[...]\protosLicense
 - C:\[...]\MiniHilProject_Template_cube\protosLicense

License Files:
---------------

- License1.lic (C:\minihil\protosLicense\License1.lic)
  Signature:  Valid
  Type: minihil-developer-tool
  Expires: Never
  Is valid for this machine:  Yes
  Max Release Date: 2026-04-22 00:00:00

- License2.lic (C:\minihil\protosLicense\License2.lic)
  Signature:  Valid
  Type: minihil-continuous-integration-tool
  Expires: 2025-05-30 14:19:27 (EXPIRED)
  Is valid for this machine:  Yes
  Max Release Date: 2025-04-22 00:00:00

License check results:
=========================
- Found valid license to execute tests and the GUI.
- Found valid license to generate code and build the test project.
- Found valid license to use the miniHIL IDE.

MiniHIL Licensing
=====================

To obtain a new license please contact your miniHIL support or write an email to <minihil@protos.de>.
Please include the machine key of the machine you want to use the miniHIL software on in your license request.
If you want to request a license for this machine the machine key is:

eyJ2IjoiMCIsImlkIj[...]lMjU2MDUzNGVmMiJ9

Installing the new license