FlexRay Driver (Fr)
Provides hardware-dependent access to FlexRay communication controllers.
Funktionen — Übersicht
void Fr_Init (const Fr_ConfigType* Fr_ConfigPtr);Initializes the Fr.Std_ReturnType Fr_ControllerInit (uint8 Fr_CtrlIdx);Initialzes a F lex Ray CC.Std_ReturnType Fr_StartCommunication (uint8 Fr_CtrlIdx);Starts communication.Std_ReturnType Fr_AllowColdstart (uint8 Fr_CtrlIdx);Invokes the CC CHI command 'ALLOW_ COLDSTART'.Std_ReturnType Fr_AllSlots (uint8 Fr_CtrlIdx);Invokes the CC CHI command 'ALL_ SLOTS'.Std_ReturnType Fr_HaltCommunication (uint8 Fr_CtrlIdx);Invokes the CC CHI command 'DEFERRED_ HALT'.Std_ReturnType Fr_AbortCommunication (uint8 Fr_CtrlIdx);Invokes the CC CHI command 'FREEZE'.Std_ReturnType Fr_SendWUP (uint8 Fr_CtrlIdx);Invokes the CC CHI command 'WAKEUP'.Std_ReturnType Fr_SetWakeupChannel (uint8 Fr_CtrlIdx, Fr_ChannelType Fr_ChnlIdx);Sets a wakeup channel.Std_ReturnType Fr_GetPOCStatus (uint8 Fr_CtrlIdx, Fr_POCStatusType* Fr_POCStatusPtr);Gets the POC status.Std_ReturnType Fr_TransmitTxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, const uint8* Fr_LSduPtr, uint8 Fr_LSduLength, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);Transmits data on the Flex Ray network.Std_ReturnType Fr_CancelTxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);Cancels the already pending transmission of a LPdu contained in a controllers p hysical transmit resource (e.Std_ReturnType Fr_ReceiveRxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, uint8* Fr_LSduPtr, Fr_RxLPduStatusType* Fr_LPduStatusPtr, uint8* Fr_LSduLengthPtr, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);Service Fr_ReceiveRxLPdu.Std_ReturnType* Fr_CheckTxLPduStatus (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, Fr_TxLPduStatusType* Fr_TxLPduStatusPtr, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);Checks the transmit status of the LSdu.Std_ReturnType Fr_PrepareLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);Prepares a LPdu.Std_ReturnType Fr_ReconfigLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, uint16 Fr_FrameId, Fr_ChannelType Fr_ChnlIdx, uint8 Fr_CycleRepetition, uint8 Fr_CycleOffset, uint8 Fr_PayloadLength, uint16 Fr_Header CRC); ⚠️Service Fr_ReconfigLPdu.Std_ReturnType Fr_DisableLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);Disables the hardware resource of a LPdu for transmission/ reception.Std_ReturnType Fr_GetGlobalTime (uint8 Fr_CtrlIdx, uint8* Fr_CyclePtr, uint16* Fr_MacroTickPtr);Gets the current global Flex Ray time.Std_ReturnType Fr_GetNmVector (uint8 Fr_CtrlIdx, uint8* Fr_NmVectorPtr);Gets the network management vector of the last communication cycle.Std_ReturnType Fr_GetNumOfStartup Fr_GetNumStartupFrames (uint8 Fr_CtrlIdx, uint8* Fr_NumOfStartupFramesPtr); ⚠️Gets the current number of startup frames seen on the cluster.Std_ReturnType Fr_GetChannelStatus (uint8 Fr_CtrlIdx, uint16* Fr_ChannelAStatusPtr, uint16* Fr_ChannelBStatusPtr);Gets the channe l status information.Std_ReturnType Fr_GetClockCorrection (uint8 Fr_CtrlIdx, sint16* Fr_RateCorrectionPtr, sint32* Fr_OffsetCorrectionPtr);Gets the current clock correction values.Std_ReturnType Fr_GetSyncFrameList (uint8 Fr_CtrlIdx, uint8 Fr_ListSize, uint16* Fr_ChannelAEvenListPtr, uint16* Fr_ChannelBEvenListPtr, uint16* Fr_ChannelAOddListPtr, uint16* Fr_ChannelBOddListPtr);Service Fr_GetSyncFrameList.Std_ReturnType Fr_GetWakeupRxStatus (uint8 Fr_CtrlIdx, uint8* Fr_WakeupRxStatusPtr);Gets the wakeup received information from the Flex Ray controller.Std_ReturnType Fr_SetAbsoluteTimer (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx, uint8 Fr_Cycle, uint16 Fr_Offset);Sets the absolute Flex Ray timer.Std_ReturnType Fr_CancelAbsoluteTimer (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);Stops an absolute timer.Std_ReturnType Fr_EnableAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);Service Fr_EnableAbsoluteTimerIRQ.Std_ReturnType Fr_AckAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);Service Fr_AckAbsoluteTimerIRQ.Std_ReturnType Fr_DisableAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);Disables the in terrupt line of an absolute timer.Std_ReturnType Fr_GetAbsoluteTimerIRQStatus (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx, boolean* Fr_IRQStatusPtr);Gets IRQ status of an absolute timer.void Fr_GetVersionInfo (Std_VersionInfoType* VersioninfoPtr);Returns the version information of this module.Std_ReturnType Fr_ReadCCConfig (uint8 Fr_CtrlIdx, uint8 Fr_Config ParamIdx, uint32* Fr_Config ParamValuePtr); ⚠️Service Fr_ReadCCConfig.
Typen — Übersicht
struct Fr_ConfigTypeThis type contains the implementation - specific post build configuration structure.enum Fr_SlotModeTypeThis formal definition refers to the description of type T_ Slot Mode in chapter 2.enum Fr_ErrorModeTypeThis formal definition refers to the description of type T_ Error Mode in chapter 2.enum Fr_WakeupStatusTypeThis formal definition refers to the description of type T_ Wakeup Status in chapter Specification of FlexRay Driverenum Fr_StartupStateTypeType Fr_StartupStateType.enum Fr_POCStatusTypeThis formal definition refers to the description of type T_ POCStatus in chapter 2.enum Fr_TxLPduStatusTypeThese values are used to determine whether a LPdu has been transmitted or not.enum Fr_RxLPduStatusTypeThese values are used to determine if a LPdu has been received or not.struct Fr_SlotAssignmentTypeThis structure contains information about the assignment of a Flex Ray frame to a cycle and a slot ID.Fr_ChannelTypeFlexRay channel identifier: FR_CHANNEL_A, FR_CHANNEL_B, or FR_CHANNEL_AB.
Funktionen & Typen — Detailansicht
function Fr_Init [SWS_Fr_00032] 📄 PDF
void Fr_Init (const Fr_ConfigType* Fr_ConfigPtr);
Initializes the Fr.
Die synchrone Funktion Fr_Init dient der Initialisierung des FlexRay-Treibers (Fr) gemäß [SWS_Fr_00032]. Sie ist über die Header-Datei Fr.h deklariert und besitzt die Service-ID 0x1c [SWS_Fr_00032]. Als einzigen Eingabeparameter erwartet die Schnittstelle Fr_ConfigPtr vom Typ const Fr_ConfigType* [SWS_Fr_00032]. Dieser Zeiger verweist auf eine treiberabhängige Konfigurationsstruktur, welche sämtliche erforderlichen Informationen für den anschließenden operativen Betrieb des FlexRay-Treibers bereitstellt [SWS_Fr_00032]. Die Funktion besitzt weder Ein-/Ausgabeparameter noch Ausgabeparameter und liefert keinen Rückgabewert (void) [SWS_Fr_00032].
Hinsichtlich der Nebenläufigkeit und Einschränkungen ist Fr_Init als nicht reentrant (Non Reentrant) spezifiziert [SWS_Fr_00032]. Aufrufe dürfen daher keinesfalls parallel oder verschachtelt erfolgen. Da die übergebene Konfigurationsstruktur alle grundlegenden Daten für den weiteren Betrieb enthält, dürfte die Initialisierung typischerweise sequenziell in der Startphase des Gesamtsystems erfolgen, bevor weitere Moduldienste aufgerufen werden [SWS_Fr_00032]. Frage Q-a208c696fbb083d4 (offen)
Eine Fehlerbehandlung über spezifische Fehlercodes oder Statusrückmeldungen ist in der Dienstdefinition nicht vorgesehen [SWS_Fr_00032]. Weitergehende Anforderungen, beispielsweise zu Benachrichtigungen an DET oder DEM, sind im vorliegenden Datensatz nicht dokumentiert.
Dieser Text wurde durch eine KI auf Basis der Spezifikation generiert.
Implementer's Guide folgt (Komplexität I1)
function Fr_ControllerInit [SWS_Fr_00017] 📄 PDF
Std_ReturnType Fr_ControllerInit (uint8 Fr_CtrlIdx);
Initialzes a F lex Ray CC.
Die synchrone Funktion Fr_ControllerInit dient der Initialisierung eines FlexRay Communication Controllers (FlexRay CC) im Kontext des FlexRay-Treibers [SWS_Fr_00017]. Sie ist in der Header-Datei Fr.h deklariert und besitzt die Service-ID 0x00 [SWS_Fr_00017]. Über den Eingabeparameter Fr_CtrlIdx vom Typ uint8 wird der Index des zu initialisierenden Controllers übergeben [SWS_Fr_00017].
Als Rückgabewert liefert die Funktion den Status Std_ReturnType [SWS_Fr_00017]:
E_OK: Der API-Aufruf wurde erfolgreich abgeschlossen [SWS_Fr_00017].E_NOT_OK: Der Aufruf wurde aufgrund aufgetretener Fehler vorzeitig abgebrochen [SWS_Fr_00017].
Detaillierte Fehlercodes sowie Meldungen an DET oder DEM sind im spezifizierten Schnittstellenumfang nicht aufgeführt [SWS_Fr_00017].
Hinsichtlich der Nebenläufigkeit ist die Funktion als nicht reentrant für dieselbe Hardware-Einheit eingestuft (Non Reentrant for the same device) [SWS_Fr_00017]. Daher darf ein Aufruf für denselben Controller-Index Fr_CtrlIdx nicht zeitgleich erfolgen; parallele Aufrufe für unterschiedliche Controller dürften hingegen zulässig sein [SWS_Fr_00017]. Frage Q-5bbbba38e8530b43 (offen) Da keine Ein- und Ausgabeparameter (inout/out) definiert sind, erfolgt die Initialisierung rein zustandsbasiert im Treiber [SWS_Fr_00017].
Dieser Nutzungshinweis wurde automatisiert auf Basis des AUTOSAR-Spezifikationsstands R20-11 generiert.
function Fr_StartCommunication [SWS_Fr_00010] 📄 PDF
Std_ReturnType Fr_StartCommunication (uint8 Fr_CtrlIdx);
Starts communication.
Die Funktion Fr_StartCommunication dient dem Starten der FlexRay-Kommunikation auf einem angegebenen Controller [SWS_Fr_00010]. Die Schnittstelle ist über die Header-Datei Fr.h verfügbar [SWS_Fr_00010].
Verwendung
Der Aufruf erfolgt asynchron unter Übergabe des Parameters Fr_CtrlIdx (Service-ID 0x03), welcher den Index des FlexRay-Kommunikationscontrollers im Treiberkontext angibt [SWS_Fr_00010]. Als Rückgabewert liefert die Funktion einen Status vom Typ Std_ReturnType [SWS_Fr_00010]:
E_OK: Der API-Aufruf wurde erfolgreich beendet [SWS_Fr_00010]. Interpretation: Aufgrund der asynchronen Semantik dürfte dies die erfolgreiche Annahme des Startbefehls bedeuten, während der eigentliche Verbindungsaufbau nachfolgend abläuft. Frage Q-fabca57ea7d32a05 (offen)E_NOT_OK: Der API-Aufruf wurde infolge von Fehlern abgebrochen [SWS_Fr_00010].
Nebenläufigkeit und Einschränkungen
Für denselben FlexRay-Controller ist Fr_StartCommunication als nicht reentrant spezifiziert [SWS_Fr_00010]. Für unterschiedliche Controller-Instanzen ist der Aufruf hingegen reentrant. Spezifische Entwicklungsfehler (DET), Fehlermeldungen (DEM) oder weiterführende Abhängigkeiten sind in den vorliegenden Spezifikationsdaten nicht enthalten.
Dieser Verwendungshinweis basiert ausschließlich auf den Angaben der Spezifikation AUTOSAR Classic Release R20-11.
Implementer's Guide folgt (Komplexität I1)
function Fr_AllowColdstart [SWS_Fr_00114] 📄 PDF
Std_ReturnType Fr_AllowColdstart (uint8 Fr_CtrlIdx);
Invokes the CC CHI command 'ALLOW_ COLDSTART'.
Verwendung
Die Funktion Fr_AllowColdstart dient dem Aufruf des Controller-Host-Interface-Befehls ALLOW_COLDSTART auf dem FlexRay Communication Controller [SWS_Fr_00114]. Die Deklaration wird über die Header-Datei Fr.h bereitgestellt; der Dienst besitzt die Service-ID 0x23 [SWS_Fr_00114]. Über den Übergabeparameter Fr_CtrlIdx wird der Index des anzusprechenden FlexRay-Controllers innerhalb des FlexRay-Treibers angegeben [SWS_Fr_00114]. Der Aufruf wird asynchron ausgeführt [SWS_Fr_00114].
Fehlerbehandlung und Rückgabewerte
Die Funktion gibt einen Status vom Typ Std_ReturnType zurück [SWS_Fr_00114]:
E_OK: Der API-Aufruf wurde erfolgreich beendet [SWS_Fr_00114].E_NOT_OK: Der API-Aufruf wurde infolge von Fehlern abgebrochen [SWS_Fr_00114].
Spezifische Fehlerursachen oder Meldungen an DEM bzw. DET sind für diesen Dienst in der Funktionsspezifikation nicht gesondert aufgeführt [SWS_Fr_00114].
Nebenläufigkeit und Einschränkungen
Die Schnittstelle ist für dieselbe Controller-Instanz nicht reentrant (Non Reentrant for the same device) [SWS_Fr_00114]. Aufrufe mit demselben Parameter Fr_CtrlIdx dürfen daher nicht parallel oder unterbrechend erfolgen [SWS_Fr_00114]. Interpretation: Aufgrund der asynchronen Ausführungssemantik quittiert der Rückgabewert E_OK vermutlich lediglich die Annahme des CHI-Kommandos durch den Treiber, während die controllerinterne Zustandsänderung zeitlich versetzt abläuft [SWS_Fr_00114]. Frage Q-e5c407f32c449510 (offen)
Dieser Nutzungshinweis wurde automatisiert auf Basis der AUTOSAR-Spezifikation für das Release R20-11 generiert.
Implementer's Guide folgt (Komplexität I1)
function Fr_AllSlots [SWS_Fr_00516] 📄 PDF
Std_ReturnType Fr_AllSlots (uint8 Fr_CtrlIdx);
Invokes the CC CHI command 'ALL_ SLOTS'.
Verwendung und Funktionsweise
Die Funktion Fr_AllSlots dient dem Absetzen des CHI-Kommandos (Controller Host Interface) ALL_SLOTS an den adressierten FlexRay-Communication-Controller [SWS_Fr_00516]. Sie wird über den Header Fr.h bereitgestellt und besitzt die Service-ID 0x24 [SWS_Fr_00516].
Als Eingabeparameter erwartet die Funktion Fr_CtrlIdx, welcher den Index des betroffenen FlexRay-Controllers im Kontext des FlexRay-Treibers angibt [SWS_Fr_00516]. Die Ausführung erfolgt asynchron [SWS_Fr_00516]. Der Rückgabewert E_OK signalisiert, dass der API-Aufruf erfolgreich abgeschlossen wurde, während E_NOT_OK einen Abbruch aufgrund von Fehlern anzeigt [SWS_Fr_00516]. Aufgrund der asynchronen Semantik bestätigt E_OK vermutlich lediglich die erfolgreiche Entgegennahme bzw. das Anstoßen des CHI-Kommandos und nicht die vollendete Hardware-Reaktion des Controllers (Interpretation). Frage Q-c526e3b174a4b44a (offen)
Fehlerbehandlung und Nebenläufigkeit
Schlägt die Ausführung fehl, bricht der Aufruf mit dem Rückgabewert E_NOT_OK ab [SWS_Fr_00516]. Konkrete Fehlerursachen oder DET-/DEM-Meldungen werden in der Spezifikation dieses Elements nicht benannt.
Hinsichtlich der Reentranz ist Fr_AllSlots als nicht reentrant für denselben Controller spezifiziert (Non Reentrant for the same device) [SWS_Fr_00516]. Nebenläufige Aufrufe für dieselbe Controller-Instanz müssen daher durch übergeordnete Schichten vermieden werden. Parallele Aufrufe für unterschiedliche Controller-Instanzen dürften hingegen zulässig sein (Interpretation). Frage (offen)
Dieser Nutzungshinweis wurde automatisiert erstellt. Fachliche Aussagen basieren ausschließlich auf dem AUTOSAR-Spezifikationsauszug.
function Fr_HaltCommunication [SWS_Fr_00014] 📄 PDF
Std_ReturnType Fr_HaltCommunication (uint8 Fr_CtrlIdx);
Invokes the CC CHI command 'DEFERRED_ HALT'.
Die Funktion Fr_HaltCommunication dient dazu, das Anhalten der Kommunikation an einem FlexRay-Kommunikationscontroller einzuleiten, indem sie den CC-CHI-Befehl 'DEFERRED_HALT' ausführt [SWS_Fr_00014].
Verwendung und Parameter
Der Aufruf erfolgt asynchron und wird über den Header Fr.h bereitgestellt (Service-ID 0x04) [SWS_Fr_00014]:
Fr_CtrlIdx(Eingangsparameter): Bestimmt den Index des anzusteuernden FlexRay-Kommunikationscontrollers innerhalb des FlexRay-Treibers [SWS_Fr_00014].- Rückgabewert (
Std_ReturnType): GibtE_OKzurück, wenn der Funktionsaufruf erfolgreich abgeschlossen wurde, oderE_NOT_OK, wenn der Aufruf infolge von Fehlern abgebrochen wurde [SWS_Fr_00014].
Nebenläufigkeit und Einschränkungen
Hinsichtlich des Aufrufkontexts und der Nebenläufigkeit ist Fr_HaltCommunication nicht reentrant bezüglich desselben Geräts (Non Reentrant for the same device) [SWS_Fr_00014]. Für denselben Controller-Index darf folglich kein nebenläufiger oder überlappender Aufruf erfolgen. Aufrufe für unterschiedliche Controller-Instanzen sind hingegen zulässig.
Fehlerbehandlung
Tritt während des Aufrufs ein Fehler auf, bricht die Funktion die Ausführung ab und signalisiert dies über den Rückgabewert E_NOT_OK [SWS_Fr_00014]. Detaillierte Fehlermeldungen sind für diese Funktion im Spezifikationsumfang nicht aufgeführt.
Dieser Nutzungshinweis wurde automatisch auf Basis der AUTOSAR-Spezifikation generiert.
function Fr_AbortCommunication [SWS_Fr_00011] 📄 PDF
Std_ReturnType Fr_AbortCommunication (uint8 Fr_CtrlIdx);
Invokes the CC CHI command 'FREEZE'.
Die synchrone Funktion Fr_AbortCommunication bricht die laufende Kommunikation ab, indem sie das Controller-Host-Interface-Kommando (CHI-Kommando) FREEZE am angegebenen FlexRay-Kommunikationscontroller (CC) ausführt [SWS_Fr_00011].
Aufruf und Parameter
Der Aufruf erfolgt über den Header Fr.h unter Angabe des Controller-Indexes Fr_CtrlIdx, welcher den Ziel-FlexRay-CC im Kontext des FlexRay-Treibers eindeutig identifiziert [SWS_Fr_00011]. Ein- und Ausgabeparameter existieren darüber hinaus nicht.
Rückgabewerte und Fehlerbehandlung
Die Funktion liefert einen Status vom Typ Std_ReturnType zurück [SWS_Fr_00011]:
E_OK: Der API-Aufruf wurde erfolgreich abgeschlossen [SWS_Fr_00011].E_NOT_OK: Der API-Aufruf wurde aufgrund von Fehlern abgebrochen [SWS_Fr_00011].
Nebenläufigkeit und Einschränkungen
Hinsichtlich des Nebenläufigkeitsverhaltens ist Fr_AbortCommunication als nicht reentrant für denselben Kommunikationscontroller spezifiziert (Non Reentrant for the same device) [SWS_Fr_00011]. Parallele Aufrufe für dieselbe Controller-Instanz müssen vom Aufrufer vermieden werden.
Dieser Text wurde von einer KI basierend auf der Spezifikation AUTOSAR R20-11 generiert.
function Fr_SendWUP [SWS_Fr_00009] 📄 PDF
Std_ReturnType Fr_SendWUP (uint8 Fr_CtrlIdx);
Invokes the CC CHI command 'WAKEUP'.
Verwendung und Semantik
Die Funktion Fr_SendWUP dient dem Veranlassen eines Wakeup-Vorgangs auf dem FlexRay-Bus durch Absetzen des CHI-Kommandos WAKEUP an den Kommunikationscontroller [SWS_Fr_00009]. Über den Parameter Fr_CtrlIdx wird der Index des Ziel-Controllers im Treiberkontext übergeben [SWS_Fr_00009]. Der Aufruf erfolgt asynchron; die Schnittstelle stößt den Befehl an, während die Übertragung des Wakeup-Musters anschließend hardwareseitig durchgeführt wird [SWS_Fr_00009]. Die Deklaration ist über Fr.h verfügbar und der Service besitzt die Service-ID 0x06 [SWS_Fr_00009].
Fehlerbehandlung und Rückgabewerte
Die Funktion liefert einen Statuswert vom Typ Std_ReturnType zurück [SWS_Fr_00009]:
E_OK: Der API-Aufruf wurde erfolgreich ausgeführt und das CHI-Kommando abgesetzt [SWS_Fr_00009].E_NOT_OK: Der API-Aufruf wurde aufgrund aufgetretener Fehler abgebrochen [SWS_Fr_00009].
Nebenläufigkeit und Einschränkungen
Die Funktion ist als nicht reentrant für dasselbe Gerät spezifiziert (Non Reentrant for the same device) [SWS_Fr_00009]. Interpretation: Dies dürfte bedeuten, dass übergeordnete Module gleichzeitige Aufrufe für dieselbe Controller-Instanz synchronisieren müssen, während Aufrufe für verschiedene Controller-Instanzen nebenläufig ausgeführt werden dürfen. Frage Q-0e3b4e70a0755877 (offen) Weder Ein-/Ausgangs- noch reine Ausgabeparameter sind definiert [SWS_Fr_00009].
Dieser Text wurde durch eine KI auf Basis der AUTOSAR-Spezifikation R20-11 generiert.
function Fr_SetWakeupChannel [SWS_Fr_00091] 📄 PDF
Std_ReturnType Fr_SetWakeupChannel (uint8 Fr_CtrlIdx, Fr_ChannelType Fr_ChnlIdx);
Sets a wakeup channel.
function Fr_GetPOCStatus [SWS_Fr_00012] 📄 PDF
Std_ReturnType Fr_GetPOCStatus (uint8 Fr_CtrlIdx, Fr_POCStatusType* Fr_POCStatusPtr);
Gets the POC status.
function Fr_TransmitTxLPdu [SWS_Fr_00092] 📄 PDF
Std_ReturnType Fr_TransmitTxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, const uint8* Fr_LSduPtr, uint8 Fr_LSduLength, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);
Transmits data on the Flex Ray network.
Die Funktion Fr_TransmitTxLPdu dient der Übertragung von Nutzdaten über das FlexRay-Netzwerk [SWS_Fr_00092]. Sie verarbeitet den Sendeauftrag mit asynchroner Semantik und ordnet die zu übertragende LSdu dem durch Fr_LPduIdx identifizierten FlexRay-Frame zu [SWS_Fr_00092].
Verwendung und Parameter
Der Aufruf erfolgt über die Header-Datei Fr.h (Service-ID 0x0b) unter Angabe des Controller-Index Fr_CtrlIdx für den FlexRay Communication Controller sowie des eindeutigen Frame-Index Fr_LPduIdx [SWS_Fr_00092]. Über den Zeiger Fr_LSduPtr wird die im Puffer bereitgestellte Sende-LSdu übergeben, deren Datenlänge in Bytes über Fr_LSduLength spezifiziert wird [SWS_Fr_00092]. Über den Ausgabeparameter Fr_SlotAssignmentPtr kann der Aufrufer den tatsächlichen Sendezyklus, die Slot-ID sowie den FlexRay-Kanal abfragen; wird diese Information nicht benötigt, kann hierfür ein NULL_PTR übergeben werden [SWS_Fr_00092].
Rückgabewerte und Fehlerbehandlung
Die Funktion quittiert den Aufruf mit dem Rückgabetyp Std_ReturnType: Der Rückgabewert E_OK bestätigt den erfolgreichen Abschluss des API-Aufrufs, während E_NOT_OK einen Abbruch aufgrund von Fehlern signalisiert [SWS_Fr_00092]. Spezifische DET- oder DEM-Meldungen sind in den Spezifikationsdaten nicht enthalten.
Nebenläufigkeit
Hinsichtlich der Nebenläufigkeit ist Fr_TransmitTxLPdu als nicht reentrant für dasselbe Gerät (Non Reentrant for the same device) spezifiziert [SWS_Fr_00092]. Parallele Sendeaufrufe für denselben FlexRay-Controller sind daher unzulässig.
Dieser Text wurde von einer KI erstellt und basiert ausschließlich auf den Spezifikationsdaten aus AUTOSAR R20-11.
function Fr_CancelTxLPdu [SWS_Fr_00610] 📄 PDF
Std_ReturnType Fr_CancelTxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);
Cancels the already pending transmission of a LPdu contained in a controllers p hysical transmit resource (e.g. message buffer).
Verwendung und Semantik
Die synchrone Funktion Fr_CancelTxLPdu bricht die bereits anstehende Übertragung einer L-PDU ab, welche sich in einer physischen Sende-Ressource des Controllers (z. B. einem Sendepuffer) befindet [SWS_Fr_00610]. Die Funktion ist im Header Fr.h deklariert und besitzt die Service-ID 0x2d [SWS_Fr_00610].
Zur Identifikation der abzubrechenden Übertragung erwartet die Schnittstelle zwei Parameter [SWS_Fr_00610]:
Fr_CtrlIdx: Index des FlexRay-Communication-Controllers im Kontext des FlexRay-Treibers [SWS_Fr_00610].Fr_LPduIdx: Eindeutiger Index zur Identifikation des jeweiligen FlexRay-Frames [SWS_Fr_00610].
Rückgabewerte und Fehlerbehandlung
Der Funktionsaufruf liefert einen Statuswert vom Typ Std_ReturnType zurück [SWS_Fr_00610]:
E_OK: Der API-Aufruf wurde erfolgreich abgeschlossen [SWS_Fr_00610].E_NOT_OK: Der Aufruf wurde aufgrund von Fehlern abgebrochen [SWS_Fr_00610].
Spezifische Fehlercodes, DET- oder DEM-Einträge sind für diese Funktion nicht dokumentiert; bei einem aufgetretenen Fehler signalisiert die Funktion diesen ausschließlich über den Rückgabewert E_NOT_OK [SWS_Fr_00610].
Nebenläufigkeit und Einschränkungen
Hinsichtlich des Nebenläufigkeitsverhaltens ist Fr_CancelTxLPdu als nicht reentrant für dasselbe Gerät (Non Reentrant for the same device) spezifiziert [SWS_Fr_00610]. Dies bedeutet vermutlich, dass parallele Aufrufe für dieselbe Controller-Instanz auf Aufruferebene synchronisiert werden müssen. Frage Q-ec480944eec04076 (offen) Weitere Ein- oder Ausgabeparameter sind nicht vorhanden [SWS_Fr_00610].
Dieser Nutzungshinweis wurde automatisiert auf Basis des AUTOSAR-R20-11-Spezifikationsstands generiert.
function Fr_ReceiveRxLPdu [SWS_Fr_00093] 📄 PDF
Std_ReturnType Fr_ReceiveRxLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, uint8* Fr_LSduPtr, Fr_RxLPduStatusType* Fr_LPduStatusPtr, uint8* Fr_LSduLengthPtr, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);
Service Fr_ReceiveRxLPdu.
Die synchrone Funktion Fr_ReceiveRxLPdu dient dem Empfang von Nutzdaten aus dem FlexRay-Netzwerk und steht über den Header Fr.h zur Verfügung [SWS_Fr_00093].
Parameter und Verwendung
Über die Eingangsparameter Fr_CtrlIdx und Fr_LPduIdx werden der jeweilige Kommunikationscontroller des FlexRay-Treibers sowie der zu empfangende FlexRay-Frame eindeutig adressiert [SWS_Fr_00093]. Die Nutz- und Zustandsdaten werden über mehrere Zeiger an den Aufrufer übergeben:
Fr_LSduPtr: Zeiger auf den Puffer, in dem die empfangene L-SDU gespeichert werden soll.Fr_LPduStatusPtr: Zeiger auf den Speicherort für den Empfangsstatus der L-PDU.Fr_LSduLengthPtr: Speicherort für die Länge der empfangenen L-SDU in Bytes, entsprechend der Anzahl der inFr_LSduPtrkopierten Bytes.Fr_SlotAssignmentPtr: Speicherort für Zyklus, Slot-ID und Kanal des Frames. Wird hierfür einNULL_PTRübergeben, signalisiert dies, dass der Aufrufer diese Zuweisungsinformationen nicht benötigt.
Nebenläufigkeit und Fehlerbehandlung
Die Schnittstelle wird synchron ausgeführt, ist jedoch für dasselbe Gerät nicht reentrant [SWS_Fr_00093]. Ein erfolgreicher Empfangsvorgang wird mit E_OK quittiert, während bei aufgetretenen Fehlern der Aufruf abgebrochen und E_NOT_OK zurückgegeben wird [SWS_Fr_00093]. Spezifische DET- oder DEM-Fehlercodes sind in den Spezifikationsdaten der Funktion nicht ausgewiesen.
Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation erstellt.
Implementer's Guide folgt (Komplexität I1)
function Fr_CheckTxLPduStatus [SWS_Fr_00094] 📄 PDF
Std_ReturnType* Fr_CheckTxLPduStatus (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, Fr_TxLPduStatusType* Fr_TxLPduStatusPtr, Fr_SlotAssignmentType* Fr_SlotAssignmentPtr);
Checks the transmit status of the LSdu.
Die synchrone Schnittstelle Fr_CheckTxLPduStatus (Service-ID 0x0d) dient gemäß [SWS_Fr_00094] der Überprüfung des aktuellen Sendestatus einer L-SDU bzw. eines FlexRay-Frames im FlexRay-Treiber. Sie wird über den Header Fr.h bereitgestellt.
Als Eingangsparameter verlangt die Funktion den Index des FlexRay-Kommunikationscontrollers (Fr_CtrlIdx) sowie den Index Fr_LPduIdx, welcher den zu prüfenden FlexRay-Frame im Treiber eindeutig identifiziert [SWS_Fr_00094]. Der ermittelte Sendestatus der LPdu wird über den Ausgabeparameter Fr_TxLPduStatusPtr an die übergebene Speicheradresse zurückgeschrieben [SWS_Fr_00094].
Zusätzlich ermöglicht der Ausgabeparameter Fr_SlotAssignmentPtr die Ermittlung der Slot-Zuweisung: Er verweist auf eine Speicherstelle, an der der tatsächliche Zyklus, die Slot-ID sowie der Kanal des adressierten Frames abgelegt werden [SWS_Fr_00094]. Benötigt der Aufrufer diese Zuordnungsinformationen nicht, signalisiert die Übergabe eines NULL_PTR, dass diese Daten nicht bereitgestellt werden müssen [SWS_Fr_00094].
Die Schnittstelle ist synchron auszuführen und für dasselbe Gerät als nicht reentrant (Non Reentrant for the same device) spezifiziert [SWS_Fr_00094]. Bei erfolgreichem Abschluss liefert der Aufruf den Rückgabewert E_OK; im Fall aufgetretener Fehler bricht die Funktion ab und gibt E_NOT_OK zurück [SWS_Fr_00094].
Dieser Text wurde von einer KI generiert und basiert auf der Spezifikation AUTOSAR CP R20-11.
Implementer's Guide folgt (Komplexität I1)
function Fr_PrepareLPdu [SWS_Fr_00107] 📄 PDF
Std_ReturnType Fr_PrepareLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);
Prepares a LPdu.
Verwendung und Semantik
Die synchrone Funktion Fr_PrepareLPdu dient gemäß [SWS_Fr_00107] der Vorbereitung einer L-PDU (Prepares a LPdu) und wird über den Header Fr.h bereitgestellt. Als Eingangsparameter erwartet der Dienst den Controller-Index Fr_CtrlIdx zur Adressierung des FlexRay Communication Controllers (CC) im Treiberkontext sowie Fr_LPduIdx zur eindeutigen Identifikation des zugehörigen FlexRay-Frames [SWS_Fr_00107]. Interpretation: Der Aufruf dürfte hardwarespezifische Pufferstrukturen für den anschließenden Sende- oder Empfangsvorgang des Frames initialisieren oder scharfschalten. Frage Q-c4375099d73dbea2 (offen)
Nebenläufigkeit und Einschränkungen
Hinsichtlich des Nebenläufigkeitsverhaltens ist Fr_PrepareLPdu als nicht reentrant für dieselbe Hardware-Einheit (Non Reentrant for the same device) spezifiziert [SWS_Fr_00107]. Ein paralleler oder unterbrechender Aufruf für denselben Controller-Index Fr_CtrlIdx ist daher durch den Aufrufer zwingend zu vermeiden.
Rückgabewerte und Fehlerbehandlung
Die Funktion besitzt die Service-ID 0x1f und meldet ihren Status über den Rückgabetyp Std_ReturnType zurück [SWS_Fr_00107]:
E_OK: Der API-Aufruf wurde erfolgreich beendet [SWS_Fr_00107].E_NOT_OK: Der API-Aufruf wurde aufgrund aufgetretener Fehler vorzeitig abgebrochen [SWS_Fr_00107]. Spezifische DET- oder DEM-Fehlercodes werden im vorliegenden Spezifikationsauszug nicht definiert.
Dieser Text wurde von einer KI auf Basis der Spezifikation AUTOSAR CP R20-11 generiert.
function Fr_ReconfigLPdu [SWS_Fr_00524] 📄 PDF
Std_ReturnType Fr_ReconfigLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx, uint16 Fr_FrameId, Fr_ChannelType Fr_ChnlIdx, uint8 Fr_CycleRepetition, uint8 Fr_CycleOffset, uint8 Fr_PayloadLength, uint16 Fr_Header CRC); ⚠️
Service Fr_ReconfigLPdu.
Verwendung und Parameter
Die synchrone Funktion Fr_ReconfigLPdu ermöglicht die dynamische Rekonfiguration einer FlexRay-LPDU zur Laufzeit [SWS_Fr_00524]. Bereitgestellt über den Header Fr.h, adressiert der Aufruf über Fr_CtrlIdx den jeweiligen FlexRay-Controller und über Fr_LPduIdx den eindeutigen Bezeichner des Frames AUTOSAR_SWS_FlexRayDriver S. 65.
Folgende Zielparameter werden bei der Rekonfiguration übergeben [SWS_Fr_00524]:
Fr_FrameIdundFr_ChnlIdx: Festlegung der neuen Frame-ID sowie des Kommunikationskanals.Fr_CycleRepetitionundFr_CycleOffset: Konfiguration der Zyklusfilterung für die LPDU.Fr_PayloadLengthundFr_HeaderCRC: Nutzdatenlänge in Byte sowie die zugehörige Header-CRC des Frames.
Nebenläufigkeit und Rückgabewerte
Der Dienst ist für denselben Controller nicht reentrant (Non Reentrant for the same device) [SWS_Fr_00524]. Bei Aufrufen für unterschiedliche FlexRay-Controller-Instanzen dürfte Reentranz hingegen gegeben sein (Interpretation). Frage Q-85908ef4796c80c7 (offen) Bei erfolgreicher Neukonfiguration liefert der Aufruf E_OK zurück; schlägt die Rekonfiguration aufgrund von Fehlern fehl, wird E_NOT_OK zurückgegeben AUTOSAR_SWS_FlexRayDriver S. 65.
Dieser Text wurde von einer KI erstellt; die Richtigkeit kann nicht garantiert werden.
function Fr_DisableLPdu [SWS_Fr_00539] 📄 PDF
Std_ReturnType Fr_DisableLPdu (uint8 Fr_CtrlIdx, uint16 Fr_LPduIdx);
Disables the hardware resource of a LPdu for transmission/ reception.
Verwendung
Die synchrone Treiberfunktion Fr_DisableLPdu dient dazu, die Hardware-Ressource einer FlexRay-LPdu für das Senden oder Empfangen zu deaktivieren ([SWS_Fr_00539]). Die Schnittstelle wird über die Header-Datei Fr.h bereitgestellt und ist der Service-ID 0x26 zugeordnet ([SWS_Fr_00539]).
Für den Funktionsaufruf sind zwei Pflichtparameter zu übergeben ([SWS_Fr_00539]):
Fr_CtrlIdx: Der Index des FlexRay-Communication-Controllers innerhalb des Treiberkontexts.Fr_LPduIdx: Der eindeutige Index zur Identifikation des jeweiligen FlexRay-Frames bzw. der LPdu.
Als Rückgabewert liefert die Funktion den Status Std_ReturnType ([SWS_Fr_00539]). Der Wert E_OK signalisiert einen erfolgreich beendeten Aufruf, während E_NOT_OK zurückgegeben wird, falls der Aufruf fehlerbedingt abgebrochen wurde.
Fehlerbehandlung
In der vorliegenden Spezifikation sind keine spezifischen Fehlercodes sowie keine Meldungen an DET oder DEM für diesen Dienst definiert; das Fehlverhalten äußert sich unmittelbar im Rückgabewert E_NOT_OK ([SWS_Fr_00539]).
Nebenläufigkeit und Einschränkungen
Hinsichtlich der Reentranz ist Fr_DisableLPdu als nicht reentrant für dasselbe Gerät eingestuft (Non Reentrant for the same device) ([SWS_Fr_00539]). Aufrufer müssen daher sicherstellen, dass gleichzeitige Aufrufe für denselben Controller synchronisiert werden.
Dieser Text wurde von einer KI auf Basis der Spezifikation AUTOSAR CP R20-11 generiert.
function Fr_GetGlobalTime [SWS_Fr_00042] 📄 PDF
Std_ReturnType Fr_GetGlobalTime (uint8 Fr_CtrlIdx, uint8* Fr_CyclePtr, uint16* Fr_MacroTickPtr);
Gets the current global Flex Ray time. Important Note: Fr_ Get Global Time may be called within an exclusive area.
function Fr_GetNmVector [SWS_Fr_00113] 📄 PDF
Std_ReturnType Fr_GetNmVector (uint8 Fr_CtrlIdx, uint8* Fr_NmVectorPtr);
Gets the network management vector of the last communication cycle.
function Fr_GetNumStartupFrames [SWS_Fr_00547] 📄 PDF
Std_ReturnType Fr_GetNumOfStartupFrames (uint8 Fr_CtrlIdx, uint8* Fr_NumOfStartupFramesPtr);
Gets the current number of startup frames seen on the cluster. See variable v Startup Pairs of [12] for details.
function Fr_GetChannelStatus [SWS_Fr_00556] 📄 PDF
Std_ReturnType Fr_GetChannelStatus (uint8 Fr_CtrlIdx, uint16* Fr_ChannelAStatusPtr, uint16* Fr_ChannelBStatusPtr);
Gets the channe l status information. Specification of FlexRay Driver AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_FlexRayDriver
function Fr_GetClockCorrection [SWS_Fr_00564] 📄 PDF
Std_ReturnType Fr_GetClockCorrection (uint8 Fr_CtrlIdx, sint16* Fr_RateCorrectionPtr, sint32* Fr_OffsetCorrectionPtr);
Gets the current clock correction values. See variables v Interim Rate Correction and v Interim Offset Correction of [12] for details.
function Fr_GetSyncFrameList [SWS_Fr_00573] 📄 PDF
Std_ReturnType Fr_GetSyncFrameList (uint8 Fr_CtrlIdx, uint8 Fr_ListSize, uint16* Fr_ChannelAEvenListPtr, uint16* Fr_ChannelBEvenListPtr, uint16* Fr_ChannelAOddListPtr, uint16* Fr_ChannelBOddListPtr);
Service Fr_GetSyncFrameList.
function Fr_GetWakeupRxStatus [SWS_Fr_00587] 📄 PDF
Std_ReturnType Fr_GetWakeupRxStatus (uint8 Fr_CtrlIdx, uint8* Fr_WakeupRxStatusPtr);
Gets the wakeup received information from the Flex Ray controller.
function Fr_SetAbsoluteTimer [SWS_Fr_00033] 📄 PDF
Std_ReturnType Fr_SetAbsoluteTimer (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx, uint8 Fr_Cycle, uint16 Fr_Offset);
Sets the absolute Flex Ray timer.
function Fr_CancelAbsoluteTimer [SWS_Fr_00095] 📄 PDF
Std_ReturnType Fr_CancelAbsoluteTimer (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);
Stops an absolute timer.
Die synchrone Funktion Fr_CancelAbsoluteTimer dient dem geordneten Anhalten eines aktiven absoluten Timers auf einem FlexRay-Communication-Controller ([SWS_Fr_00095]). Sie wird über die Header-Datei Fr.h bereitgestellt und besitzt die Service-ID 0x13 ([SWS_Fr_00095]).
Parameter und Rückgabewert
Fr_CtrlIdx: Übergibt den Index des betreffenden FlexRay-Communication-Controllers im Kontext des FlexRay-Treibers ([SWS_Fr_00095]).Fr_AbsTimerIdx: Bestimmt den Index des zu stoppenden absoluten Timers im Kontext des gewählten FlexRay-Controllers ([SWS_Fr_00095]).- Rückgabewert: Liefert über den Typ
Std_ReturnTypeden StatusE_OKbei erfolgreicher Ausführung oderE_NOT_OK, falls der Aufruf aufgrund von Fehlern abgebrochen wurde ([SWS_Fr_00095]).
Nebenläufigkeit und Einschränkungen
Hinsichtlich der Nebenläufigkeit ist die Schnittstelle für dasselbe Gerät als nicht reentrant definiert („Non Reentrant for the same device“) ([SWS_Fr_00095]). Aufrufende Schichten müssen sicherstellen, dass keine konkurrierenden oder unterbrechenden Zugriffe für denselben Controller erfolgen. Interpretation: Bei unterschiedlichen Controllern dürfte die Ausführung hingegen reentrant zulässig sein. Frage Q-01203b0b28193021 (offen)
Dieser Verwendungshinweis wurde automatisiert auf Basis der Spezifikation von AUTOSAR R20-11 erstellt.
function Fr_EnableAbsoluteTimerIRQ [SWS_Fr_00034] 📄 PDF
Std_ReturnType Fr_EnableAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);
Service Fr_EnableAbsoluteTimerIRQ.
Die synchrone Funktion Fr_EnableAbsoluteTimerIRQ dient der Aktivierung der Interrupt-Leitung eines absoluten Timers innerhalb eines FlexRay-Communication-Controllers [SWS_Fr_00034]. Der Dienst wird über die Header-Datei Fr.h bereitgestellt und besitzt die Service-ID 0x15 [SWS_Fr_00034].
Beim Aufruf erwartet die Schnittstelle zwei Eingangsparameter [SWS_Fr_00034]:
Fr_CtrlIdx: Index des FlexRay-Communication-Controllers im Kontext des FlexRay-Treibers [SWS_Fr_00034].Fr_AbsTimerIdx: Index des absoluten Timers im Kontext des adressierten FlexRay-Controllers [SWS_Fr_00034].
Der Rückgabewert vom Typ Std_ReturnType signalisiert das Ergebnis der Ausführung [SWS_Fr_00034]:
E_OK: Der API-Aufruf wurde erfolgreich abgeschlossen [SWS_Fr_00034].E_NOT_OK: Der Funktionsaufruf wurde aufgrund von Fehlern abgebrochen [SWS_Fr_00034].
In Bezug auf die Nebenläufigkeit ist die Funktion als nicht reentrant für dasselbe Gerät („Non Reentrant for the same device“) spezifiziert [SWS_Fr_00034]. Dies erfordert, dass gleichzeitige Aufrufe für dieselbe Controller-Instanz zwingend vermieden werden müssen; vermutlich ist ein paralleler Aufruf für unterschiedliche Controller-Instanzen jedoch zulässig. Frage Q-d7e594a84357e129 (offen) Spezifische Fehlercodes für Entwicklungs- oder Produktionsfehler (DET/DEM) werden in der Funktionsbeschreibung nicht aufgeführt; aufgetretene Fehler führen unmittelbar zur Rückgabe von E_NOT_OK [SWS_Fr_00034].
Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation SWS_Fr_00034 generiert.
function Fr_AckAbsoluteTimerIRQ [SWS_Fr_00036] 📄 PDF
Std_ReturnType Fr_AckAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);
Service Fr_AckAbsoluteTimerIRQ.
Die synchrone Funktion Fr_AckAbsoluteTimerIRQ gehört zum Modul des FlexRay-Treibers (Fr) in der AUTOSAR-Classic-Plattform und dient dem Zurücksetzen der Interrupt-Bedingung eines absoluten Timers [SWS_Fr_00036]. Die Deklaration der Schnittstelle wird über die Header-Datei Fr.h bereitgestellt und ist der hexadezimalen Service-ID 0x17 zugeordnet [SWS_Fr_00036].
Zur eindeutigen Adressierung des Timers erwartet die Funktion zwei Eingangsparameter vom Typ uint8, während keine Ein-/Ausgabe- oder reinen Ausgabeparameter vorhanden sind [SWS_Fr_00036]:
Fr_CtrlIdx: Übergibt den Index des FlexRay-Communication-Controllers (CC) innerhalb des Kontexts des FlexRay-Treibers [SWS_Fr_00036].Fr_AbsTimerIdx: Bezeichnet den Index des absoluten Timers innerhalb des Kontexts des jeweiligen FlexRay-Communication-Controllers [SWS_Fr_00036].
Das Ergebnis der Funktionsausführung wird über den Statuswert vom Typ Std_ReturnType zurückgemeldet. Wurde der Aufruf erfolgreich beendet, gibt die Funktion E_OK zurück [SWS_Fr_00036]. Treten während der Ausführung Fehler auf, bricht der Funktionsaufruf vorzeitig ab und liefert stattdessen E_NOT_OK [SWS_Fr_00036].
Hinsichtlich des Nebenläufigkeitsverhaltens ist der Dienst als nicht reentrant für dasselbe Gerät eingestuft (Non Reentrant for the same device) [SWS_Fr_00036]. Aufrufe für dieselbe Controller-Instanz müssen daher synchron erfolgen und dürfen nicht nebenläufig überlappend ausgeführt werden [SWS_Fr_00036].
Dieser Nutzungshinweis basiert auf der Spezifikation SWS_Fr_00036 des FlexRay-Treibers und wurde automatisiert erstellt.
function Fr_DisableAbsoluteTimerIRQ [SWS_Fr_00035] 📄 PDF
Std_ReturnType Fr_DisableAbsoluteTimerIRQ (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx);
Disables the in terrupt line of an absolute timer.
Die synchrone Funktion Fr_DisableAbsoluteTimerIRQ dient im FlexRay-Treiber dazu, die Interrupt-Leitung eines absoluten Timers gezielt zu deaktivieren [SWS_Fr_00035]. Als Eingabeparameter erwartet die Schnittstelle den Controller-Index Fr_CtrlIdx zur Adressierung des jeweiligen FlexRay-Kommunikationscontrollers (CC) im Treiberkontext sowie Fr_AbsTimerIdx zur Identifikation des absoluten Timers innerhalb dieses Controllers [SWS_Fr_00035]. Die Deklaration der Funktion wird über die Header-Datei Fr.h zur Verfügung gestellt [SWS_Fr_00035].
Das Ergebnis der Ausführung wird synchron über den Rückgabetyp Std_ReturnType an den Aufrufer übermittelt [SWS_Fr_00035]. Konnte der Dienst ordnungsgemäß und erfolgreich beendet werden, liefert er E_OK zurück [SWS_Fr_00035]. Kommt es hingegen während der Abarbeitung zu Fehlern, bricht die Funktion den Vorgang ab und signalisiert dies durch den Rückgabewert E_NOT_OK [SWS_Fr_00035]. Konkrete Entwicklungs- oder Laufzeitfehler (DET/DEM) sind im Spezifikationselement nicht ausgewiesen, sodass Fehlerzustände primär anhand des Rückgabewerts erkannt und behandelt werden müssen [SWS_Fr_00035].
Bezüglich der Nebenläufigkeit ist Fr_DisableAbsoluteTimerIRQ als nicht reentrant für dasselbe Gerät (same device) definiert [SWS_Fr_00035]. Daher dürfen mehrere Aufrufe für denselben Controller-Index nicht nebenläufig erfolgen und müssen aufruferseitig synchronisiert werden, während der parallele Zugriff auf unterschiedliche Controller zulässig ist [SWS_Fr_00035].
Dieser Nutzungshinweis wurde automatisiert anhand der AUTOSAR-R20-11-Spezifikation generiert.
function Fr_GetAbsoluteTimerIRQStatus [SWS_Fr_00108] 📄 PDF
Std_ReturnType Fr_GetAbsoluteTimerIRQStatus (uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx, boolean* Fr_IRQStatusPtr);
Gets IRQ status of an absolute timer.
function Fr_GetVersionInfo [SWS_Fr_00070] 📄 PDF
void Fr_GetVersionInfo (Std_VersionInfoType* VersioninfoPtr);
Returns the version information of this module.
function Fr_ReadCCConfig [SWS_Fr_00651] 📄 PDF
Std_ReturnType Fr_ReadCCConfig (uint8 Fr_CtrlIdx, uint8 Fr_Config ParamIdx, uint32* Fr_Config ParamValuePtr); ⚠️
Service Fr_ReadCCConfig.
Die synchrone Funktion Fr_ReadCCConfig liest einen spezifischen FlexRay-Protokoll-Konfigurationsparameter eines Controllers direkt aus der Modulkonfiguration des FlexRay-Treibers aus [SWS_Fr_00651]. Die Schnittstelle wird über den Header Fr.h deklariert und besitzt die Service-ID 0x2e [SWS_Fr_00651].
Parameter und Rückgabewerte
Fr_CtrlIdx: Bestimmt den Index des betroffenen FlexRay-Communication-Controllers im Treiberkontext [SWS_Fr_00651].Fr_ConfigParamIdx: Identifiziert den auszulesenden Parameter über definierte Makros des FormatsFR_CIDX_<config_parameter_name>[SWS_Fr_00651].Fr_ConfigParamValuePtr: Zeiger auf die Speicheradresse vom Typuint32, an welche der ausgelesene Wert geschrieben wird [SWS_Fr_00651].- Rückgabewert: Liefert
E_OKbei erfolgreicher Ausführung oderE_NOT_OKim Fehlerfall [SWS_Fr_00651].
Nebenläufigkeit und Fehlerverhalten
Die Funktion ist für denselben Controller nicht reentrant ausgelegt („Non Reentrant for the same device“) [SWS_Fr_00651]. Zeitgleiche Aufrufe für unterschiedliche Controller-Instanzen dürften demnach zulässig sein. Frage Q-b5e4172654514747 (offen) Spezifische DET- oder DEM-Fehler werden in der Schnittstellendefinition nicht benannt; Fehlerzustände führen zum Abbruch mit Rückgabe von E_NOT_OK [SWS_Fr_00651]. Der Aufrufer hat vermutlich sicherzustellen, dass Fr_ConfigParamValuePtr auf einen gültigen Speicherbereich verweist.
Dieser Text wurde von einer KI auf Basis der AUTOSAR-Spezifikation R20-11 generiert.
type Fr_ConfigType [SWS_Fr_91001] 📄 PDF
This type contains the implementation - specific post build configuration structure.
type Fr_SlotModeType [SWS_Fr_00506] 📄 PDF
This formal definition refers to the description of type T_ Slot Mode in chapter 2.2.1.3 POC status of [12]. Available Fr_ General Types.h For FlexRay 2.1 Rev A compliant FlexRay controllers see literal SINGL ESLOT instead of KEYSLOT in [14] . Specification of FlexRay Driver AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_FlexRayDriver via
Der Aufzählungstyp Fr_SlotModeType ist Teil der Schnittstellendefinition des FlexRay-Treibers in AUTOSAR Classic und wird über den Header Fr_GeneralTypes.h bereitgestellt [SWS_Fr_00506]. Die Typdefinition verweist formal auf den Typ T_SlotMode aus der FlexRay-Protokollspezifikation, wo dieser im Kapitel zum Protocol Operation Control (POC-Status) beschrieben ist [SWS_Fr_00506].
Die Enumeration spezifiziert den Zustand der Slot-Verarbeitung des Controllers anhand von drei fest definierten Werten [SWS_Fr_00506]:
FR_SLOTMODE_KEYSLOT(Wert0x00): Bildet das LiteralKEYSLOTder formalen TypdefinitionT_SlotModeab [SWS_Fr_00506].FR_SLOTMODE_ALL_PENDING(Wert0x01): Bildet das LiteralALL_PENDINGder formalen TypdefinitionT_SlotModeab [SWS_Fr_00506].FR_SLOTMODE_ALL(Wert0x02): Bildet das LiteralALLder formalen TypdefinitionT_SlotModeab [SWS_Fr_00506].
Bei der Verwendung mit Controllern, die zum älteren Standard FlexRay 2.1 Rev A konform sind, ist eine abweichende Benennung zu berücksichtigen: Anstelle des Literals KEYSLOT tritt hier das Literal SINGLESLOT auf [SWS_Fr_00506]. Interpretation: Auf Treiber- und Software-Ebene dürfte der Typ zur Bestimmung dienen, ob der FlexRay-Controller aktuell nur Schlüssel-Slots (Key Slots) oder alle Slots für die Übertragung freigegeben hat bzw. ein entsprechender Wechsel ansteht. Frage Q-f926c41c8a5d3380 (offen)
Dieser Text wurde von einer KI auf Basis der AUTOSAR-Spezifikation R20-11 generiert.
Implementer's Guide folgt (Komplexität I1)
type Fr_ErrorModeType [SWS_Fr_00507] 📄 PDF
This formal definition refers to the description of type T_ Error Mode in chapter 2.2.1.3 POC status of [12].
Verwendung
Der Aufzählungstyp Fr_ErrorModeType bildet die Fehlermodi des FlexRay-Protocol-Operation-Control (POC) ab und wird über die Header-Datei Fr_GeneralTypes.h bereitgestellt [SWS_Fr_00507]. Die Enumeration definiert die Zustände des Fehlerüberwachungsmechanismus des Kommunikations-Controllers und verweist auf die formale Typdefinition T_ErrorMode im FlexRay-POC-Status [SWS_Fr_00507].
Der Wertebereich umfasst gemäß [SWS_Fr_00507] drei Zustände:
FR_ERRORMODE_ACTIVE(0x00): Repräsentiert das LiteralACTIVEder formalen TypdefinitionT_ErrorModeund kennzeichnet den fehlerfreien Zustand bzw. Normalbetrieb des Kommunikations-Controllers.FR_ERRORMODE_PASSIVE(0x01): Entspricht dem LiteralPASSIVEder formalen TypdefinitionT_ErrorMode, bei dem Fehler am Bus registriert wurden und die Kommunikation eingeschränkt sein kann.FR_ERRORMODE_COMM_HALT(0x02): Bildet das LiteralCOMM_HALTder formalen TypdefinitionT_ErrorModeab, wenn die Buskommunikation aufgrund schwerwiegender Fehlerzustände gestoppt wurde.
Integration und Randbedingungen
Interpretation: Der Typ dürfte vor allem als Rückgabewert oder Statusparameter in Abfragefunktionen des FlexRay-Treibers dienen, um übergeordneten Softwareschichten den Zustand des Controllers zu übermitteln. Frage Q-e4d6ae534d1dfa2c (offen) Da [SWS_Fr_00507] ausschließlich die Datenstruktur spezifiziert, existieren auf Typebene keine eigenständigen Fehlerbehandlungen über DET oder DEM sowie keine direkten Anforderungen an die Reentranz oder Nebenläufigkeit.
Dieser Text wurde von einer KI auf Basis der AUTOSAR-Spezifikation R20-11 generiert.
Implementer's Guide folgt (Komplexität I1)
type Fr_WakeupStatusType [SWS_Fr_00508] 📄 PDF
This formal definition refers to the description of type T_ Wakeup Status in chapter Specification of FlexRay Driver AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_FlexRayDriver 2.2.1.3 POC status of [12].
Der Aufzählungstyp Fr_WakeupStatusType wird über die Header-Datei Fr_GeneralTypes.h bereitgestellt und bildet den Wakeup-Status des FlexRay-Treibers gemäß der formalen Definition T_WakeupStatus aus dem POC-Status ab [SWS_Fr_00508].
Verwendung und Wertebereich
Der Typ repräsentiert die verschiedenen Zustände und Ereignisse während eines FlexRay-Aufwachvorgangs und umfasst sieben spezifische Enumerationswerte [SWS_Fr_00508]:
FR_WAKEUP_UNDEFINED(0x00): Entspricht dem LiteralUNDEFINEDder formalen Typdefinition [SWS_Fr_00508].FR_WAKEUP_RECEIVED_HEADER(0x01): Kennzeichnet den Empfang eines Wakeup-Headers (LiteralRECEIVED_HEADER) [SWS_Fr_00508].FR_WAKEUP_RECEIVED_WUP(0x02): Repräsentiert das empfangene Wakeup-Pattern (LiteralRECEIVED_WUP) [SWS_Fr_00508].FR_WAKEUP_COLLISION_HEADER(0x03): Zeigt eine Kollision bei einem empfangenen Header an (LiteralCOLLISION_HEADER) [SWS_Fr_00508].FR_WAKEUP_COLLISION_WUP(0x04): Signalisiert eine Kollision während eines Wakeup-Patterns (LiteralCOLLISION_WUP) [SWS_Fr_00508].FR_WAKEUP_COLLISION_UNKNOWN(0x05): Beschreibt eine Kollision mit unbekannter Ursache (LiteralCOLLISION_UNKNOWN) [SWS_Fr_00508].FR_WAKEUP_TRANSMITTED(0x06): Bestätigt das erfolgreiche Senden des Wakeup-Signals (LiteralTRANSMITTED) [SWS_Fr_00508].
Zusammenspiel und Einschränkungen
Interpretation: Der Typ dürfte primär als Statusparameter von Treiberfunktionen dienen, um übergeordneten Modulen eine präzise Diagnose des Kanal- und Aufwachzustands zu ermöglichen. Frage Q-48907418bc3729a1 (offen) Da die Spezifikation keine spezifischen Fehlercodes oder Nebenläufigkeitsbeschränkungen für den Typ selbst definiert, unterliegt die Verwendung den Aufrufkonventionen der jeweils abfragenden API-Funktionen [SWS_Fr_00508].
Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation von AUTOSAR CP R20-11 generiert.
Implementer's Guide folgt (Komplexität I1)
type Fr_StartupStateType [SWS_Fr_00509] 📄 PDF
Type Fr_StartupStateType.
Der Enumerationstyp Fr_StartupStateType wird gemäß [SWS_Fr_00509] über die Header-Datei Fr_GeneralTypes.h bereitgestellt und bildet die Hochlaufzustände des FlexRay-Protokollcontrollers (POC-Status) auf standardisierte Werte ab. Die Definition bezieht sich auf die formale Typdefinition T_StartupState aus Kapitel 2.2.1.3 der Spezifikation.
Der Wertebereich umfasst elf diskrete Zustände, die den Ablauf des Protokoll-Hochlaufs abbilden:
FR_STARTUP_UNDEFINED(0x00): Repräsentiert einen undefinierten Hochlaufzustand.FR_STARTUP_COLDSTART_LISTEN(0x01) bisFR_STARTUP_COLDSTART_GAP(0x09): Repräsentieren die Phasen des Kaltstarts einschließlich Horchphase, Konsistenzprüfung, Kollisionsauflösung und Beitreten (Coldstart Join).FR_STARTUP_INTEGRATION_LISTEN(0x06),FR_STARTUP_INITIALIZE_SCHEDULE(0x07) undFR_STARTUP_INTEGRATION_CONSISTENCY_CHECK(0x08): Repräsentieren Integrations- und Initialisierungsschritte im Zeitplan.FR_STARTUP_EXTERNAL_STARTUP(0x0A): Repräsentiert den extern gesteuerten Hochlauf.
Integrierende Softwaremodule nutzen diesen Typ (Interpretation: primär zur Statusabfrage oder Überwachung des Controller-Hochlaufs). Frage Q-7d07faa6c48d4e58 (offen) Da Fr_StartupStateType eine reine Typdefinition ist, werden keine Fehlercodes oder Fehlermeldungen direkt ausgelöst; Auswerter müssen jedoch beachten, dass Werte außerhalb des Bereichs von 0x00 bis 0x0A nicht spezifiziert sind.
Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe. Verbindlich ist ausschließlich der Text der AUTOSAR-Spezifikation.
Implementer's Guide folgt (Komplexität I1)
type Fr_POCStatusType [SWS_Fr_00510] 📄 PDF
This formal definition refers to the description of type T_ POCStatus in chapter 2.2.1.3 POC status of [12].
Der Datentyp Fr_POCStatusType ist als Datenstruktur spezifiziert und wird über die Header-Datei Fr_GeneralTypes.h bereitgestellt [SWS_Fr_00510]. Die formale Definition verweist auf die Beschreibung des Typs T_POCStatus in Kapitel 2.2.1.3 (POC status) der FlexRay-Protokollspezifikation [SWS_Fr_00510].
Verwendung und Strukturaufbau
Die Struktur aggregiert den aktuellen Betriebs- und Protokollzustand des FlexRay Protocol Operation Control (POC) [SWS_Fr_00510]. Sie setzt sich aus folgenden Elementen zusammen:
State(TypFr_POCStateType) undStartupState(TypFr_StartupStateType) zur Angabe des aktuellen POC-Zustands sowie des Hochlaufstatus [SWS_Fr_00510].ErrorMode(TypFr_ErrorModeType) undFreeze(Typboolean) zur Kennzeichnung des Fehlermodus und eines Controller-Stopps [SWS_Fr_00510].SlotMode(TypFr_SlotModeType) undWakeupStatus(TypFr_WakeupStatusType) für die Slot-Betriebsart und den Aufwachstatus [SWS_Fr_00510].CHIHaltRequest,CHIReadyRequestsowieColdstartNoise(jeweilsboolean) zur Signalisierung von Host-Schnittstellenanforderungen bzw. Leitungsrauschen während des Kaltstarts [SWS_Fr_00510].
Nebenläufigkeit und Integration
Interpretation: Da Fr_POCStatusType eine reine Datenstruktur ohne eigene funktionale Logik ist, dürfte sie primär als Ausgabeparameter bei Statusabfragen der FlexRay-Hardware fungieren. Frage Q-960f2475ff1068fc (offen) Wenn mehrere Tasks oder Software-Schichten auf Instanzen dieser Struktur zugreifen, müssen Aufrufer eigenständig für eine geeignete Synchronisation sorgen, um ein konsistentes Auslesen der zusammenhängenden Teilzustände sicherzustellen [SWS_Fr_00510].
Dieser Nutzungshinweis wurde automatisiert auf Basis des Payloads zu SWS_Fr_00510 generiert.
Implementer's Guide folgt (Komplexität I1)
type Fr_TxLPduStatusType [SWS_Fr_00511] 📄 PDF
These values are used to determine whether a LPdu has been transmitted or not.
Der Aufzählungstyp Fr_TxLPduStatusType dient in der AUTOSAR-Classic-Plattform dazu festzustellen, ob eine FlexRay-LPdu (Link Layer Protocol Data Unit) erfolgreich übertragen wurde oder nicht [SWS_Fr_00511]. Die Typdefinition wird über die Header-Datei Fr_GeneralTypes.h für Software-Module bereitgestellt [SWS_Fr_00511].
Der Wertebereich der Enumeration umfasst drei eindeutige Statuszustände für Sendevorgänge [SWS_Fr_00511]:
FR_TRANSMITTED(0x00): Die LPdu wurde erfolgreich über den Bus übertragen [SWS_Fr_00511].FR_TRANSMITTED_CONFLICT(0x01): Während der Übertragung ist ein Konflikt aufgetreten [SWS_Fr_00511].FR_NOT_TRANSMITTED(0x02): Die LPdu wurde nicht übertragen [SWS_Fr_00511].
Hinsichtlich des Zusammenspiels und des Aufrufkontexts dürfte dieser Statuswert typischerweise von übergeordneten Schichten zur Abfrage des Sendepuffer-Zustands im FlexRay-Treiber herangezogen werden (Interpretation). Frage Q-347a88512db1f006 (offen) Spezifische Fehlercodes, Fehlerbehandlungsroutinen sowie DET- oder DEM-Meldungen sind für diesen Datentyp in den Spezifikationen nicht vorgesehen, da es sich um eine reine Typdeklaration handelt [SWS_Fr_00511].
Dieser Text wurde von einer KI auf Basis der AUTOSAR-Spezifikation R20-11 generiert.
Implementer's Guide folgt (Komplexität I1)
type Fr_RxLPduStatusType [SWS_Fr_00512] 📄 PDF
These values are used to determine if a LPdu has been received or not.
Der Enumerationstyp Fr_RxLPduStatusType ist Teil des AUTOSAR-Classic-Moduls Fr und wird über die Header-Datei Fr_GeneralTypes.h bereitgestellt [SWS_Fr_00512]. Er dient dazu festzustellen, ob eine L-PDU (FlexRay-Link-Layer-PDU) empfangen wurde oder nicht [SWS_Fr_00512].
Der Typ definiert drei diskrete Statuswerte zur Beurteilung des Empfangsstatus [SWS_Fr_00512]:
FR_RECEIVED(0x00): Die L-PDU wurde erfolgreich empfangen [SWS_Fr_00512].FR_NOT_RECEIVED(0x01): Die L-PDU wurde nicht empfangen [SWS_Fr_00512].FR_RECEIVED_MORE_DATA_AVAILABLE(0x02): Die L-PDU wurde empfangen und es stehen weitere Instanzen dieser L-PDU zur Verfügung, wie es bei der Nutzung von Empfangs-FIFOs auftritt [SWS_Fr_00512].
Beim Empfangsbetrieb über Pufferstrukturen unterscheidet der Typ nicht nur das Vorhandensein empfangener Daten, sondern kennzeichnet im FIFO-Betrieb zusätzlich das Vorliegen weiterer Instanzen [SWS_Fr_00512]. Dies dürfte dem Aufrufer signalisieren, dass nach dem Auslesen der aktuellen Instanz unmittelbar weitere Daten aus dem FIFO abgerufen werden können [SWS_Fr_00512]. Frage Q-0ab7cac72ff7f549 (offen)
Dieser Nutzungshinweis wurde von einer KI erstellt und basiert auf der Spezifikation AUTOSAR R20-11.
Implementer's Guide folgt (Komplexität I1)
type Fr_SlotAssignmentType [SWS_Fr_91002] 📄 PDF
This structure contains information about the assignment of a Flex Ray frame to a cycle and a slot ID.
Die Struktur Fr_SlotAssignmentType dient der Speicherung von Zuordnungsinformationen eines FlexRay-Frames zu einem Kommunikationszyklus und einer Slot-ID [SWS_Fr_91002]. Sie ist im Header Fr_GeneralTypes.h definiert und fasst alle Adressierungsparameter zusammen, die für das Senden oder Empfangen eines Frames auf dem FlexRay-Kanal erforderlich sind [SWS_Fr_91002].
Die Struktur umfasst folgende Elemente [SWS_Fr_91002]:
Cycle(Typuint8): Kennzeichnet den Zyklus, in dem der FlexRay-Frame gesendet oder empfangen wird [SWS_Fr_91002].SlotId(Typuint16): Bezeichnet die eindeutige Slot-ID des Frames innerhalb des FlexRay-Kommunikationsschemas [SWS_Fr_91002].channelId(TypFr_ChannelType): Gibt den FlexRay-Kanal an, über den die Übertragung oder der Empfang erfolgt [SWS_Fr_91002].
Da Fr_SlotAssignmentType eine reine Datenstruktur darstellt, besitzt sie keine eigene Ausführungssemantik wie Synchronizität oder Reentranz und löst selbst keine DET- oder DEM-Fehlermeldungen aus [SWS_Fr_91002]. Die Konsistenz der enthaltenen Werte für Zyklus, Slot und Kanal dürfte in der Verantwortung der nutzenden Treiberfunktionen liegen (Interpretation). Frage Q-77f88375e544e298 (offen)
Dieser Text wurde von einer KI erstellt und basiert ausschließlich auf den Spezifikationsdaten von AUTOSAR Classic R20-11.
type Fr_ChannelType [SWS_Fr_00514] 📄 PDF
FlexRay channel identifier: FR_CHANNEL_A, FR_CHANNEL_B, or FR_CHANNEL_AB.
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_Fr- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_Fr@rel:R20-11#c48b96de- Content hash
c48b96de- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_FlexRayDriver.pdf#nameddest=SWS_Fr_00032
claude-opus-5-5· 2026-10-13