Intrusion Detection System Manager (IdsM)
Collects and reports onboard security events to detect threats.
Funktionen — Übersicht
void IdsM_Init (const IdsM_ConfigType* configPtr);Service to initialize the module IdsM.void IdsM_GetVersionInfo (const Std_VersionInfoType* versionInfo);Returns version information, vendor ID and AUTOSAR module ID of the component.void IdsM_MainFunction (void);This function is called periodically.BufReq_ReturnType IdsM_CopyTxDataManager (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This function is called to acquire the transmit data of an I-PDU segment (N-PDU).void IdsM_SetSecurityEvent (IdsM_SecurityEventIdType securityEventId);This API is the application interface to report security events to the IdsM.void IdsM_SetSecurityEventWithContextData (IdsM_SecurityEventIdType securityEventId, const uint8* contextData, uint16 contextDataSize);This API is the application interface to report security events with context data to the IdsM.void IdsM_SetSecurityEventWithCount (IdsM_SecurityEventIdType securityEventId, uint16 count);This API is the application interface for Smart Sensors to report security events with a count value to the IdsM.void IdsM_SetSecurityEventWithCountContextData (IdsM_SecurityEventIdType securityEventId, uint16 count, const uint8* contextData, uint16 contextDataSize);This API is the application interface for Smart Sensors to report security events with a count value and context data to the IdsM.void IdsM_SetSecurityEventWithTimestampCount (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count);This API is the application interface for Smart Sensors to report security events with a timestamp and a count value to the IdsM.void IdsM_SetSecurityEventWithTimestampCountContextDataManager (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count, const uint8* contextData, uint16 contextDataSize);This API is the application interface for Smart Sensors to report security events with a timestamp, a count value and context...void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state);This callback function is invoked by the BswM to indicate ECU state changes.void IdsM_TpTxConfirmation (PduIdType id, Std_ReturnType result);This function is called after the I-PDU has been transmitted on its network, the result indicates whether the transmission was...void IdsM_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.Std_ReturnType IdsM_Dcm_GetReportingMode_RequestResults (Dcm_OpStatusType OpStatus, uint8* Out_ReportingMode, Dcm_NegativeResponseCodeType* ErrorCode);This function is a request from DCM to the IdsM to read the routine results triggered by function...Std_ReturnType IdsM_Dcm_GetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);This function is a request from DCM to the IdsM to start the routine execution to request the current reporting mode of a...Std_ReturnType IdsM_Dcm_SetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, uint8 In_ReportingMode, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);This function is a request from DCM to the IdsM to start the routine execution to set the reporting mode of a specific...
Typen — Übersicht
struct IdsM_ConfigTypeConfiguration data structure of IdsM module.enum IdsM_Filters_BlockStateTypeData type used for "Block State" filter values (bit masks)enum IdsM_Filters_ReportingModeTypeReporting modes used by the reporting mode filterIdsM_TimestampTypeData type for IdsM timestampsIdsM_SecurityEventIdTypeData type used for local IdsM Security Event IDs
Funktionen & Typen — Detailansicht
función IdsM_Init [SWS_IdsM_91001] 📄 PDF
void IdsM_Init (const IdsM_ConfigType* configPtr);
Service to initialize the module IdsM. It initializes all variables and sets the module state to initialized.
La interfaz síncrona y no reentrante IdsM_Init sirve para la inicialización básica del módulo IdsM según [SWS_IdsM_91001]. Al invocarse, el servicio inicializa todas las variables internas y pasa el IdsM al estado inicializado ([SWS_IdsM_00202]). A través del parámetro de entrada configPtr, la función recibe un puntero a la estructura de configuración específica del módulo ([SWS_IdsM_91001]).
La ejecución de IdsM_Init representa una condición previa funcional obligatoria para el funcionamiento del módulo. Si se invoca una API del IdsM distinta de IdsM_Init o IdsM_GetVersionInfo en un estado aún no inicializado, con la detección de desarrollo (IdsMDevErrorDetect) habilitada, el módulo notifica el error IDSM_E_PARAM_UNINIT a través de Det_ReportError ([SWS_IdsM_00203], véase también el código de error 0x0D en [SWS_IdsM_02003]).
Para el tratamiento de errores y el contexto de llamada se aplican reglas de comportamiento específicas:
- Si se llama a
IdsM_Initmientras el módulo ya se encuentra en el estado inicializado, no se realiza una reinicialización de las variables internas ([SWS_IdsM_00204]). - En su lugar, con
IdsMDevErrorDetecthabilitado, el módulo notifica a través deDet_ReportErrorel error de desarrolloIDSM_E_ALREADY_INITIALIZEDcon el valor numérico0x0E([SWS_IdsM_00204], [SWS_IdsM_02003]). - La función no tiene valor de retorno y está definida como no reentrante ([SWS_IdsM_91001]). Por lo tanto, no debe invocarse de forma concurrente ni varias veces simultáneamente mediante contextos de interrupción en el sistema.
Esta nota fue generada por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_GetVersionInfo [SWS_IdsM_91004] 📄 PDF
void IdsM_GetVersionInfo (const Std_VersionInfoType* versionInfo);
Returns version information, vendor ID and AUTOSAR module ID of the component.
función IdsM_MainFunction [SWS_IdsM_91000] 📄 PDF
void IdsM_MainFunction (void);
This function is called periodically. It processes security events asynchronously which are queued during API function calls.
Uso y contexto de llamada
La función IdsM_MainFunction se invoca periódicamente y está disponible a través del archivo de cabecera IdsM.h [SWS_IdsM_91000]. Posee la signatura void IdsM_MainFunction(void), no recibe ningún parámetro y carece de valor de retorno [SWS_IdsM_91000]. La llamada de la función en sí es síncrona, pero sirve para el procesamiento asíncrono de eventos de seguridad (Security Events, SEv) que se encolaron previamente durante llamadas síncronas a la API [SWS_IdsM_91000]. La activación periódica debería realizarse normalmente mediante el BSW-Scheduler o una tarea cíclica del sistema operativo. Pregunta Q-86e2e870c3496bad (abierta)
Concurrencia y restricciones
Según la especificación, IdsM_MainFunction está catalogada como no reentrante (Non Reentrant) [SWS_IdsM_91000]. Por consiguiente, el entorno del sistema que realiza la llamada debe garantizar que la función solo se ejecute en una única instancia en cualquier momento y que no se produzcan llamadas solapadas.
Interacción en el procesamiento de eventos
La tarea principal en el marco del procesamiento cíclico abarca los siguientes aspectos:
- Búfer de eventos: tras la recepción de un SEv, el IdsM lo almacena en un Event Buffer; estos búferes se gestionan y filtran de forma asíncrona en el marco de
IdsM_MainFunction[SWS_IdsM_00702]. - Búfer de datos de contexto: si se recibe un SEv con datos de contexto, el IdsM utiliza búferes adecuados de un Context Data Buffer Pool; estos búferes también se gestionan y filtran de forma asíncrona en
IdsM_MainFunction[SWS_IdsM_00705]. - Cualificación: los SEv almacenados en los Event Buffers se procesan de forma asíncrona para identificarlos como eventos de seguridad cualificados (QSEv) [SWS_IdsM_00901].
Este texto ha sido generado por una IA a partir de la especificación R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_CopyTxDataManager [SWS_IdsM_91010] 📄 PDF
BufReq_ReturnType IdsM_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);
This function is called to acquire the transmit data of an I-PDU segment (N-PDU). Each call to this function provides the next part of the I-PDU data unless retry->TpDataState is TP_ DATARETRY. In this case the function restarts to copy the data beginning at the offset from the current position indicated by retry->TxTpDataCnt. The size of the remaining data is written to the position indicated by availableDataPtr.
La función de callback se invoca de forma síncrona y reentrante para solicitar datos de transmisión correspondientes a segmentos de una I-PDU (N-PDU) [SWS_IdsM_91010]. Está disponible a través de la cabecera IdsM_Cbk.h y atiende al Service ID 0x43 [SWS_IdsM_91010].
Mediante id se identifica la I-PDU que se va a transmitir [SWS_IdsM_91010]. El parámetro info pasa el búfer de destino (SduDataPtr), así como la longitud en bytes solicitada (SduLength); un valor de 0 para SduLength (donde SduDataPtr puede ser un NULL_PTR) sirve para cambios de estado en el parámetro retry o para consultar los datos restantes [SWS_IdsM_91010]. A través de availableDataPtr, la función notifica la cantidad de datos que queda en el búfer de Tx, lo que permite a protocolos de transporte con longitudes de carga útil dinámicas (p. ej., FrIsoTp) determinar el tamaño de los Consecutive Frames posteriores [SWS_IdsM_91010].
Si retry es un NULL_PTR, los datos copiados pueden liberarse del búfer inmediatamente después del proceso de copia [SWS_IdsM_91010]. En caso contrario, RetryInfoType controla el tratamiento de errores: con TP_CONFPENDING, los datos previamente copiados permanecen en el búfer TP, mientras que TP_DATACONF confirma y libera todos los datos copiados antes de esta llamada [SWS_IdsM_91010]. Si TpDataState está ajustado a TP_DATARETRY, la función vuelve a copiar datos previamente transmitidos a partir del desplazamiento en bytes indicado por TxTpDataCnt [SWS_IdsM_91010].
La función devuelve BUFREQ_OK en caso de copia completa y correcta [SWS_IdsM_91010]. Si no se dispone de suficientes datos de transmisión, no se copia ningún dato y se devuelve BUFREQ_E_BUSY, tras lo cual el módulo de nivel inferior puede repetir la llamada [SWS_IdsM_91010]. Si la solicitud falla, se produce la devolución de BUFREQ_E_NOT_OK sin aceptación de datos [SWS_IdsM_91010].
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 IdsM_SetSecurityEvent [SWS_IdsM_91002] 📄 PDF
void IdsM_SetSecurityEvent (IdsM_SecurityEventIdType securityEventId);
This API is the application interface to report security events to the IdsM.
La función IdsM_SetSecurityEvent sirve de interfaz para que las aplicaciones notifiquen eventos de seguridad al módulo IdsM (Intrusion Detection System Manager) [SWS_IdsM_91002].
Uso y contexto de llamada
La llamada se realiza de forma síncrona a través del archivo de cabecera IdsM.h con el Service ID 0x03 [SWS_IdsM_91002]. Como único parámetro de entrada se transfiere el identificador del evento de seguridad:
securityEventId(IN,IdsM_SecurityEventIdType): identificador unívoco del evento de seguridad notificado [SWS_IdsM_91002].
La función no tiene valor de retorno (void) [SWS_IdsM_91002].
Manejo de errores
Si la detección de errores de desarrollo (IdsMDevErrorDetect) está habilitada, el módulo verifica el parámetro securityEventId frente a los eventos de seguridad configurados [SWS_IdsM_02101]. Si se transfiere un ID de evento desconocido que no ha sido configurado en IdsMEvent, el IdsM notifica el error de desarrollo IDSM_E_PARAM_INVALID [SWS_IdsM_02101].
Concurrencia y restricciones
La función está especificada como no reentrante (Non Reentrant) [SWS_IdsM_91002]. Por tanto, el llamador debe sincronizar o evitar las llamadas concurrentes o con interrupciones procedentes de diferentes contextos.
Esta nota de uso se basa en las especificaciones de AUTOSAR Classic Platform en el release R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_SetSecurityEventWithContextData [SWS_IdsM_91003] 📄 PDF
void IdsM_SetSecurityEventWithContextData (IdsM_SecurityEventIdType securityEventId, const uint8* contextData, uint16 contextDataSize);
This API is the application interface to report security events with context data to the IdsM.
La función IdsM_SetSecurityEventWithContextData sirve como interfaz de aplicación para la notificación síncrona de eventos de seguridad samt datos de contexto opcionales al Intrusion Detection System Manager ([SWS_IdsM_91003]). Carece de valor de retorno.
Parámetros y uso
securityEventId: Identificador unívoco del evento de seguridad notificado ([SWS_IdsM_91003]).contextData: Puntero a datos de contexto opcionales; si no se dispone de datos de contexto, se debe pasarNULL_PTR([SWS_IdsM_91003]).contextDataSize: Tamaño de los datos de contexto facilitados en bytes ([SWS_IdsM_91003]).
Manejo de errores
Con la detección de errores de desarrollo activada (IdsMDevErrorDetect), el módulo IdsM realiza las siguientes comprobaciones:
- Si el
securityEventIdpasado no procede de los eventos de seguridad configurados enIdsMEvent, se notifica el error de desarrolloIDSM_E_PARAM_INVALID([SWS_IdsM_02102]). - Si
contextDataSizesupera el tamaño máximo de búfer configurado para datos de contexto (definido mediante el mayor valor parametrizado deIdsMContextDataBufferSize), se notifica el error de desarrolloIDSM_E_PARAM_LENGTH([SWS_IdsM_02107]).
Concurrencia e integración
La interfaz está especificada como no reentrante (Non Reentrant) ([SWS_IdsM_91003]). Por lo tanto, quienes realicen la llamada deben asegurarse de evitar llamadas concurrentes o de sincronizarlas de manera correspondiente. La declaración está disponible a través de la cabecera IdsM.h ([SWS_IdsM_91003]).
Este texto fue generado por un sistema de IA basándose en la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_SetSecurityEventWithCount [SWS_IdsM_91018] 📄 PDF
void IdsM_SetSecurityEventWithCount (IdsM_SecurityEventIdType securityEventId, uint16 count);
This API is the application interface for Smart Sensors to report security events with a count value to the IdsM.
La función síncrona IdsM_SetSecurityEventWithCount (Service-ID 0x05) representa la interfaz de aplicación para que los Smart Sensors transmitan eventos de seguridad (Security Events, SEvs) junto con un valor de conteo al IdsM [SWS_IdsM_91018], [SWS_IdsM_00401]. De este modo, el IdsM puede recibir eventos con un contador precalculado por el sensor [SWS_IdsM_00401]. La declaración de la función se proporciona a través del archivo de cabecera IdsM.h [SWS_IdsM_91018].
En la llamada, la función espera dos parámetros de entrada:
securityEventId: Identificador del evento de seguridad de tipoIdsM_SecurityEventIdType[SWS_IdsM_91018].count: Valor de conteo de tipouint16que procede del sensor y actúa como valor inicial para el evento [SWS_IdsM_91018], [SWS_IdsM_00401].
La función no devuelve ningún valor y no define ningún parámetro de salida [SWS_IdsM_91018]. En cuanto a concurrencia y contexto de llamada, la función está declarada como no reentrante (Non Reentrant) [SWS_IdsM_91018]; por tanto, deben evitarse las llamadas paralelas desde el software.
Para el tratamiento de errores, se establece que el IdsM comprueba los parámetros securityEventId y count con la detección de desarrollo habilitada (IdsMDevErrorDetect) [SWS_IdsM_02103]. Si se transfiere un ID de evento desconocido o si count tiene el valor 0, se notifica el error de desarrollo IDSM_E_PARAM_INVALID [SWS_IdsM_02103].
Esta nota de uso fue generada automáticamente por una IA sobre la base de la especificación AUTOSAR.
Guía del implementador pendiente (complejidad I1)
función IdsM_SetSecurityEventWithCountContextData [SWS_IdsM_91019] 📄 PDF
void IdsM_SetSecurityEventWithCountContextData (IdsM_SecurityEventIdType securityEventId, uint16 count, const uint8* contextData, uint16 contextDataSize);
This API is the application interface for Smart Sensors to report security events with a count value and context data to the IdsM.
La función IdsM_SetSecurityEventWithCountContextData sirve como interfaz de aplicación para sensores inteligentes con el fin de notificar de forma síncrona eventos de seguridad con valor de recuento y datos de contexto opcionales al [SWS_IdsM_91019].
Uso y parámetros
La llamada se realiza de forma síncrona y está especificada como no reentrante (Non Reentrant) [SWS_IdsM_91019]:
securityEventId: Identificador unívoco del evento de seguridad [SWS_IdsM_91019].count: Valor de recuento que se utiliza como valor inicial para el evento de seguridad [SWS_IdsM_91019].contextData: Puntero a una matriz de bytes con los datos de contexto que se deben proporcionar [SWS_IdsM_00502]. Si no hay datos de contexto, se debe pasarNULL_PTR[SWS_IdsM_91019].contextDataSize: Tamaño de los datos de contexto pasados en bytes [SWS_IdsM_91019]. La función admite una longitud máxima de hasta 1500 bytes [SWS_IdsM_00501].
Manejo de errores
Con la detección de errores de desarrollo activada (IdsMDevErrorDetect), el módulo supervisa la validez de los argumentos pasados:
- Se notifica el error de desarrollo
IDSM_E_PARAM_INVALIDsi se pasa unsecurityEventIddesconocido o sicountpresenta el valor 0 [SWS_IdsM_02104]. - Si
contextDataSizesupera el tamaño máximo de búfer configurado (determinado por la mayorIdsMContextDataBufferSizeconfigurada), el IdsM notifica el error de desarrolloIDSM_E_PARAM_LENGTH[SWS_IdsM_02108].
La función no devuelve ningún valor de retorno [SWS_IdsM_91019]; en caso de error, es de suponer que una reacción al error se base primordialmente en la notificación a través de la DET. Pregunta Q-135f4b865790f34d (abierta)
Este texto fue generado por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I2)
función IdsM_SetSecurityEventWithTimestampCount [SWS_IdsM_91020] 📄 PDF
void IdsM_SetSecurityEventWithTimestampCount (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count);
This API is the application interface for Smart Sensors to report security events with a timestamp and a count value to the IdsM.
La interfaz síncrona IdsM_SetSecurityEventWithTimestampCount sirve a los Smart Sensors para notificar eventos de seguridad con marca de tiempo y valor de conteo al IdsM [SWS_IdsM_91020]. La función no tiene valor de retorno y está disponible a través del archivo de cabecera IdsM.h [SWS_IdsM_91020].
Se procesan los siguientes parámetros de entrada:
securityEventId: Identificador específico del evento de seguridad notificado [SWS_IdsM_91020].timestamp: Marca de tiempo para la referenciación temporal del evento [SWS_IdsM_91020]. Si la función de marca de tiempo está activa y se transfiere una marca de tiempo, el IdsM la utiliza para el almacenamiento o la transmisión del Security Event cualificado (QSEv) [SWS_IdsM_01108]. En cambio, si el evento se notifica sin marca de tiempo con la función activa, el IdsM pone a 0 el bit de opción para la marca de tiempo en la cabecera de protocolo antes de la transmisión o el almacenamiento [SWS_IdsM_01112].count: Valor de conteo como valor inicial para el evento de seguridad [SWS_IdsM_91020]. Si no se dispone de un contador calculado previamente, la función se puede llamar con el valor 1 [SWS_IdsM_00405].
Con la detección de desarrollo habilitada (IdsMDevErrorDetect), el IdsM valida los argumentos securityEventId y count. Si se transfiere un ID de evento desconocido o si count tiene el valor 0, el módulo notifica el error de desarrollo IDSM_E_PARAM_INVALID [SWS_IdsM_02105].
En lo que respecta a la concurrencia, la función está especificada como no reentrante (Non Reentrant) [SWS_IdsM_91020].
Este texto ha sido generado automáticamente a partir de la especificación AUTOSAR.
Guía del implementador pendiente (complejidad I2)
función IdsM_SetSecurityEventWithTimestampCountContextDataManager [SWS_IdsM_91021] 📄 PDF
void IdsM_SetSecurityEventWithTimestampCountContextData (IdsM_SecurityEventIdType securityEventId, IdsM_TimestampType timestamp, uint16 count, const uint8* contextData, uint16 contextDataSize);
This API is the application interface for Smart Sensors to report security events with a timestamp, a count value and context data to the IdsM.
La función IdsM_SetSecurityEventWithTimestampCountContextData con el Service-ID 0x08 sirve como interfaz de aplicación estandarizada para Smart Sensors a fin de notificar eventos de seguridad al Intrusion Detection System Manager (IdsM) junto con una marca de tiempo, un valor inicial de conteo y datos de contexto opcionales [SWS_IdsM_91021]. La declaración de esta interfaz se pone a disposición mediante el encabezado IdsM.h [SWS_IdsM_91021].
La llamada se ejecuta de forma síncrona y utiliza exclusivamente parámetros de entrada, sin existir parámetros de entrada/salida ni parámetros de salida [SWS_IdsM_91021]. Al realizar la llamada, deben transferirse los siguientes parámetros [SWS_IdsM_91021]:
securityEventId: Identificador del evento de seguridad específico que debe transmitirse al IdsM [SWS_IdsM_91021].timestamp: Valor de marca de tiempo que actúa como referencia temporal del evento de seguridad ocurrido [SWS_IdsM_91021].count: Valor de conteo utilizado por el IdsM como valor inicial para el respectivo evento de seguridad [SWS_IdsM_91021].contextData: Puntero a datos de contexto opcionales sobre el evento; si no hay datos disponibles, debe transferirseNULL_PTR[SWS_IdsM_91021].contextDataSize: Indicación numérica sobre el tamaño de los datos de contexto transferidos [SWS_IdsM_91021].
En cuanto al comportamiento de ejecución, la función está clasificada como no reentrante (Non Reentrant) y no posee valor de retorno (void) [SWS_IdsM_91021]. Por lo tanto, los Smart Sensors llamantes deben asegurarse de que no se produzcan llamadas simultáneas o solapadas a la interfaz [SWS_IdsM_91021].
Este texto ha sido generado por una IA y sirve como guía orientativa.
Guía del implementador pendiente (complejidad I1)
función IdsM_BswM_StateChanged [SWS_IdsM_91005] 📄 PDF
void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state);
This callback function is invoked by the BswM to indicate ECU state changes.
El BswM llama a la función de callback IdsM_BswM_StateChanged ([SWS_IdsM_91005]) para indicar al Intrusion Detection System Manager (IdsM) los cambios en el estado actual de la ECU ([SWS_IdsM_91005]). Está declarada en el archivo de cabecera IdsM_Cbk.h y posee el Service ID 0x0F ([SWS_IdsM_91005]).
La interfaz tiene la firma void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state) ([SWS_IdsM_91005]). Como único valor de entrada se utiliza el parámetro de entrada state del tipo IdsM_Filters_BlockStateType, el cual representa el estado actual de la ECU ([SWS_IdsM_91005]). No se prevén parámetros de entrada/salida ni parámetros de salida, y la función no devuelve ningún valor de retorno ([SWS_IdsM_91005]). La llamada se ejecuta de forma síncrona y está clasificada como reentrante ([SWS_IdsM_91005]).
En la interacción funcional, este servicio de notificación sirve para que el BswM informe continuamente al IdsM sobre el estado actual ([SWS_IdsM_01022]). La información de estado recibida se mantiene en el IdsM y se evalúa durante el procesamiento asíncrono posterior de los filtros de estado de bloque (block state filter) en el marco de la función principal (main function) ([SWS_IdsM_01022]). En el alcance de la especificación no se definen códigos de error específicos, valores de retorno ni notificaciones a la gestión de errores de desarrollo (DET) o de eventos de diagnóstico (DEM) para esta llamada.
Esta nota de uso se ha generado de forma automatizada y se basa en los requisitos de especificación de AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_TpTxConfirmation [SWS_IdsM_91011] 📄 PDF
void IdsM_TpTxConfirmation (PduIdType id, Std_ReturnType result);
This function is called after the I-PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
La función de callback IdsM_TpTxConfirmation se declara como servicio síncrono y reentrante a través del archivo de cabecera IdsM_Cbk.h [SWS_IdsM_91011]. Conforme a [SWS_IdsM_01502], el módulo IdsM recibe a través de este servicio la confirmación del módulo PduR para la transmisión de una PDU segmentada. La llamada se produce tan pronto como la I-PDU correspondiente se haya transmitido en la red subyacente [SWS_IdsM_91011].
La interfaz posee el Service-ID 0x48 y no devuelve ningún valor (void) [SWS_IdsM_91011]. Al llamarla, se transfieren dos parámetros de entrada:
id(tipoPduIdType): identificación unívoca de la I-PDU transmitida [SWS_IdsM_91011].result(tipoStd_ReturnType): transmite el resultado de la transmisión de la I-PDU e indica si el proceso de envío fue correcto o falló [SWS_IdsM_91011].
En la especificación no se definen códigos de error específicos ni mensajes de DET o DEM para esta llamada. Gracias a la reentrancia especificada, la capa invocadora puede llamar a la función en paralelo para diferentes I-PDU [SWS_IdsM_91011]. Interpretación: es probable que el módulo IdsM evalúe el parámetro de estado result para actualizar el estado de transmisión interno de la PDU segmentada y liberar los búferes de transmisión ocupados tras la finalización. Pregunta Q-9179efcbf744346d (abierta)
Este texto ha sido elaborado por una IA y se basa exclusivamente en las especificaciones de AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I2)
función IdsM_TxConfirmation [SWS_IdsM_91009] 📄 PDF
void IdsM_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);
The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
usar
Un módulo de interfaz de comunicación subyacente llama a la función de callback IdsM_TxConfirmation ([SWS_IdsM_91009]) para confirmar el envío correcto de una PDU o el fallo de la transmisión. Está definida de forma síncrona, declarada en IdsM_Cbk.h y no tiene valor de retorno. Recibe los siguientes parámetros:
TxPduId: identificador de la PDU transmitida ([SWS_IdsM_91009]).result: resultado de la transmisión conE_OKen caso de envío correcto oE_NOT_OKsi se produjo un error ([SWS_IdsM_91009]).
Concurrencia y restricciones
La función es reentrante para diferentes IDs de PDU, pero no es reentrante para la misma TxPduId ([SWS_IdsM_91009]).
Interacción y condiciones de orden
Para la secuencia de transmisión se aplica una condición de orden estricta: según [SWS_IdsM_01499], el IdsM solo puede volver a llamar a la función de envío PduR_IdsMTransmit una vez que se haya llamado previamente a IdsM_TxConfirmation o IdsM_TpTxConfirmation. Interpretación: la llegada de la confirmación debería servir en el IdsM como desencadenante para finalizar la transmisión y habilitar llamadas sucesivas. Pregunta Q-dd4013520e85370c (abierta)
Manejo de errores
Un fallo en la transmisión de la PDU se notifica directamente a través del parámetro result = E_NOT_OK ([SWS_IdsM_91009]). En la especificación de la interfaz no se indican códigos de error DET o DEM específicos.
Este texto se generó automáticamente a partir de la especificación AUTOSAR CP R20-11.
Guía del implementador pendiente (complejidad I1)
función IdsM_Dcm_GetReportingMode_RequestResults [SWS_IdsM_91007] 📄 PDF
Std_ReturnType IdsM_Dcm_GetReportingMode_RequestResults (Dcm_OpStatusType OpStatus, uint8* Out_ReportingMode, Dcm_NegativeResponseCodeType* ErrorCode);
This function is a request from DCM to the IdsM to read the routine results triggered by function IdsM_Dcm_GetReportingMode_Start().
Uso y contexto de llamada
La función síncrona IdsM_Dcm_GetReportingMode_RequestResults (Service ID 0x0D, cabecera IdsM_Cbk.h) es invocada por el Diagnostic Communication Manager (DCM) para consultar los resultados de la rutina de una solicitud iniciada previamente mediante IdsM_Dcm_GetReportingMode_Start() [SWS_IdsM_91007]. A través del parámetro de transferencia OpStatus se transmite el estado de operación actual [SWS_IdsM_91007]. En caso de finalización correcta, la función devuelve E_OK y proporciona a través del puntero de salida Out_ReportingMode el modo de notificación determinado del Security Event solicitado [SWS_IdsM_91007]. Si el procesamiento aún no ha finalizado, lo señala mediante el valor de retorno DCM_E_PENDING [SWS_IdsM_91007].
Manejo de errores
Si la consulta falla, la función devuelve E_NOT_OK [SWS_IdsM_91007]. En este caso, se debe establecer un Negative Response Code (Dcm_NegativeResponseCodeType) concreto a través del parámetro ErrorCode; si este no se establece, el DCM envía el código de error 0x22 [SWS_IdsM_91007]. Para este servicio no se indican eventos DET o DEM específicos [SWS_IdsM_91007].
Concurrencia e interacción
La función está especificada como reentrante [SWS_IdsM_91007]. En cuanto a la secuencia de llamadas, presupone obligatoriamente que la rutina se haya desencadenado previamente mediante IdsM_Dcm_GetReportingMode_Start() [SWS_IdsM_91007]. Interpretación: es de suponer que el parámetro OpStatus sea utilizado por el DCM en consultas repetidas tras la devolución de DCM_E_PENDING para coordinar el progreso de la operación de diagnóstico. Pregunta Q-c268fab018a1f5b3 (abierta)
Esta nota de uso ha sido generada por una IA a partir de la especificación AUTOSAR R20-11.
Guía del implementador pendiente (complejidad I2)
función IdsM_Dcm_GetReportingMode_Start [SWS_IdsM_91006] 📄 PDF
Std_ReturnType IdsM_Dcm_GetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);
This function is a request from DCM to the IdsM to start the routine execution to request the current reporting mode of a specific Security Event ID.
El módulo de diagnóstico (DCM) invoca la función IdsM_Dcm_GetReportingMode_Start para iniciar en el Intrusion Detection System Manager (IdsM) la ejecución de una rutina para consultar el modo de notificación actual de un evento de seguridad (SEv) específico [SWS_IdsM_91006], [SWS_IdsM_02001]. La interfaz está declarada en la cabecera IdsM_Cbk.h, posee el Service-ID 0x0C y está especificada como síncrona y reentrante [SWS_IdsM_91006].
Durante la llamada, el DCM transfiere el ID externo del evento de seguridad (In_SecurityEventId), el ID de instancia del sensor (In_SensorInstanceId) y el estado de la operación (OpStatus) [SWS_IdsM_91006]. Como valor de retorno, la función proporciona Std_ReturnType:
E_OK: la operación se ha completado correctamente [SWS_IdsM_91006].DCM_E_PENDING: la operación aún no ha concluido [SWS_IdsM_91006]. Es de suponer que esto signifique que el procesamiento interno de la rutina continúa de forma multiciclo o asíncrona hasta que se disponga de los datos. Pregunta Q-395a30fc3ed42497 (abierta)E_NOT_OK: la operación ha fallado [SWS_IdsM_91006].
En caso de error (E_NOT_OK), el IdsM está obligado a proporcionar un Negative Response Code (NRC) concreto a través del parámetro de salida ErrorCode; si esto no sucede, el DCM envía por defecto el NRC 0x22 (Conditions Not Correct) [SWS_IdsM_91006].
La función únicamente inicia la rutina; la lectura propiamente dicha de los resultados obtenidos se realiza posteriormente a través de la función IdsM_Dcm_GetReportingMode_RequestResults [SWS_IdsM_91007].
Esta nota de uso se generó automáticamente. Todos los datos se basan exclusivamente en la especificación AUTOSAR Classic R20-11.
Guía del implementador pendiente (complejidad I2)
función IdsM_Dcm_SetReportingMode_Start [SWS_IdsM_91008] 📄 PDF
Std_ReturnType IdsM_Dcm_SetReportingMode_Start (uint16 In_SecurityEventId, uint8 In_SensorInstanceId, uint8 In_ReportingMode, Dcm_OpStatusType OpStatus, Dcm_NegativeResponseCodeType* ErrorCode);
This function is a request from DCM to the IdsM to start the routine execution to set the reporting mode of a specific Security Event ID.
El módulo de diagnóstico (DCM) llama a la función síncrona y reentrante IdsM_Dcm_SetReportingMode_Start para iniciar la rutina para el cambio del modo de notificación (IdsMReportingModeFilter) para un evento de seguridad determinado en el Intrusion Detection System Manager [SWS_IdsM_91008], [SWS_IdsM_01901]. La declaración se proporciona a través del archivo de cabecera IdsM_Cbk.h [SWS_IdsM_91008].
Durante la llamada se transmiten el ID de evento externo (In_SecurityEventId), el ID de instancia del sensor (In_SensorInstanceId), el nuevo modo de notificación que se debe establecer (In_ReportingMode), así como el estado de operación (OpStatus) [SWS_IdsM_91008], [SWS_IdsM_01901]. La función proporciona los siguientes valores de retorno:
E_OK: la ejecución de la operación ha finalizado correctamente [SWS_IdsM_91008].DCM_E_PENDING: el procesamiento aún no ha finalizado y se continúa de forma asíncrona [SWS_IdsM_91008].E_NOT_OK: la operación ha fallado; en este caso, se debe establecer un Negative Response Code (NRC) concreto mediante el parámetro de salidaErrorCode, ya que, de lo contrario, el DCM transmitirá el NRC0x22[SWS_IdsM_91008].
Si falla la validación del ID de evento debido a que se utilizó un Security Event Definition ID no válido, la función devuelve E_NOT_OK y establece obligatoriamente el código de error ErrorCode a DCM_E_REQUESTOUTOFRANGE [SWS_IdsM_01903].
Esta nota de uso se ha generado de forma automatizada y se basa en las especificaciones de AUTOSAR.
Guía del implementador pendiente (complejidad I2)
tipo IdsM_ConfigType [SWS_IdsM_91012] 📄 PDF
Configuration data structure of IdsM module.
tipo IdsM_Filters_BlockStateType [SWS_IdsM_91017] 📄 PDF
Data type used for "Block State" filter values (bit masks)
El tipo de datos IdsM_Filters_BlockStateType sirve para la definición de máscaras de bits para los denominados filtros «Block State» del Intrusion Detection System Manager (IdsM) conforme a [SWS_IdsM_91017]. El tipo se deriva de uint16, cubre el rango de valores enteros de 0 a 65535 y está disponible para módulos de software a través del encabezado IdsM_Filters_Types.h ([SWS_IdsM_91017]).
El uso principal tiene lugar en interacción con el Basic Software Mode Manager (BswM). En caso de cambios en el estado del sistema o de la ECU, el BswM llama a la función de callback IdsM_BswM_StateChanged y transfiere el estado actual de la ECU a través del parámetro state de este tipo ([SWS_IdsM_91005]). Esta interfaz de callback está declarada en IdsM_Cbk.h, no devuelve ningún valor y está especificada como síncrona y reentrante ([SWS_IdsM_91005]).
Interpretación: Dado que el tipo está concebido como máscara de bits para filtros, es de suponer que el IdsM compare el valor de estado de la ECU transferido con los estados de filtro configurados para filtrar la adquisición o el bloqueo de eventos de seguridad en función del estado de la ECU. Pregunta Q-00b355cc5ec6383f (abierta) No existe un tratamiento de errores autónomo con códigos de error específicos, mensajes DET o DEM para este tipo de datos.
Esta nota ha sido generada por una IA y se basa exclusivamente en los datos de especificación de AUTOSAR CP R20-11.
Guía del implementador pendiente (complejidad I1)
tipo IdsM_Filters_ReportingModeType [SWS_IdsM_91013] 📄 PDF
Reporting modes used by the reporting mode filter
El tipo de datos IdsM_Filters_ReportingModeType se basa en el tipo base uint8 y se proporciona a través del archivo de cabecera IdsM_Types.h para componentes de software [SWS_IdsM_91013]. Describe los modos de notificación estandarizados que se aplican dentro del filtro de modo de notificación en el Intrusion Detection System Manager (IdsM) para el procesamiento específico y reenvío de eventos de seguridad [SWS_IdsM_91013].
Mediante los valores de enumeración definidos se controla con precisión si se notifica un evento y qué nivel de detalle se aplica al respecto [SWS_IdsM_91013]:
IDSM_REPORTING_MODE_OFF(0x00): el evento se suprime y no se notifica a instancias de nivel superior [SWS_IdsM_91013].IDSM_REPORTING_MODE_BRIEF(0x01): El evento se notifica en forma compacta sin datos de contexto adicionales [SWS_IdsM_91013].IDSM_REPORTING_MODE_DETAILED(0x02): El evento se notifica detalladamente incluyendo todos los datos de contexto relevantes [SWS_IdsM_91013].IDSM_REPORTING_MODE_BRIEF_BYPASSING_FILTERS(0x03): El evento elude las etapas de filtrado posteriores y se notifica sin filtrar y sin datos de contexto [SWS_IdsM_91013].IDSM_REPORTING_MODE_DETAILED_BYPASSING_FILTERS(0x04): El evento elude las etapas de filtrado posteriores y se notifica sin filtrar, incluyendo todos los datos de contexto [SWS_IdsM_91013].IDSM_REPORTING_MODE_INVALID(0xFF): Identifica un modo de notificación no válido dentro del rango de valores [SWS_IdsM_91013].
Por tanto, los valores combinan dos dimensiones de control funcional: el grado de detalle a través de los datos de contexto y la elusión selectiva de los mecanismos de filtrado regulares mediante el bypassing [SWS_IdsM_91013]. Esto permite al IdsM un tratamiento diferenciado de los incidentes de seguridad según su criticidad y configuración de filtrado [SWS_IdsM_91013].
Este texto ha sido generado por una IA a partir de la especificación R20-11.
Guía del implementador pendiente (complejidad I1)
tipo IdsM_TimestampType [SWS_IdsM_91014] 📄 PDF
Data type for IdsM timestamps
tipo IdsM_SecurityEventIdType [SWS_IdsM_91031] 📄 PDF
Data type used for local IdsM Security Event IDs
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_IdsM- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_IdsM@rel:R20-11#cac85f84- Content hash
cac85f84- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_IntrusionDetectionSystemManager.pdf#nameddest=SWS_IdsM_91001
gemini-3.8-flash-low· 2026-10-13 · Original en alemán