AUTOSAR Classic Microcontroller Abstraction (MCAL)

Die Microcontroller Abstraction Layer (MCAL) enthält hardware-spezifische Treiber für interne Mikrocontroller-Peripherie (ADC-Wandler, PWM-Generatoren, Hardware-Watchdog) und entkoppelt obere BSW-Schichten von der Silizium-Plattform.

خريطة المواضيع

عرض التفاصيل

اختر عنصرًا من المخطط.

لا توجد بيانات عناصر لهذا الإصدار

Adc

Adc_DeInit دالة

Returns all ADC HW Units to a state comparable to their power on reset state.

void Adc_DeInit (void);

Adc_DisableGroupNotification دالة

Disables the notification mechanism for the requested ADC Channel group.

void Adc_DisableGroupNotification (Adc_GroupType Group);

Adc_DisableHardwareTrigger دالة

Disables the hardware trigger for the requested ADC Channel group.

void Adc_DisableHardwareTrigger (Adc_GroupType Group);

Adc_EnableGroupNotification دالة

Enables the notification mechanism for the requested ADC Channel group.

void Adc_EnableGroupNotification (Adc_GroupType Group);

Adc_EnableHardwareTrigger دالة

Enables the hardware trigger for the requested ADC Channel group.

void Adc_EnableHardwareTrigger (Adc_GroupType Group);

Adc_GetCurrentPowerState دالة

Service Adc_GetCurrentPowerState.

Std_ReturnType Adc_GetCurrentPowerState (Adc_PowerStateType* CurrentPowerState, Adc_PowerStateRequestResultType* Result);

Adc_GetGroupStatus دالة

Returns the conversion status of the requested ADC Channel group.

Adc_StatusType Adc_GetGroupStatus (Adc_GroupType Group);

Adc_GetStreamLastPointer دالة

Returns the number of valid samples per channel, stored in the result buffer. Reads a pointer, pointing to a position in the group result buffer. With the pointer position, the results of all group channels of the last completed conversion round can be acc essed. With the pointer and the return value, all valid group conversion results can be accessed (the user has to take the layout of the result buffer into account).

Adc_StreamNumSampleType Adc_GetStreamLastPointer (Adc_GroupType Group, Adc_ValueGroupType* * PtrToSamplePtr);

Adc_GetTargetPowerState دالة

Service Adc_GetTargetPowerState.

Std_ReturnType Adc_GetTargetPowerState (Adc_PowerStateType* TargetPowerState, Adc_PowerStateRequestResultType* Result);

Adc_GetVersionInfo دالة

Returns the version information of this module.

void Adc_GetVersionInfo (Std_VersionInfoType* versioninfo);

Adc_Init دالة

Initializes the ADC hardware units and driver.

void Adc_Init (const Adc_ConfigType* ConfigPtr);

Adc_Main_PowerTransitionManager دالة

This API is cyclically called and supervises the power state transitions, checking for the readiness of the module and issuing the callbacks Io Hw Ab_ Adc_ Notify Ready For Power State (see Adc Power State Ready Cb k Ref configuration parameter).

void Adc_Main_PowerTransitionManager (void);

Adc_PreparePowerState دالة

This API starts the needed process to allow the ADC HW module to enter the AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver requested power state.

Std_ReturnType Adc_PreparePowerState (Adc_PowerStateType PowerState, Adc_PowerStateRequestResultType* Result);

Adc_ReadGroup دالة

Reads the group conversion result of the last completed conversion round of the requested group and stores the channe l values starting at the Data Buffer Ptr address. The group channel values are stored in ascending channel number order ( in contrast to the storage layout of the result buffer if streaming access is configured).

Std_ReturnType Adc_ReadGroup (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);

Adc_SetPowerState دالة

This API configures the Adc module so that it enters the already prepared power state, chosen between a predefined set of configured ones.

Std_ReturnType Adc_SetPowerState (Adc_PowerStateRequestResultType* Result);

Adc_SetupResultBuffer دالة

Initializes ADC driver with the group specific result buffer start address where the conversion results will be stored. The applicatio n has to ensure that the application buffer, where Data Buffer Ptr points to, can hold all the conversion results of the specified group. The initialization with Adc_ Setup Result Buffer is required after reset, before a group conversion can be started.

Std_ReturnType Adc_SetupResultBuffer (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);

Adc_StartGroupConversion دالة

Starts the conversion of all channels of the requested ADC Channel group.

void Adc_StartGroupConversion (Adc_GroupType Group);

Adc_StopGroupConversion دالة

Stops the conversion of the requested ADC Channel group.

void Adc_StopGroupConversion (Adc_GroupType Group);

IoHwAb_Adc_NotifyReadyForPowerState دالة

The API shall be invoked by the ADC Driver when the requested power state preparation for mode <#Mode> is completed.

void IoHwAb_Adc_NotifyReadyForPowerState<#Mode> (void);

Adc_Channel نوع

In case of active limit checking: defines which conversion values are taken into account related to the boardes defineed with Adc Channel Low Limit and Adc Channel High Limit.

Adc_ChannelType نوع

Numeric ID of an ADC channel.

Adc_ConfigType نوع

Data structure containing the set of configuration parameters required for initializing the ADC Driver and ADC HW Unit(s).

Adc_ConversionTimeType نوع

Type of conversion time, i.e. the time during which the sampled analogue value is converted into digital representation. (This is not an API type).

Adc_GroupAccessModeType نوع

Type for configuring the access mode to group conversion results.

Adc_GroupConvModeType نوع

Type for configuring the conversion mode of an ADC Channel group. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver

Adc_GroupDefType نوع

Type for assignment of channels to a channel group (this is not an API type).

Adc_GroupPriorityType نوع

Priority level of the channel. Lowest priority is 0.

Adc_GroupReplacementType نوع

Replacement mechanism, which is used on ADC group level, if a group conversion is interrupted by a group which has a higher priority.

Adc_GroupType نوع

Numeric ID of an ADC channel group.

Adc_HwTriggerSignalType نوع

Type for configuring on which edge of the hardware trigger signal the driver should react, i.e. start the conversion (only if supported by the ADC hardware).

Adc_HwTriggerTimerType نوع

Type for the reload value of the ADC module embedded timer (only if supported by the ADC hardware).

Adc_PowerStateRequestResultType نوع

Type Adc_PowerStateRequestResultType.

Adc_PowerStateType نوع

Power state currently active or set as target power state.

Adc_PrescaleType نوع

Type of clock prescaler factor. (This is not an API type).

Adc_PriorityImplementationType نوع

Type for configuring the prioritization mechanism.

Adc_ResolutionType نوع

Type of channel resolution in number of bits. (This is not an API type).

Adc_ResultAlignmentType نوع

Type for alignment of ADC raw results in ADC result buffer (left/ right alignment).

Adc_SamplingTimeType نوع

Type of sampling time, i.e. the time during which the value is sampled, (in clock - cycles). (This is not an API type).

Adc_StatusType نوع

Current status of the conversion of the requested ADC Channel group.

Adc_StreamBufferModeType نوع

Type for configuring the streaming access mode buffer type.

Adc_StreamNumSampleType نوع

Type for configuring the number of group conversions in streaming access mode (in single access mode, parameter is 1). Available Adc.h AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver via

Adc_TriggerSourceType نوع

Type for configuring the trigger source for an ADC Channel group.

Adc_ValueGroupType نوع

Type for reading the converted values of a channel group (raw, without further scaling, alignment according precompile switch ADC_ RESULT_ ALIGNMENT).

CorTst

CorTst_Abort دالة

Service to change from CORTST_ INIT to CORTST_ ABORT state

void CorTst_Abort(void);

CorTst_DeInit دالة

Service to change from CORTST_ ABORT or CORTST_ INIT to CORTST_ UNINIT state

void CorTst_DeInit(void);

CorTst_GetCurrentStatus دالة

Service for Core Test to get indicator of the last executed Core Test result

void CorTst_GetCurrentStatus(CorTst_ErrOkType* ErrOk);

CorTst_GetVersionInfo دالة

Service returns the version information of this module.

void CorTst_GetVersionInfo(Std_VersionInfoType* versioninfo);

CorTst_Init دالة

Service for initialization and change of state of the Core Test

void CorTst_Init(const CorTst_ConfigType* ConfigPtr);

CorTst_MainFunction دالة

Cyclically called by scheduler to perform processing of Core Test.

void CorTst_MainFunction(void);

CorTst_Start دالة

Service for executing foreground Core Test.

Std_ReturnType CorTst_Start(CorTst_TestIdFgndType TestId);

CorTst_TestCompletedNotification دالة

The function Cor Tst_ Test Completed Notification shall be called every time when a complete test cycle has been executed.

void CorTst_TestCompletedNotification(CorTst_ErrOkType ResultOfLastCorTstRun);

Tst_CsumSignatureBgndTypeCorTst_GetSignature دالة

Service to get signature of the last executed Core Test in background mode.

CorTst_CsumSignatureBgndType CorTst_GetSignature(void);

Tst_CsumSignatureTypeCorTst_GetFgndSignature دالة

Service to get signature of the last executed Core Test in foreground mode.

CorTst_CsumSignatureType CorTst_GetFgndSignature(void);

Tst_StateTypeCorTst_GetState دالة

Service for Core Test to immediately return status on currently executed Core Test.

CorTst_StateType CorTst_GetState(void);

CorTst_ConfigType نوع

Configuration data structure of the Cor Tst module.

CorTst_CsumSignatureBgndType نوع

Type for test signature in background mode

CorTst_CsumSignatureType نوع

This is the type of the Core Test return value if a checksum/ signature is returned from API to the caller of the API.

CorTst_ErrOkType نوع

This is the type of the Core Test test retu rn if a status is retuned from API to the caller of the API.

CorTst_ResultType نوع

This is the type of the Core Test test return if a status is retuned from API to the caller of the API.

CorTst_StateType نوع

This is a status value returned by the API Cor Tst_ Get State().

CorTst_TestIdFgndType نوع

This is the type of the parameter (Id) used for a specific foreground test configuration to run. (The Id shall be used in the call to the API Cor Tst_ Start(Cor Tst_ Test Id Fgnd Type Test Id)).

Dio

Dio_FlipChannel دالة

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.

Dio_LevelType Dio_FlipChannel(Dio_ChannelType ChannelId);

Dio_GetVersionInfo دالة

Service to get the version information of this module.

void Dio_GetVersionInfo(Std_VersionInfoType* VersionInfo);

Dio_MaskedWritePort دالة

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

void Dio_MaskedWritePort(Dio_PortType PortId, Dio_PortLevelType Level, Dio_PortLevelType Mask);

Dio_ReadChannel دالة

Returns the value of the specified DIO channel.

Dio_LevelType Dio_ReadChannel(Dio_ChannelType ChannelId);

Dio_WriteChannel دالة

Service to set a level of a channel.

void Dio_WriteChannel(Dio_ChannelType ChannelId, Dio_LevelType Level);

Dio_WriteChannelGroup دالة

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

void Dio_WriteChannelGroup(const Dio_ChannelGroupType* ChannelGroupIdPtr, Dio_PortLevelType Level);

Dio_WritePort دالة

Service to set a value of the port.

void Dio_WritePort(Dio_PortType PortId, Dio_PortLevelType Level);

LevelTypeDio_ReadChannelGroup دالة

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

Dio_PortLevelType Dio_ReadChannelGroup(const Dio_ChannelGroupType* ChannelGroupIdPtr);

LevelTypeDio_ReadPort دالة

Returns the level of all channels of that port.

Dio_PortLevelType Dio_ReadPort(Dio_PortType PortId);

Dio_ChannelGroupType نوع

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

Dio_ChannelType نوع

Numeric ID of a DIO channel.

Dio_LevelType نوع

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

Dio_PortLevelType نوع

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.

Dio_PortType نوع

Numeric ID of a DIO port.

Gpt

Gpt_CheckWakeup دالة

Checks if a wakeup capable GPT channel is the source for a wakeup event and calls the ECU state manager service Ecu M_ Set Wakeup Event in case of a valid GPT channel wakeup event.

void Gpt_CheckWakeup(EcuM_WakeupSourceType WakeupSource);

Gpt_DeInit دالة

Deinitializes the GPT driver.

void Gpt_DeInit(void);

Gpt_DisableNotification دالة

Disables the interrupt notification for a channel (relevant in normal mode).

void Gpt_DisableNotification(Gpt_ChannelType Channel);

Gpt_DisableWakeup دالة

Disables the wakeup interrupt of a channel (relevant in sleep mode).

void Gpt_DisableWakeup(Gpt_ChannelType Channel);

Gpt_EnableNotification دالة

Enables the interrupt notification for a channel (relevant in normal mode).

void Gpt_EnableNotification(Gpt_ChannelType Channel);

Gpt_EnableWakeup دالة

Enables the wakeup interrupt of a channel (relevant in sleep mode).

void Gpt_EnableWakeup(Gpt_ChannelType Channel);

Gpt_GetPredefTimerValue دالة

Delivers the current value of the desired GPT Predef Timer.

Std_ReturnType Gpt_GetPredefTimerValue(Gpt_PredefTimerType PredefTimer, uint32* TimeValuePtr);

Gpt_GetTimeElapsed دالة

Returns the time already elapsed.

Gpt_ValueType Gpt_GetTimeElapsed(Gpt_ChannelType Channel);

Gpt_GetTimeRemaining دالة

Returns the time remaining until the target time is reached.

Gpt_ValueType Gpt_GetTimeRemaining(Gpt_ChannelType Channel);

Gpt_GetVersionInfo دالة

Returns the version information of this module.

void Gpt_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr);

Gpt_Init دالة

Initializes the GPT driver.

void Gpt_Init(const Gpt_ConfigType* ConfigPtr);

Gpt_Notification_channel دالة

void Gpt_Notification_<channel>(void);

Gpt_SetMode دالة

Sets the operation mode of the GPT.

void Gpt_SetMode(Gpt_ModeType Mode);

Gpt_StartTimer دالة

Starts a timer channel.

void Gpt_StartTimer(Gpt_ChannelType Channel, Gpt_ValueType Value);

Gpt_StopTimer دالة

Stops a timer channel.

void Gpt_StopTimer(Gpt_ChannelType Channel);

Gpt_ChannelType نوع

Numeric ID of a GPT channel.

Gpt_ConfigType نوع

This is the type of the data structure including the configuration set required for initializing the GPT timer unit.

Gpt_ModeType نوع

Modes of the GPT driver.

Gpt_PredefTimerType نوع

Type for GPT Predef Timers

Gpt_ValueType نوع

Type for reading and setting the timer values (in number of ticks).

Icu

Icu_CheckWakeup دالة

Checks if a wakeup capable ICU channel is the source for a wakeup event and calls the ECU state manager service Ecu M_ Set Wakeup Event in case of a valid ICU channel wakeup event.

void Icu_CheckWakeup(EcuM_WakeupSourceType WakeupSource);

Icu_DeInit دالة

This function de - initializes the ICU module.

void Icu_DeInit(void);

Icu_DisableEdgeCount دالة

This function disables the counting of edges of the given channel.

void Icu_DisableEdgeCount(Icu_ChannelType Channel);

Icu_DisableEdgeDetection دالة

This function disables the detection of edges of the given channel.

void Icu_DisableEdgeDetection(Icu_ChannelType Channel);

Icu_DisableNotification دالة

This function disables the notification of a channel.

void Icu_DisableNotification(Icu_ChannelType Channel);

Icu_DisableNotificationAsync دالة

This function disables the notification of a channel.

void Icu_DisableNotificationAsync(Icu_ChannelType Channel);

Icu_DisableWakeup دالة

This function disables the wakeup capability of a single ICU channel.

void Icu_DisableWakeup(Icu_ChannelType Channel);

Icu_EnableEdgeCount دالة

This function enables the counting of edges of the given channel.

void Icu_EnableEdgeCount(Icu_ChannelType Channel);

Icu_EnableEdgeDetection دالة

This function enables / re - enables the detection of edges of the given channel.

void Icu_EnableEdgeDetection(Icu_ChannelType Channel);

Icu_EnableNotification دالة

This function enables the notification on the given channel.

void Icu_EnableNotification(Icu_ChannelType Channel);

Icu_EnableNotificationAsync دالة

This function enables the notification on the given channel.

void Icu_EnableNotificationAsync(Icu_ChannelType Channel);

Icu_EnableWakeup دالة

This function (re - )enables the wakeup capability of the given ICU channel.

void Icu_EnableWakeup(Icu_ChannelType Channel);

Icu_GetDutyCycleValues دالة

This function reads the coherent active time and period time for the given ICU Channel.

void Icu_GetDutyCycleValues(Icu_ChannelType Channel, Icu_DutyCycleType* DutyCycleValues);

Icu_GetInputState دالة

This function returns the status of the ICU input.

Icu_InputStateType Icu_GetInputState(Icu_ChannelType Channel);

Icu_GetTimeElapsed دالة

Description This function reads the elapsed Signal Low Time for the given channel.

Icu_ValueType Icu_GetTimeElapsed(Icu_ChannelType Channel);

Icu_GetTimestampIndex دالة

This function reads the timestamp index of the given channel.

Icu_IndexType Icu_GetTimestampIndex(Icu_ChannelType Channel);

Icu_GetVersionInfo دالة

This function returns the version information of this module.

void Icu_GetVersionInfo(Std_VersionInfoType* versioninfo);

Icu_Init دالة

This function initializes the driver.

void Icu_Init(const Icu_ConfigType* ConfigPtr);

Icu_ResetEdgeCount دالة

This function resets the value of the counted edges to zero.

void Icu_ResetEdgeCount(Icu_ChannelType Channel);

Icu_SetActivationCondition دالة

This function sets the activation - edge for the given channel.

void Icu_SetActivationCondition(Icu_ChannelType Channel, Icu_ActivationType Activation);

Icu_SetMode دالة

This function sets the ICU mode.

void Icu_SetMode(Icu_ModeType Mode);

Icu_SignalNotification_Channel دالة

According to the last call of Icu_ Enable Notification, this notification function to be called if the requested signal edge (rising / falling / both edges) occurs (once per edge).

void Icu_SignalNotification_<Channel>(void);

Icu_StartSignalMeasurement دالة

This function starts the measurement of signals.

void Icu_StartSignalMeasurement(Icu_ChannelType Channel);

Icu_StartTimestamp دالة

This function starts the capturing of timer values on the edges.

void Icu_StartTimestamp(Icu_ChannelType Channel, Icu_ValueType* BufferPtr, uint16 BufferSize, uint16 NotifyInterval);

Icu_StopSignalMeasurement دالة

This function stops the measurement of signals of the given channel.

void Icu_StopSignalMeasurement(Icu_ChannelType Channel);

Icu_StopTimestamp دالة

This function stops the timestamp measurement of the given channel.

void Icu_StopTimestamp(Icu_ChannelType Channel);

Icu_TimestampNotification_Channel دالة

This notification to be called if the number of requested timestamps (Notification interval > 0) are acquired and if the notification has been enabled by the call of Icu_ Enable Notification().

void Icu_TimestampNotification_<Channel>(void);

NumberTypeIcu_GetEdgeNumbers دالة

This function reads the number of counted edges.

Icu_EdgeNumberType Icu_GetEdgeNumbers(Icu_ChannelType Channel);

Icu_ActivationType نوع

Definition of the type of activation of an ICU channel.

Icu_ChannelType نوع

Numeric identifier of an ICU channel Avail able via Icu.h

Icu_ConfigType نوع

This type contains initialization data.

Icu_DutyCycleType نوع

Type which shall contain the values, needed for calculating duty cycles.

Icu_EdgeNumberType نوع

Type, to abstract the return value of the service Icu_ Get Edge Numbers().

Icu_IndexType نوع

Type, to abstract the return value of the service Icu_ Get Timestamp Index().Since circular buffer handling is supported and Icu_ Get Timestamp Index can return '0' as a legally true value ( not as an error according to ICU107 and ICU135), Icu_ Index Type may be implemented to have values 1..xyz.

Icu_InputStateType نوع

Input state of an ICU channel

Icu_MeasurementModeType نوع

Definition of the measurement mode type

Icu_ModeType نوع

Allow enabling / disabling of all interrupts which are not required for the ECU wakeup.

Icu_SignalMeasurementPropertyType نوع

Def inition of the measurement property type

Icu_TimestampBufferType نوع

Definition of the timestamp measurement property type

Icu_ValueType نوع

Width of the buffer for timestamp ticks and measured elapsed timeticks.

IoHwAb

<#group ID> دالة

Will be called by the ADC Driver when a group conversion is completed for group <#group ID>.

void IoHwAb_AdcNotification<#group ID>(void);

<Ecu Signal Name> دالة

This function provides control access to a certain ECU Signal t o the DCM module (<Ecu Signalname> is the symbolic name of an ECU Signal). The ECU signal can be locked and unlocked by this function. Locking 'freezes' the ECU signal to the current value, the configured default value or a value given by the parameter 'si gnal'.

void IoHwAb_Dcm_<Ecu Signal Name>(uint8 action, <Ecu Signal DataType> signal);

<Ecu Signal Name>#2 دالة

This function provides read access to a certain ECU Signal to the DCM module (<Ecu Signalname> is the symbolic name of an ECU Signal).

void IoHwAb_Dcm_Read<Ecu Signal Name>(<Ecu Signal DataType>* signal);

IoHwAb_Adc_NotifyReadyForPowerState#Mode دالة

The API shall be invoked by the ADC Driver when the requested power state preparation for mode <#Mode> is completed.

void IoHwAb_Adc_NotifyReadyForPowerState<#Mode>(void);

IoHwAb_EnterPowerState#Mode دالة

The API shall be invoked by the Io Hw Abs in order to effectively enter a power state which was prepared by the API Io Hw Ab_ Prepare Power State<#Mode> () . The aim of this API is to incapsulate all actions to set the HW in a power state corresponding to a predefined power mode, decoupling application power definition from HW power states.

void IoHwAb_EnterPowerState<#Mode>(void);

IoHwAb_GetVersionInfo دالة

Returns the version information of this module.

void IoHwAb_GetVersionInfo(Std_VersionInfoType* versioninfo);

IoHwAb_GptNotification#channel دالة

Will be called by the GPT driver when a timer value expires on channel <#channel>.

void IoHwAb_GptNotification<#channel>(void);

IoHwAb_IcuNotification#channel دالة

Will be called by the ICU driver when a signal edge occurs on channel <#channel>.

void IoHwAb_IcuNotification<#channel>(void);

IoHwAb_InitInit_Id دالة

Initializes either all the IO Hardware Abstraction software or is a part of the IO Hardware Abstraction.

void IoHwAb_Init<Init_Id>(const IoHwAb{Init_Id}_ConfigType* ConfigPtr);

IoHwAb_OcuNotification#channel دالة

Will be called by the OCU driver when the current value of the threshold matches the threshold on the channel<#channel>.

void IoHwAb_OcuNotification<#channel>(void);

IoHwAb_PreparePowerState#Mode دالة

The API shall be invoked by the Io Hw Abs in order to prepare the transition to a given power state. The aim of this API is to incapsulate all actions to prepare the HW for a predefined power mode, decoupling application power definition from HW power stat es.

void IoHwAb_PreparePowerState<#Mode>(void);

IoHwAb_Pwm_NotifyReadyForPowerState#Mode دالة

The API shall be invoked by the PWM Driver when the requested power state preparation for mode <#Mode> is completed.

void IoHwAb_Pwm_NotifyReadyForPowerState<#Mode>(void);

IoHwAb_PwmNotification#channel دالة

Will be called by the PWM Driver when a signal edge occurs on channel <#channel>.

void IoHwAb_PwmNotification<#channel>(void);

IoHwAb{Init_Id}_ConfigType نوع

Configuration data structure of the Io Hw Ab module.

Mcu

Mcu_DistributePllClock دالة

This service activates the PLL clock to the MCU clock distribution.

Std_ReturnType Mcu_DistributePllClock(void);

Mcu_GetRamState دالة

This service provides the actual status of the microcontroller Ram. (if supported)

Mcu_RamStateType Mcu_GetRamState(void);

Mcu_GetResetReason دالة

The service reads the reset type from the hardware, if supported.

Mcu_ResetType Mcu_GetResetReason(void);

Mcu_GetVersionInfo دالة

This service returns the version information of this module.

void Mcu_GetVersionInfo(Std_VersionInfoType* versioninfo);

Mcu_Init دالة

This service initializes the MCU driver.

void Mcu_Init(const Mcu_ConfigType* ConfigPtr);

Mcu_InitClock دالة

This service initializes the PLL and other MCU specific clock options.

Std_ReturnType Mcu_InitClock(Mcu_ClockType ClockSetting);

Mcu_InitRamSection دالة

This service initializes the RAM section wise.

Std_ReturnType Mcu_InitRamSection(Mcu_RamSectionType RamSection);

Mcu_PerformReset دالة

The service performs a microcontroller reset.

void Mcu_PerformReset(void);

Mcu_SetMode دالة

This service activates the MCU power modes.

void Mcu_SetMode(Mcu_ModeType McuMode);

ResetTypeMcu_GetResetRawValue دالة

The service reads the reset type from the hardware register, if supported.

Mcu_RawResetType Mcu_GetResetRawValue(void);

StatusTypeMcu_GetPllStatus دالة

This service provides the lock status of the PLL.

Mcu_PllStatusType Mcu_GetPllStatus(void);

Mcu_ClockType نوع

Specifies the identification (ID) for a clock setting, which is configured in the configuration structure

Mcu_ConfigType نوع

A pointer to such a structure is provided to the MCU initialization routines for configuration.

Mcu_ModeType نوع

Name Mcu_ Mode Type Kind Type Derived from uint Range 0..<number of MCU modes> - 1 -- The range is dependent on the number of MCU modes provided in the configuration structure. The type shall be chosen depending on MCU platform for best performance. Des cription This type specifies the identification (ID) for a MCU mode, which is configured in the configuration structure. Available via Mcu.h

Mcu_PllStatusType نوع

This is a status value returned by the function Mcu_ Get Pll Status of the MCU module.

Mcu_RamSectionType نوع

This type specifies the identification (ID) for a RAM section, which is conf igured in the configuration structure.

Mcu_RamStateType نوع

This is the Ram State data type returned by the function Mcu_ Get Ram State of the Mcu module. It is not required that all RAM state types are supported by the hardware.

Mcu_RawResetType نوع

This type specifies the reset reason in raw register format read from a reset status register.

Mcu_ResetType نوع

This is the type of the reset enumerator containing the subset of reset types. It is not required that all reset types are supported by hardware.

Ocu

Ocu_DeInit دالة

This function de - initializes the OCU module.

void Ocu_DeInit(void);

Ocu_DisableNotification دالة

This service is used to disable notifications from an OCU channel.

void Ocu_DisableNotification(Ocu_ChannelType ChannelNumber);

Ocu_EnableNotification دالة

This service is used to enable notifications from an OCU channel.

void Ocu_EnableNotification(Ocu_ChannelType ChannelNumber);

Ocu_GetCounter دالة

Service to read the current value of the counter.

Ocu_ValueType Ocu_GetCounter(Ocu_ChannelType ChannelNumber);

Ocu_GetVersionInfo دالة

This service returns the version information of this module.

void Ocu_GetVersionInfo(Std_VersionInfoType* versioninfo);

Ocu_Init دالة

Service for OCU initialization.

void Ocu_Init(const Ocu_ConfigType* ConfigPtr);

Ocu_Notification_Channel دالة

This notification function is called when a compare match occurs on the associated channel.

void Ocu_Notification_<Channel>(void);

Ocu_SetAbsoluteThreshold دالة

Service to set the value of the channel threshold using an absolute input data.

Ocu_ReturnType Ocu_SetAbsoluteThreshold(Ocu_ChannelType ChannelNumber, Ocu_ValueType ReferenceValue, Ocu_ValueType AbsoluteValue);

Ocu_SetPinAction دالة

Service to indicate the driver what shall be done automatically by hardware (if supported) upon compare match.

void Ocu_SetPinAction(Ocu_ChannelType ChannelNumber, Ocu_PinActionType PinAction);

Ocu_SetPinState دالة

Service to set immediately the level of the pin associated to an OCU channel.

void Ocu_SetPinState(Ocu_ChannelType ChannelNumber, Ocu_PinStateType PinState);

Ocu_SetRelativeThreshold دالة

Service to set the value of the channel threshold relative to the current value of the counter.

Ocu_ReturnType Ocu_SetRelativeThreshold(Ocu_ChannelType ChannelNumber, Ocu_ValueType RelativeValue);

Ocu_StartChannel دالة

Service to start an OCU channel.

Std_ReturnType Ocu_StartChannel(Ocu_ChannelType ChannelNumber);

Ocu_StopChannel دالة

Service to stop an OCU channel.

void Ocu_StopChannel(Ocu_ChannelType ChannelNumber);

Ocu_ChannelType نوع

Numeric identifier of an OCU channel.

Ocu_ConfigType نوع

This is the type of the data structure containing the initialization data for the OCU driver.

Ocu_PinActionType نوع

Automatic action (by hardware) to be performed on a pin attached to an OCU channel. A vailable via Ocu.h

Ocu_PinStateType نوع

Output state of the pin linked to an OCU channel.

Ocu_ReturnType نوع

Return information after setting a new threshold value.

Ocu_ValueType نوع

Type for reading the counter and writing the threshold values (in number of ticks).

Port

Port_GetVersionInfo دالة

Returns the version information of this module.

void Port_GetVersionInfo(Std_VersionInfoType* versioninfo);

Port_Init دالة

Initializes the Port Driver module.

void Port_Init(const Port_ConfigType* ConfigPtr);

Port_RefreshPortDirection دالة

Refreshes port direction.

void Port_RefreshPortDirection(void);

Port_SetPinDirection دالة

Sets the port pin direction

void Port_SetPinDirection(Port_PinType Pin, Port_PinDirectionType Direction);

Port_SetPinMode دالة

Sets the port pin mode.

void Port_SetPinMode(Port_PinType Pin, Port_PinModeType Mode);

Port_ConfigType نوع

Type of the external data structure containing the initialization data for this module.

Port_PinDirectionType نوع

Possible directions of a port pin.

Port_PinModeType نوع

Different port pin modes.

Port_PinType نوع

Data type for the symbolic name of a port pin.

Pwm

IoHwAb_Pwm_NotifyReadyForPowerState دالة

The API shall be invoked by the PWM Driver when the requested power state preparation for mode <#Mode> is completed.

void IoHwAb_Pwm_NotifyReadyForPowerState<#Mode> (void);

Pwm_DeInit دالة

Service for PWM De - Initialization.

void Pwm_DeInit (void);

Pwm_DisableNotification دالة

Service to disable the PWM signal edge notification.

void Pwm_DisableNotification (Pwm_ChannelType ChannelNumber);

Pwm_EnableNotification دالة

Service to enable the PWM signal edge notification according to notification pa rameter.

void Pwm_EnableNotification (Pwm_ChannelType ChannelNumber, Pwm_EdgeNotificationType Notification);

Pwm_GetCurrentPowerState دالة

This API returns the current power state of the PWM HW unit. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_PWMDriver

Std_ReturnType Pwm_GetCurrentPowerState (Pwm_PowerStateType* CurrentPowerState, Pwm_PowerStateRequestResultType* Result);

Pwm_GetOutputState دالة

Service to read the internal state of the PWM out put signal.

Pwm_OutputStateType Pwm_GetOutputState (Pwm_ChannelType ChannelNumber);

Pwm_GetTargetPowerState دالة

This API returns the Target power state of the PWM HW unit.

Std_ReturnType Pwm_GetTargetPowerState (Pwm_PowerStateType* TargetPowerState, Pwm_PowerStateRequestResultType* Result);

Pwm_GetVersionInfo دالة

Service returns the version information of this module.

void Pwm_GetVersionInfo (Std_VersionInfoType* versioninfo);

Pwm_Init دالة

Service for PWM initialization.

void Pwm_Init (const Pwm_ConfigType* ConfigPtr);

Pwm_Main_PowerTransitionManager دالة

This API is cyclically called and supervises the power state transitions, checking for the readiness of the module and issuing the callbacks Io Hw Ab_ Pwm_ Notify Ready For Power State (see Pwm Power State Ready Cb k Ref configuration parameter). AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_PWMDriver

void Pwm_Main_PowerTransitionManager (void);

Pwm_Notification_ دالة

The Pwm module shall call the function Pwm_ Notification_<#Channel> accordingly to the last call of Pwm_ Enable Notification for channel <#Channel>.

void Pwm_Notification_<#Channel> (void);

Pwm_PreparePowerState دالة

This API starts the needed process to allow the PWM HW module to enter the requested power state. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_PWMDriver

Std_ReturnType Pwm_PreparePowerState (Pwm_PowerStateType PowerState, Pwm_PowerStateRequestResultType* Result);

Pwm_SetDutyCycle دالة

Service sets the duty cycle of the PWM channel.

void Pwm_SetDutyCycle (Pwm_ChannelType ChannelNumber, uint16 DutyCycle);

Pwm_SetOutputToIdle دالة

Service sets the PWM output to the configured Idle state.

void Pwm_SetOutputToIdle (Pwm_ChannelType ChannelNumber);

Pwm_SetPeriodAndDuty دالة

Service sets the period and the duty cycle of a PWM channel

void Pwm_SetPeriodAndDuty (Pwm_ChannelType ChannelNumber, Pwm_PeriodType Period, uint16 DutyCycle);

Pwm_SetPowerState دالة

This API configures the Pwm module so that it enters the already prepared power st ate, chosen between a predefined set of configured ones.

Std_ReturnType Pwm_SetPowerState (Pwm_PowerStateRequestResultType* Result);

Pwm_ChannelClassType نوع

Defines the class of a PWM channel

Pwm_ChannelType نوع

Nume ric identifier of a PWM channel.

Pwm_ConfigType نوع

This is the type of data structure containing the initialization data for the PWM driver.

Pwm_EdgeNotificationType نوع

Definition of the type of edge notification of a PWM channel.

Pwm_OutputStateType نوع

Output state of a PWM channel.

Pwm_PeriodType نوع

Definition of the period of a PWM channel.

Pwm_PowerStateRequestResultType نوع

Result of the requests related to power state transitions.

Pwm_PowerStateType نوع

Power state currently active or set as target power state.

Spi

JobEnd دالة

Callback routine provided by the user for each Job to notify the caller that a job has been finished.

void(* Spi_JobEndNotification); ⚠️

ResultTypeSpi_GetJobResult دالة

This service returns the last transmission result of the specified Job.

Spi_JobResultType Spi_GetJobResult(Spi_JobType Job);

ResultTypeSpi_GetSequenceResult دالة

This service returns the last transmission result of the specified Sequence.

Spi_SeqResultType Spi_GetSequenceResult(Spi_SequenceType Sequence);

SeqEnd دالة

Callback routine provided by the user for each Sequence to notify the caller that a sequence has been finished.

void(* Spi_SeqEndNotification); ⚠️

Spi_AsyncTransmit دالة

Service to transmit data on the SPI bus.

Std_ReturnType Spi_AsyncTransmit(Spi_SequenceType Sequence);

Spi_Cancel دالة

Service cancels the specified on - going sequence transmission.

void Spi_Cancel(Spi_SequenceType Sequence);

Spi_DeInit دالة

Service for SPI de - initialization.

Std_ReturnType Spi_DeInit(void);

Spi_GetHWUnitStatus دالة

This service returns the status of the specified SPI Hardware microcontroller peripheral.

Spi_StatusType Spi_GetHWUnitStatus(Spi_HWUnitType HWUnit);

Spi_GetStatus دالة

Service returns the SPI Handler/ Driver software module status.

Spi_StatusType Spi_GetStatus(void);

Spi_GetVersionInfo دالة

This service returns the version information of this module.

void Spi_GetVersionInfo(Std_VersionInfoType* versioninfo);

Spi_Init دالة

Service for SPI initialization.

void Spi_Init(const Spi_ConfigType* ConfigPtr);

Spi_MainFunction_Handling دالة

void Spi_MainFunction_Handling(void);

Spi_ReadIB دالة

Service for reading synchronously one or more data from an IB SPI Handler/ Driver Channel specified by parameter.

Std_ReturnType Spi_ReadIB(Spi_ChannelType Channel, Spi_DataBufferType* DataBufferPointer);

Spi_SetAsyncMode دالة

Service to set the asynchronous mechanism mode for SPI busses handled asynchronously.

Std_ReturnType Spi_SetAsyncMode(Spi_AsyncModeType Mode);

Spi_SetupEB دالة

Service to setup the buffers and the length of data for the EB SPI Handle r/ Driver Channel specified.

Std_ReturnType Spi_SetupEB(Spi_ChannelType Channel, const Spi_DataBufferType* SrcDataBufferPtr, Spi_DataBufferType* DesDataBufferPtr, Spi_NumberOfDataType Length);

Spi_SyncTransmit دالة

Service to transmit data on the SPI bus

Std_ReturnType Spi_SyncTransmit(Spi_SequenceType Sequence);

Spi_WriteIB دالة

Service for writing one or more data to an IB SPI Handler/ Driver Channel specified by parameter.

Std_ReturnType Spi_WriteIB(Spi_ChannelType Channel, const Spi_DataBufferType* DataBufferPtr);

Spi_AsyncModeType نوع

Specifies the asynchronous mechanism mode for SPI busses handled asynchronously.

Spi_ChannelType نوع

Specifies the identification (ID) for a Channel.

Spi_ConfigType نوع

This type of the external data structure shall contain the initialization data for the SPI Handler/ Driver.

Spi_DataBufferType نوع

Type of application data buffer elements.

Spi_HWUnitType نوع

Specifies the identification (ID) for a SPI Hardware microcontroller peripheral (unit).

Spi_JobResultType نوع

This type defines a range of specific Jobs status for SPI Handler/ Driver.

Spi_JobType نوع

Specifies the identification (ID) for a Job.

Spi_NumberOfDataType نوع

Type for defining the number of data elements of the type Spi_ Data Buffer Type to send and / or receive by Channel

Spi_SeqResultType نوع

This type defines a range of specific Sequences status for SPI Handler/ Driver.

Spi_SequenceType نوع

Specifies the identification (ID) for a sequence of jobs.

Spi_StatusType نوع

This type defines a range of specific status for SPI Handler/ Driver.

Wdg

Wdg_GetVersionInfo دالة

Returns the version information of the module.

void Wdg_GetVersionInfo (Std_VersionInfoType* versioninfo);

Wdg_Init دالة

Initializes the module.

void Wdg_Init (const Wdg_ConfigType* ConfigPtr);

Wdg_SetMode دالة

Switches the watchdog into the mode Mode. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_WatchdogDriver

Std_ReturnType Wdg_SetMode (WdgIf_ModeType Mode);

Wdg_SetTriggerCondition دالة

Sets the timeout value for the trigger counter.

void Wdg_SetTriggerCondition (uint16 timeout);

Wdg_ConfigType نوع

Used for pointers to structures holding configuration data provided to the Wdg module initialization routine for configuration of the module and watchdog hardware.

WdgIf

WdgIf_GetVersionInfo دالة

Returns the version information.

void WdgIf_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr);

WdgIf_SetMode دالة

Map the service Wdg If_ Set Mode to the serv ice Wdg_ Set Mode of the corresponding Watchdog Driver.

Std_ReturnType WdgIf_SetMode(uint8 DeviceIndex, WdgIf_ModeType WdgMode);

WdgIf_SetTriggerCondition دالة

Map the service Wdg If_ Set Trigger Condition to the service Wdg_ Set Trigger Condition of the corresponding Wa tchdog Driver.

void WdgIf_SetTriggerCondition(uint8 DeviceIndex, uint16 Timeout);

WdgIf_ModeType نوع

Mode type of the Wdg If module

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الكتلةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل الصفحة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.كتلةوحدةالتعريفالوحدات في الكتلةجديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

دليل العنقودمولَّد بالذكاء الاصطناعي

يوفر برامج تشغيل قريبة من العتاد للتغليف والتحكم المباشرين في ملحقات وحدة التحكم الدقيقة وسجلاتها الداخلية.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b04694a31489 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر برامج تشغيل قريبة من العتاد للتغليف والتحكم المباشرين في ملحقات وحدة التحكم الدقيقة وسجلاتها الداخلية.

تشتمل حزمة الوحدات Microcontroller Abstraction (MCAL) على برامج التشغيل Port وDio وAdc وPwm وSpi وWdg لتغليف الملحقات المدمجة على الرقاقة (On-Chip) والتحكم فيها بشكل قريب من العتاد (SWS_ECUStateManager ص. 34). وتشمل المهام الأساسية تكوين الأطراف قبل الوصول إلى الملحقات، وإدارة الإشارات التناظرية وإشارات التضمين النبضي، بالإضافة إلى التحكم في تسلسل التنفيذ الموقوت ([SWS_Adc_00507]، [SWS_Wdg_00155]). ويجب تنفيذ تغييرات أوضاع وحالات الطاقة المركزية بشكل تسلسلي صارم وغير قابل لإعادة الدخول ([SWS_Wdg_00107]).

تغلف حزمة الوحدات Microcontroller Abstraction (MCAL) الموارد المادية المدمجة على الرقاقة لوحدة التحكم الدقيقة، وتوفر واجهات معيارية لتجريد عتاد الإدخال/الإخراج (IoHwAb)، وواجهة كلب الحراسة (WdgIf)، بالإضافة إلى EcuM وBswM (SWS_ECUStateManager ص. 34). وتتضمن عناصر برامج التشغيل الستة: Port (تعدد إرسال الأطراف - Pin Multiplexing)، وDio (الإدخال/الإخراج الرقمي)، وAdc (التحويل التناظري الرقمي)، وPwm (تضمين عرض النبضة)، وSpi (الاتصال التسلسلي مع الملحقات)، وWdg (مراقبة تنفيذ العتاد) ([SWS_Adc_00507]، [SWS_Pwm_00197]، [SWS_Wdg_00155]).

تعمل الوحدات وفق تبعيات ثابتة: يُهيئ Port_Init تعيين الأطراف (pin layout)، قبل أن تُفعّل برامج تشغيل مثل Pwm أو Adc كتل العتاد المرتبطة (AUTOSAR_CP_RS_PWMDriver ص. 14، ModemanagementGuide ص. 54). وتُوفَّر مخازن البيانات المؤقتة من جانب التطبيق عبر Adc_SetupResultBuffer ([SWS_Adc_91000])، في حين يُفصل تشغيل كلب الحراسة (Watchdog) بشكل غير متزامن عبر مقاطعات المؤقت (AUTOSAR_SWS_WatchdogDriver ص. 31).

مخطط معماري: المعمارية الطبقية وتصنيف عنقود MCAL. المصادر: SWS_ECUStateManager ص. 34، AUTOSAR_CP_RS_PWMDriver ص. 14.

بينما تكون استدعاءات برامج التشغيل المرتبطة بالقنوات والمجموعات قابلة لإعادة الدخول (reentrant) للحالات المنفصلة ([SWS_Pwm_91000]، [SWS_Adc_00367])، تتطلب عمليات تبديل الأنماط والحالات مسارات متزامنة بصرامة وغير قابلة لإعادة الدخول ([SWS_Wdg_00107]). ولتقليل استهلاك الطاقة، يُنفذ Adc وPwm انتقالات لحالة الطاقة ثنائية الطور مع إرسال إخطارات جاهزية غير متزامنة إلى IoHwAb ([SWS_Adc_00478]، [SWS_Pwm_00183]، AUTOSAR_CP_SWS_IOHardwareAbstraction ص. 57).

يتم الإبلاغ عن أخطاء الاستخدام، مثل الاستدعاءات غير المهيأة، إلى DET ([SWS_Pwm_00177])، في حين يُبلَّغ عن أعطال العتاد إلى DEM ([SWS_Wdg_00111]). وفي حالة التدهور (degradation)، يتيح Wdg_SetTriggerCondition إمكانية التسبب الموجه في إعادة تعيين الـ ECU من خلال تمرير المهلة 0 ([SWS_Wdg_00155]، SWS_WatchdogDriver ص. 29).

معمارية النظام & دور مجموعة الوحدات

يشكل عنقود وحدات طبقة تجريد المتحكم الدقيق (Microcontroller Abstraction Layer، MCAL) الأساس الأقرب إلى العتاد في AUTOSAR Classic Platform. فهو يغلف عمليات الوصول إلى سجلات الوحدات الطرفية المدمجة في الشريحة (On-Chip)، ويوفر للطبقات العليا واجهة قياسية ومستقلة عن المتحكم الدقيق. وضمن المعمارية الطبقية، تخدم برامج التشغيل كلاً من تجريد عتاد الإدخال/الإخراج (IoHwAb)، وواجهة كلب الحراسة (WdgIf)، بالإضافة إلى خدمات النظام المركزية مثل ECU State Manager (EcuM) وBasic Software Mode Manager (BswM) (SWS_ECUStateManager ص. 34).

يشتمل العنقود على ست وحدات تشغيل تكميلية: يتولى Port التهيئة العامة للأطراف وتجميع إشارات أطراف المتحكم الدقيق (Multiplexing) (AUTOSAR_CP_RS_PWMDriver ص. 14). ويحقق Dio وصولاً سريعاً إلى الإدخال/الإخراج الرقمي على مستوى البتات والمنافذ، بينما يغلف Spi اتصالات النواقل التسلسلية المتزامنة وغير المتزامنة مع الوحدات الطرفية الموجودة على اللوحة. وبالنسبة للإشارات التناظرية وإشارات تضمين عرض النبضة (PWM)، يوفر Adc ([SWS_Adc_00507]) وPwm ([SWS_Pwm_00197]) خدمات متقدمة للتحويل والتضمين. ويتحكم Wdg في المراقبة الزمنية القائمة على العتاد لضمان سلامة تنفيذ البرنامج ([SWS_Wdg_00155]).

مخطط معماري: المعمارية الطبقية والتصنيف الهيكلي لعنقود MCAL بين خدمات النظام وطبقات التجريد والوحدات الطرفية. المصادر: SWS_ECUStateManager ص. 34، AUTOSAR_CP_RS_PWMDriver ص. 14، AUTOSAR_SWS_WatchdogDriver ص. 11.

التكامل ومسارات التفاعل بين الوحدات

تعمل الوحدات وفق مسارات تدفق واضحة ومحددة للإشارات والمخازن المؤقتة. يقوم برنامج التشغيل Port بتهيئة منطق المنافذ الكهربائية وتجميع الإشارات مسبقاً، وبعد ذلك تتحكم برامج تشغيل مثل Pwm أو Adc في كتل الوحدات الطرفية المخصصة دون الحاجة إلى معرفة تفاصيل توصيل وسادات التوصيل (AUTOSAR_CP_RS_PWMDriver ص. 14). وعند قراءة الحالات المنطقية الداخلية عبر [SWS_Pwm_00100]، يقرأ Pwm_GetOutputState حالة سجل وحدة PWM وليس طرف المنفذ الفيزيائي ([SWS_Pwm_00108]، AUTOSAR_SWS_PWMDriver ص. 51).

في المسار التناظري، تطلب IoHwAb ذات المستوى الأعلى عمليات القياس وتوفر مخازن مؤقتة من جانب التطبيق (AUTOSAR_CP_SWS_IOHardwareAbstraction ص. 55). وبواسطة [SWS_Adc_91000]، يُهيئ Adc_SetupResultBuffer المؤشر الداخلي إلى نطاق الذاكرة الخاص بالجهة المتصلة (AUTOSAR_SWS_ADCDriver ص. 31). وبعد بدء التحويل عبر مشغل برمجي ([SWS_Adc_00367]) أو مشغل عتادي ([SWS_Adc_91001])، تُكتب البيانات الخام في المخزن المؤقت. وتتم عملية القراءة بشكل متزامن عبر [SWS_Adc_00369] (نسخ أحدث النتائج) أو عبر [SWS_Adc_00375] بواسطة Adc_GetStreamLastPointer (SWS_ADCDriver ص. 27).

يفصل مسار كلب الحراسة المراقبة المنطقية للتدفق عن خدمة العتاد (Hardware-Servicing): يتحكم WdgM في ميزانيات المراقبة ويضبط عبر WdgIf باستخدام [SWS_Wdg_00155] النافذة الزمنية في Wdg_SetTriggerCondition (SWS_WatchdogDriver ص. 29). وتتم خدمة العتاد الفعلية دورياً عبر مقاطعات المؤقت العتادي (AUTOSAR_SWS_WatchdogDriver ص. 31). وفي هذه الأثناء، يتم عند الحاجة مخاطبة وحدات كلب الحراسة الخارجية عبر حالات تشغيل من Dio أو Spi ([SWS_Wdg_00111]، AUTOSAR_SWS_WatchdogDriver ص. 11).

مخطط تسلسلي: التفاعل بين WdgM وWdgIf وWdg عند تمديد المشغل دورياً وتبديل الأنماط. المصادر: AUTOSAR_SWS_WatchdogDriver ص. 31، AUTOSAR_SWS_WatchdogDriver ص. 34، [SWS_Wdg_00155]، [SWS_Wdg_00107].

المزامنة، وقابلية إعادة الدخول، وسياقات المهام

تخضع برامج تشغيل MCAL لقواعد تفصيلية فيما يخص إمكانية إعادة الدخول (Reentrancy). ففي الوحدة Pwm، تكون وظائف التحكم مثل Pwm_SetDutyCycle ([SWS_Pwm_91000]) وPwm_SetPeriodAndDuty ([SWS_Pwm_91001]) وPwm_SetOutputToIdle ([SWS_Pwm_91002]) قابلة لإعادة الدخول بالنسبة للقنوات المختلفة، ولكن لا يجوز استدعاؤها بشكل متزامن للقناة ذاتها (AUTOSAR_CP_SWS_PWMDriver ص. 46). وفي الوحدة Adc، تكون واجهات برمجة التطبيقات للتحكم والقراءة مثل Adc_StartGroupConversion ([SWS_Adc_00367]) وAdc_StopGroupConversion ([SWS_Adc_00368]) وAdc_ReadGroup ([SWS_Adc_00369]) قابلة لإعادة الدخول بالنسبة لمجموعات القنوات المختلفة.

في المقابل، تم تصميم واجهات برمجة التطبيقات المركزية للتهيئة والأنماط لتكون بصرامة غير قابلة لإعادة الدخول. وينطبق ذلك على Wdg_SetMode ([SWS_Wdg_00107]) وWdg_SetTriggerCondition ([SWS_Wdg_00155]) بالإضافة إلى روتينات التهيئة وإلغاء التهيئة لجميع برامج التشغيل ([SWS_Adc_00366]، [SWS_Pwm_00096]). ويجب حماية الاستدعاءات المتزامنة المتنافسة من مهام OS المختلفة عبر مناطق SchM الحصرية (AUTOSAR_SWS_WatchdogDriver ص. 11).

يتم إطلاق الإخطارات بالأحداث (مثل تغير الحافة أو انتهاء التحويل) عبر استدعاءات راجعة (callbacks) قابلة للتكوين مثل Pwm_Notification_<#Channel> ([SWS_Pwm_00105]) أو Adc_Notification_Group_<x> ([SWS_Adc_91003]) من سياق المقاطعة (ISR). وعند تفعيل الإخطارات، يُعاد تعيين أعلام المقاطعة المعلقة ([SWS_Pwm_91004]). وإذا تنافست عدة مجموعات ADC على موارد المحول، يتم تفعيل تحديد الأولويات بالعتاد أو رتل البرمجيات (Software-Queuing) ([SWS_Adc_00522]) وفقاً للتكوين، مع آلية إلغاء/إعادة تشغيل (Abort/Restart) أو تعليق/استئناف (Suspend/Resume) قابلة للتكوين ([SWS_Adc_00523]، SWS_ADCDriver ص. 97).

دورات الحياة النموذجية وأنماط التشغيل

تبدأ دورة حياة برامج تشغيل MCAL في مرحلة بدء النظام الكلي تحت تحكم EcuM (SWS_ECUStateManager ص. 34). ويتم فرض ترتيب حتمي عبر قواعد BswM: حيث يُهيئ Port_Init أولاً وظائف الأطراف (ModemanagementGuide ص. 54). وبعد ذلك فقط تتبع برامج تشغيل الوحدات الطرفية مثل Dio_Init وSpi_Init وAdc_Init ([SWS_Adc_00365]) وPwm_Init ([SWS_Pwm_00095]) وWdg_Init ([SWS_Wdg_00106]، AUTOSAR_CP_SWS_PWMDriver ص. 47).

أثناء التشغيل، يعرف Wdg ثلاثة أنماط ساكنة: WDGIF_OFF_MODE وWDGIF_SLOW_MODE وWDGIF_FAST_MODE ([SWS_Wdg_00107]). وتُميز الوحدة Adc بين التحويلات أحادية المرة (One-Shot) والمستمرة (Continuous) ([SWS_Adc_00515])، وكذلك بين أنماط الوصول المفردة وتدفق البيانات (Streaming) ([SWS_Adc_00528]، [SWS_Adc_00519]). وتمر حالة المجموعة خلال ذلك بالحالات ADC_IDLE وADC_BUSY وADC_COMPLETED وADC_STREAM_COMPLETED ([SWS_Adc_00513]، [SWS_Adc_00374]، SWS_ADCDriver ص. 37).

بالنسبة لأنماط توفير الطاقة (Low Power)، يطبق Adc وPwm بروتوكول حالة الطاقة القياسي ثنائي الطور: في البداية، يُعدّ Adc_PreparePowerState ([SWS_Adc_00478]) وPwm_PreparePowerState ([SWS_Pwm_00183]) الانتقال ([SWS_Pwm_00165]، [SWS_Adc_00527]). وبعد الاكتمال غير المتزامن، تُبلغ طبقة تجريد العتاد عن الجاهزية عبر استدعاءات راجعة مثل IoHwAb_Adc_NotifyReadyForPowerState<#Mode> ([SWS_Adc_00480]). وأخيراً، يحول Adc_SetPowerState ([SWS_Adc_00475]) وPwm_SetPowerState ([SWS_Pwm_00166]) العتاد إلى الحالة المستهدفة (AUTOSAR_CP_SWS_IOHardwareAbstraction ص. 57). ويتم ضمان المراقبة الدورية في المهام بواسطة Pwm_Main_PowerTransitionManager ([SWS_Pwm_00189]، [SWS_Pwm_00190]).

عند إيقاف تشغيل النظام أو إعادة التعيين، تنقل خدمات إلغاء التهيئة مثل Adc_DeInit ([SWS_Adc_00366]، AUTOSAR_SWS_ADC_Driver ص. 76) وPwm_DeInit ([SWS_Pwm_00096]، AUTOSAR_SWS_PWMDriver ص. 47) الوحدات إلى حالة خمول آمنة وتعطل جميع المقاطعات.

مخطط تسلسلي: تغيير حالة الطاقة غير المتزامن ثنائي الطور في عنقود MCAL عبر BswM وIoHwAb. المصادر: AUTOSAR_CP_SWS_IOHardwareAbstraction ص. 57، [SWS_Adc_00478]، [SWS_Pwm_00183]، [SWS_Adc_00475]، [SWS_Pwm_00166].

معالجة الأخطاء، وتتبع DET، والتدهور التدريجي للخدمة (Degradation)

تُفصل الأخطاء بصرامة بين أخطاء التطوير وأخطاء الإنتاج. فعندما تكون مراقبة التطوير نشطة، تبلغ برامج التشغيل عن الاستدعاءات التي تتم قبل اكتمال التهيئة إلى Default Error Tracer (DET)، على سبيل المثال عبر PWM_E_UNINIT ([SWS_Pwm_00177]، [SWS_Pwm_00104]) أو ADC_E_UNINIT ([SWS_Adc_00476]). كما يتم فحص معلمات المؤشرات للتحقق من عدم كونها NULL، على سبيل المثال عند GetVersionInfo عبر ADC_E_PARAM_POINTER ([SWS_Adc_00376]) وWDG_E_PARAM_POINTER ([SWS_Wdg_00109]).

تؤمن أخطاء وقت التشغيل الانتقالات غير المسموح بها أثناء التشغيل: إذا تم استدعاء Pwm_SetPowerState بينما القنوات ليست في حالة IDLE أو لا تزال هناك إخطارات نشطة، يبلغ برنامج التشغيل عن خطأ وقت التشغيل PWM_E_NOT_DISENGAGED ([SWS_Pwm_00202]). وعند Adc، تؤدي محاولة إعادة تشغيل مجموعة قنوات مشغولة في التكوينات التي لا تحتوي على رتل (Queuing) إلى إرسال إبلاغ وقت التشغيل ADC_E_BUSY إلى DET (SWS_ADCDriver ص. 95).

يتم الإبلاغ عن أخطاء الإنتاج الجسيمة وأعطال الوحدات الطرفية إلى Diagnostic Event Manager (DEM) عبر Dem_SetEventStatus ([SWS_Wdg_00111]). ولأجل التدهور (degradation) إلى أنماط التشغيل الطارئ، يوفر Pwm_SetOutputToIdle إمكانية التعطيل الفوري لمخارج PWM الفردية ([SWS_Pwm_91002]). وفي برنامج تشغيل كلب الحراسة، يتيح ضبط مهلة المشغل (Trigger Timeout) على القيمة 0 الإيقاف الفوري لخدمة المراقبة ويفرض إعادة تعيين قريبة للـ ECU ([SWS_Wdg_00155]، [SWS_Wdg_00136]، SWS_WatchdogDriver ص. 29).

يستند هذا الدليل حصرياً إلى مواصفات عناصر الحمولة (Payload) ومصنوعات التتبع الخاصة بـ AUTOSAR Classic R20-11.

Module im Cluster

ADC Driver (Adc)

Provides initialization and conversion services for analog-to-digital converters.

BSW ID 123 43 APIs (19 Funktionen, 24 Typen) #include "Adc.h"

Core Test (CorTst)

AUTOSAR Classic Microcontroller Drivers-Modul Core Test (CorTst, Spezifikation: AUTOSAR_CP_SWS_CoreTest.pdf, AUTOSAR_SWS_CoreTest.pdf).

BSW ID 103 11 APIs (11 Funktionen, 0 Typen) #include "CorTst.h"

DIO Driver (Dio)

AUTOSAR Classic I/O Drivers-Modul DIO Driver (Dio, Spezifikation: AUTOSAR_CP_SWS_DIODriver.pdf, AUTOSAR_SWS_DIODriver.pdf, AUTOSAR_SWS_DIO_Driver.pdf).

BSW ID 120 9 APIs (9 Funktionen, 0 Typen) #include "Dio.h"

GPT Driver (Gpt)

AUTOSAR Classic Microcontroller Drivers-Modul GPT Driver (Gpt, Spezifikation: AUTOSAR_CP_SWS_GPTDriver.pdf, AUTOSAR_SWS_GPTDriver.pdf, AUTOSAR_SWS_GPT_Driver.pdf).

BSW ID 100 15 APIs (15 Funktionen, 0 Typen) #include "Gpt.h"

I2C Driver (I2c)

AUTOSAR Classic Communication Drivers-Modul I2C Driver (I2c, Spezifikation: AUTOSAR_CP_SWS_I2CDriver.pdf).

Keine C-API · 0 Records #include "I2c.h"

ICU Driver (Icu)

AUTOSAR Classic I/O Drivers-Modul ICU Driver (Icu, Spezifikation: AUTOSAR_CP_SWS_ICUDriver.pdf, AUTOSAR_SWS_ICUDriver.pdf, AUTOSAR_SWS_ICU_Driver.pdf).

BSW ID 122 28 APIs (28 Funktionen, 0 Typen) #include "Icu.h"

I/O Hardware Abstraction (IoHwAb)

AUTOSAR Classic I/O HW Abstraction-Modul I/O Hardware Abstraction (IoHwAb, Spezifikation: AUTOSAR_CP_SWS_IOHardwareAbstraction.pdf, AUTOSAR_SWS_IOHardwareAbstraction.pdf, AUTOSAR_SWS_IO_HWAbstraction.pdf).

BSW ID 254 13 APIs (13 Funktionen, 0 Typen) #include "IoHwAb.h"

MCU Driver (Mcu)

AUTOSAR Classic Microcontroller Drivers-Modul MCU Driver (Mcu, Spezifikation: AUTOSAR_CP_SWS_MCUDriver.pdf, AUTOSAR_SWS_MCUDriver.pdf, AUTOSAR_SWS_MCU_Driver.pdf).

BSW ID 101 11 APIs (11 Funktionen, 0 Typen) #include "Mcu.h"

OCU Driver (Ocu)

AUTOSAR Classic I/O Drivers-Modul OCU Driver (Ocu, Spezifikation: AUTOSAR_CP_SWS_OCUDriver.pdf, AUTOSAR_SWS_OCUDriver.pdf).

BSW ID 125 13 APIs (13 Funktionen, 0 Typen) #include "Ocu.h"

Port Driver (Port)

AUTOSAR Classic I/O Drivers-Modul Port Driver (Port, Spezifikation: AUTOSAR_CP_SWS_PortDriver.pdf, AUTOSAR_SWS_PortDriver.pdf, AUTOSAR_SWS_Port_Driver.pdf).

BSW ID 124 5 APIs (5 Funktionen, 0 Typen) #include "Port.h"

PWM Driver (Pwm)

Generates pulse-width-modulated signals with configurable duty cycle and period.

BSW ID 121 24 APIs (16 Funktionen, 8 Typen) #include "Pwm.h"

SPI Handler Driver (Spi)

AUTOSAR Classic Communication Drivers-Modul SPI Handler Driver (Spi, Spezifikation: AUTOSAR_CP_SWS_SPIHandlerDriver.pdf, AUTOSAR_SWS_SPIHandlerDriver.pdf, AUTOSAR_SWS_SPI_HandlerDriver.pdf).

BSW ID 83 15 APIs (15 Funktionen, 0 Typen) #include "Spi.h"

Watchdog Driver (Wdg)

Hardware watchdog timer servicing and mode configuration.

BSW ID 102 5 APIs (4 Funktionen, 1 Typen) #include "Wdg.h"

Watchdog Interface (WdgIf)

AUTOSAR Classic Onboard Device Abstraction-Modul Watchdog Interface (WdgIf, Spezifikation: AUTOSAR_CP_SWS_WatchdogInterface.pdf, AUTOSAR_SWS_WatchdogInterface.pdf).

BSW ID 43 3 APIs (3 Funktionen, 0 Typen) #include "WdgIf.h"

وحدات MCAL إضافية (كتالوج)

Dio, Port und Spi gehören zum MCAL-Cluster, haben aber noch keine Modulseite (die festen 44 Modul-Records enthalten sie nicht). Die Tabellen sind die API-Kataloge aus den SWS-Definitionen von R23-11. Die Modulseiten selbst erzeugt die Modul-Registry; bis dahin steht der Katalog direkt auf dieser Seite.

DIO Driver (Dio)

BSW ID 120 #include "Dio.h" 9 وظائف API

Service	Syntax	SWS
`Dio_ReadChannel`	`Dio_LevelType Dio_ReadChannel(Dio_ChannelType ChannelId);`	`SWS_Dio_00133`
`Dio_WriteChannel`	`void Dio_WriteChannel(Dio_ChannelType ChannelId, Dio_LevelType Level);`	`SWS_Dio_00134`
`Dio_ReadPort`	`Dio_PortLevelType Dio_ReadPort(Dio_PortType PortId);`	`SWS_Dio_00135`
`Dio_WritePort`	`void Dio_WritePort(Dio_PortType PortId, Dio_PortLevelType Level);`	`SWS_Dio_00136`
`Dio_ReadChannelGroup`	`Dio_PortLevelType Dio_ReadChannelGroup(const Dio_ChannelGroupType* ChannelGroupIdPtr);`	`SWS_Dio_00137`
`Dio_WriteChannelGroup`	`void Dio_WriteChannelGroup(const Dio_ChannelGroupType* ChannelGroupIdPtr, Dio_PortLevelType Level);`	`SWS_Dio_00138`
`Dio_GetVersionInfo`	`void Dio_GetVersionInfo(Std_VersionInfoType* VersionInfo);`	`SWS_Dio_00139`
`Dio_FlipChannel`	`Dio_LevelType Dio_FlipChannel(Dio_ChannelType ChannelId);`	`SWS_Dio_00190`
`Dio_MaskedWritePort`	`void Dio_MaskedWritePort(Dio_PortType PortId, Dio_PortLevelType Level, Dio_PortLevelType Mask);`	`SWS_Dio_00300`

Port Driver (Port)

BSW ID 124 #include "Port.h" 5 وظائف API

Service	Syntax	SWS
`Port_Init`	`void Port_Init(const Port_ConfigType* ConfigPtr);`	`SWS_Port_00140`
`Port_SetPinDirection`	`void Port_SetPinDirection(Port_PinType Pin, Port_PinDirectionType Direction);`	`SWS_Port_00141`
`Port_RefreshPortDirection`	`void Port_RefreshPortDirection(void);`	`SWS_Port_00142`
`Port_GetVersionInfo`	`void Port_GetVersionInfo(Std_VersionInfoType* versioninfo);`	`SWS_Port_00143`
`Port_SetPinMode`	`void Port_SetPinMode(Port_PinType Pin, Port_PinModeType Mode);`	`SWS_Port_00145`

SPI Handler/Driver (Spi)

BSW ID 83 #include "Spi.h" 15 وظائف API

Service	Syntax	SWS
`Spi_Init`	`void Spi_Init(const Spi_ConfigType* ConfigPtr);`	`SWS_Spi_00175`
`Spi_DeInit`	`Std_ReturnType Spi_DeInit(void);`	`SWS_Spi_00176`
`Spi_WriteIB`	`Std_ReturnType Spi_WriteIB(Spi_ChannelType Channel, const Spi_DataBufferType* DataBufferPtr);`	`SWS_Spi_00177`
`Spi_AsyncTransmit`	`Std_ReturnType Spi_AsyncTransmit(Spi_SequenceType Sequence);`	`SWS_Spi_00178`
`Spi_ReadIB`	`Std_ReturnType Spi_ReadIB(Spi_ChannelType Channel, Spi_DataBufferType* DataBufferPointer);`	`SWS_Spi_00179`
`Spi_SetupEB`	`Std_ReturnType Spi_SetupEB(Spi_ChannelType Channel, const Spi_DataBufferType* SrcDataBufferPtr, Spi_DataBufferType* DesDataBufferPtr, Spi_NumberOfDataType Length);`	`SWS_Spi_00180`
`Spi_GetStatus`	`Spi_StatusType Spi_GetStatus(void);`	`SWS_Spi_00181`
`Spi_GetJobResult`	`Spi_JobResultType Spi_GetJobResult(Spi_JobType Job);`	`SWS_Spi_00182`
`Spi_GetSequenceResult`	`Spi_SeqResultType Spi_GetSequenceResult(Spi_SequenceType Sequence);`	`SWS_Spi_00183`
`Spi_GetVersionInfo`	`void Spi_GetVersionInfo(Std_VersionInfoType* versioninfo);`	`SWS_Spi_00184`
`Spi_SyncTransmit`	`Std_ReturnType Spi_SyncTransmit(Spi_SequenceType Sequence);`	`SWS_Spi_00185`
`Spi_GetHWUnitStatus`	`Spi_StatusType Spi_GetHWUnitStatus(Spi_HWUnitType HWUnit);`	`SWS_Spi_00186`
`Spi_Cancel`	`void Spi_Cancel(Spi_SequenceType Sequence);`	`SWS_Spi_00187`
`Spi_SetAsyncMode`	`Std_ReturnType Spi_SetAsyncMode(Spi_AsyncModeType Mode);`	`SWS_Spi_00188`
`Spi_MainFunction_Handling`	`void Spi_MainFunction_Handling(void);`	`SWS_Spi_00189`

AUTOSAR Classic Microcontroller Abstraction (MCAL)

خريطة المواضيع

عرض التفاصيل

دليل العنقودمولَّد بالذكاء الاصطناعي🔍

معمارية النظام & دور مجموعة الوحدات

التكامل ومسارات التفاعل بين الوحدات

المزامنة، وقابلية إعادة الدخول، وسياقات المهام

دورات الحياة النموذجية وأنماط التشغيل

معالجة الأخطاء، وتتبع DET، والتدهور التدريجي للخدمة (Degradation)

Module im Cluster

ADC Driver (Adc)

Core Test (CorTst)

DIO Driver (Dio)

GPT Driver (Gpt)

I2C Driver (I2c)

ICU Driver (Icu)

I/O Hardware Abstraction (IoHwAb)

MCU Driver (Mcu)

OCU Driver (Ocu)

Port Driver (Port)

PWM Driver (Pwm)

SPI Handler Driver (Spi)

Watchdog Driver (Wdg)

Watchdog Interface (WdgIf)

وحدات MCAL إضافية (كتالوج)

DIO Driver (Dio)

Port Driver (Port)

SPI Handler/Driver (Spi)

دليل العنقودمولَّد بالذكاء الاصطناعي