namespace apext::diag::uds_transport

De namespace apext::diag::uds_transport biedt de C++-transportinterface voor het ontkoppelen van het generieke diagnosebeheer van specifieke UDS-transportprotocollen AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”. Protocol-plug-ins leiden af van de basisklasse UdsTransportProtocolHandler en doorlopen een strikte levenscyclus van constructie, initialisatie, start en geordend stoppen [SWS_DM_00329]. Binnenkomende berichten worden via IndicateMessage gemeld en ontvangen bij vrije capaciteit een geheugenbeheerde UdsMessagePtr voor de overname van gebruikersgegevens. Een centrale randvoorwaarde is dat er na het stoppen geen verdere aanroepen naar het diagnosebeheer mogen plaatsvinden behalve het bevestigingsbericht.

meer ›

Context

De namespace apext::diag::uds_transport definieert de gestandaardiseerde C++-transportinterface (Transport Protocol API) voor het diagnosebeheer (DM) in het AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”. De architectuur scheidt de generieke kern van het diagnosebeheer functioneel van concrete netwerk- en transportlagen. Op deze wijze kunnen gestandaardiseerde protocollen zoals DoIP evenals toekomstige of fabrikantspecifieke transportprotocollen (bijvoorbeeld voor CAN, CAN-FD of FlexRay) als modulaire plug-ins worden geïntegreerd AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”.

De centrale bemiddelende instantie wordt gevormd door de klasse UdsTransportProtocolMgr, die de interactie tussen de instanties van de Diagnostic Server en de aangesloten transportprotocollen coördineert. Concrete protocol-plug-ins leiden af van de abstracte basisklasse UdsTransportProtocolHandler AUTOSAR_AP_SWS_Diagnostics §7.1.1 “Support of UDS Transport Layer” [SWS_DM_00315]. Afzonderlijke handler-instanties worden via UdsTransportProtocolHandlerID geadresseerd [SWS_DM_00336], terwijl communicatiekanalen via het type ChannelID worden geïdentificeerd [SWS_DM_00337]. Ter ondersteuning van periodieke gegevensopvragingen conform ISO-dienst 0x2A bindt de interface tevens de klasse UdsTransportProtocolPeriodicHandler in.

Levenscyclus

Het diagnosebeheer stuurt de levenscyclus van elke UdsTransportProtocolHandler-instantie in een vast voorgeschreven volgorde [SWS_DM_00329]:

1. Aanmaak: De DM instantieert de protocol-plugin via de constructor UdsTransportProtocolHandler::UdsTransportProtocolHandler [SWS_DM_00329].
2. Initialisatie: De DM roept UdsTransportProtocolHandler::Initialize aan [SWS_DM_00329]. Afgezien van het opvragen van GetPeriodicHandler mag de DM vóór de succesvolle return van kInitializeOk geen verdere methoden op de handler aanroepen [SWS_DM_01746].
3. Start en werking: Na succesvolle initialisatie wordt de handler geactiveerd met UdsTransportProtocolHandler::Start. Pas na deze aanroep verwerkt de DM meldingen over gereactiveerde kanalen via UdsTransportProtocolMgr::ChannelReestablished [SWS_DM_01744].
4. Beëindiging: Als de DM overgaat naar de toestand ApplicationState.kTerminating, roept hij voor alle actieve plugins UdsTransportProtocolHandler::Stop aan [SWS_DM_00333]. Na terugkeer van deze aanroep mag de plugin uitsluitend UdsTransportProtocolMgr::HandlerStopped aanroepen [SWS_DM_01741]. De DM wacht actief op deze bevestiging [SWS_DM_00340].

Toestandsdiagram: levenscyclusfasen en overgangsvoorwaarden van een implementatie van een transportprotocol-handler. Bronnen: [SWS_DM_00329], [SWS_DM_00333], [SWS_DM_00340], [SWS_DM_01741], [SWS_DM_01744], [SWS_DM_01745], [SWS_DM_01746]

Gebruikspad

Tijdens normaal bedrijf verloopt het doorsturen van inkomende diagnoseberichten via een afgestemd samenspel tussen handler en manager:

1. Berichtindicatie: Als de handler gegevens ontvangt op een kanaal (ChannelID [SWS_DM_00337]), roept hij UdsTransportProtocolMgr::IndicateMessage aan. Daarbij kan hij vooraf-payload doorgeven in payloadInfo; aangeraden worden minimaal de eerste twee bytes voor de vroegtijdige herkenning van functionele verzoeken AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”.
2. Bufferallocatie: Als de DM gereed is voor opname, antwoordt IndicateMessage met een std::pair uit IndicationResult::kIndicationOk en een geldige smart pointer UdsMessagePtr [SWS_DM_00309] [SWS_DM_00385]. Het gerefereerde UdsMessage-object bezit een minimale capaciteit van één byte [SWS_DM_00385]. De buffer wordt beheerd als std::unique_ptr met een specifieke deleter van de DM-core en is niet thread-safe [SWS_DM_00303]. Voor leestoegangen bestaat het constante equivalent UdsMessageConstPtr [SWS_DM_00304].
3. Gegevensoverdracht: De handler schrijft de ontvangen diagnosegegevens in de klaargezette buffer, waarvan de bytesequentie via het type ByteSpan (alias voor ara::core::Span<ara::core::Byte> [SWS_DM_00338]) getypeerd is. Vermoedelijk dient het beschikbaar stellen van de afzonderlijke klasse UdsTransportProtocolPeriodicHandler via GetPeriodicHandler voor het ontkoppelen van de periodieke transmissiedienst 0x2A van het reguliere UDS-berichtpad. Vraag Q-230ef0b7c384c594 (open)

Sequentiediagram: verloop van de berichtindicatie en bufferallocatie tussen handler, manager en DM-core. Bronnen: AUTOSAR_AP_SWS_Diagnostics §7.1 “UDS Transport Layer”, [SWS_DM_00303], [SWS_DM_00309], [SWS_DM_00385], [SWS_DM_00386]

Foutscenario's

De specificatie definieert concrete fouttoestanden en precondities voor de transportkoppeling:

• Mislukte initialisatie: Levert UdsTransportProtocolHandler::Initialize het resultaat kInitializeFailed op, dan breekt de DM het initialisatieproces voor deze handler onmiddellijk af en roept hij er geen verdere methoden meer op aan [SWS_DM_01745].
• Weigering bij bezette diagnosecore: Wanneer de DM geblokkeerd is door een lopende serviceverwerking van dezelfde Tester Present-conversatie en het geen functionele Tester Present met payloadInfo 0x3E 0x80 betreft, geeft IndicateMessage het resultaat kIndicationOccupied samen met een nullptr terug in plaats van een berichtbuffer [SWS_DM_00386].
• Niet-toegestane aanroepen na beëindiging: Als een plugin na terugkeer van Stop een andere methode van UdsTransportProtocolMgr dan HandlerStopped aanroept, schendt dit de protocolvoorschriften [SWS_DM_01741]. Evenzo negeert de DM signalen zoals ChannelReestablished wanneer deze vóór de succesvolle aanroep van Start binnenkomen [SWS_DM_01744].