Communication Manager (ComM)
Manages communication states and channel modes across multiple network interfaces.
Funktionen — Übersicht
void ComM_Init (const ComM_ConfigType* ConfigPtr);Initializes the AUTOSAR Communication Manager and restarts the internal state machines.void ComM_DeInit (void);This API de - initializes the AUTOSAR Communication Manager.Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);Returns the initialization status of the AUTOSAR Communication Manager.Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);Returns the inhibition status of a Com M channel.Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);Requesting of a Communication Mode by a user.Std_ReturnType ComM_GetMax ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode); ⚠️Function t o query the maximum allowed Communication Mode of the corresponding user.Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the currently requested Communication Mode of the corresponding user.Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the current Communication Mode.Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);This function returns the current configuration of the ECUs PNC - to -Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);This function can be used to set entries within the the ECUs PNC - to - channel -Std_ReturnType ComM_ResetPncToChannelMapping (void);This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Std_ReturnType ComM_PnLearningRequest (void);Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving...Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning.Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode.Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication...Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.Std_ReturnType ComM_ResetInhibitCounter (void);This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);Changes the ECU Group Classification status (see chapter 10.void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);This function returns the published information (for details refer to table 10.void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have...void ComM_Nm_NetworkMode (NetworkHandleType Channel);Notification that the network management has entered Network Mode.void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Prepare Bus - Sleep Mode.void ComM_Nm_BusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Bus - Sleep Mode.void ComM_Nm_RestartIndication (NetworkHandleType Channel);If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND...void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);Notification that the state of all has left Repeat Message.void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);Service to indicate that an NM message with set PNC Learning Bit has been received.void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a Nm, then Com M is immediately...void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);Indication of active diagnostic by the DCM.void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);Indication of inactive diagnostic by the DCM.void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);Notification of a wake up on the corresponding channel.void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);Notification of a wake up on the corresponding partial network cluster.void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);Ecu M or Bsw M shall indicate to Com M when communication is allowed.void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);Indication of the actual bus mode by the corresponding Bus State Manager.void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep.
Typen — Übersicht
enum ComM_InitStatusTypeInitialization status of Com M.enum ComM_PncModeTypeCurrent mode of a PNCenum ComM_StateTypeState and sub - state of Com M state machine Com M states vs.struct ComM_ConfigTypeThis type contains the implementation - specific post build configuration structure.enum ComM_ModeTypeCurrent mode of the Communication Manager (main state of the state machine).ComM_UserHandleTypeHandle to identify a user.ComM_UserHandleArrayTypenumber Of Requesters contains the number of valid user handle entries in the "handle Array" member.ComM_UserHandleSubArrayTypeThis element contains the user handles of the users which keep the channel requested (if any), starting in its first entries.ComM_PncMembershipTypeArray of uint8 with Elements that holds the current PNC Membership of the node.modeLimitation-ComMMode-
Funktionen & Typen — Detailansicht
función ComM_Init [SWS_ComM_00146] 📄 PDF
void ComM_Init (const ComM_ConfigType* ConfigPtr);
Initializes the AUTOSAR Communication Manager and restarts the internal state machines.
La función síncrona ComM_Init (Service-ID 0x01) sirve para la inicialización básica del AUTOSAR Communication Manager y reinicia sus máquinas de estados internas [SWS_ComM_00146]. Como parámetro de entrada toma ConfigPtr, que se pasa como puntero a la estructura de configuración post-build de tipo const ComM_ConfigType* [SWS_ComM_00146]. La función no devuelve ningún valor (tipo de retorno void) y se declara a través del archivo de cabecera ComM.h [SWS_ComM_00146].
En cuanto a la concurrencia, ComM_Init se define como no reentrante (Non Reentrant) [SWS_ComM_00146]. En los datos de especificación no se especifica un invocador concreto; probablemente la llamada se realice de forma centralizada durante la fase de inicio de la ECU en el marco de la inicialización de la BSW. Pregunta Q-7121f73c12407087 (abierta)
En el sistema global, ComM_Init posee una función central de control y precondición para todo el módulo: mientras el módulo ComM no se haya inicializado, todos los servicios de módulo y API no deben iniciar su funcionamiento regular y, en el caso de servicios con tipo de retorno estándar, deben devolver E_NOT_OK [SWS_ComM_00612]. La única excepción a este bloqueo se aplica exclusivamente a ComM_Init y a las funciones de consulta ComM_GetVersionInfo y ComM_GetStatus [SWS_ComM_00612].
Esta nota de uso se ha generado automáticamente a partir de los datos de especificación de AUTOSAR.
Guía del implementador pendiente (complejidad I1)
función ComM_DeInit [SWS_ComM_00147] 📄 PDF
void ComM_DeInit (void);
This API de - initializes the AUTOSAR Communication Manager.
usar
Según [SWS_ComM_00147], la función ComM_DeInit sirve para la desinicialización del AUTOSAR Communication Manager (ComM). El servicio está diseñado de forma síncrona, tiene el Service-ID 0x02 y se declara a través del archivo de cabecera ComM.h. Según la signatura void ComM_DeInit(void), la función no acepta ningún parámetro de entrada, salida o paso, y no devuelve ningún valor al invocador [SWS_ComM_00147].
Manejo de errores
Dado que la signatura de la función devuelve void, no se produce ninguna notificación directa de códigos de error o de estado a través de la llamada a la interfaz [SWS_ComM_00147]. Las respuestas a errores específicas, como la notificación al Development Error Tracer (DET) o al Diagnostic Event Manager (DEM), no están incluidas en los datos de especificación presentes y, por lo tanto, no se indican.
Concurrencia y contexto del sistema
Según [SWS_ComM_00147], la interfaz se especifica como no reentrante (Non Reentrant). De ello se deriva el requisito imperativo para la integración del sistema de inhibir por completo las llamadas paralelas o interruptivas desde múltiples tareas o contextos. Como interpretación del flujo del sistema, la llamada debería realizarse típicamente en el curso del shutdown ordenado de la ECU por parte de una gestión de estados de nivel superior (como el BSW Manager), tan pronto como los canales de comunicación de la BSW se hayan detenido. Pregunta Q-f3b68dc129993cb7 (abierta)
Esta nota de uso se ha generado automáticamente a partir de la especificación SWS_ComM_00147.
función ComM_GetStatus [SWS_ComM_00242] 📄 PDF
Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);
Returns the initialization status of the AUTOSAR Communication Manager. After a call to Com M_ De Init() Com M should have status COMM_ UNINIT, and a new call to Com M_ Init needed to make sur e Com M restart internal state machines to defailt values.
función ComM_GetInhibitionStatus [SWS_ComM_00619] 📄 PDF
Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);
Returns the inhibition status of a Com M channel.
función ComM_RequestComMode [SWS_ComM_00110] 📄 PDF
Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);
Requesting of a Communication Mode by a user. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Note: The following modes are no vaild user requests, since they are used as internal modes: - COMM_ SIL ENT_ COMMUNICATION (this mode is used for synchronization at shutdown) - COMM_ FULL_ COMMUNICATION_ WITH_ WAKEUP_ REQUEST (this mode is used internally within the Com M channel statemachine to trigger the lower layers to request a wakeup on the network if the used hardware support such a feature. (e.g. Ethernet hardware which is compatible with OA TC10). The following modes are valid user requests: - COMM_ NO_ COMMUNICATION - COMM_ FULL_ COMMUNICATION. The communication request could also be released due to
Uso y contexto de llamada
La función síncrona y reentrante ComM_RequestComMode ([SWS_ComM_00110]) sirve para solicitar un modo de comunicación para un usuario definido (User). Está disponible a través de ComM.h. Como parámetros de transferencia para ComMode solo se permiten los siguientes valores como solicitud de usuario:
COMM_FULL_COMMUNICATION: Solicitud de capacidad de comunicación completa ([SWS_ComM_00110]).COMM_NO_COMMUNICATION: Liberación o finalización de la solicitud de comunicación ([SWS_ComM_00110]).
Los modos COMM_SILENT_COMMUNICATION (sirve para la sincronización de shutdown) y COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (disparador interno de wake-up para capas inferiores, p. ej. en hardware de Ethernet compatible con OA TC10) son estados internos y los usuarios no deben solicitarlos ([SWS_ComM_00110]). Interpretación: es probable que la transferencia de estos modos internos se confirme con E_NOT_OK. Pregunta Q-973ed1ce1845983e (abierta)
Valores de retorno y tratamiento de errores
La función señaliza el resultado a través de valores de retorno definidos ([SWS_ComM_00110]):
E_OK: El cambio al modo de comunicación deseado se ha llevado a cabo con éxito.E_NOT_OK: El cambio de modo ha fallado.COMM_E_MODE_LIMITATION: El modo solicitado no se puede conceder debido a una limitación de comunicación activa (Mode Inhibition). Las solicitudes de comunicación también se pueden liberar de nuevo mediante tales limitaciones.
Interacción y máquina de estados
La presencia o ausencia de solicitudes activas influye en la máquina de estados de canal del ComM. Si el canal se encuentra en el subestado COMM_FULL_COM_NETWORK_REQUESTED con la configuración ComMNmVariant = SLAVE_ACTIVE y no existe ninguna llamada activa a ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION), la máquina de estados del ComM cambia al subestado COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).
Este texto fue generado por un sistema de documentación asistido por IA basado en la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_GetMaxComMode [SWS_ComM_00085] 📄 PDF
Std_ReturnType ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function t o query the maximum allowed Communication Mode of the corresponding user.
función ComM_GetRequestedComMode [SWS_ComM_00079] 📄 PDF
Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the currently requested Communication Mode of the corresponding user. Availa ble via Com M.h
función ComM_GetCurrentComMode [SWS_ComM_00083] 📄 PDF
Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the current Communication Mode. Com M shall use the corresponding interfaces of the Bus State Managers to get the current Communication Mode of the network. (Call to Bus State Manager API: XXXSM _ Get Current Com Mode(...))
función ComM_GetCurrentPNCComMode [SWS_ComM_91002] 📄 PDF
Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.
función ComM_GetPncToChannelMapping [SWS_ComM_91013] 📄 PDF
Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);
This function returns the current configuration of the ECUs PNC - to -
función ComM_UpdatePncToChannelMapping [SWS_ComM_91015] 📄 PDF
Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);
This function can be used to set entries within the the ECUs PNC - to - channel -
La función síncrona ComM_UpdatePncToChannelMapping con el ID de servicio 0x62 sirve para establecer entradas en la asignación de PNC a canales de la ECU o del PNC-Gateway [SWS_ComM_91015]. La interfaz está disponible a través del archivo de cabecera ComM.h y está identificada con el estado Draft en el Release R20-11 [SWS_ComM_91015].
parámetro
A la llamada a la función se le transfieren tres parámetros de entrada [SWS_ComM_91015]:
MappingTable: Puntero a un array bidimensional deboolean(const boolean*) que contiene la asignación actual de PNC a canales del PNC-Gateway, donde la primera dimensión cubre todos los canales relevantes y la segunda dimensión cubre todos los PNC relevantes [SWS_ComM_91015].channelCnt: Número de canales físicos transferidos en elMappingTable[SWS_ComM_91015].PncCnt: Número de PNC transferidos en elMappingTable[SWS_ComM_91015].
Valores de retorno y tratamiento de errores
La función devuelve un valor de estado del tipo Std_ReturnType [SWS_ComM_91015]:
E_OK: La entrada de asignación se ha establecido correctamente [SWS_ComM_91015].E_NOT_OK: Ha fallado el establecimiento de la entrada de asignación [SWS_ComM_91015].COMM_E_LEARNING_ACTIVE: La llamada no puede ejecutarse porque la fase de aprendizaje de PNC está activa [SWS_ComM_91015].
Concurrencia y restricciones
La interfaz está definida como no reentrante [SWS_ComM_91015]. Por tanto, las llamadas no deben realizarse de forma concurrente. Además, se excluye una actualización mientras el sistema de comunicación se encuentre en la fase de aprendizaje de PNC activa [SWS_ComM_91015].
Esta nota de uso se ha generado automáticamente sobre la base de la especificación AUTOSAR CP R20-11.
función ComM_ResetPncToChannelMapping [SWS_ComM_91017] 📄 PDF
Std_ReturnType ComM_ResetPncToChannelMapping (void);
This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Status=draft
La función síncrona y no reentrante ComM_ResetPncToChannelMapping sirve para restablecer las entradas dinámicas del mapeo de PNC a canales de la ECU a los valores predeterminados configurados [SWS_ComM_91017]. No recibe parámetros de entrada y devuelve un valor de estado de tipo Std_ReturnType [SWS_ComM_91017].
Comportamiento y valores de retorno
El comportamiento de la función depende del estado de la fase de aprendizaje de PNC, así como de la configuración de los canales:
- Si para al menos un canal está habilitado
ComMDynamicPncToChannelMappingEnabledy la fase de aprendizaje de PNC no está activa, la función restablece las asignaciones a los valores predeterminados de la configuración original (entradas estáticas) y devuelveE_OK[SWS_ComM_01043]. - Si el sistema se encuentra en una fase de aprendizaje de PNC activa y para al menos un canal
ComMDynamicPncToChannelMappingEnabledoComMDynamicPncToChannelMappingSupportestá establecido enTRUE, se deniega el restablecimiento y se devuelveCOMM_E_LEARNING_ACTIVE[SWS_ComM_01042], [SWS_ComM_01045]. - Si falla el restablecimiento de las asignaciones a los valores predeterminados, la función devuelve
E_NOT_OK[SWS_ComM_91017].
Restricciones y condiciones de llamada
Dado que ComM_ResetPncToChannelMapping está especificada como no reentrante (Non Reentrant), no deben producirse llamadas simultáneas desde contextos concurrentes [SWS_ComM_91017]. Además, la interfaz se encuentra en estado Draft [SWS_ComM_91017].
Este texto ha sido generado por una IA y se basa exclusivamente en los datos de especificación de AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_PnLearningRequest [SWS_ComM_91019] 📄 PDF
Std_ReturnType ComM_PnLearningRequest (void);
Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving nodes to respond) together with the Repeat Message Request Bit (in order for receiving nodes to return into NM Repeat Message State). This function is used for the optional Dynamic PNC - to - channel - mapping feature. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Tags: atp.Status=draft
Uso y semántica
La función asíncrona ComM_PnLearningRequest inicia el mapeo dinámico de PNC a canales opcional (Dynamic PNC-to-channel-mapping) [SWS_ComM_91019]. Hace que Network Management (NM) regrese al estado NM Repeat Message State [SWS_ComM_91019]. Para ello, se envían el Partial Network Learning Bit, para que los nodos receptores respondan, y el Repeat Message Request Bit, para que los nodos receptores también cambien al estado NM Repeat Message State [SWS_ComM_91019]. La llamada se realiza sin parámetros de entrada a través de la interfaz en ComM.h con el ID de servicio 0x64 [SWS_ComM_91019].
Valores de retorno y tratamiento de errores
La función devuelve un valor de estado de tipo Std_ReturnType [SWS_ComM_91019]:
E_OK: El algoritmo de aprendizaje de PNC se ha iniciado correctamente [SWS_ComM_91019].E_NOT_OK: No se pudo iniciar el algoritmo de aprendizaje de PNC [SWS_ComM_91019].COMM_E_LEARNING_ACTIVE: La llamada a la función no puede ejecutarse porque la fase de aprendizaje de PNC ya está activa [SWS_ComM_91019].
Concurrencia y configuración
La función está especificada como no reentrante (Non Reentrant) y posee el estado draft [SWS_ComM_91019]. Solo está disponible si el parámetro de preconfiguración ComMDynamicPncToChannelMappingSupport está establecido en TRUE [SWS_ComM_01044].
Esta nota de uso se basa en la especificación de AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I2)
función ComM_UpdatePncMembership [SWS_ComM_91021] 📄 PDF
Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);
This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning. This function is used for the optional Dynamic PNC - to - channel - mapping feature. This function is used for the optional Dynamic PNC - to - channel - mapping feature. Tags: atp.Status=draft
Las Software-Components (SWC) utilizan la función síncrona y no reentrante ComM_UpdatePncMembership para adaptar la pertenencia a PNC transmitida durante el PNC-Learning para el mapeo dinámico de PNC a canales opcional [SWS_ComM_91021]. Solo está disponible a través de la cabecera ComM.h si el parámetro de configuración ComMDynamicPncToChannelMappingSupport está establecido en TRUE [SWS_ComM_01047].
A través del parámetro ComM_PncMembership se transfiere un array de bytes con la longitud del vector de PNC que contiene la pertenencia actual al PNC del nodo [SWS_ComM_91021]. Si la función está habilitada en al menos un canal y la fase de aprendizaje de PNC está inactiva, se evalúa el parámetro Control [SWS_ComM_01049]:
-
En caso de
Control = 0, la pertenencia actual al PNC se opera mediante una operación lógica AND conComM_PncMembershippara restablecer de forma selectiva los bits correspondientes en la máscara [SWS_ComM_01049]. -
En caso de
Control = 1, se aplica una operación lógica OR para establecer bits en la máscara [SWS_ComM_01049].
Si la actualización se realizó correctamente, la función devuelve E_OK [SWS_ComM_01049]. Si, por el contrario, la asignación dinámica está configurada en al menos un canal y la fase de aprendizaje de PNC está activa, se deniega la ejecución y se notifica el valor de error específico COMM_E_LEARNING_ACTIVE [SWS_ComM_01048]. Si ocurre otro error durante el proceso de actualización, se devuelve E_NOT_OK [SWS_ComM_91021].
Esta nota de uso ha sido generada por una IA y se basa exclusivamente en las prescripciones de especificación de AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_PreventWakeUp [SWS_ComM_00156] 📄 PDF
Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);
Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.
Uso y contexto de llamada
Según [SWS_ComM_00156], la función ComM_PreventWakeUp sirve para modificar el estado de inhibición COMM_NO_WAKEUP para un canal de comunicación determinado. Se ejecuta de forma síncrona y está disponible a través del archivo de cabecera ComM.h.
En la llamada se pasan dos parámetros de entrada:
Channel: Identifica el canal correspondiente según el tipoNetworkHandleType([SWS_ComM_00156]).Status: Un valor booleano con el que se activa (TRUE) o desactiva (FALSE) la inhibición del despertar ([SWS_ComM_00156]).
Valores de retorno y tratamiento de errores
Como valor de retorno, la función proporciona el estado Std_ReturnType según [SWS_ComM_00156]:
E_OK: El estado de despertar para el canal especificado se ha actualizado correctamente.E_NOT_OK: El cambio del estado de despertar ha fallado, por ejemplo, si la funcionalidad está desactivada a través de la clasificación de grupos de ECU (ComMEcuGroupClassification).
Concurrencia y restricciones
La interfaz está especificada como no reentrante (Non Reentrant) ([SWS_ComM_00156]). Por lo tanto, los invocadores deben asegurarse de evitar llamadas paralelas para la misma instancia.
Esta nota ha sido generada por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_LimitChannelToNoComMode [SWS_ComM_00163] 📄 PDF
Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);
Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode. (See also Com M_ Limit ECUTo No Com Mode, same functionality but for all channels)
La función síncrona ComM_LimitChannelToNoComMode con el Service-ID 0x0b sirve en el Communication Manager para establecer el estado de inhibición para un canal de comunicación individual [SWS_ComM_00163]. Impide o permite la transición del canal del estado COMM_NO_COMMUNICATION a un modo de comunicación superior [SWS_ComM_00163].
Parámetros y contexto de llamada
La interfaz se declara a través del archivo de cabecera ComM.h y no posee parámetros de entrada/salida ni exclusivamente de salida [SWS_ComM_00163]. En la llamada se pasan dos parámetros de entrada [SWS_ComM_00163]:
Channel: Direcciona el canal respectivo mediante el identificador de tipoNetworkHandleType[SWS_ComM_00163].Status: Determina comobooleanel estado de inhibición deseado. El paso deTRUEactiva la limitación del canal aCOMM_NO_COMMUNICATION, mientras queFALSEvuelve a desactivar esta limitación [SWS_ComM_00163].
Valores de retorno y tratamiento de errores
La función devuelve al invocador un valor del tipo Std_ReturnType [SWS_ComM_00163]:
E_OK: El estado de inhibición para el canal direccionado se ha adaptado correctamente [SWS_ComM_00163].E_NOT_OK: No se ha podido llevar a cabo el cambio de estado, lo que ocurre, por ejemplo, si la configuraciónComMEcuGroupClassification(véaseECUC_ComM_00563) desactiva la funcionalidad [SWS_ComM_00163].
Concurrencia y relación con el sistema
En cuanto al comportamiento de ejecución, la función se ejecuta de forma síncrona (Synchronous) y no reentrante (Non Reentrant) [SWS_ComM_00163]. Para el mismo propósito a nivel del sistema global existe la función relacionada ComM_LimitECUToNoComMode, que implementa la misma limitación no solo por canal, sino de manera uniforme para todos los canales de la ECU [SWS_ComM_00163].
Esta nota de uso se generó de forma automatizada sobre la base de la especificación.
Guía del implementador pendiente (complejidad I1)
función ComM_LimitECUToNoComMode [SWS_ComM_00124] 📄 PDF
Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);
Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication Mode. (See also Com M_ Limit Channel To No Com Mode, same functionality but for a specific channels)
usar
La función síncrona ComM_LimitECUToNoComMode (Service-ID 0x0c) está definida en ComM.h y sirve para cambiar el estado de inhibición para toda la ECU [SWS_ComM_00124]. Impide o permite el cambio de COMM_NO_COMMUNICATION a un modo de comunicación superior para todos los canales de comunicación de la ECU [SWS_ComM_00124]. El control se realiza a través del parámetro formal Status:
TRUE: Activa la limitación de la ECU al modoCOMM_NO_COMMUNICATION[SWS_ComM_00124].FALSE: Vuelve a desactivar la limitación de la ECU aCOMM_NO_COMMUNICATION[SWS_ComM_00124].
Tratamiento de errores y valores de retorno
La función devuelve un código de estado del tipo Std_ReturnType al invocador [SWS_ComM_00124]:
E_OK: El estado de inhibición para la ECU se ha adoptado con éxito [SWS_ComM_00124].E_NOT_OK: La modificación del estado de inhibición ha fallado, por ejemplo, si el parámetro de configuraciónComMEcuGroupClassification(véaseECUC_ComM_00563) desactiva la funcionalidad [SWS_ComM_00124].
Un invocador debe evaluar el valor de retorno para detectar si la limitación se pudo activar de forma efectiva o si fue rechazada por la configuración del módulo [SWS_ComM_00124].
Concurrencia e interacción
La interfaz está declarada como no reentrante (Non Reentrant); por lo tanto, las llamadas paralelas o que provoquen interrupción no están permitidas y deben evitarse por parte del invocador [SWS_ComM_00124]. Mientras que ComM_LimitChannelToNoComMode proporciona la misma funcionalidad de control de forma aislada para un solo canal, ComM_LimitECUToNoComMode afecta siempre a la totalidad de todos los canales de la ECU [SWS_ComM_00124].
Esta nota de uso se generó automáticamente a partir de AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_ReadInhibitCounter [SWS_ComM_00224] 📄 PDF
Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);
This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.
Uso y contexto de llamada
La función síncrona ComM_ReadInhibitCounter (Service-ID 0x0d) sirve para consultar el número de solicitudes de usuario rechazadas para el funcionamiento de comunicación completa (COMM_FULL_COMMUNICATION) [SWS_ComM_00224]. La declaración de la función se proporciona a través del archivo de cabecera ComM.h [SWS_ComM_00224].
La función no posee parámetros de entrada. Como único parámetro de salida sirve el puntero CounterValue del tipo base uint16*, a través del cual se transmite al invocador el valor del contador de solicitudes rechazadas [SWS_ComM_00224]. Si el valor del contador se ha podido determinar y escribir correctamente, la función devuelve E_OK; en caso de fallo, devuelve E_NOT_OK [SWS_ComM_00224].
Manejo de errores
Los códigos de error específicos o los errores de desarrollo estandarizados (DET) no se detallan por separado en la descripción de la interfaz. Un fallo con el valor de retorno E_NOT_OK [SWS_ComM_00224] probablemente se deba a un parámetro de puntero no válido (puntero nulo) o a una llamada previa a la inicialización del módulo ComM (interpretación). Pregunta Q-5779d898381d9894 (abierta)
Concurrencia y restricciones
La interfaz se especifica explícitamente como no reentrante (Non Reentrant) [SWS_ComM_00224]. Por lo tanto, los invocadores deben garantizar a nivel de sistema que no se produzcan llamadas concurrentes o interruptivas a través de diferentes tareas o rutinas de servicio de interrupción, a fin de evitar inconsistencias al leer el contador.
Esta nota de uso se ha generado automáticamente y se basa en las especificaciones de la versión R20-11 de AUTOSAR.
función ComM_ResetInhibitCounter [SWS_ComM_00108] 📄 PDF
Std_ReturnType ComM_ResetInhibitCounter (void);
This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.
Uso y funcionamiento
La interfaz síncrona ComM_ResetInhibitCounter sirve para restablecer en el Communication Manager el contador interno de solicitudes de comunicación completa rechazadas o impedidas (Inhibited COMM_FULL_COMMUNICATION request Counter) [SWS_ComM_00108]. La llamada se proporciona a través de la cabecera ComM.h, posee el ID de servicio 0x0e y no requiere parámetros de transferencia [SWS_ComM_00108]. Si la ejecución tiene éxito, la función proporciona el valor de retorno E_OK de tipo Std_ReturnType [SWS_ComM_00108].
Tratamiento de errores y condiciones límite
Si se produce un error al restablecer el contador, el servicio lo señala mediante el valor de retorno E_NOT_OK [SWS_ComM_00108]. En el presente extracto de la especificación no se indican errores de desarrollo (DET) o escenarios de error concretos; probablemente la ejecución falla y proporciona E_NOT_OK si el módulo aún no se ha inicializado. Pregunta Q-31d1ba95e419fa8e (abierta)
concurrencia
La función está declarada como no reentrante (Non Reentrant) [SWS_ComM_00108]. Por tanto, los usuarios deben asegurarse mediante una sincronización adecuada de que no se produzcan llamadas paralelas desde varios hilos, tareas o rutinas de servicio de interrupción, a fin de evitar inconsistencias en el contador.
Este texto ha sido generado por una IA a partir de la especificación de AUTOSAR.
función ComM_SetECUGroupClassification [SWS_ComM_00552] 📄 PDF
Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);
Changes the ECU Group Classification status (see chapter 10.2.2)
función ComM_GetVersionInfo [SWS_ComM_00370] 📄 PDF
void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);
This function returns the published information (for details refer to table 10.3)
función ComM_Nm_NetworkStartIndication [SWS_ComM_00383] 📄 PDF
void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);
Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have already entered the Network Mode.
La función ComM_Nm_NetworkStartIndication sirve como interfaz de notificación de la gestión de red al Communication Manager. Conforme a [SWS_ComM_00383], indica que se ha recibido un mensaje NM durante el estado Bus Sleep Mode, lo que señala que determinados nodos de la red ya han cambiado al Network Mode.
- Invocación y parámetros: La interfaz se declara mediante la cabecera
ComM_Nm.hy recibe como parámetro de entrada el canal de comunicación afectadoChannelde tipoNetworkHandleType[SWS_ComM_00383]. - Sincronía y retorno: La llamada no tiene valor de retorno (
void) y sigue una semántica de ejecución asíncrona [SWS_ComM_00383]. - Concurrencia: La función cuenta con el ID de servicio
0x15y está especificada como reentrante (Reentrant) [SWS_ComM_00383].
Para esta interfaz no se indican en la especificación códigos de error específicos, mensajes DET o DEM ni reacciones de error particulares [SWS_ComM_00383]. Interpretación: Probablemente la indicación esté destinada internamente a iniciar la transición desde el estado de reposo hacia la comunicación de red activa para el canal indicado. Pregunta Q-97a02db4ab6a3af8 (abierta)
Esta nota de uso se basa exclusivamente en los datos de especificación del release R20-11 de AUTOSAR.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_NetworkMode [SWS_ComM_00390] 📄 PDF
void ComM_Nm_NetworkMode (NetworkHandleType Channel);
Notification that the network management has entered Network Mode.
La función ComM_Nm_NetworkMode actúa en el Communication Manager de AUTOSAR (ComM) como callback de notificación con el que la gestión de red (Nm) señala que se ha adoptado con éxito el modo de red (Network Mode) [SWS_ComM_00390].
Invocación y parámetros
La interfaz está disponible a través del archivo de cabecera ComM_Nm.h y posee el ID de servicio 0x18 [SWS_ComM_00390]. En la llamada, a través del único parámetro de entrada Channel de tipo NetworkHandleType se transfiere el canal de comunicación afectado [SWS_ComM_00390]. La función no devuelve ningún valor de retorno (tipo de retorno void) y no dispone de parámetros de salida [SWS_ComM_00390].
Concurrencia y semántica
El comportamiento de ejecución de ComM_Nm_NetworkMode está declarado como asíncrono (Asynchronous) [SWS_ComM_00390]. En relación con la concurrencia, la función está especificada como reentrante (Reentrant), de modo que puede llamarse de forma reentrante para eventos de canal paralelos [SWS_ComM_00390].
Manejo de errores
Dado que la firma no prevé ningún valor de retorno, no se transmiten códigos de error directamente a quien llama [SWS_ComM_00390].
Este texto ha sido generado por una IA y sirve para la orientación técnica.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_PrepareBusSleepMode [SWS_ComM_00391] 📄 PDF
void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Prepare Bus - Sleep Mode.
La función ComM_Nm_PrepareBusSleepMode sirve como interfaz de notificación del Communication Manager (ComM). Informa al ComM de que la gestión de red para el canal de comunicación especificado ha cambiado al estado «Prepare Bus - Sleep Mode» [SWS_ComM_00391].
Uso y signatura
La interfaz está disponible a través del archivo de cabecera ComM_Nm.h y posee el ID de servicio 0x19 [SWS_ComM_00391]. La ejecución se realiza de forma asíncrona [SWS_ComM_00391]. La signatura de la función incluye los siguientes parámetros:
Channel(In,NetworkHandleType): Identifica el canal de red afectado cuya gestión de red ha adoptado el modo Prepare Bus Sleep [SWS_ComM_00391].- Valor de retorno:
void; no se devuelven valores de estado ni de error y no se gestionan parámetros de entrada/salida [SWS_ComM_00391].
Concurrencia y restricciones
En cuanto a la concurrencia, ComM_Nm_PrepareBusSleepMode está especificada como reentrante, aunque con la restricción obligatoria de que esto no se aplica al mismo canal NM (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. Por lo tanto, las llamadas para canales diferentes pueden realizarse en paralelo, mientras que deben excluirse las llamadas simultáneas para el mismo canal.
Contexto de llamada y tratamiento de errores
Interpretación: Es probable que el contexto de llamada se encuentre en el Network Management genérico o específico del bus, que notifica al ComM la consecución de este estado. Pregunta Q-41524322db480310 (abierta) En la especificación no se definen códigos de error específicos, mensajes DET ni DEM para esta interfaz [SWS_ComM_00391].
Este texto fue generado por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_BusSleepMode [SWS_ComM_00392] 📄 PDF
void ComM_Nm_BusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Bus - Sleep Mode. This callback function should perform a transition of the hardware and transceiver to bus - sleep mode.
usar
La función de retrollamada ComM_Nm_BusSleepMode sirve como notificación al módulo ComM de que la gestión de red ha cambiado al modo Bus Sleep [SWS_ComM_00392]. Mediante esta llamada, la función debe llevar a cabo la transición del hardware asociado así como del transceptor al modo Bus Sleep [SWS_ComM_00392].
Interfaz y parámetros
La función se proporciona a través del archivo de cabecera ComM_Nm.h y cuenta con el ID de servicio 0x1a [SWS_ComM_00392]. La llamada se realiza a través de la signatura void ComM_Nm_BusSleepMode (NetworkHandleType Channel) con las siguientes propiedades de los parámetros [SWS_ComM_00392]:
Channel: Parámetro de entrada del tipoNetworkHandleTypeque identifica el canal de comunicación afectado [SWS_ComM_00392].- Para esta función no están previstos parámetros de entrada/salida ni parámetros de salida [SWS_ComM_00392].
- No hay definido ningún valor de retorno (
void) [SWS_ComM_00392].
Concurrencia y restricciones
En cuanto al comportamiento de ejecución y las posibles restricciones, el requisito especifica las siguientes condiciones marco [SWS_ComM_00392]:
- Semántica asíncrona: La llamada está clasificada como asíncrona (Asynchronous) [SWS_ComM_00392].
- Reentrancia: La función está definida como reentrante (Reentrant) [SWS_ComM_00392].
Este texto fue generado por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_RestartIndication [SWS_ComM_00792] 📄 PDF
void ComM_Nm_RestartIndication (NetworkHandleType Channel);
If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND on at least on one of the coordinated busses NM is restarted, THEN the NM Interface shall call the callback function Com M_ Nm_ Res tart Indication with the nm Network Handle of the channels which have already indicated bus sleep state.
La función de devolución de llamada ComM_Nm_RestartIndication con el ID de servicio 0x1b es llamada por la interfaz NM y está declarada a través del archivo de cabecera ComM_Nm.h [SWS_ComM_00792]. Sirve para poner en conocimiento del Communication Manager el reinicio de la gestión de red durante un proceso de desconexión en curso de buses coordinados [SWS_ComM_00792]. El único parámetro de entrada Channel de tipo NetworkHandleType designa el canal afectado; la operación no devuelve ningún valor de retorno [SWS_ComM_00792].
La interfaz está especificada como asíncrona y reentrante [SWS_ComM_00792]. Su llamada por parte de la interfaz NM tiene lugar cuando se cumplen simultáneamente tres condiciones:
- La interfaz NM ya ha comenzado con el apagado de los buses coordinados [SWS_ComM_00792].
- Todavía no todos estos buses coordinados han notificado el estado Bus-Sleep [SWS_ComM_00792].
- En al menos uno de los buses coordinados se reinicia la gestión de red [SWS_ComM_00792].
En el extracto de la especificación no se contemplan códigos de error específicos, reacciones a fallos ni notificaciones al módulo de pruebas de desarrollo o de memoria de fallos (DET/DEM) [SWS_ComM_00792]. Interpretación: es de suponer que en el ComM la función esté prevista para volver a sincronizar el estado interno de los canales ya dormidos con la coordinación de bus reactivada. Pregunta (abierta)
Esta nota de uso fue generada automáticamente sobre la base de la especificación.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_RepeatMessageLeftIndication [SWS_ComM_91024] 📄 PDF
void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);
Notification that the state of all
usar
La función ComM_Nm_RepeatMessageLeftIndication sirve como interfaz de notificación que señala al ComM que el estado de todos los módulos Bus-NM (<Bus Nm>) ha abandonado el estado Repeat Message [SWS_ComM_91024]. En el marco de la característica funcional opcional para la asignación dinámica de Partial Network Clusters a canales (Dynamic PNC-to-channel-mapping), esta llamada indica que la fase de aprendizaje finaliza [SWS_ComM_91024].
La interfaz se declara a través de la cabecera ComM_Nm.h y no posee valor de retorno (void) [SWS_ComM_91024]. Como parámetro de entrada se transmite el canal de comunicación afectado:
Channel(In,NetworkHandleType): Identificación del canal para el que se notifica la salida del estado [SWS_ComM_91024].
Interacción y efecto funcional
El comportamiento de la indicación controla la fase de aprendizaje de PNC: Siempre que el parámetro de configuración ComMDynamicPncToChannelMappingEnabled esté establecido en TRUE y se llame a ComM_Nm_RepeatMessageLeftIndication, el ComM establece la fase de aprendizaje de PNC (PNC Learning Phase) para el canal correspondiente como inactiva [SWS_ComM_01029] [SWS_ComM_01046].
Concurrencia y restricciones
La interfaz está especificada como reentrante y presenta una semántica de ejecución asíncrona [SWS_ComM_91024]. En la presente especificación, el elemento está identificado además con el estado de desarrollo draft [SWS_ComM_91024].
Este texto fue creado por una IA a partir de la especificación AUTOSAR.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_PncLearningBitIndication [SWS_ComM_91026] 📄 PDF
void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);
Service to indicate that an NM message with set PNC Learning Bit has been received. Tags: atp.Status=draft
La función ComM_Nm_PncLearningBitIndication sirve como interfaz de notificación para el módulo ComM para indicar la recepción de un mensaje NM con el bit de PNC-Learning activado [SWS_ComM_91026]. La interfaz posee el ID de servicio 0x69, se proporciona a través del archivo de cabecera ComM_Nm.h y está identificada en la especificación con el estado «draft» [SWS_ComM_91026].
En cuanto a uso y firma, se aplican las siguientes disposiciones:
- Parámetros: como parámetro de entrada se pasa
Channeldel tipoNetworkHandleType, que identifica el canal de comunicación afectado [SWS_ComM_91026]. No hay parámetros de entrada/salida ni parámetros de salida, y el tipo de retorno esvoid[SWS_ComM_91026]. - Concurrencia: la llamada está especificada como asíncrona y reentrante [SWS_ComM_91026]. A juzgar por el identificador y el encabezado, la llamada suele realizarla normalmente el módulo NM subyacente tan pronto como se recibe el mensaje NM correspondiente. Pregunta Q-31b0ce30b88c71b6 (abierta)
- Tratamiento de errores: en el alcance de la especificación no se documentan valores de retorno ni códigos de error específicos o avisos a DET o DEM para este servicio.
En interacción con el mapeo dinámico de PNC, la función controla la activación de la fase de aprendizaje: si se llama a ComM_Nm_PncLearningBitIndication en un canal para el cual el parámetro de configuración ComMDynamicPncToChannelMappingEnabled está establecido en TRUE, ComM debe poner la fase de aprendizaje de PNC (PNC Learning Phase) en activa para este canal [SWS_ComM_01026]. Según la especificación, ComM también activa el mismo estado de fase de aprendizaje activa en el canal en cuestión cuando el propio módulo llama a Nm_PnLearningRequest [SWS_ComM_01026].
Esta nota de uso ha sido generada por una IA a partir de las especificaciones.
Guía del implementador pendiente (complejidad I1)
función ComM_Nm_ForwardSynchronizedPncShutdown [SWS_ComM_91003] 📄 PDF
void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);
If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a
La función síncrona y reentrante ComM_Nm_ForwardSynchronizedPncShutdown (ID de servicio 0x6b) se declara mediante la cabecera ComM_Nm.h y sirve para el reenvío coordinado de un apagado sincronizado de PNC [SWS_ComM_91003].
Uso y contexto de llamada: Se invoca cuando una ECU con el rol de coordinador de PNC intermedio (intermediate PNC coordinator) recibe un mensaje de apagado de PN a través de un NM específico de bus [SWS_ComM_91003]. Como único parámetro de entrada se transfiere el canal de comunicación afectado (Channel de tipo NetworkHandleType). No se ha definido ningún valor de retorno (void) [SWS_ComM_91003].
Interacción y flujo: Tras la indicación, el ComM libera de inmediato las máquinas de estados de PNC afectadas. Además, reenvía directamente la información de PN a los canales ComM afectados así como a los canales NM correspondientes [SWS_ComM_91003]. De este modo se asegura un apagado de PNC prácticamente síncrono a través de la topología jerárquica de PN, desde el coordinador de nivel superior (Top-Level) hasta los nodos PNC subordinados [SWS_ComM_91003].
Tratamiento de errores y restricciones: Dado que la interfaz no presenta valor de retorno y no hay códigos de error específicos documentados, es de suponer que el tratamiento de errores se realice de forma interna o a través del DET. Pregunta Q-618a8c1da055cdf5 (abierta) En el Release R20-11, el elemento está clasificado como Draft [SWS_ComM_91003].
Esta nota de uso se generó automáticamente sobre la base de la especificación de AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_DCM_ActiveDiagnostic [SWS_ComM_00873] 📄 PDF
void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);
Indication of active diagnostic by the DCM.
Uso y contexto de llamada
La interfaz síncrona ComM_DCM_ActiveDiagnostic sirve al Diagnostic Communication Manager (DCM) para notificar al Communication Manager (ComM) sobre actividades de diagnóstico activas en un canal de comunicación determinado [SWS_ComM_00873]. La función está definida en el archivo de cabecera ComM_Dcm.h e indicada con el Service-ID 0x1f [SWS_ComM_00873].
Como único parámetro de llamada actúa el parámetro de entrada Channel del tipo de datos NetworkHandleType, que identifica unívocamente el canal afectado para la comunicación de diagnóstico pendiente [SWS_ComM_00873]. La interfaz no posee ningún valor de retorno (tipo de retorno void), y no existen parámetros de entrada/salida ni de salida [SWS_ComM_00873].
Concurrencia y restricciones
En cuanto a la concurrencia, el elemento de servicio está especificado como reentrante [SWS_ComM_00873]. Esto permite llamadas síncronas paralelas a la función desde diferentes contextos de ejecución, por ejemplo, cuando el DCM debe gestionar o atender múltiples canales de red simultáneamente.
Tratamiento de errores e interacción
Para esta llamada no se han determinado códigos de error específicos ni mensajes a la gestión de errores de desarrollo (DET) o a la gestión de memoria de eventos de diagnóstico (DEM) [SWS_ComM_00873]. La interacción se limita al intercambio de señales entre DCM y ComM; interpretación: en ComM la llamada probablemente se utilice para mantener el canal correspondiente en estado de comunicación activa durante la duración de la actividad de diagnóstico [SWS_ComM_00873]. Pregunta Q-bfd91da2e435fbb6 (abierta)
Esta nota de uso ha sido generada de forma automatizada sobre la base de la especificación de AUTOSAR Classic Release R20-11.
función ComM_DCM_InactiveDiagnostic [SWS_ComM_00874] 📄 PDF
void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);
Indication of inactive diagnostic by the DCM.
usar
La función síncrona ComM_DCM_InactiveDiagnostic sirve para que el Diagnostic Communication Manager (DCM) indique al Communication Manager (ComM) que la comunicación de diagnóstico en un canal determinado está inactiva y ya no se necesita [SWS_ComM_00874]. La declaración de esta interfaz se proporciona a través del archivo de cabecera ComM_Dcm.h con el ID de servicio 0x20 [SWS_ComM_00874].
Como parámetro de entrada se pasa Channel de tipo NetworkHandleType, que identifica el canal de comunicación correspondiente [SWS_ComM_00874]. La función no posee parámetros de entrada/salida ni parámetros de salida, y no devuelve ningún valor (void) [SWS_ComM_00874].
Concurrencia y tratamiento de errores
La interfaz está especificada como reentrante [SWS_ComM_00874], por lo que se permiten llamadas simultáneas, por ejemplo para diferentes canales de comunicación. En el payload no se definen códigos de error específicos, mensajes de error DET ni eventos DEM para esta función [SWS_ComM_00874]. Es probable que el módulo ComM utilice internamente la notificación de inactividad para retirar las solicitudes de diagnóstico existentes para el canal y adaptar el estado del canal en consecuencia. Pregunta Q-148d39d8c17e936c (abierta)
Este texto ha sido generado por una IA y resume la especificación sobre la base de la versión R20-11 de AUTOSAR.
función ComM_EcuM_WakeUpIndication [SWS_ComM_00275] 📄 PDF
void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);
Notification of a wake up on the corresponding channel.
La función ComM_EcuM_WakeUpIndication sirve para notificar al Communication Manager (ComM) sobre un evento de wake-up ocurrido en el canal de comunicación respectivamente afectado [SWS_ComM_00275]. La llamada debería realizarse típicamente mediante el ECU State Manager (EcuM), tan pronto como este haya registrado un wake-up correspondiente en un canal. Pregunta Q-5f8c43b9df10dc8e (abierta)
Uso y contexto de llamada
La interfaz está definida como síncrona y posee el ID de servicio 0x2a [SWS_ComM_00275]. A través del parámetro de entrada Channel de tipo NetworkHandleType se transfiere el identificador del canal de comunicación en el que se detectó el wake-up [SWS_ComM_00275]. La función no posee valor de retorno (void) y se declara a través del archivo de cabecera ComM_EcuM.h [SWS_ComM_00275].
Concurrencia y restricciones
Según la especificación, ComM_EcuM_WakeUpIndication está clasificada como reentrante [SWS_ComM_00275]. Por lo tanto, la función puede llamarse en paralelo para diferentes canales o desde contextos concurrentes. No se indican códigos de error específicos, valores de retorno ni notificaciones DET/DEM en la definición del elemento [SWS_ComM_00275].
Este texto fue generado por una IA. Todos los datos proceden exclusivamente de la carga útil de especificación del release R20-11 de AUTOSAR.
función ComM_EcuM_PNCWakeUpIndication [SWS_ComM_91001] 📄 PDF
void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);
Notification of a wake up on the corresponding partial network cluster.
Uso y contexto de llamada
La función síncrona ComM_EcuM_PNCWakeUpIndication sirve para notificar al Communication Manager sobre un wake-up en un Partial Network Cluster (PNC) [SWS_ComM_91001]. Se declara a través de la cabecera ComM_EcuM.h y espera como parámetro de entrada PNCid el identificador del clúster afectado; no existen valores de retorno [SWS_ComM_91001]. Interpretación: la llamada la realiza típicamente el ECU State Manager (EcuM) al detectar un evento PNC correspondiente. Pregunta Q-fee4a70f73cde8ea (abierta)
Concurrencia y transiciones de estado
La interfaz está especificada como reentrante [SWS_ComM_91001]. Su llamada provoca transiciones de estado dirigidas dentro de las máquinas de estados de PNC y de canal del ComM:
- Si el clúster referenciado se encuentra en el estado principal de PNC
PNC_NO_COMMUNICATION, se abandona este estado y se pasa al subestado de PNCPNC_PREPARE_SLEEP[SWS_ComM_00964]. - Si la llamada se produce en el subestado
COMM_NO_COM_NO_PENDING_REQUESTcon el soporte de PNC activado (ComMPncSupport=TRUE) y el wake-up síncrono desactivado (ComMSynchronousWakeUp=FALSE), el módulo transiciona al subestadoCOMM_NO_COM_REQUEST_PENDINGaquellas máquinas de estados de canal de ComM referenciadas por el PNC especificado [SWS_ComM_01014]. - Si, por el contrario,
ComMSynchronousWakeUp=TRUEestá configurado conComMPncSupportactivo, la llamada en el subestadoCOMM_NO_COM_NO_PENDING_REQUESTtransiciona sin excepción todas las máquinas de estados de canal de ComM al subestadoCOMM_NO_COM_REQUEST_PENDING[SWS_ComM_01015].
Este texto ha sido generado por una IA sobre la base de la especificación AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_CommunicationAllowed [SWS_ComM_00871] 📄 PDF
void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);
Ecu M or Bsw M shall indicate to Com M when communication is allowed. If Ecu M/ Flex is used: Bsw M AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager
A través de la función ComM_CommunicationAllowed ([SWS_ComM_00871]), EcuM o BswM indican al módulo ComM si la comunicación está habilitada para un canal determinado.
Uso y contexto de llamada
La interfaz es llamada por el módulo EcuM o BswM; si se emplea EcuM Flex, BswM asume esta tarea ([SWS_ComM_00871]). La función está declarada a través de la cabecera ComM_BswM.h y posee el Service-ID 0x35 ([SWS_ComM_00871]).
La función no posee ningún valor de retorno (void) y espera los siguientes parámetros de paso ([SWS_ComM_00871]):
Channel(tipoNetworkHandleType): Designa el canal de comunicación afectado ([SWS_ComM_00871]).Allowed(tipoboolean): Pasa el estado de habilitación conTRUEpara comunicación permitida oFALSEpara comunicación no permitida ([SWS_ComM_00871]).
Concurrencia y restricciones
Según la especificación, la función opera de forma asíncrona (Asynchronous) y está clasificada como no reentrante (Non Reentrant) ([SWS_ComM_00871]). Debido a la no reentrancia, el invocador debería tener que garantizar que no se produzcan llamadas paralelas o interruptivas para la interfaz. Pregunta Q-e6688e3286d9ed60 (abierta)
Esta nota de uso se ha generado automáticamente a partir de la especificación SWS_ComM_00871.
función ComM_BusSM_ModeIndication [SWS_ComM_00675] 📄 PDF
void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);
Indication of the actual bus mode by the corresponding Bus State Manager. Com M shall propagate the indicated state to the users with means of the RTE and Bsw M.
Uso y signatura
La interfaz ComM_BusSM_ModeIndication sirve para la indicación del modo de bus real por parte del Bus State Manager responsable al módulo ComM [SWS_ComM_00675]. La función C está disponible a través de la cabecera ComM.h y se gestiona bajo el ID de servicio 0x33 [SWS_ComM_00675]. Su sintaxis es void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].
La función recibe dos parámetros de entrada:
Channel: el canal de comunicación afectado de tipoNetworkHandleType[SWS_ComM_00675].ComMode: el modo real del bus de tipoComM_ModeType[SWS_ComM_00675].
La interfaz no posee valor de retorno (void) y no define parámetros de entrada/salida ni parámetros puros de retorno [SWS_ComM_00675].
Concurrencia y sincronización
Para el comportamiento en tiempo de ejecución, se ha establecido que la llamada se realiza de forma asíncrona (Asynchronous) y que la función se puede ejecutar de forma reentrante (Reentrant) [SWS_ComM_00675].
Interacción en el sistema global
El módulo ComM reenvía el estado notificado mediante esta llamada a los usuarios [SWS_ComM_00675]. Esta propagación del estado del bus se realiza a través de las interfaces de la RTE y del BswM [SWS_ComM_00675].
Esta nota de uso ha sido generada de forma automatizada sobre la base de la especificación de AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I1)
función ComM_BusSM_BusSleepMode [SWS_ComM_91000] 📄 PDF
void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);
Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep. Only applicable for Com M channels with Com MNm Variant set to SLAVE_ ACTIVE or SLAVE_ PASSIVE. E.g. LIN slaves (Com MNMVariant = SLAVE_ ACTIVE) or Ethernet channels with OA TC10 compliant Ethernet hardware which act as passive communication slave (Com MNMVariant = SLAVE_ PASSIVE and Eth Trcv Act As Slave Passive Enabled set to TRUE)
usar
La función de servicio síncrona ComM_BusSM_BusSleepMode sirve al Bus State Manager (BusSM) correspondiente como notificación al Communication Manager (ComM) de que el modo de bus real de un canal de comunicación ha pasado al estado Bus-Sleep [SWS_ComM_91000]. La identificación del canal afectado se realiza a través del parámetro de entrada Channel de tipo NetworkHandleType [SWS_ComM_91000]. La función no declara parámetros de salida ni un valor de retorno (void) [SWS_ComM_91000].
Validez dependiente de la configuración
La llamada no está permitida universalmente, sino que está limitada explícitamente a canales de ComM cuyo parámetro ComMNmVariant esté establecido en SLAVE_ACTIVE o SLAVE_PASSIVE [SWS_ComM_91000]. La especificación menciona para ello dos escenarios de uso típicos:
- Esclavos LIN con la configuración
ComMNmVariant = SLAVE_ACTIVE[SWS_ComM_91000]. - Canales Ethernet con hardware según OPEN Alliance TC10 que se operan como esclavos de comunicación pasivos, donde
ComMNmVariant = SLAVE_PASSIVEy el parámetroEthTrcvActAsSlavePassiveEnabledestán establecidos enTRUE[SWS_ComM_91000].
Concurrencia e integración
La interfaz posee el ID de servicio 0x34, está declarada a través del archivo de cabecera ComM.h y está clasificada como reentrante [SWS_ComM_91000]. En la definición de la función no se indican códigos de error específicos ni un comportamiento especial en caso de error [SWS_ComM_91000].
Esta nota de uso ha sido generada de forma automatizada sobre la base de la especificación AUTOSAR CP R20-11.
Guía del implementador pendiente (complejidad I1)
tipo ComM_InitStatusType [SWS_ComM_00668] 📄 PDF
Initialization status of Com M.
El tipo de enumeración ComM_InitStatusType sirve para representar el estado de inicialización del módulo ComM (COM Manager) y está disponible a través del archivo de cabecera ComM.h [SWS_ComM_00668].
El rango de valores comprende exactamente dos estados para distinguir la disponibilidad operativa [SWS_ComM_00668]:
COMM_UNINIT(codificado con el valor0x00o bien0): indica que el COM Manager no está inicializado o no se puede utilizar. Este estado es obligatoriamente el valor por defecto directamente tras un reinicio [SWS_ComM_00668].COMM_INIT(codificado con el valor0x01): indica que el COM Manager se ha inicializado correctamente y está listo para operar [SWS_ComM_00668].
En cuanto al orden cronológico y al uso del módulo, este estado marca la usabilidad fundamental del COM Manager [SWS_ComM_00668]. Interpretación: los llamadores o las rutinas internas del módulo deberían evaluar este estado para garantizar que no se procese ninguna solicitud de comunicación en el estado COMM_UNINIT, ya que el COM Manager está especificado explícitamente como no utilizable en este estado [SWS_ComM_00668]. Pregunta Q-2c4da2e5c40a0f4b (abierta) Solo tras la transición exitosa a COMM_INIT, el módulo está disponible para interacciones de nivel superior.
Este texto ha sido generado por una IA; solo la especificación es vinculante.
Guía del implementador pendiente (complejidad I1)
tipo ComM_PncModeType [SWS_ComM_00673] 📄 PDF
Current mode of a PNC
El tipo de enumeración ComM_PncModeType define el estado operativo actual de un Partial Network Cluster (PNC) en el Communication Manager [SWS_ComM_00673]. El tipo se proporciona a través del archivo de cabecera ComM.h y comprende cinco estados discretos [SWS_ComM_00673]:
COMM_PNC_REQUESTED(0x00): el PNC es solicitado por un usuario local de ComM.COMM_PNC_READY_SLEEP(0x01): el PNC es solicitado por un usuario remoto de ComM.COMM_PNC_PREPARE_SLEEP(0x02): el PNC está activo, pero sin supervisión de plazos (Deadline Monitoring).COMM_PNC_NO_COMMUNICATION(0x03): no tiene lugar ninguna comunicación para el PNC.COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST(0x04): solicitud local de PNC con requerimiento adicional de reactivación de hardware al BswM.
En interacción con el BswM, el modo COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST sirve para señalar que una solicitud activa debe desencadenar adicionalmente la reactivación del hardware de comunicación [SWS_ComM_00673]. Esto presupone que la función esté soportada y configurada, por ejemplo en la conmutación de puertos de conmutadores Ethernet según OA TC10 [SWS_ComM_00673]. Como restricción, cabe señalar que en la versión R20-11 este modo lleva el estado draft [SWS_ComM_00673].
Dado que se trata de una mera definición de tipo, no existen rutinas de tratamiento de errores propias ni requisitos de reentrancia para ComM_PncModeType.
Interpretación: dado que el tipo está declarado en ComM.h y el BswM está direccionado como receptor de la información de modo, es probable que el tipo de datos se utilice entre módulos como parámetro de interfaz para notificaciones de estado de PNC. Pregunta Q-88ad945ffcf90e9e (abierta)
Este texto fue generado por una IA a partir de la especificación AUTOSAR CP R20-11.
Guía del implementador pendiente (complejidad I1)
tipo ComM_StateType [SWS_ComM_00674] 📄 PDF
State and sub - state of Com M state machine Com M states vs. Communication Modes: COMM_ NO_ COM* : Communication Mode='No Communication' COMM_ FULL_ COM*: Communication Mode='Full Communication' COMM_ SILENT_ COM: Communicatio Mode='Silent Communication'
Uso y definición
El tipo ComM_StateType representa los estados y subestados de la máquina de estados interna del Communication Manager (ComM) en la plataforma AUTOSAR Classic [SWS_ComM_00674]. Está definido como un tipo independiente basado en el tipo estándar uint8 y se proporciona a través del archivo de cabecera ComM.h para componentes de software y módulos BSW [SWS_ComM_00674].
Rango de valores y subestados
El rango de valores comprende cinco valores definidos que representan la fase exacta de la máquina de estados de comunicación [SWS_ComM_00674]:
COMM_NO_COM_NO_PENDING_REQUEST(valor 0): Identifica el estado dentro de No Communication cuando actualmente no hay ninguna solicitud de comunicación [SWS_ComM_00674].COMM_NO_COM_REQUEST_PENDING(valor 1): Identifica el estado dentro de No Communication mientras una solicitud de comunicación está pendiente [SWS_ComM_00674].COMM_FULL_COM_NETWORK_REQUESTED(valor 2): Identifica el estado dentro de Full Communication en el que la red está solicitada activamente [SWS_ComM_00674].COMM_FULL_COM_READY_SLEEP(valor 3): Identifica el estado dentro de Full Communication en el que ya no existen solicitudes activas y la red está lista para entrar en suspensión [SWS_ComM_00674].COMM_SILENT_COM(valor 4): Corresponde al modo de comunicación Silent Communication [SWS_ComM_00674].
Asignación a los modos de comunicación
Los valores de ComM_StateType guardan una relación directa con los modos de comunicación de nivel superior (Communication Modes) del ComM [SWS_ComM_00674]. Todos los estados con el prefijo COMM_NO_COM* están asignados al modo No Communication, mientras que los estados con el prefijo COMM_FULL_COM* corresponden al modo Full Communication [SWS_ComM_00674]. El valor COMM_SILENT_COM representa el modo de comunicación del mismo nombre, Silent Communication [SWS_ComM_00674].
Esta nota de uso se ha generado de forma automatizada sobre la base de la especificación R20-11.
Guía del implementador pendiente (complejidad I1)
tipo ComM_ConfigType [SWS_ComM_00162] 📄 PDF
This type contains the implementation - specific post build configuration structure.
tipo ComM_ModeType [SWS_ComM_00672] 📄 PDF
Current mode of the Communication Manager (main state of the state machine).
El tipo de datos ComM_ModeType representa el modo de comunicación actual y, por tanto, el estado primario de la máquina de estados del canal de ComM en el Communication Manager [SWS_ComM_00672]. Se deriva del tipo básico uint8 y se proporciona a través de la cabecera Rte_ComM_Type.h para su uso por parte de componentes de software y otros módulos BSW [SWS_ComM_00672].
El rango de valores comprende cuatro modos de funcionamiento discretos que definen la capacidad de comunicación del canal correspondiente [SWS_ComM_00672]:
COMM_NO_COMMUNICATION(0): el canal configurado se encuentra en estado de reposo y no posee capacidad de transmisión ni de recepción [SWS_ComM_00672].COMM_SILENT_COMMUNICATION(1): el canal está limitado a una capacidad de recepción pasiva; la emisión de mensajes está impedida [SWS_ComM_00672].COMM_FULL_COMMUNICATION(2): el canal se encuentra en funcionamiento de comunicación completo con capacidad activa de transmisión y recepción [SWS_ComM_00672].COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST(3): el canal dispone de capacidad de transmisión y recepción hacia la capa inferior, por ejemplo para hardware Ethernet según OPEN Alliance TC10 [SWS_ComM_00672].
Durante el uso se aplican restricciones funcionales esenciales: el modo COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST lleva la etiqueta atp.Status=draft y está destinado expresamente al uso meramente interno dentro de la máquina de estados del canal de ComM [SWS_ComM_00672]. Por lo tanto, es de suponer que los usuarios externos o los componentes de software superpuestos no deben solicitar este estado como modo de destino ni esperarlo directamente a través de interfaces. Pregunta Q-e5f4abe0d6543c82 (abierta) No se han definido códigos de error específicos, comprobaciones en tiempo de ejecución ni notificaciones a DET o DEM para este tipo [SWS_ComM_00672].
Esta nota de uso ha sido generada automáticamente y se basa en las especificaciones de AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I1)
tipo ComM_UserHandleType [SWS_ComM_00670] 📄 PDF
Handle to identify a user. For each user, a unique value must be defined at system generation time. Maximum number of users is 255. Legal user IDs are in the range 0 .. 254; user ID 255 is reserved and shall have the symbolic representation COMM_ NOT_ USED _ USER_ ID.
tipo ComM_UserHandleArrayType [SWS_ComM_00906] 📄 PDF
number Of Requesters contains the number of valid user handle entries in the "handle Array" member. If no user keeps the channel requested, this is zero {LOWER - LIMIT=0, UPPER - LIMIT= MAX_ CHANNEL_ REQUESTER }
tipo ComM_UserHandleSubArrayType [SWS_ComM_01005] 📄 PDF
This element contains the user handles of the users which keep the channel requested (if any), starting in its first entries. The size of the array MAX_ CHANNE L_ REQUESTERS is the maximum of the number of users requesting a channel.
tipo ComM_PncMembershipType [SWS_ComM_91103] 📄 PDF
Array of uint8 with
tipo modeLimitation [SWS_ComM_01009] 📄 PDF
-
El elemento de especificación modeLimitation está definido según [SWS_ComM_01009] como puerto proporcionado (Provided Port) del gestor de comunicaciones (ComM) para la interfaz ComM_ECUModeLimitation. Interpretación: a través de esta interfaz de puerto, es de suponer que el módulo ComM pone a disposición de componentes de software de nivel superior o del BswM mecanismos para la limitación selectiva de los modos de comunicación activos a nivel de unidad de control, por ejemplo para salvaguardar el consumo de corriente o los modos de funcionamiento. Pregunta Q-337c6b40bd72cf76 (abierta)
La provisión de este puerto en el sistema está sujeta a una condición de variabilidad explícita: según [SWS_ComM_01009], el elemento solo está presente en el sistema si la opción de configuración {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true está establecida. Presumiblemente, la desactivación de este parámetro hace que el puerto se omita durante la generación de código. Pregunta (abierta) Por consiguiente, los componentes de software de aplicación y de software básico solo deben conectar arquitectónicamente esta interfaz si la opción está activada.
Con respecto a operaciones concretas de interfaz, parámetros, reentrancia, así como notificaciones de error a DET o DEM, [SWS_ComM_01009] no contiene especificaciones particulares. Por lo tanto, los integradores deben asegurarse, ante todo, de que la configuración requerida esté activada en el contenedor ComMGeneral antes de conectar componentes con el puerto modeLimitation.
Este texto ha sido generado por una IA sobre la base de la especificación SWS_ComM_01009.
Guía del implementador pendiente (complejidad I1)
tipo ComMMode [SWS_ComM_01012] 📄 PDF
-
El tipo ComMMode está especificado en el módulo ComM como Mode Declaration Group [SWS_ComM_01012]. El elemento está asignado a la categoría ALPHABETIC_ORDER y define los modos de comunicación básicos del módulo [SWS_ComM_01012].
El grupo comprende tres estados vinculantes [SWS_ComM_01012]:
COMM_NO_COMMUNICATION: sirve como modo inicial del grupo [SWS_ComM_01012].COMM_SILENT_COMMUNICATION: representa un modo de comunicación pasivo [SWS_ComM_01012].COMM_FULL_COMMUNICATION: caracteriza el funcionamiento de comunicación sin restricciones [SWS_ComM_01012].
Como modo inicial se ha establecido COMM_NO_COMMUNICATION, con lo que el sistema arranca por defecto sin comunicación activa [SWS_ComM_01012]. Para las transiciones no se ha definido ningún valor particular («On transition value») [SWS_ComM_01012]; Interpretación: esto significa presumiblemente que los cambios de estado se realizan directamente sin estados intermedios definidos. Pregunta Q-f0e73d26f85073b4 (abierta) Interpretación: es de suponer que los modos reflejan el estado de comunicación de canales o usuarios de comunicación en el módulo. Pregunta Q-ef5fa29f6af152c7 (abierta) Interpretación: es probable que la categoría ALPHABETIC_ORDER prescriba principalmente la enumeración estandarizada y la representación para las interfaces de la RTE. Pregunta Q-12af3dde3a4cc95e (abierta)
Este texto ha sido generado por una IA sobre la base de SWS_ComM_01012.
Guía del implementador pendiente (complejidad I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_ComM- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_ComM@rel:R20-11#33e7b82b- Content hash
33e7b82b- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_COMManager.pdf#nameddest=SWS_ComM_00146
gemini-3.8-flash-low· 2026-10-13 · Original en alemán