service-interface StateMachineNotification

De ServiceInterface StateMachineNotification stelt aan Adaptive Applications de toestand van een toestandsmachine beschikbaar via het leesbare en abonneerbare veld CurrentState ([SWS_SM_91028], [SWS_SM_91109]). Bij toestandswisselingen signaleert het veld de tussenwaarde "inTransition" totdat alle acties zijn uitgevoerd ([SWS_SM_00616]). De interface wordt na het starten van de toestandsmachine aangeboden en bij de beëindiging ervan weer ingetrokken ([SWS_SM_00618], [SWS_SM_00619]).

meer ›

Rol en systeemcontext van de service-interface

De ServiceInterface StateMachineNotification wordt geleverd door de module State Management (SM) van het AUTOSAR Adaptive Platform ([SWS_SM_91028]). Terwijl besturingsapplicaties via afzonderlijke interfaces nieuwe toestandsovergangen aanvragen, interacteert StateMachineNotification voornamelijk met reguliere Adaptive Applications op het applicatieniveau (AUTOSAR_AP_SWS_StateManagement p. 44). De service fungeert als provider (skeleton), terwijl consumerende applicaties als consumer (proxy) via ara::com zijn aangesloten. Indien geconfigureerd voor een concrete toestandsmachine, instantieert State Management een eigen instantie van deze interface ([SWS_SM_00665]). In projecten waarin bepaalde toestandsmachines zuiver intern werken en niet relevant zijn voor applicaties, kan worden afgezien van configuratie en aanbieding (AUTOSAR_AP_SWS_StateManagement p. 45).

Methoden, gebeurtenissen en velden

De interface definieert geen klassieke methoden of pure events, maar kapselt de toestand van de bewaakte toestandsmachine in een centraal veld ([SWS_SM_91109]). Het veld CurrentState heeft het datatype StateMachineStateNameType en is puur lezend ontworpen: het beschikt over een getter (HasGetter: true) en een notifier (HasNotifier: true), maar heeft geen setter (HasSetter: false) ([SWS_SM_91109]). Adaptive Applications kunnen de actuele waarde daarmee zowel synchroon via de getter opvragen als notificaties abonneren om bij toestandswisselingen van de desbetreffende toestandsmachine asynchroon via ara::com te worden geïnformeerd ([SWS_SM_91109]).

Zodra een toestandsovergang van de toestandsmachine wordt gestart, neemt het veld CurrentState de vaste waarde "inTransition" aan ([SWS_SM_00616]). Deze tussentoestand wordt ingesteld ongeacht de activerende bron – bijvoorbeeld Execution Management, Platform Health Management of een besturingsapplicatie – en blijft ook bestaan wanneer als reactie op foutnotificaties verdere overgangen plaatsvinden (AUTOSAR_AP_SWS_StateManagement p. 67). Pas wanneer alle bijbehorende acties zijn afgehandeld, wordt de waarde bijgewerkt naar de daadwerkelijke doeltoestand van de toestandsmachine ([SWS_SM_00617]).

Sequentiediagram: aanbieding, opvraging en notifier-notificaties bij toestandsovergangen via StateMachineNotification. Bronnen: [SWS_SM_00618], [SWS_SM_91109], [SWS_SM_00616], [SWS_SM_00617]

Levenscyclus, aanbieding en toestandsafhankelijkheden

Het starten van een toestandsmachine is een meerstaps proces (AUTOSAR_AP_SWS_StateManagement p. 59). Een toestandsmachine geldt vanuit het oogpunt van overkoepelende controllers pas als gestart wanneer deze bestaat en de bijbehorende interfaces worden aangeboden (AUTOSAR_AP_SWS_StateManagement p. 59). Elke geconfigureerde StateMachineNotification-instantie wordt via ara::com aangeboden (offered) zodra het ActionListItem met de opdracht StartStateMachine met succes is verwerkt ([SWS_SM_00618]). Dit stelt applicaties in staat zich vroegtijdig aan de service te binden.

Wanneer een toestandsmachine wordt beëindigd of afgeschaald, wordt de service weer ingetrokken: de interface is vanaf het moment dat de desbetreffende beëindigingsactie wordt verwerkt niet meer beschikbaar (StopOffer) ([SWS_SM_00619]). Worden toestandsmachines door een controller bestuurd, dan vereist het metamodel bovendien dat elke actielijst refereert aan de volledige verzameling gecontroleerde agenten ([SWS_SM_CONSTR_00016]).

Foutafhandeling en randvoorwaarden

Voor StateMachineNotification zijn in het interfacemodel geen eigen applicatiespecifieke Application Errors (zoals kOperationRejected) gedefinieerd, omdat de interface zuiver observerend werkt en geen modificerende methoden aanbiedt ([SWS_SM_91109]). De foutafhandeling steunt op de communicatiemechanismen van ara::com bij het opvragen van het veld en op de evaluatie van de status "inTransition": consumers mogen deze tussenwaarde interpreteren als aanduiding van een lopend omschakel- of foutherstelproces (AUTOSAR_AP_SWS_StateManagement p. 67).