BSW Mode Manager (BswM)
Arbitrates mode requests and executes action lists to control system state transitions.
Funktionen — Übersicht
void BswM_BswMPartitionRestarted (void);Function called by Restart Task if the partition containing the Bsw M has been restarted.void BswM_CanSM_CurrentState (NetworkHandleType Network, CanSM_BswMCurrentStateType CurrentState);Function called by Can SM to indicate its current state.void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode);Function called by Com M to indicate the current communication mode of a Com M channel.void BswM_ComM_CurrentPNCMode (PNCHandleType PNC, ComM_PncModeType CurrentPncMode);Function is called by Com M to indicate the current mode of the PNC.void BswM_ComM_InitiateReset (void);Function is called by Com M to signal a shutdown.void BswM_Dcm_ApplicationUpdated (void);This function is called by the DCM in order to report an updated application.void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode);Function called by DCM to inform the Bsw M about the current state of the communication mode.void BswM_Deinit (void);Deinitializes the BSW Mode Manager.void BswM_EcuM_CurrentState (EcuM_StateType CurrentState);Function called Ecu M to indicate the current ECU Operation Mode.void BswM_EcuM_CurrentWakeup (EcuM_WakeupSourceType source, EcuM_WakeupStatusType state);Function called by Ecu M to indicate the current state of a wakeup source.void BswM_EcuM_RequestedState (EcuM_StateType State, EcuM_RunStatusType CurrentState);Function called by Ecu M notify about current Status of the Run Request Protocol.void BswM_EthIf_PortGroupLinkStateChg (EthIf_SwitchPortGroupIdxType PortGroupIdx, EthTrcv_LinkStateType PortGroupState);Function called by Eth If to indicate the link state change of a certain Ethernet switch port group.void BswM_EthSM_CurrentState (NetworkHandleType Network, EthSM_NetworkModeStateType CurrentState);Function called by Eth SM to indicate its current state.void BswM_FrSM_CurrentState (NetworkHandleType Network, FrSM_BswM_StateType CurrentState);Function called by Fr SM to indicate its current state.void BswM_GetVersionInfo (Std_VersionInfoType* VersionInfo);Returns the version information of this module.void BswM_Init (const BswM_ConfigType* ConfigPtr);Initializes the BSW Mode Manager.void BswM_J1939DcmBroadcastStatus (uint16 NetworkMask);This API tells the Bsw M the desired communication status of the available networks.void BswM_J1939Nm_StateChangeNotification (NetworkHandleType Network, uint8 Node, Nm_StateType NmState);Notification of current J1939Nm state after state changes.void BswM_LinSM_CurrentSchedule (NetworkHandleType Network, LinIf_SchHandleType CurrentSchedule);Function called by Lin SM to indicate the currently active schedule table for a specific LIN channel.void BswM_LinSM_CurrentState (NetworkHandleType Network, LinSM_ModeType CurrentState);Function called by Lin SM to indicate its current state.void BswM_LinTp_RequestMode (NetworkHandleType Network, LinTp_Mode LinTpRequestedMode);Function called by Lin TP to request a mode for the corresponding LIN channel.void BswM_Nm_CarWakeUpIndication (NetworkHandleType Network);Function called by Nm to indicate a Car Wakeup.void BswM_Nm_StateChangeNotification (NetworkHandleType Network, Nm_StateType currentState);Notification of current Nm state after state changes.void BswM_NvM_CurrentBlockMode (NvM_BlockIdType Block, NvM_RequestResultType CurrentBlockMode);Function called by Nv M to indicate the current block mode of an Nv M block.void BswM_NvM_CurrentJobMode (NvM_MultiBlockRequestType MultiBlockRequest, NvM_RequestResultType CurrentJobMode);Function called by Nv M to inform the Bsw M about the current state of a multi block job.void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode);Generic function call to request modes.void BswM_Sd_ClientServiceCurrentState (uint16 SdClientServiceHandleId, Sd_ClientServiceCurrentStateType CurrentClientState);Function called by Service Discovery to indicate current state of the Client Service (available/ down).void BswM_Sd_ConsumedEventGroupCurrentState (uint16 SdConsumedEventGroupHandleId, Sd_ConsumedEventGroupCurrentStateType ConsumedEventGroupState);Function called by Service Discovery to indicate current status of the Consumed Eventgroup (available/ down).void BswM_Sd_EventHandlerCurrentState (uint16 SdEventHandlerHandleId, Sd_EventHandlerCurrentStateType EventHandlerStatus);Function called by Service Discovery to indicate current status of the Event Handler (requested/ released).void BswM_WdgM_RequestPartitionReset (ApplicationType Application);Function called by Wdg M to request a partition reset.void BswM_MainFunction (void);Main function of the Bsw Mvoid <BswMUserCalloutFunction> (implementation_specific -);Function called by the Bsw M when a Bsw MUser Callout is executed.
Typen — Übersicht
struct BswM_ConfigTypeThis structure contains all post - build configurable parameters of the BSW Modeenum BswM_ModeTypeThis type identifies the modes that can be requested by Bsw M Users.BswM_UserTypeThis type identifies a Bsw M User that makes mode requests to the Bsw M.
Funktionen & Typen — Detailansicht
fonction BswM_BswMPartitionRestarted [SWS_BswM_00193] 📄 PDF
void BswM_BswMPartitionRestarted (void);
Function called by Restart Task if the partition containing the Bsw M has been restarted.
La fonction BswM_BswMPartitionRestarted sert à avertir le module BswM du redémarrage de la partition dans laquelle le BswM est exécuté [SWS_BswM_00193].
Utilisation et sémantique
L'appel s'effectue de manière synchrone par la tâche de redémarrage du système d'exploitation dès que la partition a été rétablie après un redémarrage [SWS_BswM_00193]. La fonction possède l'ID de service 0x1e et est déclarée via le fichier d'en-tête BswM.h [SWS_BswM_00193]. Elle n'accepte aucun paramètre de transmission (ni paramètre d'entrée ni paramètre de sortie) et ne possède aucune valeur de retour (void) [SWS_BswM_00193].
Concurrence et exécution
Selon la spécification, BswM_BswMPartitionRestarted est classé comme réentrant [SWS_BswM_00193]. Cela permet l'appel dans le contexte de la tâche de redémarrage, l'appelant devant s'assurer que le redémarrage de la partition concernée a été correctement initié avant l'appel.
Traitement des erreurs et interaction
La spécification ne définit pour ce service aucune valeur de retour spécifique ni code d'erreur DET/DEM [SWS_BswM_00193]. L'interaction se limite à la tâche de redémarrage de l'OS qui déclenche cette notification afin que le BswM puisse réagir à la partition nouvellement démarrée [SWS_BswM_00193].
Cette note d'utilisation a été générée automatiquement sur la base de la spécification SWS_BswM_00193.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_CanSM_CurrentState [SWS_BswM_00049] 📄 PDF
void BswM_CanSM_CurrentState (NetworkHandleType Network, CanSM_BswMCurrentStateType CurrentState);
Function called by Can SM to indicate its current state. Ava ilable via Bsw M_ Can SM.h
Utilisation et signature
La fonction BswM_CanSM_CurrentState est appelée par le CAN State Manager (CanSM) pour signaler au BSW Mode Manager (BswM) l'état actuel d'un canal CAN [SWS_BswM_00049]. Elle possède l'ID de service 0x05 et est mise à disposition via le fichier d'en-tête BswM_CanSM.h [SWS_BswM_00049].
L'appel s'effectue de manière synchrone et ne renvoie aucune valeur de retour (void) [SWS_BswM_00049]. L'interface traite deux paramètres d'entrée [SWS_BswM_00049] :
Network(typeNetworkHandleType) : désigne le canal CAN concerné auquel se rapporte le changement d'état signalé [SWS_BswM_00049].CurrentState(typeCanSM_BswMCurrentStateType) : transmet le nouvel état adopté par le canal CAN respectif [SWS_BswM_00049].
Ni paramètre de sortie ni paramètre d'entrée/sortie n'est prévu pour cette fonction de service [SWS_BswM_00049].
Concurrence et restrictions
La spécification désigne BswM_CanSM_CurrentState comme réentrante [SWS_BswM_00049]. Elle peut donc être appelée de manière concurrente lors d'événements parallèles sur plusieurs canaux réseau. Étant donné que l'appel s'effectue de façon synchrone et qu'aucune restriction de tâche spécifique n'est prescrite, le contexte d'appel devrait correspondre au contexte d'exécution du CanSM appelant [SWS_BswM_00049]. Question Q-0edc8b6c1cb10f6d (ouverte)
Traitement des erreurs et interaction
Dans la spécification, aucun code d'erreur spécifique, aucune valeur de retour ni aucune notification vers DET ou DEM n'est documenté pour cet appel de fonction [SWS_BswM_00049]. La fonction sert d'interface de notification définie dans l'interaction entre le CanSM et le BswM, par laquelle l'état actuel du canal est intégré à la gestion des modes du BswM [SWS_BswM_00049].
Cette note d'utilisation a été générée par une IA et s'appuie exclusivement sur les spécifications AUTOSAR indiquées.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_ComM_CurrentMode [SWS_BswM_00047] 📄 PDF
void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode);
Function called by Com M to indicate the current communication mode of a Com M channel.
La fonction BswM_ComM_CurrentMode sert, dans le module AUTOSAR Classic BswM (Basic Software Mode Manager), d'interface de notification standardisée pour le Communication Manager (ComM) [SWS_BswM_00047]. Elle est appelée par le ComM pour indiquer au BswM le mode de communication actuel d'un canal de communication déterminé [SWS_BswM_00047]. La déclaration de cette interface est mise à disposition via le fichier d'en-tête BswM_ComM.h, et l'ID de service hexadécimal 0x0e est assigné au service [SWS_BswM_00047].
La signature de la fonction est void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode) et requiert deux paramètres d'entrée non modifiables [SWS_BswM_00047] :
Network(type de donnéesNetworkHandleType) : désigne le canal de communication ComM concret pour lequel l'état est indiqué et auquel correspond l'état [SWS_BswM_00047].RequestedMode(type de donnéesComM_ModeType) : transmet l'état ou le mode actuel du canal de communication ComM spécifié au module BswM [SWS_BswM_00047].
L'interface ne possède aucune valeur de retour (void) ; de même, aucun paramètre de sortie (out) ni aucun paramètre combiné d'entrée/sortie (inout) n'est défini dans la spécification [SWS_BswM_00047]. Le comportement d'exécution de la fonction est défini comme synchrone (Synchronous) [SWS_BswM_00047]. Concernant la concurrence et le contexte d'appel simultané, BswM_ComM_CurrentMode est classé comme réentrant (Reentrant) [SWS_BswM_00047].
En ce qui concerne le traitement des erreurs, aucun code d'erreur spécifique, aucune valeur de retour ni aucun message d'erreur vers DET ou DEM n'est prévu pour cette fonction dans la spécification de l'élément [SWS_BswM_00047]. Aucune condition d'ordonnancement supplémentaire ni dépendance vis-à-vis d'exigences associées n'est non plus consignée [SWS_BswM_00047].
Cette note d'utilisation a été générée automatiquement sur la base de l'exigence SWS_BswM_00047.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_ComM_CurrentPNCMode [SWS_BswM_00148] 📄 PDF
void BswM_ComM_CurrentPNCMode (PNCHandleType PNC, ComM_PncModeType CurrentPncMode);
Function is called by Com M to indicate the current mode of the PNC. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager
La fonction BswM_ComM_CurrentPNCMode sert d'interface de notification entre le Communication Manager et le BSW Mode Manager. Conformément à [SWS_BswM_00148], elle est appelée par le ComM pour transmettre le mode actuel d'un Partial Network Cluster (PNC) au BswM.
Utilisation et contexte d'appel
L'interface est disponible via le fichier d'en-tête BswM_ComM.h et possède l'ID de service 0x15 ([SWS_BswM_00148]). L'appel est exécuté de manière synchrone et ne renvoie aucune valeur de retour (void). Seuls deux paramètres d'entrée sont transmis :
PNC(typePNCHandleType) : le descripteur (handle) du Partial Network Cluster concerné dont l'état est rapporté.CurrentPncMode(typeComM_PncModeType) : le mode actuellement adopté par le PNC indiqué.
Aucun paramètre d'entrée ou de sortie supplémentaire n'est prévu selon [SWS_BswM_00148].
Concurrence et restrictions
Concernant la concurrence, BswM_ComM_CurrentPNCMode est spécifié selon [SWS_BswM_00148] comme réentrant, ce qui rend admissibles les appels simultanés provenant du ComM. Aucun code d'erreur spécifique ni mécanisme de traitement d'erreur via DET ou DEM n'est défini dans la charge utile (payload). Les états transmis devraient servir en interne dans le BswM de déclencheurs pour l'évaluation des règles et des actions (interprétation : le payload atteste de l'indication de mode, mais ne spécifie aucune action interne du BswM). Question Q-2527fc2eda881b62 (ouverte)
Cette note d'utilisation est basée sur la spécification AUTOSAR CP R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_ComM_InitiateReset [SWS_BswM_00217] 📄 PDF
void BswM_ComM_InitiateReset (void);
Function is called by Com M to signal a shutdown.
La fonction BswM_ComM_InitiateReset est appelée par le Communication Manager (ComM) afin de signaler un arrêt imminent au BswM [SWS_BswM_00217].
Interface et sémantique d'appel
L'interface possède la signature void BswM_ComM_InitiateReset(void) et est déclarée via le fichier d'en-tête BswM_ComM.h [SWS_BswM_00217]. Elle ne traite aucun paramètre d'entrée, de sortie ni d'entrée/sortie et ne possède aucune valeur de retour [SWS_BswM_00217]. L'appel est exécuté de manière synchrone et est spécifié avec l'ID de service 0x22 [SWS_BswM_00217].
Concurrence et restrictions
La fonction est définie comme non réentrante (Non Reentrant) [SWS_BswM_00217]. L'appelant doit donc garantir que les appels s'effectuent de façon séquentielle et qu'aucune exécution parallèle ou chevauchante n'a lieu. Le traitement étant synchrone, l'appel bloque le contexte d'exécution jusqu'à l'achèvement du traitement dans le BswM.
Traitement des erreurs et interaction
Dans les spécifications, aucun code d'erreur spécifique, aucune valeur de retour ni aucun message d'erreur vers le DET ou le DEM ne sont prévus pour ce service [SWS_BswM_00217]. L'interaction se limite selon la spécification à la réception de la signalisation d'arrêt du ComM [SWS_BswM_00217] ; interprétation : la notification devrait servir de déclencheur dans le BswM pour des actions configurées en vue de réaliser l'arrêt ou la réinitialisation. Question Q-adf160d8d0fe2c97 (ouverte)
Cette note d'utilisation repose sur la spécification SWS_BswM_00217 d'AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Dcm_ApplicationUpdated [SWS_BswM_00158] 📄 PDF
void BswM_Dcm_ApplicationUpdated (void);
This function is called by the DCM in order to report an updated application.
Utilisation et contexte d'appel
La fonction BswM_Dcm_ApplicationUpdated est appelée conformément à [SWS_BswM_00158] par le Diagnostic Communication Manager (DCM) afin de signaler au BswM la mise à jour réussie d'une application. Le service est déclaré dans le fichier d'en-tête BswM_Dcm.h et possède l'ID de service 0x14. L'interface n'attend aucun paramètre de transmission (void) et ne renvoie aucune valeur à l'appelant.
Synchronisme et concurrence
Conformément à [SWS_BswM_00158], la fonction est spécifiée comme synchrone et réentrante. L'appelant demeure ainsi dans le contexte d'exécution du DCM jusqu'à ce que le traitement immédiat de l'appel au sein du BswM soit achevé. La propriété déclarée de réentrance permet en principe de solliciter l'interface de manière concurrente depuis différents contextes de tâche.
Traitement des erreurs et interaction
Pour BswM_Dcm_ApplicationUpdated, ni code d'erreur spécifique ni notification vers le DET ou le DEM n'est prévu dans [SWS_BswM_00158]. L'appel sert uniquement de notification d'état destinée à la gestion des modes du BSW. La notification devrait servir dans le BswM d'indicateur et de déclencheur pour la réévaluation de règles internes ainsi que de changements de mode ultérieurs, afin d'adapter l'ensemble du système au logiciel d'application modifié. Question Q-119282a4a72622b5 (ouverte)
Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification AUTOSAR R20-11.
fonction BswM_Dcm_CommunicationMode_CurrentState [SWS_BswM_00048] 📄 PDF
void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode);
Function called by DCM to inform the Bsw M about the current state of the communication mode.
Utilisation
La fonction BswM_Dcm_CommunicationMode_CurrentState est appelée par le module Diagnostic Communication Manager (DCM) pour informer le Basic Software Mode Manager (BswM) de l'état actuel du mode de communication [SWS_BswM_00048]. La déclaration de cette interface est fournie via le fichier d'en-tête BswM_Dcm.h [SWS_BswM_00048].
La syntaxe C de la fonction est void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode) [SWS_BswM_00048]. Lors de l'appel par le DCM, deux paramètres d'entrée sont transmis [SWS_BswM_00048] :
Network(typeNetworkHandleType) : désigne le canal de communication auquel le mode de diagnostic se rapporte [SWS_BswM_00048].RequestedMode(typeDcm_CommunicationModeType) : transmet le mode de communication de diagnostic demandé au BswM [SWS_BswM_00048].
L'interface ne possède aucune valeur de retour (type de retour void) et n'utilise ni paramètres modificateurs d'entrée/sortie (Inout) ni paramètres de sortie (Out) [SWS_BswM_00048].
Concurrence et propriétés
L'appel de fonction est exécuté de manière synchrone et est spécifié comme réentrant [SWS_BswM_00048]. Le nom du service est défini comme BswM_Dcm_CommunicationMode_CurrentState et possède l'ID de service 0x06 en notation hexadécimale [SWS_BswM_00048].
Interaction
Interprétation : le BswM devrait utiliser l'état transmis du mode de communication comme critère d'évaluation de règles de mode afin de déclencher des actions subséquentes dans le BswM [SWS_BswM_00048]. Question Q-1031b1a7ae000c2a (ouverte)
Cette note d'utilisation a été générée automatiquement.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Deinit [SWS_BswM_00119] 📄 PDF
void BswM_Deinit (void);
Deinitializes the BSW Mode Manager.
Utilisation et sémantique
La fonction BswM_Deinit sert à la désinitialisation du BSW Mode Manager ([SWS_BswM_00119]). L'exécution s'effectue de manière synchrone sans paramètre de transmission et sans valeur de retour avec l'ID de service 0x04 ([SWS_BswM_00119]). La déclaration est disponible via le fichier d'en-tête BswM.h ([SWS_BswM_00119]).
Concurrence et restrictions
L'interface est spécifiée comme non réentrante (Non Reentrant) ([SWS_BswM_00119]). Un appel concurrent ou avec interruption depuis plusieurs contextes de tâche est donc interdit. Interprétation : la désinitialisation devrait typiquement être effectuée séquentiellement pendant la phase d'arrêt du calculateur par une gestion d'état de niveau supérieur telle que l'ECU State Manager. Question Q-0a5d218bfe9fed04 (ouverte)
Interaction et comportement après la désinitialisation
Après l'appel de BswM_Deinit, le module BswM n'effectue plus aucun traitement de mode ([SWS_BswM_00120]). Cette neutralisation persiste même si des demandes de mode externes ou internes sont soumises au module ou si la fonction principale cyclique du BswM continue d'être exécutée ou appelée ([SWS_BswM_00120]).
Ce texte a été généré par une IA sur la base de la spécification AUTOSAR.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_EcuM_CurrentState [SWS_BswM_91003] 📄 PDF
void BswM_EcuM_CurrentState (EcuM_StateType CurrentState);
Function called Ecu M to indicate the current ECU Operation Mode.
La fonction de service synchrone BswM_EcuM_CurrentState est appelée par le module EcuM afin d'indiquer au BswM le mode de fonctionnement actuel de l'ECU [SWS_BswM_91003]. L'interface possède l'ID de service 0x28 et est mise à disposition via le fichier d'en-tête BswM_EcuM.h [SWS_BswM_91003].
Utilisation
Lors de l'appel de la fonction, l'état demandé de l'ECU est communiqué de manière synchrone au BswM [SWS_BswM_91003]. La transmission s'effectue via un unique paramètre d'entrée :
Current State(in) : transmet le mode de fonctionnement demandé de l'ECU en utilisant le type de donnéesEcuM_StateType[SWS_BswM_91003].
La fonction ne définit ni paramètres d'entrée/sortie (inout) ni paramètres de sortie (out) et ne possède aucune valeur de retour (void) [SWS_BswM_91003].
Concurrence et restrictions
Concernant le comportement face à la concurrence, BswM_EcuM_CurrentState est spécifiée comme réentrante [SWS_BswM_91003]. Les appels peuvent ainsi s'effectuer de manière concurrente sans restriction, par exemple lorsque différents chemins d'exécution de l'appelant sont actifs [SWS_BswM_91003].
Aucun code d'erreur spécifique, notification au module DET ou DEM, ni mécanisme particulier de traitement des erreurs n'est mentionné dans le périmètre de spécification pour ce service [SWS_BswM_91003].
Cette note d'utilisation a été générée automatiquement sur la base d'AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_EcuM_CurrentWakeup [SWS_BswM_00131] 📄 PDF
void BswM_EcuM_CurrentWakeup (EcuM_WakeupSourceType source, EcuM_WakeupStatusType state);
Function called by Ecu M to indicate the current state of a wakeup source.
La fonction BswM_EcuM_CurrentWakeup sert d'interface du BswM, appelée par le module EcuM afin de signaler l'état actuel d'une ou plusieurs sources de réveil [SWS_BswM_00131]. La déclaration est disponible via le fichier d'en-tête BswM_EcuM.h [SWS_BswM_00131].
Lors de l'appel de la fonction, les paramètres de transmission suivants sont communiqués [SWS_BswM_00131] :
source(typeEcuM_WakeupSourceType) : désigne la ou les sources de réveil dont l'état a changé [SWS_BswM_00131].state(typeEcuM_WakeupStatusType) : indique le nouvel état de la ou des sources de réveil concernées [SWS_BswM_00131].
La fonction ne possède pas de valeur de retour (void) et ne comporte aucun paramètre d'entrée/sortie ou de sortie pure [SWS_BswM_00131]. L'ID de service associé est 0x10 [SWS_BswM_00131].
Concernant le comportement d'exécution, l'appel de fonction est spécifié comme synchrone [SWS_BswM_00131]. De plus, la fonction est classée comme réentrante, ce qui lui permet d'être appelée de manière concurrente depuis différents contextes si nécessaire [SWS_BswM_00131].
Ce texte a été rédigé par une IA sur la base de la spécification.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_EcuM_RequestedState [SWS_BswM_91004] 📄 PDF
void BswM_EcuM_RequestedState (EcuM_StateType State, EcuM_RunStatusType CurrentState);
Function called by Ecu M notify about current Status of the Run Request Protocol.
Utilisation et sémantique
La fonction BswM_EcuM_RequestedState sert d'interface de notification appelée par le gestionnaire d'état du calculateur (EcuM) afin d'informer le module BswM de l'état actuel du Run Request Protocol [SWS_BswM_91004]. L'appel s'effectue de manière synchrone et est spécifié comme réentrant, de sorte que la fonction peut être exécutée dans des contextes concurrents [SWS_BswM_91004]. La déclaration est fournie par le biais du fichier d'en-tête BswM_EcuM.h avec l'ID de service 0x29 [SWS_BswM_91004].
Paramètres et valeur de retour
L'interface ne possède aucune valeur de retour (type de retour void) et attend deux paramètres d'entrée purs [SWS_BswM_91004] :
State(typeEcuM_StateType) : indique l'état demandé par l'EcuM [SWS_BswM_91004].CurrentState(typeEcuM_RunStatusType) : transmet le résultat ou l'état actuel de l'EcuM Run Request Protocol [SWS_BswM_91004].
Aucun paramètre d'entrée/sortie ni de sortie n'est prévu pour cette fonction [SWS_BswM_91004].
Interaction et intégration
La fonction est exclusivement appelée par l'EcuM. Interprétation : les états transmis devraient servir dans le BswM à l'évaluation interne des règles et au contrôle des modes afin de déclencher des actions de niveau supérieur du Basic Software [SWS_BswM_91004]. Question Q-6cd81e44c9e2920a (ouverte) Pour ce service, aucun code d'erreur spécifique pour DET ou DEM n'est consigné dans la spécification [SWS_BswM_91004].
Cette note d'utilisation a été générée automatiquement et repose exclusivement sur la spécification de la version AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_EthIf_PortGroupLinkStateChg [SWS_BswM_91001] 📄 PDF
void BswM_EthIf_PortGroupLinkStateChg (EthIf_SwitchPortGroupIdxType PortGroupIdx, EthTrcv_LinkStateType PortGroupState);
Function called by Eth If to indicate the link state change of a certain Ethernet switch port group.
Utilisation
La fonction BswM_EthIf_PortGroupLinkStateChg est appelée conformément à [SWS_BswM_91001] par le module EthIf pour signaler au BswM un changement d'état de connexion (Link State) d'un groupe de ports de switch Ethernet. L'interface possède l'ID de service 0x26 et est mise à disposition via le fichier d'en-tête BswM_EthIf.h [SWS_BswM_91001].
L'appel transmet deux paramètres d'entrée :
PortGroupIdx: désigne l'indice du groupe de ports concerné dans le contexte de l'interface Ethernet [SWS_BswM_91001].PortGroupState: indique l'état du groupe de ports, qui est dérivé du lien physique du transceiver Ethernet. Les états valides sontETHTRCV_LINK_STATE_DOWNpour un lien déconnecté etETHTRCV_LINK_STATE_ACTIVEpour un lien actif [SWS_BswM_91001].
La fonction ne possède ni paramètres d'entrée/sortie ni paramètres de sortie et ne renvoie aucune valeur (void) [SWS_BswM_91001].
Concurrence et restrictions
L'exécution est synchrone et est spécifiée comme réentrante [SWS_BswM_91001]. Aucune valeur de retour spécifique, code d'erreur ou message d'erreur (DET/DEM) n'est défini pour cette interface [SWS_BswM_91001].
Interaction
Interprétation : le BswM devrait utiliser l'état de lien transmis comme variable d'entrée pour évaluer des règles dépendantes de l'état et déclencher des actions en aval ou des changements de mode au sein de la BSW. Question Q-14285579acb760d5 (ouverte)
Ce texte a été généré par une IA et repose sur les spécifications de la version AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_EthSM_CurrentState [SWS_BswM_00050] 📄 PDF
void BswM_EthSM_CurrentState (NetworkHandleType Network, EthSM_NetworkModeStateType CurrentState);
Function called by Eth SM to indicate its current state.
La fonction BswM_EthSM_CurrentState sert d'interface de rappel (callback) et de notification du BSW Mode Manager. Elle est appelée conformément à [SWS_BswM_00050] par l'Ethernet State Manager (EthSM) afin de transmettre l'état actuel d'un canal de communication au BswM. La déclaration de l'interface est mise à disposition via l'en-tête BswM_EthSM.h et possède l'ID de service 0x0d.
Pour l'utilisation et l'appel, les dispositions suivantes s'appliquent selon [SWS_BswM_00050] :
- Sémantique d'appel : L'exécution s'effectue de manière synchrone. L'appelant attend donc que la fonction ait terminé le traitement de la notification d'état.
- Concurrence : Le service est spécifié comme réentrant [SWS_BswM_00050]. Les appels peuvent donc avoir lieu pour différentes instances de réseau ou de manière concurrente depuis le contexte du module
EthSM. - Paramètres de transmission : Sont transmis le réseau Ethernet concerné sous la forme de
Networkde typeNetworkHandleTypeainsi que l'état signalé sous la forme deCurrentStatede typeEthSM_NetworkModeStateType. Aucun paramètre d'entrée et de sortie (inout/out) n'est prévu ; la valeur de retour estvoid.
Dans la spécification de l'élément [SWS_BswM_00050], ni valeur de retour spécifique ni message d'erreur vers DET ou DEM n'est défini. Interprétation : le module BswM devrait enregistrer en interne l'état du réseau signalé et l'utiliser comme condition pour l'évaluation des règles configurées ainsi que pour le déclenchement de changements de mode. Question Q-407156ff74cbab6f (ouverte)
Cette note d'utilisation a été générée automatiquement sur la base de la spécification de la version AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_FrSM_CurrentState [SWS_BswM_00051] 📄 PDF
void BswM_FrSM_CurrentState (NetworkHandleType Network, FrSM_BswM_StateType CurrentState);
Function called by Fr SM to indicate its current state.
Utilisation et contexte d'appel
La fonction BswM_FrSM_CurrentState sert d'interface de rappel ou de notification du BswM, appelée par le FlexRay State Manager (FrSM) pour signaler l'état actuel d'un cluster FlexRay [SWS_BswM_00051]. La déclaration de la fonction est fournie via le fichier d'en-tête BswM_FrSM.h [SWS_BswM_00051]. L'appel s'effectue de façon synchrone et ne renvoie aucune valeur de retour (void) [SWS_BswM_00051].
L'interface définit deux paramètres d'entrée [SWS_BswM_00051] :
Network(typeNetworkHandleType) : indique le cluster FlexRay respectif auquel se rapporte la notification d'état [SWS_BswM_00051].CurrentState(typeFrSM_BswM_StateType) : transmet l'état actuel du cluster FlexRay concerné au BswM [SWS_BswM_00051].
Il n'existe aucun paramètre de sortie (out) ou d'entrée/sortie (inout) pour cette fonction [SWS_BswM_00051].
Concurrence et traitement des erreurs
La fonction est spécifiée avec l'ID de service 0x0c et identifiée comme réentrante [SWS_BswM_00051]. Aucun code d'erreur spécifique, comportement en cas d'erreur ou notification à la gestion des erreurs de développement (DET) ou à la gestion des événements de diagnostic (DEM) n'est mentionné dans la spécification pour ce service [SWS_BswM_00051].
Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification d'AUTOSAR Classic Release R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_GetVersionInfo [SWS_BswM_00003] 📄 PDF
void BswM_GetVersionInfo (Std_VersionInfoType* VersionInfo);
Returns the version information of this module.
fonction BswM_Init [SWS_BswM_00002] 📄 PDF
void BswM_Init (const BswM_ConfigType* ConfigPtr);
Initializes the BSW Mode Manager.
La fonction synchrone BswM_Init sert à l'initialisation du Basic Software Mode Manager (BswM) conformément à la spécification [SWS_BswM_00002]. Elle est déclarée via le fichier d'en-tête BswM.h et possède l'ID de service 0x00 [SWS_BswM_00002].
Paramètres et valeurs de retour
Un pointeur vers les données de configuration post-build de type BswM_ConfigType est transmis à la fonction par le biais de son unique paramètre d'entrée ConfigPtr [SWS_BswM_00002]. Il n'existe aucun paramètre de sortie ou d'entrée/sortie, et aucune valeur de retour n'est renvoyée [SWS_BswM_00002].
Concurrence et contexte d'exécution
L'exécution est synchrone. Le comportement du module en matière de réentrance est spécifié comme sous condition réentrant (Conditionally Reentrant) [SWS_BswM_00002]. En guise d'interprétation, cela devrait signifier que des appels simultanés ne sont autorisés que sous des conditions système spécifiques, telles que des zones de données séparées. Question Q-c0063b2a12eb4f41 (ouverte) De plus, l'appel devrait typiquement intervenir dans le cadre de l'initialisation du système, avant que d'autres opérations du BswM ne soient exécutées.
Ce texte a été généré par une IA sur la base de la spécification AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_J1939DcmBroadcastStatus [SWS_BswM_00165] 📄 PDF
void BswM_J1939DcmBroadcastStatus (uint16 NetworkMask);
This API tells the Bsw M the desired communication status of the available networks. The status will typically be activated via COM I - PDU group switches.
La fonction de service synchrone BswM_J1939DcmBroadcastStatus (ID de service 0x1b) transmet au BSW Mode Manager le statut de communication souhaité des réseaux disponibles [SWS_BswM_00165]. L'état signalé est typiquement rendu effectif dans le système par la commutation de groupes d'I-PDU de COM (COM I-PDU group switches) [SWS_BswM_00165]. L'interface est fournie via l'en-tête BswM_J1939Dcm.h [SWS_BswM_00165].
Les paramètres et la sémantique sont spécifiés comme suit [SWS_BswM_00165] :
- Paramètres de transmission : Via le paramètre
NetworkMaskest transmis un masque de bits comprenant un bit par réseau disponible. La position respective du bit correspond à l'identifiant du canal de communicationComMChannel.ComMChannelId, de sorte que l'ID de canal 0 soit mappé sur le bit 0. - Signification des bits : La valeur
1signale que le réseau est activé (Network enabled), tandis que0indique un réseau désactivé (Network disabled). - Valeur de retour : La fonction ne possède aucune valeur de retour (
void).
Concurrence et restrictions : L'appel est conçu pour être réentrant et fonctionne de manière synchrone [SWS_BswM_00165]. Le paramètre NetworkMask étant défini comme une valeur 16 bits, seuls les 16 premiers identifiants de canal de communication peuvent être adressés par conception via cette API [SWS_BswM_00165]. Aucun code d'erreur spécifique ni message DET ou DEM n'est spécifié pour cette fonction [SWS_BswM_00165].
Cette note d'utilisation a été générée par une IA sur la base de la spécification SWS_BswM_00165.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_J1939Nm_StateChangeNotification [SWS_BswM_00194] 📄 PDF
void BswM_J1939Nm_StateChangeNotification (NetworkHandleType Network, uint8 Node, Nm_StateType NmState);
Notification of current J1939Nm state after state changes. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager
Utilisation
La fonction BswM_J1939Nm_StateChangeNotification sert à notifier de manière synchrone le BSW Mode Manager de l'état actuel d'un nœud de réseau J1939 après un changement d'état effectif [SWS_BswM_00194]. La déclaration est disponible via le fichier d'en-tête BswM_J1939Nm.h et est répertoriée sous l'ID de service 0x18 [SWS_BswM_00194].
L'interface attend trois paramètres d'entrée et ne renvoie aucune valeur de retour (void) [SWS_BswM_00194] :
Network(NetworkHandleType) : identifie le canal J1939 concerné [SWS_BswM_00194].Node(uint8) : identification numérique du nœud J1939 concerné [SWS_BswM_00194].NmState(Nm_StateType) : représente l'état actuel ou nouvellement adopté du nœud [SWS_BswM_00194].
Concurrence et contexte d'appel
Le traitement s'effectue de manière synchrone et est spécifié comme réentrant [SWS_BswM_00194]. Par conséquent, dans les systèmes comportant plusieurs nœuds ou canaux, la notification peut également avoir lieu de façon concurrente. L'appelant devrait être le module J1939Nm, qui informe le BswM du nouveau statut après des transitions d'état internes. Question Q-9c0e521db5e51713 (ouverte)
Gestion des erreurs
La spécification ne définit pour ce service ni codes d'erreur spécifiques ni notifications au DET ou au DEM [SWS_BswM_00194]. De plus, il n'existe ni paramètres de sortie ni paramètres d'entrée/sortie pour l'indication d'erreurs [SWS_BswM_00194].
Ce texte a été généré par une IA sur la base de la spécification.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_LinSM_CurrentSchedule [SWS_BswM_00058] 📄 PDF
void BswM_LinSM_CurrentSchedule (NetworkHandleType Network, LinIf_SchHandleType CurrentSchedule);
Function called by Lin SM to indicate the currently active schedule table for a specific LIN channel.
La fonction BswM_LinSM_CurrentSchedule sert d'interface de notification, appelée par le LIN State Manager (Lin SM) pour indiquer au BswM la Schedule Table actuellement active pour un canal LIN déterminé ([SWS_BswM_00058]). Le service est disponible via l'en-tête BswM_LinSM.h et possède l'ID de service 0x0a ([SWS_BswM_00058]).
Lors de l'appel, deux paramètres d'entrée sont transmis ([SWS_BswM_00058]) :
Network(typeNetworkHandleType) : désigne le canal LIN concret sur lequel le changement de Schedule Table a eu lieu ([SWS_BswM_00058]).Current Schedule(typeLinIf_SchHandleType) : transmet l'identifiant de la Schedule Table désormais active sur ce canal LIN ([SWS_BswM_00058]).
L'interface ne possède ni paramètre d'entrée/sortie ni paramètre de sortie et ne renvoie aucune valeur de retour (void) ([SWS_BswM_00058]). Le comportement d'exécution est défini comme synchrone (Synchronous), et la fonction est spécifiée comme réentrante (Reentrant) ([SWS_BswM_00058]).
Aucun code d'erreur spécifique, aucune réaction aux erreurs ni aucun message vers DET ou DEM n'est indiqué pour ce service dans la spécification ([SWS_BswM_00058]). Interprétation : l'appel devrait typiquement avoir lieu immédiatement après un changement de table effectif dans le Lin SM, afin d'informer de manière synchrone l'évaluation d'état dans le BswM au sujet de ce changement. Question Q-302196d84e739258 (ouverte)
Ce texte a été généré par une IA sur la base des spécifications AUTOSAR.
fonction BswM_LinSM_CurrentState [SWS_BswM_00052] 📄 PDF
void BswM_LinSM_CurrentState (NetworkHandleType Network, LinSM_ModeType CurrentState);
Function called by Lin SM to indicate its current state.
Utilisation et contexte d'appel
La fonction synchrone BswM_LinSM_CurrentState est appelée par le LIN State Manager (LinSM) pour notifier un changement d'état d'un canal LIN au BswM [SWS_BswM_00052]. Elle est définie dans le module BswM, possède l'ID de service 0x09 et est déclarée via le fichier d'en-tête BswM_LinSM.h pour le LinSM [SWS_BswM_00052].
Paramètres et valeurs de retour
L'interface ne possède aucune valeur de retour (void) ni aucun paramètre d'entrée/sortie ou de sortie [SWS_BswM_00052]. Deux paramètres d'entrée sont transmis pour la signalisation :
Network(typeNetworkHandleType) : indique le canal LIN auquel se rapporte l'indication d'état signalée [SWS_BswM_00052].CurrentState(typeLinSM_ModeType) : contient l'état actuellement adopté par le canal LIN spécifié [SWS_BswM_00052].
Concurrence et intégration de module
Selon la spécification, la fonction est implémentée de manière réentrante [SWS_BswM_00052]. Cela permet l'appel parallèle pour différents réseaux LIN sans blocage mutuel. Interprétation : l'état du canal transmis devrait probablement être utilisé dans le BswM comme grandeur d'entrée pour l'évaluation de règles et les listes d'actions, afin de commander les transitions de mode qui en découlent dans l'ensemble du calculateur. Question Q-ca113e4b71e4ab75 (ouverte)
Ce texte a été créé par une IA et est basé sur la spécification AUTOSAR Classic R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_LinTp_RequestMode [SWS_BswM_00156] 📄 PDF
void BswM_LinTp_RequestMode (NetworkHandleType Network, LinTp_Mode LinTpRequestedMode);
Function called by Lin TP to request a mode for the corresponding LIN channel. The Lin Tp_ Mode correlates to the LIN schedule table that should be used.
Utilisation et contexte d'appel
La fonction synchrone BswM_LinTp_RequestMode est appelée par le Lin TP afin de demander un changement de mode pour un canal LIN déterminé [SWS_BswM_00156]. La déclaration s'effectue via l'en-tête BswM_LinTp.h avec l'ID de service 0x0b [SWS_BswM_00156]. Sont transmis comme paramètres d'entrée :
Network(typeNetworkHandleType) : désigne le canal LIN concerné auquel se rapporte la demande de mode [SWS_BswM_00156].LinTp_Mode(transmis en tant queLinTp_Mode Lin Tp RequestedMode) : détermine le mode TP demandé, qui est directement corrélé avec la table d'ordonnancement LIN à utiliser [SWS_BswM_00156].
La fonction ne possède aucune valeur de retour (void) [SWS_BswM_00156]. Aucun code d'erreur spécifique, aucune valeur de retour pour le traitement des erreurs ni aucun message DET n'est prévu dans la définition de la fonction [SWS_BswM_00156].
Concurrence et gestion des modes
L'interface est spécifiée comme réentrante [SWS_BswM_00156]. Cela permet un appel parallèle depuis différents contextes ou pour des canaux LIN distincts. Étant donné que le mode requis influe sur la sélection de la table d'ordonnancement, la fonction sert d'interface spécifique au mode entre Lin TP et le BSW Mode Manager [SWS_BswM_00156]. Interprétation : sur la base de la demande, le BswM devrait procéder à des évaluations internes pour amorcer le changement de la table d'ordonnancement LIN. Question Q-544460b6b32b6ac2 (ouverte)
Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification AUTOSAR Classic R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Nm_CarWakeUpIndication [SWS_BswM_00235] 📄 PDF
void BswM_Nm_CarWakeUpIndication (NetworkHandleType Network);
Function called by Nm to indicate a Car Wakeup.
Utilisation et contexte d'appel
La fonction BswM_Nm_CarWakeUpIndication sert d'interface de rappel du Basic Software Mode Manager (BswM) et est appelée par Network Management (Nm) pour signaler un événement de réveil du véhicule (Car-Wakeup) lié à un canal [SWS_BswM_00235].\n L'appel s'effectue de manière synchrone et transmet via le paramètre d'entrée Network de type NetworkHandleType l'identification du canal Nm concerné [SWS_BswM_00235].\n L'interface ne déclare aucune valeur de retour (void) et ne fournit aucun paramètre de sortie [SWS_BswM_00235].\n Le service est défini avec l'ID de service 0x24 dans le fichier d'en-tête BswM_Nm.h [SWS_BswM_00235].
Concurrence et traitement des erreurs
L'interface est spécifiée comme réentrante, ce qui autorise les appels parallèles [SWS_BswM_00235].\n Aucun code d'erreur spécifique, notification au DET ou au DEM ni mécanisme particulier de traitement des erreurs n'est indiqué dans la spécification de l'élément [SWS_BswM_00235].
Interaction
En tant que point d'intégration entre le Nm et le BswM, la fonction transmet le signal de réveil directement au traitement du BswM [SWS_BswM_00235].\n Interprétation : l'appel devrait être évalué au sein du BswM comme un indicateur pour la vérification de règles ou des changements de mode dans le cadre du démarrage du réseau. Question Q-e56d5cfb6345f1ba (ouverte)
Cette note d'utilisation a été générée automatiquement sur la base de la spécification AUTOSAR R20-11.
fonction BswM_Nm_StateChangeNotification [SWS_BswM_91002] 📄 PDF
void BswM_Nm_StateChangeNotification (NetworkHandleType Network, Nm_StateType currentState);
Notification of current Nm state after state changes.
Utilisation et contexte d'appel
La fonction BswM_Nm_StateChangeNotification sert d'interface de notification pour transmettre au BswM l'état actuel d'un canal de Network Management après des changements de statut effectifs [SWS_BswM_91002]. Elle est déclarée dans le fichier d'en-tête BswM_Nm.h et définie sous l'ID de service 0x27 [SWS_BswM_91002]. L'exécution s'effectue de manière synchrone, et la fonction ne possède aucune valeur de retour (void) [SWS_BswM_91002].
La transmission des données d'état s'effectue via deux paramètres d'entrée purs ; il n'existe pas de paramètres d'entrée/sortie ou de sortie [SWS_BswM_91002] :
Network(type :NetworkHandleType) : désigne le canal Nm concerné pour l'identification du réseau [SWS_BswM_91002].currentState(type :Nm_StateType) : signale l'état actuel ou nouvel état du canal Nm indiqué [SWS_BswM_91002].
Concurrence et comportement
L'interface est classée comme réentrante [SWS_BswM_91002]. La fonction peut ainsi être appelée de manière concurrente, ce qui est particulièrement pertinent lors de transitions d'état simultanées sur différents canaux de réseau. L'appel étant spécifié comme synchrone, la fonction ne retourne à l'appelant qu'après la prise en compte interne du changement de statut [SWS_BswM_91002]. L'appel devrait typiquement être effectué par le Network Management dès qu'un canal a adopté un nouvel état [SWS_BswM_91002]. Question Q-8645d9511a825fed (ouverte)
Ce texte a été généré par une IA sur la base de la spécification R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_NvM_CurrentBlockMode [SWS_BswM_00104] 📄 PDF
void BswM_NvM_CurrentBlockMode (NvM_BlockIdType Block, NvM_RequestResultType CurrentBlockMode);
Function called by Nv M to indicate the current block mode of an Nv M block.
Utilisation
La fonction BswM_NvM_CurrentBlockMode est appelée par le NVRAM Manager (NvM) pour indiquer au Basic Software Mode Manager (BswM) le mode de bloc actuel d'un bloc NVRAM [SWS_BswM_00104]. La déclaration de la fonction est disponible via le fichier d'en-tête BswM_NvM.h et est associée à l'ID de service 0x16 dans la spécification [SWS_BswM_00104].
Paramètres et valeurs de retour
La fonction ne renvoie aucune valeur de retour (void) à l'appelant et traite deux paramètres d'entrée [SWS_BswM_00104] :
Block(typeNvM_BlockIdType) : transmet l'identifiant de bloc du bloc NVRAM auquel se rapporte la nouvelle information de mode [SWS_BswM_00104].CurrentBlockMode(typeNvM_RequestResultType) : transmet le mode de bloc actuel ou le résultat de la requête du bloc NvM [SWS_BswM_00104].
Aucun paramètre de sortie ou paramètre combiné d'entrée/sortie n'est défini pour cette interface [SWS_BswM_00104].
Concurrence et restrictions
L'appel de fonction de BswM_NvM_CurrentBlockMode est exécuté de manière synchrone et est spécifié comme réentrant [SWS_BswM_00104]. L'interface est ainsi conçue pour une utilisation réentrante dans des contextes d'exécution concurrents [SWS_BswM_00104].
Gestion des erreurs
Pour cette interface, les exigences de la spécification n'indiquent aucun code d'erreur spécifique ni aucune exigence de notification d'erreur via le Default Error Tracer (DET) ou le module Diagnostic Event Manager (DEM) [SWS_BswM_00104].
Cette note d'utilisation a été générée automatiquement et repose exclusivement sur les données de spécification de la version AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_NvM_CurrentJobMode [SWS_BswM_00152] 📄 PDF
void BswM_NvM_CurrentJobMode (NvM_MultiBlockRequestType MultiBlockRequest, NvM_RequestResultType CurrentJobMode);
Function called by Nv M to inform the Bsw M about the current state of a multi block job.
Utilisation et signature
La fonction BswM_NvM_CurrentJobMode est appelée par le NVRAM Manager (NvM) pour informer le BSW Mode Manager (BswM) de l'état actuel d'une requête multi-blocs [SWS_BswM_00152]. L'interface est déclarée dans l'en-tête BswM_NvM.h et possède l'ID de service 0x17 [SWS_BswM_00152]. Elle accepte deux paramètres d'entrée :
MultiBlockRequest(typeNvM_MultiBlockRequestType) : indique à quelle requête multi-blocs concrète ce rappel se rapporte [SWS_BswM_00152].CurrentJobMode(typeNvM_RequestResultType) : indique le statut actuel ou le résultat de la requête multi-blocs concernée [SWS_BswM_00152].
La fonction ne renvoie aucune valeur (type de retour void) et ne dispose d'aucun paramètre d'entrée/sortie ou de sortie [SWS_BswM_00152].
Concurrence et traitement des erreurs
La spécification définit BswM_NvM_CurrentJobMode comme synchrone et réentrante [SWS_BswM_00152]. L'appel s'effectue directement depuis le contexte d'exécution du module NvM. À titre d'interprétation, cet appel devrait typiquement être déclenché lors d'opérations collectives telles que des opérations de lecture ou d'écriture dès qu'un changement d'état survient. Question Q-25514d3dbf1d8c5c (ouverte)
Pour cette fonction, la spécification ne consigne aucune valeur de retour ni aucun code d'erreur spécifique pour les erreurs de développement (DET) ou les erreurs de production ; le comportement en cas d'erreur n'est pas documenté séparément [SWS_BswM_00152].
Cette note d'utilisation a été créée de manière automatisée sur la base de la spécification AUTOSAR Classic R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_RequestMode [SWS_BswM_00046] 📄 PDF
void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode);
Generic function call to request modes. This function shall only be used by other BSW modules that does not have a specific mode request interface.
La fonction BswM_RequestMode fournit un appel de fonction générique pour la demande de modes dans le Basic Software Mode Manager (BswM) [SWS_BswM_00046]. Elle est déclarée via le fichier d'en-tête BswM.h et possède l'ID de service 0x02 [SWS_BswM_00046].
Utilisation et restrictions
L'utilisation est strictement réglementée : la fonction doit être appelée exclusivement par d'autres modules BSW qui ne disposent pas de leur propre interface spécifique au module pour la demande de mode [SWS_BswM_00046]. Les modules BSW dotés d'interfaces dédiées ne doivent donc pas utiliser ce service générique.
Paramètres et sémantique
La signature de la fonction est void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode) [SWS_BswM_00046]. Deux paramètres d'entrée sont transmis :
requesting_user: identifie l'utilisateur demandeur ou le module logiciel demandeur [SWS_BswM_00046].requested_mode: transmet l'état ou le mode concrètement demandé [SWS_BswM_00046].
Il n'existe ni paramètre d'entrée/sortie ni paramètre de sortie, et la fonction ne possède aucune valeur de retour (void) [SWS_BswM_00046].
concurrence
L'appel est traité de manière synchrone et est spécifié comme réentrant [SWS_BswM_00046]. La fonction est ainsi adaptée aux appels concurrents provenant de plusieurs contextes BSW.
Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification d'AUTOSAR Classic Release R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Sd_ClientServiceCurrentState [SWS_BswM_00204] 📄 PDF
void BswM_Sd_ClientServiceCurrentState (uint16 SdClientServiceHandleId, Sd_ClientServiceCurrentStateType CurrentClientState);
Function called by Service Discovery to indicate current state of the Client Service (available/ down).
Utilisation et contexte d'appel
La fonction BswM_Sd_ClientServiceCurrentState est appelée par Service Discovery (SD) afin d'informer le BswM de manière synchrone de l'état actuel d'un service client [SWS_BswM_00204]. Cette interface permet de signaler si le service correspondant est opérationnel (available) ou indisponible (down) [SWS_BswM_00204]. La déclaration de la fonction C est fournie via l'en-tête BswM_Sd.h [SWS_BswM_00204].
Paramètres et signature d'interface
L'interface possède l'ID de service 0x1f et attend deux paramètres d'entrée [SWS_BswM_00204] :
SdClientServiceHandleId(typeuint16) : ID de handle unique pour l'identification du service client [SWS_BswM_00204].CurrentClientState(typeSd_ClientServiceCurrentStateType) : état de disponibilité actuel du service [SWS_BswM_00204].
La fonction ne renvoie aucune valeur de retour (void) et ne définit aucun paramètre d'entrée/sortie ou de sortie [SWS_BswM_00204].
Concurrence et interaction
L'exécution de BswM_Sd_ClientServiceCurrentState est synchrone et réentrante [SWS_BswM_00204]. Les appelants ne doivent donc pas imposer de sérialisation séquentielle, mais peuvent notifier les changements d'état de manière concurrente. Dans l'interaction globale, la notification de statut devrait vraisemblablement être utilisée pour l'évaluation interne des règles et l'initiation de changements de mode configurés au sein du BswM. Question Q-0490a3902ca9e78d (ouverte)
Ce texte a été généré par une IA sur la base des données de spécification.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Sd_ConsumedEventGroupCurrentState [SWS_BswM_00207] 📄 PDF
void BswM_Sd_ConsumedEventGroupCurrentState (uint16 SdConsumedEventGroupHandleId, Sd_ConsumedEventGroupCurrentStateType ConsumedEventGroupState);
Function called by Service Discovery to indicate current status of the Consumed Eventgroup (available/ down).
La fonction BswM_Sd_ConsumedEventGroupCurrentState sert d'interface de rappel appelée par Service Discovery pour indiquer au Basic Software Mode Manager (BswM) l'état actuel d'un groupe d'événements consommé [SWS_BswM_00207]. Elle informe le BswM si le groupe d'événements correspondant est disponible (available) ou défaillant (down) sur le réseau [SWS_BswM_00207].
Utilisation et signature
L'interface possède l'ID de service 0x21 et est fournie via le fichier d'en-tête BswM_Sd.h [SWS_BswM_00207]. L'appel est traité de manière synchrone et ne possède aucune valeur de retour (void) [SWS_BswM_00207]. Lors de l'appel de fonction, Service Discovery transmet deux paramètres d'entrée, tandis qu'aucun paramètre d'entrée/sortie ni aucun paramètre de sortie pur n'est défini [SWS_BswM_00207] :
Sd Consumed Event Group Handle Id(type de donnéesuint16) : ID de handle unique pour l'identification du groupe d'événements consommé respectif [SWS_BswM_00207].Consumed Event Group State(type de donnéesSd_Consumed Event Group Current State Type) : état actuel du groupe d'événements consommé pour l'indication de disponibilité [SWS_BswM_00207].
Concurrence et traitement des erreurs
Selon la spécification, la fonction est désignée comme réentrante et peut donc être appelée de manière concurrente si nécessaire [SWS_BswM_00207]. Pour ce service, aucun code d'erreur spécifique, aucune exception ni aucun retour vers le traçage des erreurs de développement (DET) ou la gestion des événements de diagnostic (DEM) ne sont mentionnés dans la spécification [SWS_BswM_00207].
Cette note d'utilisation a été générée de manière automatisée sur la base de la spécification AUTOSAR CP R20-11.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_Sd_EventHandlerCurrentState [SWS_BswM_00210] 📄 PDF
void BswM_Sd_EventHandlerCurrentState (uint16 SdEventHandlerHandleId, Sd_EventHandlerCurrentStateType EventHandlerStatus);
Function called by Service Discovery to indicate current status of the Event Handler (requested/ released).
Utilisation et contexte d'appel
La fonction synchrone BswM_Sd_EventHandlerCurrentState sert d'interface appelée par Service Discovery pour communiquer au BSW Mode Manager (BswM) l'état actuel d'un Event Handler [SWS_BswM_00210]. Les états typiques de l'Event Handler comprennent l'indication précisant si celui-ci a été demandé ou libéré [SWS_BswM_00210]. La déclaration de la fonction est fournie via le fichier d'en-tête BswM_Sd.h [SWS_BswM_00210].
Paramètres et propriétés de signature
La fonction ne renvoie aucune valeur de retour (void) et attend deux paramètres d'entrée lors de son appel [SWS_BswM_00210] :
SdEventHandlerHandleId: identificateur de typeuint16qui adresse de manière univoque l'Event Handler associé [SWS_BswM_00210].EventHandlerStatus: information d'état de typeSd_EventHandlerCurrentStateTypequi représente l'état actuel de l'Event Handler [SWS_BswM_00210].
Concurrence et traitement des erreurs
La fonction est répertoriée sous l'ID de service 0x20 et est, d'après la spécification, de conception réentrante [SWS_BswM_00210]. Aucun code d'erreur spécifique, aucun paramètre d'entrée/sortie ni aucun message d'erreur explicite via le DET ou le DEM ne sont définis pour cette interface [SWS_BswM_00210].
Ce texte a été généré par une IA. Il sert de guide d'orientation et ne remplace pas l'étude de la spécification AUTOSAR.
Guide de l'implémenteur à venir (complexité I1)
fonction BswM_WdgM_RequestPartitionReset [SWS_BswM_00157] 📄 PDF
void BswM_WdgM_RequestPartitionReset (ApplicationType Application);
Function called by Wdg M to request a partition reset.
La fonction BswM_WdgM_RequestPartitionReset est appelée par le Watchdog Manager (WdgM) pour demander au Basic Software Mode Manager (BswM) la réinitialisation d'une partition déterminée [SWS_BswM_00157]. La déclaration de cette interface est mise à disposition via l'en-tête BswM_WdgM.h et est associée à l'ID de service 0x11 [SWS_BswM_00157].
Pour l'utilisation et le contexte d'appel, les dispositions suivantes de la spécification s'appliquent :
- Paramètres : Est transmis en tant que paramètre d'entrée
Applicationde typeApplicationType, qui représente l'identifiant unique de l'OS-Application concernée [SWS_BswM_00157]. Aucun autre paramètre d'entrée ou de sortie n'existe pour cet appel [SWS_BswM_00157]. - Valeur de retour : La fonction ne possède aucune valeur de retour (type de retour
void) [SWS_BswM_00157]. - Synchronisme et concurrence : L'exécution de la fonction s'effectue de manière synchrone et est spécifiée comme réentrante, ce qui rend admissibles les appels parallèles [SWS_BswM_00157].
- Traitement des erreurs : Les codes d'erreur spécifiques, les réactions aux erreurs ainsi que les notifications vers DET ou DEM ne sont pas documentés dans la spécification de cet élément [SWS_BswM_00157].
Dans l'interaction des modules du logiciel de base (Basic Software), la fonction constitue l'interface de notification directe par laquelle le WdgM informe de façon synchrone le BswM d'une réinitialisation de partition requise pour l'OS-Application transmise [SWS_BswM_00157].
Ce texte a été rédigé par une IA ; les directives exigent une vérification par rapport à la spécification.
fonction BswM_MainFunction [SWS_BswM_00053] 📄 PDF
void BswM_MainFunction (void);
Main function of the Bsw M
La fonction BswM_MainFunction constitue la fonction principale périodique centrale du gestionnaire de modes du BSW (BswM) ([SWS_BswM_00053]). Elle possède l'ID de service 0x03, ne prend aucun paramètre et ne renvoie aucune valeur de retour (signature : void BswM_MainFunction(void)). Sa déclaration est fournie via le fichier d'en-tête SchM_BswM.h ([SWS_BswM_00053]). En raison de sa mise à disposition par SchM_BswM.h, son appel dans le calculateur devrait typiquement être effectué de manière cyclique par le Schedule Manager (SchM) dans le contexte d'une tâche périodique du système d'exploitation. Question Q-fdb948e42c35d9fb (ouverte)
En ce qui concerne l'interaction et la logique de traitement, BswM_MainFunction est responsable de l'évaluation des demandes de mode différées : la fonction doit impérativement évaluer toutes les règles qui utilisent comme entrée au moins une demande de mode (Mode Request) avec le paramètre de configuration BswMRequestProcessing réglé sur la valeur BSWM_DEFERRED ([SWS_BswM_00075]).
Pour l'intégration pratique dans le système de Basic Software, il en découle les conditions aux limites suivantes :
- Contexte d'appel et ordonnancement : la fonction ne possède ni paramètres ni valeurs de retour ([SWS_BswM_00053]) ; elle est prévue pour une intégration récurrente dans l'échéancier cyclique du planificateur de Basic Software.
- Traitement des règles : les demandes de mode qui ne sont pas traitées immédiatement, mais sont configurées sur
BSWM_DEFERRED, sont découplées dans le temps et ne sont traitées de manière groupée que lors du cycle d'exécution de cette fonction principale ([SWS_BswM_00075]).
Ce texte a été généré par une IA sur la base de la spécification.
Guide de l'implémenteur à venir (complexité I1)
fonction <BswMUserCalloutFunction> [SWS_BswM_00270] 📄 PDF
void <BswMUserCalloutFunction> (implementation_specific -);
Function called by the Bsw M when a Bsw MUser Callout is executed. The function name and all function parameters are defined b y the Bsw MUser Callout Function configuration parameter. Any return values are ignored by the Bsw M.
Utilisation
La fonction de callout définie par l'utilisateur est appelée par le BSW Mode Manager dès qu'une action BswMUserCallout correspondante est exécutée [SWS_BswM_00270]. Le nom concret de la fonction ainsi que l'ensemble des paramètres de transmission sont définis par le paramètre de configuration BswMUserCalloutFunction [SWS_BswM_00270]. La syntaxe est définie de manière générique sous la forme void <BswMUserCalloutFunction>(implementation_specific), les éventuelles valeurs de retour étant totalement ignorées par le BswM [SWS_BswM_00270].
Concurrence et restrictions
Tant le comportement d'exécution (synchrone ou asynchrone) que la réentrance de la fonction de callout sont spécifiés comme dépendant de la configuration [SWS_BswM_00270]. Le contexte d'appel réel dépend vraisemblablement de l'événement BswM déclencheur ou de la tâche dans laquelle l'action du BswM est traitée. Les développeurs doivent donc s'assurer que l'implémentation répond aux exigences du contexte d'exécution choisi concernant la sécurité des threads et le comportement de blocage. Question Q-2f3e2cdbb9de1794 (ouverte)
Gestion des erreurs et configuration
La spécification ne définit aucun message d'erreur DET ou DEM spécifique pour ce service (ID de service 0x25) [SWS_BswM_00270]. Le BswM ignorant les éventuelles valeurs de retour, la fonction ne peut pas signaler d'erreurs au BswM par le biais de valeurs de retour standardisées. La disponibilité et la liaison de la fonction s'effectuent via la configuration du module (référence ECUC_BswM_00954) [SWS_BswM_00270].
Cette note d'utilisation a été générée automatiquement et repose sur les exigences de la spécification AUTOSAR.
type BswM_ConfigType [SWS_BswM_00213] 📄 PDF
This structure contains all post - build configurable parameters of the BSW Mode AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager Manager. A pointer to this structure is passed to the BSW Mode Manager initialization function for configuration.
type BswM_ModeType [SWS_BswM_00214] 📄 PDF
This type identifies the modes that can be requested by Bsw M Users.
Utilisation et définition de type
Le type de données BswM_ModeType sert, dans le module BswM, à identifier de manière univoque les modes pouvant être demandés par des utilisateurs du BswM (BswM Users) [SWS_BswM_00214]. Selon la spécification, le type est dérivé du type de base primitif uint16 et comprend une plage de valeurs allant de 0 à 65535 [SWS_BswM_00214]. Il est déclaré et mis à disposition via le fichier d'en-tête BswM.h, qui doit être inclus par les composants demandeurs pour son utilisation [SWS_BswM_00214].
Restrictions et hypothèses
Les entités logicielles appelantes transmettent les valeurs de mode sous forme d'entier 16 bits dans les limites de 0 à 65535 [SWS_BswM_00214]. La spécification n'énumérant pas de constantes symboliques fixes, l'attribution concrète de valeurs entières individuelles à des modes spécifiques à l'application devrait vraisemblablement être définie dans le cadre de la configuration du module BswM. Question Q-94530792144d42ea (ouverte) Pour une utilisation sans erreur, il convient de s'assurer que les demandeurs n'emploient que des valeurs situées dans la plage de valeurs définie [SWS_BswM_00214].
Intégration dans la pile BSW
Les interfaces qui transmettent des demandes de mode d'utilisateurs au BswM utilisent BswM_ModeType pour la transmission typée des identificateurs de mode [SWS_BswM_00214]. La mise à disposition via BswM.h garantit ainsi un typage homogène au-delà des différentes frontières des modules BSW [SWS_BswM_00214].
Ce texte a été créé par un système de documentation assisté par IA et repose sur la spécification AUTOSAR Classic R20-11.
Guide de l'implémenteur à venir (complexité I1)
type BswM_UserType [SWS_BswM_00216] 📄 PDF
This type identifies a Bsw M User that makes mode requests to the Bsw M.
Utilisation et définition de type
Le type de données BswM_UserType est fourni via le fichier d'en-tête BswM.h et sert à l'identification univoque d'un utilisateur du BswM qui adresse des demandes de mode au Basic Software Mode Manager [SWS_BswM_00216]. Le type est dérivé du type entier de base uint16 et comprend une plage de valeurs allant de 0 à 65535 [SWS_BswM_00216].
Interaction et intégration
Dans l'architecture logicielle, ce type devrait principalement faire office de paramètre de transmission dans les interfaces de demande de mode afin que le BswM puisse associer la demande entrante à la source respective. Question Q-83bb1af3fb090e7e (ouverte) Grâce à sa largeur de 16 bits, la définition de type offre de l'espace pour jusqu'à 65536 identificateurs d'utilisateurs différents dans le système [SWS_BswM_00216]. Les valeurs d'instance concrètes des utilisateurs sont alors vraisemblablement générées en fonction de la configuration lors de la génération du BSW.
Restrictions et traitement des erreurs
S'agissant d'une définition de type élémentaire, aucun code d'erreur spécifique, message DET ou mécanisme de concurrence n'est consigné pour ce type dans le périmètre de la spécification. Les modules logiciels demandeurs doivent s'assurer que, lors des appels, seules des valeurs comprises dans la plage autorisée de 0 à 65535 sont transmises [SWS_BswM_00216].
Cette note d'utilisation a été générée par une IA et repose exclusivement sur l'élément de spécification SWS_BswM_00216 d'AUTOSAR R20-11.
Guide de l'implémenteur à venir (complexité I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_BswM- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_BswM@rel:R20-11#89340210- Content hash
89340210- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_BSWModeManager.pdf#nameddest=SWS_BswM_00193
gemini-3.8-flash-low· 2026-10-13 · Original allemand