BSW Mode Manager (BswM)

De functie BswM_BswMPartitionRestarted dient om de BswM-module te informeren over de herstart van de partitie waarin de BswM wordt uitgevoerd [SWS_BswM_00193].

Gebruik en semantiek

De aanroep vindt synchroon plaats door de restart-taak van het besturingssysteem zodra de partitie na een herstart is hersteld [SWS_BswM_00193]. De functie heeft het service-ID 0x1e en is gedeclareerd via het headerbestand BswM.h [SWS_BswM_00193]. Deze accepteert geen overdrachtsparameters (noch invoer- noch uitvoerparameters) en heeft geen retourwaarde (void) [SWS_BswM_00193].

Gelijktijdigheid en uitvoering

Volgens de specificatie is BswM_BswMPartitionRestarted geclassificeerd als reentrant [SWS_BswM_00193]. Dit maakt de aanroep in de context van de restart-taak mogelijk, waarbij de aanroeper moet waarborgen dat de herstart van de betreffende partitie voorafgaand aan de aanroep correct is geïnitieerd.

Foutafhandeling en wisselwerking

De specificatie definieert voor deze service geen specifieke retourwaarden of DET-/DEM-foutcodes [SWS_BswM_00193]. De interactie beperkt zich tot de OS-restart-taak, die deze notificatie triggert zodat de BswM kan reageren op de herstarte partitie [SWS_BswM_00193].

Gebruik en signatuur

De functie BswM_CanSM_CurrentState wordt aangeroepen door de CAN State Manager (CanSM) om de actuele toestand van een CAN-kanaal aan de BSW Mode Manager (BswM) te melden [SWS_BswM_00049]. Deze heeft de service-ID 0x05 en wordt beschikbaar gesteld via het headerbestand BswM_CanSM.h [SWS_BswM_00049].

De aanroep geschiedt synchroon en levert geen retourwaarde (void) op [SWS_BswM_00049]. De interface verwerkt twee ingangsparameters [SWS_BswM_00049]:

• Network (type NetworkHandleType): Duidt het betreffende CAN-kanaal aan waarop de gemelde toestandswijziging betrekking heeft [SWS_BswM_00049].
• CurrentState (type CanSM_BswMCurrentStateType): Geeft de nieuw aangenomen toestand van het desbetreffende CAN-kanaal door [SWS_BswM_00049].

Noch uitgangs- noch in-/uitgangsparameters zijn voorzien voor deze servicefunctie [SWS_BswM_00049].

Gelijktijdigheid en beperkingen

De specificatie merkt BswM_CanSM_CurrentState aan als re-entrant [SWS_BswM_00049]. Deze kan zodoende bij parallelle gebeurtenissen van meerdere netwerkkanalen gelijktijdig worden aangeroepen. Aangezien de aanroep synchroon plaatsvindt en er geen specifieke task-beperkingen zijn voorgeschreven, zal de aanroepcontext vermoedelijk overeenkomen met de uitvoeringscontext van de aanroepende CanSM [SWS_BswM_00049]. Vraag Q-0edc8b6c1cb10f6d (open)

Foutafhandeling en wisselwerking

In de specificatie zijn geen specifieke foutcodes, retourwaarden of notificaties aan DET of DEM voor deze functieaanroep gedocumenteerd [SWS_BswM_00049]. De functie dient als gedefinieerde meldingsinterface in het samenspel tussen CanSM en BswM, via welke de actuele kanaaltoestand instroomt in het modusbeheer van de BswM [SWS_BswM_00049].

De functie BswM_ComM_CurrentMode dient in de AUTOSAR Classic-module BswM (Basic Software Mode Manager) als gestandaardiseerde notificatie-interface voor de Communication Manager (ComM) [SWS_BswM_00047]. Deze wordt aangeroepen door ComM om de actuele communicatiemodus van een bepaald communicatiekanaal aan de BswM te melden [SWS_BswM_00047]. De declaratie van deze interface wordt beschikbaar gesteld via het headerbestand BswM_ComM.h, en aan de service is de hexadecimale service-ID 0x0e toegewezen [SWS_BswM_00047].

De functiesignatuur luidt void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode) en vereist twee onveranderlijke invoerparameters [SWS_BswM_00047]:

• Network (datatype NetworkHandleType): Duidt het concrete ComM-communicatiekanaal aan waarvoor de status wordt gemeld en waarmee de toestand overeenkomt [SWS_BswM_00047].
• RequestedMode (datatype ComM_ModeType): Geeft de actuele toestand respectievelijk modus van het opgegeven ComM-communicatiekanaal door aan de BswM-module [SWS_BswM_00047].

De interface heeft geen retourwaarde (void); evenzo zijn in de specificatie noch uitgangsparameters (out) noch gecombineerde in-/uitgangsparameters (inout) gedefinieerd [SWS_BswM_00047]. Het uitvoeringsgedrag van de functie is vastgelegd als synchroon (Synchronous) [SWS_BswM_00047]. Met betrekking tot de gelijktijdigheid en de simultane aanroepcontext is BswM_ComM_CurrentMode geclassificeerd als re-entrant (Reentrant) [SWS_BswM_00047].

Wat betreft de foutafhandeling zijn voor deze functie in de elementspecificatie geen specifieke foutcodes, retourwaarden of foutmeldingen aan DET of DEM voorzien [SWS_BswM_00047]. Ook verdere volgordevoorwaarden of afhankelijkheden met betrekking tot gerelateerde eisen zijn niet vastgelegd [SWS_BswM_00047].

De functie BswM_ComM_CurrentPNCMode dient als notificatie-interface tussen de Communication Manager en de BSW Mode Manager. Volgens [SWS_BswM_00148] wordt deze aangeroepen door de ComM om de actuele modus van een Partial Network Cluster (PNC) door te geven aan de BswM.

Gebruik en aanroepcontext

De interface is beschikbaar via het headerbestand BswM_ComM.h en heeft het service-ID 0x15 ([SWS_BswM_00148]). De aanroep wordt synchroon uitgevoerd en levert geen retourwaarde op (void). Er worden uitsluitend twee invoerparameters doorgegeven:

• PNC (type PNCHandleType): De handle van de betreffende Partial Network Cluster waarvan de toestand wordt gerapporteerd.
• CurrentPncMode (type ComM_PncModeType): De momenteel aangenomen modus van de opgegeven PNC.

Aanvullende in- of uitgangsparameters zijn volgens [SWS_BswM_00148] niet voorzien.

Gelijktijdigheid en beperkingen

Wat betreft concurrency is BswM_ComM_CurrentPNCMode volgens [SWS_BswM_00148] gespecificeerd als reentrant, waardoor gelijktijdige aanroepen vanuit de ComM zijn toegestaan. Specifieke foutcodes of mechanismen voor foutafhandeling via DET of DEM zijn niet gedefinieerd in de payload. De overgedragen toestanden dienen in de BswM intern vermoedelijk als triggers voor regelevaluaties en acties (interpretatie: de payload bewijst de modusindicatie, maar specificeert geen interne BswM-acties). Vraag Q-2527fc2eda881b62 (open)

De functie BswM_ComM_InitiateReset wordt aangeroepen door de Communication Manager (ComM) om een aanstaande shutdown aan de BswM te signaleren [SWS_BswM_00217].

Interface en aanroepsemantiek

De interface heeft de signatuur void BswM_ComM_InitiateReset(void) en is gedeclareerd via het headerbestand BswM_ComM.h [SWS_BswM_00217]. Deze verwerkt noch invoer-, uitvoer- noch in-/uitvoerparameters en heeft geen retourwaarde [SWS_BswM_00217]. De aanroep wordt synchroon afgehandeld en is gespecificeerd met service-ID 0x22 [SWS_BswM_00217].

Gelijktijdigheid en beperkingen

De functie is gedefinieerd als niet-reentrant (Non Reentrant) [SWS_BswM_00217]. De oproeper moet daarom waarborgen dat aanroepen sequentieel plaatsvinden en dat er geen parallelle of overlappende uitvoeringen optreden. Aangezien de afhandeling synchroon plaatsvindt, blokkeert de aanroep de uitvoerende context tot de voltooiing van de verwerking in de BswM.

Foutafhandeling en wisselwerking

In de specificaties zijn voor deze service geen specifieke foutcodes, retourwaarden of foutmeldingen aan DET of DEM voorzien [SWS_BswM_00217]. Het samenspel beperkt zich volgens de specificatie tot het ontvangen van de shutdown-signalering van de ComM [SWS_BswM_00217]; Interpretatie: De melding dient in de BswM vermoedelijk als trigger voor geconfigureerde acties voor het uitvoeren van het uitschakelen of de reset. Vraag Q-adf160d8d0fe2c97 (open)

Gebruik en aanroepcontext

De functie BswM_Dcm_ApplicationUpdated wordt volgens [SWS_BswM_00158] aangeroepen door de Diagnostic Communication Manager (DCM) om de succesvolle update van een applicatie aan de BswM te melden. De service is gedeclareerd in het headerbestand BswM_Dcm.h en heeft het service-ID 0x14. De interface verwacht geen overdrachtsparameters (void) en retourneert geen waarde aan de aanroeper.

Synchroniciteit en gelijktijdigheid

Volgens [SWS_BswM_00158] is de functie gespecificeerd als synchroon en reentrant. De aanroeper blijft dus in de uitvoeringscontext van de DCM totdat de directe verwerking van de aanroep binnen de BswM is voltooid. De gedeclareerde eigenschap van reentrantie maakt het in principe mogelijk om de interface gelijktijdig vanuit verschillende taakcontexten aan te spreken.

Foutafhandeling en wisselwerking

Voor BswM_Dcm_ApplicationUpdated zijn in [SWS_BswM_00158] noch specifieke foutcodes noch notificaties aan de DET of DEM voorzien. De aanroep dient uitsluitend voor statusmelding aan het BSW-modusbeheer. De notificatie zal in de BswM vermoedelijk dienen als indicator en trigger voor de herbeoordeling van interne regels en daaropvolgende moduswisselingen om het totale systeem aan te passen aan de gewijzigde applicatiesoftware. Vraag Q-119282a4a72622b5 (open)

Gebruik

De functie BswM_Dcm_CommunicationMode_CurrentState wordt aangeroepen door de module Diagnostic Communication Manager (DCM) om de Basic Software Mode Manager (BswM) op de hoogte te stellen van de actuele toestand van de communicatiemodus [SWS_BswM_00048]. De declaratie van deze interface wordt via het headerbestand BswM_Dcm.h beschikbaar gesteld [SWS_BswM_00048].

De C-syntaxis van de functie luidt void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode) [SWS_BswM_00048]. Bij het aanroepen door de DCM worden twee ingangsparameters meegegeven [SWS_BswM_00048]:

• Network (type NetworkHandleType): Duidt het communicatiekanaal aan waarop de diagnosemodus betrekking heeft [SWS_BswM_00048].
• RequestedMode (type Dcm_CommunicationModeType): Draagt de aangevraagde diagnose-communicatiemodus over aan de BswM [SWS_BswM_00048].

De interface heeft geen retourwaarde (retourtype void) en gebruikt noch modificerende in-/uitgangsparameters (Inout) noch uitgangsparameters (Out) [SWS_BswM_00048].

Gelijktijdigheid en eigenschappen

De functieaanroep wordt synchroon uitgevoerd en is gespecificeerd als re-entrant [SWS_BswM_00048]. De servicenaam is gedefinieerd als BswM_Dcm_CommunicationMode_CurrentState en bezit de Service-ID 0x06 in hexadecimale weergave [SWS_BswM_00048].

Samenspel

Interpretatie: De BswM gebruikt de overgedragen status van de communicatiemodus vermoedelijk als criterium voor de evaluatie van modusregels om navolgende acties in de BswM te initiëren [SWS_BswM_00048]. Vraag Q-1031b1a7ae000c2a (open)

Gebruik en semantiek

De functie BswM_Deinit dient voor de deïnitialisatie van de BSW Mode Manager ([SWS_BswM_00119]). De uitvoering vindt synchroon plaats zonder overdrachtsparameters en zonder retourwaarde met het service-ID 0x04 ([SWS_BswM_00119]). De declaratie is beschikbaar via het headerbestand BswM.h ([SWS_BswM_00119]).

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-reentrant (Non Reentrant) ([SWS_BswM_00119]). Een concurrerende of onderbrekende aanroep vanuit meerdere taakcontexten is daarom niet toegestaan. Interpretatie: De deïnitialisatie zal typisch sequentieel tijdens de uitschakelfase van de ECU plaatsvinden door een overkoepelend toestandsbeheer zoals de ECU State Manager. Vraag Q-0a5d218bfe9fed04 (open)

Interactie en gedrag na deïnitialisatie

Na de aanroep van BswM_Deinit voert de BswM-module geen enkele modusverwerking meer uit ([SWS_BswM_00120]). Deze blokkering blijft zelfs van kracht wanneer er externe of interne modusverzoeken aan de module worden gericht of wanneer de cyclische hoofdfunctie van de BswM nog steeds wordt uitgevoerd resp. aangeroepen ([SWS_BswM_00120]).

De synchrone servicefunctie BswM_EcuM_CurrentState wordt aangeroepen door de module EcuM om aan de BswM de actuele ECU-bedrijfsmodus te signaleren [SWS_BswM_91003]. De interface bezit de Service-ID 0x28 en wordt via het headerbestand BswM_EcuM.h ter beschikking gesteld [SWS_BswM_91003].

Gebruik

Bij het aanroepen van de functie wordt de gewenste toestand van de ECU synchroon meegedeeld aan de BswM [SWS_BswM_91003]. De doorgifte vindt plaats via één enkele ingangsparameter:

• Current State (in): Geeft de aangevraagde ECU-bedrijfsmodus door met gebruikmaking van het datatype EcuM_StateType [SWS_BswM_91003].

De functie definieert noch in-/uitgangsparameters (inout) noch uitgangsparameters (out) en bezit geen retourwaarde (void) [SWS_BswM_91003].

Gelijktijdigheid en beperkingen

Wat betreft het concurrency-gedrag is BswM_EcuM_CurrentState gespecificeerd als re-entrant [SWS_BswM_91003]. Aanroepen kunnen zodoende zonder beperking gelijktijdig plaatsvinden, bijvoorbeeld wanneer verschillende uitvoeringspaden van de aanroeper actief zijn [SWS_BswM_91003].

Specifieke foutcodes, notificaties aan de DET- of DEM-module en afzonderlijke foutafhandelingsmechanismen zijn in de specificatieomvang voor deze service niet opgenomen [SWS_BswM_91003].

De functie BswM_EcuM_CurrentWakeup dient als interface van de BswM die door de module EcuM wordt aangeroepen om de actuele toestand van een of meer wekbronnen te melden [SWS_BswM_00131]. De declaratie is beschikbaar via het headerbestand BswM_EcuM.h [SWS_BswM_00131].

Bij de aanroep van de functie worden de volgende overdrachtsparameters doorgegeven [SWS_BswM_00131]:

• source (type EcuM_WakeupSourceType): Duidt de wekbron of wekbronnen aan waarvan de toestand is gewijzigd [SWS_BswM_00131].
• state (type EcuM_WakeupStatusType): Geeft de nieuwe toestand van de betrokken wekbron(nen) aan [SWS_BswM_00131].

De functie heeft geen retourwaarde (void) en voert geen in-/uitgangs- of zuivere uitgangsparameters [SWS_BswM_00131]. De bijbehorende Service-ID luidt 0x10 [SWS_BswM_00131].

Wat betreft het uitvoeringsgedrag is de functieaanroep gespecificeerd als synchroon [SWS_BswM_00131]. Bovendien is de functie geclassificeerd als re-entrant, waardoor deze desgewenst gelijktijdig vanuit verschillende contexten kan worden aangeroepen [SWS_BswM_00131].

Gebruik en semantiek

De functie BswM_EcuM_RequestedState dient als notificatie-interface die wordt aangeroepen door de regeleenheidstoestandsmanager (EcuM) om de module BswM te informeren over de actuele status van het Run Request Protocol [SWS_BswM_91004]. De aanroep vindt synchroon plaats en is gespecificeerd als re-entrant, zodat de functie in concurrente contexten kan worden uitgevoerd [SWS_BswM_91004]. De declaratie wordt via het headerbestand BswM_EcuM.h met de Service-ID 0x29 beschikbaar gesteld [SWS_BswM_91004].

Parameters en retourwaarde

De interface heeft geen retourwaarde (retourtype void) en verwacht twee zuivere ingangsparameters [SWS_BswM_91004]:

• State (type EcuM_StateType): Geeft de door de EcuM aangevraagde toestand aan [SWS_BswM_91004].
• CurrentState (type EcuM_RunStatusType): Verzendt het resultaat respectievelijk de actuele status van het Run Request Protocol [SWS_BswM_91004].

In-/uitgangsparameters of uitgangsparameters zijn voor deze functie niet voorzien [SWS_BswM_91004].

Interactie en integratie

De functie wordt uitsluitend aangeroepen door EcuM. Interpretatie: De overgedragen toestanden dienen in de BswM vermoedelijk voor interne regelevaluatie en modussturing om overkoepelende acties van de basissoftware in gang te zetten [SWS_BswM_91004]. Vraag Q-6cd81e44c9e2920a (open) Voor deze service zijn in de specificatie geen specifieke foutcodes voor DET of DEM vastgelegd [SWS_BswM_91004].

Gebruik

De functie BswM_EthIf_PortGroupLinkStateChg wordt conform [SWS_BswM_91001] aangeroepen door de module EthIf om aan de BswM een wijziging van de verbindingsstatus (link state) van een Ethernet-switch-poortgroep te melden. De interface heeft service-ID 0x26 en wordt via het headerbestand BswM_EthIf.h beschikbaar gesteld [SWS_BswM_91001].

De aanroep geeft twee ingangsparameters mee:

• PortGroupIdx: Duidt de index van de desbetreffende poortgroep aan in de context van de Ethernet-interface [SWS_BswM_91001].
• PortGroupState: Geeft de status van de poortgroep aan, die wordt afgeleid van de fysieke link van de Ethernet-transceiver. Geldige toestanden zijn ETHTRCV_LINK_STATE_DOWN voor een verbroken link en ETHTRCV_LINK_STATE_ACTIVE voor een actieve link [SWS_BswM_91001].

De functie heeft noch in-/uitgangsparameters noch uitgangsparameters en retourneert geen waarde (void) [SWS_BswM_91001].

Gelijktijdigheid en beperkingen

De uitvoering vindt synchroon plaats en is gespecificeerd als reentrant [SWS_BswM_91001]. Specifieke retourwaarden, foutcodes of foutmeldingen (DET/DEM) zijn voor deze interface niet gedefinieerd [SWS_BswM_91001].

Samenspel

Interpretatie: De BswM gebruikt de doorgegeven linkstatus vermoedelijk als ingangsgrootheid om toestandafhankelijke regels te evalueren en downstream acties of moduswissels binnen de BSW te activeren. Vraag Q-14285579acb760d5 (open)

De functie BswM_EthSM_CurrentState dient als callback- en notificatie-interface van de BSW Mode Manager. Deze wordt conform [SWS_BswM_00050] aangeroepen door de Ethernet State Manager (EthSM) om de actuele toestand van een communicatiekanaal door te geven aan de BswM. De declaratie van de interface wordt beschikbaar gesteld via de header BswM_EthSM.h en heeft de service-ID 0x0d.

Voor het gebruik en de aanroep gelden volgens [SWS_BswM_00050] de volgende bepalingen:

• Aanroepsemantiek: De uitvoering geschiedt synchroon. De aanroeper wacht zodoende totdat de functie de verwerking van de statusmelding heeft voltooid.
• Gelijktijdigheid: De service is gespecificeerd als re-entrant [SWS_BswM_00050]. Aanroepen kunnen zodoende voor verschillende netwerkinstanties of gelijktijdig vanuit de context van de module EthSM plaatsvinden.
• Overdrachtsparameters: Overgedragen worden het betreffende Ethernet-netwerk als Network van het type NetworkHandleType evenals de gemelde status als CurrentState van het type EthSM_NetworkModeStateType. In- en uitgangsparameters (inout/out) zijn niet voorzien; de retourwaarde is void.

In de elementspecificatie [SWS_BswM_00050] zijn noch specifieke retourwaarden noch foutmeldingen aan DET of DEM gedefinieerd. Interpretatie: De module BswM zal de gemelde netwerktoestand vermoedelijk intern opslaan en gebruiken als voorwaarde voor de evaluatie van geconfigureerde regels en voor het initiëren van moduswissels. Vraag Q-407156ff74cbab6f (open)

Gebruik en aanroepcontext

De functie BswM_FrSM_CurrentState dient als callback- respectievelijk notificatie-interface van de BswM, die door de FlexRay State Manager (FrSM) wordt aangeroepen om de actuele toestand van een FlexRay-cluster te melden [SWS_BswM_00051]. De functiedeclaratie wordt beschikbaar gesteld via het headerbestand BswM_FrSM.h [SWS_BswM_00051]. De aanroep geschiedt synchroon en levert geen retourwaarde (void) op [SWS_BswM_00051].

De interface definieert twee ingangsparameters [SWS_BswM_00051]:

• Network (type NetworkHandleType): Geeft het desbetreffende FlexRay-cluster aan waarop de toestandsmelding betrekking heeft [SWS_BswM_00051].
• CurrentState (type FrSM_BswM_StateType): Geeft de actuele toestand van het betreffende FlexRay-cluster door aan de BswM [SWS_BswM_00051].

Uitgangs- (out) of in-/uitgangsparameters (inout) zijn niet aanwezig voor deze functie [SWS_BswM_00051].

Gelijktijdigheid en foutafhandeling

De functie is gespecificeerd met de service-ID 0x0c en gekenmerkt als re-entrant [SWS_BswM_00051]. Specifieke foutcodes, gedrag bij fouten of notificaties aan het ontwikkelingsfout- (DET) of diagnose-event-management (DEM) zijn in de specificatie niet aangewezen voor deze service [SWS_BswM_00051].

De synchrone functie BswM_Init dient voor de initialisatie van de Basic Software Mode Manager (BswM) conform de specificatie [SWS_BswM_00002]. Deze is gedeclareerd via het headerbestand BswM.h en heeft de Service-ID 0x00 [SWS_BswM_00002].

Parameters en retourwaarden

Aan de functie wordt via de enige ingangsparameter ConfigPtr een pointer naar de post-build-configuratiedata van het type BswM_ConfigType meegegeven [SWS_BswM_00002]. Er bestaan geen uit- of in-/uitgangsparameters en er wordt geen retourwaarde geretourneerd [SWS_BswM_00002].

Gelijktijdigheid en uitvoeringscontext

De uitvoering vindt synchroon plaats. Het modulegedrag wat betreft re-entrantie is gespecificeerd als voorwaardelijk re-entrant (Conditionally Reentrant) [SWS_BswM_00002]. Ter interpretatie betekent dit waarschijnlijk dat gelijktijdige aanroepen alleen onder speciale systeemvoorwaarden, zoals gescheiden datagebieden, toegestaan zijn. Vraag Q-c0063b2a12eb4f41 (open) Bovendien vindt de aanroep vermoedelijk typisch plaats in het kader van de systeeminitialisatie, voordat overige operaties van de BswM worden uitgevoerd.

De synchrone servicefunctie BswM_J1939DcmBroadcastStatus (service-ID 0x1b) verzendt de gewenste communicatiestatus van de beschikbare netwerken naar de BSW Mode Manager [SWS_BswM_00165]. De gemelde status wordt in het systeem typisch geactiveerd via het schakelen van COM-I-PDU-groepen (COM I-PDU group switches) [SWS_BswM_00165]. De interface wordt ter beschikking gesteld via de header BswM_J1939Dcm.h [SWS_BswM_00165].

De parameters en de semantiek zijn als volgt gespecificeerd [SWS_BswM_00165]:

• Overdrachtsparameter: Via de parameter NetworkMask wordt een bitmasker doorgegeven dat één bit per beschikbaar netwerk bevat. De respectieve bitpositie komt daarbij overeen met de communicatiekanaal-identifier ComMChannel.ComMChannelId, zodat kanaal-ID 0 wordt afgebeeld op bit 0.
• Bitbetekenis: De waarde 1 geeft aan dat het netwerk is geactiveerd (Network enabled), terwijl 0 een gedeactiveerd netwerk aangeeft (Network disabled).
• Retourwaarde: De functie heeft geen retourwaarde (void).

Concurrency en beperkingen: De aanroep is ontworpen als reentrant en werkt synchroon [SWS_BswM_00165]. Omdat de parameter NetworkMask gedefinieerd is als een 16-bitwaarde, kunnen via deze API ontwerpmatig uitsluitend de eerste 16 communicatiekanaal-ID's worden aangesproken [SWS_BswM_00165]. Specifieke foutcodes evenals DET- of DEM-meldingen zijn voor deze functie niet gespecificeerd [SWS_BswM_00165].

Gebruik

De functie BswM_J1939Nm_StateChangeNotification dient voor de synchrone notificatie van de BSW Mode Manager over de actuele toestand van een J1939-netwerkknooppunt na een opgetreden toestandswijziging [SWS_BswM_00194]. De declaratie is beschikbaar via het headerbestand BswM_J1939Nm.h en is geregistreerd onder het service-ID 0x18 [SWS_BswM_00194].

De interface verwacht drie invoerparameters en levert geen retourwaarde (void) op [SWS_BswM_00194]:

• Network (NetworkHandleType): Identificeert het betreffende J1939-kanaal [SWS_BswM_00194].
• Node (uint8): Numerieke identificatie van het betreffende J1939-knooppunt [SWS_BswM_00194].
• NmState (Nm_StateType): Representeert de actuele respectievelijk nieuw aangenomen toestand van het knooppunt [SWS_BswM_00194].

Gelijktijdigheid en aanroepcontext

De verwerking vindt synchroon plaats en is gespecificeerd als reentrant [SWS_BswM_00194]. Daarom mag de notificatie in systemen met meerdere knooppunten of kanalen ook gelijktijdig plaatsvinden. De aanroeper zal de module J1939Nm zijn, die de BswM na interne toestandsovergangen op de hoogte stelt van de nieuwe status. Vraag Q-9c0e521db5e51713 (open)

Foutafhandeling

De specificatie definieert voor deze service noch specifieke foutcodes noch notificaties aan DET of DEM [SWS_BswM_00194]. Bovendien bestaan er noch uitgangsparameters noch in-/uitgangsparameters voor foutindicatie [SWS_BswM_00194].

De functie BswM_LinSM_CurrentSchedule dient als notificatie-interface die door de LIN State Manager (Lin SM) wordt aangeroepen om aan de BswM de momenteel actieve Schedule Table voor een bepaald LIN-kanaal te melden ([SWS_BswM_00058]). De service is beschikbaar via de header BswM_LinSM.h en heeft het service-ID 0x0a ([SWS_BswM_00058]).

Bij de aanroep worden twee invoerparameters doorgegeven ([SWS_BswM_00058]):

• Network (type NetworkHandleType): Duidt het concrete LIN-kanaal aan waarop de wisseling van de Schedule Table heeft plaatsgevonden ([SWS_BswM_00058]).
• Current Schedule (type LinIf_SchHandleType): Geeft de identifier door van de op dit LIN-kanaal nu actieve Schedule Table ([SWS_BswM_00058]).

De interface heeft noch in-/uitgangs- noch uitgangsparameters en levert geen retourwaarde op (void) ([SWS_BswM_00058]). Het uitvoeringsgedrag is gedefinieerd als synchroon (Synchronous) en de functie is gespecificeerd als reentrant (Reentrant) ([SWS_BswM_00058]).

Specifieke foutcodes, foutreacties of meldingen aan DET of DEM zijn voor deze service niet vermeld in de specificatie ([SWS_BswM_00058]). Interpretatie: De aanroep zal normaliter direct na een voltooide tabelwissel in de Lin SM plaatsvinden om de toestandsevaluatie in de BswM synchroon te informeren over de wissel. Vraag Q-302196d84e739258 (open)

Gebruik en aanroepcontext

De synchrone functie BswM_LinSM_CurrentState wordt aangeroepen door de LIN State Manager (LinSM) om een toestandswijziging van een LIN-kanaal mee te delen aan de BswM [SWS_BswM_00052]. Deze is gedefinieerd in de module BswM, heeft de service-ID 0x09 en wordt via het headerbestand BswM_LinSM.h gedeclareerd voor de LinSM [SWS_BswM_00052].

Parameters en retourwaarden

De interface heeft geen retourwaarde (void) en noch in-/uitgangs- noch uitgangsparameters [SWS_BswM_00052]. Voor de signalering worden twee ingangsparameters doorgegeven:

• Network (type NetworkHandleType): Geeft het LIN-kanaal aan waarop de gemelde toestandsaanduiding betrekking heeft [SWS_BswM_00052].
• CurrentState (type LinSM_ModeType): Bevat de actueel aangenomen toestand van het opgegeven LIN-kanaal [SWS_BswM_00052].

Gelijktijdigheid en module-integratie

De functie is volgens de specificatie uitgevoerd als re-entrant [SWS_BswM_00052]. Dit maakt de parallelle aanroep voor verschillende LIN-netwerken zonder wederzijdse blokkade mogelijk. Interpretatie: De overgedragen kanaaltoestand zal in de BswM vermoedelijk worden gebruikt als invoervariabele voor regelevaluaties en actielijsten om daarop gebaseerde modusovergangen in de totale ECU te sturen. Vraag Q-ca113e4b71e4ab75 (open)

Gebruik en aanroepcontext

De synchrone functie BswM_LinTp_RequestMode wordt aangeroepen door de Lin TP om voor een bepaald LIN-kanaal een moduswissel aan te vragen [SWS_BswM_00156]. De declaratie vindt plaats via de header BswM_LinTp.h met het service-ID 0x0b [SWS_BswM_00156]. Als invoerparameters worden doorgegeven:

• Network (type NetworkHandleType): Duidt het betreffende LIN-kanaal aan waarop het modusverzoek betrekking heeft [SWS_BswM_00156].
• LinTp_Mode (doorgegeven als LinTp_Mode Lin Tp RequestedMode): Bepaalt de aangevraagde TP-modus, die direct correleert met de te gebruiken LIN-schedule-tabel [SWS_BswM_00156].

De functie heeft geen retourwaarde (void) [SWS_BswM_00156]. Specifieke foutcodes, retourwaarden voor foutafhandeling of DET-meldingen zijn in de functiedefinitie niet voorzien [SWS_BswM_00156].

Concurrency en modusbeheer

De interface is gespecificeerd als reentrant [SWS_BswM_00156]. Dit staat een parallelle aanroep toe vanuit verschillende contexten of voor afzonderlijke LIN-kanalen. Omdat de gevraagde modus de selectie van de schedule-tabel beïnvloedt, dient de functie als modusspecifieke interface tussen Lin TP en de BSW Mode Manager [SWS_BswM_00156]. Interpretatie: Op basis van het verzoek zal de BswM vermoedelijk interne evaluaties uitvoeren om de wissel van de LIN-schedule-tabel in gang te zetten. Vraag Q-544460b6b32b6ac2 (open)

Gebruik en aanroepcontext

De functie BswM_Nm_CarWakeUpIndication dient als callback-interface van de Basic Software Mode Manager (BswM) en wordt aangeroepen door het Network Management (Nm) om een kanaalgerelateerde car-wakeup-gebeurtenis te melden [SWS_BswM_00235].\n De aanroep vindt synchroon plaats en draagt via de ingangsparameter Network van het type NetworkHandleType de identificatie van het betrokken Nm-kanaal over [SWS_BswM_00235].\n De interface declareert geen retourwaarde (void) en stelt geen uitgangsparameters beschikbaar [SWS_BswM_00235].\n De service is gedefinieerd met service-ID 0x24 in het headerbestand BswM_Nm.h [SWS_BswM_00235].

Gelijktijdigheid en foutafhandeling

De interface is gespecificeerd als reentrant, waardoor parallelle aanroepen zijn toegestaan [SWS_BswM_00235].\n Specifieke foutcodes, meldingen aan de DET of DEM en bijzondere foutafhandelingsmechanismen zijn in de elementspecificatie niet vermeld [SWS_BswM_00235].

Samenspel

Als integratiepunt tussen het Nm en de BswM geeft de functie het weksignaal direct door aan de BswM-verwerking [SWS_BswM_00235].\n Interpretatie: De aanroep wordt binnen de BswM vermoedelijk geëvalueerd als indicator voor regelcontroles of moduswissels in het kader van het opstarten van het netwerk. Vraag Q-e56d5cfb6345f1ba (open)

Gebruik en aanroepcontext

De functie BswM_Nm_StateChangeNotification dient als notificatie-interface om de actuele toestand van een netwerkmanagementkanaal na opgetreden statuswijzigingen aan de BswM door te geven [SWS_BswM_91002]. Deze is gedeclareerd in het headerbestand BswM_Nm.h en gedefinieerd onder service-ID 0x27 [SWS_BswM_91002]. De uitvoering geschiedt synchroon en de functie heeft geen retourwaarde (void) [SWS_BswM_91002].

De overdracht van de toestandsgegevens vindt plaats via twee zuivere ingangsparameters; in-/uitgangs- of uitgangsparameters bestaan niet [SWS_BswM_91002]:

• Network (type: NetworkHandleType): Duidt het betrokken Nm-kanaal aan ter identificatie van het netwerk [SWS_BswM_91002].
• currentState (type: Nm_StateType): Signaleert de actuele respectievelijk nieuwe toestand van het opgegeven Nm-kanaal [SWS_BswM_91002].

Gelijktijdigheid en gedrag

De interface is geclassificeerd als reentrant [SWS_BswM_91002]. Daarmee kan de functie gelijktijdig worden aangeroepen, wat met name relevant is bij gelijktijdige statusovergangen op verschillende netwerkkanalen. Aangezien de aanroep als synchroon is gespecificeerd, keert de functie pas na de interne ontvangst van de statuswijziging terug naar de oproeper [SWS_BswM_91002]. De aanroep zal typisch door het netwerkmanagement worden uitgevoerd zodra een kanaal een nieuwe toestand heeft aangenomen [SWS_BswM_91002]. Vraag Q-8645d9511a825fed (open)

Gebruik

De functie BswM_NvM_CurrentBlockMode wordt door de NVRAM Manager (NvM) aangeroepen om aan de Basic Software Mode Manager (BswM) de actuele blokmodus van een NVRAM-blok te melden [SWS_BswM_00104]. De declaratie van de functie is beschikbaar via het headerbestand BswM_NvM.h en in de specificatie toegewezen aan service-ID 0x16 [SWS_BswM_00104].

Parameters en retourwaarden

De functie levert geen retourwaarde (void) terug aan de aanroeper en verwerkt twee invoerparameters [SWS_BswM_00104]:

• Block (type NvM_BlockIdType): Geeft de blok-identifier door van het NVRAM-blok waarop de nieuwe modusinformatie betrekking heeft [SWS_BswM_00104].
• CurrentBlockMode (type NvM_RequestResultType): Draagt de actuele blokmodus respectievelijk het verzoekresultaat van het NvM-blok over [SWS_BswM_00104].

Uitgangsparameters of gecombineerde in-/uitgangsparameters zijn voor deze interface niet gedefinieerd [SWS_BswM_00104].

Gelijktijdigheid en beperkingen

De functieaanroep van BswM_NvM_CurrentBlockMode wordt synchroon uitgevoerd en is gespecificeerd als reentrant [SWS_BswM_00104]. Daarmee is de interface ontworpen voor reentrant gebruik in gelijktijdige uitvoeringscontexten [SWS_BswM_00104].

Foutafhandeling

Voor deze interface zijn in de specificatievoorschriften noch specifieke foutcodes noch eisen voor foutmeldingen via de Default Error Tracer (DET) of de Diagnostic Event Manager (DEM) module vermeld [SWS_BswM_00104].

Gebruik en signatuur

De functie BswM_NvM_CurrentJobMode wordt aangeroepen door de NVRAM Manager (NvM) om de BSW Mode Manager (BswM) te informeren over de actuele toestand van een multiblokopdracht [SWS_BswM_00152]. De interface is gedeclareerd in de header BswM_NvM.h en heeft het service-ID 0x17 [SWS_BswM_00152]. Deze accepteert twee invoerparameters:

• MultiBlockRequest (type NvM_MultiBlockRequestType): Geeft aan op welke concrete multiblokopdracht deze callback betrekking heeft [SWS_BswM_00152].
• CurrentJobMode (type NvM_RequestResultType): Geeft de actuele status of het resultaat van de desbetreffende multiblokopdracht aan [SWS_BswM_00152].

De functie retourneert geen waarde (retourtype void) en beschikt niet over in-/uitvoer- of uitvoerparameters [SWS_BswM_00152].

Gelijktijdigheid en foutafhandeling

De specificatie definieert BswM_NvM_CurrentJobMode als synchroon en reentrant [SWS_BswM_00152]. De aanroep vindt direct plaats vanuit de uitvoeringscontext van de module NvM. Ter interpretatie: deze aanroep zal normaliter worden geactiveerd bij verzameloperaties zoals lees- of schrijfbewerkingen zodra er sprake is van een statuswijziging. Vraag Q-25514d3dbf1d8c5c (open)

Voor deze functie zijn in de specificatie noch retourwaarden noch specifieke foutcodes voor ontwikkelingsfouten (DET) of productiefouten vastgelegd; het gedrag in geval van een fout wordt niet afzonderlijk vermeld [SWS_BswM_00152].

De functie BswM_RequestMode biedt een generieke functieaanroep voor het aanvragen van modi in de Basic Software Mode Manager (BswM) [SWS_BswM_00046]. Deze is gedeclareerd via het headerbestand BswM.h en heeft de service-ID 0x02 [SWS_BswM_00046].

Gebruik en beperkingen

Het gebruik is strikt gereglementeerd: de functie mag uitsluitend worden aangeroepen door andere BSW-modules die niet over een eigen, modulespecifieke interface voor modusaanvragen beschikken [SWS_BswM_00046]. BSW-modules met speciale interfaces mogen deze generieke service derhalve niet gebruiken.

Parameters en semantiek

De functiesignatuur luidt void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode) [SWS_BswM_00046]. Er worden twee ingangsparameters doorgegeven:

• requesting_user: Identificeert de aanvragende gebruiker respectievelijk de aanvragende softwaremodule [SWS_BswM_00046].
• requested_mode: Geeft de concreet aangevraagde toestand respectievelijk modus door [SWS_BswM_00046].

Er bestaan noch in-/uitgangs- noch uitgangsparameters, en de functie heeft geen retourwaarde (void) [SWS_BswM_00046].

Concurrency

De aanroep wordt synchroon verwerkt en is gespecificeerd als re-entrant [SWS_BswM_00046]. Daarmee is de functie geschikt voor gelijktijdige aanroepen vanuit meerdere BSW-contexten.

Gebruik en aanroepcontext

De functie BswM_Sd_ClientServiceCurrentState wordt aangeroepen door de Service Discovery (SD) om de BswM synchroon te informeren over de actuele toestand van een clientservice [SWS_BswM_00204]. Via deze interface wordt gesignaleerd of de desbetreffende service operationeel (available) of niet beschikbaar (down) is [SWS_BswM_00204]. De declaratie van de C-functie wordt ter beschikking gesteld via de header BswM_Sd.h [SWS_BswM_00204].

Parameters en interfacesignatuur

De interface heeft het service-ID 0x1f en verwacht twee invoerparameters [SWS_BswM_00204]:

• SdClientServiceHandleId (type uint16): Uniek handle-ID ter identificatie van de clientservice [SWS_BswM_00204].
• CurrentClientState (type Sd_ClientServiceCurrentStateType): Actuele beschikbaarheidstoestand van de service [SWS_BswM_00204].

De functie retourneert geen retourwaarde (void) en definieert geen in-/uitvoer- of uitvoerparameters [SWS_BswM_00204].

Gelijktijdigheid en wisselwerking

De uitvoering van BswM_Sd_ClientServiceCurrentState is synchroon en reentrant [SWS_BswM_00204]. Oproepers hoeven daarom geen sequentiële serialisatie af te dwingen, maar kunnen statuswijzigingen gelijktijdig melden. In het totale samenspel wordt de statusmelding vermoedelijk gebruikt voor de interne regelevaluatie en initiatie van geconfigureerde moduswissels binnen de BswM. Vraag Q-0490a3902ca9e78d (open)

De functie BswM_Sd_ConsumedEventGroupCurrentState dient als callback-interface die door de Service Discovery wordt aangeroepen om aan de Basic Software Mode Manager (BswM) de actuele toestand van een geconsumeerde eventgroep door te geven [SWS_BswM_00207]. Deze informeert de BswM erover of de betreffende eventgroep in het netwerk beschikbaar (available) of uitgevallen (down) is [SWS_BswM_00207].

Gebruik en signatuur

De interface heeft service-ID 0x21 en wordt via het headerbestand BswM_Sd.h beschikbaar gesteld [SWS_BswM_00207]. De aanroep wordt synchroon verwerkt en heeft geen retourwaarde (void) [SWS_BswM_00207]. Bij de functieaanroep geeft de Service Discovery twee ingangsparameters mee, terwijl noch in-/uitgangs- noch zuivere uitgangsparameters zijn gedefinieerd [SWS_BswM_00207]:

• Sd Consumed Event Group Handle Id (gegevenstype uint16): Unieke handle-ID ter identificatie van de desbetreffende geconsumeerde eventgroep [SWS_BswM_00207].
• Consumed Event Group State (gegevenstype Sd_Consumed Event Group Current State Type): Actuele status van de geconsumeerde eventgroep voor weergave van de beschikbaarheid [SWS_BswM_00207].

Gelijktijdigheid en foutafhandeling

Volgens de specificatie is de functie gemarkeerd als reentrant en mag deze derhalve desgewenst gelijktijdig worden aangeroepen [SWS_BswM_00207]. Voor deze service zijn in de specificatie geen specifieke foutcodes, excepties of terugmeldingen aan de ontwikkelingsfouttracering (DET) of het diagnose-eventmanagement (DEM) opgenomen [SWS_BswM_00207].

Gebruik en aanroepcontext

De synchrone functie BswM_Sd_EventHandlerCurrentState dient als interface die door de Service Discovery wordt aangeroepen om aan de BSW Mode Manager (BswM) de actuele status van een Event Handler mee te delen [SWS_BswM_00210]. Typische toestanden van de Event Handler omvatten de informatie of deze is aangevraagd of vrijgegeven [SWS_BswM_00210]. De declaratie van de functie wordt via het headerbestand BswM_Sd.h beschikbaar gesteld [SWS_BswM_00210].

Parameters en signatuureigenschappen

De functie levert geen retourwaarde (void) en verwacht bij aanroep twee ingangsparameters [SWS_BswM_00210]:

• SdEventHandlerHandleId: Identificator van het type uint16, die de bijbehorende Event Handler uniek adresseert [SWS_BswM_00210].
• EventHandlerStatus: Statusinformatie van het type Sd_EventHandlerCurrentStateType, die de actuele toestand van de Event Handler weergeeft [SWS_BswM_00210].

Gelijktijdigheid en foutafhandeling

De functie wordt gevoerd onder service-ID 0x20 en is volgens de specificatie reentrant uitgevoerd [SWS_BswM_00210]. Specifieke foutcodes, in-/uitgangsparameters of expliciete foutmeldingen via DET of DEM zijn voor deze interface niet gedefinieerd [SWS_BswM_00210].

De functie BswM_WdgM_RequestPartitionReset wordt aangeroepen door de Watchdog Manager (WdgM) om bij de Basic Software Mode Manager (BswM) het resetten van een bepaalde partitie aan te vragen [SWS_BswM_00157]. De declaratie van deze interface wordt beschikbaar gesteld via de header BswM_WdgM.h en is toegewezen aan service-ID 0x11 [SWS_BswM_00157].

Voor het gebruik en de aanroepcontext gelden de volgende bepalingen uit de specificatie:

• Parameters: Als invoerparameter wordt Application van het type ApplicationType doorgegeven, die de unieke identifier van de betreffende OS-Application voorstelt [SWS_BswM_00157]. Andere in- of uitgangsparameters bestaan er niet voor deze aanroep [SWS_BswM_00157].
• Retourwaarde: De functie heeft geen retourwaarde (retourtype void) [SWS_BswM_00157].
• Synchroniciteit en concurrency: De functie-uitvoering vindt synchroon plaats en is gespecificeerd als reentrant, waardoor parallelle aanroepen zijn toegestaan [SWS_BswM_00157].
• Foutafhandeling: Specifieke foutcodes, foutreacties en meldingen aan DET of DEM zijn in de specificatie van dit element niet gedocumenteerd [SWS_BswM_00157].

In het samenspel van de basissoftwaremodules vormt de functie de directe notificatie-interface waarmee de WdgM de BswM synchroon op de hoogte stelt van een vereiste partitiereset voor de doorgegeven OS-Application [SWS_BswM_00157].

De functie BswM_MainFunction vormt de centrale periodieke hoofdfunctie van de BSW-modusmanager (BswM) ([SWS_BswM_00053]). Deze bezit de Service-ID 0x03, accepteert geen overdrachtsparameters en levert geen retourwaarde op (signatuur: void BswM_MainFunction(void)). De declaratie ervan wordt via het headerbestand SchM_BswM.h beschikbaar gesteld ([SWS_BswM_00053]). Vanwege de beschikbaarstelling via SchM_BswM.h vindt de aanroep in het regeleenheid vermoedelijk typisch cyclisch plaats door de Schedule Manager (SchM) in de context van een periodieke besturingssysteemtaak. Vraag Q-fdb948e42c35d9fb (open)

Wat betreft de wisselwerking en de verwerkingslogica is BswM_MainFunction verantwoordelijk voor de evaluatie van vertraagde modusverzoeken: De functie moet verplicht alle regels evalueren die ten minste één modusverzoek (Mode Request) met de configuratieparameter BswMRequestProcessing op de waarde BSWM_DEFERRED als ingang gebruiken ([SWS_BswM_00075]).

Voor de praktische inpassing en integratie in het basissoftwaresysteem vloeien hieruit de volgende randvoorwaarden voort:

• Aanroepcontext en scheduling: De functie heeft noch parameters noch retourwaarden ([SWS_BswM_00053]); zij is voorzien voor de terugkerende integratie in het cyclische schema van de basissoftwarescheduler.
• Regelverwerking: Modusverzoeken die niet direct worden verwerkt, maar zijn geconfigureerd op BSWM_DEFERRED, worden in de tijd ontkoppeld en pas in de uitvoeringscyclus van deze hoofdfunctie verzameld afgehandeld ([SWS_BswM_00075]).

Gebruik

De gebruikersgedefinieerde callout-functie wordt aangeroepen door de BSW Mode Manager zodra een bijbehorende BswMUserCallout-actie wordt uitgevoerd [SWS_BswM_00270]. De concrete functienaam evenals alle overdrachtsparameters worden vastgelegd via de configuratieparameter BswMUserCalloutFunction [SWS_BswM_00270]. De syntaxis is generiek gedefinieerd als void <BswMUserCalloutFunction>(implementation_specific), waarbij eventuele retourwaarden door de BswM volledig worden genegeerd [SWS_BswM_00270].

Gelijktijdigheid en beperkingen

Zowel het uitvoeringsgedrag (synchroon of asynchroon) als de reentrantie van de callout-functie zijn gespecificeerd als configuratie-afhankelijk [SWS_BswM_00270]. De feitelijke aanroepcontext hangt vermoedelijk af van het initiërende BswM-event respectievelijk de taak waarin de BswM-actie wordt afgehandeld. Vraag Q-2f3e2cdbb9de1794 (open) Ontwikkelaars moeten er daarom voor zorgen dat de implementatie voldoet aan de eisen van de gekozen uitvoeringscontext wat betreft threadveiligheid en blokkeergedrag.

Foutafhandeling en configuratie

De specificatie definieert voor deze service (service-ID 0x25) geen specifieke DET- of DEM-foutmeldingen [SWS_BswM_00270]. Omdat de BswM eventuele retourwaarden negeert, kan de functie fouten niet via gestandaardiseerde retourwaarden aan de BswM melden. De beschikbaarheid en koppeling van de functie vindt plaats via de moduleconfiguratie (referentie ECUC_BswM_00954) [SWS_BswM_00270].

Gebruik en typedefinitie

Het gegevenstype BswM_ModeType dient in de module BswM voor de unieke identificatie van de modi die door BswM-gebruikers (BswM Users) kunnen worden aangevraagd [SWS_BswM_00214]. Volgens de specificatie is het type afgeleid van het primitieve basistype uint16 en omvat het een waardebereik van 0 tot en met 65535 [SWS_BswM_00214]. Het wordt gedeclareerd en beschikbaar gesteld via het headerbestand BswM.h, dat door aanvragende componenten voor gebruik moet worden ingesloten [SWS_BswM_00214].

Beperkingen en aannames

Aanroepende software-eenheden dragen moduswaarden over als 16-bits geheel getal binnen de grenzen van 0 tot en met 65535 [SWS_BswM_00214]. Aangezien de specificatie geen vaste symbolische constanten opsomt, wordt de concrete toewijzing van afzonderlijke geheeltallige waarden aan toepassingsspecifieke modi vermoedelijk vastgelegd in het kader van de configuratie van de BswM-module. Vraag Q-94530792144d42ea (open) Voor een foutloos gebruik moet worden gewaarborgd dat aanvragers uitsluitend waarden binnen het gedefinieerde waardebereik hanteren [SWS_BswM_00214].

Integratie in de BSW-stack

Interfaces die modusaanyragen van gebruikers doorgeven aan de BswM, gebruiken BswM_ModeType voor de getypeerde overdracht van de modus-identificatoren [SWS_BswM_00214]. De beschikbaarstelling via BswM.h waarborgt daarbij een uniforme typering over verschillende BSW-modulegrenzen heen [SWS_BswM_00214].

Gebruik en typedefinitie

Het gegevenstype BswM_UserType wordt beschikbaar gesteld via het headerbestand BswM.h en dient voor de unieke identificatie van een BswM-gebruiker die modusaanvragen richt aan de Basic Software Mode Manager [SWS_BswM_00216]. Het type is afgeleid van het basisgeheeltallige type uint16 en omvat een waardebereik van 0 tot en met 65535 [SWS_BswM_00216].

Interactie en integratie

In de softwarearchitectuur fungeert dit type vermoedelijk primair als overdrachtsparameter in modusaanvraag-interfaces, zodat de BswM de binnenkomende aanvraag aan de desbetreffende bron kan toewijzen. Vraag Q-83bb1af3fb090e7e (open) Door de 16-bits breedte biedt de typedefinitie ruimte voor maximaal 65536 verschillende gebruikersidentificatoren in het systeem [SWS_BswM_00216]. De concrete instantiewaarden van de gebruikers worden daarbij vermoedelijk configuratiespecifiek gegenereerd in het kader van de BSW-generatie.

Beperkingen en foutafhandeling

Aangezien het om een elementaire typedefinitie gaat, zijn in de omvang van de specificatie geen specifieke foutcodes, DET-meldingen of concurrency-mechanismen voor dit type vastgelegd. Aanvragende softwaremodules moeten waarborgen dat bij aanroepen uitsluitend waarden binnen het toelaatbare bereik van 0 tot en met 65535 worden doorgegeven [SWS_BswM_00216].