Default Error Tracer (DET)
The DET handles development errors, runtime errors, and transient faults across all BSW modules and SW-Cs.
Funktionen — Übersicht
void Det_Init (const Det_ConfigType* ConfigPtr);Service to initialize the Default Error Tracer.Std_ReturnType Det_ReportError (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);Service to report development errors.void Det_Start (void);Service to start the Default Error Tracer.Std_ReturnType Det_ReportRuntimeError (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, faultErrorTracer uint8 ErrorId);Service to report runtime errors.Std_ReturnType Det_ReportTransientFault (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 FaultId);Service to report transient faults.void Det_GetVersionInfo (Std_VersionInfoType* versioninfo);Returns the version information of this module.Std_ReturnType <User_Error_Hooks> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);-Std_ReturnType <DetReportRuntimeErrorCallout> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);-Std_ReturnType <DetReportTransientFaultCallout> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 FaultId);-
Typen — Übersicht
struct Det_ConfigTypeConfiguration data structure of the Det module.
Funktionen & Typen — Detailansicht
functie Det_Init [SWS_Det_00008] 📄 PDF
void Det_Init (const Det_ConfigType* ConfigPtr);
Service to initialize the Default Error Tracer.
De synchrone functie Det_Init dient als centrale service voor de initialisatie van de Default Error Tracer ([SWS_Det_00008]). Deze wordt beschikbaar gesteld via het headerbestand Det.h en heeft de signatuur void Det_Init (const Det_ConfigType* ConfigPtr). Via de formele ingangsparameter ConfigPtr ontvangt de functie een pointer naar de geselecteerde configuratiedataset van de module. Een retourwaarde is niet voorzien voor deze service ([SWS_Det_00008]).
Wat betreft runtimegedrag is Det_Init bindend gespecificeerd als niet-reentrant (Non Reentrant) ([SWS_Det_00008]). Om deze reden mag de functie tijdens bedrijf onder geen beding parallel of onderbrekend vanuit verschillende uitvoeringscontexten worden aangeroepen. De module wordt vermoedelijk centraal aangeroepen tijdens de initialisatiefase van de basissoftware, nog voordat andere BSW-modules of componenten fouten doorgeven aan de DET (interpretatie). Vraag Q-143a3c098d03d7f8 (open)
De functie is gedefinieerd met service-ID 0x00 ([SWS_Det_00008]). Eigen foutcodes, specifieke foutafhandelingsmechanismen of afzonderlijke foutmeldingen via DET of DEM zijn voor deze initialisatie-aanroep in het onderhavige specificatie-uittreksel niet vermeld.
In het kader van requirement tracing voldoet de interface aan de algemene AUTOSAR-richtlijnen voor uniforme API-naamgevingsconventies conform [SRS_BSW_00310] (SWS DefaultErrorTracer §6 “Requirements Tracing”).
Deze opmerking is gegenereerd door een AI op basis van de specificatie AUTOSAR R20-11.
Implementer's Guide volgt (complexiteit I1)
functie Det_ReportError [SWS_Det_00009] 📄 PDF
Std_ReturnType Det_ReportError (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);
Service to report development errors.
De functie Det_ReportError dient in AUTOSAR Classic BSW-modules voor het melden van ontwikkelingsfouten bij actieve foutdetectie ([SWS_BSW_00045], [SWS_Det_00009]). De interface is als re-entrant gedeclareerd ([SWS_Det_00009]). Het uitvoeringsgedrag keert niet terug naar de aanroeper (“never returns”); het retourtype Std_ReturnType bestaat louter voor compatibiliteit met services en hooks ([SWS_Det_00009]).
De overdrachtsparameters identificeren de foutcontext eenduidig ([SWS_Det_00009]):
ModuleId(uint16): AUTOSAR-module-identificatie van de meldende module; basissoftware gebruikt het bereik 0 tot 255 (EXP_LayeredSoftwareArchitecture §3 “Default Error Tracer”).InstanceId(uint8): Module-instantie vanaf 0; bij enkele instanties wordt 0 meegegeven ([SWS_Det_00009]).ApiId(uint8): Identificatie van de foutdetecterende API-service ([SWS_Det_00009]).ErrorId(uint8): Specifieke foutidentificatie van de BSW-module ([SWS_BSW_00045], [SWS_Det_00009]).
Ontwikkelingsfouten vertegenwoordigen fundamentele schendingen van voorwaarden door softwarefouten, verkeerde configuraties of integratieproblemen (EXP_LayeredSoftwareArchitecture §3 “Error Classification”, [SRS_BSW_00337] tekst nog niet geïmporteerd), zoals het aanroepen van een niet-geïnitialiseerde module ([SWS_BSW_00243]) of ongeldige parameters ([SWS_CANIF_00538]). Ze worden als asserties behandeld: na het aanroepen van alle in DetErrorHook geconfigureerde callbacks ([SWS_Det_00501]) mag de normale besturingsstroom niet worden voortgezet; de DET stopt de uitvoering bijvoorbeeld door middel van een oneindige lus, halt-instructie of reset ([SRS_BSW_00337] tekst nog niet geïmporteerd, EXP_LayeredSoftwareArchitecture §3 “Error Classification”).
Deze gebruiksinstructie is gegenereerd door een AI op basis van de AUTOSAR R20-11-specificatie.
Implementer's Guide volgt (complexiteit I2)
functie Det_Start [SWS_Det_00010] 📄 PDF
void Det_Start (void);
Service to start the Default Error Tracer.
De synchrone API-functie Det_Start dient ertoe de Default Error Tracer (DET) te starten ([SWS_Det_00010]). Deze service is gedeclareerd in het headerbestand Det.h onder service-ID 0x02 (SWS_DefaultErrorTracer §8.1.3.3 “Det_Start”). Volgens de syntaxis void Det_Start(void) accepteert de functie noch ingangs- noch uitgangsparameters en levert deze geen retourwaarde aan de aanroeper ([SWS_Det_00010]).
Voor de integratie en uitvoering gelden specifieke voorwaarden:
- Re-entrantie en gelijktijdigheid: De functie is gedefinieerd als niet-re-entrant (
Non Reentrant) ([SWS_Det_00010]). Parallelle oproepen vanuit meerdere taken of onderbrekende contexten zijn niet toegestaan. - Oproepcontext: Interpretatie: De oproep vindt vermoedelijk typisch centraal plaats tijdens het opstarten van het systeem na de basisinitialisatie, om de foutopsporing in de regeleenheid actief te schakelen. Vraag Q-b28f205b1cc7acfa (open)
- Foutafhandeling: De interface meldt geen fouttoestanden terug; in het specificatiefragment zijn noch foutcodes noch DET- of DEM-gebeurtenissen voor deze oproep gedefinieerd ([SWS_Det_00010]).
In het totale systeem voldoet Det_Start aan de gestandaardiseerde naamgevingsconventie voor AUTOSAR-basissoftware volgens [SRS_BSW_00310] tekst nog niet geïmporteerd (SWS_DefaultErrorTracer §6 “Requirements Tracing”).
Deze tekst is door een AI gegenereerd op basis van de AUTOSAR-specificatie R20-11.
Implementer's Guide volgt (complexiteit I1)
functie Det_ReportRuntimeError [SWS_Det_01001] 📄 PDF
Std_ReturnType Det_ReportRuntimeError (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, faultErrorTracer uint8 ErrorId);
Service to report runtime errors. If a callout has been configured then this callout shall be called.
De functie [SWS_Det_01001] dient als centrale BSW-dienst in Det.h voor het in ontvangst nemen van runtimefouten (Runtime Errors). Deze werkt synchroon en is ontworpen als re-entrant [SWS_Det_01001].
Gebruik en parameters
Aanroepende BSW-modules geven bij de foutmelding vier verplichte parameters door aan [SWS_Det_01001]:
ModuleId: module-identificator van de meldende BSW-module.InstanceId: op index gebaseerd instantienummer (bij modules met slechts één instantie de waarde0).ApiId: identificator van de API-functie waarin de fout is opgetreden.ErrorId: modulespecifieke identificator van de gedetecteerde runtimefout.
De dienst levert altijd de retourwaarde E_OK terug aan de aanroepende module [SWS_Det_01001].
Samenspel en foutafhandeling
Conform de AUTOSAR-architectuur onderscheiden runtimefouten zich van ontwikkelingsfouten (die fundamentele randvoorwaarden schenden) en productiefouten (die relevant zijn voor de werkplaatsdiagnose) EXP_LayeredSoftwareArchitecture §Integration and Runtime Aspects. De dienst wordt bijvoorbeeld als verplichte interface geïntegreerd door het ADC-stuurprogramma [SWS_Adc_00530] of DDS [CP_SWS_Dds_00832] tekst nog niet geïmporteerd.
In CanIf leidt bijvoorbeeld een verzendpoging via een offline-kanaal tot het melden van CANIF_E_STOPPED [SWS_CANIF_00382], terwijl lengteoverschrijdingen zonder afkapping als CANIF_E_TXPDU_LENGTH_EXCEEDED worden gemeld [SWS_CANIF_00900].
Bij het aanroepen van [SWS_Det_01001] worden alle callout-functies uitgevoerd die in de configuratieparameter DetReportRuntimeErrorCallout zijn opgeslagen [SWS_Det_00503]. Indien er geen fouthooks zijn geconfigureerd, blijven aanvullende functie-aanroepen achterwege, waarbij een doorzending naar de DLT actief blijft, voor zover deze is geconfigureerd [SWS_Det_00503].
Deze gebruiksinstructie is automatisch opgesteld op basis van de AUTOSAR-R20-11-specificatiestatus.
Implementer's Guide volgt (complexiteit I2)
functie Det_ReportTransientFault [SWS_Det_01003] 📄 PDF
Std_ReturnType Det_ReportTransientFault (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 FaultId);
Service to report transient faults. If a callout has been configured than this callout shall be called and the returned value of the callout shall be returned. Otherwise it returns immediately with E_ OK.
De synchrone en re-entrante functie Det_ReportTransientFault (service-ID 0x05) dient voor BSW-modules voor de gestandaardiseerde melding van gedetecteerde transiënte fouten aan de Default Error Tracer ([SWS_BSW_00225], [SWS_Det_01003]). De service is gedeclareerd via de header Det.h, maar is in release R20-11 gemarkeerd als verouderd (OBSOLETE) (SWS_DefaultErrorTracer §8.1.3.5 “Det_ReportTransientFault”).
Bij de aanroep worden uitsluitend invoerparameters meegegeven: de identificatie van de aanroepende module (ModuleId), de instantie-index (InstanceId, waarbij modules met een enkele instantie 0 meegeven), de service-ID van de foutdetecterende API (ApiId) evenals het foutnummer (FaultId), dat volgens SWS_BSWGeneral §7.2.4.4 “Reporting” van het type uint8 moet zijn ([SWS_Det_01003]).
De aanroep leidt de fout door naar geconfigureerde callout-functies en evalueert hun terugmeldingen:
- Een aanroep leidt tot de uitvoering van alle onder
DetReportTransientFaultCalloutgeconfigureerde callbacks ([SWS_Det_00502]). - Bestaat er geen geconfigureerde callout, dan beëindigt de functie onmiddellijk en levert deze de waarde
E_OKop ([SWS_Det_01003]). - Is er precies één callout ingesteld, dan geeft
Det_ReportTransientFaultde retourwaarde daarvan van het typeStd_ReturnTypeterug ([SWS_Det_01003]). - Zijn er meerdere callouts aanwezig, dan wordt de logische OR-koppeling (som) van alle callout-retourwaarden gevormd. Aangezien
E_OK = 0gedefinieerd is, levert de functie alleen danE_OKop wanneer alle callouts foutloos metE_OKantwoorden ([SWS_Det_01003]).
Met betrekking tot gelijktijdigheid en uitvoeringsomgeving is de functie re-entrant ontworpen, waardoor deze gelijktijdig vanuit verschillende modulecontexten kan worden aangeroepen ([SWS_Det_01003]).
Deze tekst is gegenereerd door een AI op basis van de AUTOSAR-specificatie R20-11.
Implementer's Guide volgt (complexiteit I1)
functie Det_GetVersionInfo [SWS_Det_00011] 📄 PDF
void Det_GetVersionInfo (Std_VersionInfoType* versioninfo);
Returns the version information of this module.
functie <User_Error_Hooks> [SWS_Det_00181] 📄 PDF
Std_ReturnType <User_Error_Hooks> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);
-
De configureerbare interface <User_Error_Hooks> definieert de oproep van door de gebruiker gedefinieerde callout-functies bij de detectie van ontwikkelingsfouten [SWS_Det_00181]. Zodra de functie Det_ReportError wordt aangeroepen, moeten alle hiervoor in het systeem geconfigureerde callouts synchroon worden uitgevoerd [SWS_Det_00180]. De declaratie van deze interface wordt beschikbaar gesteld via de header Det_Externals.h SWS DefaultErrorTracer §8.1.5 “Callout Functions / Configurable Interfaces”.
De functie bezit de service-ID 0x10 en geeft vier diagnostische parameters door voor foutanalyse [SWS_Det_00181]:
ModuleId: Eenduidige module-ID van de aanroepende BSW-module.InstanceId: Identificatie van de module-instantie, beginnend bij0(bij modules met slechts één instantie wordt0meegegeven).ApiId: Identificatie van de betrokken API-functie volgens de specificatie van de betreffende module.ErrorId: Identificatie van de specifieke ontwikkelingsfout.
Volgens de specificatie levert de interface altijd de retourwaarde E_OK op, zoals vereist voor dergelijke services [SWS_Det_00181]. Eigen foutcodes of alternatieve statuswaarden kunnen via de interface niet aan de aanroeper worden teruggemeld.
Wat betreft de uitvoering is <User_Error_Hooks> synchroon en re-entrant opgezet [SWS_Det_00181]. Indien meerdere callouts voor dezelfde service zijn gedefinieerd, moeten deze dezelfde signatuur en service-ID hebben [SWS_Det_00180]. Interpretatie: Aangezien de afhandeling direct in de oproepcontext van Det_ReportError plaatsvindt, mogen gebruikers-hooks vermoedelijk geen blokkerende mechanismen gebruiken, om de systeemuitvoering niet te vertragen. Vraag Q-acd1afcd9336992f (open)
Deze gebruiksinstructie is geautomatiseerd opgesteld aan de hand van de AUTOSAR R20-11-specificatie.
functie <DetReportRuntimeErrorCallout> [SWS_Det_00184] 📄 PDF
Std_ReturnType <DetReportRuntimeErrorCallout> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 ErrorId);
-
De configureerbare callout-interface <DetReportRuntimeErrorCallout> dient voor de gebruikersspecifieke registratie en verdere verwerking van runtimefouten in de Default Error Tracer (SWS_DefaultErrorTracer §8.1.5 “Callout Functions / Configurable Interfaces”). Zodra de functie Det_ReportRuntimeError wordt aangeroepen, voert de DET alle hiervoor geconfigureerde callout-functies synchroon uit ([SWS_Det_00180], [SWS_Det_00503]). Geconfigureerde callout-functies worden via het headerbestand Det_Externals.h beschikbaar gesteld en hebben het service-ID 0x11 ([SWS_Det_00184]).
Parameters en retourwaarde
ModuleId(uint16): numerieke identificator van de BSW-module die de runtimefout meldt ([SWS_Det_00184]).InstanceId(uint8): module-instantie-index, beginnend bij 0; bij enkele instanties wordt altijd 0 doorgegeven ([SWS_Det_00184]).ApiId(uint8): identificator van de API-dienst waarin de runtimefout is opgetreden ([SWS_Det_00184]).ErrorId(uint8): modulespecifieke identificator van de vastgestelde runtimefout ([SWS_Det_00184]).- Retourwaarde: het type
Std_ReturnTyperetourneert conform de dienstspecificatie altijdE_OK([SWS_Det_00184]).
Gelijktijdigheid en gedrag
De callout-functie is gespecificeerd als re-entrant en wordt synchroon in de uitvoeringscontext van de melder afgehandeld ([SWS_Det_00184]). Alle voor dezelfde dienst geconfigureerde callouts moeten dezelfde signatuur en hetzelfde service-ID hebben ([SWS_Det_00180]). Omdat de retourwaarde vast is vastgelegd op E_OK, vindt er via de callout geen terugkoppeling van fouttoestanden naar de DET plaats.
Opmerking: deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de specificatie AUTOSAR Classic R20-11.
functie <DetReportTransientFaultCallout> [SWS_Det_00187] 📄 PDF
Std_ReturnType <DetReportTransientFaultCallout> (uint16 ModuleId, uint8 InstanceId, uint8 ApiId, uint8 FaultId);
-
De callout-hook [SWS_Det_00187] dient voor de toepassingsspecifieke afhandeling van transiënte fouten in de Default Error Tracer (DET). De functie wordt synchroon uitgevoerd en is gedefinieerd met het service-ID 0x12 [SWS_Det_00187]. Deze accepteert vier ingangsparameters:
ModuleId: module-identificator van de aanroepende softwaremodule [SWS_Det_00187].InstanceId: op index gebaseerd instantie-ID van de module beginnend bij0, waarbij modules met een enkele instantie de waarde0moeten doorgeven [SWS_Det_00187].ApiId: identificator van de API-dienst waarin de transiënte fout is opgetreden [SWS_Det_00187].FaultId: identificator van de gedetecteerde transiënte fout conform de SWS van de aanroepende module [SWS_Det_00187].
Als retourwaarde levert de interface een waarde van het type Std_ReturnType, die direct naar de aanroeper van Det_ReportTransientFault wordt gepropageerd [SWS_Det_00187]. De declaratie wordt via het headerbestand Det_Externals.h beschikbaar gesteld [SWS_Det_00187].
Wat betreft gelijktijdigheid is de functie gespecificeerd als re-entrant [SWS_Det_00187]. Omdat de retourwaarde synchroon wordt doorgegeven, mag de callout-implementatie vermoedelijk geen blokkerende bewerkingen bevatten, om de uitvoering van de meldende module niet ontoelaatbaar te vertragen. Vraag Q-23eaffed8be030bb (open)
Deze tekst is gegenereerd door een AI op basis van de specificatiegegevens.
type Det_ConfigType [SWS_Det_00210] 📄 PDF
Configuration data structure of the Det module.
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_Det- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_Det@rel:R20-11#99427994- Content hash
99427994- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_DefaultErrorTracer.pdf#nameddest=SWS_Det_00008
gemini-3.8-flash-low· 2026-10-13 · Duits origineel