miniHIL Release Notes

Updates cage and eTrice plugins to latest versions (see details below)

Breaking: If you have been using the vsCode extension for the miniHIL, you have to manually uninstall the old eTrice extension before installing the new version.

Feat: C-Code completion, diagnostics and partial navigation in cage target code blocks. Note that the c code support will only be available after the first successful build of the miniHIL project.

Feat: Inline code actions for state machine editing.

Feat: Keyword hover in cage files

Fix: Fixes multiple bugs which would lead to stale diagnostics and scope in cage when changing room files.

Feat: Parameter names are now shown at step and sequence call sites.

Fix: The previous release (2.6.0) removed support for imported state transition graphs in generated testsuites. This release reintroduces support for imported state transition graphs.

Fix: Correctly validate the interfaces used in imported state transition graphs. Due to missing validation, previously c code that would not compile was generated when the interface of the test actor did not match the one used in the graph.

Fix: Fixes a bug where the interactive hardware documentation could not be pregenerated from an existing .json configuration file.

Fix: Fixes a bug where multiple custom extension boards could have conflicting pin IDs leading to random wiring.

Feat: Adds a CAN scheduler actor (can.platform.CANScheduler.ACanScheduler) which can be added to any can setup to automatically send can messages following a preconfigured schedule.

Fix: Correctly indicates whether received CAN frames use an extended or standard ID in the CANMessage.

Updates eTrice to version 5.9.0 (release notes)

Feat: Added traceDiagramLinkIde property to configure which IDE (VSCODE|VSCODIUM|ECLIPSE) opens CaGe TraceDiagram links.

Feat: Cage trace diagrams now rendered as collapsible sections to allow quicker navigation to the relevant traces.

Fix: Improved memory usage in case of long logs and cage traces.

Fix: Fixed a bug where the dashboard could not connect if another (possibly stale) dashboard instance was still open in the browser.

Fix: a possible loss of incoming CAN frames if both can interfaces are used simultaneously. Set a dedicated message RAM offset for FDCAN2 and reduce FIFO element counts to prevent shared message RAM overlap when both CAN controllers are used simultaneously, avoiding a race condition that could drop CAN(-FD) frames.

Feat: I2C master now supports transfers larger than 16 bytes via new writeLarge and readLarge messages in PI2CMasterCtrl. These messages take a new request data classes which contain a pointer to a user-managed buffer (DI2CWriteRequestLarge / DI2CReadRequestLarge). Read requests are answered by readCompleteLarge, containing the buffer pointer and the actual number of bytes read (docs).

Feat: Added AI2CMaster3Adapter for I2C interface 3 (pins PH8/PH7). Mirrors the existing AI2CMaster2Adapter and supports the same PI2CMasterCtrl protocol (docs).

Breaking: ActorClass ASentAdapter_TIM16_PF6_DMA1S5 renamed to ASentAdapter_TIM16_PF6_DMA2S5 to correctly reflect the used DMA channel.

Feat: Added new ASentAdapter_TIM16_PF6_DMA1S6 to allow usage of SENT in case DMA2S6 is used by another actor.

Fix: Fixes incorrect conversion of seconds to nanoseconds which lead to a duration reported 10 times longer than the actual duration.

Fix: In case of executing the same test case twice (this is also the case if the same test case with the same test case parameters is included in the same test suite multiple times), output files were overridden. Files are now uniquely numbered by execution order. This bug could also lead to seemingly incorrect test results in the test report if the test outcome changed between the two executions of the same test case. The result was always recorded correctly, but the test log and cage trace files were overridden by the second later executions.

Updated to version 5.8.0 (release notes)

Feat: User interface now allows adding and editing of customer/project specific hardware adapter boards (docs).

Fix: Correctly trigger enumeration of connected miniHIL boards on dashboard startup and board selection. Previously only "Automatic" selection was possible, which cannot be used to connect if more than one board is connected.

Fix/Feat: Automatically choose a free port if a second dashboard server instance is started. Previously only a single dashboard server could be started. Subsequently it was not possible to connect to multiple miniHIL boards on the same PC without manually starting dashboard servers on different ports.

Feat: Traces are shown per test case

Breaking: The test report schema changed: element testTraceDiagram moved to test case.

Feat: Traces are shown per test case

Fix: Ensures that the requested output voltages are applied immediately after the AnOutAdapter initialization completes. This prevents initial voltage set requests received during system startup from being lost.

Breaking: Fix: UART word length configuration to correctly reflect the selected data bits, and to handle parity-enabled configurations properly.

Feat: Adds c api to change lin baudrate at runtime LIN_setBaudrate(uint32_t baudRateBps). Note that a restart of the slave simulation is needed after changing the baudrate: LIN_startSlave(). Lowest supported baudrate is 3kbps.

Feat: The I2C master abstraction now supports baudrate configuration and 10-bit addressing. (docs).

Breaking: DI2C[Write/Read]Request have gained an additional field: use10BitAddressing. If you have used the I2C master before, and have not zero initialized the structs before using them, ensure to set this field to false to avoid undefined behavior.

Feat: Trace shows duration of timeout: timeout after X ms, where X is the expired time limit plus the timespan until raised

Updated to version 5.7.0 (release notes)

Fix: In case a test run was canceled the following test run would produce an etUnit file without header. This would lead to an error when generating the test report which led to an empty report. This has been fixed.

Feat: Client now has an option to automatically reconnect to the miniHIL process if the connection is lost. (docs).

Fix: Renamed some internal callback functions to avoid name collisions when using SPI2 and SPI6 adapters in the same project.

Fix: Keep test tree results state when clicking on cage trace links

Fix: Data dashboard widgets could not be saved as no default configuration directory was set.

Feat: Add test suite sequence number to allow ordering test suites by order of execution

Test result pie chart now uses a linear representation. Before a logarithmic scale was used.

Feat: SENT simulation now allows setting of non standard and fractional tick length (docs).

Master and Scheduler now offer a replicated port for scheduler control from multiple peers.

Fix: MCU Pin PJ13 was always driven low by I2C port extender. The Pin is now correctly configured as input and not driven.

Feat: Added @UsesResource annotation to actors in minihillib for hardware resource management (docs).

Fix: Increased sequence trace depth

Feat: Automatic partial flush of the cage trace during cage wait statements. For most loop use cases which include wait statements this mitigates or greatly improves the time before cage trace buffer overflows occur.

Feat: Allow action code blocks in sync reaction blocks.

Update from version 5.4.0 to 5.5.0:

A plugged in extension board no longer blocks the miniHIL startup in case no FPGA configuration is part of the miniHIL software.

Fixes a regression introduced in the 5.3.0 IDE:

Fixes a regression introduced in the 5.3.0 IDE: Snapping in the graphical eTrice editors did not work correctly leading to usability issues when moving elements.

[GUI] Breaking Change Replaced the existing GUI with the miniHIL Dashboard:
The script runGUI.bat and task runGUI are starting the Dashboard instead. This can be reverted by setting migrateRunGUI=false in the gradle.properties file.

[Build] Breaking change Enables gcc -Werror=implicit-function-declaration for miniHIL project builds to avoid spurious and hard to detect errors due to incorrect handling of return values when a function is not declared. This might break your project build if you are using functions without a declaration. The resulting build errors have to be fixed by adding the appropriate function declaration. Usually this means fixing a missing import.

[ICU - Input Capture Unit] Breaking change Renames AInputCaptureUnit to AInputCaptureUnit_TIM2_DMA2_S4 to reflect the used HW resources in the actors name and to avoid a naming collision with the newly added ICU actor. If you are using the AInputCaptureUnit actor class in your project you have to update you ActorRef statements and possibly correct the imports.

Feat: Left sidebar is resizable.

Fix: Data dashboard configuration could not be saved in dashboard preview release.

Feat: Added support for live test signal visualization. See miniHIL Dashboard

Fix/Feat: Adds support for big endian signals

Feat: Lin generator now supports sporadic frames

Fix: Lin generator now allows usage of real values for delays in LDF schedule tables as long as only ms precision is used

Feat: The generated signal store now supports changeNotifications which can be enabled/disabled per signal (lin docs).

Feat: Adds connectable pins to fpga extension board

Feat: Adds PCageTracing protocol which is exposed as Service and can be used via a SAP to print messages into the cage trace. (use with SAP tracer: PCageTracing and tracer.logTrace("Logged to trace");) (docs)

[Table based voltage lookup]

[ICU - Input Capture Unit]

[SENT]

[PWM Sensors]

Fix: Minor protocol changes to improve USB throughput. MiniHIL boards flashed with this release may not be able to communicate with the GUI from older releases.

Fix: Fixes unused variable warning in case the data were not compared in the expect statement (using (*) expression.

Fix: Fixes a bug where cage traces contained the wrong message names for protocols with more than 127 messages.

Feat: Adds reaction sync blocks which allow synchronous expects. I.e. checking of values without waiting for an incoming message (docs).

[PAnOut] Breaking Change PAnOut is now split into the SAP part (PAnOut_SAP) and non-SAP part (PAnOut). Refer to Migrating IOs SAPs for migration guidance.

[PDigOut] Breaking Change PDigOut is now split into the SAP part (PDigOut_SAP) and non-SAP part (PDigOut). Refer to Migrating IOs SAPs for migration guidance.

[PDigIn] Breaking Change PDigIn is now split into the SAP part (PDigIn_SAP) and non-SAP part (PDigIn). Refer to Migrating IOs SAPs for migration guidance.

Distributable artifacts for runtime/target are now collected in a build/dist folder in the MiniHilProject

Added protobuf generator to allow room actors to send and receive protobuf messages

Fixed miniHIL version values generated in C project source code

Fix possible race condition during UART receiver enable.

Fix missing initialization of rxBufferByteCount and rxBufferNeedsHandling values in UART adapter.

Fixed possible overflow when receiving bytes

Added support for etrice port modifiers mandatory/optional

Improved validation for missing arguments

Fixed weblink support (IDE)

Fixed CaGe compatibility with standalone etrice doc generator

Fix possible race condition in TimerService which could lead to invalid reception of timeout event in case a timer was killed and directly restarted.

Fixes a bug where the c generator would produce uncompilable code if \r or \n were used in message or operation parameters.

Adds @UsesResource annotation for actor classes. This annotation can be used to specify unique resources which may not be used by multiple actors. A warning is generated if a resource is used more than once in an eTrice system.

Added port connection modifiers optional and mandatory

"private" protocol messages are now hidden from code completion assist to discourage use (IDE)

For PC variant: etGetTargetTime now uses monotonic clock

Fixed duplicate test selection when using wildcard

Sunsetted deprecated index-based test selection. Since 4.4.1 tests are selected by name (Selecting Tests).

Handle missing and invalid testHW and mcuID properties when running target HW gradle tasks

Fixed test state race condition when loading test model during start

Extended documentation about report MetaInfo values

Fixed buffer usage values in platform statistics

Added property file containing release version information

Added documentation to User Guide

ctrl.error message added for ethernet connection error

Extended documentation in User Guide

Allow GCC toolchain to be configured via gradle property

MetaInfo annotation values are now rendered as markdown in the html test report.

Added out of sync check for loaded models and flashed application when connecting to the miniHIL.

Improves reliability of usb connection in case of degraded usb performance on the host side

Allow disabling automatic return to slave mode, to avoid release of NSS and CLK lines to tristate outputs

Lowered priority of USB interrupts to avoid blocking of other user specific interrupts

Adds missing common callbacks for SPI5

The rtc_getDateTime function now returns a bool to indicate if a valid time has been read into the passed ptr. The function now returns false if the rtc does not have a valid time set (e.g. before a usb connection with the test runner/gui has been established at least once). This change also fixes a bug were the RTC time could not be synchronized successfully if it had been requested using the rtc_getDateTime function before the initial sync.

Fixes a bug where MetaInfo annotations were not correctly attached to test results if the test case contained parameters.

Adds option to configure SPI idle clock polarity, clock capture edge, NSS active level and transmission timeout

Corrections and additional documentation in User Guide

LIN scheduler rollover notification and schedule switching behavior fixed to match existing documentation

DLinScheduleState documentation correction for pos member

Fixes test case descriptions for parameterized test cases

Fixes reporting when test cases were executed selectively

Percentage labels on HTML report graph forced to add up to 100%

Corrections in Model Library reference documentation for PDigIn

Adds documentation of test execution order when Selecting Tests

Fixes USB ZLP handling in case header and payload are send in one usb transaction

For PC variant test executables, fixes typo in build configuration for wait max delay override. Normal tests targeting the miniHil hardware are not affected by this change.

Fixes hard fault when the miniHIL project is compiled with -O2 optimization. The hard fault was caused by GCC that inserts undefined instructions on purpose when it detects a (null-)pointer pointing to 0x00 (beginning of RAM).

Remove unused Java JRE

Updates arm gcc from v10.3 to v12.3

Fixes a race condition which between could happen if kill and startTimeout/startTimer message were directly send after each other from within the same actor. Under some circumstances this could in turn lead to a message queue overflow.

Fixes printing the reason for expect absent expects.

For PC variant test executables, fixes excessive wait delay warnings due to platform-dependent (non-realtime) inaccuracy. The maximum delay before triggering a warning is relaxed to 10 ms. Normal tests targeting the miniHil hardware are not affected by this change.

Fixes a bug where cage traces were not converted correctly if a cage trace buffer overflow occurred at the end of a step or sequence call.

Fixes a test case name escaping bug which truncated some test case names with float parameters.

Enables html raw passthrough for test case and test suite documentation when rendered in the html test report

Extends the html test reports markdown renderer capabilities to be compatible with github flavoured markdown

Migrated Stm32CubeH7 HAL from v1.10.1 to v1.11.0 The release notes can be found here. The file is also available as part of the STM32CubeH7 package v1.11.0 (Drivers\STM32H7xx_HAL_Driver\Release_Notes.html).

The LDF to eTrice generator now supports the LIN ByteArray data type

Fixes a hard fault when using an i2c address which is not present on the bus

Adds an lwip adapter as well as an example tcp connection actor (Max payload size 255 byte). Currently ethernet may be used by user test cases. It is not used to control test execution. (minihil.platform.eth)

Fixes a bug with in range expects: In case the correct type of the expect could not be inferred from the arguments the arguments were cast to int before comparison. Inferring the correct type fails if all parameters (compare value and both range limits) are provided as target code. This could lead to unexpected fail/passes of the expect.

Updated to STM32CubeIDE v1.13.1

Added Markdown (CommonMark) support. It is now the default language for documentation in eTrice and CaGe

Updated CaGe

Adds a new input capture actor to measure timings of arbitrary digital waveforms (docs).

Fixes a crash on disconnect

Fixes wrong pin labels for usart 1 RX and TX pins in interactive hardware documentation

Adds header pin numbers to pin hover texts

Allow adding custom "software adapters" in the hwConfig.json. (A json schema file can be found in minihillib/gradle/hwConfig.schema.json).

Changes download file name to hwConfig.json to match the file name expected by the gradle task.

Adds version number info to menu

FIX: Reenables the generation of runtime statistics

FIX: Test case names with parameters are now correctly displayed in the GUIs build in console.

Improved support of test cases with arguments

Improves PLogger.logF performance for strings < 150 chars

Adds missing common callback functions for SPI6

Adds common callback functions for HAL SPI error callback

Fixes a bug where the miniHIL executable was deleted if the tests failed and if the assemble and runTests gradle tasks were used together

This release contains the preview of the new HTML test report generator. We are interested in your feedback!

This release contains the first version of the standalone MiniHIL GUI (documentation).

Adds timestampLogs project property which enables gui and headless test outputs to be generated into sub-folders named with the current date and time. (Add timestampLogs=true to your gradle.properties file).

Adds a --passthroughMultichannelIds [channelID] option to the GUI and headless test executor.

Support automatic retry for unstable tests, see (more)

Breaking: Enables compiler flag -Werror=sign-compare to ensure int/uint compares in CaGe always have the expected result. This might break your projects build if it contains comparisons between singed and unsigned integers (e.g. in custom target code expects). The resulting build errors have to be fixed by adding the appropriate type casts.

Disables unused USB FS (USB 2)

Adds an adapter to control the dac channels connected to the "AnalogOut" header using the PAnOut protocol (minihil.api.adapters.dac.ADACCtrl).

Fixes a usb enumeration issue which allowed only one gui/command line process per PC to connect to a miniHIL board even if multiple miniHIL boards where connected.

Breaking: cageTraces and etTraces are now generated into the corresponding sub folders of the build/tests folder and not directly into the build folder.

NOTE: The generated lin actors now use the baud rate specified in the ldf file. Previously the baud rate was hardcoded to 19200 bps.

Test cases can be selected by name, see (more)

Added Gradle task showTests to output all available test names

Test names defined via file (-PtestFile=) must be separated by new lines only

Adds TestLog_testTrace(const char* format, …​); function which prints strings into the test log and the generated cage traces

Updated to cube IDE v1.10.1

Fixes a regression in 4.1.2 which stopped links in the generated CaGe Traces from opening the correct cage file location in eclipse

Explicitly set in and output file encoding to UTF-8 for all generators to ensure correct encoding of special characters.

Increased max test suite name length to 60 chars. NOTE: If you are using the miniHIL PC variant you have to increase your message queue block size to >= 100 bytes.

Sequence diagrams now show timeouts and more parameter details in step calls, sequence calls, and test cases.

Fixed a bug in the documentation generator, where if a test case sequence/step was referenced in multiple test suites, the test case diagram would only be generated for one of the test suites.

Fixed createFeatureReport arguments handling in headless build. The feature report output files will now always be located in the MiniHilProject/build/tests directory, regardless of the presence of meta information arguments.

This release contains a new IDE release with usability improvements.

Adds finally expects to the CaGe language. finally expects may be used to wait for a message with a specific payload. (more)

Trace contains sequence parameters and graph state states

Added documentation for (State Transition Testing)

Migrated Stm32CubeH7 HAL from v1.2 to v1.10.1. The release notes can be found here. The file is also available as part of the STM32CubeH7 package v1.9.1 (Drivers\STM32H7xx_HAL_Driver\Release_Notes.html).

Updated arm gcc toolchain from v7.3.1 to v10.3.1

Updated gradle from v6.9 to v7.4

Removed ST_LINK_CLI.exe (it is no longer needed, the same functionality is provided by the STM32CubeProgrammer)

Removed obsolete tasks "stLinkFlash", "stLinkReset", "stLinkFlashOnly". Use "flash", "flashOnly" and "reset" instead.

Moved binary build outputs into "build/bin" subdirectory

The build changes should improve build caching and therefore build speed after the initial build has been completed.

Adds two additional UART adapters. One with RS485 DE signal and one with rs232 hardware flow control.

Adds UART3 and allows configuration of rs232 flow control for UART2

This changes how miniHIL boards are addressed when executing test using gradlew. See -Paddress documentation here.

This requires that you switch the connection method to usb when connecting through the gui

NOTE A miniHIL board which has been flashed with the new usb implementation cannot be connected through an old gui. If needed it has to be reprogrammed with the old version first.

Test logs and traces are now generated into a "build" subdirectory of the HilSimGui directory. Update ignore lists accordingly

The gui now produces the same test artifacts as the gradlew command line build

Workaround: Enable "Build Automatically" in your eclipse workspace (From the menu bar choose: Project→Build Automatically, if enabled a checkmark is shown before the menu entry)

Fixes font handle (memory) leak

Updates eTrice and CaGe plugins to the latest version

Console scrollback buffer is limited now. The full output is written to a log.txt file in the gui directory.

Example use case: Trigger actions in python client on pc and from cage testcase. E.g. to control debug probe connected to the pc.

added nanopb protocol buffers library

HilSimGUI provides tcp port for minihil multichannel

Currently the relay ports of the TestPort Provider actor classes generate relay port "portname" is not connected warnings. To avoid those warnings you should make the PortProvider actor classes abstract. E.g. abstract ActorClass MyPortProvider.

Stop now waits for end of frame slot to notify scheduleDone

Option added to notify scheduleDone on schedule rollover

Raw diag frame functionality

Adds multiKey and key-text variants of metaInfo annotation

LIN generator is now run before the code generators are executed.

Fixed regression in DigIn adapters

Removed warning 'import statements using uris are deprecated' in import of models

Improved quickfixes for imports.

Added validation and hyperlinking for new imports.

Model imports can be auto-folded, see eTrice Preferences.

Improved name filtering in eTrice dialogs