MATLAB: Enumeration Code Generation with Embedded Coder (autosar.tlc)

autosarcode generationEmbedded Coderenumeration

Hello,

does anyone have a clue what causes the following error message and how I can overcome this problem? I have a Simulink model that uses the enumeration defined in "State_Car.m"

classdef State_Car < Simulink.IntEnumType
  enumeration
      PARKEN_BN_NIO(1)
      PARKEN_BN_IO(2)
      STANDFKT_KUNDE_NICHT_IM_FZG(3)
      WOHNEN(5)
      PRUEFEN_ANALYSE_DIAGNOSE(7)
      FAHRBEREITSCHAFT_HERSTELLEN(8)
      FAHREN(10)
      FAHRBEREITSCHAFT_BEENDEN(12)
      SIGNAl_UNBEFUELLT(15)
  end
end

The error message I get during build process is:

### Build procedure for model: 'swc_heat_2017b' aborted due to an error.

The header file of the enumerated type State_Car, should be set to Rte_Type.h. To fix this error, update the getHeaderFile method of the enumeration type to return Rte_Type.h

Best Answer

Hi Yu Zhao!

As per the AUTOSAR standard, all data types must have a definition generated in Rte_type.h. This is the reason for the error and it is not possible to use a different header when doing AUTOSAR code generation.

For data types used solely inside of a SWC (not in the definition of a port) you only need to specify the header file as Rte_type.h only if you want the data type to be exported as an IncludedDataTypeSet.

Here's a small example for the implementation of the getHeaderFile method:

classdef State_Car < Simulink.IntEnumType
      enumeration
          On(1)
          Off(2)
      end
      methods (Static = true)
          function retVal = getHeaderFile()
             retVal = 'Rte_Type.h';
          end
     end
  end

Have a great day!

~Lucas

Related Solutions

MATLAB: How to generate a custom header file for an enumerated class used in Simulink model by Simulink Coder 8.4 (R2013a)

Every enumerated class has four associated static methods, which it inherits from Simulink.IntEnumType. You can optionally override these static methods to customize the behavior of an enumerated type. The methods are:

getDefaultValue — Returns the default value of the enumerated data type.

getDescription — Returns a description of the enumerated data type.

— Specifies a file where the type is defined for generated code.

addClassNameToEnumNames — Specifies whether the class name becomes a prefix in code.

Ues "getHeaderFile" to prevent the declaration of an enumerated type from being embedded in the generated code, allowing you to provide the declaration in an external file, include the following method in the enumerated class's methods section:

function retVal = getHeaderFile()
     retVal = 'filename';
end

Following codes show how to define a Enumerated class that generate a header file called "BasicColors.h" after code generation:

classdef BasicColors < Simulink.IntEnumType
    enumeration
      Red(0)
      Yellow(1)
      Blue(2) 
    end
methods (Static = true)
      function retVal = getDefaultValue()
         retVal = BasicColors.Blue;
       end
       function retVal = getDataScope()
         retVal = 'Exported';
       end
       function retVal = getHeaderFile()
         retVal = 'BasicColors.h';
       end
    end
end

MATLAB: Is the definition for internal data types not generated in “Rte_Type.h” when using AUTOSAR

Root-cause of the issue:

The error in compilation is referring to an internal data type whose definition is not being generated in “Rte_type.h” (we define data types as internal when they are not used on any interfaces with the RTE).
It is not recommended for internal types to have “Rte_type.h” set as header file, because in the generated code, none of the RTE calls need to use the internal types (by definition).
Instead, having them in a header file corresponding locally to the specific SWC would provide a cleaner partition of the code.

The recommended workaround:

I see that you are defining the enumerated data types with Simulink.defineIntEnumType:
Currently, I see that the “HeaderFile” is set to “Rte_type.h”, but no setting for “DataScope” is provided when defining your enum types.
By default, according to the documentation, when having a HeaderFile but not a DataScope property, Simulink is expecting the type to be imported from “Rte_type.h”, and hence the error message.

Depending on your use case, there are two recommended approaches:

1. Top-down workflow:

In this case, you can either:
add a “HeaderFile” property with a header file that you choose, and “DataScope” set to “Exported” (this way this internal type’s definition will be generated in that specific header file), or
simply do no set any values for “HeaderFile” and “DataScope” properties. In this case, the type will be exported to “modelname_types.h”.

As an example of the two options using the enumerated data type that you showed above:

1. Selecting a HeaderFile and DataScope set to “Exported” (data type definition will be generated in “myheaderfile.h”):

Simulink.defineIntEnumType( 'myEnumType', ...
   {'a','b','c'}, ...
   [0 1 2], ...
   'DefaultValue', 'a', ...
   'StorageType', 'uint8', ...
   'HeaderFile', 'myheaderfile.h', ...
   'DataScope', 'Exported', ...
   'AddClassNameToEnumNames', true);

2. Not adding any HeaderFile or DataScope (data type definition by default generated in “modelname_types.h”):

Simulink.defineIntEnumType( 'myEnumType', ...
   {'a','b','c'}, ...
   [0 1 2], ...
   'DefaultValue', 'a', ...
   'StorageType', 'uint8', ...
   'AddClassNameToEnumNames', true);

2. Bottom-up workflow: (from MATLAB R2020b release)

If you are using Simulink as an AUTOSAR authoring tool and would require all data types to be defined in the generated code, you can use this capability from MATLAB R2020b release on.
With this new feature, you can export definitions of internal types, and for your particular use case, you can select the internal types to be exported to "Rte_type.h".
For this, you can choose "Rte_type.h" as HeaderFile, and set the DataScope property to "Exported", as follows:

Simulink.defineIntEnumType( 'myEnumType', ...
   {'a','b','c'}, ...
   [0 1 2], ...
   'DefaultValue', 'a', ...
   'StorageType', 'uint8', ...
   'HeaderFile', 'Rte_type.h', ...
   'DataScope', 'Exported', ...
   'AddClassNameToEnumNames', true);

This would make the definition for "myEnumType" to be generated in "Rte_type.h".

Best Answer

Related Solutions

MATLAB: How to generate a custom header file for an enumerated class used in Simulink model by Simulink Coder 8.4 (R2013a)

MATLAB: Is the definition for internal data types not generated in “Rte_Type.h” when using AUTOSAR

Related Question