klasse apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler

De klasse apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler biedt een puur virtuele interface voor de afhandeling van de periodieke UDS-service 0x2A via transportspecifieke diagnosekanalen ([SWS_DM_01064]). Deze stelt het diagnosebeheer in staat om kanaalspecifieke payload- en hoeveelheidslimieten te bepalen, evenals de ordelijke overdracht van meerdere UDS-berichten via PeriodicTransmit ([SWS_DM_01067]). Als het verzenden van een bericht mislukt, wordt het proces afgebroken en wordt de toestand gemeld via een bevestigingsfunctie. Aangezien alle methoden als niet-thread-safe zijn gespecificeerd, moeten gelijktijdige toegangen door de aanroeper worden gesynchroniseerd.

meer ›

Context

De puur virtuele klasse apext::diag::uds_transport::UdsTransportProtocolPeriodicHandler vormt de gestandaardiseerde interface ter ondersteuning van het periodiek uitlezen van diagnosegegevens conform de UDS-service 0x2A ([SWS_DM_01064], AUTOSAR_AP_SWS_Diagnostics §C.3.1 “Class: UdsTransportProtocolPeriodicHandler”). In het diagnosesysteem van het AUTOSAR Adaptive Platform ontkoppelt deze het bovenliggende diagnosebeheer van de concrete netwerk- en transportprotocolimplementatie. Terwijl het diagnosebeheer binnenkomende verzoeken voor periodieke overdrachten evalueert en de bijbehorende datapakketten samenstelt, verzorgt de handler de daadwerkelijke overdracht van deze periodieke berichten over een concrete verbinding ([SWS_DM_01067]). Als interactiepartners fungeren daarbij het diagnosebeheer aan de aanroeperszijde en het respectievelijke communicatiekanaal, dat wordt geïdentificeerd via een unieke ChannelID ([SWS_DM_01065], [SWS_DM_01066]).

Contextdiagram: Inbedding van de UdsTransportProtocolPeriodicHandler tussen de diagnoseserver en de transportlaag. Bronnen: [SWS_DM_01064], [SWS_DM_01067], AUTOSAR_AP_SWS_Diagnostics §C.3.1 “Class: UdsTransportProtocolPeriodicHandler”.

Levenscyclus

Aangezien UdsTransportProtocolPeriodicHandler is gedefinieerd als een abstracte basisinterface met puur virtuele methoden, kan deze niet direct worden geïnstantieerd ([SWS_DM_01064]). De creatie van concrete handler-instanties vindt vermoedelijk plaats door transportspecifieke drivercomponenten (bijvoorbeeld voor DoIP- of CAN-gebaseerde protocollen). Vraag Q-d0b3bf3b0c14dcf6 (open) De levenscyclus van de instantie is typisch gebonden aan de beschikbaarheid van de betreffende transportprotocol-stack. Voor de correcte polymorfe vernietiging bij beëindiging van de communicatiestack stelt de klasse een virtuele destructor ~UdsTransportProtocolPeriodicHandler() beschikbaar ([SWS_DM_02089], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.1.1 “Destructor”).

Wat betreft gelijktijdigheid zijn alle lidfuncties van de klasse expliciet aangeduid als niet-thread-safe (not thread-safe) ([SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067], [SWS_DM_02089]). Bij parallelle toegang vanuit meerdere threads of gelijktijdige verzoeken via dezelfde ChannelID moeten aanroepers de toegangen daarom onder eigen verantwoordelijkheid synchroniseren.

Gebruikspad

Een typisch verloop voor het uitvoeren van periodieke berichtoverdrachten voor de service 0x2A is onderverdeeld in de volgende stappen:

• Bepaling van de maximale payloadlengte: Het diagnosebeheer roept GetMaxPayloadLength(channelId) aan om de op de opgegeven verbinding maximaal ondersteunde payloadlengte voor een enkele periodieke overdracht te controleren ([SWS_DM_01066], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.1 “GetMaxPayloadLength”).
• Opvragen van de berichtcapaciteit: Via GetNumberOfPeriodicMessages(channelId) wordt het transportprotocol- en verbindingsspecifieke aantal mogelijke periodieke berichten opgevraagd ([SWS_DM_01065], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.2 “GetNumberOfPeriodicMessages”).
• Uitvoering van de periodieke overdracht: Het diagnosebeheer geeft een geordende lijst van berichten in een ara::core::Vector<UdsMessageConstPtr> door aan de methode PeriodicTransmit(channelId, messages) ([SWS_DM_01067], AUTOSAR_AP_SWS_Diagnostics §C.3.1.1.2.3 “PeriodicTransmit”). De handler verzendt de opgenomen berichten in de opgegeven volgorde.
• Bevestiging: De transportlaag signaleert het resultaat van het verzendproces via de aanroep van PeriodicTransmit Confirmation, die het aantal succesvol verzonden berichten en de oorspronkelijke vector retourneert ([SWS_DM_01067]).

Sequentiediagram: Typisch verloop van de capaciteitsopvraag, het periodiek verzenden en de bevestiging. Bronnen: [SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067].

Foutscenario's

Tijdens de uitvoering van PeriodicTransmit worden alle berichten in de lijst achtereenvolgens overgedragen. Als de overdracht van een afzonderlijk bericht mislukt, wordt het gehele verzendproces onmiddellijk afgebroken ([SWS_DM_01067]). De daaropvolgende berichten in de lijst worden in dat geval niet meer verzonden. Voor foutdiagnose en informatie aan het diagnosebeheer wordt desalniettemin de bevestigingsaanroep PeriodicTransmit Confirmation geactiveerd. Deze bevat het aantal tot aan het afbreken succesvol verzonden berichten en ongewijzigd de volledige vector met UDS-berichten ([SWS_DM_01067]). Hierdoor kan het diagnosebeheer exact nagaan welk bericht de fout heeft veroorzaakt.

Alle interfacemethoden zijn gespecificeerd als noexcept en exception-safe (exception safe) ([SWS_DM_01065], [SWS_DM_01066], [SWS_DM_01067], [SWS_DM_02089]). Fouttoestanden bij de overdracht leiden niet tot C++-excepties, maar worden deterministisch gemeld via het daarvoor bestemde bevestigingsmechanisme.