Revision History

Version 2.89 - 09 November 2026

Fixed CDX/XCU runtime CAN pack/copy calls to use internal start-LSB offsets for Motorola signals in TX setters, RX/TX start-value initialization, multiplexor initialization and common-signal copies.

Version 2.88 - 29 October 2026

Added ‘Urgent TX’ feature for CDX Runtime integration. See manual for details on how to configure this feature in the options file. Updated manual styling. Use MS Edge / Chrome for PDF generation of manual.

Version 2.87 - 28 October 2026

Added representative A2L project regression test (compare full output to reference A2L). Added –timestamps and –no-timestamps commandline options to avoid putting date/time into output file notes. Useful if the output must be 100% repeatable.

Version 2.86 - 27 October 2026

T#6747: Update to Visual Studio 2026 Moved manual upload to new server. a2l/1.71.1: Write shortest round-trip floating-point coefficients without reducing numeric precision. B#7083: A2L export: retain option scalar and offset in COMPU_METHOD coefficients, preserving bit-mask scaling adjustments.

Version 2.85 - 19 October 2026

B#7054: ginmake simulink: CAN signal packing optimizer can result in overwriting of other signals in some cases: Fixed Simulink DBC CAN Tx setters overwriting neighboring signals when mask and shift are required. Retained aligned stores and added inline masked updates for simple packed fields. Fixed Motorola CAN-FD cross-boundary packing using invalid adjusted bit offsets.

Version 2.84 - 15 October 2026

B#6949: A2L export: honour VIEWRANGE/LIMITS and export VALIDRANGE/HARDLIMITS as EXTENDED_LIMITS for calibration objects. Fixed HARDLIMITS upper bounds being ignored unless LIMITS was also specified. Added W4038 for HARDLIMITS/VALIDRANGE on A2L measurements (suppress with -u4038). T#7038: Added –version to display only the ginmake version and build number without requiring a license. B#7037: Simulink export: Do not generate GemsSignal.m when workspace generation is disabled. Signal factory files are generated alongside their enabled workspace scripts. Generate CAN get_set.h header to fix insufficient include files issue with embedded coder generated code. Gin file support 3.35. The default output version remains at 3.34. Added round-trip export coverage for explicit GIN 3.35 output; rebuild gemscom after updating its headers to avoid linking stale version support. Fixed non-wx builds of gems by guarding the wx-only theme settings implementation with GEMS_WX. Fixed Release build version mismatches by generating version.h only in libginmake, before the executable and tests are built.

Version 2.83 - 14 October 2026

Fixed invalid integer suffix ‘uu’ being generated in some cases. CDX API include cdx_can.h as appropriate.

Version 2.82 - 09 October 2026

Fix divide by zero crash if alignment requirement is set to 0.

Version 2.81 - 07 October 2026

Added mechanism for generating IPC ‘ABI’ hash for checking IPC signal compatibility.

Version 2.80 - 07 October 2026

Fixed unescaped pipe chars in common-definitions manual topic from omitting BIT(…) documentation for Bitmask field. Simulink export: For CDX model integration, CAN Ports may be named instead of numeric (e.g. “IPC1”).

Version 2.79 - 25 September 2026

T#6966: Added GenSigStartValue initializers for CAN Rx + Tx frames via options tx_use_start_values and rx_use_start_values. T#6965: Added CDX Simulink API mode (target: “CDX” or uses_cdx_api: true), with CDX_ API prefixes and CAN Tx without frame timeouts, execution deadlines, or notification handlers. Migrated project to git SCM. Update for refactored gems/gemscom libs. Emerald 5.5.15.

Version 2.78 - 24 June 2026

Fix PC-Lint Plus warning in generated code for XCU8 CAN Tx: tx_data could be pointer to const. Fix PC-Lint Plus warning: Repeated include file “xcu_time.h” - now using external include guard.

Version 2.77 - 22 June 2026

Fixed duplication of Simulink section in manual & broken image. Fixed generated code for XCU8 CAN Tx notification handling for multiplexed messages.

Version 2.76 - 24 April 2026

B#6707: A2L export: set BYTE_ORDER on CHARACTERISTIC or MEASUREMENT if their derived endian mode differs from the global MODULE setting. T#6708: Switched to HTML help system. A PDF version of the manual is now generated from the HTML and is now called GinmakeManual.pdf. Online version of the help is available at https://gems.co.uk/manuals/ginmake

Version 2.75 - 21 March 2026

B#6619: Set floating point raw type for floating point signals aliased on XCU8 CAN frames (e.g. CAN Tx / CAN Rx). T#6618: Set valid deadlines for CAN Tx messages. Added simulink options: cantx_frame_timeout_enable cantx_frame_timeout cantx_frame_timeout_multiplier can.disable_tx_notify can.tx_timeout_enable can.tx_timeout can.tx_timeout_multiplier Added support for the following DBC attributes for CAN Tx messages: GenMsgCycleTime - now also used with timeout multiplier to set deadline for CAN Tx message. GenMsgDelayTime - Offset to stagger messages with same cycle time. GenMsgStartDelayTime - Initial delay before first transmission of message.

GEMS custom DBC attributes:
	GemsMsgTimeout - Absolute timeout for message, used if GenMsgCycleTime is not specified or if can.tx_timeout_enable is set.
	GemsMsgTimeoutEnable - Disable/enable use of timeout for message.
	GemsMsgTimeoutOffset - Added to message deadline calculated using multiplier on GenMsgCycleTime value.
	GemsMsgTimeoutMultiplier - Multiplier on GenMsgCycleTime to calculate message deadline.
The message deadline is used to prune stale CAN messages from the Tx queue.

Version 2.74 - 19 March 2026

XCU8 code generation: do not add ‘u’ suffix to CAN Bus ID symbols. Include xcu_can_bus_id.h for XCU_CAN_BUS_ID type & related defines in ginmake_can_tx.h.

Version 2.73 - 17 March 2026

Modified output for XCU CAN API changes.

Version 2.72 - 18 February 2026

A2L Export: Use MSB_FIRST instead of BIG_ENDIAN and LSB_FIRST instead of LITTLE_ENDIAN to specify BYTE_ORDER in A2L file, since the BIG_ENDIAN / LITTLE_ENDIAN keywords are deprecated and may not be interpreted as expected by all tools (e.g. CANAPE).

B#6070: Fixed “Duplicate symbol GINMAKE_A2L” error for A2L Simulink builds where –a2l command-line option is also specified. B#6075: Improved error message if e.g. –verify-mapfile is specified along with an accidental compilation target, without a full gimake license. Updated package sdb/3.5.0, fixes issue with misinterpretation of VFrameFormat in DBC files (was always interpreting frames as FD if VFrameFormat was used).

Version 2.71 - 01 December 2025

B#6390: Fixed Simulink code generation error: removed subscript from CAN data u64 scalar field accessors.

Version 2.70 - 18 November 2025

Fixed a couple of issues in generated C code for Simulink get/set functions relating to integer literal suffixes on bitmask values and correct matching of parentheses in expressions in some cases.

Release now includes 64bit version, which is faster to execute on x64 systems. Removed unused namesdb support / mysql dependency, makes x64 build possible.

Updated compiler to msvc 17.14.19. Updated package manager to conan v2. Updated packages: boost/1.89.0 cryptopp/8.9.0 emerald_id/1.2.66 emerald/5.5.10 gtest/1.17.0 sdb/3.4.0 xz_utils/5.4.5 zlib/1.3.1 zlib-minizip/1.3.1

Version 2.69 - 05 November 2025

Simulink: Improved escaping of ‘description’ property. descriptions may use prefix to allow HTML content. Simulink: DBC comment used as description field is now escapoed to avoid ginmake syntax errors.

Version 2.68 - 28 October 2025

Fixed A2L export issue where min/max values that have exact integer representations were being exported as floating point values, for example full-scale uint32 would end up with a loss of precision in the A2L file. Now min/max values are exported using integer representation where possible. Numeric precision was also increased for floating point values to avoid precision loss.

Version 2.67 - 17 October 2025

Fixed A2L BIT_MASK and BIT_OPERATION handling - A2L BIT_MASK is now shifted and where necessary BIT_OPERATION is included. For cases where a multiplier would be required to convert between raw and physical values, an error is raised so that the transfomation can be applied at source. Note that ASAM specifies MEASUREMENT and CHARACTERISTIC differently - it is not standardised to allow BIT_OPERATION on CHARACTERISTIC items. Fixed issue resolving relative paths when including a grh file within a grh file.

Version 2.66 - 15 October 2025

Simulink options: added asm_gcc_ext, asm_iar_ext and asm_msvc_ext options to specify the file extension to use for generated assembly files for different toolchains. Defaults changed to “s”, “s” and “asm” respectively.

Version 2.65 - 25 September 2025

Added per-object and per-region attribute “sl_prefix” to control the automatic prefixing of Simulink.Signal names. Added SL_PREFIX directive for shorthand setting of sl_prefix attribute.

Version 2.64 - 25 September 2025

B#6197: ALIAS directive now resets [IDENTIFIER],[LONG_IDENTIFIER] and [DISPLAY_IDENTIFIER] to avoid ambiguity with the original object.

Version 2.63 - 10 September 2025

B#6180: Fixed bug in expression evaluator that could result in an infinite loop when evaulating cast expressions.

Version 2.62 - 09 September 2025

B#6175: get_set.h generation now includes objects derived from STRUCT definition members. B#6176: Simulink get_set: Fixed signed/unsigned literal suffix for ternary expressions passed to XCU_memory_write_u{NN}_masked. B#6177: Simulink get_set: Fixed handling of items that use BIT(offset[|length]) syntax for bitfields.

T#6168: Added new ALIAS directive: Create an alias for an existing object. T#6178: Support any separator char following # when expanding STRUCT members e.g. “AN_1##” would give AN_01{member}, AN_01_{member} etc. T#6174: Simulink: use IDENTIFIER in preference to object name for exported Simulink.Signal / Simulink.Parameter objects if it is defined. T#6179: XCU8 Simulink: Added ‘direct_cal_access’ option, which defaults ON for XCU8 targets.
This allows direct access to calibration variables without going through the XCU_memory read/write API functions. Individual objects may opt out of this by specifying post-fix [DIRECT_CAL_DISABLE] or [ATTRIBUTE,direct_cal_disable=1] per-object or per-memory segment.

Version 2.61 - 20 August 2025

Do not use SC_ prefix for XCU8 API functions. XCU8 API includes utility functions already, so generate.utility_functions no longer has any effect for XCU8 targets. Corrected naming of XCU8 masked write functions in output (postfix with “_masked” instead of “Masked”). Generated get_set.h file for XCU8 targets now includes xcu_utils.h and xcu_memory.h instead of xcu_types.h to ensure that the required XCU8 API function prototypes are available.

Version 2.60 - 19 August 2025

Generate base workspace / get/set functions for Simulink models that do not have a base GIN file. Create temp path specified in simulink options file if it does not exist. If using XCU8 API, prefix matlab paramters and signals generated from base platform with “XCU_”.

Version 2.59 - 19 August 2025

Added asm_gcc_comment_start to ‘generate’ section as comment start character can vary depending upon target. Defaults to ‘@’. Fixed GCC ASM section syntax for S32K build. Added optional ‘include’ array to simulink options file to allow inclusion of common options files. CAN DBC files are now interpreted in Latin1 encoding rather than UTF-8. For example, fixes display of exported degrees symbol in other applications.

Version 2.58 - 11 August 2025

Do not issue error “VirtualMachine::execute: Program has no instructions” for .m files that do not contain any code.

Version 2.57 - 07 July 2025

Fixed regression: Use boolean_T instead of bool8_t EM80_M simulink builds.

Version 2.56 - 07 July 2025

Fixed regression in expression evaluator whereby integers being divided were no longer giving a floating point result (e.g. 100/65535 would give 0.00152588).

Version 2.55 - 04 July 2025

B#6040: New expression evaluator - fixed parsing of negative numbers with typespec prefixes. e.g. [VALUES,{@4f:-10}].

Version 2.54 - 04 July 2025

Write defines for segment start pointer / size to separate header file externs_segments.h, instead of inline in externs.h. This file can then be included in places that do not need to see the rest of externs.h. Avoids [MISRA 8.5], in some cases. Write variable address #defines into separate header file {prefix}_externs_addr.h, instead of inline in externs.h, to reduce cost of compilation when this information is not needed within a translation unit. Added GINMAKE_DISABLE_EXTERN_DECLARATIONS preprocessor exclusion to externs.h file to allow translation units to avoid including duplicate extern definitions [MISRA 8.5].

Version 2.53 - 03 July 2025

XCU: breaking changes to generated code vs ginmake 2.52.

Simulink: Improved PC-Lint Plus / MISRA compliance for XCU8 generated code. XCU split CAN Rx header into 2 files: xcu8_can_rx.h and xcu8_can_rx_get.h. xcu8_can_rx_get.h now depends on the generated externs.h file to avoid multiple declarations [MISRA 2012 Rule 8.5, required]. CAN RX init routine now in separate file xcu8_can_rx_init.c. CAN TX split header into 3 files: xcu8_can_tx.h, xcu8_can_tx_get.h, xcu8_can_tx_set.h. xcu8_can_tx_get.h now depends on the generated externs.h file to avoid multiple declarations [MISRA 2012 Rule 8.5, required]. General tidying of XCU8 CAN RX code formatting. CAN Tx signal setters: precalculate integer value for boolean signals (avoids MISRA warnings). Generate macro [SEGMENT]FIRST_EXTERN_PTR in externs.h, so that if the first item is an array, a pointer to the first element is given. XCU_generated prefix => XCU_auto_ prefix to reduce identifier length (MISRA). XCU: tx_completion => tx_notify.

Version 2.52 - 02 July 2025

B#6013: Simulink: Handle scalar types in addition to char arrays for Min / Max members on e.g. Parameter objects. T#6030: Generate defaults aspect file + embed in ecudef file (if A2L). Simulink: Generate integration code for XCU API for XCU8 targets. Fixed use of grh file in model_sources not adding the referenced paths. Fixed typo in error message (‘sematic’ => ‘semantic’). Simulink object attributes: parse quoted strings as C-style strings and remove the quotation marks. e.g. %$ format: “#.##” ==> #.## %$ description: “This is\na description” ==> \n is interpreted as a newline character. A2L: do not export IF_DATA GEMS FORMAT if the gems format string can be exactly represented by the A2L compu_method. Reworked compilation so that base sources can be compiled before generated externs.h, with other simulink related operations in-between. Simulink: remove .tmp file if it was not copied over existing generated file. Simulink: Include array size in type mismatch error messages for array types. Simulink: new option generate.externs_addresses. Generates #defines with the expected address of each variable. Simulink: new option generate.externs_segment_size: Generates #define with the used size of each segment in the externs.h file. Simulink: new option generate.externs_asm_placement: Generates asm files for various assemblers to place variables in specific order within data segments.
Variables in externs.h then become externs themselves file. Also generates a .c file with the externs as may be required for e.g. testing purposes. Simulink rework how padding vars are inserted. Added ‘attributes’ property to Simulink segment definitions in the options file. This allows [ATTRIBUTES,…] to be added to segments so that the PrgType can be set for XCP access. XCU8 CAN RX: Implemented more optimal CAN signal accessor functions vs EM80-M for aligned signals. XCU8 CAN RX: frame time / period / data are split into separate variables & work with ASM placement feature. XCU8 CAN RX: CAN-FD support. Simulink: Support basic function definitions & calls in .m files; VM can now execute the GemsSignal function. Simulink: case of ‘U’ integer suffix changed to ‘u’ for readability. Rename legacy GEMS Parameter => Channel in some ginmake output messages.

Version 2.51 - 30 May 2025

Note: this is an interim release and does not have full xcu8 target support implemented yet. specifically, the CAN tx/rx API is different to the xcu8 target to EM80-M.

A2L: ecudef archive no longer includes .a2l in the file extension. Added ‘xcu8’ target option to Simulink options file. Added MODULE_NAME, MODULE_VERSION and MODULE_LONG_IDENTIFIER meta strings to override these values in A2L export. A2L: Avoid inserting EPK_ADDR twice in the A2L file. Include EPK in simulink generated A2L file. Output A2L file for XCU8 target without requiring a base GIN file. B#5708: Fixed handling of #elif in preprocessor directives. New evaluator for constant expressions with more C language features including type casts to typedef’d types and numeric literal suffixes. Enumeration strings can now be specified in [VALUES…] directives. [ENUM…] now allows a trailing comma after the last value. Fixed issue with automatic alignment being computed against object size instead of alignment requirement. Fixed: OPTUSERSCALAR units were not being included in ECU definition file. T#1428: Document META strings NO_CLEAR_BEFORE_REFLASH and REFLASH_RESETS_CAL. Simulink: Add VirtualVersion to identity even when not generating GIN file. T#1439: Added support for GRH files in model_sources section of simulink options file. B#5714: Raise an error if defined memory segments [SEGMENT] overlap.

Version 2.50 - 16 January 2025

A2L: Support export of ASCII CHARACTERISTIC items for ECU_STRING objects.

Version 2.49 - 06 January 2025

Support ATTRIBUTES on LOGMAP objects. B#5408: Fixed Simulink: If base ECU definition already contained an “address_map” meta string then Simulink extended ECU definition file could not be verified against linker map file. Added axis_channel and xaxis_channel aliases for axis_param simulink object attribute. Added yaxis_channel alias for yaxis_param simulink object attribute.

T#5156: Moved SDB (DBC signal database) library to package manager. Updated to C++20.

Version 2.48.0 - 09 September 2024

Support ! and ~ name prefix for ECU_STRING objects for hidden / conversion ignore flags.

Version 2.47.0 - 27 June 2024

T#5042: Changed the way that ginmake checks for duplicate names so that if items within un-instantiated structs may have the same name as items in other structs; duplicate checking now occurs as objects are instantiated. Duplicate name errors now also include an instantiation backtrace.

T#5041: Added options for aligning arrays in the generated C code, even if their base type would not require that alignment level.

Added –array-alignment commandline option. Added compiler_array_alignment option to the Simulink options file. This operates differently to the –array-alignment commandline option in that it will insert padding into the generated C code (externs.h) to ensure that arrays are aligned to the specified level. This is safer in case there are situations where e.g. short arrays do not get aligned in the same way.

Changed error “Segment "%0" ignored when creating regions due to being empty.” to use its own unique error code so that it can be suppressed independently of other ‘possible segmentation error’ warnings.

Version 2.46.0 - 03 June 2024

Modified A2L export of items that are a single bit so that they don’t specify a string format. This will result in GWv4 displaying the values as ON/OFF rather than as a number. A2L: For ‘identity’ (default) COMPU_METHODs, items will now use NO_COMPU_METHOD rather than a shared COMPU_METHOD.

Version 2.45.0 - 05 April 2024

Extended struct identifier syntax to allow starting at indices other than 0 by specifying a number before the #. e.g. [STRUCT,MyStruct1#] will start numbering at 1 and [STRUCT,MyStruct2#] will start numbering at 2. Added IF_DATA GEMS extension to support displaying values in hexadecimal format in GW from A2L files, since this feature appears to be lacking in A2L.

Version 2.44.0 - 20 March 2024

Updated to emerald 5.5.7. A2L Export: Now exporting error/default value/string from FunctionTable and Enumerations.

Version 2.43.0 - 06 March 2024

Writable channels now include READ_WRITE in exported A2L file.

Version 2.42.0 - 26 February 2024

Fixed: If format strings were specified, they would not make it through to A2L exports.

Version 2.41.0 - 23 February 2024

Added VAR_PREFIX directive to allow a prefix to be added to all following variable names, can be useful to disambiguate variables scoped within different structures. Modified the way that identity information is included in PROJECT and MODULE A2L nodes. When concatenating strings from preprocessor symbols, whitespace between the strings is now removed. Fixed units making it through to COMPU_METHOD in A2L when User scalars are used. A2L Export: Combine COMPU_METHODs with the same parameters to reduce the size of the A2L file. A2L Export: Write UTF-8 BOM to A2L file so that unicode characters are interpreted correctly. A2L Export: Export units using REF_UNIT on COMPU_METHODs where appropriate so that GEMS unit IDs can be included as LongIdentifier of UNIT definition in the A2L file. Also unit conversions are identified in the A2L. A2L Export: Only export DISPLAY_IDENTIFIER if DISPLAY_IDENTIFIER is explicitly defined in source code. A2L Export: Change the way that object Name field is generated so that it is based upon the ginmake item name rather than the variable name, unless an IDENTIFIER ATTRIBUTE is explicitly defined. STRUCT instantiation: if the struct name ends with ‘#’ then a numeric suffix is added to the name instead of the default array syntax.

Version 2.40.0 - 20 February 2024

Added XCP PROTOCOL type. When generating A2L, set the GIN protocol to avoid address space exceeded errors. Do not warn about PCTL / PACK / STAT1 for XCP based ECUs.

Version 2.39.0 - 07 February 2024

T4686: Command-line option to generate A2L instead of GIN. T4697: A2L: File comment to include GIN notes. T4695: A2L: Generate MOD_COMMON. T4687/T4690: A2L: Generate Segment information. Fixed handling of definitions over multiple single-line C++ comment lines, where the comment characters could get included in object definitions. T4694: Generate MOD_PAR section: EPK, ADDR_EPK and ECU_CALIBRATION_OFFSET. [META] directives may now contain braced sections which are subject to symbol substitution. Symbol substitution in braced sections will now remove double quotes from the substituted value. T4696: Generate FUNCTION definitions in A2L to mirror GEMS GIN Category definitions. Generate DISPLAY_IDENTIFIER in A2L. Define GINMAKE_A2L preprocessor symbol when generating A2L. T4693: Added [INCLUDE_A2L,] directive to include an A2L file in the output A2L MODULE section. Minifier: Added read_only section for setting items to read-only in ‘customer’ GIN files. Upgraded to C++17 standard.

Version 2.38.0 - 19 October 2023

Added DELETE directive. Fixed missing conversion from directive IDs to string for newly added directives in 2.37.0. Redefining VALUES on an object is now a warning rather than an error, since this could be wanted behaviour when using EXTEND. Added option for VALUES expressions for defining address: [VALUES=#Analog 00] [VALUES=#Analog 00:channel]

Version 2.37.0 - 18 October 2023

Added new directives: EXTEND, RENAME, IDENTIFIER, LONG_IDENTIFIER, DISPLAY_IDENTIFIER. New GIN file version 3.34, supports serialization of IDENTIFIER, LONG_IDENTIFIER, and DISPLAY_IDENTIFIER.

EXTEND directive allows updating of existing GIN items (e.g. rename, adding default values / descriptions etc). These extensions could be provided in a separate file from the original definition for easier customization of build variants using common source code. Additionally can avoid having verbose metadata in the main source code header files used by assemblers / compilers.

Version 2.36.0 - 12 September 2023

Upgrade to VS2022. Updated dependencies. GIN: fixed loading of identity when scanning file for name/version only and the GIN file uses a virtual version. Added –asm-to-c command-line option to convert assembly header files to C headers. T4417: Produce gin_path.txt for non-simulink builds.

Version 2.35.0 - 08 February 2023

T1438: Support basic typedefs of built-in types in C code. e.g. typedef uint8_t ChargeState; Changed Simulink export to use typedefs for enums rather than #defines in externs.h. Scalar/Offset/RW/Bitmask/Format fields: IFF the whole field is a preprocessor symbol then it will be substituted. Fixed bug in deserialization of values that use type specifiers. Added unit test for testing methods of achieving 100% scaling. Updated to emerald_id 1.2.26. Updated to emerald 5.5.2.

Version 2.34.0 - 18 November 2022

B2897: Improved error messaging for Simulink models. Made CAN frame elapsed / time signals ‘uint32’ rather than ‘single’ by default. To go back to the old behaviour, in simulink options file, set generate: can_integer_frame_times: false

Updated to emerald 5.5.1. Updated to emerald_id 1.2.17.

Version 2.33.0 - 19 May 2022

B1996: boolean_T simulink type will now generate values of type bool in the GIN file.

UT: JSON configuration files can now use more permissive JSONX format: (see https://rubydoc.info/gems/json-next) quotes for strings are optional if they follow JavaScript identifier rules. backtick quoted strings, (like ES6’s template string literal). A backtick-quoted string may span several lines and you are not required to escape regular quote characters, only backticks. Backslashes still need to be escaped, and all other backslash-escape sequences work like in regular JSON. For single-line strings, single quotes (’’) are supported in addition to double quotes ("") # can be used to begin comments (in addition to // and /…/). Commas are optional and trailing commas are supported too. Quotes for string values OR keys are optional if they follow JavaScript identifier rules. Such string may also contain ‘-’ characters. Additional extension: dotted strings (e.g. one.two) are supported.

Version 2.32.0 - 19 May 2022

UT : Fixed linker section address parse for sections whose address appears on the next line in the file.

Version 2.31.0 - 19 May 2022

UT : Added an error if GIN file contains an empty address map when performing map file verification. UT : Perform address verification in linker address order for easier manual analysis. UT : Do not strictly require physical_address to be specified in simulink segment options in order to verify against map file - the section address is now parsed from the linker map file. Resolves issues where physical section placement can change. UT : Fixed insertion of object address offsets into ECU definition file for address verification purposes (fixes address verification of e.g. Simulink CAN RX) - this got missed from merge.

Version 2.30.0 - 18 May 2022

Merge map file verification code into main build - verification was otherwise succeeding without actually checking anything. UT : Added –verbose command line option. Gives more verbose linker map verification output.

Version 2.29.0 - 17 May 2022

UT : Additional change to IDENTITY handling for backwards compatibility issue.

Version 2.28.0 - 17 May 2022

UT : Fixed update of name/version in ECU Identity if IDENTITY directives are used. UT : Updated to Emerald 5.4.4 and emerald_id 1.2.2.

Version 2.27.0 - 21 March 2022

T2876: Added IDENTITY directive for adding fields to generated ECU Identity (to support GLS/GLD loggers use [IDENTITY,GlsVersion,“01V00”]). Output generated identity JSON to file.

Version 2.26.0 - 07 March 2022

B2854: Do not define near/idata/bdata segments if named segments have been manually defined - fixes use of manually names segments with page tables for C builds. B2853: Exclude multi-line comments that are within preprocessor excluded sections. T2787: Added feature matrix to manual.

Version 2.25.0 - 17 January 2022

UT : GIN file version 3.33. Supports attributes + hidden flag on User Scalars + additional GinItem fields (identifier, long identifier, description etc). Enumeration types now also support additional GinItem fields (attributes, identifier, long identifer, description). T2704: Add ability to define units in GIN file (requires GIN version 3.33). Added UNIT and UNITQUANTITY directives for defining user units. T2697: System in place that will allow an option to be used to record the units that AFR are calibrated to & added description of this to the manual. Added unit test for userscalar/optionuserscalar / dynamic base units. UT : Reordered manual topics & made definitions section titles more consistent & alphabetical. UT : Fixed: User scalar units were not being added to the ECU definition file. UT : Fixed issue with default values for empty fields (e.g. scalar multiplier on UserScalar objects). UT : Added features to UserScalar: enable setting display units / base unit overrides. handle unit conversions within gemscom library. gin object now has a UnitSystem object. UT : User Scalars can be hidden from units configuration by prefixing name with ‘!’. GIN file version 3.33 only. UT : Unit tests - store build results in test_vectors/out for convenience. UT : Added GIN/Ginmake/GWv4 compatibility matrix. UT : Updated styling of manual document. UT : Adjusted Simulink multiplexor output to fix up offset of big endian multiplexor signals and include top bit of length to indicate endian.

Version 2.24.0 - 07 December 2021

T2256: Support for structs and arrays of structs. Added STRUCT directive. Added PACK_PUSH / PACK_POP for controlling alignment packing from within code.

UT : Reworked some string processing to use string views. Slight speed increase. UT : Fixed regression dealing with parenthesized references (e.g. user scalar references in units field).

Version 2.23.0 - 02 December 2021

B0158: EM80-M/ginmake multiplex CAN. UT : Fixed build of GIN files from source code that no longer uses page tables.

Version 2.22.0 - 11 November 2021

B0205: Fixed support for Option Steps on table / map axes. UT : Improve error message if failed to open a file (includes the filename). UT : Added gcc_section option to SEGMENT_ADDRESS definitions for storage in the GIN file for address verification purposes. UT : Added physical_address option for segments in simulink options (optional) - if this is specified then it can aid address verification. UT : Issue fatal error if required license is not installed.

T2244-7: KH: Added a MIN_VERSION directive to enforce a minimum Version ersion.

UT : Added [PARSEMODE,ASM|C|C11] directive, which must appear within the first few lines of a source file.
This allows individual files to define how they should be parsed by ginmake, making it possible to combine ASM + C in the same ginmake build.

The C11 parse mode is not ready for real-world use - it enables a new 
expermental parsing mode that may allow typedefs and struct definitions to be 
handled in future.  This mode will not handle existing ginmake builds at 
present.

Updated to boost 1.77.0.

Version 2.21.0 - 21 July 2021

Simulink: Matlab .m files are now processed before other source inputs and the state between files is preserved to allow enum classdefs to be accessible in multiple files. Fixed an issue where processing the simulink representation of an object before the C extern for it would result in ‘duplicate symbol’ errors.

PB: Fixed some usages of Virtual Version. When running simulink build on a GIN file that already has a virtual version, the base version should be used. #3669: KH: Treat duplicate object names as errors if the object type is the same. Can be suppressed with command line option –treat-duplicates-as-warnings. #3669: PB: Reworked duplicates checking method. Added new error and warning codes for duplicates / old name duplicates. #4721: KH: Simulink CANRX definitions - added additional comments to aid readability. PB: If available, use the original source file/line for errors in the base GIN file when building simulink GIN. Previously there would be no file/line information. #4878: KH & PB: Added error on duplicate entries in simulink options file. Previously, the application would exit in some cases due to bug in JSON parser. PB: JSON parser: Fixed bug in JSON parser that would fail to parse objects with duplicate keys that are arrays. PB: Removed addition of ‘old names’ for CAN RX Time / Delta time etc signals as they could lead to compilation warnings and are no longer needed. PB: Optimized a number of execution time hotspots in order to speed up build times. #3481: KH: Simulink dbc import - Added error and test for duplicate CAN IDs per port. PB: Matrix signals now get generated as tables / maps. #4263: KH: Warning added for when floating point quantities are used without limits defined. Added a test for it. #4929: KH: general tidying. PB: Fixed writing of some older format GIN files, discovered through setting up wider regression test catchment. PB: Optimized GIN ‘find’ routines using hash table. PB: If simulink options file does not exist, raise ‘cannot open file’ error instead of a syntax error in the non-existent file. PB: Generate uniformly named ‘gin_path.txt’ file that contains output GIN file name. Useful for testing & scripting. #4549: PB: T1252: Support Simulink enumerated types. PB: Major rework of Matlab VM for parsing Simulink workspaces. PB: Command line options ‘-c’ and ‘-C’ removed and replaced with opt-in –namecheck & –namecheck-shell options. T#1979 PB: Generate GIN Minifier template from GIN file for template authoring purposes.

Version 2.20.0 - 25 May 2021

Breaking changes: #3829: CAN RX import: added new option to optimize CAN signal base size so that reading values from the ECU in GWv4 and additionally selecting them for ECU internal logging will not waste bytes in many cases.

This new behaviour is enabled by default and will affect reproducible 
builds.

In case of problems, the old behavior can be retained in simulink options 
files by specifying:
    can_signal_size_optimization: false
in the 'generate' section.

Other changes: Modified identifier legalization to deal with items with a numeric prefix. #4755: Added $(FilePrefix) macro for simulink options.

Added rx_gin_category, rx_raw_gin_category, rx_time_gin_category options for Simulink CAN import sections. Allows CAN channels to be added to GIN categories. Catgories need to be defined in e,g, an M file: %+ [CATEGORY,CAN1,CAN 1] %+ [CATEGORY,CAN2,CAN 2] %+ [CATEGORY,CAN1.Signals,Signals,CAN1] %+ [CATEGORY,CAN1.Time,Time,CAN1] %+ [CATEGORY,CAN1.Raw,Raw,CAN1] %+ [CATEGORY,CAN2.Signals,Signals,CAN2] %+ [CATEGORY,CAN2.Time,Time,CAN2] %+ [CATEGORY,CAN2.Raw,Raw,CAN2]

Version 2.19.0 - 12 May 2021

#4261: Added a way to define memory regions without external page table header (SEGMENT + SEGMENT_ADDRESS). #4262: Add a way to assign a segment to a section of code with SEGMENT_BEGIN / SEGMENT_END. #4670: Simulink: If item can’t be placed in a segment, ginmake should raise an error. #3788: Added customizable output filename for Simulink builds via output_filename option in the Simulink options file. Added the built-in macro $(Name) for simulink option processing. Expands to ECU name in GIN file.

Version 2.18.00 - 04 January 2021

Added ability to specify ‘default’ value for ENUM (optlist) definitions. e.g. [ENUM=Bool,0,false,1,true,?,invalid]

Added section to the manual regarding the ecudef file format. Mentioned _GEMS_Initialize functions in the manual.

Version 2.17.00 - 02 November 2020

Updated to googletest 1.10.0. Simulink: Add items in functions whose names end with _GEMS_Initialize to initialization lists (to support latest matlab version).

Version 2.16.00 - 06 October 2020

#4116: Fixed application for attributes on frames extended IDs (e.g.) GenMsgCycleTime. #3986: Rename Option List => Enumeration. This is more in line with how similar types of object in other tools & programming languages are named.
It also means that such objects are less easily confused with lists of options in the GWv4 user interface. Ginmake is still backwards compatible when building code that uses the old OPTLIST and ol(name) terminology as opposed to ENUM and enum(name). #3995: Added mechanism for specifying virtual version for simulink builds.
Macros $(BaseVersion) and ${ModelVersion) are available, as are environment variables. see virtual_version in simulink options file.

Version 2.15.00 - 24 August 2020

#4098: CAN RX node filtering should use the node referenced from the signals (receiving node) rather than the frame (transmitting node). The old behaviour can be retained by using: filter_rx_nodes_on_signals: false in the can options.

Version 2.14.00 - 09 July 2020

#4083: Fixed incorrect assignment of options lists (enumerations) in simulink builds. #4077: Matlab R2013b support: Added SamplingMode field to signals Can be turned off via generate: { sampling_mode: false }. #4077: Matlab R2013b support: Put signal generator functions in separate files Can use old behaviour by setting generate: { m_file_per_function: false }.

Version 2.13.00 - 29 May 2020

Do not include old name for CAN items if it is the same as its original name to avoid duplicate warnings. Support real_T for the time being for Simulink.. Ideally ginmake should be extended to support typedefs (including structs).

Version 2.12.00 - 22 May 2020

#3406: Categorise Simulink.Signals, Simulink.Parameters etc in output GIN.
Can be wired off in the simulink options file.

Version 2.11.00 - May 2020

#3933: in_signals referenced in the initialization function are now placed in a separate initInSignals array to facilitate separate initialisation and reduced load on the main loop. The initialization code must be topped and tailed with // GEMS_Initialize_Begin and //GEMS_Initialize_End.

Version 2.10.00 - 06 April 2020

#3910: Fixed corruption of V1 ecudef files. Added additional check that GIN can be extracted from the output ecudef file to prevent the possibility of regressions in future.

Version 2.09.00 - 27 March 2020

Output Version ersion at the end of the build. Changed naming of CANRX frame related signals in output GIN files. #3880: Only import CAN signals as integer if multiply/offset are identity ([1 0]).

Version 2.07.00 - 10 March 2020

#3750: Document ASM segment handling.

Changed the way regions/segments are handled when building ASM source. For GIN files that use EEROM + EEROM2, these regions will now be separated in the output GIN file. It is now possible to generate arbitrary segments in ASM builds as for C builds and eerom segments will now be named.

#3841: Duplicate externs in from simulink code should not generate multiple instances. ginmake will check that duplicated externs are of the same type and size. Simulink: if errors occur during build, ginmake will now have a non-zero exit code (typically -1). #3801: Generate CAN RX frame timeout signals & getter functions. #3738: Generate ecudef .h/.c for embedding.

Internal project restructuring / updates to internal dependencies.

Version 2.06.00 - 05/02/2020

Fixed infinite loop when input .m file is empty. Fixed inport generation from setter functions.

Version 2.05.00 - 30/01/2020

Fixed breakpoint table referencing on lookup tables in the generated GIN file. #3557: Import descriptions from base GIN parameters into matlab workspace. Can be switched off with generate: workspace_descriptions:false. Import DBC signal comment into matlab signal description field. #3716: Ignore exe verson number in installer to allow install of prior version. #3729: Simulink CAN TX - use integer types for signals if possible. #3708: Reduce generated workspace file sizes by using factory function to create signals. Can be switched off with generate: workspace_optimize:false. #3495: Simulink - Create a version define containing the model version.

Version 2.04.00 - 23/01/2020

#3710, #3711. Added [HARDLIMITS,min,max] which is equivalent to VALIDRANGE except that is is specified in real (physical) values. Simulink Export: Min/Max are set as both LIMITS and HARDLIMITS unless overridden by special comments. Simulink: Don’t check for page boundary overlaps on items from base GIN. Do not emit page boundary overlap warnings if within a single segment (contiguous address range).

Version 2.03.00 - 17 January 2020

#3321: When legalizing matlab variable names, leading underscores are not valid. variables are now prefixed ‘a_’ instead & keep them at the start of alpha sorted lists. added generate:identity flag to simulink options. #3561: Import items from base gin as integer or boolean where possible. This new behaviour can be reverted to via generate: get_set_real_only: true in simulink options file. #3363: Support boolean and integer values from CAN RX. This new behaviour can be reverted to via can: rx_real_only: true #3671: Import can rx signals as integer/boolean.

Version 2.02.00 - 15 January 2020

Fixed bug generating model build ID. Was not taking into account headers critical to ABI because they had not been flushed to disk yet.

Version 2.01.00 - 14 January 2020

Added tx_name_prefix & rx_name_prefix options to simulink can configuration for prefixing names in the GIN file. #3679: Treat vector/matrix Simulink.Parameter objects as tables/maps. #3680: Simulink: Insert default Values from .m file into GIN

Version 2.00.00 - 19 December 2019

#3576: Pick up DataType from Simulink Table or Breakpoints sub-objects if not given by top-level object. #3573: Added option cantx_data_size with default of 12 and emit a TYPEDEF_SIZE directive.

Version 1.99.00 - 18 December 2019

Simulink: Added option canrx_data_size with correct default of 16.

Version 1.98.00 - 16 December 2019

Reset file ACLs following move. Removed user/organization option from installer.

Version 1.97.00 - 10 December 2019

Generate ECU_identity_size value.

Version 1.96.00 - 10 December 2019

More mods to alignment (do not use arrays). Fixed alignment padding calculation. Sort items in generated externs file based upon segment to reduce confusion. Insert some additional comments for readability to generated externs file.

Version 1.95.00 - 10 December 2019

Modified alignment methodology for simulink builds.

Version 1.94.00 - 09 December 2019

#3560: Simulink: Add support for boolean types from user workspace. Boolean types are given a ‘bool’ attribute for later editing enhancement in GW. #3432: Simulink: Support integer types and doubles from user workspace.

Version 1.93.00 - 06 December 2019

#3461: Generate Build ID for generated model code based upon hash of important output files (excluding comments) + the base GIN file. Generate embeddable identity file. Include model build ID in GIN file + ecudef file. Include model versions in extended identity.

Version 1.92 - 29 November 2019

Updated to VS2019 Updated to boost 1.71 #3460: Include simulink model version in generate gin file name.
Can be switched off with generate: { gin_append_model_version: false }. Will also generate a text file containing the path to the generated gin file for use by other build tools etc. #3307: Simulink: added options tx_nodes and rx_nodes for CAN DBC import to filter the DBC based upon frame sending node. Installation of GIN files as compressed ecudef files can be enabled by setting environment variable GINMAKE_INSTALL_ECUDEF = “1”. This is not enabled by default until there is wider support by all GEMS software. Generate compressed ecudef version of the GIN file. SHA1 hash of the GIN file is output to the console. #3456: Ginmake-simulink license option. #3375: Simulink: Added ability to specify limits in comments with fields: min,max,min_raw,max_raw e.g. %$ min: 10 %$ max: 1000 Added [LIMITS,min,max] which is equivalent to VIEWRANGE except that is is specified in real (phsysical) values. #3435: Added an option to export all variables from m files to externs.h generate: { unused_externs:true } #3510: Simulink: parse the Min and Max fields apply these to the GIN file.

Version 1.91 - 23 September 2019

#3168: Simulink: per-object segment override option.

Version 1.90 - 20 September 2019

Output endian for all parameters.

Version 1.89 - 20 September 2019

#3360: Fixed address offsets of CANRX data. #3359: Fixed documentation regarding regions vs segments. Added endian option to segment items in simulink options file. Fixed assignment of region endian mode to region objects. Generate parameters for individual CAN frame bytes. Can be turned off with generate: { can_frame_bytes: false } Require SC_is_near_zero(f) function for bit signals. Avoid emitting sign mismatch warnings when underlying type is not a built-in.

Version 1.88 - 19 September 2019

#3333: Simulink: Special handling for bit based values.

Version 1.87 - 19 September 2019

GIN version 3.32. Added per-object / per-region endian modes. Changed the way raw values are dealt with in the gemscom library. #3326: Simulink DBC import - generate gems parameters for DBC signals. Include compiled GIN version in output messages. SHL and SHR expressions for shifting following masking (avoids needing to do this with the multiplier). BIT expressions as a terser way of expressing a mask + shift, similar to DBC bit offset + length.

Version 1.86 - 13 September 2019

#3328: Simulink: swap X/Y breakpoint table linkage on generated maps. Simulink: Set writable flag for option/table/map.

Version 1.85 - 12 September 2019

Simulink: Changed the way externs are processed.

Version 1.84 - 12 September 2019

Evaluate all externs in simulink generated header.

Version 1.83 - 11 September 2019

Fixed parse failure resulting in aborted compilation for C source where the segment directive contains non-prefixed hex numbers.

Version 1.82 - 09 September 2019

#3309: Simulink: Do not export CAN frames reserved for unassigned signals. #3304: Simulink: Autogenerated can_tx.h now has an include guard.

Version 1.81 - 03 September 2019

Include CAN tx rate (from GenMsgCycleTime, if present otherwise default to 10) in CANTx_FrameConfig. Added default_tx_rate to can port config in simulink options file. Simulink codegen: CAN tx functions should have a return type of ‘void’. CAN tx: generate pre-baked packing of CAN signals to reduce firmware overhead.

Version 1.80 - 03 September 2019

Catch more syntax errors in JSON parser. e.g. rx:[“foo”] tx:[“bar”] would parse successfuly even though syntactically incorrect and the resulting document would not be correct either. Refactored error handling code to avoid crosstalk in unit tests.

Version 1.79 - 30 August 2019

#3297: Fixed Matlab parsing of fractional doubles.

Version 1.78 - 30 August 2019

#3294: Fixed incorrect scaling of items due to incorrectly parsing floating point numbers as (int . int). Added unit test to cover this. #3296: CAN dbc paths in simulink options file should be relative to the options file, not the working directory. #3240: Account for new DeltaTime field in CAN RX data structure. #3284: Raise an error if simulink file_prefix is not a valid MATLAB identifier. #1622: Feature: Range based construction of parameter tables.

Version 1.77 - 08 August 2019

#3230: externs.h file now includes rtwtypes.h #3233: Do not insert NULL chars for CAN_Rx_FrameConfig. #3232: User Hex representation for CAN IDs in simulink CAN config source files. #3234: Define CAN frame count macros. #3239: Do not use relative paths for headers in can workspace files. #3228: Fixed problem with out_dir_workspace and file_prefix not being applied correctly.

Version 1.76 - 31 July 2019

Generate CANRX signals from DBC file and frame timing information signals. #3212: Added segments:[…] option to simulink-options for defining memory segments. Added parameters for viewing CAN rx time / frame data (DBC signals -> parameters not implemented yet as will require new GIN file version).

#3217: Fixed missing brackets in SC_round function. #3216: Disabled generation of units for the time being - some units in the base GIN file may not be acceptable unit expressions. #3218: Simulink: If there are duplicate object names in the GIN file, generate disambiguated names. #3219: Separate output dirs for generated gin/workspace/code. Improved error message if Json parse of simulink options fails to include line/column. Added TYPEDEF_SIZE directive.

Version 1.75 - 25 July 2019

Installer package. Fixed: Version details were not being embedded in the compiled exe. Copy simulink description field as a ginmake [DESCRIPTION,…] directive. Escape units and name in ginmake comments generated from simulink. Enabled multiple ginmake comments to be specified in simulink workspace file for aliases and also other directives. Added more readable option for specifying ginmake object fields in matlab workspace files (see manual for whats available). Added INPUTS and OUTPUTS directives for the purpose of defining audit chains in the GIN file. At some point this will enable generating audit graphs. Fixed C lexing error for hex numbers with letter e or E in them. Emit warnings if unrecognised options are specified in the simulink options file.

Version 1.74 - 24 July 2019

Simulink: Section placement for externs. ginmake style comments are now supported in user.m workspace file. Use %$ for object comments before the assignment of the simulink object constructor. Use %+ for other ginmake comments (e.g. for defining option lists). Merged GIN file is now generated from the generated externs header. Added _DEFINE directive to enable preprocessor symbol definition from ginmake comments alone. No longer generates “Extension GIN”. Only a merged GIN is generated. The merged GIN is now LZMA compressed and converted to a source code array for static inclusion into the CoPro firmware (for GW to download). Added options to control which files are generated by simulink export. This also allows the externs file to be hand edited and used to generate the merged gin if desired. Simulink: Optionally use temporary files for output + compare before overwrite. Simulink: Now handles relative + absolute paths (relative to options file). Fixed some compilation issues in gems library when building with stricter C++ compilance. Added unit test to validate an ASM build.

Version 1.73 - 18 July 2019

Moved over to VS2017 and gemsbuild system. Refactored project to enable unit testing. Implemented basic matlab virtual machine for processing simulink workspace files. Implemented parsing of simulink generated model code to extract used get/set/externs. Implemented code generators for simulink support. [Incomplete]

Version 1.72 - 14 June 2018

#2384: Option to tag existing gins with customer access ids.

Version 1.71 - 09 April 2018

#1547: Added license dongle restriction. GIN version 3.31. Remove unicows.dll delayload - win98 no longer supported.

Version 1.70 - 08/03/2018

#1526: Added EQU annotations.

Version 1.69 - 01 April 2016

Added SIZEOF and ADDROFF directives. This enables aliasing of byte and word values. GW #859: Fixed: GINMAKE: Alignment of 16bit following a 32bit causes an overlap. #890: Fixed: ginmake does not handle ASM label & instruction on different lines.

Version 1.68 - 13 November 2015

Emit warning if parameter has an address of zero as it is then not usable in CAN telemetry / comcode options etc.

Version 1.67 - 17 September 2015

Command line option ‘-r’ to generate XREF and XREF files from source input.

Version 1.66 - 31 July 2015

Added output of original variable name + source code file/line and info into output gin. For users with staff dongles, this information will be displayed in the descriptions window in GWv4 versions 4.02.08+.

Version 1.65 - 30 July 2015

Added ’none’ checksum type option for [SEGMENT] definitions.

Version 1.64 - 10 July 2015

Fixed problem with custom segment definitions not having their size calculated correctly. As a result of this bug, it would also not correctly set the checksum size. Updated to latest GEMS libs. Updated to use MSVC2013 compiler.

Version 1.63 - 19 February 2015

Added ability to generate user-defined calibration regions from segments in ASM code. See ginmake docs: [SEGMENT,<mem_type>,,<attrib_name>{,<checksum_name>,<checksum_type>}] segment definitions must appear before pagetbl and region variables. Update to latest gems/gemscom libs.

Version 1.62 - 19 December 2014

Updated gems/gemscom libraries => possible fix for a issue with generating older version GIN files that would end up displaying parameter list bars at full scale always. Updated to boost 1.54 and fixed some build issues arising from that. Now building with SP1 compiler.

Version 1.61 - 03 April 2014

Added SEGMENT definitions for C compilations. Allows better configuration of the page table.

Version 1.60 - 23 May 2013

Fixed error in GIN serialization affecting GINS from version 2.28+.

Version 1.59 - 17 May 2013

GIN file version 3.30. 24/32/64 bit value support. IEEE 32bit/64bit raw value support.

Added type specifiers for raw/real values. Allows the underlying type to be overidden for some things such as function table /option list raw values. Format: @Nt:VALUE

Where 'N' is the number of bytes in the value (1,2,3,4 or 8).
If 'N' is zero, the value is undefined.
Where 't' is the type:
	i = signed integer
	u = unsigned integer
	f = floating point	
e.g. 
@4i:1234567
@2u:65535

Multiplier values may be specified as a numerator and denominator for integer scaling (requires the use of typespec’d values in the Scalar field of definitions). If you are using 64bit integer values then scaling in this way may be neccessary as the value would potentially not be representable using ‘double’. e.g. @8u:1/@8u:0x10000000

Version 1.58 - 03 January 2013

Issue fatal error if ASM compilation does not specify segments and ginmake attempts to assign addresses to objects (instead of crashing). Update gems/gemscom libraries.

Version 1.57 - 04 October 2012

Include site count and actual site count in function table warning message about site counts not matching. Fixed potential crash processing indirect axis options. Fixed error message “X is outside of EEROM space.” Fixed icorrect lookup of option lists by name if there are option lists with no items (e.g. if ;[OPTLIST] is seen).

Version 1.56 - 07 Mar 2012

GIN file version now at 3.29. Fixed single character format strings being ignored. Updated libraries. Fixed storage of format strings in user scalars. Added ability to set formatters for table/map axes.
Use a semicolon separated list in the base/format field to specify axis formatters.

Version 1.55 - 08 Feb 2012

GIN file version now at 3.28. GWv4 ticket #791: Dynamic object names i.e. map/table/option/parameter names can be based on an option that has an option list, much in the same way as dynamic user scalars.

A dynamic name option may be specified by adding the name of an option in 
square brackets.  
You should also specify a static name for the object.  
If one is not specified then the variable name will be used.

e.g. [Fuel A[Fuel A Name],...]
or [[Fuel A Name]Fuel A,...]

This specifies that the 'Fuel A Name' option should be used to pick up the 
dynamic name.  The static name is 'Fuel A' and this is used in calibration 
conversions and comparisons.
Options used for the selector MUST have an option list associated with it, 
otherwise an error will be issued.
The option list may have empty items in it that will cause the object to 
default to it's static name.	

Updated gems libs. Fixed possible crash in gems::ConvertOemToAnsi. Since Windows 98 compilation was broken in 1.54 by uprades to dependent libraries, the build has been moved to the VS2008 IDE to be in-line with all other projects to reduce maintainence overhead. Windows 98 will no longer be supported.

Version 1.54 - 26 Jan 2012

GIN file version now at 3.27. Hidden flag using ‘!’ at start of object name (similar to usage of ‘’). May be combinded with ‘’. Indirect axis table/parameters. Dynamic user scalar units.

Version 1.53 - 01 September 2011

GIN file version now at 3.26. Added support for remote feature upgrade. Optimized alias checking step. Optimized a few string handling routines. Reduced temporary string allocation significantly. Added ECU_STRING object definition:
example ds.b 6 ;[ECU_STRING,Example]

Version 1.52 - 01 March 2011

Added ability to specify a formatting string for options, parameters, tables, maps etc. This allows decimal places etc to be specified. This is specified by adding a format string in the ‘base’ field of options/tables/maps/parameters, where you normally specify hex/decimal. e.g. #.# for 1 decimal place.

Updated internal libraries.

Version 1.51 - 24 January 2011

ASM Page table parser: Can now add a ‘PAGETBLEND’ label in your code at the end of the page table to indicate that the end of the page table has been reached. This avoids some issues when processing some page table definitions that are followed by additional ds.? instructions that are not actually part of the page table.

No longer parses commented out lines in page table definitions.

Version 1.50 - 17 January 2011

Use ‘server’ for names database rather than fixed IP address.

Version 1.49 - 06 September 2010

Fixed handling of METAFILE definitons.

Version 1.48 - 29 July 2010

Fixed preprocessor exclusions when compiling C code.

Version 1.47 - 29 July 2010

Lifted restriction of pagetbl being only 32 bytes long in ASM build as its size cannot be reliably calculated.

Version 1.46 - 28 July 2010

GIN file version now 3.25.

Fix handling of closing brace at end of C style page table if it is on its own line.

PAGETBLV2 handling, allows multi-region calibration space for use with extended protocol.

Added warnings when using PAGETBLV2 for parameter space objects that span page boundaries.

Added errors for EEROM region spanning objects.

Added optimizations to pre-processor. Added optimizations to reference resolving algorithm.

Version 1.45 - 27 May 2010

Fixed incorrect protocol/connection warning when archiving pre 3.24 version GIN files.

Only output note about alias conflicts if there were any aliases.

Version 1.44 - 26 May 2010

GIN file version now 3.24

Implemented extended comms protocol. CONNECTION definition: COM connections must define baud rate. PROTOCOL definition: added max read and max write options. PROTOCOL definition: Made it possible to associate a protocol with a connection type.

No longer an error not to add a comma for the parent category reference part of a CATEGORY definition.

Use map lookup in definition parse (should improve performance).

Added [XMLDESCRIPTIONS]. Allows objects to be described in an external XML file that can either be embedded in the GIN file or supplied in the GWv4 distribution.

Version 1.43 - Built on 29/04/2010

Delay load libmysql.dll to reduce startup time if names database checking is not required (and also avoid the need for the dll if not used).

Delay load unicows.dll.

Changed optimization settings.

Version 1.42 - Built on 26/02/2010

Added inline comment conditionals that only apply to the next definition rather than the entire line. e.g. ;[_IF1,(OMEX != 2)][Fuel Mod,…] ;[_IFDEF1,OMEX]… ;[_IFNDEF1,OMEX]… If any definitions directly following an _IF1, _IFDEF1 or _IFNDEF1 are other inline preporcessor directives or _WARN directives, then they are ignored and the next ’normal’ definition afther this is retained or rejected.

Version 1.41 - Built on 24/02/2010

Implemented local warning supression with _WARN.
e.g: //; [_WARN,4019][some expression that generates warning 4019]

Added METAFILE definition for use with output pin config feature.
Initially this will be an xml file that is manually generated to include in the gin. In this situation, it must be called pin_config. e.g. //[METAFILE,pin_config,aem25_pin_config.xml]

Version 1.40 - Built on 11/12/2009

Added ability to specify %n and/or %v in the specific output gin file name (-o option). This allows you to tailor the output gin file name. e.g. -o"%n-%v.gin" would output the name as NAME-VER.gin rather than NAMEVER.gin. In some cases this makes the output file name easier to read.

Version 1.39 - Built on 27/07/2009

Added warning for when sign of underlying type does not match sign field.

Only emit an alias warning if the aliased objects has mismatched option lists or non-identical overlapping bitmasks.

Version 1.38 - Built on 20/07/2009

Use modified version of 14bit protocol. Old version is now invalid.

Moved project to SVN.

Version 1.37 - Built on 20/02/2009

Support labels in PAGETBL in asm builds. Also extended support for dc.l in pagetbl. dc.b is now ignored for backwards compatibility with 24bit pagetbls.

Version 1.36 - Built on 20 November 2008

Fixed installation of GIN files, should the user have the gin files directory specified with a trailing backslash.

Version 1.35 - Built on 20 November 2008

Fixed broken padding in user scalar records in archive versions prior to 3.15.

Version 1.34 - Built on 20 November 2008

Linked against Microsoft Layer for Unicode so as to support windows 98.

If build fails when in source code update mode, don’t update the source code.

Version 1.33 - Built on 19 November 2008

Summary of new features in 3.23 GIN files:

  • ATTRIBUTES can now be assigned values.
  • CONNECTION tag added for defining default connection information (e.g. baudrate).
  • Strings now support unicode characters hat can be inserted using special entity reference character sequences.
  • PARAMTBL definition changed for more flexible axis definitions.
  • DESCRIPTION tag allows descriptions to be tagged onto objects.
  • META tags for additional arbitrary information.
    Currently allows CAN channels to be given names.

More in depth on the new features / other changes:

Made ATTRIBUTES definition able to have values assigned to each attribute. e.g. [ATTRIBUTES,attr1 = value1, attr2=value2]

Added CONNECTION definition. This allows connection methods to be defined: [CONNECTION,COM,38400] [CONNECTION,FTDI] [CONNECTION,LIBUSB] The idea behind this is so that the user can select which ECU they are connecting to in the case of connection problems. The user can be aided via a wizard using this information by making sure that they have the correct port settings. There may be multiple connection types if required (e.g. X25 has COM and LIBUSB). An error will be given if no connections are defined and the GIN file version being compiled is v3.23+.

Now using unicode strings internally.

As of v3.23 gin files, strings are stored in UTF8, so that it is possible to have unicode characters names that would otherwise not be possible. Such characters will only currently work in GWv4, NOT GWv3 (unless they can be mapped into the codepage of the windows version being used. This will vary depending on the language of the windows installation).

It is now possible to use entity references in strings. These are very similar to HTML entity references, but they have a different syntax - the ‘&’ and ‘;’ characters are replaced with the $ symbol.
e.g. < codes for ‘<’ This becomes: $lt$ in ginmake speak. Entity references enable us to circumvent the issuse of the DOS and ANSI code pages not entirely overlapping one another and also allows other special characters that may not be present in these codepages. For example the capital ‘omega’ symbol is in the DOS codepage, but not in the ANSI codepage. The symbol can now be represented with ‘$Omega$’.
There is a list of all supported entities in the ginmake manual under the new “String Handling” section.

If you find that an entity is not supported, you can enter the value of the code-point directly. e.g. These each code for Omega. $Omega$ $#x03A9$ $#937$ Be aware that entities are case sensitive. $Omega$ and $omega$ are not the same!

As of v3.23 gin files, names and units are no longer length restricted.

ParameterTable objects could not be successfully built. Definition now changed to be common to table axis generation.

Added DESCRIPTION tag, so that items can be given inline descriptions for additional information in the user interface. For example, options can be given a description that would be displayed as a tooltip in GWv4.

Added META tag, so that GIN file gan be given ‘global’ attributes (meta information). This will initially be used for naming CAN telemetry channels: [META,CAN_CHANNEL_NAME,1,Vehicle CAN] [META,CAN_CHANNEL_NAME,2,Engine CAN]

Updated Manual.

Version 1.32 - Built on 03 November 2008

UNTRACKED - Preprocessor expressions were not being correctly evaluated. e.g. #if (2 == 2) would not compile.

UNTRACKED - Added inline comment conditionals: e.g. ;[_IF,(OMEX != 2)][Fuel Mod,…] ;[_IFDEF,OMEX]… ;[_IFNDEF,OMEX]…

		These conditionals work up to the end of the whole comment - 
		if the expression evaluates to false, then the rest of the comment 
		is excluded from parsing.

Version 1.31 - Built on 07 October 2008

UNTRACKED - Implemented source code update of names, old names and categories from another template GIN. The GIN is supplied with the command line switch ‘-g[filename]’, filename being the path to the template GIN. The intention is to use the namesdb application to generate a gin file using appropriate categorization. You then use this GIN file as a parameter to the build of your GIN file. Ginmake will compile the GIN and then compare it with the modified GIN file. Places that were different will be updated in the source code at the end of the compile.
Once this is done, you should attempt a normal compile again to check that everything is OK. In some situations you may end up with duplicate names or undefined references, which for now will need to be updated manually. The task is at least not as onerous as manual categorization. It is recommended that you back-up your source code before doing this in case it goes wrong.

UNTRACKED - If a field had only a category or profile reference in it, then compilation would fail and the implicit writablilty of the item would not be assumed.

UNTRACKED - Emit an error if there are duplicated values in an option list.

Version 1.30 - Built on 11 August 2008

UNTRACKED - Detect when gemscom addressable space has been exceeded.

Version 1.29 - Built on 07 August 2008

UNTRACKED - Allow uppercase preprocessor directives.

Version 1.28 - Built on 14 July 2008

UNTRACKED - Fix crash when CHKLOC or CRCLOC is defined before a Region object has been created for the GIN file.

Version 1.27 - Built on 24 June 2008

UNTRACKED - Define WINVER for Windows98.

UNTRACKED - Regressed compiler to VS2005 so that executable still runs on Windows 98.

UNTRACKED - Added option in interactive mode to end the interactive session but still display name-check warnings.

UNTRACKED - Fixed incorrect warning types when checking database names in non-interactive mode.

Version 1.26 - Built on 23 June 2008

UNTRACKED - GIN file version updated to v3.22.

UNTRACKED - Allow items to be added to MAIN_PROFILE.

UNTRACKED - Added checking of names against the names database.

UNTRACKED - Added interactive shell for updating the database.

UNTRACKED - Implemented “categories” feature.

UNTRACKED - Allow -ve raw values for valid range and view range.

Version 1.25 - Built on 15 April 2008

UNTRACKED - Default value initializer using x_ and y_ was inserting values in row-major rather than column major ordering.

Version 1.24 - Built on 15 April 2008

UNTRACKED - Continuation characters (a ‘' char) are now only applied to preprocessor lines (i.e. those that begin with a ‘#’ character).

Version 1.23 - Built on 14 April 2008

UNTRACKED - Updated serialization routine for version3 serialize (new attributes were not being saved).

Version 1.22 - Built on 11 April 2008

UNTRACKED - Implemented function-like macros in the pre-processor.

UNTRACKED - Added VALUES tag for specifying default value initializers.

UNTRACKED - Added ATTRIBUTES for tagging types with metadata (e.g. ‘fuel’).

UNTRACKED - Added VALIDRANGE to enable validation of calibrations to ensure that specified objects have sensible values.

UNTRACKED - Added VIEWRANGE to enable an object to specify a default range for views such as table graphs and maps, assuming that the object only normally uses a small portion of its full raw range.

UNTRACKED - Made it an error to have a comm-code object that is not large enough to store a comm-code.

Version 1.21 - Built on 26 February 2008

UNTRACKED - Added new gin file version 3.19.

UNTRACKED - CRC checksum type is now stored correctly in the gin file.

UNTRACKED - Checksum reference size is now stored correctly for regions.

Version 1.20 - Built on 25 February 2008

UNTRACKED - Updated to use latest gemscom library.

UNTRACKED - Added support for GWv4 installation.

UNTRACKED - Added optional install versions specifier to -i command line switch.

UNTRACKED - Added new gin file version 3.18.

UNTRACKED - Added LOGGINGSIZE definition for 3.18 gins.

UNTRACKED - Store name of option lists in 3.18 gins.
i.e. [OPTLIST=Baudrate] will display as “Baudrate” in GWE2 as well as be used for name based lookup in Ginmake.

UNTRACKED - Updated documentation.

Version 1.19 - Built on 04 October 2007

UNTRACKED - Fixed a regression in the steps/start/offset field handling code. The initial evaluation of the field to replace preprocessor symbols and expressions was causing an error to be emitted for fields that contained valid option references.
The replacement is now attempted without emitting an error and subsequently checked to see if it could be an option name. Also fixes a pontential issue where bracketed expressions would not have been evaluated and immediately considered to be an option name.

UNTRACKED - Applied a couple of optimizations to field parsing code to reduce heap allocations and string processing. Refactored some duplicate code in this area.

UNTRACKED - Error for ’numeric base’ field was displaying the value in the ‘floating point’ field.

Version 1.18 - Built on 02 October 2007

UNTRACKED - Name was not being set on option lists (still not saved in gin file)

UNTRACKED - Use of uninitialised variables that could lead to silent exclusion of objects.

Version 1.17 - Built on 28 September 2007

UNTRACKED - Neglected to replace symbols in offset field of axes.

Version 1.16 - Built on 25 September 2007

UNTRACKED - Fix bug introduced in previous version where preprocessor symbols would not be correctly evaluated for map steps/start/offset fields.

Version 1.15 - Built on 17 September 2007

UNTRACKED - Fix issue with offset option fixup.

Version 1.14 - Built on 17 September 2007

UNTRACKED - Having option start/offset on the axis of a table or map did not set the object up as having ‘option steps’.

UNTRACKED - Steps option is now retreived from ‘steps’ field, not the parameter/table field.

UNTRACKED - Fixed false duplicate object warnings when ‘old names’ are used.

UNTRACKED - Removed requirement for option start/offset from having to be enclosed in brackets.

Version 1.13 - Built on 11 September 2007

UNTRACKED - Bracketed references were not removed correctly from field strings leading to erroneous definition errors.

        This means that it is possible to use the new-style option list
        references with multipliers.  i.e. option lists can be used on 
        masked values:
        
		;[OPTLIST=PullUpList,0,No Pullup,1,1k,2,100]
        ;[Pull up A1,,256 ol(PullUpList),,o,,,$3,]
		;[Pull up A2,,64 ol(PullUpList),,o,,,$C,]

Version 1.12 - Built on 07 September 2007

UNTRACKED - Rebuilt with updated gems + gemscom libraries. Appears to have fixed a bug causing an invalid address fixup with Lancer+8 v1.02 build.

UNTRACKED - Optimized comment parser slightly (reduced heap allocation frequency).

Version 1.11 - Built on 09 August 2007

UNTRACKED - chksm, chkloc and crcloc addresses were not being fixed up.

Version 1.10 - Built on 31 May 2007

UNTRACKED - Types that have a ‘real’ value in the offset field (preceeded with a ‘’ character were not being processed correctly (the ‘’ was not being trimmed from the string during parsing. This would mean that the conversion to a floating point number would fail).
The result is that the compiler raises an error indicating that the field contains an invalid expression.
Additionally the compiler would subsequently crash when checking aliases due to the object not being correctly constructed.

UNTRACKED - Fix crash when checking aliases if gin object not created by common type builder due to a failure in its construction.
Builders are now elided from all processes post-parsing to preempt any other issues.

UNTRACKED - Error message indicating that a map could not be found said that a table could not be found.

Version 1.09 - Built on 16 May 2007

UNTRACKED - Separate profiles with semicolon rather than pipe characters.

Version 1.08 - Built on 09 May 2007

UNTRACKED - Allow user to disable automatic alignment from the command line options.

Version 1.07 - Built on 08 May 2007

UNTRACKED - Fix file extension bug.

Version 1.06 - Built on 08 May 2007

UNTRACKED - Name based referencing for map modifiers was losing the last character.

UNTRACKED - Removed profiles from log maps.

UNTRACKED - Made it possible to have multiple profiles per object.

UNTRACKED - Reserve address 0x00000000 for ECU objects when NOT using the 13bit protocol.

		This address is reserved so that we don't get problems when using 
		addresses of parameters as the value of other objects.
		
		An example of this is when addresses are stored for logging purposes.

UNTRACKED - Support for ‘old names’ whereby names are separated by semicolons.

UNTRACKED - Support for ‘ignore in conversion’ feature

UNTRACKED - Add new warnings for aliased items

UNTRACKED - Add warning supression

UNTRACKED - Add ’treat warnings as errors’ feature

UNTRACKED - Add Generate file name feature for HTG2

UNTRACKED - Add Install Gin feature for HTG2

UNTRACKED - Add version list feature for HTG2

UNTRACKED - Fix issue with SDATA segment and AEM25

Version 1.05 - Built on 12 March 2007

UNTRACKED - Output warning for read only options.

UNTRACKED - ‘-o’ command line option could be set, but was bypassed from checking of arguments, so compile would not run.

UNTRACKED - Inclusion of files inherits parent file’s path (e.g. for GRH files the pathe of included files is relative to the GRH, rather than the current working directory.

UNTRACKED - Warn if PCTL, PACK or STAT1 are not defined.

Version 1.04 - Built on 19 February 2007

UNTRACKED - Fix issue whereby function tables would not be written into the gin.

Version 1.03 - Built on 30 November 2006

UNTRACKED - Boolean conversion from ‘y’ could silently fail.

UNTRACKED - Updated gems + gemscom libraries and addressed breaking changes.

UNTRACKED - Raw and real sites were round the wrong way in the function table builder.

UNTRACKED - Some preparations for storing all strings in Ansi/unicode format in new gin file types.

Version 1.02 - Built on 09 November 2006

UNTRACKED - For version 3 gin files, always set the logtbl to be a base size of a byte. This is because having its correct size breaks GWv3. An informational message is output to indicate that this has happened.

Version 1.01 - Built on 09 November 2006

UNTRACKED - ASM compilation was not advancing data location, leading to incorrect addresses

UNTRACKED - Option user scalars were not setting the flag to indicate that they use options for thier scalar and offset

UNTRACKED - Elements in data definitions were not being trimmed of whitespace at the ends of each string.

UNTRACKED - Data location was not being updated with the current segment offset when changing segments.

UNTRACKED - Modifier parameters were not being assigned the map index that they modify.

UNTRACKED - Added build errors for when REV_NAME and/or REV_VERSION are not defined.

UNTRACKED - Changed warning ID’s so that they are unique and do not conflict with compiler error id’s. This gives the opportunity for a flag to be made available that gets the compiler to treat warnings as errors.

UNTRACKED - Was not setting the Min value and Max value of items such as parameters. Note that in HTG, these values were being incorrectly set anyway as it was not taking into account the sign of the number. This shouldn’t have been a problem in practice, because these values are degenerate and are recalculated when the gin file is loaded.

UNTRACKED - Misleading warning message - if command line option -p and -q used together, a warning would be reported that options -q and -o were used. The warning now reports that -o OR -p were used with -q.

UNTRACKED - Suppress duplicate warning when a table has the same name as the parameter used as its axis. Since a table canot use itself as a table axis, the parameter is used and no warning is given.

UNTRACKED - Duplicates warning on axis parameters was giving incorrect line numbers.

Version 1.00 - Initial Version

Initial release