klasse ara::shwa::AcceleratorSelector

De klasse ara::shwa::AcceleratorSelector dient in de hardware-acceleration-module voor de beoordeling en selectie van geschikte versnellerapparaten conform een selectorstrategie ([AP_SWS_SHWA_00413]). Via SelectDevice() kan direct een passend Device worden geselecteerd, terwijl operator() een individuele numerieke beoordeling van afzonderlijke apparaten mogelijk maakt ([AP_SWS_SHWA_00412]). Aangezien beide operaties als niet thread-safe zijn gespecificeerd, vereist concurrent gebruik externe synchronisatie. Mogelijke fouten zoals overbelaste resources of niet-ondersteunde functies worden zonder rollback via ara::core::Result teruggemeld.

meer ›

Context

De klasse ara::shwa::AcceleratorSelector fungeert in de module shwa (Hardware Acceleration) van het AUTOSAR Adaptive Platform als gespecialiseerde selector voor hardwareversnellerapparaten. Volgens de klassesyntaxis leidt deze publiek af van de basisinterface DeviceSelector (class AcceleratorSelector : public DeviceSelector). Haar centrale taak bestaat erin fysieke of logische versnellerapparaten (Device) volgens een gedefinieerde selectorstrategie te evalueren of een passend apparaat te selecteren ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

Tot de interactiepartners behoren de bovengeschikte applicatielogica, die versnellerresources voor rekenintensieve taken aanvraagt, de overervende basisklasse DeviceSelector en de door de selector geanalyseerde of geretourneerde Device-instanties. De selectiecriteria zelf zijn ingekapseld in de concrete implementatie van de selectorstrategie ([AP_SWS_SHWA_00413]).

Contextdiagram: inpassing van AcceleratorSelector in het samenspel met applicatie, DeviceSelector en Device. Bronnen: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

Levenscyclus

De instantiëring van AcceleratorSelector vindt vermoedelijk typisch applicatiespecifiek of via passende factory-mechanismen vóór de eerste apparaataanvraag plaats. Vraag Q-933e42753f63687c (open) De vernietiging gebeurt zodra de selectielogica voor de desbetreffende applicatiecomponent niet meer nodig is; specifieke tussentoestanden of levenscyclusfasen schrijft de specificatie niet voor.

Wat betreft de gelijktijdigheid zijn beide geboden operaties – SelectDevice() en operator() – uitdrukkelijk gespecificeerd als niet thread-safe („not thread-safe”) ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). Hoewel beide methoden als const zijn gedeclareerd, moeten parallelle aanroepen via dezelfde instantie of op dezelfde onderliggende hardwareresources door de aanroeper extern worden gesynchroniseerd.

Gebruikspad

De interactie met AcceleratorSelector vindt plaats via twee alternatieve gebruikspaden: de directe automatische selectie en de individuele kandidaatbeoordeling. Via de virtuele methode SelectDevice() vraagt de applicatie direct de selectie van een geschikt apparaat aan conform de geïmplementeerde strategie ([AP_SWS_SHWA_00413]). In geval van succes levert de aanroep een Device-instantie ingekapseld in een ara::core::Result terug.

Als alternatief maakt de overbeladen aanroep-operator operator() de stapsgewijze beoordeling van afzonderlijke bekende apparaten mogelijk ([AP_SWS_SHWA_00412]). De door operator() geretourneerde integerwaarde (int) vertegenwoordigt vermoedelijk een relatieve geschiktheidsscore, aan de hand waarvan de applicatie zelf een rangschikking of filtering kan uitvoeren. Interpretatie: SelectDevice() kapselt de volledige selectiestrategie autonoom in, terwijl operator() fijnmazige vergelijkingen van afzonderlijke apparaten mogelijk maakt. Vraag Q-e2de44ef0c9e936d (open)

Sequentiediagram: aanroepverloop bij apparaatbeoordeling en apparaatselectie. Bronnen: [AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]

Foutscenario's

Beide operaties zijn gedeclareerd als noexcept en garanderen exception safety ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). Fouten worden uitsluitend via het retourtype ara::core::Result getransporteerd. De volgende foutcodes uit het bereik ShwaErrorCode zijn gespecificeerd:

• ShwaErrorCode::kResourceBusy: de operatie kon niet worden uitgevoerd, omdat de desbetreffende resource momenteel overbelast of bezet is ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).
• ShwaErrorCode::kFeatureNotSupported: een voor de selectie of beoordeling aangevraagde eigenschap wordt niet ondersteund door het platform of het apparaat ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]).

Voor beide functies is vastgelegd dat er geen rollback-semantiek bestaat (no_rollback_semantics) ([AP_SWS_SHWA_00412], [AP_SWS_SHWA_00413]). Treedt er een fout op, dan wordt een eerdere systeem- of hardwaretoestand niet automatisch hersteld. Aanroepers moeten de foutcode van het Result-object controleren en eventueel herhaalde pogingen of alternatieve selectiepaden initiëren.