DIO Driver (Dio)

Returns the value of the specified DIO channel.

Service to set a level of a channel.

Returns the level of all channels of that port.

Service to set a value of the port.

This Service reads a subset of the adjoining bits of a port.

Service to set a subset of the adjoining bits of a port to a specified level.

Service to get the version information of this module.

Service to flip (change from 1 to 0 or from 0 to 1) the level of a channel and return the level of the channel after flip.

Service to set the value of a given port with required mask.

Numeric ID of a DIO channel.

Numeric ID of a DIO port.

Type for the definition of a channel group, which consists of several adjoining channels within a port.

These are the possible levels a DIO channel can have (input or output)

If the µC owns ports of different port widths (e.g. 4, 8,16...Bit) Dio_ Port Level Type inherits the size of the larg est port.

I f development error detection is enabled , the services Dio_ReadChannel , Dio_WriteChannel and Dio_Flip Channel shall check the “Channel Id ” parameter to be valid within the current configuration. If the “Channel Id ” paramet er is invalid, the functions shall report the error code DIO_E_PARAM_INVALID_CHANNEL_ID to the DET.

I f development error detection is enabled , the functions Dio_ReadPort , Dio_WritePort and Dio_ Masked WritePort shall check the “Port Id ” parameter to be valid within the current configuration. If the “Port Id ” parameter is invalid, the functions shall report the error code DIO_E_PARAM_INVALID_PORT_ID to the DET.

I f development error detection is enabled , the functions Dio_ReadChannelGroup and Dio_WriteChannelGroup shall check the “ChannelGroupId Ptr ” parameter to be valid within the current configuration. If the “ChannelGroupId P tr ” parameter is invalid, the functions shall report the error code DIO_E_PARAM_INVALID_GROUP to the DET.

Module Header File Imported Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

Det _ Report Error Det.h Service to report development errors.

Invalid port requested. Related error code: DI O_E_PARAM_INVALID_PORT_ID Value: [hex]: 0x14

Invalid c hannel g roup requested. Related error code: DIO_E_PARAM_INVALID_GROUP Value: [hex]: 0x1F

API service called with a NULL pointer. Related error code: DIO_E_ PARAM_POINTER Value: [hex]: 0x20

[SWS_Dio_00189] Upstream requirements: SRS_BSW_00323 ⌈If DET is enabled for the DIO Driver module, the function Dio_GetVersionInfo shall raise DIO_E_PARAM_POINTER, if the argument is NULL pointer and return with- out any action.⌋

The Dio_MaskedWritePort function shall simultaneously set the levels of the selected output channels. Mask argument specifies which bits are selected: a bit value '0' means the corresponding channel is not selected, a bit value '1' means the corresponding channel is selected. Level argument s pecifies the physical levels: a bit value '0' sets the corresponding channel to physical STD_LOW , a bit value '1' sets the corresponding channel to physical STD_HIGH .

The Dio_MaskedWritePort function shall ensure that the functionality of the input channels of that port is not affected.

The Dio_MaskedWritePort function shall set the specified value for the channels in the specified port if the corresponding bit in Mask is '1'.

When the Dio_MaskedWritePort function is called, DIO Channels that are configured as input shall remain unchanged.

When writing a port which is smaller than the Dio_PortLevelType using the Dio_MaskedWritePort function (see [SWS_Dio_00103]), the function shall ignore the MSB.

The DIO module shall reject configurations with partition mappings which are not supported by the implementation .

The ECUC partitions referenced by DioPortEcucPartitionRef shall b e a subset of the ECUC partitions referenced by DioEcucPartitionRef.

The ECUC partitions referenced by DioChannelEcucPartitionRef shall be a subset of the ECUC partitions referenced by DioPortEcucPartitionRef.

If DioEcucPartitionRef references one or more ECUC partitions, DioPortEcucPartitionRef shall have a multiplicity of greater than zero and reference one or several of these ECUC partitions as well.

If DioEcucPartitionRef references one or more ECUC part itions, DioChannelEcucPartitionRef shall have a multiplicity of greater than zero and reference one or several of these ECUC partitions as well.

If DioPortEcucPartitionRef references one or more ECUC partitions, DioChannelGroupEcucPartitio nRef shall have a multiplicity of greater than zero and reference one or several of these ECUC partitions as well.

Type of error Related error code Error value Invalid channel requested DIO_ E_ PARAM_ INVALID_ CHANNEL_ ID 0x0A Invalid port requested DIO_ E_ PARAM_ INVALID_ PORT_ ID 0x14 Invalid channel group requested DIO_ E_ PARAM_ INVALID_ GROUP 0x1F API service called with a NULL pointer DIO_ E_ PARAM_ POINTER 0x20