klasse ara::shwa::CpuSelector

De klasse ara::shwa::CpuSelector dient in de module shwa voor de beoordeling en gerichte selectie van hardware-apparaten conform een specifieke selectorstrategie [AP_SWS_SHWA_00410]. Applicatiesoftware kan afzonderlijke apparaatkandidaten via operator() beoordelen of via de methode SelectDevice() direct een geschikt doelapparaat bepalen [AP_SWS_SHWA_00409]. Als wezenlijke randvoorwaarden zijn de interfaces niet thread-safe gespecificeerd, bieden ze geen rollback-semantiek en dragen ze potentiële fouten zoals bezette resources uitsluitend over via ara::core::Result.

meer ›

Context

De klasse ara::shwa::CpuSelector maakt deel uit van de module voor hardwareversnelling (shwa) binnen het AUTOSAR Adaptive Platform. Deze leidt af van de basisinterface DeviceSelector en specialiseert de functionele selectie van uitvoeringsapparaten. Haar primaire verantwoordelijkheid bestaat erin hardware-apparaten (Device) aan de hand van een selectorstrategie te beoordelen of een geschikt apparaat direct te selecteren [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

In het totale systeem fungeert CpuSelector als schakel tussen aanvragende softwarecomponenten en beschikbare hardware-eenheden. Terwijl DeviceSelector de algemene interface biedt, richt CpuSelector zich als selectorstrategie vermoedelijk specifiek op CPU-gebaseerde hardwareresources, zoals de klassenaam suggereert. Vraag Q-32abbae13e272c68 (open) Applicatiesoftware integreert deze klasse om voorafgaand aan de taakoverdracht gefundeerde beslissingen over de geschiktheid van resources te nemen.

Levenscyclus

Instanties van CpuSelector worden in de applicatiecontext of door bovengeschikte beheerinstanties aangemaakt om selectiestrategieën beschikbaar te stellen. De centrale beoordelings- en selectieoperaties zijn gedeclareerd als const, waardoor de instantie zich tijdens haar gebruik naar buiten toe toestandloos gedraagt en geen interne selectietoestanden modificeert [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

Voor gelijktijdigheid geldt dat noch SelectDevice() [AP_SWS_SHWA_00410] noch operator() [AP_SWS_SHWA_00409] thread-safe zijn (not thread-safe). Aangezien de methoden als niet thread-safe zijn gespecificeerd, moeten concurrente toegangen tot dezelfde instantie van CpuSelector vermoedelijk door de aanroeper worden gesynchroniseerd. Vraag Q-fced1ce242dea2c2 (open) Aan het einde van de levenscyclus wordt de selector zonder afzonderlijke rollback-procedures ontbonden.

Gebruikspad

De typische interactie met CpuSelector omvat hetzij de individuele beoordeling van afzonderlijke kandidaten, hetzij het direct opvragen van het optimale doelapparaat. Voor de kandidaattoetsing geeft de aanroeper een apparaatreferentie door aan operator()(const Device &device) [AP_SWS_SHWA_00409]. De returnwaarde van operator() als ara::core::Result<int> vertegenwoordigt vermoedelijk een numerieke beoordelingsmetriek (score) voor het doorgegeven Device, aan de hand waarvan meerdere apparaten kunnen worden vergeleken. Vraag Q-33885b34ba761592 (open)

Wanneer de applicatie de selectie volledig aan de strategie wil overlaten, roept deze SelectDevice() aan [AP_SWS_SHWA_00410]. Deze methode bepaalt intern het geschikte apparaat en retourneert een ara::core::Result<Device> die het geselecteerde doelapparaat inkapselt.

Sequentiediagram: typisch verloop voor de beoordeling en selectie van een doelapparaat via CpuSelector. Bronnen: [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

Foutscenario's

Beide methoden zijn gedeclareerd met noexcept en garanderen volledige uitzonderingsveiligheid (exception safe) [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410]. Optredende foutcondities worden niet gemeld via C++-exceptions, maar geretourneerd via het foutdomein in ara::core::Result.

De volgende foutwaarden uit ShwaErrorCode zijn voor beide methoden gespecificeerd:

• ShwaErrorCode::kResourceBusy: de evaluatie of selectie kon niet worden uitgevoerd, omdat de geadresseerde resource momenteel overbelast is [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].
• ShwaErrorCode::kFeatureNotSupported: een aangevraagde apparaateigenschap of selectorfunctie wordt niet ondersteund door het systeem [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].

Als preconditie voor operator() moet een geldige Device-referentie beschikbaar zijn. Beide functies zien af van rollback-semantiek (no_rollback_semantics), waardoor in geval van fouten geen automatische opschoning van eerdere systeemtoestanden plaatsvindt [AP_SWS_SHWA_00409], [AP_SWS_SHWA_00410].