Intrusion Detection System Manager (IdsM)

동기식 및 비재진입 인터페이스 IdsM_Init은 [SWS_IdsM_91001]에 따른 IdsM 모듈의 기본 초기화에 사용됩니다. 호출 시 서비스는 모든 내부 변수를 초기화하고 IdsM을 초기화된 상태([SWS_IdsM_00202])로 전환합니다. 입력 파라미터 configPtr을 통해 이 함수는 모듈별 구성 구조체에 대한 포인터를 전달받습니다([SWS_IdsM_91001]).

IdsM_Init의 실행은 모듈 동작을 위한 필수적인 기능적 전제조건입니다. 아직 초기화되지 않은 상태에서 IdsM_Init 또는 IdsM_GetVersionInfo 이외의 IdsM API가 호출되는 경우, 개발 감지(IdsMDevErrorDetect)가 활성화되어 있으면 모듈은 Det_ReportError를 통해 오류 IDSM_E_PARAM_UNINIT를 보고합니다([SWS_IdsM_00203], [SWS_IdsM_02003] 아래의 오류 코드 0x0D도 참조).

오류 처리 및 호출 컨텍스트에는 특정 동작 규칙이 적용됩니다:

• 모듈이 이미 초기화된 상태에 있는 동안 IdsM_Init이 호출되면 내부 변수의 재초기화가 수행되지 않습니다([SWS_IdsM_00204]).
• 대신 IdsMDevErrorDetect이 활성화되어 있는 경우 모듈은 Det_ReportError을 통해 숫자 값 0x0E을 갖는 개발 오류 IDSM_E_ALREADY_INITIALIZED를 보고합니다([SWS_IdsM_00204], [SWS_IdsM_02003]).
• 이 함수는 반환값이 없으며 비재진입([SWS_IdsM_91001])으로 정의되어 있습니다. 따라서 시스템 내에서 동시적으로 또는 인터럽트 컨텍스트에 의해 동시에 여러 번 호출되어서는 안 됩니다.

사용법 및 호출 컨텍스트

함수 IdsM_MainFunction은 주기적으로 호출되며 헤더 파일 IdsM.h을 통해 사용할 수 있습니다 [SWS_IdsM_91000]. 이 함수는 void IdsM_MainFunction(void) 시그니처를 가지며, 매개변수를 받지 않고 반환값도 없습니다 [SWS_IdsM_91000]. 함수 자체의 호출은 동기식이지만, 동기 API 호출 중에 이전에 대기열에 들어간 보안 이벤트(Security Events, SEv)를 비동기적으로 처리하는 역할을 합니다 [SWS_IdsM_91000]. 주기적 트리거링은 일반적으로 BSW 스케줄러 또는 주기적 OS 태스크에 의해 수행될 것으로 보입니다. 질문 Q-86e2e870c3496bad (열림)

동시성 및 제약사항

사양에 따라 IdsM_MainFunction은 재진입 불가(Non Reentrant)로 분류됩니다 [SWS_IdsM_91000]. 따라서 호출 시스템 환경은 함수가 특정 시점에 단일 인스턴스로만 실행되고 중복 호출이 발생하지 않도록 보장해야 합니다.

이벤트 처리 상호작용

주기적 처리 프레임워크 내의 주요 작업에는 다음 측면들이 포함됩니다:

• 이벤트 버퍼: SEv를 수신한 후 IdsM은 이를 Event Buffer에 저장합니다. 이러한 버퍼는 IdsM_MainFunction의 일부로 비동기식으로 관리되고 필터링됩니다 [SWS_IdsM_00702].
• 컨텍스트 데이터 버퍼: 컨텍스트 데이터와 함께 SEv를 수신하면 IdsM은 Context Data Buffer Pool에서 적절한 버퍼를 사용합니다. 이러한 버퍼 역시 IdsM_MainFunction에서 비동기식으로 처리되고 필터링됩니다 [SWS_IdsM_00705].
• 검증: Event Buffers에 저장된 SEv는 검증된 보안 이벤트(QSEv)로 식별하기 위해 비동기식으로 처리됩니다 [SWS_IdsM_00901].

콜백 함수는 I-PDU(N-PDU) 세그먼트에 대한 송신 데이터를 검색하기 위해 동기식 및 재진입 가능 방식으로 호출됩니다 [SWS_IdsM_91010]. 이 함수는 헤더 IdsM_Cbk.h을 통해 제공되며 서비스 ID 0x43를 처리합니다 [SWS_IdsM_91010].

id을 통해 전송할 I-PDU가 식별됩니다 [SWS_IdsM_91010]. 매개변수 info는 대상 버퍼(SduDataPtr)와 요청된 바이트 길이(SduLength)를 전달합니다. SduLength에 대한 0 값(여기서 SduDataPtr은 NULL_PTR일 수 있음)은 매개변수 retry의 상태 변경 또는 남은 데이터 쿼리에 사용됩니다 [SWS_IdsM_91010]. availableDataPtr을 통해 함수는 Tx 버퍼에 남아 있는 데이터 양을 보고하므로, 동적 페이로드 길이를 갖는 전송 프로토콜(예: FrIsoTp)이 후속 Consecutive Frame의 크기를 결정할 수 있습니다 [SWS_IdsM_91010].

retry이 NULL_PTR인 경우, 복사된 데이터는 복사 프로세스 직후 버퍼에서 해제될 수 있습니다 [SWS_IdsM_91010]. 그렇지 않으면 RetryInfoType이 오류 처리를 제어합니다. TP_CONFPENDING의 경우 이전에 복사된 데이터가 TP 버퍼에 유지되는 반면, TP_DATACONF는 이 호출 이전에 복사된 모든 데이터를 확인하고 해제합니다 [SWS_IdsM_91010]. TpDataState이 TP_DATARETRY로 설정된 경우 함수는 TxTpDataCnt로 지정된 바이트 오프셋부터 이전에 전송된 데이터를 다시 복사합니다 [SWS_IdsM_91010].

전체 복사에 성공하면 함수는 BUFREQ_OK을 반환합니다 [SWS_IdsM_91010]. 사용 가능한 송신 데이터가 충분하지 않은 경우 데이터가 복사되지 않고 BUFREQ_E_BUSY가 반환되며, 이후 하위 모듈이 호출을 재시도할 수 있습니다 [SWS_IdsM_91010]. 요청이 실패하면 데이터 복사 없이 BUFREQ_E_NOT_OK가 반환됩니다 [SWS_IdsM_91010].

함수 IdsM_SetSecurityEvent은 애플리케이션이 IdsM(Intrusion Detection System Manager) 모듈에 보안 이벤트를 보고하기 위한 인터페이스 역할을 합니다 [SWS_IdsM_91002].

사용법 및 호출 컨텍스트

호출은 서비스 ID 0x03을 갖는 헤더 파일 IdsM.h을 통해 동기식으로 수행됩니다 [SWS_IdsM_91002]. 유일한 전달 파라미터로 보안 이벤트의 식별자가 전달됩니다:

• securityEventId (IN, IdsM_SecurityEventIdType): 보고된 보안 이벤트의 고유 식별자 [SWS_IdsM_91002].

이 함수는 반환값이 없습니다(void) [SWS_IdsM_91002].

오류 처리

개발 오류 감지(IdsMDevErrorDetect)가 활성화된 경우 모듈은 구성된 보안 이벤트에 대해 파라미터 securityEventId을 검사합니다 [SWS_IdsM_02101]. IdsMEvent에 구성되지 않은 알 수 없는 이벤트 ID가 전달되면 IdsM은 개발 오류 IDSM_E_PARAM_INVALID를 보고합니다 [SWS_IdsM_02101].

동시성 및 제약사항

이 함수는 비재진입(Non Reentrant)으로 명세되어 있습니다 [SWS_IdsM_91002]. 따라서 서로 다른 컨텍스트에서의 동시 호출 또는 인터럽트 호출은 호출자에 의해 동기화되거나 방지되어야 합니다.

함수 IdsM_SetSecurityEventWithContextData은 선택적 컨텍스트 데이터와 함께 보안 이벤트를 Intrusion Detection System Manager([SWS_IdsM_91003])에 동기식으로 보고하기 위한 애플리케이션 인터페이스 역할을 합니다. 이 함수는 반환값이 없습니다.

매개변수 및 사용법

• securityEventId: 보고된 보안 이벤트의 고유 식별자([SWS_IdsM_91003]).
• contextData: 선택적 컨텍스트 데이터에 대한 포인터입니다. 컨텍스트 데이터를 사용할 수 없는 경우 NULL_PTR을 전달해야 합니다([SWS_IdsM_91003]).
• contextDataSize: 제공된 컨텍스트 데이터의 바이트 단위 크기([SWS_IdsM_91003]).

오류 처리

개발 오류 감지(IdsMDevErrorDetect)가 활성화된 경우 IdsM 모듈은 다음 검사를 수행합니다:

• 전달된 securityEventId이 IdsMEvent에 구성된 보안 이벤트에 속하지 않는 경우, 개발 오류 IDSM_E_PARAM_INVALID가 보고됩니다([SWS_IdsM_02102]).
• contextDataSize이 컨텍스트 데이터에 대해 구성된 최대 버퍼 크기(매개변수화된 IdsMContextDataBufferSize의 최댓값으로 정의됨)를 초과하는 경우, 개발 오류 IDSM_E_PARAM_LENGTH가 보고됩니다([SWS_IdsM_02107]).

동시성 및 통합

이 인터페이스는 재진입 불가(Non Reentrant)로 지정되어 있습니다([SWS_IdsM_91003]). 따라서 호출자는 동시 호출을 방지하거나 적절히 동기화해야 합니다. 선언은 헤더 IdsM.h를 통해 제공됩니다([SWS_IdsM_91003]).

동기식 함수 IdsM_SetSecurityEventWithCount(서비스 ID 0x05)은 Smart Sensors가 보안 이벤트(Security Events, SEvs)를 카운트 값과 함께 IdsM에 전달하기 위한 애플리케이션 인터페이스를 제공합니다 [SWS_IdsM_91018], [SWS_IdsM_00401]. 이를 통해 IdsM은 센서에서 사전 계산된 카운터가 포함된 이벤트를 수신할 수 있습니다 [SWS_IdsM_00401]. 함수 선언은 헤더 파일 IdsM.h를 통해 제공됩니다 [SWS_IdsM_91018].

호출 시 이 함수는 두 개의 입력 매개변수를 요구합니다:

• securityEventId: IdsM_SecurityEventIdType 타입의 보안 이벤트 식별자 [SWS_IdsM_91018].
• count: 센서로부터 생성되어 이벤트의 초기 시작 값 역할을 하는 uint16 타입의 카운트 값 [SWS_IdsM_91018], [SWS_IdsM_00401].

이 함수는 반환값을 제공하지 않으며 출력 매개변수를 정의하지 않습니다 [SWS_IdsM_91018]. 동시성 및 호출 컨텍스트와 관련하여 이 함수는 재진입 불가(Non Reentrant)로 선언되어 있으므로 [SWS_IdsM_91018], 소프트웨어 측면에서 병렬 호출을 방지해야 합니다.

오류 처리의 경우 개발 감지(IdsMDevErrorDetect)가 활성화되었을 때 IdsM이 매개변수 securityEventId 및 count를 검증하도록 명시되어 있습니다 [SWS_IdsM_02103]. 알 수 없는 이벤트 ID가 전달되거나 count의 값이 0인 경우 개발 오류 IDSM_E_PARAM_INVALID가 보고됩니다 [SWS_IdsM_02103].

함수 IdsM_SetSecurityEventWithCountContextData은 스마트 센서가 카운트 값 및 선택적 컨텍스트 데이터를 포함한 보안 이벤트를 [SWS_IdsM_91019]에 동기식으로 보고하기 위한 애플리케이션 인터페이스 역할을 합니다.

사용법 및 매개변수

호출은 동기식으로 수행되며 재진입 불가(Non Reentrant)로 지정되어 있습니다 [SWS_IdsM_91019]:

• securityEventId: 보안 이벤트의 고유 식별자 [SWS_IdsM_91019].
• count: 보안 이벤트의 시작 값으로 사용되는 카운트 값 [SWS_IdsM_91019].
• contextData: 제공할 컨텍스트 데이터가 포함된 바이트 배열에 대한 포인터 [SWS_IdsM_00502]. 컨텍스트 데이터가 없는 경우 NULL_PTR를 전달해야 합니다 [SWS_IdsM_91019].
• contextDataSize: 전달된 컨텍스트 데이터의 바이트 단위 크기 [SWS_IdsM_91019]. 이 함수는 최대 1500바이트의 길이를 지원합니다 [SWS_IdsM_00501].

오류 처리

개발 오류 감지(IdsMDevErrorDetect)가 활성화된 경우 모듈은 전달된 인수의 유효성을 모니터링합니다:

• 알 수 없는 securityEventId이 전달되거나 count의 값이 0인 경우 개발 오류 IDSM_E_PARAM_INVALID이 보고됩니다 [SWS_IdsM_02104].
• contextDataSize이 구성된 최대 버퍼 크기(가장 크게 구성된 IdsMContextDataBufferSize에 의해 결정됨)를 초과하면 IdsM은 개발 오류 IDSM_E_PARAM_LENGTH를 보고합니다 [SWS_IdsM_02108].

이 함수는 반환값을 반환하지 않습니다 [SWS_IdsM_91019]. 오류 발생 시의 오류 대응은 주로 DET를 통한 보고를 기반으로 할 것으로 보입니다. 질문 Q-135f4b865790f34d (열림)

동기식 인터페이스 IdsM_SetSecurityEventWithTimestampCount은 Smart Sensors가 타임스탬프와 카운트 값을 포함한 보안 이벤트를 IdsM에 보고하는 데 사용됩니다 [SWS_IdsM_91020]. 이 함수는 반환값이 없으며 헤더 파일 IdsM.h를 통해 사용할 수 있습니다 [SWS_IdsM_91020].

다음 입력 매개변수가 처리됩니다:

• securityEventId: 보고된 보안 이벤트의 고유 식별자 [SWS_IdsM_91020].
• timestamp: 이벤트의 시간적 참조를 위한 타임스탬프 [SWS_IdsM_91020]. 타임스탬프 기능이 활성화되어 있고 타임스탬프가 전달되면 IdsM은 이를 정규화된 보안 이벤트(QSEv)의 저장 또는 전송에 사용합니다 [SWS_IdsM_01108]. 반면 해당 기능이 활성화되어 있으나 이벤트가 타임스탬프 없이 보고되면, IdsM은 전송 또는 저장 전에 프로토콜 헤더의 타임스탬프 옵션 비트를 0으로 설정합니다 [SWS_IdsM_01112].
• count: 보안 이벤트의 시작 값 역할을 하는 카운트 값 [SWS_IdsM_91020]. 사전에 계산된 카운터가 없는 경우 1의 값으로 함수를 호출할 수 있습니다 [SWS_IdsM_00405].

개발 감지(IdsMDevErrorDetect)가 활성화되어 있으면 IdsM은 인수 securityEventId 및 count를 유효성 검사합니다. 알 수 없는 이벤트 ID가 전달되거나 count이 0 값을 갖는 경우 모듈은 개발 오류 IDSM_E_PARAM_INVALID를 보고합니다 [SWS_IdsM_02105].

동시성 측면에서 이 함수는 재진입 불가(Non Reentrant)로 지정되어 있습니다 [SWS_IdsM_91020].

서비스 ID 0x08을 갖는 함수 IdsM_SetSecurityEventWithTimestampCountContextData은 Smart Sensors가 보안 이벤트를 타임스탬프, 시작 카운트 값 및 선택적 컨텍스트 데이터와 함께 Intrusion Detection System Manager(IdsM)에 보고하기 위한 표준화된 애플리케이션 인터페이스 역할을 합니다 [SWS_IdsM_91021]. 이 인터페이스의 선언은 헤더 IdsM.h을 통해 제공됩니다 [SWS_IdsM_91021].

호출은 동기식으로 실행되며 입력 매개변수만을 사용하고 입출력 매개변수나 출력 매개변수는 존재하지 않습니다 [SWS_IdsM_91021]. 호출 시 다음 매개변수를 전달해야 합니다 [SWS_IdsM_91021]:

• securityEventId: IdsM에 전송되어야 하는 특정 보안 이벤트의 식별자 [SWS_IdsM_91021].
• timestamp: 발생한 보안 이벤트의 시간적 참조 역할을 하는 타임스탬프 값 [SWS_IdsM_91021].
• count: 해당 보안 이벤트의 시작 값으로 IdsM에서 사용하는 카운트 값 [SWS_IdsM_91021].
• contextData: 이벤트에 대한 선택적 컨텍스트 데이터에 대한 포인터이며, 데이터가 없는 경우 NULL_PTR을 전달해야 합니다 [SWS_IdsM_91021].
• contextDataSize: 전달된 컨텍스트 데이터의 크기에 대한 숫자 지정 [SWS_IdsM_91021].

실행 동작과 관련하여 이 함수는 재진입 불가(Non Reentrant)로 분류되며 반환값을 갖지 않습니다(void) [SWS_IdsM_91021]. 따라서 호출하는 Smart Sensors는 인터페이스의 동시 또는 중복 호출이 발생하지 않도록 보장해야 합니다 [SWS_IdsM_91021].

콜백 함수 IdsM_BswM_StateChanged([SWS_IdsM_91005])은 현재 ECU 상태의 변경 사항을 Intrusion Detection System Manager(IdsM)에 알리기 위해 BswM에 의해 호출됩니다([SWS_IdsM_91005]). 이는 헤더 파일 IdsM_Cbk.h에 선언되어 있으며 서비스 ID 0x0F를 갖습니다([SWS_IdsM_91005]).

이 인터페이스는 시그니처 void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state)을 갖습니다([SWS_IdsM_91005]). 유일한 전달 값으로는 현재 ECU 상태를 나타내는 타입 IdsM_Filters_BlockStateType의 입력 파라미터 state가 사용됩니다([SWS_IdsM_91005]). 입출력 파라미터나 출력 파라미터는 제공되지 않으며, 함수는 반환값을 반환하지 않습니다([SWS_IdsM_91005]). 호출은 동기식으로 실행되며 재진입 가능한 것으로 분류됩니다([SWS_IdsM_91005]).

기능적 상호 작용에서 이 알림 서비스는 BswM을 통해 IdsM에 현재 상태를 지속적으로 알리는 역할을 합니다([SWS_IdsM_01022]). 수신된 상태 정보는 IdsM에 유지되며, 메인 함수(main function)의 맥락에서 블록 상태 필터(block state filter)의 후속 비동기 처리 중에 평가됩니다([SWS_IdsM_01022]). 이 호출에 대해서는 명세 범위 내에서 특정 오류 코드, 반환값 또는 개발 오류 관리(DET)나 진단 이벤트 관리(DEM)로의 보고가 지정되어 있지 않습니다.

콜백 함수 IdsM_TpTxConfirmation은 헤더 파일 IdsM_Cbk.h을 통해 동기식 및 재진입 가능 서비스로 선언됩니다 [SWS_IdsM_91011]. [SWS_IdsM_01502]에 따르면 모듈 IdsM는 이 서비스를 통해 세그먼트화된 PDU의 전송에 대한 모듈 PduR의 확인을 수신합니다. 호출은 해당 I-PDU가 기본 네트워크를 통해 전송되자마자 수행됩니다 [SWS_IdsM_91011].

이 인터페이스는 서비스 ID 0x48을 가지며 반환값을 제공하지 않습니다(void) [SWS_IdsM_91011]. 호출 시 두 개의 입력 매개변수가 전달됩니다:

• id(PduIdType 타입): 전송된 I-PDU의 고유 식별자 [SWS_IdsM_91011].
• result(Std_ReturnType 타입): I-PDU 전송 결과를 전달하며 송신 작업이 성공했는지 실패했는지를 나타냅니다 [SWS_IdsM_91011].

이 호출에 대한 특정 오류 코드나 DET 또는 DEM 메시지는 사양에 정의되어 있지 않습니다. 지정된 재진입성 덕분에 호출 계층에서 서로 다른 I-PDU에 대해 함수를 병렬로 호출할 수 있습니다 [SWS_IdsM_91011]. 해석: 모듈 IdsM은 상태 매개변수 result를 평가하여 세그먼트화된 PDU의 내부 전송 상태를 업데이트하고 완료 후 점유된 송신 버퍼를 해제할 것으로 보입니다. 질문 Q-9179efcbf744346d (열림)

사용

콜백 함수 IdsM_TxConfirmation([SWS_IdsM_91009])은 PDU의 성공적인 전송 또는 전송 실패를 확인하기 위해 하위 통신 인터페이스 모듈에 의해 호출됩니다. 이 함수는 동기식으로 정의되고 IdsM_Cbk.h에 선언되어 있으며 반환값이 없습니다. 다음 파라미터를 수신합니다:

• TxPduId: 전송된 PDU의 식별자([SWS_IdsM_91009]).
• result: 성공적인 전송 시 E_OK, 오류 발생 시 E_NOT_OK를 갖는 전송 결과([SWS_IdsM_91009]).

동시성 및 제약사항

이 함수는 서로 다른 PDU ID에 대해서는 재진입이 가능하지만 동일한 TxPduId에 대해서는 재진입이 불가능합니다([SWS_IdsM_91009]).

상호작용 및 순서 조건

전송 순서에는 엄격한 순서 조건이 적용됩니다: [SWS_IdsM_01499]에 따라 IdsM은 이전에 IdsM_TxConfirmation 또는 IdsM_TpTxConfirmation가 호출된 후에만 송신 함수 PduR_IdsMTransmit를 다시 호출할 수 있습니다. 해석: 확인 신호의 도착은 IdsM에서 전송을 완료하고 후속 호출을 활성화하기 위한 트리거 역할을 할 것으로 보입니다. 질문 Q-dd4013520e85370c (열림)

오류 처리

PDU 전송 실패는 파라미터 result = E_NOT_OK을 통해 직접 보고됩니다([SWS_IdsM_91009]). 인터페이스 명세에는 특정 DET 또는 DEM 오류 코드가 명시되어 있지 않습니다.

사용법 및 호출 컨텍스트

동기 함수 IdsM_Dcm_GetReportingMode_RequestResults(서비스 ID 0x0D, 헤더 IdsM_Cbk.h)은 이전에 IdsM_Dcm_GetReportingMode_Start()을 통해 시작된 요청의 루틴 결과를 질의하기 위해 Diagnostic Communication Manager(DCM)에 의해 호출됩니다 [SWS_IdsM_91007]. 전달 파라미터 OpStatus를 통해 현재 작업 상태가 전송됩니다 [SWS_IdsM_91007]. 성공적으로 완료되면 함수는 E_OK을 반환하고 출력 포인터 Out_ReportingMode을 통해 요청된 Security Event의 결정된 보고 모드를 출력합니다 [SWS_IdsM_91007]. 처리가 아직 완료되지 않은 경우 반환값 DCM_E_PENDING을 통해 이를 알립니다 [SWS_IdsM_91007].

오류 처리

질의가 실패하면 함수는 E_NOT_OK을 반환합니다 [SWS_IdsM_91007]. 이 경우 파라미터 ErrorCode를 통해 구체적인 Negative Response Code(Dcm_NegativeResponseCodeType)를 설정해야 하며, 설정되지 않은 경우 DCM은 오류 코드 0x22를 전송합니다 [SWS_IdsM_91007]. 이 서비스에 대해 특정 DET 또는 DEM 이벤트는 명시되어 있지 않습니다 [SWS_IdsM_91007].

동시성 및 상호 작용

이 함수는 재진입 가능한 것으로 명세되어 있습니다 [SWS_IdsM_91007]. 호출 순서와 관련하여 루틴이 사전에 IdsM_Dcm_GetReportingMode_Start()을 통해 트리거되었음을 필수로 전제합니다 [SWS_IdsM_91007]. 해석: 파라미터 OpStatus은 DCM이 DCM_E_PENDING 반환 후 반복적인 질의 시 진단 작업의 진행 상태를 조정하는 데 사용될 것으로 보입니다. 질문 Q-c268fab018a1f5b3 (열림)

함수 IdsM_Dcm_GetReportingMode_Start은 진단 모듈(DCM)에 의해 호출되어 Intrusion Detection System Manager(IdsM)에서 특정 Security Event(SEv)의 현재 보고 모드를 조회하기 위한 루틴의 실행을 시작합니다 [SWS_IdsM_91006], [SWS_IdsM_02001]. 이 인터페이스는 헤더 IdsM_Cbk.h에 선언되어 있고 서비스 ID 0x0C를 가지며 동기식 및 재진입 가능으로 지정되어 있습니다 [SWS_IdsM_91006].

호출 시 DCM은 보안 이벤트의 외부 ID(In_SecurityEventId), 센서의 인스턴스 ID(In_SensorInstanceId) 및 작업 상태(OpStatus)를 전달합니다 [SWS_IdsM_91006]. 반환값으로 함수는 Std_ReturnType를 제공합니다:

• E_OK: 오퍼레이션이 성공적으로 완료되었습니다[SWS_IdsM_91006].
• DCM_E_PENDING: 작업이 아직 완료되지 않았습니다 [SWS_IdsM_91006]. 이는 데이터를 사용할 수 있을 때까지 루틴의 내부 처리가 다중 주기 또는 비동기식으로 계속 진행됨을 의미할 것으로 보입니다. 질문 Q-395a30fc3ed42497 (열림)
• E_NOT_OK: 오퍼레이션이 실패했습니다[SWS_IdsM_91006].

오류 발생 시(E_NOT_OK) IdsM은 출력 매개변수 ErrorCode을 통해 구체적인 Negative Response Code(NRC)를 제공해야 하며, 그렇지 않을 경우 DCM은 기본적으로 NRC 0x22(Conditions Not Correct)를 전송합니다 [SWS_IdsM_91006].

이 함수는 루틴을 트리거하기만 하며, 확인된 결과의 실제 판독은 이후 함수 IdsM_Dcm_GetReportingMode_RequestResults을 통해 수행됩니다 [SWS_IdsM_91007].

동기식 및 재진입 함수 IdsM_Dcm_SetReportingMode_Start은 Intrusion Detection System Manager에서 특정 보안 이벤트에 대한 보고 모드(IdsMReportingModeFilter) 변경 루틴을 시작하기 위해 진단 모듈(DCM)에 의해 호출됩니다 [SWS_IdsM_91008], [SWS_IdsM_01901]. 선언은 헤더 파일 IdsM_Cbk.h를 통해 제공됩니다 [SWS_IdsM_91008].

호출 시 외부 이벤트 ID(In_SecurityEventId), 센서 인스턴스 ID(In_SensorInstanceId), 새로 설정할 보고 모드(In_ReportingMode) 및 작업 상태(OpStatus)가 전달됩니다 [SWS_IdsM_91008], [SWS_IdsM_01901]. 이 함수는 다음 반환값을 제공합니다:

• E_OK: 작업 실행이 성공적으로 완료되었습니다 [SWS_IdsM_91008].
• DCM_E_PENDING: 처리가 아직 완료되지 않았으며 비동기적으로 계속됩니다 [SWS_IdsM_91008].
• E_NOT_OK: 작업이 실패했습니다. 이 경우 출력 파라미터 ErrorCode을 통해 구체적인 Negative Response Code(NRC)를 설정해야 하며, 그렇지 않으면 DCM이 NRC 0x22를 전송합니다 [SWS_IdsM_91008].

유효하지 않은 Security Event Definition ID가 사용되어 이벤트 ID 검증에 실패하는 경우, 함수는 E_NOT_OK을 반환하고 오류 코드 ErrorCode을 반드시 DCM_E_REQUESTOUTOFRANGE로 설정합니다 [SWS_IdsM_01903].

데이터 타입 IdsM_Filters_BlockStateType은 [SWS_IdsM_91017]에 따른 Intrusion Detection System Manager(IdsM)의 이른바 "Block State" 필터용 비트마스크를 정의하는 데 사용됩니다. 이 타입은 uint16에서 파생되어 0부터 65535까지의 정수 값 범위를 포괄하며, 헤더 IdsM_Filters_Types.h을 통해 소프트웨어 모듈에 제공됩니다([SWS_IdsM_91017]).

주요 사용은 Basic Software Mode Manager(BswM)와의 상호작용에서 이루어집니다. 시스템 또는 ECU 상태가 변경될 때 BswM은 콜백 함수 IdsM_BswM_StateChanged을 호출하고 이 타입의 매개변수 state을 통해 현재 ECU 상태를 전달합니다([SWS_IdsM_91005]). 이 콜백 인터페이스는 IdsM_Cbk.h에 선언되어 있으며, 반환값이 없고 동기식 및 재진입 가능(reentrant)하도록 지정되어 있습니다([SWS_IdsM_91005]).

해석: 이 타입이 필터용 비트마스크로 설계되었기 때문에, IdsM은 전달된 ECU 상태 값을 구성된 필터 상태와 비교하여 ECU 상태에 따라 보안 이벤트의 감지 또는 차단을 필터링할 것으로 보입니다. 질문 Q-00b355cc5ec6383f (열림) 이 데이터 타입에 대해 특정 오류 코드, DET 또는 DEM 메시지를 사용하는 독립적인 오류 처리는 존재하지 않습니다.

데이터 타입 IdsM_Filters_ReportingModeType은 기본 타입 uint8을 기반으로 하며 소프트웨어 컴포넌트를 위해 헤더 파일 IdsM_Types.h를 통해 제공됩니다 [SWS_IdsM_91013]. 이는 Intrusion Detection System Manager(IdsM)의 보고 모드 필터 내에서 보안 이벤트의 대상 지정 처리 및 전달에 적용되는 표준화된 보고 모드를 설명합니다 [SWS_IdsM_91013].

정의된 열거형 값을 통해 이벤트가 보고되는지 여부와 이때 어떤 상세 수준이 적용되는지가 정밀하게 제어됩니다 [SWS_IdsM_91013]:

• IDSM_REPORTING_MODE_OFF (0x00): 이벤트가 억제되며 상위 인스턴스로 보고되지 않습니다 [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF (0x01): 이벤트가 추가 컨텍스트 데이터 없이 간결한 형식으로 보고됩니다 [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED (0x02): 모든 관련 컨텍스트 데이터를 포함하여 이벤트가 상세하게 보고됩니다 [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF_BYPASSING_FILTERS (0x03): 이벤트가 후속 필터 단계를 우회하고 컨텍스트 데이터 없이 필터링되지 않은 상태로 보고됩니다 [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED_BYPASSING_FILTERS (0x04): 이벤트가 후속 필터 단계를 우회하고 모든 컨텍스트 데이터를 포함하여 필터링되지 않은 상태로 보고됩니다 [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_INVALID (0xFF): 값 범위 내에서 유효하지 않은 보고 모드를 나타냅니다 [SWS_IdsM_91013].

따라서 이 값들은 두 가지 기능적 제어 차원을 결합합니다: 컨텍스트 데이터를 통한 상세 수준과 바이패스를 통한 일반 필터 메커니즘의 의도적 우회 [SWS_IdsM_91013]. 이를 통해 IdsM은 중요도 및 필터 구성에 따라 보안 인시던트를 차별화하여 처리할 수 있습니다 [SWS_IdsM_91013].