klasse apext::diag::uds_transport::UdsTransportProtocolMgr

Gebruik

De methode ChannelReestablished van de klasse apext::diag::uds_transport::UdsTransportProtocolMgr dient als terugkoppeling van een UDS-transportprotocol-implementatie aan Diagnostic Management (DM) dat een communicatiekanaal na een (her)start weer beschikbaar is [SWS_DM_00313]. De transportprotocol-implementatie roept deze methode precies één keer aan zodra de hernieuwde beschikbaarheid van het door ChannelID gerepresenteerde netwerkkanaal wordt gedetecteerd [SWS_DM_00358]. Als parameter wordt globalChannelId doorgegeven, bestaande uit de tuple van de eigen handlerIdent en de ChannelID [SWS_DM_00358].

Zusammenspiel en levenscyclus

Voorwaarde voor de notificatie is een voorafgaande aanroep van NotifyReestablishment [SWS_DM_00313], [SWS_DM_00356]. Een typische use case is het uitvoeren van een ECU-reset (UDS-dienst 0x11) met de optie van een positief antwoord na de herstart [SWS_DM_00326]. Om de notificatie ook na een herstart van het DM te garanderen, moet het notificatieverzoek persistent worden opgeslagen door het transportprotocol [SWS_DM_00359].

Foutafhandeling en gelijktijdigheid

De functie heeft geen retourwaarde en is gespecificeerd als noexcept (exception safe) [SWS_DM_00313]. Aangezien de interface als niet-thread-safe (not thread-safe) is geclassificeerd [SWS_DM_00313], moeten aanroepende handlers de toegang vermoedelijk extern synchroniseren. Vraag Q-aaf14893457cceb6 (open) Als tijdsbeperking geldt dat het DM de aanroep van ChannelReestablished pas na de aanroep van UdsTransportProtocolHandler::Start mag verwerken [SWS_DM_01744].

De methode HandleMessage dient voor de overdracht van een volledig ontvangen, geldig UDS-verzoekbericht van de transportlaag naar de sessielaag van het diagnosebeheer ([SWS_DM_00311]). Dit komt overeen met de dienst T_Data.ind volgens ISO 14229-2 ([SWS_DM_00311], AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.2 “HandleMessage”).

Aanroep en parameters

Zodra de implementatie van het transportprotocol de payload van de eerder via IndicateMessage aangevraagde buffer heeft gevuld ([SWS_DM_00388]), roept deze HandleMessage aan op de instantie van apext::diag::uds_transport::UdsTransportProtocolMgr ([SWS_DM_00345]). Als argument wordt message van het type UdsMessagePtr meegegeven. Door de std::unique_ptr-semantiek gaat het eigenaarschap van het UDS-bericht terug naar de generieke DM-core ([SWS_DM_00311]). De functie levert geen retourwaarde op.

Semantiek, gelijktijdigheid en foutafhandeling

• Asynchronie: De aanroep moet onmiddellijk terugkeren („instantly returns”) ([SWS_DM_00311]). Interpretatie: De daadwerkelijke verwerking van het diagnoseverzoek zal in de DM-core vermoedelijk asynchroon in een aparte uitvoeringscontext worden voortgezet. Vraag Q-b8dd1a5f3d2dcdf0 (open)
• Foutgeval: De methode is gedeclareerd als noexcept en is uitzonderingsveilig ([SWS_DM_00311]). Mislukt de ontvangst of het vullen van het bericht, dan mag HandleMessage niet worden aangeroepen; in plaats daarvan moet de fout via NotifyMessageFailure worden gemeld ([SWS_DM_00310]).
• Thread-veiligheid: De operatie is gespecificeerd als not thread-safe ([SWS_DM_00311]). Aanroepers moeten parallelle toegangen tot dezelfde instantie synchroniseren.

Samenspel

De interface behoort tot de transportprotocollaag en moet worden onderscheiden van de applicatieve service-verwerkingsmethode ara::diag::GenericUDSService::HandleMessage ([SWS_DM_00618]).

De puur virtuele callback-methode HandlerStopped van de managementinterface apext::diag::uds_transport::UdsTransportProtocolMgr dient als terugmelding van een UDS-transportplugin aan de Diagnostic Manager (DM) dat de uitvoering daarvan is beëindigd en alle bijbehorende resources en netwerkverbindingen volledig zijn vrijgegeven [SWS_DM_00314]. Deze aanroep wordt verwacht als verplichte reactie van de handler op een eerdere aanroep van UdsTransportProtocolHandler::Stop() [SWS_DM_00314], [SWS_DM_00323].

Aanroepcontext en parameters: De betreffende plugin identificeert zich bij de aanroep via de invoerparameter handlerId van het type UdsTransportProtocolHandlerID [SWS_DM_00314]. De methode heeft geen retourwaarde (void) en waarborgt door de specificatie als noexcept volledige uitzonderingsveiligheid (exception safe) [SWS_DM_00314]. Specifieke foutcodes, foutreacties of meldingen aan DET of DEM zijn voor deze interface niet gedefinieerd.

Verloop en restricties: Gaat de Diagnostic Manager in het kader van het afsluiten over naar de toestand ApplicationState.kTerminating, dan roept deze eerst Stop() aan op elke gestarte UDS-transportprotocolimplementatie [SWS_DM_00333]. Na terugkeer uit Stop() geldt een strikt aanroepverbod: de handler-plugin mag naar UdsTransportProtocolMgr toe geen enkele andere methode meer aanroepen, met uitzondering van HandlerStopped [SWS_DM_01741], [SWS_DM_00323]. Vóór de definitieve beëindiging van het DM-proces wacht dit op de binnenkomst van de respectieve HandlerStopped-callback met de passende handlerId [SWS_DM_00340]. De interface is aangemerkt als niet-thread-safe (not thread-safe) [SWS_DM_00314]. Interpretatie: Aangezien de DM de binnenkomst van de callback afzonderlijk afwacht, vindt de daadwerkelijke beëindiging van de netwerkverbindingen in de plugin vermoedelijk asynchroon ten opzichte van de terugkeer van de Stop()-methode plaats. Vraag Q-40829d46bd661337 (open)

De methode IndicateMessage [SWS_DM_00309] van de klasse apext::diag::uds_transport::UdsTransportProtocolMgr wordt synchroon aangeroepen door een UdsTransportProtocolHandler wanneer het begin van de ontvangst van een UDS-bericht moet worden gesignaleerd en de handler dit ondersteunt. De aanroeper geeft het bron- en doeladres (sourceAddr, targetAddr), het adresseringstype type (fysiek of functioneel), de kanaal-ID globalChannelId, de verwachte totale grootte size en optioneel een byte-view op reeds ontvangen payload (payloadInfo) door. Het beschikbaar stellen van minimaal twee bytes in payloadInfo wordt aanbevolen, zodat de Diagnostic Management Core functionele verzoeken zoals Tester-Present (bypass-logica) ook tijdens lopende verwerking kan herkennen AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”.

Als retourwaarde levert de synchrone en uitzonderingsveilige aanroep een std::pair bestaande uit IndicationResult [SWS_DM_00384] en een UdsMessagePtr [SWS_DM_00309] op:

• Acceptatie: Kan het bericht worden verwerkt, dan retourneert de DM Core IndicationResult::kIndicationOk samen met een geldige UdsMessagePtr waarvan de minimumcapaciteit ten minste één byte bedraagt [SWS_DM_00385].
• Weigering en foutgevallen: Is de DM overbelast, dan antwoordt deze met kIndicationOccupied en nullptr [SWS_DM_00386]. Bij een ongeldig doeladres wordt kIndicationUnknownTargetAddress met een null-pointer geretourneerd. Andere gedefinieerde statuswaarden zijn kIndicationOverflow [SWS_DM_00384].

Wat betreft concurrency en levensduur is de methode als niet-thread-safe (not thread-safe) gespecificeerd [SWS_DM_00309]; aanroepen moeten daarom overeenkomstig gesynchroniseerd plaatsvinden. De via payloadInfo doorgegeven view is vluchtig en mag uitsluitend binnen deze functieaanroep worden gebruikt [SWS_DM_00309].

In het verdere verloop vult de transportlaag bij teruggave van kIndicationOk de beschikbaar gestelde buffer via GetPayload [SWS_DM_00301] tot aan de capaciteitsgrens of de volledige berichtlengte [SWS_DM_00388]. Na succesvolle vulling wordt HandleMessage aangeroepen [SWS_DM_00345]. Mislukt de berichtontvangst voortijdig, dan moet de handler de buffer via NotifyMessageFailure [SWS_DM_00310] teruggeven aan Diagnostic Management.

Gebruik

De zuiver virtuele methode NotifyMessageFailure wordt via de header apext/diag/uds_transport/protocol_mgr.h in de interface apext::diag::uds_transport::UdsTransportProtocolMgr ter beschikking gesteld [SWS_DM_00310]. Deze dient ertoe dat de transportprotocol-implementatie aan Diagnostic Management meldt dat een eerder via IndicateMessage() gesignaleerd bericht is mislukt en er geen finale aanroep van HandleMessage() [SWS_DM_00345] meer zal plaatsvinden [SWS_DM_00310]. Als parameter wordt de pointer message van het type UdsMessagePtr doorgegeven, waardoor het desbetreffende bericht aan de sessielaag wordt teruggegeven [SWS_DM_00310]. Een retourwaarde bestaat niet (void).

Foutafhandeling en gelijktijdigheid

De functie is als noexcept en uitzonderingsveilig gedeclareerd [SWS_DM_00310]. Zij werpt geen excepties op en meldt overdrachtsafbrekingen louter via de parameterinterface. Wat betreft concurrency is de methode als niet-thread-safe (not thread-safe) geclassificeerd [SWS_DM_00310]. Interpretatie: Aanroepers moeten bij parallelle verwerking op transportprotocolniveau vermoedelijk zorgen voor een externe synchronisatie. Vraag Q-8d9b3a3561b9b6ac (open)

Samenspel en verloop

In het reguliere verloop vult het transportprotocol na een succesvolle IndicateMessage() de payload van de UdsMessage [SWS_DM_00388] en stuurt deze via HandleMessage() door naar Diagnostic Management [SWS_DM_00345]. Mislukt de overdracht echter – bijvoorbeeld bij fouten tijdens de ontvangst van een multi-frame-verzoek –, dan wordt in plaats daarvan NotifyMessageFailure aangeroepen [SWS_DM_00310]. Dit voorkomt opvolgende verwerkingsaanroepen en beïnvloedt het sessiebeheer: terwijl de S3Server-timer bij de ontvangststart wordt gestopt [SWS_DM_00383], leidt een ontvangstfout van een multi-frame-bericht ertoe dat de S3Server-timer wordt gereset en vanaf het begin opnieuw telt (SWS Diagnostics §7.3.2.7 “Session handling” / [SWS_DM_00310]).

Gebruik

De zuiver virtuele methode PeriodicTransmitConfirmation maakt deel uit van de klasse apext::diag::uds_transport::UdsTransportProtocolMgr en wordt gedeclareerd via het headerbestand apext/diag/uds_transport/protocol_mgr.h [SWS_DM_01069]. Ze dient voor de bevestiging van verzonden periodieke diagnoseberichten en voor het doorgeven van het aantal succesvol verzonden berichten AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.6 “PeriodicTransmitConfirmation”.

Bij de aanroep worden twee invoerparameters meegegeven, terwijl de methode geen retourwaarde oplevert:

• messages (ara::core::Vector<UdsMessageConstPtr>): Dezelfde geordende lijst van berichten die eerder aan de methode UdsTransportProtocolPeriodicHandler::PeriodicTransmit() werd meegegeven [SWS_DM_01069].
• numberOfSentMessages (std::size_t): Het aantal berichten uit de lijst messages dat succesvol is overgedragen [SWS_DM_01069].

Foutafhandeling en uitzonderingsveiligheid

Wat betreft uitzonderingsveiligheid is de interface gespecificeerd als exception safe en voorzien van de aanduiding noexcept [SWS_DM_01069]. Ze werpt zodoende geen C++-excepties. Specifieke foutcodes of foutmeldingen via DET of DEM zijn voor deze bevestigingsfunctie in de specificatie niet gedefinieerd.

Gelijktijdigheid en randvoorwaarden

De functie is volgens de specificatie geclassificeerd als niet thread-safe (not thread-safe) [SWS_DM_01069]. Gelijktijdige aanroepen op dezelfde instantie zijn derhalve niet beschermd en moeten door de aanroeper worden gecoördineerd.

Samenspel

De functie sluit direct aan op de periodieke verzendingsstroom: ze neemt de bevestiging van de daadwerkelijk verstuurde berichten na een aanroep van UdsTransportProtocolPeriodicHandler::PeriodicTransmit() in ontvangst AUTOSAR_AP_SWS_Diagnostics §C.2.1.2.2.6 “PeriodicTransmitConfirmation”. Op eisniveau is de functie toegewezen aan de upstream-eis RS_Diag_04215 [SWS_DM_01069].

Gebruik

De zuiver virtuele methode TransmitConfirmation van de interface apext::diag::uds_transport::UdsTransportProtocolMgr dient voor de notificatie van het Diagnostic Management (DM) over de afronding van een verzendopdracht die eerder door het DM via UdsTransportProtocolHandler::Transmit is geïnitieerd [SWS_DM_00312] [SWS_DM_00348]. De functie realiseert de primitieve service T_Data.con conform ISO 14229-2 [SWS_DM_00312].

Bij de aanroep worden twee parameters meegegeven [SWS_DM_00312]:

• message (UdsMessageConstPtr): Pointer naar het UDS-bericht dat eerder in IndicateMessage() beschikbaar is gesteld en waarvan de overdracht wordt bevestigd [SWS_DM_00312].
• result (TransmissionResult): Geeft het resultaat van de overdracht aan. Als de netwerklaag het UDS-antwoord succesvol op het netwerk heeft kunnen plaatsen, moet de waarde op kTransmitOk worden gezet, anders op kTransmitFailed [SWS_DM_00351] SWS Diagnostics §7.1.1.3 “Confirmation Result”.

De methode heeft geen retourwaarde (void) en is gedeclareerd als noexcept, waardoor ze uitzonderingsveilig moet worden uitgevoerd [SWS_DM_00312].

Gelijktijdigheid en systeemgedrag

De interface is expliciet gespecificeerd als niet thread-safe [SWS_DM_00312]. Aanroepen vanuit gelijktijdige netwerk- of handlercontexten vereisen derhalve vermoedelijk een externe synchronisatie door de transportprotocolimplementatie. Vraag Q-e540ca89c3f61ecb (open)

Bovendien beïnvloedt de aanroep het authenticatiebeheer: bevindt een client zich in de standaardsessie en in de toestand kAuthenticated, dan brengt de Diagnostic Server deze naar de toestand kDeAuthenticated als na de laatste TransmitConfirmation gedurende authenticationTimeout geen nieuw verzoek wordt ontvangen [SWS_DM_01210].