Intrusion Detection System Manager (IdsM)

A interface síncrona e não reentrante IdsM_Init destina-se à inicialização fundamental do módulo IdsM de acordo com [SWS_IdsM_91001]. Aquando da chamada, o serviço inicializa a totalidade das variáveis internas e transfere o IdsM para o estado inicializado ([SWS_IdsM_00202]). Através do parâmetro de entrada configPtr, a função recebe um apontador para a estrutura de configuração específica do módulo ([SWS_IdsM_91001]).

A execução de IdsM_Init constitui uma pré-condição funcional obrigatória para a operação do módulo. Se for chamada uma API do IdsM que não IdsM_Init ou IdsM_GetVersionInfo no estado ainda não inicializado, o módulo reporta, caso a deteção de erros de desenvolvimento (IdsMDevErrorDetect) esteja ativa, o erro IDSM_E_PARAM_UNINIT via Det_ReportError ([SWS_IdsM_00203], veja-se também o código de erro 0x0D em [SWS_IdsM_02003]).

Aplicam-se regras de comportamento específicas para o tratamento de erros e o contexto de chamada:

• Se IdsM_Init for chamada enquanto o módulo já se encontra no estado inicializado, não é efetuada uma reinicialização das variáveis internas ([SWS_IdsM_00204]).
• Em vez disso, com IdsMDevErrorDetect ativo, o módulo reporta através de Det_ReportError o erro de desenvolvimento IDSM_E_ALREADY_INITIALIZED com o valor numérico 0x0E ([SWS_IdsM_00204], [SWS_IdsM_02003]).
• A função não possui valor de retorno e está definida como não reentrante ([SWS_IdsM_91001]). Por conseguinte, não pode ser chamada concorrentemente ou por contextos de interrupção múltiplas vezes em simultâneo no sistema.

Utilização e contexto de chamada

A função IdsM_MainFunction é chamada periodicamente e está disponível através do arquivo de cabeçalho IdsM.h [SWS_IdsM_91000]. Ela possui a assinatura void IdsM_MainFunction(void), não recebe parâmetros e não possui valor de retorno [SWS_IdsM_91000]. A chamada da função em si é síncrona, mas serve ao processamento assíncrono de eventos de segurança (Security Events, SEv) que foram previamente enfileirados durante chamadas síncronas de API [SWS_IdsM_91000]. É provável que o acionamento periódico seja realizado tipicamente pelo escalonador BSW ou por uma tarefa cíclica do sistema operacional. Pergunta Q-86e2e870c3496bad (aberta)

Simultaneidade e restrições

De acordo com a especificação, IdsM_MainFunction é classificada como não reentrante (Non Reentrant) [SWS_IdsM_91000]. O ambiente do sistema chamador deve, portanto, assegurar que a função seja executada a qualquer momento em apenas uma única instância e que não ocorram chamadas sobrepostas.

Interação no processamento de eventos

A tarefa principal no âmbito do processamento cíclico abrange os seguintes aspectos:

• Buffer de eventos: após a recepção de um SEv, o IdsM o armazena em um Event Buffer; esses buffers são gerenciados e filtrados de forma assíncrona no âmbito de IdsM_MainFunction [SWS_IdsM_00702].
• Buffer de dados de contexto: caso um SEv seja recebido com dados de contexto, o IdsM utiliza buffers adequados de um Context Data Buffer Pool; esses buffers também são tratados e filtrados de forma assíncrona em IdsM_MainFunction [SWS_IdsM_00705].
• Qualificação: os SEv armazenados nos Event Buffers são processados de forma assíncrona para identificá-los como eventos de segurança qualificados (QSEv) [SWS_IdsM_00901].

A função de callback é chamada de forma síncrona e reentrante para recuperar dados de transmissão para segmentos de uma I-PDU (N-PDU) [SWS_IdsM_91010]. Ela está disponível através do cabeçalho IdsM_Cbk.h e atende ao ID de serviço 0x43 [SWS_IdsM_91010].

Por meio de id, identifica-se a I-PDU a ser transmitida [SWS_IdsM_91010]. O parâmetro info passa o buffer de destino (SduDataPtr) bem como o comprimento solicitado em bytes (SduLength); um valor de 0 para SduLength (sendo que SduDataPtr pode ser um NULL_PTR) serve para mudanças de estado no parâmetro retry ou para a consulta de dados restantes [SWS_IdsM_91010]. Através de availableDataPtr, a função retorna a quantidade de dados restante no buffer Tx, o que permite que protocolos de transporte com comprimentos úteis dinâmicos (por exemplo, FrIsoTp) determinem o tamanho de Consecutive Frames subsequentes [SWS_IdsM_91010].

Se retry for um NULL_PTR, os dados copiados podem ser liberados do buffer imediatamente após o processo de cópia [SWS_IdsM_91010]. Caso contrário, RetryInfoType controla o tratamento de erros: em TP_CONFPENDING, os dados previamente copiados permanecem no buffer TP, enquanto TP_DATACONF confirma e libera todos os dados copiados antes desta chamada [SWS_IdsM_91010]. Se TpDataState estiver definido como TP_DATARETRY, a função copia novamente dados previamente transmitidos a partir do deslocamento de bytes indicado por TxTpDataCnt [SWS_IdsM_91010].

A função retorna BUFREQ_OK em caso de cópia completa bem-sucedida [SWS_IdsM_91010]. Se não houver dados de transmissão suficientes disponíveis, nenhum dado é copiado e é retornado BUFREQ_E_BUSY, após o que o módulo subordinado pode repetir a chamada [SWS_IdsM_91010]. Se a solicitação falhar, ocorre o retorno de BUFREQ_E_NOT_OK sem transferência de dados [SWS_IdsM_91010].

A função IdsM_SetSecurityEvent serve de interface para que as aplicações reportem eventos de segurança ao módulo IdsM (Intrusion Detection System Manager) [SWS_IdsM_91002].

Utilização e contexto de chamada

A chamada ocorre de forma síncrona através do ficheiro de cabeçalho IdsM.h com o Service-ID 0x03 [SWS_IdsM_91002]. Como único parâmetro de passagem, é transmitido o identificador do evento de segurança:

• securityEventId (IN, IdsM_SecurityEventIdType): Identificador unívoco do evento de segurança notificado [SWS_IdsM_91002].

A função não possui valor de retorno (void) [SWS_IdsM_91002].

Tratamento de erros

Se a deteção de erros de desenvolvimento (IdsMDevErrorDetect) estiver ativada, o módulo verifica o parâmetro securityEventId face aos eventos de segurança configurados [SWS_IdsM_02101]. Se for transmitido um ID de evento desconhecido que não tenha sido configurado em IdsMEvent, o IdsM reporta o erro de desenvolvimento IDSM_E_PARAM_INVALID [SWS_IdsM_02101].

Simultaneidade e restrições

A função é especificada como não reentrante (Non Reentrant) [SWS_IdsM_91002]. Chamadas concorrentes ou de interrupção a partir de diferentes contextos devem, portanto, ser sincronizadas ou evitadas pelo chamador.

A função IdsM_SetSecurityEventWithContextData serve como interface de aplicação para a notificação síncrona de eventos de segurança juntamente com dados de contexto opcionais ao Intrusion Detection System Manager ([SWS_IdsM_91003]). Ela não possui valor de retorno.

Parâmetros e uso

• securityEventId: Identificador unívoco do evento de segurança notificado ([SWS_IdsM_91003]).
• contextData: Ponteiro para dados de contexto opcionais; se não houver dados de contexto disponíveis, deve-se passar NULL_PTR ([SWS_IdsM_91003]).
• contextDataSize: Tamanho dos dados de contexto fornecidos em bytes ([SWS_IdsM_91003]).

Tratamento de erros

Com a detecção de desenvolvimento ativada (IdsMDevErrorDetect), o módulo IdsM executa as seguintes verificações:

• Se o securityEventId passado não for proveniente dos eventos de segurança configurados em IdsMEvent, o erro de desenvolvimento IDSM_E_PARAM_INVALID é notificado ([SWS_IdsM_02102]).
• Se contextDataSize exceder o tamanho máximo de buffer configurado para dados de contexto (definido pelo maior valor parametrizado de IdsMContextDataBufferSize), o erro de desenvolvimento IDSM_E_PARAM_LENGTH é notificado ([SWS_IdsM_02107]).

Simultaneidade e integração

A interface é especificada como não reentrante (Non Reentrant) ([SWS_IdsM_91003]). Os chamadores devem, portanto, assegurar que chamadas concorrentes sejam evitadas ou devidamente sincronizadas. A declaração está disponível através do cabeçalho IdsM.h ([SWS_IdsM_91003]).

A função síncrona IdsM_SetSecurityEventWithCount (ID de serviço 0x05) representa a interface de aplicação para Smart Sensors, a fim de transmitir eventos de segurança (Security Events, SEvs) juntamente com um valor de contagem ao IdsM [SWS_IdsM_91018], [SWS_IdsM_00401]. Desta forma, o IdsM pode receber eventos com um contador pré-calculado pelo sensor [SWS_IdsM_00401]. A declaração da função é disponibilizada através do ficheiro de cabeçalho IdsM.h [SWS_IdsM_91018].

Ao ser chamada, a função espera dois parâmetros de entrada:

• securityEventId: Identificador do evento de segurança do tipo IdsM_SecurityEventIdType [SWS_IdsM_91018].
• count: Valor de contagem do tipo uint16, que provém do sensor e atua como valor inicial de partida para o evento [SWS_IdsM_91018], [SWS_IdsM_00401].

A função não fornece qualquer valor de retorno e não define parâmetros de saída [SWS_IdsM_91018]. No que diz respeito à concorrência e ao contexto de chamada, a função está declarada como não reentrante (Non Reentrant) [SWS_IdsM_91018]; as chamadas paralelas têm, por isso, de ser evitadas a nível de software.

Para o tratamento de erros, está definido que o IdsM, com a deteção de desenvolvimento ativada (IdsMDevErrorDetect), verifica os parâmetros securityEventId e count [SWS_IdsM_02103]. Se for passado um ID de evento desconhecido ou se count contiver o valor 0, é reportado o erro de desenvolvimento IDSM_E_PARAM_INVALID [SWS_IdsM_02103].

A função IdsM_SetSecurityEventWithCountContextData serve como interface de aplicação para sensores inteligentes para a notificação síncrona de eventos de segurança com valor de contagem e dados de contexto opcionais ao [SWS_IdsM_91019].

Utilização e parâmetros

A chamada ocorre de forma síncrona e é especificada como não reentrante (Non Reentrant) [SWS_IdsM_91019]:

• securityEventId: Identificador unívoco do evento de segurança [SWS_IdsM_91019].
• count: Valor de contagem utilizado como valor inicial para o evento de segurança [SWS_IdsM_91019].
• contextData: Ponteiro para um array de bytes com os dados de contexto a serem fornecidos [SWS_IdsM_00502]. Se não houver dados de contexto, deve-se passar NULL_PTR [SWS_IdsM_91019].
• contextDataSize: Tamanho dos dados de contexto passados em bytes [SWS_IdsM_91019]. A função suporta um comprimento máximo de até 1500 bytes [SWS_IdsM_00501].

Tratamento de erros

Com a detecção de desenvolvimento ativada (IdsMDevErrorDetect), o módulo monitora a validade dos argumentos passados:

• O erro de desenvolvimento IDSM_E_PARAM_INVALID é notificado caso um securityEventId desconhecido seja passado ou count apresente o valor 0 [SWS_IdsM_02104].
• Se contextDataSize exceder o tamanho máximo de buffer configurado (determinado pela maior IdsMContextDataBufferSize configurada), o IdsM notifica o erro de desenvolvimento IDSM_E_PARAM_LENGTH [SWS_IdsM_02108].

A função não retorna nenhum valor [SWS_IdsM_91019]; uma reação a falhas em caso de erro provavelmente se baseará primariamente na notificação através do DET. Pergunta Q-135f4b865790f34d (aberta)

A interface síncrona IdsM_SetSecurityEventWithTimestampCount serve para os Smart Sensors notificarem eventos de segurança com carimbo de data/hora e valor de contagem ao IdsM [SWS_IdsM_91020]. A função não possui valor de retorno e está disponível através do ficheiro de cabeçalho IdsM.h [SWS_IdsM_91020].

São processados os seguintes parâmetros de entrada:

• securityEventId: Identificador específico do evento de segurança reportado [SWS_IdsM_91020].
• timestamp: Carimbo de data/hora para a referenciação temporal do evento [SWS_IdsM_91020]. Se a funcionalidade de carimbo de data/hora estiver ativa e for transmitido um carimbo de data/hora, o IdsM utiliza-o para o armazenamento ou transmissão do Security Event qualificado (QSEv) [SWS_IdsM_01108]. Se, pelo contrário, com a funcionalidade ativa o evento for reportado sem carimbo de data/hora, o IdsM define o bit de opção para o carimbo de data/hora no cabeçalho do protocolo para 0 antes da transmissão ou do armazenamento [SWS_IdsM_01112].
• count: Valor de contagem como valor inicial para o evento de segurança [SWS_IdsM_91020]. Se não estiver previamente disponível nenhum contador calculado, a função pode ser chamada com o valor 1 [SWS_IdsM_00405].

Com a deteção de desenvolvimento ativada (IdsMDevErrorDetect), o IdsM valida os argumentos securityEventId e count. Caso seja transmitido um ID de evento desconhecido ou count apresente o valor 0, o módulo reporta o erro de desenvolvimento IDSM_E_PARAM_INVALID [SWS_IdsM_02105].

Relativamente à concorrência, a função está especificada como não reentrante (Non Reentrant) [SWS_IdsM_91020].

A função IdsM_SetSecurityEventWithTimestampCountContextData com o ID de serviço 0x08 serve como interface de aplicação padronizada para Smart Sensors, a fim de reportar eventos de segurança juntamente com um carimbo de data/hora, um valor inicial de contagem, bem como dados de contexto opcionais ao Intrusion Detection System Manager (IdsM) [SWS_IdsM_91021]. A declaração desta interface é disponibilizada através do header IdsM.h [SWS_IdsM_91021].

A chamada é executada de forma síncrona e utiliza exclusivamente parâmetros de entrada, não existindo parâmetros de entrada/saída nem parâmetros de saída [SWS_IdsM_91021]. Na chamada, devem ser passados os seguintes parâmetros [SWS_IdsM_91021]:

• securityEventId: Identificador do evento de segurança específico a ser transmitido ao IdsM [SWS_IdsM_91021].
• timestamp: Valor de carimbo de data/hora que atua como referência temporal do evento de segurança ocorrido [SWS_IdsM_91021].
• count: Valor de contagem utilizado pelo IdsM como valor inicial para o respetivo evento de segurança [SWS_IdsM_91021].
• contextData: Ponteiro para dados de contexto opcionais relativos ao evento; caso não estejam disponíveis dados, deve ser passado NULL_PTR [SWS_IdsM_91021].
• contextDataSize: Indicação numérica sobre o tamanho dos dados de contexto transmitidos [SWS_IdsM_91021].

No que diz respeito ao comportamento de execução, a função está classificada como não reentrante (Non Reentrant) e não possui valor de retorno (void) [SWS_IdsM_91021]. Os Smart Sensors que a chamam devem, portanto, assegurar que não ocorrem chamadas simultâneas ou sobrepostas da interface [SWS_IdsM_91021].

A função de callback IdsM_BswM_StateChanged ([SWS_IdsM_91005]) é chamada pelo BswM para sinalizar ao Intrusion Detection System Manager (IdsM) alterações do estado atual da unidade de comando ([SWS_IdsM_91005]). Encontra-se declarada no ficheiro de cabeçalho IdsM_Cbk.h e possui o Service-ID 0x0F ([SWS_IdsM_91005]).

A interface possui a assinatura void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state) ([SWS_IdsM_91005]). Como único valor de passagem, serve o parâmetro de entrada state do tipo IdsM_Filters_BlockStateType, o qual reflete o estado atual da ECU ([SWS_IdsM_91005]). Não estão previstos parâmetros de entrada/saída nem parâmetros de saída, e a função não devolve qualquer valor de retorno ([SWS_IdsM_91005]). A chamada é executada de forma síncrona e está classificada como reentrante ([SWS_IdsM_91005]).

Na interação funcional, este serviço de notificação serve para que o IdsM seja informado continuamente pelo BswM sobre o estado atual ([SWS_IdsM_01022]). A informação de estado recebida é mantida no IdsM e avaliada no processamento assíncrono posterior de filtros de block-state (block state filter) no âmbito da função principal (main function) ([SWS_IdsM_01022]). Para esta chamada, não estão definidos códigos de erro específicos, valores de retorno ou mensagens para o desenvolvimento (DET) ou para o Diagnostic Event Management (DEM) no âmbito da especificação.

A função de callback IdsM_TpTxConfirmation é declarada como serviço síncrono e reentrante por meio do arquivo de cabeçalho IdsM_Cbk.h [SWS_IdsM_91011]. De acordo com [SWS_IdsM_01502], o módulo IdsM recebe por meio deste serviço a confirmação do módulo PduR para a transmissão de uma PDU segmentada. A chamada ocorre assim que a respectiva I-PDU tiver sido transmitida na rede subjacente [SWS_IdsM_91011].

A interface possui o Service ID 0x48 e não fornece valor de retorno (void) [SWS_IdsM_91011]. Na chamada, são passados dois parâmetros de entrada:

• id (tipo PduIdType): identificação unívoca da I-PDU transmitida [SWS_IdsM_91011].
• result (tipo Std_ReturnType): transmite o resultado da transmissão da I-PDU e indica se o processo de envio foi bem-sucedido ou falhou [SWS_IdsM_91011].

Códigos de erro específicos, bem como mensagens de DET ou DEM, não são definidos para esta chamada na especificação. Graças à reentrância especificada, a função pode ser chamada pela camada chamadora em paralelo para diferentes I-PDUs [SWS_IdsM_91011]. Interpretação: o módulo IdsM provavelmente deve avaliar o parâmetro de status result para atualizar o status de transmissão interno da PDU segmentada e liberar os buffers de transmissão ocupados após a conclusão. Pergunta Q-9179efcbf744346d (aberta)

usar

A função de callback IdsM_TxConfirmation ([SWS_IdsM_91009]) é chamada por um módulo de interface de comunicação subjacente para confirmar o envio bem-sucedido de uma PDU ou a falha da transmissão. Está definida como síncrona, declarada em IdsM_Cbk.h e não possui valor de retorno. Recebe os seguintes parâmetros:

• TxPduId: Identificador da PDU transmitida ([SWS_IdsM_91009]).
• result: Resultado da transmissão com E_OK em caso de envio bem-sucedido ou E_NOT_OK em caso de ocorrência de erro ([SWS_IdsM_91009]).

Simultaneidade e restrições

A função é reentrante para diferentes IDs de PDU, contudo não é reentrante para o mesmo TxPduId ([SWS_IdsM_91009]).

Interação e condições de ordenação

Aplica-se uma condição de ordem estrita para a sequência de transmissão: De acordo com [SWS_IdsM_01499], o IdsM só pode voltar a chamar a função de envio PduR_IdsMTransmit depois de IdsM_TxConfirmation ou IdsM_TpTxConfirmation ter sido chamada previamente. Interpretação: A receção da confirmação deverá servir de gatilho no IdsM para concluir a transmissão e libertar chamadas subsequentes. Pergunta Q-dd4013520e85370c (aberta)

Tratamento de erros

Uma falha na transmissão da PDU é comunicada diretamente através do parâmetro result = E_NOT_OK ([SWS_IdsM_91009]). Não estão indicados códigos de erro de DET ou DEM específicos na especificação da interface.

Utilização e contexto de chamada

A função síncrona IdsM_Dcm_GetReportingMode_RequestResults (Service-ID 0x0D, cabeçalho IdsM_Cbk.h) é chamada pelo Diagnostic Communication Manager (DCM) para consultar os resultados de rotina de um pedido previamente iniciado através de IdsM_Dcm_GetReportingMode_Start() [SWS_IdsM_91007]. Através do parâmetro de passagem OpStatus é transmitido o estado operacional atual [SWS_IdsM_91007]. Em caso de conclusão bem-sucedida, a função devolve E_OK e fornece através do ponteiro de saída Out_ReportingMode o modo de reporte determinado do Security Event solicitado [SWS_IdsM_91007]. Se o processamento ainda não estiver concluído, sinaliza-o através do valor de retorno DCM_E_PENDING [SWS_IdsM_91007].

Tratamento de erros

Se a consulta falhar, a função retorna E_NOT_OK [SWS_IdsM_91007]. Neste caso, deve ser definido um Negative Response Code (Dcm_NegativeResponseCodeType) concreto através do parâmetro ErrorCode; se este permanecer por definir, o DCM envia o código de erro 0x22 [SWS_IdsM_91007]. Eventos específicos de DET ou DEM não estão indicados para este serviço [SWS_IdsM_91007].

Concorrência e interação

A função é especificada como reentrante [SWS_IdsM_91007]. Relativamente à sequência de chamada, pressupõe obrigatoriamente que a rotina tenha sido acionada previamente através de IdsM_Dcm_GetReportingMode_Start() [SWS_IdsM_91007]. Interpretação: O parâmetro OpStatus deverá ser utilizado pelo DCM em consultas repetidas após o retorno de DCM_E_PENDING para coordenar o progresso da operação de diagnóstico. Pergunta Q-c268fab018a1f5b3 (aberta)

A função IdsM_Dcm_GetReportingMode_Start é chamada pelo módulo de diagnóstico (DCM) para iniciar no Intrusion Detection System Manager (IdsM) a execução de uma rotina para consulta do modo de relatório atual de um Security Event (SEv) específico [SWS_IdsM_91006], [SWS_IdsM_02001]. A interface é declarada no cabeçalho IdsM_Cbk.h, possui o Service ID 0x0C e é especificada como síncrona e reentrante [SWS_IdsM_91006].

Na chamada, o DCM passa o ID externo do evento de segurança (In_SecurityEventId), o ID de instância do sensor (In_SensorInstanceId) e o status da operação (OpStatus) [SWS_IdsM_91006]. Como valor de retorno, a função fornece Std_ReturnType:

• E_OK: A operação foi concluída com sucesso [SWS_IdsM_91006].
• DCM_E_PENDING: a operação ainda não foi concluída [SWS_IdsM_91006]. Isso provavelmente indica que o processamento interno da rotina continuará de forma multicíclica ou assíncrona até que os dados estejam disponíveis. Pergunta Q-395a30fc3ed42497 (aberta)
• E_NOT_OK: A operação falhou [SWS_IdsM_91006].

Em caso de erro (E_NOT_OK), o IdsM é obrigado a fornecer um Negative Response Code (NRC) concreto por meio do parâmetro de saída ErrorCode; caso isso não ocorra, o DCM envia por padrão o NRC 0x22 (Conditions Not Correct) [SWS_IdsM_91006].

A função apenas dispara a rotina; a leitura propriamente dita dos resultados apurados ocorre posteriormente por meio da função IdsM_Dcm_GetReportingMode_RequestResults [SWS_IdsM_91007].

A função síncrona e reentrante IdsM_Dcm_SetReportingMode_Start é chamada pelo módulo de diagnóstico (DCM) para iniciar a rotina de alteração do modo de relatório (IdsMReportingModeFilter) para um determinado evento de segurança no Intrusion Detection System Manager [SWS_IdsM_91008], [SWS_IdsM_01901]. A declaração é disponibilizada através do ficheiro de cabeçalho IdsM_Cbk.h [SWS_IdsM_91008].

Aquando da chamada, são transmitidos o ID de evento externo (In_SecurityEventId), o ID de instância de sensor (In_SensorInstanceId), o novo modo de relatório a definir (In_ReportingMode) e o estado operacional (OpStatus) [SWS_IdsM_91008], [SWS_IdsM_01901]. A função devolve os seguintes valores de retorno:

• E_OK: A execução da operação foi concluída com sucesso [SWS_IdsM_91008].
• DCM_E_PENDING: O processamento ainda não está concluído e é continuado de forma assíncrona [SWS_IdsM_91008].
• E_NOT_OK: A operação falhou; neste caso, deve ser definido um Negative Response Code (NRC) concreto através do parâmetro de saída ErrorCode, caso contrário o DCM transmite o NRC 0x22 [SWS_IdsM_91008].

Se a validação do ID de evento falhar devido à utilização de um Security Event Definition ID inválido, a função devolve E_NOT_OK e define obrigatoriamente o código de erro ErrorCode para DCM_E_REQUESTOUTOFRANGE [SWS_IdsM_01903].

O tipo de dados IdsM_Filters_BlockStateType serve para a definição de máscaras de bits para filtros de «Block State» do Intrusion Detection System Manager (IdsM) de acordo com [SWS_IdsM_91017]. O tipo é derivado de uint16, cobre o intervalo de valores inteiros de 0 a 65535 e é disponibilizado para módulos de software através do header IdsM_Filters_Types.h ([SWS_IdsM_91017]).

A utilização primária ocorre em interação com o Basic Software Mode Manager (BswM). No caso de alterações do estado do sistema ou da centralina, o BswM chama a função de callback IdsM_BswM_StateChanged e passa o estado atual da centralina através do parâmetro state deste tipo ([SWS_IdsM_91005]). Esta interface de callback está declarada em IdsM_Cbk.h, não possui valores de retorno e está especificada como síncrona, bem como reentrante ([SWS_IdsM_91005]).

Interpretação: Como o tipo foi concebido como máscara de bits para filtros, é provável que o IdsM compare o valor de estado da ECU transmitido com estados de filtro configurados, para filtrar a aquisição ou o bloqueio de eventos de segurança em função do estado da centralina. Pergunta Q-00b355cc5ec6383f (aberta) Não existe um tratamento de erros autónomo com códigos de erro específicos, mensagens DET ou DEM para este tipo de dados.

O tipo de dados IdsM_Filters_ReportingModeType baseia-se no tipo de base uint8 e é disponibilizado para componentes de software através do ficheiro de cabeçalho IdsM_Types.h [SWS_IdsM_91013]. Descreve os modos de relatório padronizados que são aplicados dentro do filtro Reporting-Mode no Intrusion Detection System Manager (IdsM) para o processamento e reencaminhamento direcionados de eventos de segurança [SWS_IdsM_91013].

Através dos valores de enumeração definidos, é controlado com precisão se um evento é reportado e que nível de detalhe é utilizado para o efeito [SWS_IdsM_91013]:

• IDSM_REPORTING_MODE_OFF (0x00): O evento é suprimido e não é reportado a instâncias superiores [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF (0x01): O evento é reportado sem dados de contexto adicionais de forma compacta [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED (0x02): O evento é reportado de forma detalhada com inclusão de todos os dados de contexto relevantes [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF_BYPASSING_FILTERS (0x03): O evento contorna as etapas de filtragem subsequentes e é reportado sem dados de contexto, de forma não filtrada [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED_BYPASSING_FILTERS (0x04): O evento contorna as etapas de filtragem subsequentes e é reportado de forma não filtrada, incluindo a totalidade dos dados de contexto [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_INVALID (0xFF): Identifica um modo de relatório inválido dentro do intervalo de valores [SWS_IdsM_91013].

Os valores combinam, portanto, duas dimensões de controlo funcionais: o grau de detalhe através dos dados de contexto, bem como o desvio direcionado de mecanismos de filtragem regulares através do bypassing [SWS_IdsM_91013]. Isto permite ao IdsM um tratamento diferenciado de incidentes de segurança consoante a criticalidade e a configuração de filtragem [SWS_IdsM_91013].