service-interface UpdateAllowedService

De service-interface dient ertoe dat een besturingsapplicatie State Management toestaat of belet software-updates uit te voeren (EXP SWArchitecture §9.2.2.1.1 “Interfaces for a SMControlApplication”). Via het beschikbaar gestelde veld verzendt de applicatie de vrijgavestatus naar de controller van het toestandsbeheer ([SWS_SM_91108]). Staat het veld op een weigerende toestand, dan wijst State Management binnenkomende sessieverzoeken van het Update and Configuration Management dwingend af. Hoewel campagnes voertuigbreed worden gesynchroniseerd, waarborgt dit mechanisme dat lokale machinetoestanden een update op elk moment kunnen verhinderen.

meer ›

Rol en systeemcontext van de service-interface

De service-interface UpdateAllowedService is een dienst van het AUTOSAR Adaptive Platform binnen het functionele cluster State Management (SM) ([SWS_SM_91025]). Het cluster SM stelt deze service via een gestandaardiseerde poort beschikbaar voor andere processen ([SWS_SM_91024]). In de systeemarchitectuur behoort de interface tot de interactie-interfaces voor een besturingsapplicatie (SMControlApplication), met behulp waarvan bovengeschikte applicatielogica kan interageren met de toestandsmachines van State Management (EXP SWArchitecture §9.2.2.1.1 “Interfaces for a SMControlApplication”).

De interface dient er primair toe dat een SMControlApplication interageert met de Controller van State Management (SWS StateManagement §9.2.3 “StateMachine UpdateAllowed service”). Terwijl het cluster State Management de service-instantie als provider aanbiedt, fungeert de SMControlApplication als serviceconsument (interpretatie: de applicatie ageert als client-proxy in het kader van het ara::com-patroon). Vraag Q-ba7662e744d9f9f0 (open) De kerntaak van de interface bestaat erin State Management mee te delen of een updatesessie (Update Session) op de machine moet worden toegekend of geweigerd (SWS StateManagement §9.2.3 “StateMachine UpdateAllowed service”).

Methoden, gebeurtenissen en velden

De service-interface UpdateAllowedService omvat geen zelfstandige methoden of events, maar bundelt haar functionaliteit volledig in een veld genaamd UpdateAllowed ([SWS_SM_91108]). Dit veld is van het datatype UpdateAllowedType en beschikt over zowel getter-, setter- als notifier-functionaliteit (HasGetter = true, HasSetter = true, HasNotifier = true) ([SWS_SM_91108]).

Via de setter kan de SMControlApplication de actuele vrijgavestatus actief instellen en naar State Management verzenden ([SWS_SM_91108]). De getter maakt het opvragen van de opgeslagen waarde mogelijk, terwijl de notifier waardewijzigingen eventgebaseerd meldt aan abonnees ([SWS_SM_91108]). De concrete inhoud van het veld bepaalt in doorslaggevende mate of een aanstaande updatesessie wordt toegestaan of niet (SWS StateManagement §9.2.3 “StateMachine UpdateAllowed service”).

Levenscyclus, sessieverlopen en toestandsafhankelijkheden

De updatevrijgave is van toepassing in de context van software-updatecampagnes waarbij het Update and Configuration Management (UCM) via de methode RequestUpdateSession een updatesessie aanvraagt bij State Management (SWS StateManagement §7.x). Weliswaar dient de principiële uitvoerbaarheid van een updatecampagne vooraf op voertuigniveau te worden gesynchroniseerd en gecontroleerd, maar een campagne kan meerdere machines omvatten en aanzienlijke tijd in beslag nemen (SWS StateManagement §7.x).

Aangezien lokale randvoorwaarden op een afzonderlijke machine gedurende deze tijdsspanne kunnen veranderen, is de expliciete aanroep van RequestUpdateSession dwingend vereist (SWS StateManagement §7.x). De SMControlApplication past de vrijgavestatus via het veld UpdateAllowed continu aan. Staat de SMControlApplication de start van de sessie toe (interpretatie: door het instellen van een overeenkomstige vrijgavewaarde zoals kUpdateAllowed), dan mag het gemodelleerde proces van de controller de updatesessie accepteren (SWS StateManagement §7.x). Vraag Q-3dd3bcc37bf14309 (open)

Sequentiediagram: Weigering van een updatesessie door State Management bij ingestelde waarde kUpdateNotAllowed. Bronnen: [SWS_SM_00630], SWS StateManagement §7.x

Foutafhandeling en Application Errors

Weigert de SMControlApplication de uitvoering van een update, dan moet het gemodelleerde proces dat de toestandsmachine van het type Controller aanstuurt, het updateverzoek van het UCM afwijzen (SWS StateManagement §7.x). Wanneer het veld UpdateAllowed op de waarde kUpdateNotAllowed is ingesteld, moet het gemodelleerde proces van de Controller-toestandsmachine bij de methodeaanroep RequestUpdateSession dwingend de fout kOperationRejected retourneren ([SWS_SM_00630]).

Via deze specifieke Application Error wordt aan het UCM gesignaleerd dat de lokale machine momenteel niet gereed is voor de overgang naar een updatesessie, waardoor foutieve of veiligheidskritieke updatetoestanden worden vermeden ([SWS_SM_00630]).