Diagnostic Communication Manager (DCM)

De synchrone en niet-re-entrante functie Dcm_Init dient voor de fundamentele initialisatie van de DCM-module [SWS_Dcm_00037]. Deze accepteert via de parameter ConfigPtr een pointer naar de configuratieset bij post-build-varianten en heeft geen retourwaarde [SWS_Dcm_00037]. Tijdens de uitvoering initialiseert de module alle globale DCM-variabelen met de waarden uit de configuratie [SWS_Dcm_00334].

In het kader van het initialisatieproces worden verschillende functionele gebieden en toestanden geconfigureerd:

• DDDID-beheer: Als de configuratieparameter DcmDDDIDStorage op FALSE is ingesteld, initialiseert het DCM bij het opstarten alle dynamisch gedefinieerde data-identifiers (DDDIDs) als niet aanwezig [SWS_Dcm_00866]. Als de parameter op TRUE is ingesteld, worden de DDDID-definities hersteld uit het NvM [SWS_Dcm_00867].
• Response on Event (ROE): Het DCM brengt de toestand van elk event tijdens Dcm_Init over naar de status 'ROE cleared' [SWS_Dcm_00872].
• Authenticatiestatus: Wanneer DcmDspAuthenticationPersistStateModeRuleRef niet is geconfigureerd of de gerefereerde modusregel resulteert in false, brengt de module alle authenticatietoestanden naar de toestand 'deauthenticated' [SWS_Dcm_01480].
• Communicatiestatus: Na afronding van Dcm_Init stelt het DCM de parameter ActiveDiagnostic in op 'DCM_COMM_ACTIVE' [SWS_Dcm_01069].

Wat betreft de uitvoeringsomgeving is vastgelegd dat Dcm_Init niet-re-entrant is [SWS_Dcm_00037]. Specifieke foutcodes en gestandaardiseerde foutmeldingen aan DET of DEM worden voor deze initialisatieservice in de interfacespecificatie niet vermeld [SWS_Dcm_00037].

Gebruik

De synchrone interface Dcm_DemTriggerOnDTCStatus (Service-ID 0x2B) is beschikbaar via de header Dcm_Dem.h en dient ertoe wijzigingen van de UDS-statusbyte aan het DCM te melden [SWS_Dcm_00614]. Dit stelt het DCM in staat om Response-on-Event-gebeurtenissen (ROE) te triggeren voor de diagnosedienst-subservice OnDTCStatusChanged [SWS_Dcm_00614]. Bij aanroep accepteert de functie drie invoerparameters: de desbetreffende foutcode DTC (uint32), de eerdere toestand DTCStatusOld (Dem_UdsStatusByteType) en de bijgewerkte toestand DTCStatusNew (Dem_UdsStatusByteType) [SWS_Dcm_00614]. In- en uitvoerparameters bestaan niet [SWS_Dcm_00614].

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie het type Std_ReturnType op, waarbij volgens de specificatie zonder uitzondering E_OK wordt geretourneerd [SWS_Dcm_00614]. Specifieke foutcodes, fallback-waarden of afzonderlijke notificaties aan DEM of DET zijn voor deze aanroep niet gedefinieerd.

Gelijktijdigheid en wisselwerking

De functie is geclassificeerd als re-entrant en beschikt over een synchrone uitvoeringssemantiek [SWS_Dcm_00614]. Met betrekking tot de wisselwerking met diagnoseverzoeken geldt een vaste randvoorwaarde: als in het DCM momenteel een verzoek tot het wissen van het gebeurtenisgeheugen (EventMemory) wordt verwerkt, moet het DCM inkomende aanroepen van de callback Dcm_DemTriggerOnDTCStatus negeren [SWS_Dcm_01410].

De functie Dcm_BndMWriteBlockFinish dient als notificatie-interface van de BndM aan de DCM om de voltooiing van een blokschrijfbewerking aan te geven [SWS_Dcm_91088]. De functie is gedeclareerd in het headerbestand Dcm.h, heeft de service-ID 0x7a, levert geen retourwaarde (void) en wordt synchroon uitgevoerd [SWS_Dcm_91088].

De interface verwacht twee overdrachtsparameters [SWS_Dcm_91088]:

• BlockId (type: BndM_BlockIdType): Identificeert het blok waarvan de schrijfbewerking is voltooid.
• result (type: BndM_ResultType): Verzendt het resultaat van de schrijfbewerking naar de DCM.

De functionele interactie en het gedrag in geval van een fout zijn gekoppeld aan eerder door de DCM geïnitieerde atomaire BndM-schrijfbewerkingen:

• Als Dcm_BndMWriteBlockFinish wordt aangeroepen met de status result = E_OK, verzendt de DCM een positief diagnose-antwoord op het openstaande verzoek [SWS_Dcm_01584].
• Wordt de functie aangeroepen met result = E_NOT_OK, dan reageert de DCM in geval van een fout met een negatief diagnose-antwoord 0x72 (generalProgrammingFailure) [SWS_Dcm_01585].

Wat betreft gelijktijdigheid is Dcm_BndMWriteBlockFinish gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Dcm_91088]. Oproepers moeten bijgevolg waarborgen dat de functie niet parallel of onderbrekend door meerdere contexten wordt aangeroepen.

Gebruik en aanroepcontext

De functie Dcm_SetDeauthenticatedRole wordt synchroon en re-entrant uitgevoerd ([SWS_Dcm_91069]). Deze stelt een softwarecomponent in staat om voor een door connectionId geïdentificeerde verbinding een nieuwe rol deauthenticatedRole van het type Dcm_AuthenticationRoleType voor de gedeauthenticeerde toestand toe te wijzen ([SWS_Dcm_91069], [SWS_Dcm_01486]). Als retourwaarde wordt zonder uitzondering E_OK geleverd ([SWS_Dcm_91069]).

Toestandsvoorwaarden en foutafhandeling

Een aanroep wordt door de DCM uitsluitend verwerkt als de verbinding zich in de gedeauthenticeerde toestand (deauthenticated state) bevindt ([SWS_Dcm_01487]). Aangezien de signatuur niet in alternatieve foutwaarden voorziet en altijd E_OK retourneert ([SWS_Dcm_91069]), wordt een aanroep buiten deze toestand vermoedelijk zonder foutmelding verworpen. Vraag Q-6f14770eae6ce896 (open) Specifieke DET- of DEM-events zijn in de specificatie niet gedefinieerd.

Geldigheidsduur en levenscyclus

Als de rol voor de gedeauthenticeerde toestand succesvol wordt overgenomen ([SWS_Dcm_01486]), blijft deze toewijzing tijdelijk bestaan:

• De ingestelde rol wordt verworpen zodra de verbinding overgaat naar de geauthenticeerde toestand (authenticated state) ([SWS_Dcm_01488]).
• De geldigheid eindigt uiterlijk bij een reset van de regeleenheid ([SWS_Dcm_91069]).

De synchrone en re-entrante functie Dcm_GetSecurityLevel vraagt het actueel actieve beveiligingsniveau van de DCM op en stelt dit beschikbaar [SWS_Dcm_00338]. De functie is gedeclareerd via de header Dcm.h en geeft de bepaalde statuswaarde via de uitvoerparameter SecLevel van het type Dcm_SecLevelType* door aan de aanroeper. Als retourwaarde wordt volgens de specificatie zonder uitzondering E_OK geretourneerd [SWS_Dcm_00338].

Het bepalen van het interne beveiligingsniveau is gebaseerd op de door de tester in het kader van de dienst SecurityAccess verzonden parameter SecurityAccessType volgens de vaste omrekeningsformule SecurityLevel = (SecurityAccessType + 1) / 2 [SWS_Dcm_00338].

In het samenspel met de bovenliggende diagnosedienstverwerking maakt onder andere de DSP-submodule gebruik van deze waarde: als de module een geconfigureerd verzoek met het subfunctietype „requestSeed” (oneven waarde) ontvangt en het bijbehorende toegangsniveau volgens Dcm_GetSecurityLevel reeds actief is, stelt de DSP-submodule de seed-inhoud in op 0x00 [SWS_Dcm_00323].

Wat betreft gelijktijdigheid en foutafhandeling is de functie gedefinieerd als re-entrant [SWS_Dcm_00338]. Aangezien er geen specifieke foutcodes of DET-controles zijn gespecificeerd en altijd E_OK wordt geretourneerd, vindt er vermoedelijk geen controle op null-pointers plaats; aanroepers moeten daarom vermoedelijk altijd een geldige pointer naar geheugenruimte voor SecLevel doorgeven. Vraag Q-5402d82ac0151b22 (open)

De synchrone functie Dcm_ResetToDefaultSession stelt de applicatie in staat om de actieve diagnosesessie terug te zetten naar de standaardsessie (Default Session) [SWS_Dcm_00520]. Een typische use-case is de automatische beëindiging van een uitgebreide diagnosesessie zodra een voertuig een vooraf ingestelde snelheidsdrempel overschrijdt [SWS_Dcm_00520].

Gebruik en foutafhandeling

• Interface en parameters: De functie is beschikbaar via Dcm.h met de Service-ID 0x2a, heeft de signatuur Std_ReturnType Dcm_ResetToDefaultSession (void) en vereist geen overdrachtsparameters [SWS_Dcm_00520].
• Retourwaarde en fouten: Als retourtype wordt Std_ReturnType teruggeleverd, waarbij zonder uitzondering de waarde E_OK wordt teruggegeven [SWS_Dcm_00520]. Specifieke foutcodes, DET-runtimecontroles of DEM-gebeurtenissen zijn in de eisen voor deze aanroep niet gespecificeerd.

Gelijktijdigheid en wisselwerking

De uitvoering verloopt synchroon en is gedeclareerd als re-entrant [SWS_Dcm_00520].

Naast de feitelijke sessiewisseling initieert Dcm_ResetToDefaultSession dwingend een moduswijziging voor de ModeDeclarationGroupPrototype DcmDiagnosticSessionControl [SWS_Dcm_01062]. Hierbij roept de functie intern SchM_Switch_<bsnp>_DcmDiagnosticSessionControl(RTE_MODE_DcmDiagnosticSessionControl_DCM_DEFAULT_SESSION) aan om de systeemomgeving te notificeren over de overgang naar de standaardsessie [SWS_Dcm_01062].

De synchrone functie Dcm_TriggerOnEvent (service-ID 0x2D), beschikbaar gesteld via de header Dcm.h, dient voor het triggeren van een gebeurtenis die gekoppeld is aan een ResponseOnEvent-verzoek (ROE) [SWS_Dcm_00521].

Aanroep en werking

De aanroeper draagt als enige parameter RoeEventId over (ingangsparameter van het type uint8), die de te triggeren gebeurtenis identificeert; in- of uitgangsparameters bestaan niet [SWS_Dcm_00521]. Zodra de functie wordt aangeroepen, controleert de DCM de toestand van de gebeurtenis: als de overgedragen RoeEvent actief is, triggert de DCM de desbetreffende gebeurtenis [SWS_Dcm_00920]. De DCM voert de met de gebeurtenis geassocieerde dienst uit, mits de bijbehorende modus van de RoeEventId op 'ROE started' staat [SWS_Dcm_00521].

Retourwaarden en validatie

De aanroep retourneert synchroon een status van het type Std_ReturnType, die uitsluitsel geeft over de geldigheid van de parameter [SWS_Dcm_00521]:

• E_OK: De overgedragen waarde voor RoeEventId is geldig [SWS_Dcm_00521].
• E_NOT_OK: De waarde van RoeEventId is ongeldig [SWS_Dcm_00521].

Gelijktijdigheid en eigenschappen

De interface is als re-entrant gespecificeerd [SWS_Dcm_00521]. Deze kan zodoende gelijktijdig worden aangeroepen om gebeurtenissen synchroon aan de DCM te melden [SWS_Dcm_00521].

De synchrone en re-entrante functie Dcm_StartOfReception ([SWS_Dcm_00094]) wordt door een transportprotocolmodule aan het begin van de ontvangst van een N-SDU aangeroepen – zowel bij enkelvoudige berichten (Single Frame, SF) als bij gesegmenteerde berichten (First Frame, FF). Deze kan in de interruptcontext worden aangeroepen ([SWS_Dcm_00094]). De aanroep bewerkt onder andere het stoppen van de S3Server-timer bij aanvang van de ontvangst ([SWS_Dcm_00141]).

Via info worden gebruikersdata en metadata overgedragen; bij generieke verbindingen worden hierdoor onder andere SOURCE_ADDRESS_16 opgeslagen ([SWS_Dcm_00848]) en TARGET_ADDRESS_16 gecontroleerd ([SWS_Dcm_01347]). Als er noch payload noch metadata aanwezig is, wordt NULL_PTR doorgegeven ([SWS_Dcm_00094]). Via bufferSizePtr meldt de functie de beschikbare buffer terug voor de berekening van de Block Size (BS) ([SWS_Dcm_00094]). Bij succesvolle acceptatie levert zij BUFREQ_OK op, waarna vervolgdata via Dcm_CopyRxData worden gekopieerd ([SWS_Dcm_00443]).

Fout- en afwijzingsgevallen worden via de retourwaarde gesignaleerd:

• BUFREQ_E_OVFL: Wordt teruggegeven als de opgevraagde lengte TpSduLength groter is dan de in de DCM beschikbare buffer ([SWS_Dcm_00094], [SWS_Dcm_00444]). bufferSizePtr blijft ongewijzigd ([SWS_Dcm_00094]).
• BUFREQ_E_NOT_OK: Wordt teruggegeven wanneer TpSduLength gelijk is aan 0 ([SWS_Dcm_00642]) of een lopend verzoek op dezelfde verbinding blokkeert ([SWS_Dcm_00557]). Bij een andere verbinding bepaalt de parameter DcmDslDiagRespOnSecondDeclinedRequest of er met BUFREQ_E_NOT_OK wordt afgewezen ([SWS_Dcm_00790]) of met BUFREQ_OK wordt geaccepteerd ([SWS_Dcm_00788]). Gelijktijdige TesterPresent-verzoeken worden eveneens met BUFREQ_OK bevestigd ([SWS_Dcm_00557]).

Gebruik

De synchrone functie Dcm_CopyRxData wordt aangeroepen om ontvangen gegevens van een I-PDU-segment (N-PDU) over te dragen aan de hogere laag in de DCM [SWS_Dcm_00556]. Elke aanroep stelt het volgende deel van de I-PDU-gegevens beschikbaar [SWS_Dcm_00556]. Via de parameter id wordt de ontvangen I-PDU geïdentificeerd [SWS_Dcm_00556]. De pointer info stelt via SduDataPtr de bronbuffer evenals via SduLength het aantal te kopiëren bytes beschikbaar [SWS_Dcm_00556]. Na voltooiing van het kopieerproces wordt de resterende vrije buffergrootte in de DCM via bufferSizePtr teruggemeld [SWS_Dcm_00556], [SWS_Dcm_00443].

Als Dcm_CopyRxData wordt aangeroepen met een SduLength van 0, dient dit puur voor het opvragen van de buffer [SWS_Dcm_00556]. In dit geval mag SduDataPtr een NULL_PTR zijn; de functie retourneert BUFREQ_OK en vult de resterende grootte van de ontvangstbuffer in bij bufferSizePtr [SWS_Dcm_00556], [SWS_Dcm_00996].

Samenspel

Vóór het kopiëren moet Dcm_StartOfReception met BUFREQ_OK zijn afgesloten; daaropvolgende aanroepen van Dcm_CopyRxData kopiëren de gegevens uit de beschikbaar gestelde buffer naar de DCM-buffer en werken bufferSizePtr bij [SWS_Dcm_00443].

Foutafhandeling

De functie retourneert de status als BufReq_ReturnType: BUFREQ_OK bevestigt het succesvol kopiëren of het opvragen van de buffer, terwijl BUFREQ_E_NOT_OK aangeeft dat er vanwege een fout geen gegevens zijn gekopieerd [SWS_Dcm_00556], [SWS_Dcm_00996].

Gelijktijdigheid en beperkingen

Dcm_CopyRxData is gespecificeerd als re-entrant en mag in interrupt-context worden aangeroepen [SWS_Dcm_00556]. De interface wordt beschikbaar gesteld via Dcm.h [SWS_Dcm_00556].

Gebruik en aanroepcontext

De synchrone functie Dcm_TpRxIndication wordt na ontvangst van een I-PDU via de TP-API aangeroepen, typisch door de module PduR [SWS_Dcm_00093], [SWS_Dcm_00112]. Deze draagt de PDU-identificatie (id) en het ontvangstresultaat (result) over en levert geen retourwaarde op [SWS_Dcm_00093]. Omdat de functie re-entrant is en in interrupt-context mag worden aangeroepen, moeten aanroeper en modulestatussen zijn ontworpen voor overeenkomstige gelijktijdigheid [SWS_Dcm_00093].

Gedrag bij foutieve ontvangst

Als Dcm_TpRxIndication wordt aangeroepen met een resultaatwaarde die afwijkt van E_OK, mag de module Dcm de buffer die aan de gerefereerde I-PDU is toegewezen niet evalueren [SWS_Dcm_00344].

Interactie van de submodules

De submodule DSL stuurt ontvangen gegevens uitsluitend door naar de submodule DSD wanneer de aanroep met de parameterwaarde result = E_OK heeft plaatsgevonden [SWS_Dcm_00111]. Voor diagnoseverzoeken gelden daarbij specifieke regels:

• Als het bij het succesvol ontvangen verzoek (Result = E_OK) om het commando TesterPresent met gezette suppressPosRspMsgIndicationBit (SID 0x3E, subfunctie 0x80) gaat, stelt de DSL-submodule de sessie-timeout-timer S3Server terug [SWS_Dcm_00112].
• In dit geval wordt het verzoek door de DSL-submodule niet ter verdere interpretatie naar de DSD-submodule doorgestuurd [SWS_Dcm_00113].

Gebruik en semantiek

De synchrone en re-entrante functie Dcm_CopyTxData wordt aangeroepen door modules van de lagere laag (zoals transportprotocollen) om gegevens van een I-PDU-segment (N-PDU) op te halen voor overdracht [SWS_Dcm_00092]. Via de parameter info draagt de aanroeper de doelbuffer SduDataPtr en de gewenste bytelengte SduLength over. Een waarde van 0 voor SduLength kan worden gebruikt om statuswijzigingen via retry te signaleren of de hoeveelheid beschikbare gegevens op te vragen; SduDataPtr mag in dit geval een NULL_PTR zijn [SWS_Dcm_00092]. Via availableDataPtr meldt het DCM het resterende aantal bytes in de verzendbuffer, dat door TP-modules kan worden gebruikt om opeenvolgende segmentgroottes te bepalen en dat het aantal nog te verzenden bytes niet mag overschrijden [SWS_Dcm_00092], [SWS_Dcm_00350].

Bufferbeheer en herhaling van de overdracht

Via de parameter retry wordt de bevestiging of herhaling van gegevens bestuurd [SWS_Dcm_00092]:

• Als retry een NULL_PTR is, mogen de gegevens direct na het kopieerproces uit de buffer worden verwijderd [SWS_Dcm_00092].
• Bij TP_CONFPENDING moeten eerder gekopieerde gegevens in de TP-buffer blijven voor eventuele foutafhandeling [SWS_Dcm_00092].
• TP_DATACONF bevestigt alle vóór deze aanroep gekopieerde gegevens voor vrijgave [SWS_Dcm_00092].
• TP_DATARETRY kopieert gegevens opnieuw vanaf de offset TxTpDataCnt relatief ten opzichte van de huidige positie [SWS_Dcm_00092].

Retourwaarden en foutafhandeling

Als de gegevens succesvol en volledig zijn gekopieerd, retourneert de functie BUFREQ_OK [SWS_Dcm_00092], [SWS_Dcm_00346]. Als er niet voldoende verzendgegevens beschikbaar zijn, wordt er geen kopieerproces uitgevoerd en wordt BUFREQ_E_BUSY geretourneerd; de lagere laag kan de aanroep later herhalen [SWS_Dcm_00092]. Mislukt het verzoek, dan levert de functie BUFREQ_E_NOT_OK op [SWS_Dcm_00092]. In dit geval is het verzendverzoek uit PduR_DcmTransmit() nog niet voltooid; pas een afsluitende aanroep van Dcm_TpTxConfirmation beëindigt het proces en maakt nieuwe overdrachten mogelijk [SWS_Dcm_00350].

Concurrency

De functie is re-entrant en mag ook in interrupt-context worden aangeroepen [SWS_Dcm_00092].

De callbackfunctie Dcm_TpTxConfirmation ([SWS_Dcm_00351]) wordt synchroon aangeroepen door de onderste transportlaag nadat een diagnostische I-PDU op het netwerk is verzonden. Via de parameter id wordt de desbetreffende I-PDU geïdentificeerd, terwijl result het slagen of mislukken van het zendproces meldt ([SWS_Dcm_00351]). De functie heeft geen retourwaarde, is re-entrant en mag expliciet in de interruptcontext worden uitgevoerd ([SWS_Dcm_00351]).

Bij aanroep van Dcm_TpTxConfirmation voert de DCM-module centrale opschoon- en statusovergangen uit:

• De toegewezen zendbuffer wordt ontgrendeld ([SWS_Dcm_00352]).
• Lopende foutbewakingen zoals page-buffer-timeouts en P2ServerMax- en P2*ServerMax-timeouts worden gestopt ([SWS_Dcm_00353]).
• De sinds de ontvangst (Dcm_TpRxIndication) geblokkeerde DcmPduId van de verbinding wordt vrijgegeven, zodat opeenvolgende verzoeken kunnen worden ontvangen ([SWS_Dcm_00241]).
• Het actuele protocol wordt door de bevestiging van het DSL-antwoord niet beëindigd (geen aanroep van xxx_StopProtocol) ([SWS_Dcm_00624]).

In geval van een fout (wanneer result een fout aangeeft of een afbreking na een mislukte Dcm_CopyTxData wordt bevestigd) vereist [SWS_Dcm_00350] dwingend deze afsluitende aanroep om de zendopdracht formeel af te sluiten en nieuwe overdrachten via PduR_DcmTransmit() mogelijk te maken. Bij een foutieve bevestiging mag de DSD-submodule het diagnoserespons niet opnieuw verzenden ([SWS_Dcm_00118]).

Daarnaast markeert de bevestiging van een respons (ongelijk aan NRC 0x78) de reguliere afsluiting van een diagnose-request ([SWS_Dcm_01378]). Na de bevestiging van een positieve respons op een EcuReset negeert de DCM tijdens de resetverwerking alle verdere verzoeken ([SWS_Dcm_00834]).

Gebruik

De synchrone interface Dcm_TxConfirmation (service-ID 0x40, gedeclareerd in Dcm.h) wordt volgens [SWS_Dcm_01092] door de onderliggende communicatie-interfacemodule aangeroepen om de verzending van een PDU te bevestigen of het mislukken van de transmissie te melden. De functie heeft geen retourwaarde en verwerkt twee ingangsparameters:

• TxPduId: Identifier (PduIdType) van de verzonden PDU.
• result: Status van de transmissie (Std_ReturnType). Geldige waarden zijn E_OK bij succesvolle transmissie en E_NOT_OK indien de transmissie van de PDU is mislukt.

Foutafhandeling en statusfeedback

Het resultaat van de transmissie wordt direct aan de DCM gesignaleerd via parameter result ([SWS_Dcm_01092]). Specifieke DET- of DEM-foutmeldingen zijn in het verstrekte specificatie-uittreksel voor deze functie niet gedefinieerd.

Gelijktijdigheid en aanroepcontext

Wat betreft re-entrantie is Dcm_TxConfirmation re-entrant voor aanroepen met verschillende PDU-ID's, maar niet re-entrant voor dezelfde TxPduId ([SWS_Dcm_01092]). Men dient er rekening mee te houden dat de aanroep door de onderliggende module in interrupt-context kan plaatsvinden ([SWS_Dcm_01092]).

Samenspel

In het geval van een periodieke transmissie (PeriodicTransmission) wordt de DCM conform [SWS_Dcm_01073] via Dcm_TxConfirmation aangeroepen om over het respectieve zendresultaat te worden geïnformeerd.

De synchrone en re-entrante functie Dcm_ComM_NoComModeEntered (Service-ID 0x21) informeert de DCM-module over de overgang van een communicatienetwerk naar de toestand COMM_NO_COMMUNICATION [SWS_Dcm_00356]. De interface wordt beschikbaar gesteld via de header Dcm_ComM.h, heeft geen retourwaarde en identificeert het desbetreffende netwerk via de invoerparameter NetworkId van het type uint8 [SWS_Dcm_00356].

Met de aanroep schakelt de DCM alle communicatie op het opgegeven netwerk uit, zodat zowel het ontvangen als het verzenden van berichten volledig worden gedeactiveerd [SWS_Dcm_00148]. Dit omvat bindend de volgende overdrachtstypen:

• het verhinderen van ResponseOnEvent-overdrachten [SWS_Dcm_00149],
• het deactiveren van periodieke overdrachten via ReadDataByPeriodicIdentifier (periodicId) [SWS_Dcm_00150], en
• het uitschakelen van normale overdrachten [SWS_Dcm_00151].

Bijgevolg mag de DCM-module na uitvoering van Dcm_ComM_NoComModeEntered voor deze context niet meer de PduR-functie PduR_DcmTransmit() aanroepen [SWS_Dcm_00152].

Wordt de functie aangeroepen met een NetworkId die niet overeenkomt met een in de DCM via de configuratieparameter DcmDslProtocolComMChannelRef gerefereerd ComM-kanaal, dan voert de DCM-module generlei acties uit en keert deze onmiddellijk terug [SWS_Dcm_01324].

De synchrone en re-entrante functie Dcm_ComM_SilentComModeEntered ([SWS_Dcm_00358]) dient ertoe de DCM-module te informeren over de overgang van een communicatienetwerk naar de toestand COMM_SILENT_COMMUNICATION. De interface heeft de Service-ID 0x22, levert geen retourwaarde op en verwacht als invoerparameter NetworkId de identifier van het desbetreffende netwerk ([SWS_Dcm_00358]). Deze wordt via het headerbestand Dcm_ComM.h ter beschikking gesteld ([SWS_Dcm_00358]).

Zodra deze aanroep plaatsvindt, moet de DCM alle zendactiviteiten op het desbetreffende netwerkkanaal volledig staken ([SWS_Dcm_00153]). Dit omvat in detail de volgende maatregelen:

• de deactivering van alle normale overdrachten ([SWS_Dcm_00156]),
• het verhinderen van Response-on-Event-overdrachten ([SWS_Dcm_00154]), en
• het deactiveren van periodieke verzendingen in het kader van ReadDataByPeriodicIdentifier ([SWS_Dcm_00155]).

Wat betreft de foutafhandeling en randvoorwaarden is vastgelegd dat de DCM zonder enige verdere actie moet terugkeren, indien de doorgegeven NetworkId overeenkomt met een ComM-kanaal dat in de DCM niet via de configuratieparameter DcmDslProtocolComMChannelRef wordt gerefereerd ([SWS_Dcm_01325]). Specifieke ontwikkelingsfouten of foutretourwaarden zijn voor deze aanroep niet gespecificeerd.

Interpretatie: De aanroep zal doorgaans plaatsvinden door de module ComM, zodra de overgang naar de stille communicatiemodus wordt voltrokken. Vraag Q-fc9b6303ae0c0e41 (open)

De synchrone en re-entrante functie Dcm_ComM_FullComModeEntered wordt via het headerbestand Dcm_ComM.h ter beschikking gesteld en informeert de DCM-module over de overgang van een communicatienetwerk naar de toestand COMM_FULL_COMMUNICATION [SWS_Dcm_00360]. Als invoerparameter dient NetworkId, die het door de moduswijziging getroffen netwerk identificeert [SWS_Dcm_00360].

Door de aanroep wordt alle communicatie voor dit netwerk geactiveerd, zodat zowel het ontvangen als het verzenden van berichten zijn vrijgegeven [SWS_Dcm_00157]. Dit omvat de volgende overdrachtstypen:

• normale overdrachten [SWS_Dcm_00161],
• Response-on-Event-overdrachten [SWS_Dcm_00159], en
• periodieke overdrachten door middel van ReadDataByPeriodicIdentifier [SWS_Dcm_00160].

Zodra Dcm_ComM_FullComModeEntered is aangeroepen, verwerkt de DCM de interne functies DslInternal_ResponseOnOneDataByPeriodicId() en DslInternal_ResponseOnOneEvent() zonder beperkingen [SWS_Dcm_00162]. In de tijdsvolgorde moet de DCM deze aanroep afwachten voordat de overdracht van een diagnoserespons wordt ingeleid; de wachttijd mag vanaf het moment van ontvangst van het verzoek niet langer zijn dan P2ServerMax [SWS_Dcm_01142].

In geval van een fout, wanneer de doorgegeven NetworkId betrekking heeft op een ComM-kanaal dat in de DCM niet is geconfigureerd (parameter DcmDslProtocolComMChannelRef), keert de functie onmiddellijk en zonder verdere acties terug [SWS_Dcm_01326].

Gebruik en semantiek

De synchrone en re-entrante callback-functie Dcm_CsmAsyncJobFinished wordt aangeroepen door de Crypto Service Manager (CSM) zodra een asynchrone opdrachtverwerking is voltooid [SWS_Dcm_91076]. Als invoerparameter ontvangt deze via result van het type Csm_ResultType het resultaat van de beëindigde CSM-job [SWS_Dcm_91076]. Als retourwaarde levert de functie altijd E_OK terug [SWS_Dcm_91076].

Configuratie en randvoorwaarden

Integrators moeten de naam van deze functie in de ECUC-configuratie van de CSM configureren als callback voor asynchrone jobs [SWS_Dcm_91076]. Voor de DCM is uitsluitend één enkele dergelijke callback beschikbaar; de identificatie van de beëindigde opdracht vindt volgens de specificatie plaats door evaluatie van de jobparameter [SWS_Dcm_91076]. Aangezien de C-functiesignatuur echter alleen result doorgeeft, achterhaalt de DCM de bijbehorende opdracht intern vermoedelijk via de transactietoestand van de lopende authenticatie. Vraag Q-04ad1d5fb514f467 (open)

De interface is alleen beschikbaar wanneer in de configuratie de parameter DcmDspAuthenticationConnection is ingesteld (ongelijk aan null) [SWS_Dcm_91076]. Specifieke foutafhandelingen of DET-meldingen zijn voor deze aanroep niet gespecificeerd, aangezien de retourwaarde onveranderlijk E_OK is [SWS_Dcm_91076].

De synchrone en re-entrante callback-functie Dcm_KeyMAsyncCertificateVerifyFinished wordt door de module KeyM aangeroepen na voltooiing van een asynchrone certificaatverificatie [SWS_Dcm_91077]. Deze informeert de DCM over de voltooiing en het resultaat van de verificatieprocedure en levert als retourwaarde altijd E_OK [SWS_Dcm_91077].

Parameters en werking

• CertID: Identificatie van het certificaat waarvan de verificatie is voltooid. Aan de hand van deze identifier bepaalt de DCM welke verificatie-opdracht is beëindigd [SWS_Dcm_91077].
• Result: Retourwaarde en status van de asynchrone verificatie-opdracht vanuit de KeyM [SWS_Dcm_91077].

Configuratie en randvoorwaarden

Integrators moeten deze functienaam in de ECUC-configuratie van de KeyM configureren als callback voor asynchrone jobs [SWS_Dcm_91077]. Aangezien voor deze notificatie slechts één enkele callback beschikbaar is, is de DCM erop aangewezen om het desbetreffende certificaat via de parameter CertID op te lossen [SWS_Dcm_91077].

De interface is uitsluitend beschikbaar wanneer de configuratieparameter DcmDspAuthenticationConnection in het pad Dcm/DcmDsp/DcmDspAuthentication is geconfigureerd (!= null) [SWS_Dcm_91077]. Bijzondere foutcodes of DET-meldingen zijn voor deze aanroep niet gespecificeerd [SWS_Dcm_91077].

De callout-functie Dcm_ReadMemory ([SWS_Dcm_00539]), gedeclareerd in Dcm_Externals.h, dient voor de DCM voor het uitlezen van server-geheugengegevens aan de hand van startadres (MemoryAddress) en bytegrootte (MemorySize). De functie is vereist voor de UDS-services ReadMemoryByAddress (0x23) ([SWS_Dcm_00495]), ReadDataByIdentifier (0x22) voor dynamische DID's in het adresbereik 0xF200 tot 0xF3FF ([SWS_Dcm_00653]), RequestUpload en TransferData ([SWS_Dcm_00539]). Indien de parameter MemoryIdentifier niet wordt gebruikt, moet deze op 0 worden gezet ([SWS_Dcm_00539]).

De interface is asynchroon en niet-reentrant ([SWS_Dcm_00539]). De aanroepstatus wordt doorgegeven via OpStatus met de waarden DCM_INITIAL, DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK. Zolang de leesbewerking voortduurt, retourneert de functie DCM_READ_PENDING ([SWS_Dcm_00985]). Indien de aanroep DCM_READ_FORCE_RCRRP oplevert, initieert de DCM onmiddellijk het verzenden van een RCR-RP-bericht (NRC 0x78) en pauzeert verdere aanroepen tot aan de verzendbevestiging ([SWS_Dcm_00839]). Na bevestiging van de RCR-RP roept de DCM de functie uit Dcm_MainFunction opnieuw aan met OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00840]).

In het geval van succes worden de uitgelezen gegevens in de buffer MemoryData geschreven en wordt DCM_READ_OK geretourneerd ([SWS_Dcm_00539], [SWS_Dcm_00985]). Mislukt de operatie, dan retourneert de functie DCM_READ_FAILED en stelt ErrorCode in. De DCM verzendt vervolgens een negatief antwoord met de overeenkomstige NRC-waarde ([SWS_Dcm_00644]).

De in Dcm_Externals.h gedeclareerde callout-functie Dcm_WriteMemory wordt door de DCM asynchroon en niet-reentrant aangeroepen om geheugengegevens aan de hand van startadres en bytegrootte te schrijven [SWS_Dcm_00540]. Deze dient voor de implementatie van de UDS-services WriteMemoryByAddress (0x3D), RequestDownload en TransferData [SWS_Dcm_00540]. Bij ontvangst van WriteMemoryByAddress roept de DCM de callout pas aan na controle van het verzoek [SWS_Dcm_00491].

Voor de besturing van het verloop wordt OpStatus doorgegeven (mogelijke waarden: DCM_INITIAL, DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK) [SWS_Dcm_00540]. De parameters MemoryAddress en MemorySize bepalen het doelgeheugenbereik, terwijl MemoryData naar de diagnosebuffer van de DCM wijst [SWS_Dcm_00540]. Worden MemoryIdentifier of MemoryAddress (bijvoorbeeld bij gecomprimeerde gegevens) niet gebruikt, dan moeten deze op 0 worden gezet [SWS_Dcm_00540].

De retourwaarde Dcm_ReturnWriteMemoryType [SWS_Dcm_00986] definieert de verdere verwerking in de DCM:

• DCM_WRITE_OK: de schrijfbewerking was succesvol [SWS_Dcm_00540], [SWS_Dcm_00986].
• DCM_WRITE_PENDING: de operatie is nog niet voltooid en vereist vervolgaanroepen [SWS_Dcm_00540], [SWS_Dcm_00986].
• DCM_WRITE_FORCE_RCRRP: de DCM initieert onmiddellijk het verzenden van een Response Pending (NRC 0x78) en schort verdere aanroepen op tot de verzendbevestiging [SWS_Dcm_00837]. Daarna volgt de nieuwe aanroep vanuit Dcm_MainFunction met DCM_FORCE_RCRRP_OK [SWS_Dcm_00838].
• DCM_WRITE_FAILED: bij een fout verzendt de DCM een negatief antwoord met de via de uitvoerparameter ErrorCode doorgegeven NRC-waarde [SWS_Dcm_00540], [SWS_Dcm_00643].

De callout-functie Dcm_SetProgConditions stelt de integrator in staat relevante informatie persistent op te slaan voorafgaand aan een overgang naar de bootloader of een reset als gevolg van een ECUReset-verzoek [SWS_Dcm_00543]. De relevante contextgegevens worden doorgegeven via een pointer naar de structuur Dcm_ProgConditionsType, die onder meer verbindings- en tester-bronadressen, service- en subfunctie-ID's en besturingsvlaggen zoals ReprogramingRequest en ResponseRequired bundelt [SWS_Dcm_00988]. Bij ontvangst van een UDS-service 0x10 met subfunctie 0x02 stelt de DCM deze vlaggen in en roept de interface aan [SWS_Dcm_01182].

De aanroep vindt asynchroon plaats en is niet-reentrant (Non Reentrant) [SWS_Dcm_00543]. Via de parameter OpStatus worden de toestanden DCM_INITIAL, DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK bestuurd [SWS_Dcm_00543]. Zolang de uitvoering voortduurt en de functie DCM_E_PENDING retourneert, roept de DCM de interface in de volgende hoofdfunctiecyclus opnieuw aan om het instellen te voltooien [SWS_Dcm_00543], [SWS_Dcm_01184]. Door middel van DCM_E_FORCE_RCRRP kan de verzending van een Response Pending-antwoord (NRC 0x78) worden afgedwongen [SWS_Dcm_00543]. Afhankelijk van de configuratie vindt de aanroep door de DCM pas plaats na succesvolle verzending van NRC 0x78 [SWS_Dcm_00535].

Als de voorwaarden foutloos zijn ingesteld en de callout E_OK retourneert, initieert de DCM de moduswijziging van de ModeDeclarationGroupPrototype DcmEcuReset naar EXECUTE [SWS_Dcm_00719], [SWS_Dcm_01163], [SWS_Dcm_01180]. Kan de toestand daarentegen niet worden opgeslagen en antwoordt de functie met E_NOT_OK, dan blijven de reset en de bootloader-sprong achterwege, wordt de moduswijziging geblokkeerd en verzendt de DCM het negatieve antwoord NRC 0x22 (Conditions not correct) [SWS_Dcm_00715], [SWS_Dcm_01181].

De callout-functie Dcm_GetProgConditions met de Service-ID 0x62 wordt tijdens de initialisatie van de DCM aangeroepen om vast te stellen of er een openstaand diagnose-antwoord op service $50 of $51 moet worden verzonden [SWS_Dcm_00544]. De declaratie van de interface wordt beschikbaar gesteld via het headerbestand Dcm_Externals.h [SWS_Dcm_00544].

Gebruik en parameters

De functie-uitvoering verloopt synchroon, waarbij geen reguliere invoer- of invoer-/uitvoerparameters worden doorgegeven [SWS_Dcm_00544]:

• Uitvoerparameter: via de pointer ProgConditions van het type Dcm_ProgConditionsType* levert de callout de voorwaarden terug waaronder de eerdere sprong vanuit de bootloader is aangevraagd [SWS_Dcm_00544]. De relevante contextparameters zijn vastgelegd in het gegevenstype Dcm_ProgConditionsType [SWS_Dcm_00544].
• Retourwaarde: de functie retourneert een statuswaarde van het type Dcm_EcuStartModeType aan de aanroeper [SWS_Dcm_00544].

Gelijktijdigheid en foutafhandeling

De functie is geclassificeerd als niet-reentrant (Non Reentrant) en mag daarom niet gelijktijdig worden uitgevoerd [SWS_Dcm_00544]. Voor deze callout zijn in de interfacespecificatie geen specifieke foutcodes voor DET of DEM gedefinieerd [SWS_Dcm_00544].

De callout-functie Dcm_ProcessRequestAddFile wordt door de DCM aangeroepen om de dienst RequestFileTransfer met de bedrijfsmodus 0x01 (AddFile) te initiëren ([SWS_Dcm_91078]). Deze is beschikbaar via Dcm_Externals.h, heeft de service-ID 0x72 en is gespecificeerd als niet-re-entrant (Non Reentrant) en asynchroon ([SWS_Dcm_91078]).

De besturing van het asynchrone aanroepverloop vindt plaats via de parameter OpStatus:

• DCM_INITIAL: Alle invoerparameters zijn geldig. Hiertoe behoren het bestandspad en de bestandsnaam (filePathAndName met filePathAndNameLength), de byte dataFormatIdentifier (high-nibble voor compressie, low-nibble voor versleuteling) evenals de ongecomprimeerde en gecomprimeerde bestandsgrootte (fileSizeUncompressed, fileSizeCompressed) ([SWS_Dcm_91078]).
• DCM_PENDING, DCM_CANCEL en DCM_FORCE_RCRRP_OK: Bij deze vervolgaanroepen zijn alle invoerparameters ingesteld op 0x00 ([SWS_Dcm_91078]).

Als retourwaarden levert de functie E_OK bij succesvolle uitvoering, DCM_E_PENDING bij aanhoudende verwerking of DCM_E_FORCE_RCRRP wanneer de applicatie verzoekt om het verzenden van een voorlopig antwoord (NRC 0x78) ([SWS_Dcm_91078], [SWS_Dcm_91086]). In geval van succes definieert maxNumberOfBlockLength de maximaal toegestane bloklengte van toekomstige TransferData-berichten zonder SID en blokteller ([SWS_Dcm_91078]).

In geval van een fout levert de functie E_NOT_OK terug. In dit geval moet via de parameter ErrorCode een negatieve responscode (NRC) worden doorgegeven, die de DCM in een negatief diagnose-antwoord naar de client verzendt ([SWS_Dcm_91078]). Als de configuratie DcmRequestFileTransferUsePort is geactiveerd, wordt deze functionaliteit alternatief beschikbaar gesteld als poortoperatie ProcessRequestAddFile van de interface RequestFileTransfer ([SWS_Dcm_91086]).

Gebruik en aanroepsemantiek

De callout-functie Dcm_ProcessRequestDeleteFile wordt aangeroepen door de DCM om in het kader van de diagnosedienst RequestFileTransfer het verwijderen van een bestand (modeOfOperation = 0x02) op de server te initiëren [SWS_Dcm_91079]. De functie is gedeclareerd in Dcm_Externals.h en werkt asynchroon en niet-re-entrant (Non Reentrant) [SWS_Dcm_91079].

De overdracht en evaluatie vinden plaats aan de hand van de parameter OpStatus:

• DCM_INITIAL: Geeft de start van de operatie aan. Hierbij zijn alle invoerparameters geldig; filePathAndName geeft de opslaglocatie en naam van het te verwijderen bestand door, waarvan de bytelengte via filePathAndNameLength is gespecificeerd [SWS_Dcm_91079].
• DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK: Bij voortgaande verwerking of afbreken zijn alle invoerparameters ingesteld op 0x00 [SWS_Dcm_91079].

Als retourwaarden levert de functie E_OK bij succesvolle uitvoering, DCM_E_PENDING indien de uitvoering nog voortduurt en verdere aanroepen vereist, of DCM_E_FORCE_RCRRP wanneer de applicatie verzoekt om het verzenden van een tussenbericht met NRC 0x78 (Response Pending) [SWS_Dcm_91079], analoog aan de dienst RequestFileTransfer [SWS_Dcm_91086].

Foutafhandeling

Mislukt de verwerking, dan retourneert de functie E_NOT_OK. In dit geval moet via de uitvoerparameter ErrorCode een negatieve responscode beschikbaar worden gesteld, die de DCM als negatieve terugmelding (NRC) naar de tester verzendt [SWS_Dcm_91079].

De callout-functie Dcm_ProcessRequestReplaceFile wordt aangeroepen door de DCM om een diagnoseproces voor RequestFileTransfer met de bedrijfsmodus 0x03 (ReplaceFile) te initiëren [SWS_Dcm_91080]. De functie is gedefinieerd als niet-re-entrant (Non Reentrant) en asynchroon, en wordt beschikbaar gesteld via de header Dcm_Externals.h [SWS_Dcm_91080].

De besturing van het asynchrone verwerkingsverloop vindt plaats via de parameter OpStatus:

• Bij de initiële aanroep met DCM_INITIAL geeft de DCM alle invoerparameters geldig door, waaronder pad en bestandsnaam (filePathAndName met lengte-aanduiding filePathAndNameLength), de identificatie voor compressie en versleuteling (dataFormatIdentifier) evenals de ongecomprimeerde en gecomprimeerde bestandsgrootte (fileSizeUncompressed, fileSizeCompressed) [SWS_Dcm_91080].
• Bij vervolgaanroepen of een afbreking (DCM_PENDING, DCM_CANCEL, DCM_FORCE_RCRRP_OK) zijn alle in-parameters ingesteld op 0x00 [SWS_Dcm_91080].
• In geval van succes retourneert de functie via de out-parameter maxNumberOfBlockLength de maximale payloadlengte voor opvolgende TransferData-verzoeken (zonder SID en blokvolgordeteller) aan de DCM [SWS_Dcm_91080].

Als retourwaarden zijn E_OK bij succesvolle uitvoering, DCM_E_PENDING bij nog aanhoudende verwerking en DCM_E_FORCE_RCRRP voor het verzoeken van een response-pending-terugmelding (NRC 0x78) voorzien [SWS_Dcm_91080], [SWS_Dcm_91086]. Mislukt de uitvoering, dan retourneert de functie E_NOT_OK en wijst deze aan de parameter ErrorCode de bijbehorende negatieve diagnoseresponscode (NRC) toe, die de DCM naar de tester verzendt [SWS_Dcm_91080].

De callout-functie Dcm_ProcessRequestReadFile wordt aangeroepen door de DCM om een file-transfer-proces (service RequestFileTransfer) met de bedrijfsmodus ReadFile (modeOfOperation 0x04) te starten [SWS_Dcm_91081]. De functie is gedeclareerd in de header Dcm_Externals.h, werkt asynchroon en is niet-re-entrant (Non Reentrant) [SWS_Dcm_91081].

De aanroep vindt plaats via de statusparameter OpStatus: Bij de initiële aanroep DCM_INITIAL zijn alle invoerparameters geldig, terwijl ze bij vervolgaanroepen met DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK worden ingesteld op 0x00 [SWS_Dcm_91081]. De applicatie ontvangt pad en bestandsnaam via filePathAndName (lengte in filePathAndNameLength), het formaat voor compressie en versleuteling via dataFormatIdentifier evenals de bestandsgroottes via fileSizeUncompressed en fileSizeCompressed [SWS_Dcm_91081]. Als uitvoerparameter moet de applicatie maxNumberOfBlockLength invullen met het maximale aantal bytes voor opvolgende TransferData-antwoorden (zonder SID en blokvolgordeteller) [SWS_Dcm_91081].

Als retourwaarden van Std_ReturnType zijn E_OK bij succesvolle uitvoering, DCM_E_PENDING bij nog aanhoudende asynchrone verwerking of DCM_E_FORCE_RCRRP voor het verzoeken van een "Response Pending"-antwoord (NRC 0x78) gedefinieerd [SWS_Dcm_91081]. Mislukt de operatie, dan levert deze E_NOT_OK; in dit geval verzendt de DCM een negatief antwoord met de in de uitvoerparameter ErrorCode ingestelde NRC-waarde naar de tester [SWS_Dcm_91081]. De interactie komt overeen met de algemene afhandeling van de dienst RequestFileTransfer, zoals deze analoog voor andere bestandsoperaties zoals ProcessRequestAddFile wordt geconfigureerd [SWS_Dcm_91086].

Gebruik

De callout-functie Dcm_ProcessRequestReadDir wordt gedeclareerd via het headerbestand Dcm_Externals.h en aangeroepen door de DCM om de dienst RequestFileTransfer met de bedrijfsmodus 0x05 (ReadDir) asynchroon te starten [SWS_Dcm_91082]. De verwerkingsvoortgang wordt bestuurd via de overdrachtsparameter OpStatus [SWS_Dcm_91082]. Bij de eerste aanroep met DCM_INITIAL geeft de DCM het pad resp. de naam door via filePathAndName samen met de bytelengte filePathAndNameLength [SWS_Dcm_91082]. Bij opvolgende aanroepen of bij een afbreking (DCM_PENDING, DCM_CANCEL, DCM_FORCE_RCRRP_OK) zijn alle invoerparameters ingesteld op 0x00 [SWS_Dcm_91082].

Als uitvoerwaarden moet de applicatie de grootte van de mapgegevens via dirInfoLength en de maximaal toegestane blokgrootte voor opvolgende overdrachten via maxNumberOfBlockLength beschikbaar stellen [SWS_Dcm_91082]. Naast E_OK bij succesvolle uitvoering kan de functie DCM_E_PENDING retourneren wanneer de operatie nog voortduurt, of DCM_E_FORCE_RCRRP om het verzenden van een tussenantwoord (NRC 0x78) te initiëren [SWS_Dcm_91082].

Foutafhandeling

Treedt er een fout op, dan moet de functie E_NOT_OK retourneren. In dit geval leest de DCM de parameter ErrorCode uit en verzendt deze de waarde daarvan als negatieve responscode (NRC) naar de tester [SWS_Dcm_91082]. Specifieke DET- of DEM-meldingen zijn voor de interface niet voorzien; foutcontroles van het doorgegeven pad behoren daarom vermoedelijk volledig tot de verantwoordelijkheid van de applicatiespecifieke implementatie. Vraag Q-278dbc3db7b4363b (open)

Gelijktijdigheid en wisselwerking

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) en mag bijgevolg niet gelijktijdig voor meerdere diagnoseverzoeken worden aangeroepen [SWS_Dcm_91082]. Deze maakt deel uit van de interfacegroep van de dienst RequestFileTransfer, waarvan de koppeling kan worden beïnvloed via configuratieparameters [SWS_Dcm_91086].

Gebruik en aanroepcontext

De callout-functie Dcm_WriteFile wordt aangeroepen door de DCM wanneer via de UDS-dienst TransferData (0x36) gegevens worden ontvangen en een eerder via RequestFileTransfer met de modi 0x01 (AddFile) of 0x03 (ReplaceFile) gestart downloadproces actief is [SWS_Dcm_01444]. De interface is beschikbaar via Dcm_Externals.h [SWS_Dcm_91083].

De bezetting van de parameters hangt af van de voortgangsstatus OpStatus [SWS_Dcm_91083]:

• DCM_INITIAL: Alle invoerparameters zijn geldig. De pointer Data verwijst naar de te schrijven payload, en DataLength geeft de bytelengte daarvan aan. De waarde van DataLength overschrijdt de eerder bij Dcm_ProcessRequestFileTransfer onderhandelde maximale bloklengte (NumberOfBlockLength) niet.
• DCM_PENDING, DCM_CANCEL en DCM_FORCE_RCRRP_OK: Alle invoerparameters zijn ingesteld op 0x00.

Asynchrone semantiek en retourwaarden

De functie werkt asynchroon en niet-re-entrant (Non Reentrant) [SWS_Dcm_91083]. Deze levert de volgende statuswaarden op:

• E_OK: De schrijfbewerking is met succes voltooid.
• DCM_E_PENDING: De verwerking is nog niet beëindigd en vereist verdere aanroepen.
• DCM_E_FORCE_RCRRP: De applicatie verzoekt om het verzenden van een wachtantwoord (Response Pending, NRC 0x78).
• E_NOT_OK: de bewerking is mislukt.

Foutafhandeling

Als Dcm_WriteFile de waarde E_NOT_OK retourneert, verzendt de DCM-module een negatief UDS-antwoord waarvan de NRC overeenkomt met de via de uitvoerparameter ErrorCode beschikbaar gestelde waarde [SWS_Dcm_91083].

De callout-functie Dcm_ReadFileOrDir wordt aangeroepen door de DCM-module wanneer in het kader van een lopende bestands- of map-upload (eerder gestart via UDS-dienst RequestFileTransfer met modus 0x04 voor ReadFile of 0x05 voor ReadDir) een formatconforme aanvraag voor de UDS-dienst TransferData (0x36) binnenkomt [SWS_Dcm_01445]. De functie dient om de gegevens beschikbaar te stellen die als antwoord naar de client moeten worden verzonden [SWS_Dcm_91085]. De interfacedeclaratie is beschikbaar via de header Dcm_Externals.h [SWS_Dcm_91085].

De uitvoering vindt asynchroon plaats en is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Dcm_91085]. De interactie en de parameterbezetting hangen af van de overgedragen bedrijfsstatus:

• Bedrijfsstatus (OpStatus): Bij de initiële aanroep met DCM_INITIAL zijn alle invoerparameters geldig. Bij vervolg- of afbreekaanroepen met DCM_PENDING, DCM_CANCEL of DCM_FORCE_RCRRP_OK zijn alle invoerparameters ingesteld op 0x00 [SWS_Dcm_91085].
• Buffer en bloklengte: De parameter DataLength geeft aan de invoerzijde de maximaal toegestane bloklengte door (overeenkomend met de aan de client gemelde waarde maxNumberOfBlockLength) en retourneert aan de uitvoerzijde de daadwerkelijk in Data beschikbaar gestelde bytelengte, die de invoerwaarde niet mag overschrijden [SWS_Dcm_91085]. Interpretatie: Hoewel Data in de interface formeel als in-parameter is gedeclareerd, dient deze vermoedelijk voor de overdracht van de uit te lezen payload. Vraag Q-53de8a0bdbc4a2b4 (open)
• Retourwaarden: De operatie levert E_OK bij succesvolle gegevensbeschikbaarstelling, DCM_E_PENDING bij nog niet voltooide verwerking of DCM_E_FORCE_RCRRP wanneer de applicatie het verzenden van een tussenbericht (Response Pending, NRC 0x78) wil afdwingen [SWS_Dcm_91085].

Mislukt de verwerking in de applicatie, dan wordt E_NOT_OK geretourneerd. In dit foutgeval verzendt de DCM-module een negatief UDS-antwoord (NRC) naar de client, waarvan de foutcode overeenkomt met de in de uitvoerparameter ErrorCode ingestelde waarde [SWS_Dcm_91085].

De functie Dcm_MainFunction dient voor de verwerking van de centrale taken van de hoofdlus van de Diagnostic Communication Manager ([SWS_Dcm_00053]). Deze heeft de signatuur void Dcm_MainFunction(void) en levert geen retourwaarden op. Aangezien deze via de header SchM_Dcm.h beschikbaar wordt gesteld, vindt de aanroep ervan vermoedelijk cyclisch plaats in de context van een schedulertaak van de basissoftware. Vraag Q-e083a72aae447ab5 (open)

Een essentiële taak is de besturing en cyclusoverstijgende voortzetting van asynchrone processen:

• Als een operatie met Dcm_OpStatusType de retourwaarde DCM_E_PENDING oplevert, roept het DCM de operatie bij elke aanroep van Dcm_MainFunction opnieuw aan met OpStatus = DCM_PENDING, zolang deze status aanhoudt ([SWS_Dcm_00530]).
• Als Dem_ClearDTC() de status DEM_PENDING retourneert, wordt de functie in de volgende cyclus van Dcm_MainFunction opnieuw aangeroepen; het DCM verzendt indien nodig NRC 78 (ResponsePending) ([SWS_Dcm_00703]).
• Aanroepen van Dem_SetDTCFilter() met gezette parameter FilterForFault-DetectionCounter moeten verplicht plaatsvinden in de context van Dcm_MainFunction ([SWS_Dcm_00519]).
• Na bevestiging van een RCR-RP-overdracht roept het DCM operaties zoals Dcm_WriteMemory of Dcm_ReadMemory vanuit Dcm_MainFunction opnieuw aan met OpStatus = DCM_FORCE_RCRRP_OK ([SWS_Dcm_00529], [SWS_Dcm_00838], [SWS_Dcm_00840]).
• Als bij Xxx_GetSecurityAttemptCounter de waarde DCM_E_PENDING wordt gemeld, wordt de aanroep onderbroken en in de volgende cyclus voortgezet ([SWS_Dcm_01351]); bij overschrijding van de geconfigureerde time-out breekt het DCM de openstaande operatie af met OpStatus = DCM_CANCEL ([SWS_Dcm_01352]).

De functie Xxx_GetSeed (beschikbaar gesteld via Dcm_Externals.h) dient voor het asynchroon beschikbaar stellen van een seed-waarde door de applicatie voor de DCM-module [SWS_Dcm_01151]. Deze wordt aangeroepen zodra een UDS-aanvraag van de service SecurityAccess (0x27) met het subfunctietype “requestSeed” wordt ontvangen en het aangevraagde beveiligingsniveau nog niet actief is [SWS_Dcm_00862], [SWS_Dcm_00324].

Aanroepcontext en parameters

De interface is gedefinieerd als niet re-entrant (Non Reentrant) en werkt asynchroon [SWS_Dcm_01151]:

• SecurityAccessDataRecord: Pointer naar aanvullende invoergegevens voor de seed-berekening; de minimumomvang bedraagt één byte conform DcmDspSecurityADRSize [SWS_Dcm_01151].
• OpStatus: Geeft de actuele status van de asynchrone operatie aan [SWS_Dcm_01151].
• Seed: Uitvoerpointer via welke de applicatie de berekende seed beschikbaar stelt [SWS_Dcm_01151].
• ErrorCode: Uitvoerparameter voor het retourneren van een negatieve foutcode (NRC) [SWS_Dcm_01151].

Retourwaarden en foutafhandeling

• E_OK: De seed is succesvol bepaald en beschikbaar gesteld [SWS_Dcm_01151].
• DCM_E_PENDING: De berekening is nog niet voltooid; voor de afronding zijn vervolgberekeningen resp. -aanroepen noodzakelijk [SWS_Dcm_01151].
• E_NOT_OK: De aanvraag is mislukt. In dit geval zendt de DCM-module een negatief UDS-antwoord met de in parameter ErrorCode doorgegeven NRC-waarde [SWS_Dcm_01151], [SWS_Dcm_00659].

Integratie-instructies

Afhankelijk van de configuratie van DcmDspSecurityUsePort vindt de koppeling plaats als C-functie bij USE_ASYNCH_FNC (gerefereerd via DcmDspSecurityGetSeedFnc) [SWS_Dcm_00862] of als Rte-operatie bij USE_ASYNCH_CLIENT_SERVER [SWS_Dcm_00324]. Indien er geen aanvullende toegangsgegevens hoeven te worden doorgegeven, wordt de alternatieve functiesignatuur zonder de parameter SecurityAccessDataRecord gebruikt [SWS_Dcm_91003].

De functie Xxx_GetSeed dient als asynchrone interface van de module DCM naar de applicatie om in het kader van de UDS-dienst SecurityAccess (0x27) bij een verzoek van het type “requestSeed” een seed-waarde beschikbaar te stellen [SWS_Dcm_91003], [SWS_Dcm_00862]. De aanroep vindt plaats door de DCM-DSP-submodule, mits het beveiligingsniveau nog niet actief is en de configuratie in USE_ASYNCH_CLIENT_SERVER of USE_ASYNCH_FNC voorziet [SWS_Dcm_00324], [SWS_Dcm_00862].

De interface is asynchroon en niet-reentrant (Non Reentrant) uitgevoerd [SWS_Dcm_91003]. De besturing van de verwerkingsvoortgang vindt plaats via de ingangsparameter OpStatus (type Dcm_OpStatusType) [SWS_Dcm_91003]. Als retourwaarden zijn E_OK bij succesvolle beschikbaarstelling, E_NOT_OK in geval van een fout en DCM_E_PENDING gedefinieerd wanneer de seed-generatie nog voortduurt en verdere aanroepen vereist zijn [SWS_Dcm_91003]. De gegenereerde waarde wordt via de pointer Seed (inout/out-buffer) overgedragen [SWS_Dcm_91003].

Mislukt de operatie en levert Xxx_GetSeed E_NOT_OK op, dan moet de DCM-module een negatief antwoord (NRC) verzenden met de foutcode die via de uitgangsparameter ErrorCode (Dcm_NegativeResponseCodeType) is ingesteld [SWS_Dcm_91003], [SWS_Dcm_00659]. De dienst is gedeclareerd via de header Dcm_Externals.h [SWS_Dcm_91003].

De functie Xxx_CompareKey wordt door de Diagnostic Communication Manager ([SWS_Dcm_91004]) asynchroon en niet-reentrant aangeroepen om een ontvangen sleutel in het kader van de UDS-dienst SecurityAccess (0x27, subfunctie sendKey) te verifiëren tegen de interne logica van de applicatie ([SWS_Dcm_00863]). Deze wordt gebruikt wanneer de toegangsstatus nog niet actief is, het seed-verzoek succesvol was en de configuratieparameter DcmDspSecurityUsePort is ingesteld op USE_ASYNCH_CLIENT_SERVER ([SWS_Dcm_00324]) dan wel volgens [SWS_Dcm_00863] de functie-interface via USE_ASYNCH_FNC/DcmDspSecurityCompareKeyFnc is geconfigureerd. De interface is gedeclareerd in Dcm_Externals.h ([SWS_Dcm_91004]).

De overdracht omvat de te controleren sleutelpointer Key, de actuele operationele status OpStatus (van het type Dcm_OpStatusType) en de pointer ErrorCode voor de in geval van een fout uit te voeren negatieve antwoordcode ([SWS_Dcm_91004]). Als retourwaarden zijn gespecificeerd:

• E_OK: Sleutelcontrole succesvol ([SWS_Dcm_91004]).
• DCM_E_PENDING: Controle nog niet voltooid; verdere aanroepen door de DCM-module ter beëindiging zijn vereist ([SWS_Dcm_91004]).
• E_NOT_OK: Verwerking niet succesvol. De DCM verzendt daarop een negatief UDS-antwoord met de in ErrorCode ingestelde NRC, zonder het interne beveiligingsniveau te wijzigen of de foutpogingenteller (AttemptCounter) te verhogen ([SWS_Dcm_01150]).
• DCM_E_COMPARE_KEY_FAILED: Sleutel komt niet overeen ([SWS_Dcm_91004]).

Mislukt de sleutelvergelijking (DCM_E_COMPARE_KEY_FAILED), dan wordt bij geconfigureerde DcmDspSecurityNumAttDelay de AttemptCounter geïncrementeerd ([SWS_Dcm_01397]). Ligt de teller onder de grenswaarde, dan verzendt de DCM de NRC 0x35 (InvalidKey) ([SWS_Dcm_00660]). Bereikt of overschrijdt het aantal mislukte pogingen de geconfigureerde limiet DcmDspSecurityNumAttDelay, dan start de DCM de SecurityDelayTimer met de tijdsduur DcmDspSecurityDelayTime en verzendt de NRC 0x36 (exceededNumberOfAttempts) ([SWS_Dcm_01349]). In beide gevallen blijft het beveiligingsniveau ongewijzigd.

De asynchrone en niet-re-entrante functie [SWS_Dcm_01152] leest bij de initialisatie van de DCM de actuele foutieve-pogingenteller voor een geconfigureerd beveiligingsniveau uit de applicatie uit. De aanroep vindt plaats voor elk item in DcmDspSecurityRow waarbij de configuratieparameter DcmDspSecurityAttemptCounterEnabled op TRUE is ingesteld [SWS_Dcm_01154].

De programmabesturing wordt gevoerd via de parameter OpStatus met de waarden DCM_INITIAL, DCM_PENDING of DCM_CANCEL [SWS_Dcm_01152]. Geeft de functie DCM_E_PENDING terug, dan onderbreekt de DCM de aanroepketen en zet deze voort in de daaropvolgende cyclus van Dcm_MainFunction() [SWS_Dcm_01351]. Wordt de na de eerste cyclus geconfigureerde tijdbewaking DcmDspSecurityMaxAttemptCounterReadoutTime overschreden, dan breekt de DCM de nog openstaande bewerking af met DCM_CANCEL [SWS_Dcm_01352].

In geval van succes levert de interface E_OK op en draagt de tellerstand over via de uitvoerparameter AttemptCounter [SWS_Dcm_01152]. Geeft de aanroep E_NOT_OK terug, dan stelt de DCM de teller automatisch in op de voor dit beveiligingsniveau geconfigureerde waarde DcmDspSecurityNumAttDelay [SWS_Dcm_01156].

Zolang niet alle tellerwaarden definitief zijn vastgesteld of geannuleerd, wijst de DCM elke aanvraag voor SecurityAccess (0x27) om een seed aan te vragen af met de negatieve responscode conditionsNotCorrect (0x22) [SWS_Dcm_01354]. Na voltooiing van de opvraagketen controleert de DCM de tellerwaarden: bereikt of overschrijdt ten minste één teller de drempelwaarde DcmDspSecurityNumAttDelay, dan start de DCM de SecurityDelayTimer met de hoogste waarde uit DcmDspSecurityDelayTimeOnBoot en DcmDspSecurityDelayTime [SWS_Dcm_01355].

De functie Xxx_SetSecurityAttemptCounter dient ertoe de pogingenteller voor een specifiek beveiligingsniveau in de applicatie in te stellen ([SWS_Dcm_01153]). Deze wordt beschikbaar gesteld via de header Dcm_Externals.h.

Aanroep en semantiek

De uitvoering vindt asynchroon plaats en is gespecificeerd als niet re-entrant (Non Reentrant) ([SWS_Dcm_01153]). De aanroep stuurt het verloop via de parameter OpStatus met de waarden DCM_INITIAL, DCM_PENDING of DCM_CANCEL. De nieuwe tellerwaarde wordt via de ingangsparameter AttemptCounter (uint8) doorgegeven.

Retourwaarden en foutafhandeling

Als retourtype wordt Std_ReturnType gebruikt ([SWS_Dcm_01153]):

• E_OK: Het verzoek is succesvol afgerond.
• E_NOT_OK: De uitvoering was niet succesvol.
• DCM_E_PENDING: De verwerking is nog niet beëindigd; verdere aanroepen voor voltooiing zijn vereist.

Wordt een lopende asynchrone operatie afgebroken, dan geeft de DCM de status DCM_CANCEL door ([SWS_Dcm_01153]).

Samenspel en randvoorwaarden

De DCM-module roept Xxx_SetSecurityAttemptCounter aan zodra deze de pogingenteller heeft gewijzigd, om de applicatie over de update te informeren ([SWS_Dcm_01155]). Dit vereist dat de configuratieparameter DcmDspSecurityAttemptCounterEnabled voor de bijbehorende DcmDspSecurityRow op TRUE is geconfigureerd ([SWS_Dcm_01155]). Aangezien de interface niet re-entrant is, moet de applicatie gelijktijdige uitvoering voor dezelfde instantie uitsluiten ([SWS_Dcm_01153]).

De synchrone functie Xxx_ReadData vraagt bij de applicatie de actuele gegevenswaarde van een DID of PID op wanneer de configuratieparameter DcmDspDataUsePort op USE_DATA_SYNCH_CLIENT_SERVER is ingesteld [SWS_Dcm_00793]. De interface wordt bereitgesteld via de header Dcm_Externals.h en heeft de service-ID 0x34 [SWS_Dcm_00793]. De aangeroepen applicatie kopieert de opgevraagde gebruikersgegevens direct naar de doorgegeven buffer Data [SWS_Dcm_00793].

Wat betreft de retourwaarde is vastgelegd dat de aanroep zonder uitzondering E_OK retourneert [SWS_Dcm_00793]. Specifieke foutcodes, negatieve terugmeldingen of DET-/DEM-meldingen zijn voor deze signatuur niet gespecificeerd. Interpretatie: het mislukken van het bereitstellen van gegevens is op dit interfaceniveau vermoedelijk niet voorzien, aangezien in tegenstelling tot de asynchrone variant [SWS_Dcm_91005] noch een parameter ErrorCode voor negatieve responscodes (NRC), noch retourwaarden zoals E_NOT_OK of DCM_E_PENDING bestaan. Vraag Q-adcf0171ecfd37c4 (open)

Wat betreft gelijktijdigheid en randvoorwaarden is de functie gespecificeerd als niet re-entrant (Non Reentrant) en werkt deze volledig synchroon [SWS_Dcm_00793]. Het samenspel met diagnoseverzoeken vindt plaats in meerdere scenario's:

• Bij ontvangst van een OBD-service-$01-verzoek met niet-beschikbaarheids-PID's roept de DCM de telkens geconfigureerde Xxx_ReadData-functies voor alle gegevens van de PID aan om de responswaarden te registreren [SWS_Dcm_00408].
• Bij een UDS-verzoek van de dienst 0x22 (ReadDataByIdentifier) met niet-beschikbaarheids-identifiers roept de DCM de functies voor alle gegevens van de OBDDataIdentifier [SWS_Dcm_01380] en van de OBDInfoTypeDataIdentifier [SWS_Dcm_01389] aan.
• Indien daarentegen asynchroon gedrag vereist is, treden de afzonderlijke signaturen met OpStatus conform [SWS_Dcm_91006] respectievelijk [SWS_Dcm_91005] in werking.

De functie Xxx_ReadData dient ertoe gegevenswaarden van een DID of PID asynchroon bij de applicatie op te vragen, mits de parameter DcmDspDataUsePort op USE_DATA_ASYNCH_CLIENT_SERVER is geconfigureerd ([SWS_Dcm_91006]). Deze wordt gedeclareerd via het headerbestand Dcm_Externals.h ([SWS_Dcm_91006]).

Bij de aanroep stuurt de parameter OpStatus (type Dcm_OpStatusType) de voortgang van de lopende operatie, terwijl via de pointer Data (type uint8*) de uitvoerbuffer wordt doorgegeven waarin de opgevraagde gegevens moeten worden gekopieerd ([SWS_Dcm_91006]). Als retourwaarden zijn E_OK bij succesvolle afronding en DCM_E_PENDING gedefinieerd, mits de verwerking nog voortduurt en verdere aanroepen voor voltooiing vereist ([SWS_Dcm_91006]).

De DCM-module integreert deze functie in de volgende diagnoseprocessen:

• Bij ontvangst van een OBD Service $01 leest de DCM de actuele PID-waarden (uitgezonderd beschikbaarheids-PID's) in via de geconfigureerde Xxx_ReadData-functies ([SWS_Dcm_00408]).
• Bij UDS Service 0x22 (ReadDataByIdentifier) roept de DCM de functie voor OBDDataIdentifier ([SWS_Dcm_01380]) en OBDInfoTypeDataIdentifier ([SWS_Dcm_01389]) aan.

Wat betreft de uitvoering is de functie gespecificeerd als niet re-entrant (Non Reentrant) ([SWS_Dcm_91006]). In tegenstelling tot de synchrone interface ([SWS_Dcm_00793]) of de asynchrone variant met aanvullende ErrorCode-parameter ([SWS_Dcm_91005]) voorziet deze functievorm niet in een directe teruggave van een negatieve responscode.

De functie Xxx_ReadData vraagt asynchroon bij de applicatie de gegevenswaarde van een DID of PID op, mits de configuratieparameter DcmDspDataUsePort op USE_DATA_ASYNCH_CLIENT_SERVER is ingesteld [SWS_Dcm_91005]. De functiedeclaratie wordt via het interfacebestand Dcm_Externals.h beschikbaar gesteld [SWS_Dcm_91005].

De interface heeft de volgende aanroep- en afloopkarakteristieken:

• Semantiek en parameters: De ingangsparameter OpStatus bestuurt de voortgang van de lopende operatie [SWS_Dcm_91005]. Bij succesvolle afronding worden de opgevraagde gebruikersgegevens naar de uitgangsbuffer Data gekopieerd en wordt E_OK geretourneerd [SWS_Dcm_91005]. Heeft de applicatie meer verwerkingstijd nodig, dan signaleert deze DCM_E_PENDING, waarna vervolgaanroepen vereist zijn [SWS_Dcm_91005].
• Foutafhandeling: Mislukt de operatie en wordt E_NOT_OK geretourneerd, dan evalueert de DCM-module de uitgangsparameter ErrorCode en verzendt een negatief diagnose-antwoord met deze NRC-code [SWS_Dcm_91005].
• Gelijktijdigheid: De functie is gedefinieerd als niet-reentrant (Non Reentrant) [SWS_Dcm_91005]. Interpretatie: De herhaalde aanroepen bij aanhangige verwerking vinden vermoedelijk sequentieel plaats in de cyclus van de DCM-hoofdverwerking. Vraag Q-541226d5f242f7c2 (open)
• Interactie: De DCM-module roept de functie aan bij verzoeken van de OBD Service $01 voor niet-beschikbaarheids-PID's [SWS_Dcm_00408] evenals bij de UDS Service ReadDataByIdentifier (0x22) voor OBDDataIdentifier [SWS_Dcm_01380] en OBDInfoTypeDataIdentifier [SWS_Dcm_01389]. In vergelijking met de synchrone variant [SWS_Dcm_00793] of asynchrone interfaces zonder NRC-parameter [SWS_Dcm_91006] maakt deze signatuur een specifieke negatieve foutoverdracht mogelijk.

Gebruik

De functie Xxx_WriteData wordt aangeroepen door de Diagnostic Communication Manager (DCM) om de applicatie te verzoeken een DID-datawaarde (Data Identifier) te schrijven ([SWS_Dcm_00794]). De declaratie wordt beschikbaar gesteld via de header Dcm_Externals.h. De aanroep vindt synchroon plaats onder de Service-ID 0x51 ([SWS_Dcm_00794]).

Parameters en retourwaarden:

• Data (in): pointer naar de buffer met de te schrijven payload ([SWS_Dcm_00794]).
• ErrorCode (out): pointer naar de variabele waarin bij een mislukking de negatieve diagnosecode (NRC) moet worden ingevuld ([SWS_Dcm_00794]).
• Retourwaarde (Std_ReturnType): E_OK signaleert succesvol schrijven, E_NOT_OK het mislukken van de operatie ([SWS_Dcm_00794]).

Foutafhandeling

Retourneert de functie E_NOT_OK, dan leest de DCM-module de parameter ErrorCode uit en verzendt een negatief diagnose-antwoord met deze NRC-code ([SWS_Dcm_00794]).

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-reentrant (Non Reentrant) ([SWS_Dcm_00794]) en mag niet gelijktijdig worden uitgevoerd.

Samenspel

Aangezien er geen lengteparameter bestaat, is deze variant vermoedelijk bedoeld voor DID's met een vaste datalengte. Vraag Q-ebc074ac1cb66aaa (open) Voor DID's met variabele lengte stelt AUTOSAR de synchrone signatuur met de parameter DataLength beschikbaar ([SWS_Dcm_91007]). Bovendien bestaan er voor langdurige afhandelingen asynchrone varianten met OpStatus en mogelijke retournering van DCM_E_PENDING, zowel met vaste datalengte ([SWS_Dcm_91008]) als met variabele lengteparameter ([SWS_Dcm_91009]).

De callback-functie Xxx_WriteData dient ertoe de applicatie te verzoeken de gegevenswaarde van een Data Identifier (DID) te schrijven [SWS_Dcm_91007]. De interface is gedeclareerd via de header Dcm_Externals.h en heeft de service-ID 0x52 [SWS_Dcm_91007]. De aanroep geschiedt synchroon en is gespecificeerd als niet re-entrant (Non Reentrant), waardoor gelijktijdige aanroepen voor dezelfde functie niet mogen plaatsvinden [SWS_Dcm_91007].

Aan parameters ontvangt de functie de buffer Data met de te schrijven gebruikersgegevens en DataLength met de lengtespecificatie in bytes [SWS_Dcm_91007]. Als retourwaarde levert zij het type Std_ReturnType met E_OK bij succesvolle uitvoering of E_NOT_OK in geval van een fout [SWS_Dcm_91007]. Mislukt de operatie en retourneert zij E_NOT_OK, dan moet de DCM-module een negatieve respons naar de diagnosetester sturen; daarbij komt de Negative Response Code (NRC) overeen met de via de pointerparameter ErrorCode verzonden waarde [SWS_Dcm_91007].

In het totale systeem vormt [SWS_Dcm_91007] de synchrone variant voor DID's met expliciete lengtespecificatie. Aanvullend daarop bestaat met [SWS_Dcm_00794] (service-ID 0x51) een synchrone variant zonder de parameter DataLength. Voor langere schrijfprocessen voorziet de standaard in asynchrone interfaces: [SWS_Dcm_91008] (service-ID 0x35) zonder lengtespecificatie en [SWS_Dcm_91009] (service-ID 0x3e) met DataLength. Beide asynchrone functies worden bestuurd via OpStatus en kunnen naast E_OK en E_NOT_OK ook DCM_E_PENDING retourneren [SWS_Dcm_91008] [SWS_Dcm_91009].

Gebruik

De functie Xxx_WriteData verzoekt de applicatie de gegevenswaarde van een Data Identifier (DID) te schrijven [SWS_Dcm_91008]. Zij is gedeclareerd in het headerbestand Dcm_Externals.h en heeft een asynchrone uitvoeringssemantiek met de service-ID 0x35 [SWS_Dcm_91008].

De parameters en retourwaarden zijn als volgt onderverdeeld [SWS_Dcm_91008]:

• Data (IN): Pointer naar de buffer die de te schrijven gegevens bevat.
• OpStatus (IN): Status van de actuele operatie ter besturing van het asynchrone aanroepverloop.
• ErrorCode (OUT): Pointer naar de foutcode (NRC) die in geval van een fout wordt ingesteld.
• Retourwaarde (Std_ReturnType): E_OK bevestigt het succesvolle schrijfproces, E_NOT_OK meldt een mislukking en DCM_E_PENDING geeft aan dat de operatie nog voortduurt en verdere aanroepen voor voltooiing vereist.

Foutafhandeling en gelijktijdigheid

Retourneert de aanroep de waarde E_NOT_OK, dan moet de DCM-module een negatieve respons verzenden met de in de uitvoerparameter ErrorCode doorgegeven NRC-waarde [SWS_Dcm_91008]. De functie is gespecificeerd als niet re-entrant [SWS_Dcm_91008], zodat gelijktijdige of overlappende aanroepen voor dezelfde instantie niet zijn toegestaan.

Interactie en varianten

Deze interface conform [SWS_Dcm_91008] dekt de asynchrone schrijftoegang zonder afzonderlijke lengteparameter af. AUTOSAR definieert hiervoor verwante varianten in de DCM: een synchrone signatuur zonder lengtespecificatie [SWS_Dcm_00794] en signaturen met een aanvullende parameter DataLength voor synchrone [SWS_Dcm_91007] en asynchrone processen [SWS_Dcm_91009].

Gebruik en semantiek

De functie Xxx_WriteData verzoekt de applicatie de gegevenswaarde van een Data Identifier (DID) te schrijven [SWS_Dcm_91009]. Deze wordt gedeclareerd via het headerbestand Dcm_Externals.h en heeft de service-ID 0x3e [SWS_Dcm_91009]. De uitvoering geschiedt asynchroon (Asynchronous), waarvoor de volgende parameters worden doorgegeven:

• Data (in): Pointer naar de buffer met de te schrijven gebruikersgegevens [SWS_Dcm_91009].
• DataLength (in): Lengte van de te schrijven gegevens in bytes [SWS_Dcm_91009].
• OpStatus (in): Operatiestatus (Dcm_OpStatusType) ter besturing van de asynchrone verwerkingsvoortgang [SWS_Dcm_91009].
• ErrorCode (out): Pointer voor de opname van een negatieve responscode (NRC) in geval van een fout [SWS_Dcm_91009].

Als retourwaarden van het type Std_ReturnType zijn E_OK (schrijfverzoek succesvol afgerond), E_NOT_OK (verzoek mislukt) en DCM_E_PENDING gedefinieerd [SWS_Dcm_91009]. De status DCM_E_PENDING signaleert dat het proces nog niet is voltooid en verdere vervolgaanroepen voor voltooiing vereist zijn [SWS_Dcm_91009]. Interpretatie: de DCM roept de functie bij teruggave van DCM_E_PENDING met voortgezette OpStatus vermoedelijk zo lang cyclisch opnieuw aan totdat er een definitief resultaat voorligt. Vraag Q-fdbd734dab052f5c (open)

Foutafhandeling en gelijktijdigheid

Retourneert de functie de waarde E_NOT_OK, dan moet via de parameter ErrorCode de overeenkomstige foutcode worden bereitgesteld; de DCM-module stuurt vervolgens een negatieve respons met deze NRC-waarde [SWS_Dcm_91009]. Specifieke DET- of DEM-meldingen zijn in de payload voor deze interface niet gedefinieerd. Wat betreft gelijktijdigheid is de functie gespecificeerd als niet re-entrant (Non Reentrant) [SWS_Dcm_91009].

Samenspel en interfacevarianten

De signatuur [SWS_Dcm_91009] dekt asynchrone schrijftoegangen met expliciete lengtespecificatie af. In de DCM bestaan verdere varianten van Xxx_WriteData:

• Synchrone uitvoering zonder lengtespecificatie: [SWS_Dcm_00794] (service-ID 0x51).
• Synchrone uitvoering met lengtespecificatie: [SWS_Dcm_91007] (service-ID 0x52).
• Asynchrone uitvoering zonder lengtespecificatie: [SWS_Dcm_91008] (service-ID 0x35).

Gebruik

Met de functie Xxx_ReadDataLength verzoekt de DCM-module de applicatie om de gegevenslengte van een gegeven in bytes te bepalen en te retourneren [SWS_Dcm_00796]. De interface is gedeclareerd in de header Dcm_Externals.h en heeft de Service-ID 0x36 [SWS_Dcm_00796]. Het opvragen wordt synchroon uitgevoerd [SWS_Dcm_00796]. Via de uitvoerparameter DataLength van het type uint16* draagt de applicatie de bytelengte van de te lezen gegevens over aan het DCM [SWS_Dcm_00796]. Ingangs- of in-/uitgangsparameters zijn niet gedefinieerd [SWS_Dcm_00796]. Als retourwaarde levert de functie altijd E_OK van het type Std_ReturnType op [SWS_Dcm_00796].

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Dcm_00796]. Aangezien de functie synchroon werkt en volgens de specificatie altijd E_OK meldt, zijn er voor deze aanroep geen specifieke foutcodes of afwijkende statusretourwaarden voorzien [SWS_Dcm_00796].

Samenspel

Naast de synchrone functie bestaat er een gelijknamige asynchrone variant met de Service-ID 0x4c, die eveneens via Dcm_Externals.h beschikbaar wordt gesteld [SWS_Dcm_91010]. Terwijl de synchrone versie [SWS_Dcm_00796] zonder operatiestatus kan, vereist de asynchrone tegenhanger de invoerparameter OpStatus van het type Dcm_OpStatusType [SWS_Dcm_91010]. Bovendien kan de asynchrone interface naast E_OK de retourwaarde DCM_E_PENDING opleveren indien het verzoek nog niet is voltooid en verdere aanroepen vereist voor afronding [SWS_Dcm_91010].

De functie [SWS_Dcm_91010] (service-ID 0x4c) verzoekt de applicatie om de datalengte van een data-element in bytes te bepalen. Deze is gedeclareerd in de header Dcm_Externals.h en dient voor de Diagnostic Communication Manager (DCM) voor het flexibel opvragen van de lengte van diagnosedata.

Gebruik en semantiek

Bij de aanroep geeft de DCM-module de actuele voortgang door via de ingangsparameter OpStatus van het type Dcm_OpStatusType ([SWS_Dcm_91010]). Het resultaat van de opvraag schrijft de applicatie in de uitvoerparameter DataLength (type uint16*). Is de datalengte niet direct beschikbaar, dan signaleert de functie via de retourwaarde DCM_E_PENDING dat de verwerking voortduurt en verdere aanroepen vereist zijn ([SWS_Dcm_91010]). Zodra het resultaat gereed is, meldt de applicatie de afronding terug met E_OK.

Gelijktijdigheid en beperkingen

Volgens de specificatie is de functie geclassificeerd als niet-reentrant ([SWS_Dcm_91010]), waardoor gelijktijdige aanroepen door de DCM moeten worden uitgesloten. Aangezien de specificatie geen specifieke foutwaarden behalve DCM_E_PENDING voorschrijft, mag worden aangenomen dat de DCM bij teruggave van E_OK altijd uitgaat van een geldig ingestelde bytegrootte. Vraag Q-e7ecd3a518e2cbcb (open)

Samenspel

De asynchrone interface [SWS_Dcm_91010] verschilt van de verwante synchrone variant [SWS_Dcm_00796] (service-ID 0x36). Laatstgenoemde heeft geen parameter OpStatus, wordt synchroon uitgevoerd en retourneert de lengte altijd direct met E_OK. [SWS_Dcm_91010] stelt de applicatie daarentegen in staat om tijdsintensieve berekeningen asynchroon over meerdere aanroepcycli te spreiden.

De synchrone callout-functie Xxx_ConditionCheckRead wordt via het headerbestand Dcm_Externals.h ter beschikking gesteld en dient ertoe bij de applicatie na te vragen of aan de voorwaarden voor het uitlezen van de diagnosedata is voldaan [SWS_Dcm_00797].

De interface heeft geen invoerparameters en signaleert de status van de controle via de retourwaarde van het type Std_ReturnType [SWS_Dcm_00797]:

• E_OK: De controle was succesvol, aan de voorwaarden voor het lezen van de data is voldaan [SWS_Dcm_00797].
• E_NOT_OK: De controle is mislukt, het uitlezen is niet toegestaan [SWS_Dcm_00797].

Levert de functie E_NOT_OK terug, dan verzendt de DCM-module een negatief antwoord (Negative Response) met de foutcode die de applicatie via de uitvoerparameter ErrorCode (type Dcm_NegativeResponseCodeType*) heeft doorgegeven [SWS_Dcm_00797].

Wat betreft de concurrency is de functie gespecificeerd als niet-re-entrant (Non Reentrant) en wordt deze met de Service-ID 0x49 synchroon uitgevoerd [SWS_Dcm_00797]. De controle dient aan de applicatiezijde daarom direct zonder blokkerende wachttijden te worden geëvalueerd, om vertraging van de synchrone DCM-aanroeper te voorkomen. Vraag Q-ada29c78c29d961e (open)

In afwijking van deze synchrone operatie definieert [SWS_Dcm_91011] een asynchrone variant onder de Service-ID 0x37. Deze maakt aanvullend gebruik van de invoerparameter OpStatus (type Dcm_OpStatusType) en kan naast E_OK en E_NOT_OK ook DCM_E_PENDING teruggeven wanneer vervolgstappen voor de beëindiging van de controle noodzakelijk zijn [SWS_Dcm_91011].

Gebruik en semantiek

De functie Xxx_ConditionCheckRead wordt beschikbaar gesteld via het headerbestand Dcm_Externals.h en dient ertoe bij de applicatiesoftware te controleren of aan de voorwaarden voor het uitlezen van de diagnosedata is voldaan [SWS_Dcm_91011]. De uitvoering vindt plaats onder het service-ID 0x37 op asynchrone wijze [SWS_Dcm_91011]. Via de ingangsparameter OpStatus (type Dcm_OpStatusType) wordt de actuele status van de lopende operatie doorgegeven [SWS_Dcm_91011].

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie een status van het type Std_ReturnType [SWS_Dcm_91011]:

• E_OK: Het verzoek was succesvol en aan de leesvoorwaarden is voldaan [SWS_Dcm_91011].
• E_NOT_OK: De controle is mislukt [SWS_Dcm_91011]. In dat geval moet de applicatie via de uitvoerparameter ErrorCode een negatieve antwoordcode (NRC) van het type Dcm_NegativeResponseCodeType instellen; de DCM-module stuurt vervolgens een negatief antwoord met deze NRC [SWS_Dcm_91011].
• DCM_E_PENDING: De controle is nog niet voltooid, zodat verdere aanroepen voor de voltooiing noodzakelijk zijn [SWS_Dcm_91011].

Gelijktijdigheid en afbakening

De interface is gespecificeerd als niet-reentrant (Non Reentrant) [SWS_Dcm_91011]. In tegenstelling tot deze asynchrone variant definieert [SWS_Dcm_00797] onder het service-ID 0x49 een synchrone signatuur zonder OpStatus-parameter, die uitsluitend E_OK of E_NOT_OK retourneert [SWS_Dcm_00797].

De asynchrone interface Xxx_GetScalingInformation wordt beschikbaar gesteld via de header Dcm_Externals.h en dient om schaalinformatie van een data-element op te vragen uit de applicatie [SWS_Dcm_91012]. De DCM-module roept deze functie aan zodra een diagnoseverzoek voor de UDS-dienst ReadScalingByIdentifier wordt ontvangen, en wel voor elk gegeven dat voor de opgevraagde DID is geconfigureerd [SWS_Dcm_00394].

Parameters en retourwaarden

De functie definieert de volgende parameters en semantiek [SWS_Dcm_91012]:

• OpStatus (in): Geeft de actuele status van de lopende bewerking door.
• ScalingInfo (out): Buffer voor het opnemen van de schaalinformatie (scalingByte en scalingByteExtension).
• ErrorCode (out): Neemt de negatieve antwoordcode op indien de bewerking mislukt.

Als retourwaarden zijn E_OK bij een succesvolle afronding, E_NOT_OK bij een fout en DCM_E_PENDING gespecificeerd indien de verwerking nog niet is voltooid en verdere aanroepen nodig heeft voor de voltooiing [SWS_Dcm_91012].

Foutafhandeling en gelijktijdigheid

Retourneert de aanroep E_NOT_OK, dan moet de DCM-module een negatief antwoord verzenden waarvan de NRC overeenkomt met de via de uitvoerparameter ErrorCode ter beschikking gestelde waarde [SWS_Dcm_91012]. De functie is gespecificeerd als niet-reentrant (Non Reentrant) [SWS_Dcm_91012]. Interpretatie: Of deze asynchrone functie met OpStatus of de alternatief gespecificeerde synchrone variant zonder OpStatus [SWS_Dcm_00798] wordt aangeroepen, zal vermoedelijk afhangen van de configuratie van de desbetreffende DID. Vraag Q-c4054a798f17a52c (open)

De functie Xxx_ReturnControlToECU wordt via de header Dcm_Externals.h beschikbaar gesteld en verzoekt de applicatie om de controle over een in-/uitvoersturing (IOControl) terug te geven aan de ECU [SWS_Dcm_01285]. De aanroep geschiedt synchroon en is gespecificeerd als niet re-entrant [SWS_Dcm_01285].

Parameters en varianten

De functiesignatuur is afhankelijk van de configuratie van het externe stuurmasker [SWS_Dcm_01285]:

• Als DcmDspDidControlMask op DCM_CONTROLMASK_EXTERNAL is ingesteld en de maskergrootte maximaal vier bytes bedraagt (DcmDspDidControlMaskSize <= 0x04), wordt de ingangsparameter controlMask van het type Dcm_ControlMask_{DID}Type doorgegeven [SWS_Dcm_01285].
• Bedraagt de maskergrootte vijf of meer bytes (DcmDspDidControlMaskSize >= 0x05), dan wordt in plaats daarvan de pointer controlMask2 van het type uint8* gebruikt [SWS_Dcm_01285].
• Via de uitgangsparameter ErrorCode (type Dcm_NegativeResponseCodeType*) verzendt de functie in geval van een fout de specifieke negatieve responscode (NRC) naar de DCM [SWS_Dcm_01285].

Retourwaarden en foutafhandeling

De functie levert de status Std_ReturnType terug. Bij een succesvolle teruggave van de controle meldt de applicatie E_OK [SWS_Dcm_01285]. Mislukt de operatie, dan moet de functie E_NOT_OK retourneren; in dat geval stuurt de DCM-module een negatief antwoord met de in ErrorCode opgeslagen NRC naar de diagnosetester [SWS_Dcm_01285].

Interactie en aanroepcontext

De DCM roept de geconfigureerde functie-interface (parameter DcmDspDataReturnControlToEcuFnc) aan wanneer DcmDspDataUsePort op USE_DATA_SYNCH_FNC, USE_DATA_ASYNCH_FNC of USE_DATA_ASYNCH_FNC_ERROR is geconfigureerd [SWS_Dcm_01435]. Naast reguliere diagnoseacties wordt Xxx_ReturnControlToECU door de DCM in het bijzonder aangeroepen wanneer een actieve IO-sturingssequentie moet worden afgebroken [SWS_Dcm_01435].

De synchrone functie-interface Xxx_ResetToDefault wordt beschikbaar gesteld via de header Dcm_Externals.h en dient ertoe een applicatie te verzoeken om een I/O-aansturing (IOControl) te resetten naar de standaardwaarde [SWS_Dcm_01286].

Aanroepcontext en parameters

De functie heeft het service-ID 0x4d, werkt synchroon en is gespecificeerd als niet-reentrant [SWS_Dcm_01286]. Afhankelijk van de geconfigureerde grootte van het externe sturingsmasker wordt een van twee alternatieve ingangsparameters meegegeven:

• controlMask (type Dcm_ControlMask_{DID}Type) wordt toegepast wanneer DcmDspDataUsePort is geconfigureerd op USE_DATA_SYNCH_FNC, DcmDspDidControlMask op DCM_CONTROLMASK_EXTERNAL staat en DcmDspDidControlMaskSize ten hoogste 0x04 bedraagt [SWS_Dcm_01286].
• controlMask2 (type uint8*) wordt gebruikt wanneer onder identieke randvoorwaarden DcmDspDidControlMaskSize groter dan of gelijk aan 0x05 is geconfigureerd [SWS_Dcm_01286].

Retourwaarden en foutafhandeling

Kon het resetten succesvol worden uitgevoerd, dan retourneert de functie E_OK [SWS_Dcm_01286]. Mislukt de bewerking, dan moet E_NOT_OK worden geretourneerd. In dat geval vult de applicatie de uitvoerparameter ErrorCode (type Dcm_NegativeResponseCodeType*) met de overeenkomstige negatieve antwoordcode (NRC), die de DCM-module als negatieve terugmelding naar de tester verzendt [SWS_Dcm_01286].

Interactie en afbakening

Is het systeem ontworpen voor asynchrone interfaceafhandeling via USE_DATA_ASYNCH_FNC of USE_DATA_ASYNCH_FNC_ERROR, dan wordt in plaats van deze synchrone functie de asynchrone variant met de extra parameter OpStatus en het service-ID 0x3c gebruikt [SWS_Dcm_01314].

De asynchrone functie [SWS_Dcm_01314] verzoekt de applicatie om een in-/uitgangsaansturing (IOControl) te resetten naar de standaardwaarde. Deze is gedeclareerd in Dcm_Externals.h en heeft het service-ID 0x3c. Via de parameter OpStatus wordt de voortgang van de bewerking geregeld. Bij nog niet voltooide verwerking retourneert de functie DCM_E_PENDING, terwijl een succesvolle afronding wordt bevestigd met E_OK.

Afhankelijk van de configuratie en de maskergrootte (DcmDspDidControlMaskSize tot 4 byte of vanaf 5 byte) wordt bij externe maskering aanvullend controlMask respectievelijk controlMask2 meegegeven [SWS_Dcm_01314]. Mislukt de reset, dan retourneert de functie E_NOT_OK. In dat geval moet via de uitvoerparameter ErrorCode een negatieve antwoordcode (NRC) worden doorgegeven, die de DCM-module als negatieve response naar de tester verzendt [SWS_Dcm_01314].

De functie is gespecificeerd als niet-reentrant (Non Reentrant) [SWS_Dcm_01314]. Deze wordt gebruikt wanneer DcmDspDataUsePort is ingesteld op USE_DATA_ASYNCH_FNC of USE_DATA_ASYNCH_FNC_ERROR. Voor synchrone interfaceconfiguraties (USE_DATA_SYNCH_FNC) bestaat als alternatief de synchrone variant zonder OpStatus [SWS_Dcm_01286].

Gebruik

De synchrone functie Xxx_FreezeCurrentState (in de elementencatalogus aangeduid als Xxx_FreezeCurrentStateManager) dient ertoe een applicatie te verzoeken de actuele toestand van een in- of uitvoersturing (IOControl) te bevriezen [SWS_Dcm_01290]. De functie is beschikbaar via het headerbestand Dcm_Externals.h en heeft de service-ID 0x4a AUTOSAR_SWS_DiagnosticCommunicationManager p. 279. (Interpretatie: het voorvoegsel Xxx fungeert daarbij vermoedelijk als tijdelijke aanduiding voor de betreffende applicatiemodule.) Vraag Q-f8c864cda732acc2 (open)

De interfaceparameters zijn afhankelijk van de configuratie van het externe stuurmasker (DcmDspDidControlMask op DCM_CONTROLMASK_EXTERNAL) [SWS_Dcm_01290]:

• controlMask (invoer, type Dcm_ControlMask_{DID}Type): Wordt doorgegeven wanneer de maskergrootte DcmDspDidControlMaskSize kleiner dan of gelijk aan 4 bytes (<= 0x04) is geconfigureerd.
• controlMask2 (invoer, type uint8*): Wordt in plaats daarvan gebruikt wanneer de maskergrootte ten minste 5 bytes (=> 0x05) omvat.
• ErrorCode (uitvoer, type Dcm_NegativeResponseCodeType*): Pointer voor de opname van een negatieve responscode bij fouten.

Foutafhandeling en retourwaarden

De functie levert als Std_ReturnType hetzij E_OK op bij succesvolle uitvoering, hetzij E_NOT_OK wanneer het verzoek niet succesvol was [SWS_Dcm_01290]. Doet zich een fout voor en wordt E_NOT_OK geretourneerd, dan moet de applicatie in parameter ErrorCode een specifieke negatieve responscode (NRC) invullen; de DCM-module zendt vervolgens een negatief diagnose-antwoord met deze NRC AUTOSAR_SWS_DiagnosticCommunicationManager p. 279.

Gelijktijdigheid en beperkingen

De operatie is gespecificeerd als niet re-entrant (Non Reentrant) [SWS_Dcm_01290]. Aanroepers moeten ervoor zorgen dat aanroepen voor dezelfde instantie synchroon en zonder gelijktijdige overlapping worden afgehandeld.

Gebruik en aanroepcontext

De asynchrone functie Xxx_FreezeCurrentState wordt door de DCM-module aangeroepen om bij de toepassingssoftware het bevriezen van de actuele toestand van een in-/uitvoersturing (IOControl) aan te vragen [SWS_Dcm_01315]. De declaratie wordt via de header Dcm_Externals.h ter beschikking gesteld [SWS_Dcm_01315].

Parameters en stuurmaskers

De aanroep vindt plaats met de volgende parameters [SWS_Dcm_01315]:

• OpStatus: Verzendt de actuele status van de asynchrone operatie (Dcm_OpStatusType).
• controlMask resp. controlMask2: Wanneer het stuurmasker extern is geconfigureerd (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL) en de asynchrone functie-interface wordt gebruikt, geeft de DCM afhankelijk van DcmDspDidControlMaskSize bij maximaal 4 bytes de parameter controlMask (van het type Dcm_ControlMask_{DID}Type) door en vanaf 5 bytes de pointer controlMask2 (uint8*).
• ErrorCode: Pointer naar Dcm_NegativeResponseCodeType voor de teruggave van een foutcode.

Retourwaarden en foutafhandeling

De functie retourneert een status van het type Std_ReturnType [SWS_Dcm_01315]:

• E_OK: Het bevriezen van de toestand is succesvol voltooid.
• DCM_E_PENDING: Het verzoek is nog in behandeling en vereist vervolgaanroepen.
• E_NOT_OK: De operatie is mislukt. In dit geval zendt de DCM een negatief diagnose-antwoord met de via ErrorCode ingestelde NRC-waarde.

Concurrency

De interface is gedefinieerd als niet re-entrant (Non Reentrant) en vereist daarom een gesynchroniseerde verwerking per sturingsinstantie [SWS_Dcm_01315].

De synchrone functie Xxx_ShortTermAdjustment verzoekt de applicatie om een bepaald I/O-signaal tijdelijk aan te passen [SWS_Dcm_00802]. Deze wordt beschikbaar gesteld via de header Dcm_Externals.h en heeft de Service-ID 0x50 [SWS_Dcm_00802].

Via de pointer ControlStateInfo ontvangt de functie de stuurtoestandsinformatie uit de parameter ControlOptionRecord van het diagnoseverzoek InputOutputControlByIdentifier [SWS_Dcm_00802]. Als er een extern stuurmasker is geconfigureerd (DcmDspDidControlMask == DCM_CONTROLMASK_EXTERNAL), wordt afhankelijk van DcmDspDidControlMaskSize aanvullend ofwel controlMask (tot 4 bytes) van het type Dcm_ControlMask_{DID}Type of controlMask2 (vanaf 5 bytes) als uint8* overgedragen [SWS_Dcm_00802].

Als retourwaarde levert de operatie Std_ReturnType op [SWS_Dcm_00802]:

• E_OK: De aanpassing van het I/O-signaal is succesvol uitgevoerd [SWS_Dcm_00802].
• E_NOT_OK: De aanpassing is mislukt [SWS_Dcm_00802]. In dit geval moet de applicatie via de uitvoerparameter ErrorCode een specifieke negatieve responscode (Dcm_NegativeResponseCodeType) instellen, die de DCM-module in het negatieve diagnoseresponsbericht terugzendt naar de tester [SWS_Dcm_00802].

De functie is niet-re-entrant (Non Reentrant) en wordt synchroon aangeroepen [SWS_Dcm_00802]. Deze synchrone variant wordt gebruikt wanneer het gegevenselement is geconfigureerd voor synchrone functieaanroepen (DcmDspDataUsePort == USE_DATA_SYNCH_FNC) [SWS_Dcm_00802]. Voor asynchroon geconfigureerde poorten (USE_DATA_ASYNCH_FNC of USE_DATA_ASYNCH_FNC_ERROR) bestaat daarentegen de asynchrone variant met Service-ID 0x55 en een uitgebreide parameterset inclusief OpStatus en DataLength [SWS_Dcm_01316].

Gebruik en aanroepcontext

De functie [SWS_Dcm_01316] wordt aangeroepen door de Diagnostic Communication Manager (DCM) en beschikbaar gesteld via Dcm_Externals.h. Deze verzoekt de applicatie asynchroon om een IO-signaal aan te passen in het kader van de diagnosedienst InputOutputControlByIdentifier. De sturingsdata worden doorgegeven via de pointer ControlStateInfo (uit de parameter ControlOptionRecord), aangevuld met de bytelengte DataLength. Het verloop wordt geregeld via OpStatus: zolang de aanpassing voortduurt, retourneert de applicatie DCM_E_PENDING; na succesvolle afronding meldt deze E_OK.

Varianten en maskerparameters

Bij externe configuratie van het controlemasker (DCM_CONTROLMASK_EXTERNAL) worden aanvullende parameters meegegeven [SWS_Dcm_01316]:

• Is de maskergrootte kleiner dan of gelijk aan 4 byte, dan wordt controlMask van het type Dcm_ControlMask_{DID}Type meegegeven.
• Bedraagt de maskergrootte minimaal 5 byte, dan wordt in plaats daarvan controlMask2 als pointer naar uint8 meegegeven.

Foutafhandeling en gelijktijdigheid

Mislukt de signaalaansturing, dan retourneert de functie E_NOT_OK en stelt via de pointer ErrorCode de negatieve antwoordcode (NRC) in, die de DCM in het negatieve antwoord verzendt [SWS_Dcm_01316]. De functie is gespecificeerd als niet-reentrant.

Interactie en afbakening

De interface wordt gebruikt wanneer de DID-datapoort is geconfigureerd op USE_DATA_ASYNCH_FNC of USE_DATA_ASYNCH_FNC_ERROR en het datatype op UINT8_DYN [SWS_Dcm_01316]. Deze verschilt van de synchrone variant [SWS_Dcm_00802], die noch OpStatus noch DataLength gebruikt en bedoeld is voor synchrone poorten bij statische datatypen.

De functie Xxx_IsDidAvailable dient voor de asynchrone controle of een opgevraagde Diagnostic Identifier (DID) beschikbaar is binnen een gedefinieerd DID-bereik [SWS_Dcm_00803]. Deze wordt beschikbaar gesteld via de header Dcm_Externals.h en heeft de Service-ID 0x53 [SWS_Dcm_00803].

Gebruik en parameters

De aanroep vindt plaats met de volgende parameters [SWS_Dcm_00803]:

• DID (In): De op te vragen identifierwaarde van de DID [SWS_Dcm_00803].
• OpStatus (In): De actuele status van de operatie voor de besturing van het asynchrone verloop [SWS_Dcm_00803].
• supported (Out): Geeft aan of de DID in het bereik beschikbaar is; DCM_DID_SUPPORTED betekent ondersteuning, terwijl DCM_DID_NOT_SUPPORTED de niet-ondersteuning aangeeft [SWS_Dcm_00803].

Asynchrone semantiek en retourwaarden

Omdat de functie asynchroon wordt uitgevoerd, vereist het bepalen onder bepaalde omstandigheden meerdere aanroepstappen [SWS_Dcm_00803]. De retourwaarde DCM_E_PENDING signaleert dat het verzoek nog niet is voltooid en dat er verdere aanroepen nodig zijn voor afronding [SWS_Dcm_00803]. De retourwaarde E_OK wordt gemeld wanneer de controle is voltooid [SWS_Dcm_00803] (interpretatie: vermoedelijk voltooit E_OK de opvraging, waarna de parameter supported het geldige resultaat bevat). Vraag Q-22c62d306a7ac4f1 (open)

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Dcm_00803]. Parallelle aanroepen voor dezelfde of andere DID's binnen dezelfde instantie zijn daarom niet toegestaan.

Gebruik en parameterinterface

De functie Xxx_ReadDidData (service-ID 0x40) is beschikbaar via Dcm_Externals.h en vraagt bij de applicatie de gegevenswaarden van een diagnose-identifier (DID) op [SWS_Dcm_00804]. De overdracht en terugkoppeling vinden plaats via de volgende parameters:

• DID: Identifier van de aangevraagde Data Identifier [SWS_Dcm_00804].
• Data: Pointer naar de buffer waarin de gelezen nuttige gegevens moeten worden gekopieerd [SWS_Dcm_00804].
• OpStatus: Voortgangs- respectievelijk operatiestatus van het actuele verzoek [SWS_Dcm_00804].
• DataLength: Lengte van de te lezen gegevens [SWS_Dcm_00804].
• ErrorCode: Uitgangsparameter voor de opname van een negatieve responscode (NRC) [SWS_Dcm_00804].

Asynchrone semantiek en retourwaarden

De functie is als asynchroon (Asynchronous) gedefinieerd en retourneert een status van het type Std_ReturnType [SWS_Dcm_00804]:

• E_OK: Het uitlezen van de gegevens was succesvol [SWS_Dcm_00804].
• DCM_E_PENDING: Het verzoek is nog niet voltooid; voor de voltooiing zijn verdere aanroepen vereist [SWS_Dcm_00804].
• E_NOT_OK: De operatie was niet succesvol [SWS_Dcm_00804].

Foutafhandeling en gelijktijdigheid

Retourneert de applicatie voor Xxx_ReadDidData de retourwaarde E_NOT_OK, dan verzendt de DCM-module een negatief antwoord met de via de parameter ErrorCode ingestelde NRC-code naar de diagnosetester [SWS_Dcm_00804]. De functie is als niet-re-entrant (Non Reentrant) gespecificeerd [SWS_Dcm_00804]. Interpretatie: Vanwege de asynchrone afhandeling met DCM_E_PENDING vindt de aanroep vermoedelijk typisch plaats in de cyclische taakcontext van de DCM. Vraag Q-5e41e9fb7dc261b9 (open)

De functie Xxx_WriteDidData wordt aangeroepen door de module DCM om de applicatie te verzoeken de gegevenswaarde van een DID te schrijven [SWS_Dcm_00805]. De declaratie is beschikbaar via de header Dcm_Externals.h [SWS_Dcm_00805].

Aanroep en semantiek

De aanroep geschiedt asynchroon en is gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_Dcm_00805]. Bij de aanroep worden de volgende parameters overgedragen [SWS_Dcm_00805]:

• DID: Identifier van de te schrijven data-identifier.
• Data: Pointer naar de buffer met de te schrijven gegevens.
• OpStatus: Status van de actuele operatie.
• DataLength: Lengte van de te schrijven gegevens in bytes.
• ErrorCode: Uitvoerparameter voor de negatieve responscode (NRC).

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie Std_ReturnType met de volgende betekenissen [SWS_Dcm_00805]:

• E_OK: De schrijfopdracht is succesvol uitgevoerd.
• DCM_E_PENDING: De operatie is nog niet voltooid; voor voltooiing zijn verdere aanroepen vereist.
• E_NOT_OK: De operatie was niet succesvol. In dit geval verzendt de DCM-module een negatief antwoord met de in de uitgangsparameter ErrorCode overgedragen NRC-waarde.

De functie Xxx_ReadDidRangeDataLength dient ertoe de toepassingssoftware te verzoeken om teruggave van de datalengte voor een DID-bereik (DID Range) [SWS_Dcm_01271]. Deze maakt deel uit van de AUTOSAR-module Dcm, heeft service-ID 0x5e en wordt via het headerbestand Dcm_Externals.h ter beschikking gesteld [SWS_Dcm_01271].

De aanroep vindt plaats met asynchrone semantiek (Asynchronous) via de volgende interfaceparameters [SWS_Dcm_01271]:

• DID (IN, uint16): Identificeert de concrete data-identifier (Data ID value) van het opgevraagde DID-bereik [SWS_Dcm_01271].
• OpStatus (IN, Dcm_OpStatusType): Geeft de actuele verwerkingsstatus van de lopende operatie aan [SWS_Dcm_01271].
• DataLength (OUT, uint16*): Pointer naar de lengte van de data die gelezen of geschreven moeten worden [SWS_Dcm_01271].

De retourwaarde van het type Std_ReturnType signaleert het resultaat van de lengteopvraag [SWS_Dcm_01271]:

• E_OK: De aanvraag was succesvol en de bepaalde lengte is beschikbaar [SWS_Dcm_01271].
• E_NOT_OK: De aanvraag was niet succesvol [SWS_Dcm_01271].
• DCM_E_PENDING: De uitvoering is nog niet afgerond en vereist verdere vervolgaanroepen voor voltooiing [SWS_Dcm_01271].

Met betrekking tot concurrency is de interface vastgelegd als niet re-entrant (Non Reentrant) [SWS_Dcm_01271].

De asynchrone interface Xxx_GetInfotypeValueData wordt door de DCM-module aangeroepen zodra een diagnoseaanvraag voor OBD Service $09 wordt ontvangen en het opgevraagde InfoType geen beschikbaarheids-InfoType (“availability InfoType”) is [SWS_Dcm_00423]. Om de data beschikbaar te stellen, roept de DCM alle voor dit InfoType geconfigureerde functies aan en voegt de waarden samen als antwoord op Service $09 [SWS_Dcm_00423]. De declaratie is beschikbaar via Dcm_Externals.h [SWS_Dcm_91014].

De overdracht en terugkoppeling van de data vindt plaats via gedefinieerde buffer- en statusparameters [SWS_Dcm_91014]:

• OpStatus (in): Toont de actuele voortgangsstatus van de lopende operatie.
• DataValueBuffer (out): Buffer voor de opname van de specifieke InfoType-payload.
• DataValueBufferSize (inout): Bevat bij de aanroep de maximaal beschrijfbare buffergrootte in bytes en wordt door de aangeroepen functie gevuld met het werkelijke aantal geschreven databytes.

Als asynchrone functie levert zij E_OK op bij succesvolle afronding, E_NOT_OK bij fouten of DCM_E_PENDING indien de operatie nog niet is afgerond en verdere aanroepen voor voltooiing vereist [SWS_Dcm_91014]. Aangezien de functie is gespecificeerd als niet re-entrant (Non Reentrant), mogen er geen gelijktijdige aanroepen voor dezelfde functie plaatsvinden [SWS_Dcm_91014].

De functie Xxx_Start wordt gedeclareerd via het headerbestand Dcm_Externals.h en verzoekt de applicatiesoftware om de uitvoering van een diagnostische routine te starten [SWS_Dcm_01203]. De module DCM roept deze functie aan zodra een UDS-serviceverzoek voor RoutineControl (0x31) met de subfunctie startRoutine is ontvangen en succesvol is geverifieerd [SWS_Dcm_00400], of wanneer een RoutineControl-verzoek met een niet-beschikbaarheids-OBDTestId binnenkomt [SWS_Dcm_01392].

De interface ondersteunt zowel vaste als variabele dataformaten en wordt asynchroon uitgevoerd [SWS_Dcm_01203]:

• Invoerparameters: Vaste ingangssignalen dataIn_1 tot dataIn_n of variabele data via de byte-array dataInVar en de operationele status OpStatus [SWS_Dcm_01203].
• Uitvoerparameters: Vaste uitgangssignalen dataOut_1 tot dataOut_n of variabele uitgangsdata dataOutVar en de foutcode ErrorCode voor negatieve antwoordberichten [SWS_Dcm_01203].
• Lengteparameters: De in- en uitvoerparameter currentDataLength transporteert bij variabele datalengte het aantal payloadbytes in dataInVar respectievelijk dataOutVar [SWS_Dcm_01203].
• Retourwaarden: E_OK bevestigt de succesvolle start, E_NOT_OK meldt een mislukking, DCM_E_PENDING signaleert nog lopende verwerkingsstappen en DCM_E_FORCE_RCRRP verzoekt om het voortijdig verzenden van een pending-bericht (NRC 0x78) [SWS_Dcm_01203].

Met betrekking tot concurrency is Xxx_Start gedefinieerd als niet-reentrant (Non Reentrant) [SWS_Dcm_01203]. Bij asynchrone processen met de retourwaarde DCM_E_PENDING roept de DCM-module de functie cyclisch opnieuw aan met de voortgezette OpStatus totdat de bewerking is voltooid [SWS_Dcm_01203].

Wordt de bewerking succesvol beëindigd met E_OK, dan stuurt de DCM-module een positief UDS-antwoord terug met de via dataOut ter beschikking gestelde data als routineStatusRecord [SWS_Dcm_00401]. Mislukt de uitvoering met E_NOT_OK, dan verstuurt de DCM een negatief antwoord met de in parameter ErrorCode gespecificeerde NRC [SWS_Dcm_01203]. In de context van OBD-routines leidt een retourwaarde ongelijk aan E_OK tot het verzenden van NRC 0x22 [SWS_Dcm_01394].

Gebruik

De functie Xxx_StartConfirmation geeft conform [SWS_Dcm_91016] de verzending van een antwoord op een voorafgaand StartRoutine-verzoek bindend aan. De interface is gedeclareerd in het headerbestand Dcm_Externals.h en heeft een synchrone uitvoeringssemantiek ([SWS_Dcm_91016]). Als enige invoerparameter wordt ConfirmationStatus van het type Dcm_ConfirmationStatusType doorgegeven, die de bevestigingsstatus van de routineverzending beschrijft. Aanvullende in- en uitvoerparameters bestaan volgens de specificatie niet ([SWS_Dcm_91016]).

Foutafhandeling en retourwaarden

Als retourwaarde levert de functie een statuswaarde van het type Std_ReturnType ([SWS_Dcm_91016]). Daarbij bevestigt de waarde E_OK de succesvolle uitvoering van het verzoek, terwijl E_NOT_OK een niet-succesvolle verwerking signaleert. Specifieke foutcodes of expliciete meldingen aan de Development Error Tracer (DET) of Diagnostic Event Manager (DEM) zijn voor deze functie niet in de payload gedefinieerd.

Gelijktijdigheid en beperkingen

Met betrekking tot de gelijktijdigheid is Xxx_StartConfirmation geclassificeerd als niet-re-entrant (Non Reentrant) ([SWS_Dcm_91016]). Dit vereist van de aanroeper dat concurrerende of overlappende uitvoeringen strikt worden vermeden. Interpretatie: De functie wordt vermoedelijk aangeroepen door de DCM om de routine-implementatie aan de applicatiezijde te informeren over de voltooiing van het verzendproces. Vraag Q-be2dafd63bf2a9a5 (open)

Gebruik

De functie [SWS_Dcm_01204] wordt door de DCM aangeroepen om de uitvoering van een lopende diagnoseroutine in de applicatie te beëindigen. De aanroep vindt plaats in het kader van de UDS-dienst RoutineControl (0x31) met de subfunctie stopRoutine, zodra de vereiste voorcontroles met succes zijn doorlopen [SWS_Dcm_00402]. De interface heeft de service-ID 0x5c en is gedeclareerd via het headerbestand Dcm_Externals.h [SWS_Dcm_01204].

Parameters en retourwaarden

Afhankelijk van de configuratie van de routine geeft de DCM vaste of variabele invoergegevens (dataIn_1 tot dataIn_n resp. dataInVar) en bufferreferenties voor uitvoergegevens (dataOut_1 tot dataOut_n resp. dataOutVar) door [SWS_Dcm_01204], [SWS_Dcm_00402]. Bij variabele datalengte bevat currentDataLength het aantal bytes van de in- resp. uitvoergegevens [SWS_Dcm_01204]. Als retourwaarden van Std_ReturnType zijn vastgelegd:

• E_OK: Routine succesvol beëindigd; de DCM verzendt een positief UDS-antwoord met de gegenereerde uitvoergegevens als routineStatusRecord [SWS_Dcm_01204], [SWS_Dcm_00403].
• E_NOT_OK: Afbreken van de routine mislukt; de DCM zendt een negatief UDS-antwoord met de in ErrorCode opgeslagen NRC [SWS_Dcm_01204].
• DCM_E_PENDING: Operatie is nog in behandeling; de DCM roept de functie opnieuw aan voor voltooiing [SWS_Dcm_01204].
• DCM_E_FORCE_RCRRP: De applicatie verzoekt de DCM om verzending van een pending-antwoord (NRC 0x78) [SWS_Dcm_01204].

Gelijktijdigheid en beperkingen

De operatie is gespecificeerd als asynchroon en niet re-entrant (Non Reentrant) [SWS_Dcm_01204]. Treedt er bij de uitvoering een fout op, dan moet de applicatie de parameter ErrorCode met de passende Dcm_NegativeResponseCodeType beschrijven en E_NOT_OK retourneren [SWS_Dcm_01204].

De synchrone functie Xxx_StopConfirmation dient ertoe de verzending van een antwoord op een voorafgaand StopRoutine-verzoek aan te geven [SWS_Dcm_91017]. Bij de aanroep geeft het systeem via de invoerparameter ConfirmationStatus van het type Dcm_ConfirmationStatusType de concrete bevestigingsstatus van de routinebeëindiging door [SWS_Dcm_91017]. Als retourwaarde levert de interface een waarde van het type Std_ReturnType: hierbij geeft E_OK aan dat het verzoek succesvol is verwerkt, terwijl E_NOT_OK een niet-succesvol verzoek signaleert [SWS_Dcm_91017].

Wat betreft gelijktijdigheid en aanroepvoorwaarden is de interface gespecificeerd als niet-re-entrant (Non Reentrant) en bezit deze de service-ID 0x69 [SWS_Dcm_91017]. De declaratie wordt via het headerbestand Dcm_Externals.h beschikbaar gesteld [SWS_Dcm_91017]. Interpretatie: Vanwege de beschikbaarstelling via Dcm_Externals.h en het aanpasbare voorvoegsel Xxx_ wordt de functie vermoedelijk door de DCM-module aangeroepen en geïmplementeerd door een applicatiespecifieke softwarecomponent respectievelijk de verantwoordelijke routinehandler. Vraag Q-743e69ff8cf92321 (open)

Specifieke foutcodes of meldingen aan het ontwikkelingsfoutbeheer (DET) of de Diagnostic Event Manager (DEM) zijn in de vereisten niet vermeld. Het gedrag bij fouten beperkt zich op dit interfaceniveau formeel tot de teruggave van de foutwaarde E_NOT_OK wanneer de verwerking niet succesvol kon worden afgerond [SWS_Dcm_91017].

De functie [SWS_Dcm_91013] wordt door de DCM-module aangeroepen om bij de applicatie het resultaat van een routine-uitvoering op te vragen. Dit gebeurt in het kader van de UDS-dienst RoutineControl (0x31) met de subfunctie requestRoutineResults, zodra alle ingangscontroles met succes zijn doorlopen [SWS_Dcm_00404]. De interface is beschikbaar via Dcm_Externals.h, werkt asynchroon en is gespecificeerd als niet re-entrant [SWS_Dcm_91013].

Via de parameter OpStatus bestuurt de DCM-module het verloop van de operatie. De functie neemt vaste invoergegevens (dataIn_1 tot dataIn_n) of variabele gegevens (dataInVar) aan, die worden afgeleid van het routineControlOptionRecord [SWS_Dcm_00404]. Via vaste uitvoerparameters (dataOut_1 tot dataOut_n) of variabele uitvoerbuffers (dataOutVar en variableDataLength) draagt de applicatie de resultaatgegevens over aan de DCM [SWS_Dcm_91013].

Wordt de opvraag succesvol afgerond met E_OK, dan voegt de DCM-module de uitvoergegevens aan de hand van de configuratieparameter DcmDspRequestRoutineResultsOut samen tot een routineStatusRecord en verzendt een positief antwoord [SWS_Dcm_00405]. Indien de operatie nog voortduurt, kan de applicatie DCM_E_PENDING voor vervolgaanroepen of DCM_E_FORCE_RCRRP voor het zenden van een voorlopig antwoord (NRC 0x78) retourneren [SWS_Dcm_91013].

In geval van een fout levert de functie E_NOT_OK terug en stelt ErrorCode in op de van toepassing zijnde NRC-waarde, waarna de DCM-module een overeenkomstig negatief antwoord verstuurt [SWS_Dcm_91013]. Omdat de functie niet re-entrant is, mag deze voor dezelfde routine niet parallel worden aangeroepen [SWS_Dcm_91013].

Gebruik en semantiek

De functie Xxx_RequestResultsConfirmation dient ter bevestiging van een verzonden diagnoseantwoord op een RequestRoutineResults-verzoek [SWS_Dcm_91018]. Deze is gedeclareerd in het headerbestand Dcm_Externals.h en bezit de service-ID 0x70 [SWS_Dcm_91018]. Via de invoerparameter ConfirmationStatus van het type Dcm_ConfirmationStatusType ontvangt de implementatie informatie over de status waarmee de verzending van de routineresultaten is voltooid [SWS_Dcm_91018]. De aanroep wordt synchroon uitgevoerd en retourneert een Std_ReturnType, waarbij E_OK een succesvolle verwerking aangeeft en E_NOT_OK een mislukking signaleert [SWS_Dcm_91018].

Gelijktijdigheid en beperkingen

Volgens de specificatie is de functie ingeschaald als niet-re-entrant (Non Reentrant) [SWS_Dcm_91018]. Daarom mogen gelijktijdige aanroepen voor dezelfde instantie niet plaatsvinden. Interpretatie: De aanroep door de DCM-module vindt sequentieel plaats in de context van de antwoordbevestiging, waardoor de functie zonder blokkerende operaties moet worden uitgevoerd. Vraag Q-935a06744e7b9af7 (open)

Foutafhandeling en wisselwerking

De foutafhandeling beperkt zich tot de retourwaarde E_NOT_OK, aangezien afzonderlijke ontwikkelingsfouten (DET) of productiefouten (DEM) voor deze aanroep niet zijn gespecificeerd [SWS_Dcm_91018]. Interpretatie: De functie dient als een applicatiespecifiek bevestigingseindpunt (callback) voor de DCM om na verzending van de routineresultaten de afronding van de diagnoseopdracht op gebruikersniveau te synchroniseren. Vraag Q-d3dd0142a30e1363 (open)

De functie Xxx_RequestControl dient voor de uitvoering van een TID-specifieke stuurfunctie en wordt typisch toegepast voor de implementatie van OBD Service $08 ([SWS_Dcm_01338]). De DCM-module roept de geconfigureerde functie synchroon aan zodra een OBD-Service-$08-aanvraag wordt ontvangen waarvan de test-ID (TID) geen beschikbaarheids-TID (“availability TID”) is ([SWS_Dcm_00419]). De declaratie van de interface wordt via het headerbestand Dcm_Externals.h ter beschikking gesteld ([SWS_Dcm_01338]).

Parameters en bufferbehandeling

• InBuffer: Pointer naar de payload van het ontvangen OBD-verzoek. Het aantal bytes van deze invoergegevens moet exact overeenkomen met de in de DCM-module geconfigureerde omvang ([SWS_Dcm_00419], [SWS_Dcm_01338]).
• OutBuffer: Pointer naar de uitvoerbuffer waarin de aangeroepen stuurfunctie haar resultaten opslaat. De buffergrootte is vast voorgeschreven en wordt ontleend aan de configuratie van de DCM-module ([SWS_Dcm_00419], [SWS_Dcm_01338]).

Retourwaarden en foutafhandeling

De functie geeft als statuswaarde Std_ReturnType terug: de waarde E_OK signaleert een succesvolle afhandeling, terwijl E_NOT_OK een fouttoestand aangeeft ([SWS_Dcm_01338]). Indien Xxx_RequestControl een ander resultaat dan E_OK oplevert, reageert de DCM-module met de negatieve responscode NRC 0x22 (Conditions Not Correct) richting de diagnosetester ([SWS_Dcm_01192]).

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet re-entrant (Non Reentrant) en heeft de service-ID 0x63 ([SWS_Dcm_01338]).

De callback-functie Xxx_StartProtocol wordt beschikbaar gesteld via de header Dcm_Externals.h en stelt de applicatie in staat om bij het eerste verzoek van een diagnoseprotocol actuele omgevingscondities te controleren en de verdere protocolverwerking vrij te geven of af te wijzen [SWS_Dcm_01339].

Aanroepcontext en parameters

De aanroep vindt synchroon en niet-reentrant plaats door de DSL-submodule van de DCM voor alle geconfigureerde functies [SWS_Dcm_00036], [SWS_Dcm_01339]. Aan de functie worden de volgende ingangsparameters meegegeven [SWS_Dcm_01339]:

• ProtocolType: Type van het te starten diagnoseprotocol,
• TesterSourceAddress: Bronadres van de verzoekende tester,
• ConnectionId: Unieke identificatie van de verbinding.

Retourwaarden en foutafhandeling

Als retourwaarde levert de functie Std_ReturnType met E_OK bij succesvolle vrijgave, E_NOT_OK bij een niet-succesvolle controle of E_PROTOCOL_NOT_ALLOWED indien het protocol niet is toegestaan [SWS_Dcm_01339]. Retourneert ten minste één geconfigureerde Xxx_StartProtocol-functie niet E_OK, dan breekt de DCM de protocolstart af en antwoordt met NRC 0x22 [SWS_Dcm_00674].

Initialisatie na succesvolle vrijgave

Pas wanneer alle geconfigureerde Xxx_StartProtocol-callbacks E_OK hebben geretourneerd, voert de DCM de verdere initialisatiestappen uit:

• Laden van de standaard timingparameters uit de default-sessieconfiguratie [SWS_Dcm_00144],
• Activeren van de servicetabel [SWS_Dcm_00145],
• Resetten van de beveiligingsstatus (Security State) [SWS_Dcm_00146],
• Resetten van de sessiestatus naar de standaard diagnosesessie en het uitvoeren van de moduswissel via SchM_Switch_<bsnp>_DcmDiagnosticSessionControl naar RTE_MODE_DcmDiagnosticSessionControl_DEFAULT_SESSION [SWS_Dcm_00147].

De synchrone callback-functie Xxx_StopProtocol informeert de applicatie over het beëindigen van een diagnoseprotocol ([SWS_Dcm_01340]). Deze wordt gedeclareerd via het headerbestand Dcm_Externals.h en is gespecificeerd als niet-reentrant (Non Reentrant) ([SWS_Dcm_01340]).

De aanroep van alle geconfigureerde Xxx_StopProtocol-functies (geconfigureerd via de parameter DcmDslCallbackDCMRequestService) wordt door de DSL-submodule geactiveerd in de volgende preemption-scenario's:

• Een lopend diagnoseverzoek wordt verdrongen door een verzoek met een hogere prioriteit van een ander protocol ([SWS_Dcm_00459]).
• Een verzoek met een lagere of gelijke prioriteit verdringt een protocol met een hogere prioriteit, mits dit zich in de Default Session bevindt en er geen actief verzoek in de uitvoeringsfase is ([SWS_Dcm_00625]).

Bij de aanroep worden het protocoltype (ProtocolType), het bronadres van de tester (TesterSourceAddress) en de verbindingsidentificatie (ConnectionId) meegegeven ([SWS_Dcm_01340]). Als retourwaarde levert de functie E_OK bij succesvolle uitvoering of E_NOT_OK ([SWS_Dcm_01340]). Retourneert de functie niet E_OK, dan antwoordt de DCM met de negatieve antwoordcode NRC 0x22 ([SWS_Dcm_01190]).

De synchrone, niet-re-entrante functie Xxx_Indication wordt via de header Dcm_Externals.h gedeclareerd [SWS_Dcm_01341]. Deze toont de applicatie de aanstaande uitvoering van een diagnosedienst en stelt deze in staat de uitvoering van het serviceverzoek af te wijzen [SWS_Dcm_01341]. De aanroep geschiedt synchroon door de DSD-submodule op alle geconfigureerde ServiceRequestIndication-poorten wanneer de configuratiecontainers DcmDsdServiceRequestManufacturerNotification [SWS_Dcm_00218] of DcmDsdServiceRequestSupplierNotification [SWS_Dcm_00516] aanwezig zijn.

Als invoerparameters worden de Service-ID (SID), de verzoekdata zonder SID (RequestData, DataSize), het adresseringstype (ReqType), de verbindings-ID (ConnectionId), het protocoltype (ProtocolType) en het bronadres van de tester (TesterSourceAddress) doorgegeven [SWS_Dcm_01341].

Via de retourwaarde van het type Std_ReturnType bestuurt de applicatie de reactie van de DSD-submodule [SWS_Dcm_01341]:

• E_OK: Het verzoek was succesvol en wordt regulier verder verwerkt [SWS_Dcm_01341].
• E_REQUEST_NOT_ACCEPTED: Het verzoek wordt niet geaccepteerd. Geeft ten minste één aangeroepen indication-functie E_REQUEST_NOT_ACCEPTED terug, dan onderdrukt de DSD-submodule elk antwoord aan de tester [SWS_Dcm_00462], [SWS_Dcm_00517].
• E_NOT_OK: Het verzoek was niet succesvol. De applicatie schrijft in dit geval een negatieve responscode in de uitvoerparameter ErrorCode [SWS_Dcm_01341]. Voor zover geen enkele aanroep E_REQUEST_NOT_ACCEPTED teruggeeft, verzendt de DSD-submodule een negatief antwoord met deze NRC [SWS_Dcm_00463], [SWS_Dcm_00518].

Als bij meerdere geconfigureerde notificaties meerdere functies E_NOT_OK teruggeven en geen enkele functie E_REQUEST_NOT_ACCEPTED, dan gebruikt de DSD-submodule voor het negatieve antwoord bindend de ErrorCode van de eerste met E_NOT_OK antwoordende functie [SWS_Dcm_01321], [SWS_Dcm_01322].

De callbackfunctie Xxx_Confirmation dient ertoe de applicatie de voltooiing van een diagnoseoverdracht – hetzij de succesvolle verzending, hetzij een overdrachtsfout – synchroon mede te delen ([SWS_Dcm_01342]). De declaratie wordt via de header Dcm_Externals.h ter beschikking gesteld ([SWS_Dcm_01342]).

Bij de aanroep door de DCM-submodule DSD (Diagnostic Service Dispatcher) worden essentiële contextgegevens van de diagnoseopdracht overgedragen ([SWS_Dcm_01342], [SWS_Dcm_00741]):

• SID: Identificator van de diagnosedienst ([SWS_Dcm_01342]).
• ReqType: Adresseringswijze (0 voor fysiek, 1 voor functioneel) ([SWS_Dcm_01342]).
• ConnectionId, ProtocolType en TesterSourceAddress: Eenduidige verbindings- en protocolattributen evenals het bronadres van de tester ([SWS_Dcm_01342]).
• ConfirmationStatus: Statusinformatie over succes of fout van de overdracht ([SWS_Dcm_01342]).

Als retourwaarde levert de operatie Std_ReturnType (E_OK bij succesvolle bevestigingsverwerking, anders E_NOT_OK) ([SWS_Dcm_01342]). De DSD roept de functie aan op alle poorten die de interface ServiceRequestNotification gebruiken (geconfigureerd via DcmDsdServiceRequestManufacturerNotification resp. DcmDsdServiceRequestSupplierNotification) ([SWS_Dcm_00741]).

Wat betreft de aanroepvolgorde wordt Xxx_Confirmation regulier direct aansluitend op DspInternal_DcmConfirmation() uitgevoerd ([SWS_Dcm_00742]). Doet zich echter het uitzonderlijke geval volgens [SWS_Dcm_01172] voor, dan roept de DSD uitsluitend Xxx_Confirmation aan, terwijl de interne aanroep vervalt.

Aangezien Xxx_Confirmation als niet-reentrant (Non Reentrant) en synchroon gespecificeerd is ([SWS_Dcm_01342]), bevat de applicatiezijdige implementatie vermoedelijk geen blokkerende processen en veroorzaakt deze geen reentrante terugaanroepen naar de DCM (interpretatie). Vraag Q-58ce3e44dc61540b (open)

Gebruik

De synchrone callout-functie Xxx_ClearDTCCheckFnc wordt via het headerbestand Dcm_Externals.h voor de applicatie beschikbaar gesteld [SWS_Dcm_01270]. Deze dient voor fabrikant- en leverancierspecifieke controle van voorwaarden voorafgaand aan het wissen van een aangevraagde groep van diagnose-foutcodes (Group of DTC). Als invoerparameter wordt de identifier GoDTC van het type uint32 meegegeven, die de te wissen foutcodegroep specificeert [SWS_Dcm_01270].

Foutafhandeling en retourwaarden

De vrijgave van het wisverzoek vindt plaats via de retourwaarde van het type Std_ReturnType in samenspel met de uitvoerparameter ErrorCode [SWS_Dcm_01270]:

• E_OK: De applicatie staat het wissen van de opgevraagde foutcodegroep toe GoDTC [SWS_Dcm_01270].
• E_NOT_OK: De applicatie verbiedt het wissen van de groep. In dit foutgeval moet via de uitvoerparameter ErrorCode van het type Dcm_NegativeResponseCodeType* een negatieve responscode worden ingesteld. De module DCM verstuurt vervolgens een negatief antwoord met de in ErrorCode aangegeven NRC-waarde [SWS_Dcm_01270].

Gelijktijdigheid en beperkingen

De functie is voorzien van de service-ID 0x5f, werkt synchroon en is gedefinieerd als niet re-entrant (Non Reentrant) [SWS_Dcm_01270]. De aanroepcontext moet daarom waarborgen dat aanroepen sequentieel en zonder gelijktijdige overlappingen plaatsvinden.

De callout-functie Xxx_ProcessRequestDownload ([SWS_Dcm_00754]) wordt door de module Dcm aangeroepen om bij de verwerking van de UDS-dienst RequestDownload een downloadproces te initiëren. Deze is gedefinieerd als asynchroon en niet-re-entrant en wordt via de header Dcm_Externals.h ter beschikking gesteld ([SWS_Dcm_00754]).

Gebruik en parameters

De aanroep geschiedt stapsgewijs via de parameter OpStatus met de waarden DCM_INITIAL, DCM_PENDING of DCM_CANCEL ([SWS_Dcm_00754]). Als invoerparameters worden compressie- en versleutelingsmethoden (DataFormatIdentifier), het geheugenblok (MemoryIdentifier), het startadres (MemoryAddress) en de ongecomprimeerde geheugengrootte in bytes (MemorySize) overgedragen ([SWS_Dcm_00754]). Vóór de aanroep beschrijft de Dcm de inout-parameter BlockLength met de maximaal mogelijke buffergrootte ([SWS_Dcm_01417]). De functie past deze waarde aan op de maximaal toelaatbare bloklengte voor latere schrijfbewerkingen ([SWS_Dcm_00754]).

Retourwaarden en interactie

De functie levert E_OK bij succesvolle uitvoering, DCM_E_PENDING als de bewerking nog voortduurt, of E_NOT_OK bij een fout ([SWS_Dcm_00754]):

• Levert de aanroep E_OK op en is de onderhandelde waarde BlockLength kleiner dan of gelijk aan de ondersteunde bufferlengte van de actuele protocolverbinding, dan verstuurt de Dcm een positieve respons met deze waarde als maxNumberOfBlockLength ([SWS_Dcm_01419]).
• Overschrijdt de geretourneerde bufferlengte de ondersteunde buffergrootte van de protocolverbinding, dan meldt de Dcm de DET-fout DCM_E_INTERFACE_BUFFER_OVERFLOW ([SWS_Dcm_01418]).
• Bij teruggave van E_NOT_OK verzendt de Dcm een negatieve UDS-respons (NRC) met de in de uitvoerparameter ErrorCode gezette waarde ([SWS_Dcm_00754], [SWS_Dcm_00757]).

De callout-functie Xxx_ProcessRequestTransferExit wordt door de DCM-module aangeroepen om een lopend download- of uploadproces in het kader van de UDS-dienst RequestTransferExit te beëindigen [SWS_Dcm_00755]. De declaratie van de interface wordt via de header Dcm_Externals.h beschikbaar gesteld [SWS_Dcm_00755].

Gebruik en semantiek

De functie wordt asynchroon uitgevoerd en is als niet-re-entrant gedefinieerd [SWS_Dcm_00755]. De aanroep vindt plaats onder overdracht van de actuele uitvoeringsstatus OpStatus (mogelijke waarden: DCM_INITIAL, DCM_PENDING of DCM_CANCEL) [SWS_Dcm_00755]. Als retourwaarden van het type Std_ReturnType zijn gespecificeerd:

• E_OK: De overdracht is succesvol beëindigd [SWS_Dcm_00755].
• DCM_E_PENDING: De overdrachtsbeëindiging is nog niet voltooid en vereist vervolgaanroepen [SWS_Dcm_00755].
• E_NOT_OK: De beëindiging is mislukt of de antwoordbuffer is te klein [SWS_Dcm_00755].

Foutafhandeling en wisselwerking

Retourneert de operatie Xxx_ProcessRequestTransferExit de foutwaarde E_NOT_OK, dan moet via de uitgangsparameter ErrorCode een negatieve responscode worden overgedragen. De DCM-module verzendt vervolgens een negatief UDS-antwoord (NRC) met exact deze foutcode naar de diagnosetester [SWS_Dcm_00759]. Bij een afbreek-aanroep draagt de DCM-module de status DCM_CANCEL over aan de functie [SWS_Dcm_00755].