classe apext::sm::PowerStateInterface

L'interface coordonne, en tant que wrapper OS, les états d'énergie entre State Management et le système d'exploitation ([SWS_SM_71000]). State Management enregistre préalablement par son intermédiaire des gestionnaires de rappel pour les événements de réveil et transmet les requêtes d'état concrètes au système d'exploitation ([SWS_SM_71001]). Une fois la réactivation effectuée, l'enregistrement du gestionnaire peut être annulé dans le wrapper OS. Comme contrainte fonctionnelle essentielle, tous les appels de méthodes ne sont pas sûrs pour les threads et doivent donc obligatoirement être sérialisés par l'appelant.

plus ›

Contexte

La classe C++ apext::sm::PowerStateInterface fait office d'interface fonctionnelle du module State Management pour la coordination des états d'énergie avec le système d'exploitation ([SWS_SM_71000], SWS StateManagement §C.1.2 « Class: PowerStateInterface »). Dans l'architecture système, elle assume le rôle d'un wrapper OS qui transmet les requêtes de State Management au système d'exploitation sous-jacent et reçoit les retours. Trois composants clés participent à l'interaction globale : State Management en tant qu'instance coordinatrice, la classe PowerStateInterface en tant qu'intermédiaire, et le système d'exploitation hôte qui exécute la gestion de l'énergie proche du matériel ([SWS_SM_71001]).

Diagramme de contexte : coordination des états d'énergie et des signaux de réveil entre State Management, le wrapper OS et le système d'exploitation. Sources : [SWS_SM_71000], [SWS_SM_71001], [SWS_SM_71003].

Cycle de vie

La création et la destruction d'instances de la classe PowerStateInterface ne sont pas régies par des méthodes de fabrique explicites dans les documents de spécification. Selon l'interprétation, l'instanciation devrait être effectuée par State Management au cours de sa phase d'initialisation afin de fournir le wrapper OS. Question Q-15bde6ce044e9bc3 (ouverte) L'en-tête apext/sm/power_state_interface.h est prévu pour l'inclusion de la classe ([SWS_SM_71001], SWS StateManagement §C.1.2.1.1 « Member Functions »).

En ce qui concerne l'état interne, l'objet gère l'enregistrement d'un gestionnaire pour les événements de réveil. Cet état reste actif jusqu'à ce que le gestionnaire soit explicitement retiré ([SWS_SM_71005]). Concernant la concurrence, toutes les fonctions membres sont classées comme non sûres pour les threads (not-threadsafe) ([SWS_SM_71001], [SWS_SM_71003], [SWS_SM_71005]). L'instance appelante de State Management doit donc s'assurer sous sa propre responsabilité que les appels à une instance sont strictement sérialisés et qu'aucun accès parallèle non protégé n'a lieu depuis plusieurs threads.

Parcours d'utilisation

Un chemin d'utilisation typique pour commander des états d'énergie et recevoir des signaux de réveil s'effectue en plusieurs étapes coordonnées :

• Enregistrement du gestionnaire : avant d'engager un état d'économie d'énergie, State Management enregistre au moyen de RegisterWakeUpHandler une fonction de rappel de type apext::sm::WakeUpHandler dans le wrapper OS ([SWS_SM_71003], SWS StateManagement §C.1.2.1.1.1 « RegisterWakeUpHandler »). Cela définit la façon dont State Management sera informé des processus de réveil subséquents.
• Requête d'état : State Management appelle ensuite la méthode SetPowerState avec l'état cible apext::sm::PowerState souhaité ([SWS_SM_71001], SWS StateManagement §C.1.2.1.1.2 « SetPowerState »). L'interface transmet immédiatement cette requête au système d'exploitation. La mise en œuvre technique de la transition s'effectue probablement de façon spécifique à la plateforme dans le système d'exploitation. Question Q-29345b74ba3bedf2 (ouverte)
• Notification de réveil : si le système d'exploitation détecte un événement de réveil, la notification est signalée au wrapper OS. Celui-ci exécute le WakeUpHandler précédemment enregistré. Selon l'interprétation, l'appel devrait avoir lieu de manière asynchrone dans le contexte d'exécution du processus de réactivation. Question (ouverte)
• Désenregistrement du gestionnaire : dès que le processus de réveil est terminé ou que State Management ne requiert plus d'autres notifications, le rappel enregistré est retiré du wrapper OS via UnregisterWakeUpHandler ([SWS_SM_71005], SWS StateManagement §C.1.2.1.1.3 « UnregisterWakeUpHandler »).

Diagramme de séquence : déroulement typique de l'enregistrement du gestionnaire, du transfert d'état au système d'exploitation et du désenregistrement. Sources : [SWS_SM_71001], [SWS_SM_71003], [SWS_SM_71005].

Scénarios d'erreur

Les méthodes d'interface RegisterWakeUpHandler, SetPowerState et UnregisterWakeUpHandler possèdent le type de retour void et ne définissent aucun code de retour d'erreur spécifique ([SWS_SM_71001], [SWS_SM_71003], [SWS_SM_71005]). Toutes les fonctions sont déclarées comme noexcept et garantissent une sécurité totale vis-à-vis des exceptions (exception safe).

Les états système erronés peuvent découler principalement de violations de préconditions. Cela inclut la violation de la sécurité des threads requise en raison d'appels de méthode parallèles non protégés. De plus, State Management doit s'assurer, en tant que condition préalable pour RegisterWakeUpHandler, que l'objet fonction transmis est valide et demeure en mémoire jusqu'à son annulation par UnregisterWakeUpHandler ([SWS_SM_71003], [SWS_SM_71005]).