COM Based Transformer (ComXf)

This function transforms a Sender/Receiver communication using the serialization of COM Based Transformer. It takes the data element as input and outputs a uint8 array containing the serialized data.

This function deserializes a Sender/Receiver communication using the deserialization of COM Based Transformer. It takes the uint8 array containing the serialized data as input and outputs the original data element which will be passed to the Rte.

This service returns the version information of the called transformer module.

This service initializes the transformer for the further processing.

This service deinitializes the transformer.

This is the type of the data structure containing the initialization data for the transformer.

The COM Based transformer shall only be used as the top- most transformer (first) in a transformer chain.

The COM Based transformer defined in this document shall be used as a transformer if • the attribute protocol of the TransformationTechnology is set to COM- Based • and the attribute version of the TransformationTechnology is set to 1.0.0 • and the attribute transformerClass of the TransformationTechnology is set to serializer

The serialization is based on the Ecu configuration of the COM module and • the Software Components PortPrototype , • the dataElement list defined by the respective SenderReceiverInterface , • the SenderReceiverToSignalGroupMapping , • and the ISignalToIPduMapping for the SystemSignalGroup .

The COM Based Transformer shall only provide functions for transformers where the TransformationTechnology is referenced as the first ref- erence in the list of ordered references transformerChain from a DataTransfor- mation to a TransformationTechnology .

The function specified in [SWS_ComXf_00007] shall exist for the first reference in the list of ordered references transformerChain from a DataTransformation to a TransformationTechnology if the DataTransfor- mation is referenced by an ISignalGroup in the role comBasedSignalGroup- Transformation where the ISignalGroup references a SystemSignalGroup which is referenced by SenderReceiverToSignalGroupMapping .

The function specified in [SWS_ComXf_00007] shall serial- ize complex data elements of Sender/Receiver communication into a linear byte array representation using the COM Based Transformation.

The function specified in [SWS_ComXf_00010] shall exist for the first reference in the list of ordered references transformerChain from a DataTransformation to a TransformationTechnology if the DataTransfor- mation is referenced by an ISignalGroup in the role comBasedSignalGroup- Transformation where the ISignalGroup references a SystemSignalGroup which is referenced by SenderReceiverToSignalGroupMapping .

The function specified in [SWS_ComXf_00010] shall deserial- ize a linear byte array to primitive or complex data elements of Sender/Receiver com- munication using the COM Based Transformation.

To allow migration, the deserialization shall be able to accept larger array representations and ignore dataElements appended at the end of a previ- ously known parameter list.

The COM Based Transformer shall support all basic data types that are supported by the COM module in [SWS_Com_00675] except for UINT8_DYN .

The COM Based Transformer shall handle each dataEle- ment of the SenderReceiverInterface individually.

The COM Based Transformer does not support Client-Server communication.

The COM Based Transformer only supports composite data types (i.e. Signal Groups from COM).

The COM Based Transformer only supports fix sized data types.

The COM Based Transformer shall place the serialized data element into the data buffer at the bit position according to the configuration of the ISignalGroup in Com.

The COM Based Transformer shall handle each dataEle- ment of the SenderReceiverInterface like defined for the COM module [4] when the COM API Com_SendSignal (rep. Com_ReceiveSignal ) is called for a shadow signal.

The COM Based Transformer only supports signal groups which are byte aligned.

The COM Based Transformer shall support signal group where all group signals are mapped successively (possibly with gaps where positions in the signal group layout have no corresponding signal defined) to the IPdu.

The apiServicePrefix of the COM Based Transformer's EcuC shall be set to ComXf .

Type of error Related error code Error value Error code if any other API service, except Get VersionInfo, is called before the transformer module was initialized with Init or after a call to De Init. <MIP>_E_UNINIT 0x01 Type of error Related error code Error value Error code if an invalid configuration set was selected <MIP>_E_INIT_FAILED 0x02 API service called with wrong parameter <MIP>_E_PARAM 0x03 API service called with invalid pointer <MIP>_E_PARAM_POINTER 0x04

The COM Based Transformer is configured based on the COM module configuration [4].

The COM Based Transformer does not support external trig- ger communication.

The vendor specific module definition of the COM Based Transformer - based on the Xfrm configuration [2] - may be extended by the vendor to support the close interaction with the Com module [4].

The COM Based Transformer shall be configured to be post- Build when the configuration of the Com module [4] is postBuild for the respective ComSignalGroup s.

If ComXf_Inv_<transformerId> specified in [SWS_ComXf_00010] is called with buffer equal to NULL_PTR and buffer- Length equal to 0 , then the output buffer buffer shall not be changed and ComXf_Inv_<transformerId> shall return with E_NO_DATA .

If the signal layout of the signal group array representation contains gaps, those gaps shall be set during transmission to the value defined by the ComTxIPduUnusedAreasDefault of the respective ComTxIPdu that this signal group is mapped to.

Buffer reservation for further transformers The COM Based Transformer shall consider the header and/or trailer ISignal s defined in the ISignalGroup which are processed by further transformers.

doesn’t use a complete Software Component Description (VFB View) the "legacy" policy can be chosen. initValue ValueSpecification 0..1 aggr Optional definition of a ISignal’s initValue in case the System Description doesn’t use a complete Software Component Description (VFB View). This supports the inclusion of legacy system signals. This value can be used to configure the Signal’s "Init Value". If a full DataMapping exist for the SystemSignal this information may be available from a configured Sender ComSpec and ReceiverComSpec. In this case the initvalues in SenderComSpec and/or ReceiverComSpec override this optional value specification. Further restrictions apply from the RTE specification. ▽