klasse ara::shwa::DeviceMonitor

De klasse ara::shwa::DeviceMonitor dient voor de synchrone bewaking van de toestand van hardware-apparaten in het functionele cluster shwa. Instanties worden via de statische factory-methode Create op basis van een apparaatreferentie aangemaakt ([AP_SWS_SHWA_01407]), waarna de apparaatstatus continu via de methode Status() kan worden opgevraagd ([AP_SWS_SHWA_01409]). Terwijl de aanmaak via factory-methoden thread-safe wordt uitgevoerd, is de aanroep voor het opvragen van de status niet thread-safe en vereist deze bij parallelle toegang vermoedelijk synchronisatie aan de toepassingszijde. Vraag (open)

meer ›

Context

De klasse ara::shwa::DeviceMonitor biedt in de module shwa de centrale interface voor de bewaking van de toestand van hardware-apparaten. Toepassingssoftware gebruikt de klasse om de bedrijfsstatus op te vragen van een hardwarecomponent die is geïdentificeerd via een apparaatreferentie Device of via een selectorelement DeviceSelector ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). Door de inkapseling van de statusbepaling in het retourtype DeviceStatus ([AP_SWS_SHWA_01409]) ontkoppelt DeviceMonitor de aanroepende besturingstoepassing van de interne hardwaredetails en dient als gestandaardiseerde waarnemer voor de levens- en foutcyclus van het geadresseerde apparaat.

Levenscyclus

Instanties van DeviceMonitor kunnen niet worden aangemaakt via een parameterloze standaardconstructor, aangezien deze expliciet is verwijderd ([AP_SWS_SHWA_01402]). De objectaanmaak verloopt in plaats daarvan gecontroleerd via twee statische factory-methoden: Create(const Device &device) ([AP_SWS_SHWA_01407]) of de template-functie Create(const DeviceSelector &deviceSelector) ([AP_SWS_SHWA_01408]). Beide factory-paden leveren een ara::core::Result<DeviceMonitor> op, zijn gespecificeerd als uitzonderingsveilig (exception safe) en garanderen thread-safety.

Wat betreft eigendomsverhoudingen en waardesemantiek gedraagt de klasse zich flexibel: zowel kopieerconstructor ([AP_SWS_SHWA_01403]) en kopieertoekenningsoperator ([AP_SWS_SHWA_01404]) als verplaatsingsconstructor ([AP_SWS_SHWA_01405]) en verplaatsingstoekenningsoperator ([AP_SWS_SHWA_01406]) zijn beschikbaar als gestandaardiseerde (default) en uitzonderingsveilige (noexcept) operaties.

Bij het thema gelijktijdigheid moet strikt onderscheid worden gemaakt tussen constructie en gebruik: terwijl de aanmaak via de factory-functies thread-safe is, is de opvraagmethode Status() expliciet gedeclareerd als niet thread-safe (not thread-safe) ([AP_SWS_SHWA_01409]). Bij parallelle toegang van meerdere threads tot dezelfde instantie is vermoedelijk synchronisatie aan de toepassingszijde vereist. Vraag Q-4002d6fb6cac23ce (open)

Gebruikspad

Het typische gebruikspad is onderverdeeld in de aanmaak van de monitorinstantie, de validatie van het resultaat en het herhaaldelijk opvragen van de apparaatstatus. Eerst roept de toepassing een van de factory-methoden Create aan en geeft de doelcomponent door ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). Vervolgens controleert de toepassing het resulterende ara::core::Result op succes. Als het object geldig is, wordt de methode Status() aangeroepen ([AP_SWS_SHWA_01409]), die synchroon een object van het type DeviceStatus oplevert.

Sequentiediagram: Typisch aanroepverloop van de instantiëring tot het herhaaldelijk opvragen van de status. Bronnen: [AP_SWS_SHWA_01407], [AP_SWS_SHWA_01409]

Foutscenario's

Fouten treden voornamelijk op bij de aanmaak via de factory-methoden Create en worden zonder C++-excepties in het retourtype ara::core::Result via ShwaErrorCode beschikbaar gesteld ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]). De volgende fouttoestanden zijn gedefinieerd voor de aanmaak:

• ShwaErrorCode::kRuntime: Er is een algemene runtimefout opgetreden tijdens de initialisatie ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kResourceBusy: De onderliggende bron is momenteel bezet, waardoor het aanmaken van de monitor niet onmiddellijk kan worden voltooid ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kInvalidParameter: Aan de aanroep is een ongeldig argument doorgegeven, bijvoorbeeld een niet-toegestane apparaatspecificatie ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).
• ShwaErrorCode::kFeatureNotSupported: De aangevraagde bewakingsfunctie wordt niet ondersteund door het doelplatform of de hardwareconfiguratie ([AP_SWS_SHWA_01407], [AP_SWS_SHWA_01408]).

Tijdens de normale werking bij het aanroepen van Status() zijn er geen foutcodes of excepties voorzien; de methode is noexcept en garandeert Exception Safety ([AP_SWS_SHWA_01409]). Een hardwarestoring of verbindingsverlies wordt vermoedelijk weerspiegeld in de geretourneerde toestandswaarde DeviceStatus. Vraag Q-8e2c8c2c7533b36f (open)