emmtrix Wiki - User contributions [en]

emmtrix Studio Release Notes

2025-09-29T08:43:25Z

Oliver.Wolf.EMX:

= emmtrix Studio Release Notes =

== Release 2025.09 ==

=== New Features ===

* New/improved transformations:
** UnityBuildMerger trafo: Added new transformation merging all source files into a single source file
** Inline trafo: Inline transformation learned to remove unused inlined functions

* ONNX models can now be used as input and will be converted to C code with integrated ONNX2C

* emmtrix C to Rust Compiler
** New transformation that converts C code to safe Rust code. Currently supported constructs are:
*** Rust strictly-typed operators and detecting reserved keywords
*** Basic types (bool, integer and float), arrays, structs and unions
*** Typedefs
*** Local, global, static and volatile variables
*** Detection of unsafe constructs and minimal <code>unsafe</code> blocks insertion
*** Function calls
*** Automatic removal of mut
*** printf to print! conversion for known format strings (%d, %i, %u, %X, %c, %s)
*** if, for, while and do while control structures
*** switch to match conversion for simple switch statements
*** sizeof operator
*** String and char literals
*** Pointers and function pointers

=== Improvements ===

* emmtrix Dependency Analyzer (eDA)
** Supporting field-sensitive propagation and multi-dimensional arrays for array-sensitive propagation
** Improved performance and memory consumption
** Shortest-path and reachability analysis can now be disabled
** Report repetitive warnings only once
** Changed handling of blocking variables that only the last effective variable assignments are considered

* emmtrix Performance Estimator (ePE)
** Added setting to switch time metric between average, minimal and maximal for the hierarchical program view
** Added setting to only consider copy instructions

* emmtrix Code Vectorizer (eCV)
** Improved and reduced warnings for WAW, RAW and WAR conflicts
** RISC-V: Supporting vectorization for RISC-V Vector C Intrinsic v1.0
** Improved code generation for comparison operators that return bool
** Improved readability of generated vector code

* C Frontend
** Improved handling of inline assembly with macros and parameters
** Supporting identically-named source files located in different folders
** Support parsing of tasking-specific keywords (if Tasking compiler is selected)
** Supporting designated initializers with multiple designators
** Improved type deduction for conditionals to ensure standards compliance

* Other changes
** Added optional logging of basic project size metrics after loading, initialization, and transformation
** Added support to override system includes for parsing and processing
** Procedure Duplication: Added limit on how often functions are duplicated, default is 100, -1 means no limit

=== Bugfixes ===

* eDA
** Assigns with non-constant array subscripts did not remove previous array-sensitive values
** Array- and field-sensitive values were not considered in conditions
** Fixed incorrect handling of pointer arithmetic with pointers to volatile data

* eCV
** PPU: Fixed compilation errors caused by arrays of type 32-bit <code>long</code>
** Fixed "data type not supported" error in VectorCGeneration for 32-bit <code>long</code>

* Frontend: Fixed handling of enum types

* Code transformations are not applied to functions that are not called in the project anymore. This avoids transformation crashes in these functions.

== Release 2025.03 ==

=== New Features ===
* '''emmtrix Performance Estimator (ePE)'''
** Supporting performance estimation of Simulink blocks
*** Generation of interactive HTML performance report with results mapped to Simulink blocks and hierarchy
*** MBDComments trafo: Added new trafo to parse model-based design comments generated by TargetLink
** Supporting setting of loop trip count and if-block probabilities in the Hierarchical Program View GUI
*** Loops: Set number of iterations
*** If blocks: Set true path execution frequency
*** Functions: Set runtime in cycles or time

* '''emmtrix Dependency Analyzer (eDA)'''
** Supporting bit-level dependency analysis of input/output signals
*** BitBlast trafo: Added new helper trafo that converts a C function into a boolean representation, breaking down operations into individual bit-level logic

* '''emmtrix Code Vectorizer (eCV)'''
** Added support for AVX2 x86 ISA extension
** Added support for ARM SVE ISA extension
** Added support for loop-local structs, structs in vector code generation and continue statements
** Added support for vectorizing math functions:
*** <code>hypotf</code>, <code>tanf</code>, <code>fdimf</code>, <code>logf</code>, <code>log10f</code>, <code>fdimf</code>, <code>fmaf</code>
** Added new perspective for code vectorization
*** Vector code generation for testing, target and simulator
*** Buttons to run and compile code and compare results with sequential input code
* Add support for Triboard TC4D9 Parallel Processing Unit for Synopsis and Tasking

* '''New/improved transformations:'''
** IfMerge trafo: Added new trafo to merge subsequent if statements with compatible condition
** BlockOutlineTrafo: Added new trafo to extract functions from blocks
** DeadStmtRemoval trafo: Added new trafo to remove dead statements
** RemoveIncludes trafo: Added new trafo to remove all non-standard includes and add declarations to source files

=== Improvements ===
* Performance Estimation: Added support for num exec calculation of if blocks with constant values
* BulkProcessing: Added support for a list of passes that should be executed
* Improved support for C23 standard:
** Supporting labels followed by a declaration
** Supporting unnamed parameters in function definitions
* Transformation Framework: Selected transformations can now be set via properties
** Currently supports transformations <code>MBDComments</code> and <code>IdiomRecognizer</code>
* Improved performance of hierarchical program view for larger projects
* Settings dialog now has sections for each supported software platform for easier configuration of different use cases

=== Bugfixes ===
* Fixed bugs in LLVM IR based performance estimation
* Fixed bus in Assembly-based performance estimation

=== Notes ===
* Vectorization: Changed Tasking compiler setting to favor performance over code size
* GUI: Number formatting will now always use English language

== Release 2024.11 ==

=== New Features ===
* New/improved transformations:
** ControlStructSimplify trafo: Added new trafo to simplify control structures
** VarCoalescing trafo: Added transformation to remove unnecessary copy operations by coalescing (i.e. reusing) variables
** ArrayToScalar trafo: Extended trafo to convert arrays to single scalars
** VarSplit trafo: Automatically perform loop if splitting on affected loops
** Vectorization trafo: Using platform SIMD vector length property as default vector length
** LoopUnswitch trafo: Added new trafo to unswitch `for` loops containing `if` conditions
** ConstPropagation trafo: Added `remove_dead_blocks=<no|defensive|aggressive>` parameter to remove dead blocks after constant propagation
** ConstantPropagation now supports arrays
** VectorizeTrafo: Added warnings for constructs that might lead to incorrect code
** Vectorization: Showing analysis abort reasons (For loop structure, analysis of memory accesses, detection of nested structures)
* Target platforms: Implemented Tasking/Synopsys targets for Aurix Triboard TC499a STD
* Vectorization: Supporting sin, cos and exp operations
* Full support for PPU of AURIX TC4x (reduction, rounding, multiply-accumulate...)
* Pragmas: `pragmas.json`: Supporting global, variable, parameter, and function declaration pragmas
* Transformation: Showing reason why a transformation cannot be applied

=== Improvements ===
* CLI: Added new `addtrafo <trafoname> <path> [--jsonparams <params>]` command to add a trafo to the `emx_trafos_v2.json` file
* GUI: Combo box to switch the active project is now disabled while a pass is running
* Performance Estimation: Improved loop analysis by using maximum number of iterations and supporting while loops. Uses maximum number of iterations if available and sets `avg = (min + max)/2`
* CLI: Added new `createproject2 <name> [--folder <dir>]` command
* C parsing: Changed handling of include directories
** Subdirectories of include folder are not automatically added as include folders anymore
** Parsing stops with an error message when an include cannot be resolved
** The name of all parsed header files and where they are included is printed on the console when debugging is enabled

=== Bugfixes ===
* Assembly-based performance estimation: Fixed incorrect code caused by const data type in ?: operator
* Vectorization: Fixed incorrect code generation caused by comments at the end of the for body
* C parsing: Fixed that pragmas within included files were not considered
* LoopInterchange trafo: Fixed exception caused by loop local variable used within variable initialization
* Vectorization: Fixed that all linear memory accesses were considered as indexed
* Vectorization: Fixed vectorization of loops containing unsupported code
* Performance estimation: Fixed handling of nested folder structures for ASM performance estimation

=== Notes ===
* Removed support for GPUs (CUDA and OpenCL code generation)
* Removed support for FPGAs (high-level synthesis)
* ParallelCodeGeneration: Deactivated default static array conversion for test code generation (can be activated in settings)

== Release 2024.07 ==

=== New Features ===

* New/improved transformations
** Deroll trafo: Added new trafo to create loops for similar subsequent statements or constructs
** LoopFusion trafo: Added new trafo to fuse two subsequent for loops with the same iteration space
** PtrResolve trafo: Added new trafo to resolve pointers and replace indirect memory accesses by direct (used in eDA)
** MakeStatic trafo: Added new trafo to make functions static if used only locally to provide optimization potential for the compiler and ease the linking
** ArrayToScalar trafo: Added new trafo to convert arrays to scalars
** LoopUnroll trafo:
*** Added possibility to apply <code>LoopUnroll</code> to all for-loops of selected functions
*** Automatically perform full loop unrolling when the unrolling factor exceeds the constant number of iterations

* emmtrix Dependency Analyzer (eDA)
** Added result caching mechanism to speed up recurring analysis
** Added support for label propagation
** Added shortest-path and reachability report to follow how values/signals propagate

* emmtrix Performance Estimator (ePE)
** Added min/max runtime calculation

=== Improvements ===
* C code handling
** Preserving <code>#define</code> and <code>#undef</code> preprocessor directives
** Parsing C code comments for analysis and code generation
** Added option to set charsets for source code files
** Respecting the correct order of #include directives and other declarations

* GUI Improvements
** Settings: Sorted and restructured settings
** Improved usability of emmtrix Studio project wizard

* Analysis Time Improvements
** Improved performance of SSA calculation
** Improved analysis performance by caching result of variable usage
** Added internal caching for performance estimation
** Improvements of internal type calculations
** Added cache to improve performance to calculations in eDA
** Fixed performance bottleneck in dominator calculation in eDA

* emmtrix Parallel Studio
** Added option to enable parallelization for shared memory (improves global variables synchronization)

* General
** Improved support for pointers in dependency analysis in eDA
** Improved constant propagation by using sparse conditional constant propagation algorithm
** Commandline interface learned to run commands from script file

=== Bugfixes ===
* Fixed handling of enum declarations
* Improved support for nested folder structures
* Crash in SSA algorithm
* Fixed automatic insertion of forward declaration when necessary
* Handling of ArithmeticException e.g. caused by division by zero in const propagation
* Fixed stack overflow in SSA algorithm caused by deep CFGs


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths



= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded
[[Category:emmtrix Tools]]

TC4x PPU Coverage Analysis

2025-06-30T07:52:07Z

Oliver.Wolf.EMX:

During development of a library for the [[Infineon AURIX TC4x Parallel Processing Unit (PPU)]], we had to fulfil safety-critical process requirements (ISO 26262, ASPICE).
One key deliverable was proof of structural code coverage for every safety-relevant unit test.

Traditional host-based coverage tools (e.g. gcov, llvm-cov) assume that the code under test can be built and run natively on the host. Because PPU kernels are developed in a C dialect (Vector C Code) containing PPU-specific SIMD instructions, compiling and executing tests on the host was impossible.

We therefore created a coverage workflow that runs the compiled PPU binary inside the PPU simulator.

==Simulation-Based Coverage Workflow==
[[File:Example HTML coverage report.png|thumb|Example HTML coverage report for PPU]]

Unlike classic host-based coverage methods, we '''do not rely on code instrumentation'''. Instead, the PPU simulator itself provides detailed trace data of '''every instruction executed''' during each test run. This ensures that coverage is measured directly on the final machine code without modifying the binary.

Our implementation utilizes '''TASKING SmartCode''' for compiling the PPU code and the '''Synopsys ARC nSIM Instruction Set Simulator''' for executing the tests. This setup allows for precise tracking of executed instructions and branches during simulation.

Our coverage process follows a simple '''three-step workflow''':

# '''Record per-test coverage''' Each unit test is executed inside the PPU simulator, which generates raw coverage data indicating all executed instructions and branches for that single test.
# '''Merge results''' After all tests have run, we merge the individual coverage data into one consolidated dataset representing the entire project’s coverage.
# '''Generate an HTML report''' The merged coverage data is converted into a human-readable HTML report, allowing developers and quality engineers to review overall coverage levels and identify untested code areas down to the source line.

This approach ensures that our coverage analysis is:

* '''Target-accurate''', because it is based on the real PPU machine code
* '''Non-intrusive''', since it requires no code changes or instrumentation
* '''Fully automatable''', integrating seamlessly into our CI/CD pipelines
* [[File:HTML report vector code.png|thumb|Example HTML coverage report for vectorized C code for PPU]]'''Generically extensible''', allowing adaptation to other toolchains and simulators beyond the current setup

== See Also ==

* [[Infineon AURIX TC4x]]
* [[Infineon AURIX TC4x Parallel Processing Unit (PPU)]]
* [[emmtrix Code Vectorizer]]

== External Links ==

* [https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc4x/ Infineon’s AURIX™ TC4x family of microcontrollers]
* [https://www.tasking.com/products/smartcode/ TASKING SmartCode]
* [https://www.synopsys.com/dw/ipdir.php?ds=sim_nsim Synopsys ARC® nSIM Instruction Set Simulator]

[[Category:emmtrix Tools]]

File:HTML report vector code.png

2025-06-30T07:51:07Z

Oliver.Wolf.EMX:

Example HTML coverage report for vectorized C code

TC4x PPU Coverage Analysis

2025-06-27T14:04:40Z

Oliver.Wolf.EMX:

File:Example HTML coverage report.png

2025-06-27T14:04:07Z

Oliver.Wolf.EMX:

Example HTML coverage report with covered parts marked in green and lines that were not covered marked in red.

Function Duplication

2025-06-12T09:30:31Z

Oliver.Wolf.EMX:

A '''function duplication transformation''' also known as function cloning is a technique commonly used in program optimization, parallelization, and analysis to '''create multiple copies of a function''', each tailored to a specific context or use case. This approach allows for greater flexibility in optimizing or analyzing the function based on how it's used.

= Description =
Function duplication copies an existing function every time the function is called from a different part of the code. Each copy is marked with a _duplicate_<n> suffix to show that multiple versions of the function exist. The additional copies allow individual analysis like constant propagation for each time the function is called.

== When is it applied ==

* When a function is not marked as inline. However, functions called from inline functions may still be copied if all other conditions are met.
* When a function is called more than once
* When the implementation of a function is available
* When the function call is on the call graph started by the root function. Additional calls from functions which are not part of this call graph don't cause any additional copies.

= Where is it useful =

* Static performance estimation of each call allows for more accurate estimation with its context (parameters and their values, memory usage...)
* Parallelization on different uses depending on the load of all cores during the call
* In combination with constant propagation it can provide improved results for the dependency analysis
[[Category:Code Transformation]]

Function Duplication

2025-06-12T09:29:44Z

Oliver.Wolf.EMX: Created page with "A '''function duplication transformation''' also known as function cloning is a technique commonly used in program optimization, parallelization, and analysis to '''create multiple copies of a function''', each tailored to a specific context or use case. This approach allows for greater flexibility in optimizing or analyzing the function based on how it's used. = Description = Function duplication copies an existing function every time the function is called from a dif..."

Constant Propagation

2025-06-03T06:47:38Z

Oliver.Wolf.EMX: Oliver.Wolf.EMX moved page Constant Propagation to Constant Propagation Transformation

#REDIRECT [[Constant Propagation Transformation]]

Constant Propagation Transformation

2025-06-03T06:47:38Z

Oliver.Wolf.EMX: Oliver.Wolf.EMX moved page Constant Propagation to Constant Propagation Transformation

{{DISPLAYTITLE:Constant Propagation Transformation}}

Constant propagation is an optimization technique used in compilers to improve execution efficiency by replacing variables with known constant values during compilation. If an expression consists entirely of constants or previously propagated values, it is evaluated at compile time and replaced with its computed result. This transformation reduces runtime computations, simplifies code, and enables further optimizations by minimizing unnecessary variable assignments. By eliminating redundant calculations, constant propagation enhances program performance while preserving its original behavior.
==Constant Propagation Transformation in emmtrix Studio==
emmtrix Studio implements constant propagation using #pragma directives or via the GUI. Constant propagation is a transformation that propagates all known variable values within the block it is applied to. If an expression consists of propagated values and of constants, it will itself be evaluated and replaced with its constant value.

All arithmetic operations for integral types are supported. Interprocedural propagation, i.e. propagating into and out of function calls, is partially supported.

===Typical Usage and Benefits===
Constant propagation is typically used to generate a clearer code, to reduce complexity for dependency analysis and increase potential for better optimization possibilities.
===Example===
{| class="wikitable"
|-
|<syntaxhighlight lang="c">
/* The following code tests constant propagation applied to main function.
* In the given example, variables a, b and c are known.
* They are propagated to the rest of the body of main.
*/

#pragma EMX_TRANSFORMATION ConstPropagation
int main(void) {
int a = 2;
int b = a;

int c, d;
c = 2 + 2;
d = b + c;

return 0;
}
</syntaxhighlight>
|<syntaxhighlight lang="c">
/* The following code is the generated code after the transformation has been applied.
*/

int main(void) {
int a = 2;
int b = a;
int c;
int d;

c = 4;
d = 6;

return 0;
}
</syntaxhighlight>
|}

=== Parameters ===
{| class="wikitable"
|+
!Id
!Possible Values
!Default Value
!Description
|-
|<code>global</code>
|<code>true, false</code>
|<code>false</code>
|Determines whether the constant propagation should work across function boundaries
|-
|<code>modify_nonstatic_functions</code>
|<code>true, false</code>
|<code>false</code>
|Determines whether the constant propagation may modify non-static functions. This should be used with care as it might be illegal if not all call-sites of the non-static functions are known.
|-
|<code>remove_dead_blocks</code>
|<code>no, defensive, aggressive</code>
|<code>no</code>
|Determines whether parts of the code that are unreachable after constant propagation should be removed. The <code>aggressive</code> variant might seldomly insert additional <code>goto</code> statements in cases where the<code>defensive</code> variant rather keeps some unreachable parts of the code to avoid <code>goto</code> statements.
|}
[[Category:Code Transformation]]

Main Page

2025-05-22T12:45:20Z

Oliver.Wolf.EMX:

__NOTOC__

Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.

{| border="0" style="padding: 10px"
| style="vertical-align: top; padding: 10px;" |
=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix Performance Estimator]]
** [[Mapping TargetLink generated C code back to Simulink blocks]]
* [[emmtrix Dependency Analyzer]]
* [[emmtrix Code Vectorizer]]
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com emmtrix C++ to C Compiler Online]
* [[:Category:emmtrix Studio FAQ|FAQ]]
* [[emmtrix Code Generator]] (discontinued)
* [[emmtrix Model Code Generator]] (discontinued)
| style="vertical-align: top; padding: 10px;" |
=== Supported Architectures ===
* [[TriCore Instruction Set Architecture]]
** [[Infineon AURIX TC2xx]]
** [[Infineon AURIX TC3xx]]
** [[Infineon AURIX TC4x]], including [[Infineon AURIX TC4x Parallel Processing Unit (PPU)|Parallel Processing Unit (PPU)]]
* ... and many more
|-
|
|
|}

=== Compiler Background ===

* [[Loop Transformations]]
* [[:Category:Code Transformation]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== Other Topics ===
* [[C to Z3 Cheat Sheet]]
* [[Eclipse Xcore Cheat Sheet]]
* [[Logical Execution Time (LET)]]
* [[ULP Difference of Float Numbers]]
* [[Automatic C to Rust Translation]]

Infineon AURIX TC3xx

2025-03-25T14:44:46Z

Oliver.Wolf.EMX: /* emmtrix Tools for AURIX TC3xx */

[[File:AURIX TC399 LFBGA-516 plain.jpg|thumb|''Infineon AURIX™ TC3xx second-generation microcontroller (TC399 BGA package). The AURIX TC3xx family integrates multiple TriCore CPUs and on-chip safety/security modules for automotive applications.'' ]]
The '''Infineon AURIX TC3xx''' (Automotive Realtime Integrated neXt-generation architecture) is a family of 32-bit automotive microcontrollers introduced as the second generation of Infineon’s AURIX platform. Launched in 2016 as a successor to the earlier [[Infineon AURIX TC2xx|AURIX TC2xx series]], the TC3xx devices emphasize high performance, functional safety, and embedded security for advanced automotive and industrial applications. AURIX TC3xx microcontrollers feature a hexa-core [[TriCore Instruction Set Architecture|''TriCore'' processor architecture]] with enhanced safety measures, making them well-suited for demanding tasks such as autonomous driving domain controllers, powertrain control, and sensor data fusion in advanced driver-assistance systems (ADAS). The combination of multiple CPU cores, extensive on-chip memory, and a rich peripheral set allows TC3xx chips to deliver real-time responsiveness and reliability in safety-critical environments while meeting stringent automotive standards (such as ISO 26262 for functional safety).<ref name="ref1951907555">Safety Microcontrollers: Texas Instruments Hercules vs Infineon AURIX https://www.linkedin.com/pulse/safety-microcontrollers-texas-instruments-hercules-vs-cook-meng-miet</ref><ref name="ref1428109010">AURIX™ microcontroller TC3xx family of Infineon fuels automated driving and electromobility - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2016/INFATV201610-005.html</ref><ref name="ref1948477695">32-bit TriCore™ AURIX™– TC3xx - Infineon Technologies https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc3xx/</ref>
==Applications==
AURIX TC3xx microcontrollers are used in a variety of safety-critical and high-performance applications across the automotive and industrial sectors. Key application domains include:
*'''Automotive Systems:''' The TC3xx family was primarily designed for automotive use and finds broad application in vehicles’ electronic control units (ECUs). Notably, it is used in ''powertrain and drivetrain control'' (engine management, transmission control, hybrid/electric vehicle inverter control, battery management) where its real-time processing and resilience support precise actuator control. It is also deployed in ''chassis and safety systems'' such as anti-lock braking systems (ABS), electronic stability control, airbag controllers, and electric power steering, leveraging its redundancy and fast response for fail-safe operation. With the growth of ADAS and autonomous driving, AURIX TC3xx devices serve as domain controllers for ''ADAS sensor fusion'', handling data from radar, LiDAR, camera, and ultrasonic sensors and performing environment modeling and decision-making algorithms. Their combination of multiple cores and a built-in radar signal processing sub-system makes them an attractive choice for tasks like front radar processing, sensor fusion hubs, and ''autonomous driving domain controllers'' that must meet ASIL-D safety levels.<ref name="ref14281090102">AURIX™ microcontroller TC3xx family of Infineon fuels automated driving and electromobility - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2016/INFATV201610-005.html</ref><ref name="ref572781451">Safety Joins Performance: Infineon Introduces Automotive Multicore 32-bit Microcontroller Family AURIX™ to Meet Safety and Powertrain Requirements of Upcoming Vehicle Generations - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2012/INFATV201205-040.html</ref>
*'''Industrial Automation and Robotics:''' Infineon has also positioned the AURIX family for use in industrial applications that demand high reliability. The TC3xx MCUs, with their hardware self-test mechanisms and safety documentation, can be found in ''industrial motor drives, robotics controllers, and PLCs (programmable logic controllers)'', where they help achieve functional safety certifications up to SIL-3 (according to IEC 61508). The powerful TriCore cores and rich peripheral set enable complex motor control algorithms (e.g., field-oriented control for servo motors) and real-time sensor processing in factory automation. Additionally, the support for automotive-grade networking (CAN/CAN-FD, Ethernet) and timing peripherals makes them suitable for synchronous control in robotics and machinery. Infineon’s provision of AUTOSAR-compatible software for AURIX has even facilitated its use in non-automotive settings such as medical devices and elevator controllers, where proven safety and security are required.<ref name="ref496771205">Infineon's AURIX™ & TRAVEO™ microcontroller families extend their support for IEC 61508 hardware and software metrics enabling industrial safety up to SIL-3 - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2023/INFATV202303-078.html</ref>
*'''Aerospace and Defense:''' The high fault-tolerance and deterministic performance of the AURIX TC3xx architecture also attract interest for aerospace and other mission-critical uses. In avionics systems or autonomous drones, for instance, the lockstep core configuration and robust error checking of AURIX can provide an added layer of reliability for flight control computers or navigation systems. While primarily an automotive chip, its ability to operate in harsh conditions (−40°C to 150°C range) and to detect internal failures in real-time makes it viable for certain aerospace electronic systems. Some defense and aerospace projects leverage COTS (commercial off-the-shelf) automotive components like AURIX for applications such as unmanned vehicle control and high-reliability communication links, given its safety pedigree. (In these domains, additional analysis and possibly radiation testing would be performed if the devices are used in high-altitude or space environments.)
== Architecture Overview ==
[[File:Infineon TC3xx Architecture.webp|545x545px|thumb]]
=== Processor Cores and Architecture===
The AURIX TC3xx family implements Infineon’s TriCore™ architecture, which uniquely combines aspects of RISC microcontrollers, DSP (digital signal processor) capabilities, and conventional microprocessor features into a single core design. Each TC3xx device can include up to six independent TriCore 32-bit CPU cores (TriCore version 1.6.2), all capable of running at up to 300 MHz clock frequency. Four of these cores can operate in dual-core lockstep pairs (with one core acting as a redundant checker for its partner) to provide fault detection for safety-critical functions. The TriCore cores use a superscalar Harvard architecture with 32-bit instruction words (and support for mixed 16/32-bit instruction encoding for code density). Each core includes a dedicated Floating Point Unit (FPU) for single-precision arithmetic and supports DSP-oriented instructions (e.g. single-cycle 16×16 MAC operations, SIMD for 16-bit/8-bit data) to accelerate signal processing tasks. For fast real-time performance, the architecture offers low interrupt latency (with automatic context save on-chip) and features like zero-overhead loops and a programmable peripheral timer unit for scheduling tasks. In total, a high-end TC3xx (such as the TC39x) provides six 300 MHz cores plus four checker cores, yielding a theoretical processing throughput of up to ~2400 DMIPS (Dhrystone MIPS) when all cores are utilized. This represents roughly a threefold increase in computational power over the previous AURIX generation (which achieved ~740 DMIPS with three cores).<ref name="ref19484776952">32-bit TriCore™ AURIX™– TC3xx - Infineon Technologies https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc3xx/</ref><ref name="ref2022357806">UDE Debug, Trace and Test solutions for Infineon TriCore™ AURIX™ TC32, TC33, TC35, TC36, TC37, TC38, TC39, TC3x Microcontrollers https://www.pls-mc.com/products/infineon-tricore-aurix-tc32-tc33-tc35-tc36-tc37-tc38-tc39-microcontrollers/</ref><ref name="ref14281090103">AURIX™ microcontroller TC3xx family of Infineon fuels automated driving and electromobility - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2016/INFATV201610-005.html</ref>
===Memory Subsystem and Cache===
AURIX TC3xx microcontrollers integrate a large on-chip memory system to meet real-time and safety requirements. Program flash memory sizes range up to 16 MB on the largest models, with over 6 MB of on-chip SRAM available for data and scratchpad usage. Each TriCore CPU has its own tightly-coupled local memories as well as caches: for example, each core includes a 32 KB instruction cache and a 16 KB data cache. In addition, every core has separate local RAM blocks (Harvard architecture) for instructions and data (often termed PSPR and DSPR – Program Scratch-Pad RAM and Data Scratch-Pad RAM) that allow deterministic access for time-critical routines. Shared global memory is provided via a Local Memory Unit (LMU) which can be up to several hundred kilobytes (for instance, 768 KB in the TC39x) accessible by all cores. The memory system is connected by a high-bandwidth internal bus fabric (the SRI crossbar and peripheral buses) that arbitrates access between cores, DMA engines, and peripherals. This architecture ensures that each core can quickly fetch instructions and data either from its local cache/RAM or the central memory, enabling efficient parallel processing. Memory protection hardware is also built-in to isolate tasks of different criticality, an important feature for safety and security.<ref name="ref19484776952" /><ref name="ref5727814512">Safety Joins Performance: Infineon Introduces Automotive Multicore 32-bit Microcontroller Family AURIX™ to Meet Safety and Powertrain Requirements of Upcoming Vehicle Generations - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2012/INFATV201205-040.html</ref>
===Peripherals and Interfaces===
One of the strengths of the AURIX TC3xx architecture is its extensive set of on-chip peripherals and interface controllers, designed to handle the complex networking and I/O needs of modern vehicles and industrial systems. Key peripheral features and interfaces include:<ref name="ref19484776952" /><ref name="ref2022357806" /><ref name="ref14281090103" /><ref name="ref3635926">AURIX Training System Architecture https://www.infineon.com/dgdl/Infineon-AURIX_TC3xx_System_Architecture-Training-v01_00-EN.pdf?fileId=5546d46272e49d2a0172eb476d56739e</ref>

* '''Networking Interfaces:''' Multiple CAN FD controllers (supporting up to 12 CAN-FD channels in high-end variants) for in-vehicle networking, with legacy CAN and LIN interfaces (up to 24 LIN channels) for lower-speed device communication. Many TC3xx devices also integrate up to two FlexRay controllers for time-triggered automotive networks (maintaining compatibility with earlier automotive communication standards). For high-bandwidth data, a Gigabit Ethernet MAC is included, enabling uses like automotive Ethernet (e.g., audio-video bridging and IP-based connectivity).
* '''Analog and Timers:''' A suite of analog peripherals including multiple ADC units for sensor interfacing and motor control, and DACs in some models. Sophisticated timer units are on-chip, notably the Generic Timer Module (GTM) and Capture/Compare Units (CCU6), which can generate complex PWM waveforms and handle events for engine control, power inverters, or robotics with minimal CPU intervention. These timers enable precise control of actuators (e.g. fuel injection timing, electric motor commutation) in real time.
*'''Serial Interfaces:''' SPI, I²C, UART/LIN and other serial interfaces for connecting to external sensors, actuator controllers, and memory. The controllers often support multiple instances (several SPI channels, etc.) to accommodate numerous devices. AURIX TC3xx also provides an external bus interface (EBU) for parallel memory or FPGA connectivity, and an SD/MMC interface (eMMC) to connect external flash memory for data logging or over-the-air update storage.
*'''Dedicated Processing Units:''' Some AURIX TC3xx models include special accelerators, such as a hardware Fast Fourier Transform unit (HW-FFT) and up to two Signal Processing Units (SPUs) optimized for radar signal processing. These enable the microcontroller to handle radar front-end data or other intensive DSP tasks (like Fourier transforms for radar or audio signals) on-chip, which is crucial for advanced driver assistance sensors. There is also a ''Security Module'' (covered in a later section) and a Safety Management Unit that supervise system integrity.
*'''Other On-chip Modules:''' Watchdog timers, error-correction coders for memories (ECC on flash and RAM for reliability), a programmable interrupt system, multiple DMA channels (up to 128 DMA channels) for efficient data movement, and debug interfaces (JTAG and a 2/3-pin DAP) for development. The on-chip debug system supports tracing of program execution (via a built-in Emulation Memory, MCDS) to aid in complex multicore software development.

Overall, the AURIX TC3xx provides a highly integrated SoC-like platform, allowing a single chip to manage tasks ranging from powertrain control and chassis control to infotainment gateways. This high level of integration reduces the need for separate companion chips and helps to lower system complexity and cost.
===Performance and Benchmarking===
Fabricated in a 40 nm embedded flash process<ref name="ref2022357806" />, AURIX TC3xx processors achieve significant performance gains over prior generations while maintaining automotive-grade power efficiency. With six 32-bit cores at 300 MHz (four of them paired in lockstep), a flagship TC3xx device (e.g., TC39x) can deliver up to approximately 2,400 DMIPS of aggregate computing throughput<ref name="ref2022357806" />. In terms of per-core performance, the TriCore architecture yields around 1.3–2.0 DMIPS/MHz depending on the instruction mix, meaning each 300 MHz core can approach ~400–600 DMIPS in optimized scenarios<ref name="ref14281090103" /><ref name="ref1222155140">Infineon AURIX - Wikipedia https://en.wikipedia.org/wiki/Infineon_AURIX</ref>. This is on par with or exceeding many contemporary 32-bit automotive MCUs. The integrated DSP extensions and optional accelerators (like the FFT unit) also enable high-speed signal processing, with Infineon citing up to ~1.8 GFLOPS of DSP throughput for certain operations<ref name="ref1222155140" />.

Real-world performance improvements of the TC3xx over its predecessor are notable: for example, compared to the first-generation AURIX (which offered up to 740 DMIPS), the TC3xx’s expanded core count and clock speed provide roughly three times the computational power on the same type of workload<ref name="ref14281090103" />. This extra headroom allows more functions (such as running multiple control algorithms or sensor fusion tasks in parallel) to be consolidated onto one microcontroller without compromising real-time deadlines<ref name="ref14281090103" />. Despite the increase in speed and core count, the TC3xx family was designed with power and thermal constraints in mind, achieving these gains within similar power consumption envelopes as the previous generation by leveraging the smaller 40 nm process and power-saving features like clock gating<ref name="ref5727814512" />. The deterministic real-time performance (with features like lockstep and tightly-coupled memory) makes the AURIX TC3xx suitable for the most demanding automotive applications, where consistent low latency and high throughput are required simultaneously.

== On-Chip System Connectivity and Bridges ==
[[File:TC3xx On-Chip System Connectivity.png|thumb|SRI Domains]]
The AURIX™ TC3xx Platform has three independent on-chip connectivity resources:

* '''System Resource Interconnect Fabric (SRI Fabric)''' connects the TriCore CPUs, the DMA module, and other high bandwidth requestors to high bandwidth memories and other resources for instruction fetches and data accesses. A key component of the fabric is the SRI crossbar, which connects all the agents in one SRI domain. The SRI crossbar carries the transactions between the SRI Masters and SRI Slaves of the domain. The SRI crossbar supports parallel transactions between different SRI Master and SRI Slave agents. In addition to the parallelism of concurrent requests, it also supports pipelined requests from an SRI Master to a SRI Slave.
* '''System Peripheral Bus (SPB)''' connects the TriCore CPUs, the DMA module, and other SPB masters to the medium and low bandwidth peripherals. SPB masters do not directly connect to the SRI Fabric, and will access SRI attached resources via a SFI_F2S Bridge.
* '''Back Bone Bus (BBB)''' connects the TriCore CPUs, the DMA module, and SPB masters with ADAS resources. SRI Masters do not directly connect to the BBB, but access BBB attached resources via a SFI_S2F Bridge. SPB masters also do not directly connect to the BBB, but access BBB attached resources via bridging over the SRI Fabric.

=== CPU Resource Access Times ===
These tables describe the CPU access times to various resources in CPU clock cycles for the AURIX™ TC3xx Platform. In the case of load or fetch accesses, the access times are the minimum number of CPU stall cycles to complete the access. If there is a conflict for the resource accessed, there may be additional stall cycles till the conflicting access completes.

For write access, the access times are the maximum for a sequence of such access (non-conflicting). In many cases for a singleton access, or a short sequence, write buffering reduces the stall effect seen by a CPU, sometimes to 0. However, as with loads and fetches, if there is a conflict for the resource accessed, there may be additional stall cycles till the conflicting access completes.

==== Access latency for global resources ====
{| class="wikitable"
|+
! CPU Access Type !! CPU stall cycles
!Notes
|-
| Data read from System Peripheral Bus (SPB) || <math>\frac{f_\text{CPU}}{f_\text{SPB}} \cdot (4 + \text{Module Wait State})</math>
| rowspan="2" |The final number of stall cycles will depend on the real number of WS generated by the target resource.
|-
| Data write to System Peripheral Bus (SPB) || <math>\frac{f_\text{CPU}}{f_\text{SPB}} \cdot (4 + \text{Module Wait State})</math>
|-
| Data read from Back Bone Bus (BBB) (TC39x, TC37xED) || <math>9 + \frac{f_\text{CPU}}{f_\text{BBB}} \cdot (5 + \text{Module Wait State})</math>
| rowspan="2" |When SFI_S2F is connected to XBar2 (TC39x and TC37xED) there is an additional latency due to access going through an S2S.
|-
| Data write to Back Bone Bus (BBB) (TC39x, TC37xED) || <math>5 + \frac{f_\text{CPU}}{f_\text{BBB}} \cdot (4 + \text{Module Wait State})</math>
|-
| Data read from Back Bone Bus (BBB) (TC35x, TC33xED) || <math>6 + \frac{f_\text{CPU}}{f_\text{BBB}} \cdot (5 + \text{Module Wait State})</math>
|
|-
| Data write to Back Bone Bus (BBB) (TC35x, TC33xED) || <math>3 + \frac{f_\text{CPU}}{f_\text{BBB}} \cdot (4 + \text{Module Wait State})</math>
|
|}


* '''Module Wait State''': The number of wait states for read and for write accesses is >= 1 and depends on the accessed module and its configuration.


==== CPU Accesses: Stall cycles for local and SRI resources ====
{| class="wikitable"
|+
! CPU Access Type !! Local CPU !! Local SRI !! Remote SRI Domain
|-
| Data read from DSPR || 0 || 7 || 10
|-
| Data write to DSPR || 0 || 5, {{rev|3|with Pipelining}}|| 5, {{rev|4|with Pipelining}}
|-
| Instruction fetch from DSPR || See local SRI column || 7 || 10
|-
| Data read from DLMU || 0 || 7 || 10
|-
| Data write to DLMU || 2 || 5, {{rev|3|with Pipelining}}|| 5, 4
|-
| Instruction fetch from DLMU || See local SRI column || 7 || 10
|-
| Data read from PSPR || See local SRI column || 7 || 10
|-
| Data write to PSPR || See local SRI column || 5, {{rev|3|with Pipelining}}|| 5, {{rev|4|with Pipelining}}
|-
| Instruction fetch from PSPR || 0 || 7 || 10
|-
| Data read from PFlash || 5 + PWS || 10 + PWS || 13 + PWS
|-
| Instruction fetch from PFlash (buffer miss) || 2 + PWS || 9 + PWS || 12 + PWS
|-
| Instruction fetch from PFlash (buffer hit) || 3 || 6 || 9
|-
| Data read from LMU || n.a. || 7 || 10
|-
| Data write to LMU || n.a. || 5, {{rev|3|with Pipelining}}|| 5, {{rev|4|with Pipelining}}
|-
| Instruction fetch from LMU || n.a. || 7 || 10
|-
| Data read from DFlash || n.a. || 5 + 3*(3 + DCWS) || 8 + 3*(3 + DCWS)
|-
| Data read access from EMEM (TC39x, TC37xED) || n.a. || n.a. || 14, {{rev|15|fBBB < fSRI}}
|-
| Data write access to EMEM (TC39x, TC37xED) || n.a. || n.a. || 9
|-
| Data read access from EMEM (TC35x, TC33xED) || n.a. || 11, {{rev|12|fBBB < fSRI}}|| n.a.
|-
| Data write access to EMEM (TC35x, TC33xED) || n.a. || 9 || n.a.
|-
| Data read access from DAM || n.a. || 10 || 13
|-
| Data write access to DAM || n.a. || 7 || 7
|}

* '''Remote SRI Domain''': Only applies to products with SRI extenders. Additional latency due to access going through an S2S
* '''PWS''': Configured PFlash Wait States (Includes cycles for PFlash access cycles only). ECC correction latency is only incurred when the incoming data requires ECC correction.
* '''PWS''': Configured PFlash Wait States (Includes cycles for PFlash access cycles only). ECC correction latency is only incurred when the incoming data requires ECC correction.
* '''DCWS''': Configured DFlash Corrected Wait States (Includes cycles for DFlash access cycles and ECC correction latency)

== CPU Subsystem (CPU0 ... CPU5) ==
[[File:TC3xx Processor Core, Local Memory and Connectivity.png|alt=TC3xx Processor Core, Local Memory and Connectivity|thumb|Processor Core, Local Memory and Connectivity]]The Infineon AURIX TC3xx features up to 6 processor cores implementing the [[Tricore TC1.6.2 Instruction Set Architecture|TC1.6.2 instruction set architecture]]. The following section focuses on the microarchitectural details of the CPU subsystem. For more information about the ISA, please take a look at the [[Tricore Instruction Set Architecture|TC1.6.2 article]].

The processor core connects to the following memories and bus interfaces (where implemented):
*Program Scratch-Pad SRAM (PSPR)
*Data Scratch-Pad SRAM (DSPR)
*Program Cache (PCache)
*Data Cache (DCache)
*Local Memory Unit (DLMU)
*Local Pflash bank (LPB)
*SRI slave interface (x2)
*SRI master Interface
*SPB master interface

=== TC1.6.2P Implementation Features ===
*Most instructions executed in 1 cycle
*Branch instructions in 1, 2 or 3 cycles (using dynamic branch prediction)
*Wide memory interface for fast context switch
* Automatic context save-on-entry and restore-on-exit for: subroutine, interrupt, trap
*Six memory protection register sets
*Dual instruction issuing (in parallel into Integer Pipeline and Load/Store Pipeline)
*Third pipeline for loop instruction only (zero overhead loop)
*Single precision Floating Point Unit (IEEE-754 Compatible)
*Dedicated Integer divide unit
*18 data memory protection ranges, 10 code memory protection ranges arranged in 6 sets

=== Pipeline ===

=== Instruction Timing ===

==Functional Safety and Security Features==
===Hardware Security Module and Encryption===
One of the defining features of the AURIX TC3xx family is its robust hardware-based security subsystem, implemented to protect against cyber threats and unauthorized manipulation of vehicle systems. Each TC3xx MCU includes a dedicated ''Hardware Security Module'' (HSM), which is essentially an on-chip co-processor with its own CPU and cryptographic engine designed to handle secure operations. In the second-generation AURIX (TC3xx), the HSM was upgraded with support for asymmetric cryptography (e.g., RSA, ECC algorithms) in hardware, providing significantly faster public-key encryption and authentication capabilities than pure software implementations. This HSM supports '''EVITA Full''' (the highest level of the EU’s EVITA automotive security requirements), meaning it can perform secure boot, message authentication, and encryption at a level suitable for protecting critical in-vehicle communications. For example, the HSM can encrypt and authenticate CAN/Ethernet messages to prevent spoofing or tampering on the vehicle network, and it can manage cryptographic keys securely isolated from the main application cores.<ref name="ref14281090104">AURIX™ microcontroller TC3xx family of Infineon fuels automated driving and electromobility - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2016/INFATV201610-005.html</ref><ref name="ref20223578062">UDE Debug, Trace and Test solutions for Infineon TriCore™ AURIX™ TC32, TC33, TC35, TC36, TC37, TC38, TC39, TC3x Microcontrollers https://www.pls-mc.com/products/infineon-tricore-aurix-tc32-tc33-tc35-tc36-tc37-tc38-tc39-microcontrollers/</ref>

The security module enables features like '''secure boot''', where the AURIX will only execute firmware that is digitally signed by the vehicle manufacturer, thereby preventing unauthorized or malicious code. It also facilitates ''over-the-air (OTA) updates'' in a secure manner: the TC3xx HSM can verify and decrypt update packages received via telematics, allowing firmware upgrades while protecting against attackers attempting to hijack the software. In addition, the HSM includes a true random number generator and supports protocols for immobilizer and theft protection systems. Infineon’s implementation essentially treats the HSM as an “embedded smart card” inside the microcontroller. This approach, building on Infineon’s expertise in chip card security, helps to safeguard sensitive assets like cryptographic keys and to perform secure operations (encryption, decryption, authentication) in hardware, making attacks significantly more difficult. The strong cybersecurity provisions of the AURIX TC3xx have made it a preferred choice for vehicle gateway ECUs and central body controllers, which are points of entry for connected car communications and thus high-value targets for hackers. By incorporating the HSM, automotive OEMs can implement advanced security features such as encrypted onboard communication (to thwart bus tampering) and secure diagnostics, ensuring the vehicle’s electronic data is protected against cyber threats even as cars become more connected.<ref name="ref14281090104" /><ref name="ref5727814513">Safety Joins Performance: Infineon Introduces Automotive Multicore 32-bit Microcontroller Family AURIX™ to Meet Safety and Powertrain Requirements of Upcoming Vehicle Generations - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2012/INFATV201205-040.html</ref><ref name="ref19484776953">32-bit TriCore™ AURIX™– TC3xx - Infineon Technologies https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc3xx/</ref>
=== Functional Safety and Fault Tolerance===
Beyond cybersecurity, the AURIX TC3xx architecture is built with extensive ''functional safety'' features to meet the highest safety integrity levels in automotive systems. The multi-core design supports ''lockstep operation'', where redundant checker cores run in parallel with main cores and continuously compare results cycle-by-cycle. In TC3xx devices, up to four of the six TriCore CPUs have such lockstep partner cores, allowing the microcontroller to detect any single-point CPU failure instantly (if a discrepancy arises between the core and its checker, a fault is signaled). A ''Safety Management Unit (SMU)'' is integrated on-chip to monitor various fault conditions throughout the device – it aggregates error signals from the lockstep cores, memory ECC monitors, clock/watchdog monitors, and peripheral self-tests, and can initiate safe-state actions (like resetting the chip or signaling an error pin to an external supervisor) if a critical fault is detected. The AURIX safety concept also includes a distributed Memory Protection Unit (MPU) arrangement, with multiple memory protection contexts that prevent errant or malicious code from writing to wrong memory areas. This helps contain faults and eases the integration of software with mixed criticality (Infineon allows partitioning software components of different ASIL levels on the same MCU while keeping them isolated).<ref name="ref14281090104" /><ref name="ref5727814513" /><ref name="ref19519075552">Safety Microcontrollers: Texas Instruments Hercules vs Infineon AURIX https://www.linkedin.com/pulse/safety-microcontrollers-texas-instruments-hercules-vs-cook-meng-miet</ref>

Crucially, the TC3xx family was developed according to ISO 26262 processes and can achieve '''ASIL-D''' (Automotive Safety Integrity Level D), the highest grade for automotive functional safety. Compared to a traditional dual-core lockstep approach, the AURIX’s multi-core safety architecture allowed Infineon to reduce certain safety development overheads (earlier Infineon data suggested up to 30% reduction in safety software workload) by providing built-in safety mechanisms and diagnostics. Infineon supplies a comprehensive safety manual and diagnostic libraries for the AURIX, helping engineers utilize features like CPU self-tests, RAM tests, and CRC checks to comply with safety standards. In addition to automotive standards, the AURIX TC3xx has also been qualified for '''industrial safety''': in 2023, Infineon announced support for IEC 61508 metrics, enabling designs with AURIX to reach SIL-2 and SIL-3 safety integrity levels for industrial applications. This cross-industry safety compliance is facilitated by the MCU’s redundant design and detailed failure mode documentation (FMEDA) provided by Infineon. In summary, the AURIX TC3xx integrates both proactive safety (fault prevention via lockstep, monitoring and protection) and reactive safety (fault detection and safe shutdown), making it a dependable component for systems that cannot afford unintended behavior, whether in cars, factories, or aerospace. <ref name="ref14281090104" /><ref name="ref5727814513" /><ref name="ref4967712052">Infineon's AURIX™ & TRAVEO™ microcontroller families extend their support for IEC 61508 hardware and software metrics enabling industrial safety up to SIL-3 - Infineon Technologies https://www.infineon.com/cms/en/about-infineon/press/market-news/2023/INFATV202303-078.html</ref><ref name="ref196858272">MCUs support industrial functional safety - Electronic Products https://www.electronicproducts.com/mcus-support-industrial-functional-safety/</ref>
== Platform Devices ==
The following table shows a feature overview of the AURIX™ TC3xx Platform family focusing on memory and number of cores.
{| class="wikitable"
!
!Feature
!TC33x
!TC33xEXT
!TC35x
!TC36x
!TC37x
!TC37xEXT
!TC38x
!TC39x
|-
| rowspan="2" |CPUs
|Cores / Checker Cores
|1 / 1
|2 / 1
|3 / 2
|2 / 2
|3 / 2
|3 / 3
|4 / 2
|6 / 4
|-
|Max. Freq.
| colspan="8" |300 MHz
|-
| rowspan="2" |Cache per CPU
|Program [KB]
| colspan="8" |32
|-
|Data [KB]
| colspan="8" |16
|-
| rowspan="3" |SRAM per CPU
|PSPR [KB]
|8
|{{rev|32|CPU0}}
{{rev|64|other}}
|64
|32
|64
|64
|64
|64
|-
|DSPR [KB]
|192
|{{rev|192|CPU0}}
{{rev|64|other}}
|{{rev|240|CPU0&1}}
{{rev|64|other}}
|192
|{{rev|240|CPU0&1}}
{{rev|64|other}}
|{{rev|240|CPU0&1}}
{{rev|64|other}}
|{{rev|240|CPU0&1}}
{{rev|64|other}}
|{{rev|240|CPU0&1}}
{{rev|64|other}}
|-
|DLMU [KB]
|8
|{{rev|8|CPU0}}
{{rev|64|other}}
|64
|64
|64
|64
|64
|64
|-
| rowspan="2" |SRAM global
|LMU [KB]
| -
| -
|512
| -
| -
| -
|128
|768
|-
|DAM [KB]
| -
| -
|32
| -
|64
|64
|128
|128
|-
| rowspan="3" |Extension Memory (EMEM)
|TCM [MB]
| -
|1
|2
| -
| -
|2
| -
|2
|-
|XCM [MB]
| -
| -
| -
| -
| -
|1
| -
|2
|-
|XTM [KB]
| -
|16
|16
| -
| -
|16
| -
|16
|-
| rowspan="2" |Program Flash
|Size [MB]
|2
|4
|4
|4
|6
|10
|10
|16
|-
|Banks [MB]
|1 x 2
|2 x 2
|2 x 2
|2 x 2
|2 x 3
|3 x 3, 1 x 1
|3 x 3, 1 x 1
|5 x 3, 1 x 1
|-
| rowspan="2" |Data Flash
|DF0 Size (single-ended) [KB]
|128
|128
|128
|128
|256
|512
|512
|1024
|-
|DF1 Size (single-ended) [KB]
|128
|128
|128
|128
|128
|128
|128
|128
|-
| rowspan="3" |DMA
|Channels
|64
|64
|64
|64
|128
|128
|128
|128
|-
|Move Engines
|2
|2
|2
|2
|2
|2
|2
|2
|-
|Resource Partitions
|4
|4
|4
|4
|4
|4
|4
|4
|}

== Compilers ==
The AURIX TC3xx family is a series of high-performance microcontrollers widely used in automotive and industrial applications. Compilers for the AURIX TC3xx are crucial for developers aiming to optimize performance, reliability, and safety in their applications. One significant aspect of the compiler landscape for AURIX TC3xx is the limited direct support from mainline open-source compilers such as GCC or LLVM/Clang. The primary reason for this is the stringent requirements for functional safety in automotive and industrial applications, which demand specialized features and compliance with safety standards that are often not met by general-purpose open-source compilers.

=== Commercial Compilers ===

# '''Tasking''': Tasking compilers are renowned for their robust support for automotive applications, offering advanced debugging capabilities and optimization techniques tailored for the AURIX architecture. They provide extensive code optimization, comprehensive debugging tools, and strong support for safety standards such as ISO 26262, making them ideal for developing high-performance, reliable, and safe applications.
# '''HighTec''': The HighTec compiler is a popular choice, known for its Eclipse-based development environment and strong multicore support. HighTec provides both GCC and LLVM-based ports of open-source compilers tailored specifically for the AURIX TC3xx family. These compilers offer efficient parallel execution, advanced code analysis, and an integrated development environment, ensuring robust performance and compliance with safety standards.
# '''Green Hills Software''': Green Hills Software provides a highly optimized toolchain aimed at safety-critical applications, focusing on high performance and strict compliance with automotive standards. Their compiler offers superior optimization, extensive safety features, and a proprietary IDE with specialized tools for automotive development, ensuring developers can meet the stringent demands of functional safety.

=== GCC for AURIX ===

While mainline GCC does not directly support the AURIX TC3xx family, there is an unofficial GCC version available for AURIX. Due to the GNU General Public License (GPL), the source code from HighTec was retrieved and, along with binary versions, published on GitHub:

*GCC 4.9.4/Binutils 2.20/Newlib 1.18 for Tricore Aurix [[https://github.com/volumit/package_494 Source]] [[https://github.com/volumit/tricore_gcc494_mingw_bins Prebuild Mingw Binaries]] [[https://github.com/volumit/tricore_gcc494_linux_bins Prebuild Linux Binaries]]
*GCC 9.4.0/Binutils 2.20/Newlib 1.18 for Tricore Aurix [[https://github.com/volumit/package_940 Source]] [[https://github.com/volumit/tricore_gcc940_mingw_bins Prebuild Mingw Binaries]] [[https://github.com/volumit/tricore_gcc940_linux_bins Prebuild Linux Binaries]]
*GDB 10.0.50 for Tricore Aurix [[https://github.com/volumit/gdb-tricore Source]]
==emmtrix Tools for AURIX TC3xx==
[[File:lowres-Signet Associated Partner EN.eps.png|thumb|305x305px|emmtrix Technologies is Infineon Associated Partner, has over 10 years of experience working with Infineon and their '''AURIX™ microcontroller family''' and has been collaborating for the past five years.]]
emmtrix offers the following tool for the Infineon AURIX TC3xx architecture:
=== emmtrix Performance Estimator ===
[[emmtrix Performance Estimator|emmtrix Performance Estimator (ePE)]] provides static timing analysis of C code. Compared to simulation or measurement on hardware, static performance analysis can be applied significantly earlier in the development process and will deliver results on average 6 months earlier compared to a typical automotive HIL setup. The analysis only takes a few minutes at most and runs on the developer’s PC independently of any target hardware. Function developers can analyze their runnables or SWCs without the need of a fully integrated program. emmtrix Performance Estimator is fully compatible with '''Infineon's AURIX™ [[Infineon AURIX TC2xx|TC2xx]] / TC3xx/ [[Infineon AURIX TC4x|TC4x]] microcontroller family,''' ensuring precise and reliable performance analysis for embedded systems.

A unique feature is the combination with TargetLink or Embedded Coder generated code. Without any measurement overhead, our static performance estimation can analyze even the smallest code snippets. This allows us to map the timing analysis to Simulink blocks, giving function developers insight into the timing behavior of their models.

ePE offers three accuracy levels:

* analysis of C code
* generically compiler-optimized code
* assembly code from the target compiler.

Method 1 yields results with minimum effort while method 3 takes the timing of the processor pipeline into account. All methods offer excellent reliability when tracking the tendency of changes in software runtimes e.g. when used in a continuous integration environment.

=== Services ===

==See Also==

*[[Infineon AURIX TC4x]]
*[[Infineon AURIX TC2xx]]
*[[TriCore Instruction Set Architecture]]

==External Links==

*https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc3xx/
*[https://documentation.infineon.com/aurixtc3xx/docs/qmd1702366622648 AURIX TC3xx user manuals]
**[https://www.infineon.com/dgdl/Infineon-AURIX_TC3xx_Part1-UserManual-v02_00-EN.pdf?fileId=5546d462712ef9b701717d3605221d96 AURIX™ TC3xx User Manual Part-1]
**[https://www.infineon.com/dgdl/Infineon-AURIX_TC3xx_Part2-UserManual-v02_00-EN.pdf?fileId=5546d462712ef9b701717d35f8541d94 AURIX™ TC3xx User Manual Part-2]
**[https://www.infineon.com/dgdl/Infineon-AURIX_TC3xx_Architecture_vol1-UserManual-v01_00-EN.pdf?fileId=5546d46276fb756a01771bc4c2e33bdd AURIX™ TC3xx Architecture vol 1]
**[https://www.infineon.com/dgdl/Infineon-AURIX_TC3xx_Architecture_vol2-UserManual-v01_00-EN.pdf?fileId=5546d46276fb756a01771bc4a6d73b70 AURIX™ TC3xx Architecture vol 2]

== References ==
<references />
[[Category:Supported Architectures]]

Infineon AURIX TC4x

2025-03-25T14:44:22Z

Oliver.Wolf.EMX:

[[File:Infineon Aurix TC4x.webp|right|frameless]]
The TC4x is Infineon's latest generation of AURIX™ microcontrollers, designed for advanced automotive applications, including eMobility, Advanced Driver Assistance Systems (ADAS), and automotive E/E (Electric/Electronic) architectures. These microcontrollers are built on a 28 nm process and feature the [[TriCore Instruction Set Architecture|TriCore™ 1.8 instruction set architecture]], which includes up to six cores running at speeds up to 500 MHz. This architecture is optimized for high-performance and real-time applications.

== Key Features ==
* '''High Performance and Scalability''': Equipped with a Parallel Processing Unit (PPU), Data Routing Engine (DRE), and other accelerators to enhance AI capabilities and real-time processing.
* '''Extensive Connectivity''': Supports high-speed communication interfaces such as 5 Gbps Ethernet, PCIe, CAN-XL, and 10BASE-T1S Ethernet, providing flexibility and performance for various automotive applications.
* '''Enhanced Security''': Compliant with ISO 21434, the TC4x includes advanced cybersecurity modules and supports safe, over-the-air (SOTA) updates with zero downtime.
* '''Memory and Storage''': Features up to 25 MB of on-chip flash memory, allowing for complex software applications and data storage.
* '''Real-Time Control''': Advanced timers and ADCs (Analog-to-Digital Converters) improve control loops for electric motors and power conversion tasks.

== Architecture ==
[[File:Infineon TC4x Architecture.png|thumb|Infineon TC4x architecture|494x494px]]

=== System Architecture ===

=== TC 1.8P Processor Core (CPU0 ... CPU5) ===

=== Parallel Processing Unit (PPU) ===
The PPU is an implementation of the '''DesignWare ARC EV71 Processor'''. The length of the vector registers is flexible and depends on the version. Commercially, 128 or 256 bit vector registers are available. In a pre-series stepping even 512 bit was used.

== Applications ==
* eMobility
* ADAS
* Automotive E/E architectures
* Affordable artificial intelligence (AI) applications

== emmtrix Tools for AURIX TC4x ==
emmtrix offers several tools for the Infineon AURIX TC4x architecture:

* [https://www.emmtrix.com/tools/emmtrix-code-vectorizer emmtrix Code Vectorizer] for vectorizing C code for the Infineon PPU. emmtrix was working together with Infineon already during develop of the TC4x architecture for supporting the PPU and received one of the first series A test boards.
* [https://www.emmtrix.com/tools/emmtrix-performance-estimatorator emmtrix Performance Estimator] for estimating the performance of C code written for the Tricore CPUs.

[[File:Infineon Board.png|thumb|Infineon Development Board (AURIX™ TC4x Communication Board)]]

=== emmtrix Code Vectorizer ===
[https://www.emmtrix.com/tools/emmtrix-code-vectorizer emmtrix Code Vectorizer (eCV)] simplifies programming the Parallel Processing Unit (PPU) on Infineon’s '''AURIX™ TC4x microcontrollers''', enabling significant acceleration of data-parallel applications like sensor fusion or AI inference. By leveraging the PPU, these tasks can be accelerated by factors >10, unlocking the full potential of hardware capabilities.

eCV automates the vectorization process, transforming sequential C code into optimized vectorized code tailored to the '''AURIX™ TC4x architecture'''. This includes efficient handling of memory layouts and advanced loop transformations. Developers can simulate and test functionality even without access to target hardware, reducing development time and effort.

With support for '''Simulink® models, ONNX-based AI workflows,''' and detailed performance insights through integrated simulators, eCV minimizes the need for manual optimization while maximizing hardware performance.[[File:lowres-Signet Associated Partner EN.eps.png|thumb|305x305px|emmtrix Technologies is Infineon Associated Partner, has over 10 years of experience working with Infineon and their '''AURIX™ microcontroller family''' and has been collaborating for the past five years.]]

=== emmtrix Performance Estimator ===
[[emmtrix Performance Estimator|emmtrix Performance Estimator (ePE)]] provides static timing analysis of C code. Compared to simulation or measurement on hardware, static performance analysis can be applied significantly earlier in the development process and will deliver results on average 6 months earlier compared to a typical automotive HIL setup. The analysis only takes a few minutes at most and runs on the developer’s PC independently of any target hardware. Function developers can analyze their runnables or SWCs without the need of a fully integrated program. emmtrix Performance Estimator is fully compatible with '''Infineon's AURIX™ [[Infineon AURIX TC2xx|TC2xx]] / [[Infineon AURIX TC3xx|TC3xx]]/ TC4x microcontroller family,''' ensuring precise and reliable performance analysis for embedded systems.

A unique feature is the combination with TargetLink or Embedded Coder generated code. Without any measurement overhead, our static performance estimation can analyze even the smallest code snippets. This allows us to map the timing analysis to Simulink blocks, giving function developers insight into the timing behavior of their models.

ePE offers three accuracy levels:

* analysis of C code
* generically compiler-optimized code
* assembly code from the target compiler.

Method 1 yields results with minimum effort while method 3 takes the timing of the processor pipeline into account. All methods offer excellent reliability when tracking the tendency of changes in software runtimes e.g. when used in a continuous integration environment.

=== Services ===

== See Also ==

* [[Infineon AURIX TC3xx]]
* [[TriCore Instruction Set Architecture]]

== External Links ==

* https://www.infineon.com/cms/en/product/microcontroller/32-bit-tricore-microcontroller/32-bit-tricore-aurix-tc4x/

[[Category:Supported Architectures]]

emmtrix Studio Release Notes

2025-03-14T09:40:10Z

Oliver.Wolf.EMX: /* emmtrix Studio Release Notes */

= emmtrix Studio Release Notes =

== Release 2025.03 ==

=== New Features ===
* '''emmtrix Performance Estimator (ePE)'''
** Supporting performance estimation of Simulink blocks
*** Generation of interactive HTML performance report with results mapped to Simulink blocks and hierarchy
*** MBDComments trafo: Added new trafo to parse model-based design comments generated by TargetLink
** Supporting setting of loop trip count and if-block probabilities in the Hierarchical Program View GUI
*** Loops: Set number of iterations
*** If blocks: Set true path execution frequency
*** Functions: Set runtime in cycles or time

* '''emmtrix Dependency Analyzer (eDA)'''
** Supporting bit-level dependency analysis of input/output signals
*** BitBlast trafo: Added new helper trafo that converts a C function into a boolean representation, breaking down operations into individual bit-level logic

* '''emmtrix Code Vectorizer (eCV)'''
** Added support for AVX2 x86 ISA extension
** Added support for ARM SVE ISA extension
** Added support for loop-local structs, structs in vector code generation and continue statements
** Added support for vectorizing math functions:
*** <code>hypotf</code>, <code>tanf</code>, <code>fdimf</code>, <code>logf</code>, <code>log10f</code>, <code>fdimf</code>, <code>fmaf</code>
** Added new perspective for code vectorization
*** Vector code generation for testing, target and simulator
*** Buttons to run and compile code and compare results with sequential input code
* Add support for Triboard TC4D9 Parallel Processing Unit for Synopsis and Tasking

* '''New/improved transformations:'''
** IfMerge trafo: Added new trafo to merge subsequent if statements with compatible condition
** BlockOutlineTrafo: Added new trafo to extract functions from blocks
** DeadStmtRemoval trafo: Added new trafo to remove dead statements
** RemoveIncludes trafo: Added new trafo to remove all non-standard includes and add declarations to source files

=== Improvements ===
* Performance Estimation: Added support for num exec calculation of if blocks with constant values
* BulkProcessing: Added support for a list of passes that should be executed
* Improved support for C23 standard:
** Supporting labels followed by a declaration
** Supporting unnamed parameters in function definitions
* Transformation Framework: Selected transformations can now be set via properties
** Currently supports transformations <code>MBDComments</code> and <code>IdiomRecognizer</code>
* Improved performance of hierarchical program view for larger projects
* Settings dialog now has sections for each supported software platform for easier configuration of different use cases

=== Bugfixes ===
* Fixed bugs in LLVM IR based performance estimation
* Fixed bus in Assembly-based performance estimation

=== Notes ===
* Vectorization: Changed Tasking compiler setting to favor performance over code size
* GUI: Number formatting will now always use English language

== Release 2024.11 ==

=== New Features ===
* New/improved transformations:
** ControlStructSimplify trafo: Added new trafo to simplify control structures
** VarCoalescing trafo: Added transformation to remove unnecessary copy operations by coalescing (i.e. reusing) variables
** ArrayToScalar trafo: Extended trafo to convert arrays to single scalars
** VarSplit trafo: Automatically perform loop if splitting on affected loops
** Vectorization trafo: Using platform SIMD vector length property as default vector length
** LoopUnswitch trafo: Added new trafo to unswitch `for` loops containing `if` conditions
** ConstPropagation trafo: Added `remove_dead_blocks=<no|defensive|aggressive>` parameter to remove dead blocks after constant propagation
** ConstantPropagation now supports arrays
** VectorizeTrafo: Added warnings for constructs that might lead to incorrect code
** Vectorization: Showing analysis abort reasons (For loop structure, analysis of memory accesses, detection of nested structures)
* Target platforms: Implemented Tasking/Synopsys targets for Aurix Triboard TC499a STD
* Vectorization: Supporting sin, cos and exp operations
* Full support for PPU of AURIX TC4x (reduction, rounding, multiply-accumulate...)
* Pragmas: `pragmas.json`: Supporting global, variable, parameter, and function declaration pragmas
* Transformation: Showing reason why a transformation cannot be applied

=== Improvements ===
* CLI: Added new `addtrafo <trafoname> <path> [--jsonparams <params>]` command to add a trafo to the `emx_trafos_v2.json` file
* GUI: Combo box to switch the active project is now disabled while a pass is running
* Performance Estimation: Improved loop analysis by using maximum number of iterations and supporting while loops. Uses maximum number of iterations if available and sets `avg = (min + max)/2`
* CLI: Added new `createproject2 <name> [--folder <dir>]` command
* C parsing: Changed handling of include directories
** Subdirectories of include folder are not automatically added as include folders anymore
** Parsing stops with an error message when an include cannot be resolved
** The name of all parsed header files and where they are included is printed on the console when debugging is enabled

=== Bugfixes ===
* Assembly-based performance estimation: Fixed incorrect code caused by const data type in ?: operator
* Vectorization: Fixed incorrect code generation caused by comments at the end of the for body
* C parsing: Fixed that pragmas within included files were not considered
* LoopInterchange trafo: Fixed exception caused by loop local variable used within variable initialization
* Vectorization: Fixed that all linear memory accesses were considered as indexed
* Vectorization: Fixed vectorization of loops containing unsupported code
* Performance estimation: Fixed handling of nested folder structures for ASM performance estimation

=== Notes ===
* Removed support for GPUs (CUDA and OpenCL code generation)
* Removed support for FPGAs (high-level synthesis)
* ParallelCodeGeneration: Deactivated default static array conversion for test code generation (can be activated in settings)

== Release 2024.07 ==

=== New Features ===

* New/improved transformations
** Deroll trafo: Added new trafo to create loops for similar subsequent statements or constructs
** LoopFusion trafo: Added new trafo to fuse two subsequent for loops with the same iteration space
** PtrResolve trafo: Added new trafo to resolve pointers and replace indirect memory accesses by direct (used in eDA)
** MakeStatic trafo: Added new trafo to make functions static if used only locally to provide optimization potential for the compiler and ease the linking
** ArrayToScalar trafo: Added new trafo to convert arrays to scalars
** LoopUnroll trafo:
*** Added possibility to apply <code>LoopUnroll</code> to all for-loops of selected functions
*** Automatically perform full loop unrolling when the unrolling factor exceeds the constant number of iterations

* emmtrix Dependency Analyzer (eDA)
** Added result caching mechanism to speed up recurring analysis
** Added support for label propagation
** Added shortest-path and reachability report to follow how values/signals propagate

* emmtrix Performance Estimator (ePE)
** Added min/max runtime calculation

=== Improvements ===
* C code handling
** Preserving <code>#define</code> and <code>#undef</code> preprocessor directives
** Parsing C code comments for analysis and code generation
** Added option to set charsets for source code files
** Respecting the correct order of #include directives and other declarations

* GUI Improvements
** Settings: Sorted and restructured settings
** Improved usability of emmtrix Studio project wizard

* Analysis Time Improvements
** Improved performance of SSA calculation
** Improved analysis performance by caching result of variable usage
** Added internal caching for performance estimation
** Improvements of internal type calculations
** Added cache to improve performance to calculations in eDA
** Fixed performance bottleneck in dominator calculation in eDA

* emmtrix Parallel Studio
** Added option to enable parallelization for shared memory (improves global variables synchronization)

* General
** Improved support for pointers in dependency analysis in eDA
** Improved constant propagation by using sparse conditional constant propagation algorithm
** Commandline interface learned to run commands from script file

=== Bugfixes ===
* Fixed handling of enum declarations
* Improved support for nested folder structures
* Crash in SSA algorithm
* Fixed automatic insertion of forward declaration when necessary
* Handling of ArithmeticException e.g. caused by division by zero in const propagation
* Fixed stack overflow in SSA algorithm caused by deep CFGs


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths



= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded
[[Category:emmtrix Tools]]

emmtrix Studio Release Notes

2024-11-29T20:24:47Z

Oliver.Wolf.EMX: /* emmtrix Studio Release Notes */

= emmtrix Studio Release Notes =

== Release 2024.11 ==

=== New Features ===
* New/improved transformations:
** ControlStructSimplify trafo: Added new trafo to simplify control structures
** VarCoalescing trafo: Added transformation to remove unnecessary copy operations by coalescing (i.e. reusing) variables
** ArrayToScalar trafo: Extended trafo to convert arrays to single scalars
** VarSplit trafo: Automatically perform loop if splitting on affected loops
** Vectorization trafo: Using platform SIMD vector length property as default vector length
** LoopUnswitch trafo: Added new trafo to unswitch `for` loops containing `if` conditions
** ConstPropagation trafo: Added `remove_dead_blocks=<no|defensive|aggressive>` parameter to remove dead blocks after constant propagation
** ConstantPropagation now supports arrays
** VectorizeTrafo: Added warnings for constructs that might lead to incorrect code
** Vectorization: Showing analysis abort reasons (For loop structure, analysis of memory accesses, detection of nested structures)
* Target platforms: Implemented Tasking/Synopsys targets for Aurix Triboard TC499a STD
* Vectorization: Supporting sin, cos and exp operations
* Full support for PPU of AURIX TC4x (reduction, rounding, multiply-accumulate...)
* Pragmas: `pragmas.json`: Supporting global, variable, parameter, and function declaration pragmas
* Transformation: Showing reason why a transformation cannot be applied

=== Improvements ===
* CLI: Added new `addtrafo <trafoname> <path> [--jsonparams <params>]` command to add a trafo to the `emx_trafos_v2.json` file
* GUI: Combo box to switch the active project is now disabled while a pass is running
* Performance Estimation: Improved loop analysis by using maximum number of iterations and supporting while loops. Uses maximum number of iterations if available and sets `avg = (min + max)/2`
* CLI: Added new `createproject2 <name> [--folder <dir>]` command
* C parsing: Changed handling of include directories
** Subdirectories of include folder are not automatically added as include folders anymore
** Parsing stops with an error message when an include cannot be resolved
** The name of all parsed header files and where they are included is printed on the console when debugging is enabled

=== Bugfixes ===
* Assembly-based performance estimation: Fixed incorrect code caused by const data type in ?: operator
* Vectorization: Fixed incorrect code generation caused by comments at the end of the for body
* C parsing: Fixed that pragmas within included files were not considered
* LoopInterchange trafo: Fixed exception caused by loop local variable used within variable initialization
* Vectorization: Fixed that all linear memory accesses were considered as indexed
* Vectorization: Fixed vectorization of loops containing unsupported code
* Performance estimation: Fixed handling of nested folder structures for ASM performance estimation

=== Notes ===
* Removed support for GPUs (CUDA and OpenCL code generation)
* Removed support for FPGAs (high-level synthesis)
* ParallelCodeGeneration: Deactivated default static array conversion for test code generation (can be activated in settings)

== Release 2024.07 ==

=== New Features ===

* New/improved transformations
** Deroll trafo: Added new trafo to create loops for similar subsequent statements or constructs
** LoopFusion trafo: Added new trafo to fuse two subsequent for loops with the same iteration space
** PtrResolve trafo: Added new trafo to resolve pointers and replace indirect memory accesses by direct (used in eDA)
** MakeStatic trafo: Added new trafo to make functions static if used only locally to provide optimization potential for the compiler and ease the linking
** ArrayToScalar trafo: Added new trafo to convert arrays to scalars
** LoopUnroll trafo:
*** Added possibility to apply <code>LoopUnroll</code> to all for-loops of selected functions
*** Automatically perform full loop unrolling when the unrolling factor exceeds the constant number of iterations

* emmtrix Dependency Analyzer (eDA)
** Added result caching mechanism to speed up recurring analysis
** Added support for label propagation
** Added shortest-path and reachability report to follow how values/signals propagate

* emmtrix Performance Estimator (ePE)
** Added min/max runtime calculation

=== Improvements ===
* C code handling
** Preserving <code>#define</code> and <code>#undef</code> preprocessor directives
** Parsing C code comments for analysis and code generation
** Added option to set charsets for source code files
** Respecting the correct order of #include directives and other declarations

* GUI Improvements
** Settings: Sorted and restructured settings
** Improved usability of emmtrix Studio project wizard

* Analysis Time Improvements
** Improved performance of SSA calculation
** Improved analysis performance by caching result of variable usage
** Added internal caching for performance estimation
** Improvements of internal type calculations
** Added cache to improve performance to calculations in eDA
** Fixed performance bottleneck in dominator calculation in eDA

* emmtrix Parallel Studio
** Added option to enable parallelization for shared memory (improves global variables synchronization)

* General
** Improved support for pointers in dependency analysis in eDA
** Improved constant propagation by using sparse conditional constant propagation algorithm
** Commandline interface learned to run commands from script file

=== Bugfixes ===
* Fixed handling of enum declarations
* Improved support for nested folder structures
* Crash in SSA algorithm
* Fixed automatic insertion of forward declaration when necessary
* Handling of ArithmeticException e.g. caused by division by zero in const propagation
* Fixed stack overflow in SSA algorithm caused by deep CFGs


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths



= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded
[[Category:emmtrix Tools]]

Main Page

2024-09-16T14:22:39Z

Oliver.Wolf.EMX:

__NOTOC__

Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.

{| border="0" style="padding: 10px"
| style="vertical-align: top; padding: 10px;" |
=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix Performance Estimator]]
** [[Mapping TargetLink generated C code back to Simulink blocks]]
* [[emmtrix Dependency Analyzer]]
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com emmtrix C++ to C Compiler Online]
* [[:Category:emmtrix Studio FAQ|FAQ]]
| style="vertical-align: top; padding: 10px;" |
=== Supported Architectures ===
* [[Infineon AURIX TC3xx]]
* [[Infineon AURIX TC4x]]
* ... and many more

|}

=== Compiler Background ===

* [[Loop Transformations]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== Other Topics ===
* [[C to Z3 Cheat Sheet]]
* [[Eclipse Xcore Cheat Sheet]]

emmtrix Studio Release Notes

2024-08-07T08:04:24Z

Oliver.Wolf.EMX: /* emmtrix Studio Release Notes */

= emmtrix Studio Release Notes =

== Release 2024.07 ==

=== New Features ===

* New/improved transformations
** Deroll trafo: Added new trafo to create loops for similar subsequent statements or constructs
** LoopFusion trafo: Added new trafo to fuse two subsequent for loops with the same iteration space
** PtrResolve trafo: Added new trafo to resolve pointers and replace indirect memory accesses by direct (used in eDA)
** MakeStatic trafo: Added new trafo to make functions static if used only locally to provide optimization potential for the compiler and ease the linking
** ArrayToScalar trafo: Added new trafo to convert arrays to scalars
** LoopUnroll trafo:
*** Added possibility to apply <code>LoopUnroll</code> to all for-loops of selected functions
*** Automatically perform full loop unrolling when the unrolling factor exceeds the constant number of iterations

* emmtrix Dependency Analyzer (eDA)
** Added result caching mechanism to speed up recurring analysis
** Added support for label propagation
** Added shortest-path and reachability report to follow how values/signals propagate

* emmtrix Performance Estimator (ePE)
** Added min/max runtime calculation

=== Improvements ===
* C code handling
** Preserving <code>#define</code> and <code>#undef</code> preprocessor directives
** Parsing C code comments for analysis and code generation
** Added option to set charsets for source code files
** Respecting the correct order of #include directives and other declarations

* GUI Improvements
** Settings: Sorted and restructured settings
** Improved usability of emmtrix Studio project wizard

* Analysis Time Improvements
** Improved performance of SSA calculation
** Improved analysis performance by caching result of variable usage
** Added internal caching for performance estimation
** Improvements of internal type calculations
** Added cache to improve performance to calculations in eDA
** Fixed performance bottleneck in dominator calculation in eDA

* emmtrix Parallel Studio
** Added option to enable parallelization for shared memory (improves global variables synchronization)

* General
** Improved support for pointers in dependency analysis in eDA
** Improved constant propagation by using sparse conditional constant propagation algorithm
** Commandline interface learned to run commands from script file

=== Bugfixes ===
* Fixed handling of enum declarations
* Improved support for nested folder structures
* Crash in SSA algorithm
* Fixed automatic insertion of forward declaration when necessary
* Handling of ArithmeticException e.g. caused by division by zero in const propagation
* Fixed stack overflow in SSA algorithm caused by deep CFGs


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths



= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded
[[Category:emmtrix Tools]]

emmtrix Studio Release Notes

2024-08-07T08:02:38Z

Oliver.Wolf.EMX: /* emmtrix Studio Release Notes */

= emmtrix Studio Release Notes =

== Release 2024.07 ==

=== New Features ===

* New/improved transformations
** Deroll trafo: Added new trafo to create loops for similar subsequent statements or constructs
** LoopFusion trafo: Added new trafo to fuse two subsequent for loops with the same iteration space
** PtrResolve trafo: Added new trafo to resolve pointers and replace indirect memory accesses by direct (used in eDA)
** MakeStatic trafo: Added new trafo to make functions static if used only locally to provide optimization potential for the compiler and ease the linking
** ArrayToScalar trafo: Added new trafo to convert arrays to scalars
** LoopUnroll trafo:
*** Added possibility to apply `LoopUnroll` to all for-loops of selected functions
*** Automatically perform full loop unrolling when the unrolling factor exceeds the constant number of iterations

* emmtrix Dependency Analyzer (eDA)
** Added result caching mechanism to speed up recurring analysis
** Added support for label propagation
** Added shortest-path and reachability report to follow how values/signals propagate

* emmtrix Performance Estimator (ePE)
** Added min/max runtime calculation

=== Improvements ===
* C code handling
** Preserving `#define` and `#undef` preprocessor directives
** Parsing C code comments for analysis and code generation
** Added option to set charsets for source code files
** Respecting the correct order of #include directives and other declarations

* GUI Improvements
** Settings: Sorted and restructured settings
** Improved usability of emmtrix Studio project wizard

* Analysis Time Improvements
** Improved performance of SSA calculation
** Improved analysis performance by caching result of variable usage
** Added internal caching for performance estimation
** Improvements of internal type calculations
** Added cache to improve performance to calculations in eDA
** Fixed performance bottleneck in dominator calculation in eDA

* emmtrix Parallel Studio
** Added option to enable parallelization for shared memory (improves global variables synchronization)

* General
** Improved support for pointers in dependency analysis in eDA
** Improved constant propagation by using sparse conditional constant propagation algorithm
** Commandline interface learned to run commands from script file

=== Bugfixes ===
* Fixed handling of enum declarations
* Improved support for nested folder structures
* Crash in SSA algorithm
* Fixed automatic insertion of forward declaration when necessary
* Handling of ArithmeticException e.g. caused by division by zero in const propagation
* Fixed stack overflow in SSA algorithm caused by deep CFGs


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths



= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded
[[Category:emmtrix Tools]]

Mapping TargetLink generated C code back to Simulink blocks

2024-05-15T07:23:50Z

Oliver.Wolf.EMX:

When using TargetLink to generate C code out of Simulink models, the C code contains comments that indicate from which block the C code was generated from.

In the simplest case it looks like this:

<pre> /* Sum: MyModel/SubSystem/Sum */
res = var1 + var2;
</pre>
The statement `res = var1 + var2;` is generated from a block `Sum` inside the `SubSystem` of `MyModel`.

TargetLink tries to optimize the code by combining different statements:
<pre> /* Sum: MyModel/SubSystem/Sum
## combined ## Sum: MyModel/SubSystem/Sum2 */
res = (var1 + var2) - var3;
</pre>
Here, the code of the blocks `Sum` and `Sum1` are combined into a single statement and assigned to the variable `res`. The statement can therefore be mapped partially to each of the Sum blocks.

This can become more complicated with control structures like if blocks:
<pre> /* Switch: MyModel/SubSystem/Switch
## combined ## Product: MyModel/SubSystem/product
## combined ## Product: MyModel/SubSystem/product2 */
if (enable) {
res = var1 * var 2;
} else {
res = var3 * var4;
}
</pre>
Here, both product blocks were combined with the if block.

Some parts of the code will be generated to handle array accesses like in this example:
<pre> for (Aux_S32 = 0; Aux_S32 < 75; Aux_S32++) {
/* Assignment: MyModel/SubSystem/Assignment - output initialization */
data[Aux_S32] = 0;
}
</pre>
While the for loop doesn't have a comment on it's own, the code belongs to the Assignment block as can be extracted from the comment inside the loop. These kind of loops use an iterator variable with a name containing `aux`, usually have a fixed length and are used to perform operations over indices of an array.

Other loops use iterator variables with names based on existing sub systems:
<pre> for (SBS25_For_Iterator_it = 1; SBS25_For_Iterator_it <= 2; SBS25_For_Iterator_it++) {
/* Sum: MyModel/SubSystem/for_loop/Sum */
res = var1 + var2;
}
</pre>
`SBS25_For` is the name of a subsystem that is defined like this at the top of the file:
<pre>*** SBS25 MyModel/SubSystem/for_loop
</pre>
It is typically a for loop used in the model that can contain several internal blocks.

Mapping TargetLink generated C code back to Simulink blocks

2024-05-08T12:04:45Z

Oliver.Wolf.EMX: Created page with "When using TargetLink to generate C code out of Simulink models, the C code contains comments that indicate from which block the C code was generated from. In the simplest case it looks like this: <pre> /* Sum: MyModel/SubSystem/Sum */ res = var1 + var2; </pre> The statement `res = var1 + var2;` is generated from a block `Sum` inside the `SubSystem` of `MyModel`. TargetLink tries to optimize the code by combining different statements: <pre> /* Sum: MyModel/SubSys..."

When using TargetLink to generate C code out of Simulink models, the C code contains comments that indicate from which block the C code was generated from.

In the simplest case it looks like this:

<pre> /* Sum: MyModel/SubSystem/Sum */
res = var1 + var2;
</pre>
The statement `res = var1 + var2;` is generated from a block `Sum` inside the `SubSystem` of `MyModel`.

TargetLink tries to optimize the code by combining different statements:
<pre> /* Sum: MyModel/SubSystem/Sum
== combined == Sum: MyModel/SubSystem/Sum2 */
res = (var1 + var2) - var3;
</pre>
Here, the code of the blocks `Sum` and `Sum1` are combined into a single statement and assigned to the variable `res`. The statement can therefore be mapped partially to each of the Sum blocks.

This can become more complicated with control structures like if blocks:
<pre> /* Switch: MyModel/SubSystem/Switch
== combined == Product: MyModel/SubSystem/product
== combined == Product: MyModel/SubSystem/product2 */
if (enable) {
res = var1 * var 2;
} else {
res = var3 * var4;
}
</pre>
Here, both product blocks were combined with the if block.

Some parts of the code will be generated to handle array accesses like in this example:
<pre> for (Aux_S32 = 0; Aux_S32 < 75; Aux_S32++) {
/* Assignment: MyModel/SubSystem/Assignment - output initialization */
data[Aux_S32] = 0;
}
</pre>
While the for loop doesn't have a comment on it's own, the code belongs to the Assignment block as can be extracted from the comment inside the loop. These kind of loops use an iterator variable with a name containing `aux`, usually have a fixed length and are used to perform operations over indices of an array.

Other loops use iterator variables with names based on existing sub systems:
<pre> for (SBS25_For_Iterator_it = 1; SBS25_For_Iterator_it <= 2; SBS25_For_Iterator_it++) {
/* Sum: MyModel/SubSystem/for_loop/Sum */
res = var1 + var2;
}
</pre>
`SBS25_For` is the name of a subsystem that is defined like this at the top of the file:
<pre>*** SBS25 MyModel/SubSystem/for_loop
</pre>
It is typically a for loop used in the model that can contain several internal blocks.

Main Page

2024-05-08T12:00:57Z

Oliver.Wolf.EMX:

<languages/>
<translate>


Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.


=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix Performance Estimator]]
* emmtrix Dependency Analyzer
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com emmtrix C++ to C Compiler Online]
* [[:Category:emmtrix Studio FAQ|FAQ]]

</translate>

=== Compiler Background ===

* [[Loop Transformations]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== Other Topics ===
* [[Mapping TargetLink generated C code back to Simulink blocks]]

=== FAQ ===

* [[Error Handling]]

Main Page

2024-04-30T06:52:36Z

Oliver.Wolf.EMX: /* emmtrix Products */

<languages/>
<translate>


Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.


=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix Performance Estimator]]
* emmtrix Dependency Analyzer
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com Live C++ to C compiler demo]
* [[:Category:emmtrix Studio FAQ|FAQ]]

</translate>

=== Compiler Background ===

* [[Loop Transformations]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== FAQ ===

* [[Error Handling]]

Why can the source code not be parallelized/optimized?

2024-04-09T08:40:24Z

Oliver.Wolf.EMX: Created page with "Since ePS2022.04, as part of the CodeTransformation functionality, a function has been added to display the reasons why code transformations cannot be applied. This indicates reasons why code cannot be parallelized or optimized. # Right-click on the block to be analyzed in the [Hierarchical Program View], and if "Not applicable transformations" is displayed, the reason for non-parallelizability can be confirmed. # Select the item of non-parallelization you want to check..."

Since ePS2022.04, as part of the CodeTransformation functionality, a function has been added to display the reasons why code transformations cannot be applied. This indicates reasons why code cannot be parallelized or optimized.

# Right-click on the block to be analyzed in the [Hierarchical Program View], and if "Not applicable transformations" is displayed, the reason for non-parallelizability can be confirmed.
# Select the item of non-parallelization you want to check, and the reason of non-parallelization will be displayed as follows.

[[File:Not applicable transformations.png|thumb|List of transformations that cannot be applied to the selected block.]]
The following trivial reasons are not displayed.

* If the block is not a loop, the loop transformation cannot be applied
* [[File:Reason for being not applicable.png|thumb|Example for a reason of why a transformation cannot be applied.]]If-loop split is not shown if there is no if in the loop

File:Reason for being not applicable.png

2024-04-09T08:39:51Z

Oliver.Wolf.EMX:

Example for a reason of why a transformation cannot be applied.

File:Not applicable transformations.png

2024-04-09T08:38:28Z

Oliver.Wolf.EMX:

Shows transformations that are not applicable for the selected block

Notes on using Japanese character code (Shift-JIS)

2024-04-09T08:30:50Z

Oliver.Wolf.EMX: Created page with "If the source code to be analyzed uses Japanese character code (Shift-JIS) on Windows, the following JAVA exception message may be output when analyzing with ePS. Error: Exception ''java.lang.StringIndexOutOfBoundsException'' To avoid this, it is recommended to use UTF-8 character code for the source code to be parsed. To convert the character encoding of multiple source codes at once, you can use a script such as the one linked below. Batch conversion of multiple fi..."

If the source code to be analyzed uses Japanese character code (Shift-JIS) on Windows, the following JAVA exception message may be output when analyzing with ePS.

Error: Exception ''java.lang.StringIndexOutOfBoundsException''

To avoid this, it is recommended to use UTF-8 character code for the source code to be parsed.

To convert the character encoding of multiple source codes at once, you can use a script such as the one linked below.

Batch conversion of multiple files' character codes with Windows PowerShell: https://atmarkit.itmedia.co.jp/ait/articles/0804/18/news155.html

Parallelizing code containing pre-processing instructions

2024-04-09T08:22:14Z

Oliver.Wolf.EMX: Created page with "In the actual code, there are symbol definitions and conditional compilations that are tailored to the target environment and debugging situation. ePS parallelizes the code after preprocessing, so these definitions are removed. Therefore, if necessary, users need to reflect them in the parallelized code. In addition, for practical use, it is possible to define the parallelization of these pre-processing instructions under specific conditions as an ePS project in advance,..."

In the actual code, there are symbol definitions and conditional compilations that are tailored to the target environment and debugging situation. ePS parallelizes the code after preprocessing, so these definitions are removed. Therefore, if necessary, users need to reflect them in the parallelized code.
In addition, for practical use, it is possible to define the parallelization of these pre-processing instructions under specific conditions as an ePS project in advance, and to manage the parallelized code by not including the pre-processing instructions. In this case, add a custom macro in [Preferences]->[General]->[Advanced Options] as follows.

[[File:eS custom macro.png|thumb|Settting a custom macro in the ePS settings]]

File:eS custom macro.png

2024-04-09T08:21:39Z

Oliver.Wolf.EMX:

Setting a custom macro in ePS settings

String Index Out of Bounds Exception

2024-04-09T08:17:54Z

Oliver.Wolf.EMX:

When "Run Mapping & Scheduling" is executed, ''java.lang.SteeringIndexOutOfBoundsException'' may occur.
{| class="wikitable"
|java.lang.StringIndexOutOfBoundsException: index 16015,length 15925
at java.base/java.lang.String.checkIndex(String.java:3278)

at java.base/java.lang.StringUTF16.checkIndex(StringUTF16.java:1470)

at java.base/java.lang.StringUTF16.charAt(StringUTF16.java:1267)

at java.base/java.lang.String.charAt(String.java:695)
|}

=== Possible Reasons ===
The source code to be analyzed is treated as Shift-JIS.

=== Solution ===
Convert from Shift-JIS to UTF-8.

=== Reference ===
https://atmarkit.itmedia.co.jp/ait/articles/0804/18/news155.html (Japanese)

String Index Out of Bounds Exception

2024-04-09T08:12:54Z

Oliver.Wolf.EMX: Created page with "When "Run Mapping & Scheduling" is executed, ''java.lang.SteeringIndexOutOfBoundsException'' may occur. {| class="wikitable" |java.lang.StringIndexOutOfBoundsException: index 16015,length 15925 at java.base/java.lang.String.checkIndex(String.java:3278) at java.base/java.lang.StringUTF16.checkIndex(StringUTF16.java:1470) at java.base/java.lang.StringUTF16.charAt(StringUTF16.java:1267) at java.base/java.lang.String.charAt(String.java:695) |} === Possible Reasons === The s..."

When "Run Mapping & Scheduling" is executed, ''java.lang.SteeringIndexOutOfBoundsException'' may occur.
{| class="wikitable"
|java.lang.StringIndexOutOfBoundsException: index 16015,length 15925
at java.base/java.lang.String.checkIndex(String.java:3278)
at java.base/java.lang.StringUTF16.checkIndex(StringUTF16.java:1470)
at java.base/java.lang.StringUTF16.charAt(StringUTF16.java:1267)
at java.base/java.lang.String.charAt(String.java:695)
|}

=== Possible Reasons ===
The source code to be analyzed is treated as Shift-JIS.

=== Solution ===
Convert from Shift-JIS to UTF-8.

=== Reference ===
https://atmarkit.itmedia.co.jp/ait/articles/0804/18/news155.html (Japanese)

Main Page

2024-04-09T08:08:33Z

Oliver.Wolf.EMX: /* FAQ */

<languages/>
<translate>


Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.


=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com Live C++ to C compiler demo]

</translate>

=== Compiler Background ===

* [[Loop Transformations]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== FAQ ===

* [[Error Handling]]

Main Page

2024-04-09T08:08:24Z

Oliver.Wolf.EMX:

<languages/>
<translate>


Welcome to the emmtrix Technologies Wiki. As a company with a deep-rooted passion for compilers, we specialize in source-to-source compilers designed to analyze, optimize and transform your code. This Wiki aims to offer detailed, technical background information that complements the tools and resources available on our official website. Here, you'll find in-depth explanations, usage guidelines, and insights into the engineering behind our specialized software solutions. Whether you're a developer or a technically-inclined enthusiast, this space is designed to deepen your understanding of what makes our tools essential for your projects.


=== emmtrix Products ===


* [[emmtrix Studio Release Notes]]
* emmtrix Parallel Studio
* [[emmtrix C++ to C Compiler]]
** [https://online-ecpp2c.emmtrix.com Live C++ to C compiler demo]

</translate>

=== Compiler Background ===

* [[Loop Transformations]]
*[[Demystifying C++]]
*[[The alias Attribute|The alias attribute]]
*[[Clang Diagnostics Overview]]
*[[:Category:Clang Diagnostics]]

=== FAQ ===

* [[Error_Handling]]

emmtrix Studio Release Notes

2023-11-29T12:28:20Z

Oliver.Wolf.EMX: Created page with " = emmtrix Studio Release Notes = == Release 2023.11 == ===..."

= emmtrix Studio Release Notes =


== Release 2023.11 ==


=== New Features ===

* All emmtrix tools are now gathered in the emmtrix Studio framework with their own perspectives
** emmtrix Parallel Studio
** emmtrix Performance Estimator
*** TargetLink Extension (coming soon)
*** Simulink Extension (on request)
** emmtrix Dependency Analyzer
** emmtrix Code Vectorizer (coming soon)
** emmtrix Model Code Generator
** emmtrix Code Generator
* Windows: A portable Cygwin installation is provided to remove the need to install any additional third-party tools


=== Improvements ===

* Hierarchical Program View: New indicator icon for tasks with measured timing data
* Code Transformations: Added setting in GUI to enable/disable code transformation analysis
* Frontend: Print out missing include files for all processed files for easier project setup and debugging
* Eclipse: Update to version 2023-06
* EMX-LLVM: Update to version 230901
* Added support for alias attribute (e.g. <code>__attribute__((alias("name")))</code>) for functions and variables
* InstructionSimplifier trafo: Added the following simplifications:
** <code>const ? a : b</code> => <code>a</code> or <code>b</code>
** <code>0 - x</code> => <code>-x</code>
** <code>x [-&^|/%] x</code> => <code>0</code> or <code>x</code>
** <code>x [+-] (-y)</code> => <code>x [-+] y</code>
** <code>(-x) + y</code> => <code>y - x</code>
** <code>x [*/] (-1)</code> => <code>-x</code>
* ExplicitCastInserter trafo: Added trafo to insert explicit type casts in expressions where implicit casts are performed
** <code>if (expr)</code> => <code>if ((_Bool)expr)</code>
** <code>float_var = 10</code> => <code>float_var = (float)10</code>
** <code>ptr_to_long_int + char</code> => <code>ptr_to__long_int + (int)char</code>
** <code>bool_var * unsigned_long_var</code> => <code>(unsigned long)bool_var * unsigned_long_var</code>
** <code>0 ? bool_var : vol_int_var</code> => <code>(_Bool)0 ? (volatile int)bool_var : vol_int_var</code>
** <code>func_call(signed_int_var + long_double_var)</code> => <code>func_call((long double)signed_int_var + long_double_var)</code>
* Simulink viewer: Improved usability
** Added sliders for larger models
** Added labels for simple blocks (e.g. sum, product)
** Improved contrast of background colors
** Improved positioning of labels


=== Bugfixes ===

* Parallelization: Fixed generation of inconsistent ids from send/recv calls
* Parallelization: Detect variable length arrays as unsupported and clustered
* Fixed wrong reordering of declarations for automatic merging of blocks
* Fixed access analysis of function call arguments including <code>&</code> and structs
* Fixed crash caused by struct field passed as pointer to function
* Project Wizard got stuck during project creation
* Performance Estimation: Fixed bug with LLVM IR based estimation and multiple source files
* Bugfix for handling custom paths replacing the system paths


= emmtrix Parallel Studio Release Notes =


== Release 2022.10 ==


=== Improvements ===

* Added support for GCC extension [https://gcc.gnu.org/onlinedocs/gcc/Statement-Exprs.html statement expressions]
* Update EMX-LLVM tools to release 2022.11.18
* Added separate template files for “Parallel Tests” (independent from sequential test template)
* Eclipse: Updated to version 2022.06
* Added setting to specify the path for EMX-LLVM tools
* Added new transformation to convert <code>for</code> loops to <code>while</code> loops


=== Bugfixes ===

* Avoid false duplication of functions


== Release 2022.07 ==


=== New Features ===

* Added support for assembly-based performance estimation
** Added option to enable assembly-based performance estimation in advanced settings
** Supporting Tricore using HighTec GCC compiler (tricore-gcc)
** Supporting ARM Cortex-A7 using [https://developer.arm.com/downloads/-/arm-gnu-toolchain-downloads ARM GNU Toolchain]
** Updated target defintions with assembler performance estimation
* Added new disassembly view with traceability between HTG and C source code
** Generating <code>assembly.asmmodel</code> file storing disassembly and mapping information
** Disassembly view: Added disassembly view (AsmEditor) for <code>assembly.asmmodel</code> files that displays disassembly information
** Disassembly view: Option to display timing information from assembly-based performance information
** Disassembly view: Option to reorder basic blocks to better match the order within the source file
** Disassembly view: Automatically highlighting the C source line in a corresponding editor if the caret is changed to an assembly instruction
** Disassembly view: Automatically highlighting the assembly instruction in a corresponding disassembly view if the caret is changed to a C expression
** HTG view: Added new <code>ASM</code> button to open disassembly view
** HTG view: Automatically highlighting the assembly instructions within disassembly view if a HTG node is selected
** Currently supports Infineon AURIX and ARM Cortex-A7
* Performance estimation workflow
** Added new GUI elements to handle performance estimation to workflow
** Generation of HTML report with information on function level
** Added support for loading timing data from simulation and hardware
* Added support for LLVM-IR-based performance estimation
** Independent from target compiler
** Example target specification available for Infineon AURIX TC3xx
* Added new code sinking transformation
** The transformation moves assign statements to positions where it is executed less frequently
** A threshold value is given that specifies the minimum reduction factor for the execution count (threshold)
* Added new loop-invariant code motion transformation
** The transformation moves only statements by default
** It optionally moves sub-expressions by creating temporary variables (sub_exprs=1)
** It optionally reorders invariant expressions by applying the commutative and associative laws (reorder=1)
** It includes an built-in test about the number of moved expressions (expected_moved_exprs)
* Added checksum based upgrade mechanism for <code>target</code> and <code>template</code> folders


=== Improvements ===

* Template processing: Added variables <code>C_FILES_PROCESSED</code>, <code>C_FILES_ADDITIONAL</code> and <code>C_FILES_TOCOMPILE</code>
* CPP2C: Supporting projects with multiple *.cpp files
* Active project management
** GUI: Project list in workflow view now has an empty entry to deselect any project
** Bugfix: The active project is now stored explicitly in the workspace to avoid any ambiguity
** Bugfix: Fixed detection of changes to projects (rename, import, copy, etc.)
* Improved WhileToFor transformation with better detection of step and init code
* Improved loop unrolling transformation by adding support for declarations, unknown number of exections, returns and breaks
* C library: Supporting <code>va_start</code>, <code>va_end</code> and <code>va_arg</code> of stdarg.h
* Improved trip count calculation of for loops by using local constant propagation
* Improved check for unsupported C constructs that will be automatically clustered
** Switch case constructs (that are not converted to if)
** Double pointers: e.g. <code>int **a</code>
** Do while loops
** Goto statements
** Functions with multiple return paths (no return or one return at the end is allowed)
** Loops (for, while, do while) with continue
** Loops (for, while, do while) with break


=== Bugfixes ===

* Parallel code generation: Header file <code>_emx_main.h</code> was included multiple times
* Control-To-Goto: Fixed conversion of short-circuit operations within variable initialization
* Bugfix: Constant propagation with pointers
* Fixed issues with generation of temporary variables
* Fixed some GUI related bugs (avoid unnecessary exceptions)
* Fixed some bugs in the parallel performance estimation (wrong calculation of loops)
* Fixed Linux related bugs (paths, executable flags)
* Fixed Run on MATLAB and compare


=== Other ===

* Removed TWIG template support
* ePS is now using Java 17, required files for Windows and Linux are integrated
* Release is based on Eclipse 2022.03
* Update eCG to release from 29/04/22
* Update CPP2C to release from 29/07/22


== Release 2022.04 ==


=== New Features ===

* Transformations:
** Introduced VarSplit transformation for splitting an array variable into multiple variables
** Introduced FuncPtrResolve transformation for replacing indirect function calls by if-then-else constructs
** Introduced <code>InstructionSimplifier</code> transformation to simplify expressions by applying neutral and zero element optimizations
** Transformations can now track the reason the analysis failed
* Standard header files now available in template folder (<code>standard_includes</code>) and can be edited by the user
* Introduced new file management (epsfiles.txt)
** Input files are now defined in the file <code>sources/epsfiles.txt</code> which follows the syntax of [https://git-scm.com/docs/gitattributes .gitattributes] files
** It supports the following attributes
*** <code>action=[none|process|compile|copy]</code>: Defines what ePS is doing with the file
**** <code>none</code> or no attribute is ignoring the file
**** <code>compile</code> is copying and compiling the file to output folder
**** <code>copy</code> is only copying the file to output folder
**** <code>process</code> is processing (reading and writing) the C source file by ePS
*** <code>template=[twig|ftl]</code>: The file is processed by the specified template engine. A corresponding file extension is removed.
*** <code>c_preprocess</code>: The source file is preprocessed through a C/C++ preprocessor
*** <code>codegen=[eCG|eCPP2C]</code>: Code generation is applied to the source file
**** <code>eCG</code> runs emmtrix Code Generator on the MATLAB or Scilab file
**** <code>eCPP2C</code> runs emmtrix C++ to C Compiler on C++ source files
** Source file status is shown in Project Explorer as specified in epsfiles.txt
** Default epsfiles.txt file can be created via context menu in Project Explorer or in the Project Settings dialog


=== Improvements ===

* Target platforms:
** Added Tasking template for the Aurix TC397 platform
** Added hardware model of SPC58ECxx (PowerPC e200z4 dual-core)
* Vectorization transformation (still experimental)
** Improved support for array subscripts with linear memory access pattern
** Improved source code appearance after vectorization
** Supporting array subscripts with indexed memory access pattern
** Supporting vectorization of loops containing unvectorizable expressions
** Supporting vectorization of simple sub-functions
** Supporting <code>for</code> loops with non-constant iteration count
** Supporting memory accesses with indirection operator (e.g. <code>*(p+1) = ...</code>)
** Supporting <code>?:</code> operators, generic for loop initialization and non-vectorized local variables
* Performance estimation: Consider duration of variable initialization and ignoring constant expressions
* GUI: Changed format of exceptions dialog
* C library: Added header <code>arpa/inet.h</code>, <code>sys/socket.h</code>, <code>netinet/in.h</code> and <code>netdb.h</code>
* Improved support for wide character string and char literals
* Supporting array size calculation of designated array initializers
* Performance estimation: Set default to 1 cycle per instruction when no data is available
* EpsProject: Include directories are relativized if they are part of the project
* CodeGeneration: Replicate input folder structure
* Added node context menu to Hierarchical Program View to export task dependencies in DOT or CSV format
* LLVM tools: Update to release from 27/04/2022


=== Bugfixes ===

* Crash caused by <code>if (a = func() == 3)</code>
* Frontend: Crash in type compatibility check when variable was redeclared after struct was redeclared
* Parallel code generation: Missing function prototypes of parallelized functions
* ParallelCodeGeneration: ‘sources’ folder is now correctly added to the includes
* Fixed OS-dependent path name that could cause one C file being parsed multiple times
* Frontend: Crash caused by two nested C99 for loops without curly brackets, e.g. <code>for (int i=0; i<10; ++i) for (int i2; i2<10; ++i2) ...</code>
* Function duplication did not consider static variables
* Type deduction of function pointers
* Frontend: Improved error handling of false C code (e.g. case outside switch)
* Fixed executable flags for Linux
* Type deduction failed for address operator on <code>_Bool</code> variable
* Performance estimation: Wrong warning: Assuming default number of iterations


== Release 2022.01.a ==


=== Improvements ===

* Parallelization: Automatic scheduler avoids any schedules that causes slowdowns
* Parallelization: Functions with unsupported use of pointers are automatically clustered and will not be falsely parallelized


=== Bugfixes ===

* Fixed errors with libraries math.h and errno.h
* Fixed bugs related to incompatible types
* Compilation error caused by conflict between user-defined macros (e.g. <code>N</code>) and winnt.h
* Fixed prompt for workspace selection at startup


== Release 2022.01 ==


=== New Features ===

* Added initial vectorization support for Aurix TC4xx PPU
** VectorizeTrafo: Added trafo for vectorizing a simple <code>for</code> loop into platform-independent vector code (alpha)
*** No check is performed that the vectorized code will be correct
*** Unsupported constructs are not detected beforehand. Instead, an exception is thrown during application
*** Supporting only simple array variable constructs of <code>a[i]</code> (<code>i</code> is the <code>for</code> iterator variable) or <code>a[j1]...[j2][i]</code> (<code>j1 ... j2</code> must be loop invariant)
*** Supporting vectorization of reduction variables, e.g. <code>for (i=0; i<N; ++i) i += a[i];</code>
*** Supporting predicated vector instructions
*** Supporting optional padding of array variables to eliminate predicated vector instructions
** TargetPlatform: <code>host_win32</code> supports code generation of platform-independent vector code by using a template-based library for vector types and functions
** TargetPlatform: Added two “Aurix TC4xx Parallel Processing Unit” platforms with Tasking and Synopsys PPU compiler support
*** Supporting simulator code generation with cycle-approximate performance measurement


=== Improvements ===

* Supporting <code>long double</code> in our libc math.h
* Added ConstPropagationTrafo transformation for applying constant propagation to a function
* Improved replacement of inc/dec (e.g. <code>++</code>) and compound assign (e.g. <code>+=</code>) operators
** Supports correct handling of volatile variables
** Resolution within array/struct initializers was not working (e.g. <code>int i1[] = { x++ };</code>)
** Resolution within variable initialization could switch the order of statements (e.g. <code>int i1 = x++; int i2 = x;</code>)
* Target platforms: Added <code>char16_t</code> and <code>char32_t</code> types and supporting macros
* Improved support for running code on target platforms
* Documentation: Added section about CLI
* Documentation: Set Cygwin 64 bit as only supported version
* Added support for selecting the target compiler affecting the macros and types used to parse the source code
** Settings: Added compiler combo box into general settings
** TargetPlatform: <code>microarchitecture.xml</code>: Added <code>Compilers</code> section
* Switched to Eclipse 2021-09
* Improved switch-to-if converter
* Added initial support for designated array range initializers (<code>[first ... last] = value</code>) (see [https://gcc.gnu.org/onlinedocs/gcc/Designated-Inits.html designated inits])
* Added optional function de-duplication pass (can be activated in advanced settings)
* Preserving all function, variable and type declarations and their original order within C file
* Flow: Improved monitor output (warning/error display) and added subtasks
* Multiple performance improvements for large projects (''e.g. performance estimation works well with 1 mio lines of code'')


=== Bugfixes ===

* Invalid function arguments after parallelization
* Parallelized function returned result on wrong core
* Duplication of <code>for</code> loops with declarations generated incorrect code
* Communication was not working with pointer variables
* Communication was placed after return statements
* Multiple transfers of same variable with same ID
* Fixed handling of large call trees
* Crash in SSATraversal caused by recursive functions with pointer parameters
* Memory leaks
* Avoiding “Too many arguments to function” warning for implicit functions
* Array size calculation of <code>array[ENUMERATOR]</code> is now working
* COutput: -(-1) was output as –1
* Fixed analysis of for loops where the loop variable is modified before the for loop
* Pragmas outside of functions are preserved in the correct order
* Fixed output of forward-declared structs, unions and enums
* Merging two composite blocks could lead to two variables using the same name


== Release 2021.09.a ==


=== New Features ===

* Added pass to use a preprocessor (e.g. gcc or clang) on C code before it is used in ePS
* Integrated AUTOSAR file parsing based on the Artop library
* Added calculation of confidence level for performance estimation
* Added support for a configuration file to add pragmas without changing the source code


=== Improvements ===

* Added basic support for:
** function pointers
** recursive functions
** designated array initializers
** designated struct/union initializers
** compound assignment operators
** C11 style anonymous enum/struct/union definitions embedded in other type definitions
** incomplete data types (according to C standard)
* Separated settings for sequential and parallel platform tests
* Added new functionalities to CLI:
** Configuration of projects
** Control over passes to run
* Improved traceability of input to output source code lines
* Added generation of log files for each pass that capture all output from the console
* Project files are now stored compressed to save space
* Reworked the status messages of the flow
* Improved profile-guided execution counts of for loops
* Added more information to properties view of HTG representation
* Switched file structure for parallelization constraints to reduce the number of required entries
* Added Infineon TC387 platform
* Made the analysis for transformations more robust


=== Bugfixes ===

* Crash for arguments with pointer case (e.g. (void*) arg)
* Crash with function calls used in variable initialization
* Assertion caused by repeated function declarations in one translation unit
* Various conflicting types errors
* Wrong placement of global variables
* Typedef redefinition was always reported as error
* Function declaration and implementation of different but compatible function types caused errors
* Fixed several issues with files not being closed correctly in the GUI
* Fixed error in size calculation in recursive structs
* Propagation of absolute number of executions over function calls
* Errors in duplication of function calls
* Detection of recursive function calls in unused functions
* Type deduction was wrong in many cases (e.g. <code>enum</code>, <code>++</code>)
* void-cast of function call caused incorrect code
* Removed automic inclusion of System32 folder in path on Windows
* Fixed bug with PATH variable on Windows
* Fixed path separation on Linux
* Wrong messages about assignments to constant variables
* Fixed layout of advanced settings page
* Renamed _emx_main.c to _emx_t_main.c to avoid conflicts with sources named main.c
* Functions called via function pointers/references were considered unused


== Release 2021.06 ==

* Added line information for warning “Variable is defined externally”
* Code generation: Added supported for generating inline assembler
* ConsistencyChecker: Introduced different levels of strictness and added corresponding project setting
* DepChainAnalysis: Added reason to warning if a function could not be analyzed
* Frontend / Model / Code generation: Supporting switch case expressions to contain generic instructions (e.g. enumerators) instead of just integers
* Frontend: Added support for inline assembler
* Frontend: Handling of null statements improved (especially if labeled or within empty body blocks) HTG: Adding task clusters for goto instructions
* Hardware support: Added the optimized ringbuffer communication models ringbuf_fixed_fork (the new default) and ringbuf_fixed_thread based on the existing Aurix optimized ringbuffer implementation
* Hardware support: Implemented new communication API:EMXAPI prefix replaced with EMX, Added functions to send and receive float and double types, Values to be sent/received by scalar communication functions are now passed by value and as the return value, Argument order changed so that the first four arguments of all functions are: src, dst, id and index, followed by value/buffer arguments when present
* Hardware support: Renamed communication model names ringbuf->ringbuf_fork and singlecopy_sharedmem->ringbuf_thread
* Product: Updated provided JRE on linux to 11.0.11
* Wizard: Added communication test example project
* Bugfix: Custom paths were not considered for executing external tools
* Bugfix: DepChainAnalysis: Fixed crash if a function was not duplicated
* Bugfix: ExtractMain transformation: Converting function to main was not working if the calling function was not main
* Bugfix: Fixed handling of the size of alias types
* Bugfix: Fixed some problems related to BasicBlock file locations
* Bugfix: Frontend / Code Generation: Handling of case blocks with { } was not working
* Bugfix: Frontend: Correct placement of pragmas in front of labels
* Bugfix: GUI: Re-initialize compiler defaults when project settings is changed
* Bugfix: SSA: Crash in SSATraversal caused by incorrect usedef detection of parameters


== Release 2021.03a ==

* Code generation: Template processing is deleting template files directly after processing
* DepChainAnalysis: Added XML output (depchainanalysis.xml)
* DepChainAnalysis: Bugfix: Function calls with unused return value were broken
* Flow: Introduced source template processing of ''.ftl and ''.twig files. An option was added in general settings to enable that feature.
* GUI: Source template GUI option now also added for non-C inputs and defaults to disabled
* Performance estimation: Refactored BBDurationProvider and BBDurationEstimator
* Performance estimation: Refactored procedure call overhead
* Settings: Improved handling of false root procedures
* Supporting EMX_EXTRACTMAIN pragma to trigger extract main transformation. The extract main trafo uses the pragma to apply the transformation after all other transformations.
* Template processing: Introduced generic project-based variables
* Trafo: Added loop interchange transformation
* Bugfix: C Frontend: Pragma placement
* Bugfix: Crash in case of unary operator within while condition
* Bugfix: Exception caused by loop analyzer in case of reverse “for” loop
* Bugfix: Fixed several GUI and flow errors
* Bugfix: ParallelPostCodeGen: Fixed check for empty source folders list
* Bugfix: Parameters no longer removed from function without body
* Bugfix: Project wizard stored wrong String in .properties for InputLanguage
* Bugfix: TargetPlatform: GUI was broken in case a software platform was missing


== Release 2021.03 ==

* Added GUI mechanism to insert timing instructions around functions and at blocks marked with pragmas
* Bugfix: CDT Frontend: Variable declaration in the middle could produce wrong code
* Bugfix: Dangling exception with AliasType
* Bugfix: GUI: Project wizard was broken for empty workspaces
* Bugfix: GUI: the presence of a file without extension inside the ECG output folder caused an exception in C2MMapper
* Bugfix: HTG: Crash caused by a too deep HTG
* Bugfix: Indirection (dereference) as function call argument
* Bugfix: PaddingPragmaHandler: EMX_PADDING pragma is working across function boundaries
* Bugfix: Parallel Code Generation: Return assignment check failed for non-duplicated functions
* Bugfix: Remove unused functions setting was broken
* Bugfix: Scheduler: Root function forcibly clustered due to multiple returns are handled correctly
* Bugfix: Scheduler: exception caused by main function with multiple return statements
* Bugfix: Size deduction from variable initialization was broken for global variables
* Bugfix: The analysis failed in case a variable was available only as an external declaration. A warning is now issued in that case.
* Bugfix: incorrect view when switching between input languages
* DepChainAnalysis: Improved dependency chain analysis to take repeating function calls into account and added delay suffix for each dependency
* DepChainAnalysis: Supporting analysis of function calls
* DepChainAnalysis: Supporting control dependency calculation
* DepChainAnalysis: Supporting functions with return parameters
* Eclipse: Switched to version 2021.03
* Flow view: removed unnecessary methods for button state restores
* Flow: Introduced lambda-based CallNormalizer that reimplements the old functionality to move every call into its own basic block
* Flow: Output of eMCG is now stored in generated_files
* Frontend: Added C correctness checks
* GUI: Added button to generate transformed code
* GUI: Added indicator of execution frequency to block representation in HTG view
* GUI: Added tab in properties view for displaying source code
* GUI: Anti and output dependencies are not rendered if they are between tasks on different cores
* GUI: Children of blocks are scaled to make sure they fit into the parent
* GUI: HTG and Scheduler view: Added support for bringing up the context menu using the keyboard
* GUI: HTG and Scheduler view: Fixed a bug that caused invalid behavior when focus was lost during mouse drag
* GUI: HTG and Scheduler view: Made selection behavior more consistent with standard windows selection behavior
* GUI: HTG: Changing ecg_decisions.ini file only if the content changed. That prevents unnecessary eCG runs.
* GUI: The length of THEN/ELSE blocks is scaled according to their execution frequency
* GeCoS: Deleted several unused classes
* ParallelCodeGeneration: Leaving non-parallelized functions unchanged
* ParallelCodeGeneration: Removed user includes from _emx_main.h
* Performance estimation: Brought back execution frequency assumptions in case code cannot be analyzed
* Performance estimation: Changed perf test platform to aurix_tc397_kit
* Performance estimation: Improved LLVM profiling provider to handle nested control constructs and while loops
* Settings: Added setting to disable consistency checking
* Settings: Moved host profiling settings from advanced to general
* Settings: Supporting <Makefile> placeholder in compile command settings that is replaced by Makefile or Makefile.gen (whatever exists)
* Supporting <code>#pragma EMX_PADDING <pad></code> pragma to increase the size of the last dimension of an array to a multiple of <code>pad</code>
* TargetPlatform: Supporting run command specification in software platform (e.g. <code><Run command="make sim"/></code>)
* TargetPlatform: Supporting specification of compile settings in software platform
* TargetPlatform: Used software platform description for parallel testing
* Templates: Added EMXAPI_SyncCores and EMXAPI_GetCore API functions
* Templates: Converted timing template to use FTL instead of macros
* Trafo: Added ExtractMain transformation
* Trafo: Added ObfuscationTrafo to make identifiers obscure
* Trafo: Added function inline transformation


== Release 2020.12 ==

* Added Apache FreeMarker (.ftl file extension) as additional template language
* Flow GUI: Parsing the C source code is now a pass
* Switched to Eclipse-2020-09
* HTG and properties view: Displaying call overhead
* Scheduler / Performance estimation: Refactored procedure call overhead calculation/handling
* GUI: refactored eCG and ePS view to use same base
* AURIX: Implemented high-performance communication library using statically determined absolute addresses
* AURIX: Added new combined template for TC297 and TC397
* Parallel Code Generation: Implement feature to convert functions to static (Parallelization settings, activated by default)
* Performance estimation: Reworked calculation of call overhead
* Added post-placement communication optimization by moving send as early and recv as late as possible (Advanced setting, deactived by default)
* Most important bug fixes:
** Bugfix: Return type of parallelized functions
** Bugfix: Pragma-controlled clustering (<code>EMX_TASK_CLUSTER</code>) of tasks was broken
** Bugfix: <code>EMX_TASK_ALLOC</code> pragmas appeared in generated code
** Bugfix: Linux: Issue with short task names on task termination
** Bugfix: Preserving static keyword and name of static global variables
** Bugfix: Fixed support for <code>EMX_INITCODE</code> pragma


== Release 2020.06 ==

* emmtrix project wizard now can import multiple C files
* Fixed handling of C projects without main function
* Introduced new indicators for status of passes
* Reworked handling of compiler settings
* Switched to internal pass infrastructure
* Switched to Eclipse version 2020-03
* Switched from Jasva 8 to Java 11
* Bugfix: CDTFrontend crashed for “for (;;) {}” loops [TS]
* TargetPlatform: Added support for additional function information (funcinfo.xml)
* Bugfix: Fixed template of MBA5728
* Added option to disable removal of unsused functions
* Added option to disable reordering of tasks
* Added option to parse of C files in eCG output folder
* Bugfix: Fixed generation of functions with simple declarations
* Removed enforced option “-B” for sequential tests
* Added handling of include directories
* Added button to parse C code in C projects
* Fixed various bugs


== Release 2019.11.07 ==

* Fixed definition of custom paths
* Several bug fixes regarding global variables
* Several bug fixes regarding parameters of parallelized functions
* Improved generation of OpenCL code
* Improved handling of static keyword
* Fixed bug in analysis of data dependencies
* Several other minor bug fixes


== Release 2019.03.20 ==

* Support for array of structs in emmtrix Code Generator
* Various improvements for data type selection in eCG
* Fixed bug that might cause parallel execution of passes within ePS
* Added option to set C macros for C workflow
* Improved error messages from CDTFrontend
* Redesigned SSH password and confirmation dialog
* Fixed various bugs related to C code input


== Release 2018.08.09 ==

* Support for Linux. We have tested it under Xubuntu 18.04. Since it is the first version for Linux, additional bugs compared to Windows cannot be excluded.
* Customization of the target platform: a target folder is automatically generated in the project folder, in which the various files for the target platform are located. Here e.g. timings for library functions can be stored. More details can be found in the ePS User Guide (just click on Parallel Studio Help in the tool).
* Support for software templates: in the generated subfolder “template” files can be stored that are to be used for building the parallel code. In addition, existing files can be customized for specific projects and templates can be filled in dynamically using Jtwig (http://jtwig.org/). Again, more details can be found in the ePS User-Guide
* Improved C support: processing of generic C code (e.g. with structs and switch cases) has been improved
* Static performance analysis has been reworked. Estimated times from previous versions may differ especially in nested structures. With the new method, it is no longer necessary that the input code is executed on the host system. Instead, all values are calculated as far as possible and otherwise populated with default values.


== Release 2017.07.04 ==

* Restructured settings
* Removed option of eCG to mimic the output of MATLAB
* Integrated automatic consistency checker into the flow
** Model consistency
** Order consistency
** Schedule checker (times, containment, order)
* Unified video interfaces across all platforms
* Switched to Eclipse Oxygen
* Removed support for GeCoS scripts
* Improved sequential testing for C flow
* Simplified support of parallelization of functions with pointer parameters 

* Fixed scheduler crash with function prototypes that omit parameter names
* Updated instruction performance for Cortex-A7 and Cortex-A15 on ODROID XU4
* Fixed a bug that could cause the tabular communication cost model to assign transfer costs for same-core transfers
* Fixed a bug that prevented to correctly derive a tabular communication cost models when multiple commtable files where present for the same target platform (affected heterogeneous architectures only)
* Analysis results are integrated into a node’s property view
* Fixed support for emx_task_alloc and emx_task_cluster pragmas: pragmas now take precedence over allocation made in the GUI or via the constraint settings JSON file
* Various fixes and improvements regarding user decisions
* Fixed a bug that would cause user decisions that were not changed in the current session to be removed from ecg_decisions.ini upon save of the file
* corrected calculation of start and finish times of for loops
* Fixed display of loops that are mapped to multiple cores


== Release 2017.03.23 ==

* Added Simulink Model Viewer, which currently supports:
** display of top level of model
** descend to sub block by double clicking on block
** block hover and selection
** history: Back/Forward/Home to model root
** zoom: 0,25 - 2.00 using toolbar or mouse wheel
* Support Simulink models
* HLS: Added synchronization for FPGA accelerators
* Fixed receive of pipe communication
* Enabled basic testing of C code in the C based flow
* Improved error handling when accessing projects/settings
* HLS: Added software interface generation for custom IP
* HLS: Added IP insertion into template Vivado project and bitstream generation
* HLS: Improved error handling and reporting
* Added video support for FriendlyARM NanoPi M3
* UnifyParameters now adds names to all unnamed function parameters
* Improved upgrade capabilities of project wizard
** automatic deletion of old epsproject and properties files
** generation of new epsproject and properties files
* Added Properties view to eCG and ePS perspective
* Added pass to place the eCG decision pragmas at parent blocks
* Improved error handling of update decision job
* Improved error handling of script execution


== Release 2017.03.08 ==

* Added support for Aurix FreeRTOS template and compiler script
* Added support for individual compiler settings for sequential, parallel and platform tests. These include:
** pre-/post-build bash script execution
** customization of CFLAG and LDFLAG
** customization of environment variables
* Improved support for handling of external files
* Improved support of __cplusplus define
* Added platform description for NanoPI M3 (S5P6818 Quad-Core Cortex-A53 1.4 GHz)
* Added platform description attribute “active” that determines whether a description is loaded/an available target platform
* HLS: improved the result checker to ensure compatability with Vivado HLS
* HLS: improved error checking of synthesis progress
* HLS: code refactoring and miscellaneous minor fixes
* Scheduler View: set minimal width of blocks to one pixel to improve placement of data dependencies
* Scheduler View: removed gaps beetween adjacent blocks to better reflect the blocks’ actual runtime
* Scheduler View: block selection markers are now drawn after blocks, so that they may not be overlapped by adjacent blocks anymore
* HTG View: moved information about from right pane to the properties view
* HTG View: added button to show the property view


== Release 2016.27.01 ==

* emmtrix Technologies GmbH was founded

Main Page

2023-11-29T12:21:30Z

Oliver.Wolf.EMX: /* emmtrix Products */

Main Page

2023-11-29T12:21:15Z

Oliver.Wolf.EMX: