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
دالة 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.
تُستخدم الواجهة المتزامنة وغير القابلة لإعادة الدخول IdsM_Init للتهيئة الأساسية للوحدة IdsM وفقًا لـ [SWS_IdsM_91001]. عند الاستدعاء، تقوم الخدمة بتهيئة كافة المتغيرات الداخلية وتنقل IdsM إلى الحالة مهيأ ([SWS_IdsM_00202]). عبر معلمة الإدخال configPtr، تقبل الدالة مؤشرًا إلى هيكل التكوين الخاص بالوحدة ([SWS_IdsM_91001]).
يمثل تنفيذ IdsM_Init شرطًا أساسيًا وظيفيًا إلزاميًا لتشغيل الوحدة. إذا تم استدعاء واجهة برمجة تطبيقات (API) لـ IdsM بخلاف IdsM_Init أو IdsM_GetVersionInfo في الحالة غير المهيأة بعد، فستبلغ الوحدة عند تنشيط اكتشاف أخطاء التطوير (IdsMDevErrorDetect) عن الخطأ IDSM_E_PARAM_UNINIT عبر Det_ReportError ([SWS_IdsM_00203]، انظر أيضًا رمز الخطأ 0x0D تحت [SWS_IdsM_02003]).
تنطبق قواعد سلوك محددة على معالجة الأخطاء وسياق الاستدعاء:
- إذا تم استدعاء
IdsM_Initبينما تكون الوحدة بالفعل في الحالة مهيأ، فلن تتم إعادة تهيئة المتغيرات الداخلية ([SWS_IdsM_00204]). - بدلاً من ذلك، تبلغ الوحدة عند تنشيط
IdsMDevErrorDetectعبرDet_ReportErrorعن خطأ التطويرIDSM_E_ALREADY_INITIALIZEDبالقيمة العددية0x0E([SWS_IdsM_00204]، [SWS_IdsM_02003]). - لا تحتوي الدالة على قيمة إرجاع وهي معرّفة على أنها غير قابلة لإعادة الدخول ([SWS_IdsM_91001]). لذلك، لا يجوز استدعاؤها في النظام بشكل متزامن أو عبر سياقات مقاطِعة عدة مرات في الوقت نفسه.
تم إنشاء هذه الملاحظة بواسطة ذكاء اصطناعي استناداً إلى مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
دالة 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.
الاستخدام وسياق الاستدعاء
تُستدعى الدالة IdsM_MainFunction دوريًا وتكون متاحة عبر ملف الترويسة IdsM.h [SWS_IdsM_91000]. تمتلك التوقيع void IdsM_MainFunction(void)، ولا تقبل أي معلمات وليست لها قيمة إرجاع [SWS_IdsM_91000]. استدعاء الدالة نفسه متزامن، ولكنه يخدم المعالجة غير المتزامنة لأحداث الأمان (Security Events, SEv) التي تم إدراجها سابقًا في قوائم انتظار أثناء استدعاءات API متزامنة [SWS_IdsM_91000]. ويُرجح أن يتم التحفيز الدوري نمطيًا بواسطة مجدول BSW أو مهمة نظام تشغيل دورية. سؤال 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]. - التأهيل: تتم معالجة أحداث SEv المخزنة في Event Buffers بشكل غير متزامن لتحديدها كأحداث أمان مؤهلة (QSEv) [SWS_IdsM_00901].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تُستدعى دالة الاسترجاع (Callback) بشكل متزامن وقابل لإعادة الدخول لجلب بيانات الإرسال لأجزاء من I-PDU (N-PDU) [SWS_IdsM_91010]. وهي متاحة عبر ملف الترويسة IdsM_Cbk.h وتخدم معرف الخدمة 0x43 [SWS_IdsM_91010].
يتم تحديد I-PDU المراد نقلها عبر id [SWS_IdsM_91010]. تمرر المعلمة info المخزن المؤقت للوجهة (SduDataPtr) بالإضافة إلى طول البايت المطلوب (SduLength)؛ وتُستخدم القيمة 0 لـ SduLength (حيث يجوز أن يكون SduDataPtr هو NULL_PTR) لتغييرات الحالة في المعلمة retry أو للاستعلام عن البيانات المتبقية [SWS_IdsM_91010]. وعبر availableDataPtr تُبلغ الدالة عن كمية البيانات المتبقية في المخزن المؤقت للإرسال Tx، مما يتيح لبروتوكولات النقل ذات الحمولات الديناميكية (مثل FrIsoTp) تحديد حجم إطارات Consecutive Frames اللاحقة [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].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تُستخدم الدالة IdsM_SetSecurityEvent كواجهة للتطبيقات للإبلاغ عن أحداث الأمان إلى الوحدة IdsM (Intrusion Detection System Manager) [SWS_IdsM_91002].
الاستخدام وسياق الاستدعاء
يتم الاستدعاء بشكل متزامن عبر ملف الرأس IdsM.h مع معرف الخدمة 0x03 [SWS_IdsM_91002]. يتم تمرير معرف حدث الأمان كمعلمة التمرير الوحيدة:
securityEventId(IN،IdsM_SecurityEventIdType): المعرف الفريد لحدث الأمان المبلغ عنه [SWS_IdsM_91002].
لا تحتوي الدالة على قيمة إرجاع (void) [SWS_IdsM_91002].
معالجة الأخطاء
إذا تم تنشيط اكتشاف أخطاء التطوير (IdsMDevErrorDetect)، تتحقق الوحدة من المعلمة securityEventId مقابل أحداث الأمان المكونة [SWS_IdsM_02101]. إذا تم تمرير معرف حدث غير معروف لم يتم تكوينه في IdsMEvent، يبلغ IdsM عن خطأ التطوير IDSM_E_PARAM_INVALID [SWS_IdsM_02101].
التزامن والقيود
تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_IdsM_91002]. لذلك، يجب مزامنة أو تجنب الاستدعاءات المتزامنة أو المقاطِعة من سياقات مختلفة بواسطة المتصل.
تستند ملاحظة الاستخدام هذه إلى مواصفات منصة AUTOSAR Classic في الإصدار R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تُستخدم الدالة 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]).
تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تمثل الدالة المتزامنة IdsM_SetSecurityEventWithCount (معرّف الخدمة 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]؛ لذا يجب تجنب الاستدعاءات المتوازية من جانب البرمجيات.
بالنسبة لمعالجة الأخطاء، تم تحديد أن IdsM يتحقق من المعاملين securityEventId وcount عند تفعيل ميزة اكتشاف التطوير (IdsMDevErrorDetect) [SWS_IdsM_02103]. وإذا تم تمرير معرّف حدث غير معروف أو كانت قيمة count تساوي 0، يتم الإبلاغ عن خطأ التطوير IDSM_E_PARAM_INVALID [SWS_IdsM_02103].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بواسطة ذكاء اصطناعي استنادًا إلى مواصفات AUTOSAR.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تُستخدم الدالة 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)، تراقب الوحدة النمطية المعاملات الممررة للتحقق من صحتها:
- يُبلَّغ عن خطأ التطوير
IDSM_E_PARAM_INVALIDإذا تم تمريرsecurityEventIdغير معروفة أو إذا كانت قيمةcountتساوي 0 [SWS_IdsM_02104]. - إذا تجاوز
contextDataSizeالحد الأقصى لحجم المخزن المؤقت المهيأ (المحدد بواسطة أكبرIdsMContextDataBufferSizeمهيأة)، يبلغ IdsM عن خطأ التطويرIDSM_E_PARAM_LENGTH[SWS_IdsM_02108].
لا تُرجع الدالة أي قيمة إرجاع [SWS_IdsM_91019]؛ ويُرجح أن يستند التفاعل مع الخطأ في حالة حدوثه بشكل أساسي إلى الإبلاغ عبر DET. سؤال Q-135f4b865790f34d (مفتوح)
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة 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.
تُستخدم الواجهة المتزامنة 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. وإذا تم تمرير معرّف حدث غير معروف أو كانت قيمة count تساوي 0، تبلّغ الوحدة عن خطأ التطوير IDSM_E_PARAM_INVALID [SWS_IdsM_02105].
فيما يتعلق بالتزامن، تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_IdsM_91020].
تم إنشاء هذا النص تلقائيًا استنادًا إلى مواصفات AUTOSAR.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة 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.
تُستخدم الدالة IdsM_SetSecurityEventWithTimestampCountContextData ذات معرّف الخدمة 0x08 كواجهة تطبيق قياسية للمستشعرات الذكية (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].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو مخصص للإرشاد والتوجيه.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
يتم استدعاء دالة رد النداء IdsM_BswM_StateChanged ([SWS_IdsM_91005]) بواسطة BswM للإشارة إلى تغييرات حالة وحدة التحكم الإلكترونية الحالية إلى Intrusion Detection System Manager (IdsM) ([SWS_IdsM_91005]). تم التصريح عنها في ملف الرأس IdsM_Cbk.h ولديها معرف الخدمة 0x0F ([SWS_IdsM_91005]).
تمتلك الواجهة التوقيع void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state) ([SWS_IdsM_91005]). تعمل معلمة الإدخال state من النوع IdsM_Filters_BlockStateType كقيمة التمرير الوحيدة، والتي تمثل حالة ECU الحالية ([SWS_IdsM_91005]). لا توجد معلمات إدخال/إخراج ولا معلمات إخراج، ولا تُرجع الدالة أي قيمة إرجاع ([SWS_IdsM_91005]). يتم تنفيذ الاستدعاء بشكل متزامن ويُصنف على أنه قابل لإعادة الدخول ([SWS_IdsM_91005]).
في التفاعل الوظيفي، تُستخدم خدمة الإشعار هذه لإبقاء IdsM مطلعًا باستمرار على الحالة الحالية بواسطة BswM ([SWS_IdsM_01022]). يتم الاحتفاظ بمعلومات الحالة المستلمة في IdsM وتقييمها أثناء المعالجة غير المتزامنة اللاحقة لمرشحات حالة الكتلة (block state filter) كجزء من الدالة الرئيسية (main function) ([SWS_IdsM_01022]). لم يتم تحديد رموز أخطاء معينة أو قيم إرجاع أو رسائل إلى إدارة أخطاء التطوير (DET) أو إدارة أحداث التشخيص (DEM) لهذا الاستدعاء ضمن نطاق المواصفات.
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا وتستند إلى متطلبات مواصفات AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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.
تُصرح دالة الاسترجاع IdsM_TpTxConfirmation كخدمة تزامنية وقابلة لإعادة الدخول عبر ملف الترويسة IdsM_Cbk.h [SWS_IdsM_91011]. وفقًا لـ [SWS_IdsM_01502]، تستقبل الوحدة IdsM عبر هذه الخدمة تأكيد الوحدة PduR لنقل PDU مجزأة. ويتم الاستدعاء بمجرد نقل I-PDU المعنية عبر الشبكة الأساسية [SWS_IdsM_91011].
تمتلك الواجهة معرف الخدمة 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 (مفتوح)
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند حصريًا إلى مواصفات AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة 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.
الاستخدام
يتم استدعاء دالة رد النداء IdsM_TxConfirmation ([SWS_IdsM_91009]) بواسطة وحدة واجهة اتصال تابعة لتأكيد الإرسال الناجح لـ PDU أو فشل الإرسال. وهي معرّفة بشكل متزامن، ومُصرّح عنها في IdsM_Cbk.h ولا تمتلك قيمة إرجاع. وتستقبل المعاملات التالية:
TxPduId: معرّف الـ PDU المنقولة ([SWS_IdsM_91009]).result: نتيجة الإرسال معE_OKعند الإرسال الناجح أوE_NOT_OKعند حدوث خطأ ([SWS_IdsM_91009]).
التزامن والقيود
الدالة قابلة لإعادة الدخول بالنسبة لمعرّفات PDU المختلفة، ولكنها غير قابلة لإعادة الدخول بالنسبة لـ TxPduId نفسها ([SWS_IdsM_91009]).
التفاعل وشروط التسلسل
ينطبق شرط ترتيب صارم على تسلسل الإرسال: وفقًا لـ [SWS_IdsM_01499]، لا يُسمح لـ IdsM بإعادة استدعاء دالة الإرسال PduR_IdsMTransmit إلا بعد أن يتم مسبقًا استدعاء IdsM_TxConfirmation أو IdsM_TpTxConfirmation. تفسير: يُرجَّح أن يعمل ورود التأكيد في IdsM كمشغّل لإكمال الإرسال وإتاحة الاستدعاءات اللاحقة. سؤال Q-dd4013520e85370c (مفتوح)
معالجة الأخطاء
يتم الإبلاغ عن فشل إرسال PDU مباشرة عبر المعامل result = E_NOT_OK ([SWS_IdsM_91009]). لا توجد أكواد أخطاء DET أو DEM محددة موضحة في مواصفات الواجهة.
تم إنشاء هذا النص تلقائيًا استنادًا إلى مواصفات AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة 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().
الاستخدام وسياق الاستدعاء
يتم استدعاء الدالة المتزامنة IdsM_Dcm_GetReportingMode_RequestResults (معرف الخدمة 0x0D، ملف الرأس IdsM_Cbk.h) بواسطة Diagnostic Communication Manager (DCM) للاستعلام عن نتائج الإجراء لطلب تم بدؤه مسبقًا عبر IdsM_Dcm_GetReportingMode_Start() [SWS_IdsM_91007]. يتم نقل حالة العملية الحالية عبر معلمة التمرير OpStatus [SWS_IdsM_91007]. عند الاكتمال الناجح، تُرجع الدالة E_OK وتُخرج وضع إعداد التقارير المحدد لحدث الأمان المطلوب عبر مؤشر الإخراج Out_ReportingMode [SWS_IdsM_91007]. إذا لم تكتمل المعالجة بعد، فإنها تشير إلى ذلك عبر قيمة الإرجاع DCM_E_PENDING [SWS_IdsM_91007].
معالجة الأخطاء
إذا فشل الاستعلام، تُرجع الدالة E_NOT_OK [SWS_IdsM_91007]. في هذه الحالة، يجب تعيين رمز استجابة سلبية محدد (Dcm_NegativeResponseCodeType) عبر المعلمة ErrorCode؛ وإذا ظل غير معين، يرسل 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 (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة 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.
تُستدعى الدالة IdsM_Dcm_GetReportingMode_Start بواسطة وحدة التشخيص (DCM) لبدء تنفيذ روتين في Intrusion Detection System Manager (IdsM) للاستعلام عن وضع الإبلاغ الحالي لحدث أمني معين (SEv) [SWS_IdsM_91006]، [SWS_IdsM_02001]. الواجهة مصرح عنها في الترويسة IdsM_Cbk.h، وتمتلك معرف الخدمة 0x0C، ومحددة بأنها تزامنية وقابلة لإعادة الدخول [SWS_IdsM_91006].
عند الاستدعاء، تمرر DCM المعرف الخارجي لحدث الأمان (In_SecurityEventId)، ومعرف المثيل للحساس (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 بتوفير Negative Response Code (NRC) محدد عبر معامل الإخراج ErrorCode؛ وإذا لم يحدث ذلك، ترسل DCM افتراضيًا الرمز NRC 0x22 (Conditions Not Correct) [SWS_IdsM_91006].
تقوم الدالة بتشغيل الروتين فقط؛ بينما تتم القراءة الفعلية للنتائج المحددة لاحقًا عبر الدالة IdsM_Dcm_GetReportingMode_RequestResults [SWS_IdsM_91007].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا. تستند جميع المعلومات حصريًا إلى مواصفات AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة 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.
يتم استدعاء الدالة المتزامنة والقابلة لإعادة الدخول IdsM_Dcm_SetReportingMode_Start بواسطة وحدة التشخيص (DCM) لبدء الإجراء الخاص بتغيير وضع إعداد التقارير (IdsMReportingModeFilter) لحدث أمان معين في Intrusion Detection System Manager [SWS_IdsM_91008]، [SWS_IdsM_01901]. يتم توفير التصريح عبر ملف الرأس IdsM_Cbk.h [SWS_IdsM_91008].
عند الاستدعاء، يتم تمرير معرّف الحدث الخارجي (In_SecurityEventId)، ومعرّف مثيل المستشعر (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: فشلت العملية؛ وفي هذه الحالة يجب تعيين كود استجابة سلبية (NRC) محدد عبر معامل الإخراجErrorCode، وإلا فإن DCM سينقل الـ NRC0x22[SWS_IdsM_91008].
إذا فشل التحقق من صحة معرّف الحدث بسبب استخدام Security Event Definition ID غير صالح، تُرجع الدالة E_NOT_OK وتعين كود الخطأ ErrorCode إلزاميًا على DCM_E_REQUESTOUTOFRANGE [SWS_IdsM_01903].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا وتستند إلى مواصفات AUTOSAR.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
نوع IdsM_ConfigType [SWS_IdsM_91012] 📄 PDF
Configuration data structure of IdsM module.
نوع IdsM_Filters_BlockStateType [SWS_IdsM_91017] 📄 PDF
Data type used for "Block State" filter values (bit masks)
يُستخدم نوع البيانات IdsM_Filters_BlockStateType لتعريف أقنعة البتات لما يُعرف بمرشحات «Block State» التابعة لـ Intrusion Detection System Manager (IdsM) وفقًا لـ [SWS_IdsM_91017]. هذا النوع مشتق من uint16، ويغطي نطاق القيم الصحيحة من 0 إلى 65535 ويتاح لوحدات البرمجيات عبر ملف الترويسة IdsM_Filters_Types.h ([SWS_IdsM_91017]).
يتم الاستخدام الأساسي بالتنسيق مع Basic Software Mode Manager (BswM). عند حدوث تغييرات في حالة النظام أو وحدة التحكم، يستدعي BswM دالة رد النداء IdsM_BswM_StateChanged ويمرر حالة وحدة التحكم الحالية عبر المعامل state من هذا النوع ([SWS_IdsM_91005]). تم التصريح عن واجهة رد النداء هذه في IdsM_Cbk.h، وهي لا تُرجع أي قيم ومحددة على أنها متزامنة وقابلة لإعادة الدخول ([SWS_IdsM_91005]).
تفسير: نظرًا لتصميم النوع كقناع بتات للمرشحات، يُرجَّح أن يقارن IdsM قيمة حالة ECU الممررة بحالات المرشح المهيأة، لتصفية تسجيل أو حظر أحداث الأمان اعتمادًا على حالة وحدة التحكم. سؤال Q-00b355cc5ec6383f (مفتوح) لا توجد معالجة أخطاء مستقلة بأكواد أخطاء محددة أو رسائل DET أو DEM لنوع البيانات هذا.
تم إنشاء هذا الإشعار بواسطة ذكاء اصطناعي ويستند حصريًا إلى بيانات المواصفات من AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع IdsM_Filters_ReportingModeType [SWS_IdsM_91013] 📄 PDF
Reporting modes used by the reporting mode filter
يعتمد نوع البيانات IdsM_Filters_ReportingModeType على النوع الأساسي uint8 ويتم توفيره لمكونات البرمجيات عبر ملف الترويسة IdsM_Types.h [SWS_IdsM_91013]. وهو يصف أوضاع إعداد التقارير القياسية التي يتم تطبيقها داخل مرشح وضع إعداد التقارير (Reporting-Mode-Filter) في 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].
وبذلك تجمع القيم بين بعدين وظيفيين للتحكم: مستوى التفاصيل عبر بيانات السياق، بالإضافة إلى التجاوز المتعمد لآليات التصفية الاعتيادية من خلال التجاوز (Bypassing) [SWS_IdsM_91013]. يتيح ذلك لـ IdsM معالجة متمايزة للحوادث الأمنية تبعًا لدرجة الأهمية وتهيئة المرشح [SWS_IdsM_91013].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع IdsM_TimestampType [SWS_IdsM_91014] 📄 PDF
Data type for IdsM timestamps
نوع 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#11c3c9f1- Content hash
11c3c9f1- 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 · الأصل الألماني