struct ara::diag::CommunicationControl::ComCtrlRequestParamsType

De datastructuur bundelt alle invoerparameters van een UDS-serviceverzoek 0x28 voor de adaptieve communicatiebesturing conform [SWS_DM_00805]. Bij ontvangst van een dergelijk diagnosebericht deserialiseert het platform de besturings- en communicatietypen evenals de knooppuntidentificatie en draagt het de gevulde structuur over aan de bijbehorende servicehandler. De applicatiesoftware evalueert de opgenomen waarden om het zend- en ontvangstgedrag van gedefinieerde netwerksegmenten gericht te beïnvloeden (AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”). Als staatloze datacontainer bezit de structuur geen eigen concurrency-synchronisatie, waardoor toegangen binnen de uitvoeringscontext van de handler moeten blijven.

meer ›

Context

De structuur ara::diag::CommunicationControl::ComCtrlRequestParamsType is een centraal gegevensoverdrachtstype binnen de functionele diagnose-interface van AUTOSAR Adaptive [SWS_DM_00805]. Zij is gedeclareerd in het headerbestand ara/diag/communication_control.h en dient als gestandaardiseerde parametercontainer die alle invoerparameters van een diagnoseverzoek van de UDS-dienst 0x28 (CommunicationControl) inkapselt (AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”).

In het totale systeem fungeert de structuur als bemiddelaar tussen het AUTOSAR-diagnosebeheer (Diagnostic Management) en de adaptieve applicatiesoftware die verantwoordelijk is voor de voertuigspecifieke communicatiebesturing. Binnenkomende diagnoseopdrachten van externe testers worden op platformniveau gedeserialiseerd en via deze structuur aan de applicatie overgedragen. De structuur omvat drie openbare lidvariabelen (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 “Public Member Variables”):

• controlType ([SWS_DM_01562], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.2 “controlType”): Gedefinieerd als std::uint8_t, transporteert dit veld de uit het UDS-verzoek geëxtraheerde subfunctie ter specificatie van het uit te voeren besturingsproces.
• communicationType ([SWS_DM_01563], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.1 “communicationType”): Eveneens van het type std::uint8_t, representeert dit veld het in het UDS-verzoek aangegeven communicatietype (zoals bijv. normale of netwerkmanagementcommunicatie).
• nodeIdentificationNumber ([SWS_DM_01564], AUTOSAR_AP_SWS_Diagnostics §8.7.2.1.3 “nodeIdentificationNumber”): Gedefinieerd als std::uint16_t, identificeert deze variabele het concrete doelknooppunt respectievelijk het deelnetwerk waartoe de besturingsinstructie is gericht.

Levenscyclus

Als elementaire C++-structuur (struct) [SWS_DM_00805] vertoont ComCtrlRequestParamsType de eigenschappen van een eenvoudig waardetype (Plain Old Data / POD). Zij bezit geen interne toestandsmachine, geen virtuele functiewijzers en geen dynamisch gealloceerde geheugengebieden (AUTOSAR_AP_SWS_Diagnostics §8.7.2.1 “Public Member Variables”).

Het aanmaken van een instantie gebeurt typisch vluchtig door het Diagnostic Management-framework: zodra een UDS-0x28-bericht is ontvangen en formeel is gevalideerd, instantieert de stack de structuur en initialiseert hij de lidvariabelen met de gedecodeerde payload (interpretatie: de objectcreatie berust volledig bij de middleware in het kader van de verzoekacceptatie). Vraag Q-1abe8049ce5759f2 (open) De eigendomsverhoudingen zijn strikt beperkt tot de context van de methode-aanroep. Het platform draagt de instantie gewoonlijk per waarde of constante referentie over aan de servicehandler van de applicatie; de ontvangende applicatie neemt geen permanent eigenaarschap van de instantie over.

Dienovereenkomstig bestaan er geen levenscyclusfasen of complexe statusovergangen. De vernietiging van de instantie vindt automatisch plaats bij het verlaten van de scope van de desbetreffende callback-aanroep. Met het oog op gelijktijdigheid implementeert ComCtrlRequestParamsType geen eigen synchronisatiemechanismen. Aangezien de members na initialisatie door het platform doorgaans puur lezend door de applicatiesoftware worden geëvalueerd, is de toegang vermoedelijk thread-safe, mits de instantie thread-lokaal aan de verwerkingscontext wordt overgedragen (interpretatie: voor de evaluatie zijn geen externe vergrendelingen vereist). Vraag Q-d654753d06273bca (open)

Gebruikspad

Het typische gebruikstraject in het kader van de diagnoseverwerking verloopt in een vaste stappenvolgorde van het netwerkbericht tot aan de applicatiereactie (AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”):

1. Ontvangst van het diagnosebericht: Een externe diagnosetester verzendt een UDS-0x28-verzoek naar de ECU. Het Adaptive Diagnostic Management neemt het datapakket op transportniveau in ontvangst.
2. Deserialisatie en instantiëring: De diagnosestack parset de payload, maakt een instantie van ComCtrlRequestParamsType [SWS_DM_00805] aan en wijst de overgedragen waarden toe aan de velden controlType [SWS_DM_01562], communicationType [SWS_DM_01563] en nodeIdentificationNumber [SWS_DM_01564].
3. Overdracht aan de service-handler: De middleware stuurt de instantie door naar de geïmplementeerde callback-methode van de CommunicationControl-interface in de adaptieve applicatie.
4. Parameterevaluatie en uitvoering: De adaptieve applicatie leest de structuur uit. Aan de hand van de nodeIdentificationNumber [SWS_DM_01564] wordt vastgesteld of de eigen node dan wel een deelnetwerk is geadresseerd. Vervolgens worden via controlType [SWS_DM_01562] en communicationType [SWS_DM_01563] de desbetreffende zend- en ontvangstmodi geactiveerd of gedeactiveerd.
5. Terugmelding: Na succesvolle uitvoering bevestigt de applicatie de bewerking aan het Diagnostic Management, dat het standaardconforme positieve UDS-antwoord naar de diagnosetester verzendt.

Sequentiediagram: Typisch verloop van de verzoekverwerking van het UDS-0x28-bericht tot aan de parameterevaluatie in de applicatie. Bronnen: [SWS_DM_00805], AUTOSAR_AP_SWS_Diagnostics §8.7.2 “Struct: ComCtrlRequestParamsType”