Dient voor de verzending en het beheer van de toestand van een DoIP-activeringslijn naar de Diagnostic Manager.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: f91d71d289e3HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Dient voor de verzending en het beheer van de toestand van een DoIP-activeringslijn naar de Diagnostic Manager.
De klasse ara::diag::DoIPActivationLine stelt een applicatie in staat om de toestand van een DoIP-activeringslijn beschikbaar te stellen en wijzigingen door te geven aan de Diagnostic Manager [SWS_DM_00830]. Na de op poorten gebaseerde instantiëring wordt de service geactiveerd middels Offer(), waarna de DM lijnstatus en netwerk-ID opvraagt en statuswijzigingen via UpdateActivationLineState() ontvangt [SWS_DM_00834]. Als centrale randvoorwaarde moet de bijbehorende netwerkinterface in het model geconfigureerd zijn als afhankelijk van de activeringslijn [SWS_DM_00833].
Context
De klasse ara::diag::DoIPActivationLine representeert de interface DiagnosticDoIPActivationLineInterface conform [SWS_DM_00830]. Deze stelt een Adaptive Application (AA) in staat om de fysieke of logische toestand van een DoIP-activeringslijn te melden en beschikbaar te stellen aan de Diagnostic Manager (DM). Via deze activeringslijn regelt een applicatie indirect het verzenden van DoIP-voertuigaankondigingsberichten (Vehicle Announcement Messages), zoals gespecificeerd in AUTOSAR_AP_SWS_Diagnostics, p. 107, zonder de verzending expliciet zelf te triggeren.
Bij de interactie zijn in wezen drie componenten betrokken: de implementerende Adaptive Application, de instantie van ara::diag::DoIPActivationLine als service-interface en de Diagnostic Manager van het basissysteem. Detecteert de DM via deze interface een toestandsverandering van de activeringslijn, dan stelt deze afhankelijke netwerkinterfaces op de hoogte en initieert gestandaardiseerde DoIP-processen [SWS_DM_00816].
Een instantie van ara::diag::DoIPActivationLine wordt aangemaakt via een ara::core::InstanceSpecifier die verwijst naar een PortPrototype[SWS_DM_00831]. De klasse vormt een unieke instantie: copy- en move-constructors evenals copy- en move-toekenningsoperators zijn verwijderd (=delete), waardoor verplaatsen of dupliceren uitgesloten is ([SWS_DM_01631], [SWS_DM_01632], [SWS_DM_01633], [SWS_DM_01634]).
Na instantiëring bevindt het object zich in de toestand “niet aangeboden”. Door de aanroep van Offer() wordt de beschikbaarstelling geactiveerd, zodat de DM kan luisteren naar toestandsveranderingen van de activeringslijn [SWS_DM_00836]. Middels StopOffer() wordt deze beschikbaarstelling weer gedeactiveerd [SWS_DM_00837]. De virtuele destructor is gedeclareerd als standaarddestructor en geeft de resources vrij [SWS_DM_00832]. Wat betreft gelijktijdigheid zijn de constructor [SWS_DM_00831] en de zuivere leesopvragingen GetActivationLineState()[SWS_DM_00835] en GetNetworkInterfaceId()[SWS_DM_00833] thread-safe uitgevoerd, terwijl Offer()[SWS_DM_00836], StopOffer()[SWS_DM_00837] en UpdateActivationLineState()[SWS_DM_00834] niet thread-safe zijn.
Gebruikspad
Het reguliere verloop omvat het afleiden en registreren van een applicatiespecifieke klasse en de continue toestandsverzending:
Instantiëring: De Adaptive Application instantieert de afgeleide klasse onder vermelding van de passende InstanceSpecifier[SWS_DM_00831].
Service aanbieden: De applicatie roept Offer() aan om de interface vrij te geven voor de DM [SWS_DM_00836].
Netwerk- en initiële opvraging: De DM bepaalt via de pure virtual methode GetNetworkInterfaceId() het bijbehorende interface-ID [SWS_DM_00833] en vraagt met GetActivationLineState() de actuele lijntoestand op [SWS_DM_00835]. Beide methoden retourneren een ara::core::Future.
Toestandsactualisering: Verandert de fysieke toestand van de lijn (bijv. niveauloop op een hardwarelijn), dan informeert de applicatie de DM synchroon via UpdateActivationLineState()[SWS_DM_00834]. Dit brengt de DM ertoe vervolgacties te ondernemen, zoals statusmeldingen aan netwerkinterfaces [SWS_DM_00816].
Beëindiging: Voor het afsluiten of bij deactivering roept de applicatie StopOffer() aan [SWS_DM_00837].
Bij het gebruik van ara::diag::DoIPActivationLine kunnen functionele fouten en configuratiefouten optreden:
Model- en poortschendingen bij aanmaak: De constructor controleert de geldigheid van de InstanceSpecifier[SWS_DM_00831]. Faalt de resolutie, dan worden gestandaardiseerde schendingsmeldingen geactiveerd: InstanceSpecifierMappingIntegrityViolation (ongeldig modelelement), PortInterfaceMappingViolation (poort niet getypeerd door DiagnosticDoIPActivationLineInterface), ProcessMappingViolation (ontbrekende procesreferentie) of InstanceSpecifierAlreadyInUseViolation (specifier binnen het proces reeds vergeven).
Meervoudig aanbieden: Wordt Offer() aangeroepen terwijl de service al wordt aangeboden, dan mislukt de bewerking met de foutcode DiagOfferErrc::kAlreadyOffered[SWS_DM_00836].
Configuratie-inconsistentie van de netwerkinterface: Meldt de applicatie via GetNetworkInterfaceId() een interface-ID waarvan de bijbehorende DoIpNetworkConfiguration de eigenschap isActivationLineDependent = 'FALSE' bezit, dan geldt dit volgens de specificatie expliciet als een ernstige configuratiefout [SWS_DM_00833].
Uitzonderingsveiligheid: Terwijl de constructor, de getters, Offer(), StopOffer() en de destructor als uitzonderingsveilig (exception safe) zijn gespecificeerd, is UpdateActivationLineState() expliciet aangemerkt als niet-uitzonderingsveilig (not exception safe) [SWS_DM_00834]. Fouten binnen deze aanroep moeten door de aanroepende applicatie daarom zorgvuldig worden afgehandeld.
Deze handleiding is uitsluitend gebaseerd op de specificatievoorschriften uit AUTOSAR AP Release R25-11.
InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticDoIpActivationLinePortMapping needs to be typed by a DiagnosticDoIPActivationLineInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.
Parameter (in)
Parameter
Beschreibung
specifier
InstanceSpecifier to a PortPrototype of a DiagnosticDoIPActivationLineInterface
Request a governed re-review of this record. The record is not changed immediately.
network interface id for which this activation line is responsible.
Fehler
Fehlercode
Beschreibung
This function does not specify any standardized errors.
Hinweise: If the reported DoIpNetworkConfiguration.networkInterfaceId belongs to a DoIpNetworkConfiguration with property isActivationLineDependent = ’FALSE’, this is an error!
Request a governed re-review of this record. The record is not changed immediately.
This Offer will enable the DM to listen to activation line state changes.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 3534ff4305bfHerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De synchrone methode Offer van de klasse ara::diag::DoIPActivationLine ([SWS_DM_00836], headerbestand #include "ara/diag/doip_activationline.h") stelt Diagnostic Management (DM) in staat statuswijzigingen van de activeringslijn te detecteren. De bewerking heeft geen invoerparameters en meldt het resultaat terug via het retourtype ara::core::Result<void>.
Zodra de interface middels Offer ter beschikking is gesteld, bewaakt de DM de activeringslijn. Detecteert de DM een overgang naar de toestand „active”, dan initieert deze het verzenden van voertuigaankondigingsberichten (Vehicle Announcement Messages) conform ISO 13400-2 op de desbetreffende netwerkinterfaces ([SWS_DM_00816], AUTOSAR_AP_SWS_Diagnostics §[SWS_DM_00816] p. 106). Interpretatie: de aanroep van Offer vindt typisch plaats in de initialisatiefase van de applicatie, zodat statuswisselingen vroegtijdig worden geregistreerd. Vraag Q-254ced2fd3a1e3d2 (open)
In geval van een fout wordt een overeenkomstige foutcode in Result geretourneerd. Indien de methode voor dezelfde instantie herhaaldelijk wordt aangeroepen terwijl de service reeds wordt aangeboden, retourneert deze de foutcode DiagOfferErrc::kAlreadyOffered met rollback-semantiek ([SWS_DM_00836]).
Wat betreft gelijktijdigheid is de methode gespecificeerd als niet-thread-safe (not thread-safe) ([SWS_DM_00836]). Gelijktijdige aanroepen op dezelfde instantie moeten daarom aan applicatiezijde worden gesynchroniseerd. Door de declaratie als noexcept is de functie volledig exception-safe ([SWS_DM_00836]).
Deze gebruiksinstructie is gebaseerd op de specificatie AUTOSAR Adaptive Platform Release R25-11.
This StopOffer will disable the provision of activation line state to DM.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 668b8f5f37f2HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De methode ara::diag::DoIPActivationLine::StopOffer beëindigt het beschikbaar stellen van de toestand van de DoIP-activeringslijn (Activation Line) aan het Diagnostic Management (DM) conform [SWS_DM_00837].
De functie heeft de signatuur void StopOffer() noexcept en wordt synchroon uitgevoerd op een instantie van ara::diag::DoIPActivationLine (AUTOSAR_AP_SWS_Diagnostics §5 “Overview”). Ze accepteert geen parameters en levert geen retourwaarde op. Door de aanroep wordt de actieve doorgifte van toestandswijzigingen van de activeringslijn aan de Diagnostic Manager gedeactiveerd.
Wat betreft foutafhandeling is de methode gespecificeerd als exception safe en garandeert via noexcept dat er geen excepties worden geworpen ([SWS_DM_00837]). Omdat de operatie volgens de specificatie not thread-safe is, mogen aanroepen op dezelfde instantie niet onbeschermd gelijktijdig vanuit meerdere threads plaatsvinden; parallelle toegangen vereisen dwingend synchronisatie aan applicatiezijde.
Het ontwerppatroon volgt de in het Adaptive-platform gevestigde nomenclatuur voor de dienstverlening (AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”). Waar StopOffer bij verwante DoIP-klassen zoals ara::diag::DoIPGroupIdentification ([SWS_DM_00726]) of ara::diag::DoIPPowerMode ([SWS_DM_00736]) het doorsturen van inkomende DM-verzoeken deactiveert, stopt het hier specifiek het melden van de toestand van de activeringslijn aan het DM. Interpretatie: Voor een consistent operationeel verloop wordt vermoedelijk verondersteld dat voorafgaand aan de aanroep van StopOffer reeds een beschikbaarstelling via dezelfde instantie actief is geïnitieerd. Vraag Q-c5d38151ef8198e7 (open)
Deze gebruiksinstructie is door een AI gegenereerd op basis van de specificatie AUTOSAR R25-11.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: becd58166c09HerkomstOpen vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De methode UpdateActivationLineState van de klasse ara::diag::DoIPActivationLine dient ertoe om de actuele status van de DoIP-activeringslijn aan het adaptieve diagnosebeheer door te geven [SWS_DM_00834] (AUTOSAR_AP_SWS_Diagnostics §8.32.1.1.3.5). De declaratie wordt via het headerbestand ara/diag/doip_activationline.h beschikbaar gesteld.
Gebruik en parameters:
Parameters: De booleaanse overdrachtsparameter activation_line_state signaleert aan het systeem of de activeringslijn actief (TRUE) of inactief (FALSE) is [SWS_DM_00834].
Retourwaarde: De operatie heeft geen retourwaarde (void) en werkt synchroon.
Gelijktijdigheid en beperkingen:
Thread-safety: De functie is expliciet gespecificeerd als not thread-safe[SWS_DM_00834]. Interpretatie: Aanroepen op dezelfde instantie van DoIPActivationLine moeten door de aanroepende applicatie worden gesynchroniseerd om dataconflikten te voorkomen. Vraag Q-d1c43b8ffc4bdcff (open)
Foutafhandeling: De methode is gedeclareerd als not exception safe[SWS_DM_00834]. Specifieke foutcodes of excepties zijn niet gedefinieerd; de aanroepende applicatie kan in de regel geen excepties opvangen. Vraag Q-394304b9d771cf69 (open)
Deze tekst is gegenereerd door een AI op basis van de specificatie.
gemini-3.8-flash-low· 2026-10-13 · Duits origineel