Communication Manager (ComM)
Manages communication states and channel modes across multiple network interfaces.
Funktionen — Übersicht
void ComM_Init (const ComM_ConfigType* ConfigPtr);Initializes the AUTOSAR Communication Manager and restarts the internal state machines.void ComM_DeInit (void);This API de - initializes the AUTOSAR Communication Manager.Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);Returns the initialization status of the AUTOSAR Communication Manager.Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);Returns the inhibition status of a Com M channel.Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);Requesting of a Communication Mode by a user.Std_ReturnType ComM_GetMax ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode); ⚠️Function t o query the maximum allowed Communication Mode of the corresponding user.Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the currently requested Communication Mode of the corresponding user.Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Function to query the current Communication Mode.Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);This function returns the current configuration of the ECUs PNC - to -Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);This function can be used to set entries within the the ECUs PNC - to - channel -Std_ReturnType ComM_ResetPncToChannelMapping (void);This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Std_ReturnType ComM_PnLearningRequest (void);Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving...Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning.Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode.Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication...Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.Std_ReturnType ComM_ResetInhibitCounter (void);This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);Changes the ECU Group Classification status (see chapter 10.void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);This function returns the published information (for details refer to table 10.void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have...void ComM_Nm_NetworkMode (NetworkHandleType Channel);Notification that the network management has entered Network Mode.void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Prepare Bus - Sleep Mode.void ComM_Nm_BusSleepMode (NetworkHandleType Channel);Notification that the network management has entered Bus - Sleep Mode.void ComM_Nm_RestartIndication (NetworkHandleType Channel);If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND...void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);Notification that the state of all has left Repeat Message.void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);Service to indicate that an NM message with set PNC Learning Bit has been received.void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a Nm, then Com M is immediately...void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);Indication of active diagnostic by the DCM.void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);Indication of inactive diagnostic by the DCM.void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);Notification of a wake up on the corresponding channel.void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);Notification of a wake up on the corresponding partial network cluster.void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);Ecu M or Bsw M shall indicate to Com M when communication is allowed.void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);Indication of the actual bus mode by the corresponding Bus State Manager.void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep.
Typen — Übersicht
enum ComM_InitStatusTypeInitialization status of Com M.enum ComM_PncModeTypeCurrent mode of a PNCenum ComM_StateTypeState and sub - state of Com M state machine Com M states vs.struct ComM_ConfigTypeThis type contains the implementation - specific post build configuration structure.enum ComM_ModeTypeCurrent mode of the Communication Manager (main state of the state machine).ComM_UserHandleTypeHandle to identify a user.ComM_UserHandleArrayTypenumber Of Requesters contains the number of valid user handle entries in the "handle Array" member.ComM_UserHandleSubArrayTypeThis element contains the user handles of the users which keep the channel requested (if any), starting in its first entries.ComM_PncMembershipTypeArray of uint8 with Elements that holds the current PNC Membership of the node.modeLimitation-ComMMode-
Funktionen & Typen — Detailansicht
دالة ComM_Init [SWS_ComM_00146] 📄 PDF
void ComM_Init (const ComM_ConfigType* ConfigPtr);
Initializes the AUTOSAR Communication Manager and restarts the internal state machines.
تُستخدم الدالة المتزامنة ComM_Init (معرّف الخدمة 0x01) للتهيئة الأساسية لـ AUTOSAR Communication Manager وتُعيد تشغيل آلات الحالة الداخلية الخاصة به [SWS_ComM_00146]. تأخذ كمعلمة إدخال ConfigPtr، والتي يتم تمريرها كمؤشر إلى بنية تهيئة ما بعد البناء من النوع const ComM_ConfigType* [SWS_ComM_00146]. لا ترجع الدالة أي قيمة (نوع الإرجاع void) ويتم التصريح عنها عبر ملف الترويسة ComM.h [SWS_ComM_00146].
فيما يتعلق بالتزامن، يتم تعريف ComM_Init على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_ComM_00146]. لا يُحدد متصل ملموس في بيانات المواصفة؛ ويُفترض أن يتم الاستدعاء مركزيًا أثناء مرحلة بدء تشغيل وحدة التحكم الإلكترونية في إطار تهيئة BSW. سؤال Q-7121f73c12407087 (مفتوح)
في النظام الإجمالي، تمتلك ComM_Init وظيفة تحكم وشرط مسبق مركزية للوحدة بأكملها: ما دامت وحدة ComM لم تُهيأ، لا يجوز لجميع خدمات الوحدة وخدمات API بدء تشغيلها العادي ويجب عليها في الخدمات ذات نوع الإرجاع القياسي إرجاع E_NOT_OK [SWS_ComM_00612]. ينطبق استثناء من هذا الحظر فقط على ComM_Init نفسها وكذلك على دوال الاستعلام ComM_GetVersionInfo وComM_GetStatus [SWS_ComM_00612].
تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى بيانات مواصفة AUTOSAR.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_DeInit [SWS_ComM_00147] 📄 PDF
void ComM_DeInit (void);
This API de - initializes the AUTOSAR Communication Manager.
الاستخدام
تُستخدم الدالة ComM_DeInit وفقًا لـ [SWS_ComM_00147] لإلغاء تهيئة AUTOSAR Communication Manager (ComM). الخدمة مصممة لتكون متزامنة، وتحمل معرّف الخدمة 0x02 ويتم التصريح عنها عبر ملف الترويسة ComM.h. وفقًا للتوقيع void ComM_DeInit(void)، لا تقبل الدالة أي معلمات إدخال أو إخراج أو تمرير، ولا تُرجع أي قيمة إلى المتصل [SWS_ComM_00147].
معالجة الأخطاء
بما أن توقيع الدالة يُرجع void، فلا توجد استجابة مباشرة لأكواد الخطأ أو الحالة عبر استدعاء الواجهة [SWS_ComM_00147]. ولا تتضمن بيانات المواصفة المتاحة ردود فعل محددة للأخطاء، مثل إخطار Development Error Tracer (DET) أو Diagnostic Event Manager (DEM)، وبالتالي لا يتم عرضها.
التزامن وسياق النظام
وفقًا لـ [SWS_ComM_00147]، تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant). ويترتب على ذلك مطلب إلزامي لتكامل النظام بمنع الاستدعاءات المتوازية أو المقاطِعة من عدة مهام أو سياقات بشكل كامل. وكتفسير لتسلسل النظام، من المرجح أن يتم الاستدعاء عادةً في سياق إيقاف التشغيل المنظم لوحدة التحكم الإلكترونية عبر إدارة حالة عليا (مثل مدير BSW)، بمجرد إيقاف قنوات اتصال BSW. سؤال Q-f3b68dc129993cb7 (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على المواصفة SWS_ComM_00147.
دالة ComM_GetStatus [SWS_ComM_00242] 📄 PDF
Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);
Returns the initialization status of the AUTOSAR Communication Manager. After a call to Com M_ De Init() Com M should have status COMM_ UNINIT, and a new call to Com M_ Init needed to make sur e Com M restart internal state machines to defailt values.
دالة ComM_GetInhibitionStatus [SWS_ComM_00619] 📄 PDF
Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);
Returns the inhibition status of a Com M channel.
دالة ComM_RequestComMode [SWS_ComM_00110] 📄 PDF
Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);
Requesting of a Communication Mode by a user. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Note: The following modes are no vaild user requests, since they are used as internal modes: - COMM_ SIL ENT_ COMMUNICATION (this mode is used for synchronization at shutdown) - COMM_ FULL_ COMMUNICATION_ WITH_ WAKEUP_ REQUEST (this mode is used internally within the Com M channel statemachine to trigger the lower layers to request a wakeup on the network if the used hardware support such a feature. (e.g. Ethernet hardware which is compatible with OA TC10). The following modes are valid user requests: - COMM_ NO_ COMMUNICATION - COMM_ FULL_ COMMUNICATION. The communication request could also be released due to
الاستخدام وسياق الاستدعاء
تُستخدم الدالة المتزامنة والقابلة لإعادة الدخول ComM_RequestComMode ([SWS_ComM_00110]) لطلب وضع اتصال لمستخدم محدد (User). وهي متوفرة عبر ComM.h. كمعلمات تمرير لـ ComMode، لا يُسمح إلا بالقيم التالية كطلب مستخدم:
COMM_FULL_COMMUNICATION: طلب قدرة اتصال كاملة ([SWS_ComM_00110]).COMM_NO_COMMUNICATION: تحرير أو إنهاء طلب الاتصال ([SWS_ComM_00110]).
الوضعان COMM_SILENT_COMMUNICATION (يُستخدم لمزامنة إيقاف التشغيل) وكذلك COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (محفز إيقاظ داخلي للطبقات الأدنى، على سبيل المثال في عتاد Ethernet الداعم لـ OA TC10) هما حالتان داخليتان ولا يجوز طلبهما من قبل المستخدمين ([SWS_ComM_00110]). تفسير: من المرجح أن تمرير هذين الوضعين الداخليين سيُقابل بـ E_NOT_OK. سؤال Q-973ed1ce1845983e (مفتوح)
قيم الإرجاع ومعالجة الأخطاء
تشير الدالة إلى النتيجة عبر قيم إرجاع محددة ([SWS_ComM_00110]):
E_OK: تم الانتقال إلى وضع الاتصال المطلوب بنجاح.E_NOT_OK: فشل تغيير الوضع.COMM_E_MODE_LIMITATION: لا يمكن منح الوضع المطلوب بسبب تقييد اتصال نشط (Mode Inhibition). ويمكن أيضاً تحرير طلبات الاتصال مجدداً من خلال هذه التقييدات.
التفاعل وآلة الحالة
يؤثر وجود أو غياب الطلبات النشطة في آلة حالة القناة لـ ComM. إذا كانت القناة في الحالة الفرعية COMM_FULL_COM_NETWORK_REQUESTED مع التهيئة ComMNmVariant = SLAVE_ACTIVE ولا يوجد استدعاء نشط لـ ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION)، تنتقل آلة حالة ComM إلى الحالة الفرعية COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017]).
تم إنشاء هذا النص بواسطة نظام توثيق مدعوم بالذكاء الاصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_GetMaxComMode [SWS_ComM_00085] 📄 PDF
Std_ReturnType ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function t o query the maximum allowed Communication Mode of the corresponding user.
دالة ComM_GetRequestedComMode [SWS_ComM_00079] 📄 PDF
Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the currently requested Communication Mode of the corresponding user. Availa ble via Com M.h
دالة ComM_GetCurrentComMode [SWS_ComM_00083] 📄 PDF
Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
Function to query the current Communication Mode. Com M shall use the corresponding interfaces of the Bus State Managers to get the current Communication Mode of the network. (Call to Bus State Manager API: XXXSM _ Get Current Com Mode(...))
دالة ComM_GetCurrentPNCComMode [SWS_ComM_91002] 📄 PDF
Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);
The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.
دالة ComM_GetPncToChannelMapping [SWS_ComM_91013] 📄 PDF
Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);
This function returns the current configuration of the ECUs PNC - to -
دالة ComM_UpdatePncToChannelMapping [SWS_ComM_91015] 📄 PDF
Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);
This function can be used to set entries within the the ECUs PNC - to - channel -
تُستخدم الدالة المتزامنة ComM_UpdatePncToChannelMapping ذات معرّف الخدمة 0x62 لتعيين مدخلات في تعيين PNC إلى القناة لوحدة التحكم الإلكترونية أو بوابة PNC [SWS_ComM_91015]. الواجهة متاحة عبر ملف الترويسة ComM.h ومميزة بالحالة Draft في الإصدار R20-11 [SWS_ComM_91015].
المعلمات
يتم تمرير ثلاث معلمات إدخال إلى استدعاء الدالة [SWS_ComM_91015]:
MappingTable: مؤشر إلى صفيفbooleanثنائي الأبعاد (const boolean*) يحتوي على تعيين PNC إلى القناة الحالي لبوابة PNC، حيث يغطي البعد الأول جميع القنوات ذات الصلة ويغطي البعد الثاني جميع PNCs ذات الصلة [SWS_ComM_91015].channelCnt: عدد القنوات المادية الممررة فيMappingTable[SWS_ComM_91015].PncCnt: عدد PNCs الممررة فيMappingTable[SWS_ComM_91015].
قيم الإرجاع ومعالجة الأخطاء
تُرجع الوظيفة قيمة حالة من النوع Std_ReturnType [SWS_ComM_91015]:
E_OK: تم تعيين مدخل التعيين بنجاح [SWS_ComM_91015].E_NOT_OK: فشل تعيين مدخل التعيين [SWS_ComM_91015].COMM_E_LEARNING_ACTIVE: لا يمكن تنفيذ الاستدعاء لأن مرحلة تعلم PNC نشطة [SWS_ComM_91015].
التزامن والقيود
تم تعريف الواجهة على أنها غير قابلة لإعادة الدخول [SWS_ComM_91015]. ولذلك لا يجوز إجراء الاستدعاءات بالتزامن. كما يُستبعد التحديث طالما أن نظام الاتصال في مرحلة تعلم PNC النشطة [SWS_ComM_91015].
تم إنشاء ملاحظة الاستخدام هذه تلقائياً استناداً إلى مواصفة AUTOSAR CP R20-11.
دالة ComM_ResetPncToChannelMapping [SWS_ComM_91017] 📄 PDF
Std_ReturnType ComM_ResetPncToChannelMapping (void);
This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Status=draft
تُستخدم الدالة المتزامنة غير القابلة لإعادة الدخول ComM_ResetPncToChannelMapping لإعادة تعيين الإدخالات الديناميكية لمطابقة PNC بالقناة لوحدة التحكم الإلكترونية إلى القيم الافتراضية المهيأة [SWS_ComM_91017]. ولا تقبل أي معاملات تمرير، وتُرجع قيمة حالة من النوع Std_ReturnType [SWS_ComM_91017].
السلوك وقيم الإرجاع
يعتمد سلوك الدالة على حالة مرحلة تعلم PNC بالإضافة إلى تهيئة القنوات:
- إذا تم تفعيل
ComMDynamicPncToChannelMappingEnabledلقناة واحدة على الأقل ولم تكن مرحلة تعلم PNC نشطة، تُعيد الدالة تعيين التعيينات إلى القيم الافتراضية للتهيئة الأصلية (الإدخالات الثابتة) وتُرجعE_OK[SWS_ComM_01043]. - إذا كان النظام في مرحلة تعلم PNC نشطة وتم ضبط
ComMDynamicPncToChannelMappingEnabledأوComMDynamicPncToChannelMappingSupportعلىTRUEلقناة واحدة على الأقل، يتم رفض إعادة التعيين ويتم إرجاعCOMM_E_LEARNING_ACTIVE[SWS_ComM_01042]، [SWS_ComM_01045]. - إذا فشلت إعادة تعيين التعيينات إلى القيم الافتراضية، تُرجع الدالة
E_NOT_OK[SWS_ComM_91017].
القيود وشروط الاستدعاء
نظراً لتحديد ComM_ResetPncToChannelMapping على أنها غير قابلة لإعادة الدخول (Non Reentrant)، فلا يجوز إجراء استدعاءات متزامنة من سياقات متزامنة [SWS_ComM_91017]. بالإضافة إلى ذلك، فإن الواجهة في حالة المسودة (Draft) [SWS_ComM_91017].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند حصرياً إلى بيانات مواصفات AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_PnLearningRequest [SWS_ComM_91019] 📄 PDF
Std_ReturnType ComM_PnLearningRequest (void);
Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving nodes to respond) together with the Repeat Message Request Bit (in order for receiving nodes to return into NM Repeat Message State). This function is used for the optional Dynamic PNC - to - channel - mapping feature. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Tags: atp.Status=draft
الاستخدام والدلالات
تطلق الدالة غير المتزامنة ComM_PnLearningRequest مطابقة PNC بالقناة الديناميكية الاختيارية (Dynamic PNC-to-channel-mapping) [SWS_ComM_91019]. وهي تجعل Network Management (NM) يعود إلى الحالة NM Repeat Message State [SWS_ComM_91019]. ويتم أثناء ذلك إرسال Partial Network Learning Bit لكي تستجيب العقد المستقبلة، وRepeat Message Request Bit لكي تنتقل العقد المستقبلة أيضاً إلى الحالة NM Repeat Message State [SWS_ComM_91019]. يتم الاستدعاء بدون معاملات تمرير عبر الواجهة في ComM.h مع معرّف الخدمة 0x64 [SWS_ComM_91019].
قيم الإرجاع ومعالجة الأخطاء
تُرجع الدالة قيمة حالة من النوع Std_ReturnType [SWS_ComM_91019]:
E_OK: تم بدء خوارزمية تعلم PNC بنجاح [SWS_ComM_91019].E_NOT_OK: تعذر بدء خوارزمية تعلم PNC [SWS_ComM_91019].COMM_E_LEARNING_ACTIVE: لا يمكن تنفيذ استدعاء الدالة، نظراً لأن مرحلة تعلم PNC نشطة بالفعل [SWS_ComM_91019].
التزامن والتكوين
تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) وتتمتع بالحالة draft [SWS_ComM_91019]. وهي متاحة حصرياً إذا تم ضبط معامل التهيئة المسبقة ComMDynamicPncToChannelMappingSupport على TRUE [SWS_ComM_01044].
تستند ملاحظة الاستخدام هذه إلى مواصفات AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة ComM_UpdatePncMembership [SWS_ComM_91021] 📄 PDF
Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);
This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning. This function is used for the optional Dynamic PNC - to - channel - mapping feature. This function is used for the optional Dynamic PNC - to - channel - mapping feature. Tags: atp.Status=draft
تُستخدم الدالة المتزامنة وغير القابلة لإعادة الدخول ComM_UpdatePncMembership بواسطة Software-Components (SWCs) لتكييف عضوية PNC المنقولة أثناء تعلم PNC لمطابقة PNC بالقناة الديناميكية الاختيارية [SWS_ComM_91021]. ولا تتوفر عبر ملف الرأس ComM.h إلا إذا تم ضبط معامل التهيئة ComMDynamicPncToChannelMappingSupport على TRUE [SWS_ComM_01047].
يتم عبر المعامل ComM_PncMembership تمرير مصفوفة بايتات بطول متجه PNC، والتي تحتوي على عضوية PNC الحالية للعقدة [SWS_ComM_91021]. وإذا تم تفعيل الدالة على قناة واحدة على الأقل وكانت مرحلة تعلم PNC غير نشطة، فسيتم تقييم المعامل Control [SWS_ComM_01049]:
-
في حالة
Control = 0، يتم احتساب عضوية PNC الحالية باستخدام عملية AND منطقية معComM_PncMembership، وذلك لإعادة تعيين البتات المعنية في القناع بشكل هادف [SWS_ComM_01049]. -
في حالة
Control = 1، يتم تطبيق عملية OR منطقية لتعيين البتات في القناع [SWS_ComM_01049].
إذا كان التحديث ناجحاً، تُرجع الدالة E_OK [SWS_ComM_01049]. أما إذا كانت المطابقة الديناميكية مهيأة على قناة واحدة على الأقل وكانت مرحلة تعلم PNC نشطة، فسيتم رفض التنفيذ والإبلاغ عن قيمة الخطأ المحددة COMM_E_LEARNING_ACTIVE [SWS_ComM_01048]. وإذا حدث خطأ آخر أثناء عملية التحديث، فسيتم إرجاع E_NOT_OK [SWS_ComM_91021].
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي وتستند حصرياً إلى متطلبات مواصفات AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_PreventWakeUp [SWS_ComM_00156] 📄 PDF
Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);
Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.
الاستخدام وسياق الاستدعاء
تُستخدم الدالة ComM_PreventWakeUp وفقًا لـ [SWS_ComM_00156] لتغيير حالة الحظر COMM_NO_WAKEUP لقناة اتصال معينة. ويتم تنفيذها بشكل متزامن وهي متاحة عبر ملف الترويسة ComM.h.
عند الاستدعاء، يتم تمرير معلمتي إدخال:
Channel: يحدد القناة المعنية وفقًا للنوعNetworkHandleType([SWS_ComM_00156]).Status: قيمة بوليانية يُفعّل بها حظر الإيقاظ (TRUE) أو يُعطّل (FALSE) ([SWS_ComM_00156]).
قيم الإرجاع ومعالجة الأخطاء
كقيمة مرجعة، تقدم الدالة الحالة Std_ReturnType وفقًا لـ [SWS_ComM_00156]:
E_OK: تم تحديث حالة الإيقاظ للقناة المحددة بنجاح.E_NOT_OK: فشل تغيير حالة الإيقاظ، على سبيل المثال إذا كانت الوظيفة معطلة عبر تصنيف مجموعة Ecu (ComMEcuGroupClassification).
التزامن والقيود
تم تحديد الواجهة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_ComM_00156]). لذلك يجب على المتصلين التأكد من تجنب الاستدعاءات المتوازية للمثيل ذاته.
تم إنشاء هذه الملاحظة بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_LimitChannelToNoComMode [SWS_ComM_00163] 📄 PDF
Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);
Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode. (See also Com M_ Limit ECUTo No Com Mode, same functionality but for all channels)
تُستخدم الدالة المتزامنة ComM_LimitChannelToNoComMode ذات معرّف الخدمة 0x0b في Communication Manager لتعيين حالة الحظر لقناة اتصال مفردة [SWS_ComM_00163]. تمنع أو تسمح بانتقال القناة من الحالة COMM_NO_COMMUNICATION إلى نمط اتصال أعلى [SWS_ComM_00163].
المعلمات وسياق الاستدعاء
يتم التصريح عن الواجهة عبر ملف الترويسة ComM.h ولا تحتوي على معلمات إدخال/إخراج أو معلمات إخراج فقط [SWS_ComM_00163]. عند الاستدعاء، يتم تمرير معلمتي إدخال [SWS_ComM_00163]:
Channel: يعنون القناة المعنية عبر المعرّف من النوعNetworkHandleType[SWS_ComM_00163].Status: يحدد كـbooleanحالة الحظر المطلوبة. يؤدي تمريرTRUEإلى تفعيل تقييد القناة علىCOMM_NO_COMMUNICATION، بينما يؤديFALSEإلى إعادة تعطيل هذا التقييد [SWS_ComM_00163].
قيم الإرجاع ومعالجة الأخطاء
تُرجع الدالة قيمة من النوع Std_ReturnType إلى المتصل [SWS_ComM_00163]:
E_OK: تم تعديل حالة الحظر للقناة المعنونة بنجاح [SWS_ComM_00163].E_NOT_OK: تعذر إجراء تغيير الحالة، وهو ما يحدث على سبيل المثال إذا كانت التهيئةComMEcuGroupClassification(انظرECUC_ComM_00563) تعطل هذه الوظيفة [SWS_ComM_00163].
التزامن والارتباط بالنظام
فيما يتعلق بسلوك التنفيذ، تم تنفيذ الدالة بشكل متزامن (Synchronous) وغير قابل لإعادة الدخول (Non Reentrant) [SWS_ComM_00163]. وللغرض ذاته على مستوى النظام الإجمالي، توجد الدالة ذات الصلة ComM_LimitECUToNoComMode، والتي لا تنفذ التقييد نفسه على أساس القناة فحسب، بل بشكل موحد لجميع قنوات وحدة التحكم الإلكترونية [SWS_ComM_00163].
تم توليد ملاحظة الاستخدام هذه تلقائياً بناءً على المواصفة.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_LimitECUToNoComMode [SWS_ComM_00124] 📄 PDF
Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);
Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication Mode. (See also Com M_ Limit Channel To No Com Mode, same functionality but for a specific channels)
الاستخدام
تُعرَّف الدالة المتزامنة ComM_LimitECUToNoComMode (معرّف الخدمة 0x0c) في ComM.h وتُستخدم لتغيير حالة الحظر لوحدة التحكم الإلكترونية بأكملها [SWS_ComM_00124]. تمنع أو تسمح بالانتقال من COMM_NO_COMMUNICATION إلى نمط اتصال أعلى لجميع قنوات الاتصال في ECU [SWS_ComM_00124]. ويتم التحكم عبر المعلمة الشكلية Status:
TRUE: يفعّل تقييد وحدة التحكم الإلكترونية على النمطCOMM_NO_COMMUNICATION[SWS_ComM_00124].FALSE: يعيد تعطيل تقييد وحدة التحكم الإلكترونية علىCOMM_NO_COMMUNICATION[SWS_ComM_00124].
معالجة الأخطاء وقيم الإرجاع
تُرجع الدالة كود حالة من النوع Std_ReturnType إلى المتصل [SWS_ComM_00124]:
E_OK: تم تطبيق حالة الحظر لوحدة التحكم الإلكترونية بنجاح [SWS_ComM_00124].E_NOT_OK: فشل تغيير حالة الحظر، على سبيل المثال إذا كانت معلمة التهيئةComMEcuGroupClassification(انظرECUC_ComM_00563) تعطل هذه الوظيفة [SWS_ComM_00124].
يجب على المتصل تقييم القيمة المرجعة للتحقق مما إذا كان قد تم تفعيل التقييد بنجاح أو تم رفضه بواسطة تهيئة الوحدة [SWS_ComM_00124].
التزامن والتفاعل
تم التصريح عن الواجهة بأنها غير قابلة لإعادة الدخول (Non Reentrant)؛ ولذلك فإن الاستدعاءات المتوازية أو المقاطِعة غير مسموح بها ويجب تجنبها من جانب المتصل [SWS_ComM_00124]. بينما توفر ComM_LimitChannelToNoComMode وظيفة التحكم ذاتها بشكل معزول لقناة مفردة، تؤثر ComM_LimitECUToNoComMode دائمًا في مجمل جميع قنوات وحدة التحكم الإلكترونية [SWS_ComM_00124].
تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_ReadInhibitCounter [SWS_ComM_00224] 📄 PDF
Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);
This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.
الاستخدام وسياق الاستدعاء
تُستخدم الدالة المتزامنة ComM_ReadInhibitCounter (معرّف الخدمة 0x0d) للاستعلام عن عدد طلبات المستخدم المرفوضة بعد تشغيل الاتصال الكامل (COMM_FULL_COMMUNICATION) [SWS_ComM_00224]. يتم توفير التصريح عن الدالة عبر ملف الترويسة ComM.h [SWS_ComM_00224].
لا تحتوي الدالة على معلمات إدخال. والمعلمة الوحيدة للإخراج هي المؤشر CounterValue من النوع الأساسي uint16*، والذي يُرسل من خلاله عدد العداد للطلبات المرفوضة إلى المتصل [SWS_ComM_00224]. إذا أمكن تحديد قيمة العداد وكتابتها بنجاح، تُرجع الدالة E_OK؛ وفي حالة الفشل تُرجع E_NOT_OK [SWS_ComM_00224].
معالجة الأخطاء
لم تُدرج أكواد خطأ محددة أو أخطاء تطوير قياسية (DET) بشكل منفصل في وصف الواجهة. ومن المحتمل أن يكون الفشل مع القيمة المرجعة E_NOT_OK [SWS_ComM_00224] ناتجًا عن معلمة مؤشر غير صالحة (مؤشر فارغ Null) أو استدعاء قبل تهيئة وحدة ComM (تفسير). سؤال Q-5779d898381d9894 (مفتوح)
التزامن والقيود
تم تحديد الواجهة صراحةً على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_ComM_00224]. لذلك يجب على المتصلين ضمان عدم حدوث استدعاءات متزامنة أو مقاطِعة عبر مهام مختلفة أو روتين خدمة المقاطعة على مستوى النظام، لتجنب عدم الاتساق عند قراءة العداد.
تم إنشاء ملاحظة الاستخدام هذه آليًا وتستند إلى مواصفات إصدار AUTOSAR R20-11.
دالة ComM_ResetInhibitCounter [SWS_ComM_00108] 📄 PDF
Std_ReturnType ComM_ResetInhibitCounter (void);
This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.
الاستخدام وطريقة العمل
تُستخدم الواجهة المتزامنة ComM_ResetInhibitCounter لإعادة تعيين العداد الداخلي لطلبات الاتصال الكامل المرفوضة أو المحظورة (Inhibited COMM_FULL_COMMUNICATION request Counter) في Communication Manager [SWS_ComM_00108]. ويتم توفير الاستدعاء عبر ملف الرأس ComM.h، وله معرّف الخدمة 0x0e ولا يتطلب أي معاملات تمرير [SWS_ComM_00108]. وعند التنفيذ بنجاح، تُقدم الدالة قيمة الإرجاع E_OK من النوع Std_ReturnType [SWS_ComM_00108].
معالجة الأخطاء والشروط الحدية
إذا حدث خطأ أثناء إعادة تعيين العداد، تشير الخدمة إلى ذلك عبر قيمة الإرجاع E_NOT_OK [SWS_ComM_00108]. ولا توجد أخطاء تطوير محددة (DET) أو سيناريوهات أخطاء مسرودة في مستخرج المواصفات الحالي؛ ومن المفترض أن يفشل التنفيذ ويُرجع E_NOT_OK إذا لم تكن الوحدة قد هُيِّئت بعد. سؤال Q-31d1ba95e419fa8e (مفتوح)
التزامن
صُرِّح بالدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_ComM_00108]. لذلك يجب على المستخدمين ضمان عدم حدوث استدعاءات متوازية من خيوط أو مهام أو روتينات خدمة مقاطعة متعددة عبر مزامنة ملائمة، وذلك لتجنب التضارب في العداد.
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفات AUTOSAR.
دالة ComM_SetECUGroupClassification [SWS_ComM_00552] 📄 PDF
Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);
Changes the ECU Group Classification status (see chapter 10.2.2)
دالة ComM_GetVersionInfo [SWS_ComM_00370] 📄 PDF
void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);
This function returns the published information (for details refer to table 10.3)
دالة ComM_Nm_NetworkStartIndication [SWS_ComM_00383] 📄 PDF
void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);
Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have already entered the Network Mode.
تُستخدم الدالة ComM_Nm_NetworkStartIndication كواجهة إخطار من إدارة الشبكة إلى Communication Manager. ووفقًا لـ [SWS_ComM_00383]، فإنها تشير إلى أنه تم استلام رسالة NM أثناء حالة Bus Sleep Mode، مما يشير إلى أن بعض العقد في الشبكة قد انتقلت بالفعل إلى Network Mode.
- الاستدعاء والمعلمات: يتم التصريح عن الواجهة عبر الترويسة
ComM_Nm.hوتستقبل كمعلمة إدخال قناة الاتصال المعنيةChannelمن النوعNetworkHandleType[SWS_ComM_00383]. - التزامن والإرجاع: لا تحتوي عملية الاستدعاء على قيمة إرجاع (
void) وتتبع دلالات تنفيذ غير متزامنة [SWS_ComM_00383]. - التزامن: الدالة مزودة بمعرّف الخدمة
0x15ومحددة كقابلة لإعادة الدخول (Reentrant) [SWS_ComM_00383].
لم يتم إدراج أي رموز خطأ محددة أو رسائل DET أو DEM أو استجابات أخطاء منفصلة لهذه الواجهة في المواصفة [SWS_ComM_00383]. تفسير: من المرجح أن يكون الإشعار مخصصًا داخليًا لبدء الانتقال من حالة السكون إلى اتصال الشبكة النشط للقناة المحددة. سؤال Q-97a02db4ab6a3af8 (مفتوح)
تستند ملاحظة الاستخدام هذه حصريًا إلى بيانات مواصفات إصدار AUTOSAR برقم R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_NetworkMode [SWS_ComM_00390] 📄 PDF
void ComM_Nm_NetworkMode (NetworkHandleType Channel);
Notification that the network management has entered Network Mode.
تعمل الدالة ComM_Nm_NetworkMode في مدير اتصالات AUTOSAR (ComM) كرد نداء للإخطار تُشير به إدارة الشبكة (Nm) إلى أنه تم الدخول بنجاح في نمط الشبكة (Network Mode) [SWS_ComM_00390].
الاستدعاء والمعاملات
تتوفر الواجهة عبر ملف الرأس ComM_Nm.h ولها معرّف الخدمة 0x18 [SWS_ComM_00390]. وعند الاستدعاء، يتم تمرير قناة الاتصال المعنية عبر معامل الإدخال الوحيد Channel من النوع NetworkHandleType [SWS_ComM_00390]. ولا تُرجع الدالة أي قيمة إرجاع (نوع الإرجاع void) ولا تحتوي على معاملات إخراج [SWS_ComM_00390].
التزامن والدلالات
صُرِّح بسلوك التنفيذ لـ ComM_Nm_NetworkMode على أنه غير متزامن (Asynchronous) [SWS_ComM_00390]. وفيما يتعلق بالتزامن، حُدِّدت الدالة على أنها قابلة لإعادة الدخول (Reentrant)، بحيث يمكن استدعاؤها مع إمكانية إعادة الدخول لأحداث القنوات المتوازية [SWS_ComM_00390].
معالجة الأخطاء
نظراً لأن البنية لا تنص على قيمة إرجاع، فلن يتم إرسال رموز أخطاء مباشرةً إلى المستدعي [SWS_ComM_00390].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو مخصص للتوجيه الفني.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_PrepareBusSleepMode [SWS_ComM_00391] 📄 PDF
void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Prepare Bus - Sleep Mode.
تُستخدم الدالة ComM_Nm_PrepareBusSleepMode كواجهة إخطار لـ Communication Manager (ComM). وهي تُعلم ComM بأن إدارة الشبكة لقناة الاتصال المحددة قد انتقلت إلى الحالة «Prepare Bus - Sleep Mode» [SWS_ComM_00391].
الاستخدام والتوقيع
تتوفر الواجهة عبر ملف الرأس ComM_Nm.h ولها معرّف الخدمة 0x19 [SWS_ComM_00391]. ويتم التنفيذ بشكل غير متزامن [SWS_ComM_00391]. وتتضمن بنية الدالة المعاملات التالية:
Channel(In،NetworkHandleType): يحدد قناة الشبكة المعنية التي دخلت إدارة الشبكة الخاصة بها في نمط Prepare-Bus-Sleep [SWS_ComM_00391].- قيمة الإرجاع:
void؛ لا يتم إرجاع أي قيم حالة أو أخطاء ولا يتم تضمين أي معاملات إدخال/إخراج [SWS_ComM_00391].
التزامن والقيود
فيما يتعلق بالتزامن، حُدِّدت ComM_Nm_PrepareBusSleepMode على أنها قابلة لإعادة الدخول، ولكن مع قيد ملزم يقضي بأن ذلك لا ينطبق على نفس قناة NM (Reentrant (but not for the same NM - Channel)) [SWS_ComM_00391]. لذلك، يجوز إجراء استدعاءات متوازية لقنوات مختلفة، في حين يجب استبعاد الاستدعاءات المتزامنة لنفس القناة.
سياق الاستدعاء ومعالجة الأخطاء
تفسير: من المرجح أن يكون سياق الاستدعاء في Network Management العام أو الخاص بالناقل، والذي يُبلّغ ComM بالوصول إلى هذه الحالة. سؤال Q-41524322db480310 (مفتوح) ولا توجد رموز أخطاء محددة أو بلاغات DET أو DEM معرفة لهذه الواجهة في المواصفات [SWS_ComM_00391].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_BusSleepMode [SWS_ComM_00392] 📄 PDF
void ComM_Nm_BusSleepMode (NetworkHandleType Channel);
Notification that the network management has entered Bus - Sleep Mode. This callback function should perform a transition of the hardware and transceiver to bus - sleep mode.
الاستخدام
تُستخدم دالة إعادة الاتصال ComM_Nm_BusSleepMode كإشعار إلى الوحدة ComM بأن إدارة الشبكة قد انتقلت إلى وضع Bus-Sleep [SWS_ComM_00392]. ومن خلال هذا الاستدعاء، يجب على الدالة تنفيذ انتقال العتاد المقترن وجهاز الإرسال والاستقبال إلى وضع Bus-Sleep [SWS_ComM_00392].
الواجهة والمعلمات
يتم توفير الدالة عبر ملف الترويسة ComM_Nm.h وتحمل معرّف الخدمة (Service ID) 0x1a [SWS_ComM_00392]. ويتم الاستدعاء عبر التوقيع void ComM_Nm_BusSleepMode (NetworkHandleType Channel) مع خصائص المعلمات التالية [SWS_ComM_00392]:
Channel: معلمة إدخال من النوعNetworkHandleTypeتحدد قناة الاتصال المعنية [SWS_ComM_00392].- لم يتم تخصيص معلمات إدخال/إخراج ولا معلمات إخراج لهذه الدالة [SWS_ComM_00392].
- لا توجد قيمة إرجاع محددة (
void) [SWS_ComM_00392].
التزامن والقيود
فيما يتعلق بسلوك التنفيذ والقيود المحتملة، يحدد المتطلب الشروط العامة التالية [SWS_ComM_00392]:
- الدلالات غير المتزامنة: تم تصنيف الاستدعاء على أنه غير متزامن (Asynchronous) [SWS_ComM_00392].
- إمكانية إعادة الدخول: تم تعريف الدالة على أنها قابلة لإعادة الدخول (Reentrant) [SWS_ComM_00392].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_RestartIndication [SWS_ComM_00792] 📄 PDF
void ComM_Nm_RestartIndication (NetworkHandleType Channel);
If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND on at least on one of the coordinated busses NM is restarted, THEN the NM Interface shall call the callback function Com M_ Nm_ Res tart Indication with the nm Network Handle of the channels which have already indicated bus sleep state.
يتم استدعاء دالة الاستدعاء الذاتي ComM_Nm_RestartIndication ذات Service-ID 0x1b بواسطة NM-Interface وتكون مصرحاً بها عبر ملف الرأس ComM_Nm.h [SWS_ComM_00792]. وتُستخدم لإخطار Communication Manager بإعادة تشغيل إدارة الشبكة أثناء عملية إيقاف تشغيل جارية لنواقل منسقة [SWS_ComM_00792]. تحدد معلمة الإدخال الوحيدة Channel من النوع NetworkHandleType القناة المعنية؛ ولا ترجع العملية أي قيمة [SWS_ComM_00792].
تم تحديد الواجهة على أنها غير متزامنة وقابلة لمعاودة الدخول [SWS_ComM_00792]. ويتم استدعاؤها بواسطة NM-Interface عند توفر ثلاثة شروط في الوقت نفسه:
- بدأت NM-Interface بالفعل في إيقاف تشغيل النواقل المنسقة [SWS_ComM_00792].
- لم تبلغ جميع هذه النواقل المنسقة بعد عن حالة Bus-Sleep [SWS_ComM_00792].
- تتم إعادة تشغيل إدارة الشبكة على واحد على الأقل من النواقل المنسقة [SWS_ComM_00792].
لم يتم النص في مقتطف المواصفة على رموز أخطاء محددة أو استجابات للأخطاء أو رسائل إلى وحدة اختبار التطوير أو ذاكرة الأخطاء (DET/DEM) [SWS_ComM_00792]. تفسير: يُرجح أن تكون الدالة مخصصة في ComM لمواءمة الحالة الداخلية للقنوات النائمة بالفعل مجدداً مع تنسيق الناقل المُعاد تنشيطه. سؤال (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على المواصفة.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_RepeatMessageLeftIndication [SWS_ComM_91024] 📄 PDF
void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);
Notification that the state of all
الاستخدام
تُستخدم الدالة ComM_Nm_RepeatMessageLeftIndication كواجهة إشعار تشير إلى ComM بأن حالة جميع وحدات Bus-NM (<Bus Nm>) قد غادرت الحالة Repeat Message [SWS_ComM_91024]. وفي إطار الميزة الوظيفية الاختيارية للتعيين الديناميكي لمجموعات Partial Network Clusters إلى القنوات (Dynamic PNC-to-channel-mapping)، يشير هذا الاستدعاء إلى انتهاء مرحلة التعلم [SWS_ComM_91024].
يتم التصريح عن الواجهة عبر ملف الرأس ComM_Nm.h وليس لها قيمة إرجاع (void) [SWS_ComM_91024]. ويتم إرسال قناة الاتصال المعنية كمعامل تمرير:
Channel(In،NetworkHandleType): معرّف القناة التي يتم الإبلاغ عن مغادرة الحالة لها [SWS_ComM_91024].
التفاعل والأثر الوظيفي
يتحكم سلوك الإشارة في مرحلة تعلم PNC: إذا تم ضبط معامل التهيئة ComMDynamicPncToChannelMappingEnabled على TRUE وتم استدعاء ComM_Nm_RepeatMessageLeftIndication، فإن ComM يضبط مرحلة تعلم PNC (PNC Learning Phase) للقناة المعنية على غير نشطة [SWS_ComM_01029] [SWS_ComM_01046].
التزامن والقيود
تم تحديد الواجهة على أنها قابلة لإعادة الدخول وتتميز بدلالات تنفيذ غير متزامنة [SWS_ComM_91024]. وفي هذه المواصفة الحالية، تم تمييز العنصر أيضاً بحالة التطوير draft [SWS_ComM_91024].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_PncLearningBitIndication [SWS_ComM_91026] 📄 PDF
void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);
Service to indicate that an NM message with set PNC Learning Bit has been received. Tags: atp.Status=draft
تُستخدم الدالة ComM_Nm_PncLearningBitIndication كواجهة إشعار للوحدة ComM للإشارة إلى استلام رسالة NM مع تعيين PNC-Learning-Bit [SWS_ComM_91026]. تمتلك الواجهة معرّف الخدمة 0x69، ويتم توفيرها عبر ملف الرأس ComM_Nm.h، وهي مميزة في المواصفات بالحالة «draft» [SWS_ComM_91026].
تنطبق التحديدات التالية فيما يتعلق بالاستخدام والتوقيع:
- المعاملات: يتم تمرير
Channelمن النوعNetworkHandleTypeكمعامل إدخال، والذي يحدد قناة الاتصال المعنية [SWS_ComM_91026]. ولا توجد معاملات إدخال/إخراج ولا معاملات إخراج، ونوع الإرجاع هوvoid[SWS_ComM_91026]. - التزامن: تم تحديد الاستدعاء على أنه غير متزامن وقابل لإعادة الدخول [SWS_ComM_91026]. ووفقاً للاسم وملف الرأس، فمن المحتمل أن يتم الاستدعاء عادةً بواسطة وحدة NM التابعة بمجرد استلام رسالة NM المقابلة. سؤال Q-31b0ce30b88c71b6 (مفتوح)
- معالجة الأخطاء: لم يتم توثيق أي قيم إرجاع أو رموز أخطاء محددة أو رسائل إلى DET أو DEM لهذه الخدمة ضمن نطاق المواصفات.
بالتفاعل مع مطابقة PNC الديناميكية، تتحكم الدالة في تفعيل مرحلة التعلم: إذا تم استدعاء ComM_Nm_PncLearningBitIndication على قناة تم فيها ضبط معامل التهيئة ComMDynamicPncToChannelMappingEnabled على TRUE، فيجب على ComM ضبط مرحلة تعلم PNC (PNC Learning Phase) لهذه القناة على نشطة [SWS_ComM_01026]. وتطلق ComM نفس الحالة لمرحلة تعلم نشطة على القناة المعنية وفقاً للمواصفات أيضاً عندما تستدعي الوحدة نفسها Nm_PnLearningRequest [SWS_ComM_01026].
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على متطلبات المواصفات.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_Nm_ForwardSynchronizedPncShutdown [SWS_ComM_91003] 📄 PDF
void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);
If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a
يتم التصريح عن الدالة المتزامنة والقابلة لإعادة الدخول ComM_Nm_ForwardSynchronizedPncShutdown (معرّف الخدمة 0x6b) عبر الترويسة ComM_Nm.h وتُستخدم للتمرير المنسق لعملية إيقاف تشغيل PNC متزامنة [SWS_ComM_91003].
الاستخدام وسياق الاستدعاء: يتم استدعاؤها عندما تستقبل وحدة تحكم إلكترونية تؤدي دور منسق PNC وسيط (intermediate PNC coordinator) رسالة إيقاف تشغيل PN عبر NM خاص بالناقل [SWS_ComM_91003]. ويتم تمرير قناة الاتصال المعنية (Channel من النوع NetworkHandleType) كمعلمة إدخال وحيدة. ولا توجد قيمة إرجاع معرّفة (void) [SWS_ComM_91003].
التفاعل والتسلسل: بعد الإشعار، تحرر ComM على الفور آلات حالات PNC المعنية. بالإضافة إلى ذلك، فإنها تمرر معلومات PN مباشرةً إلى قنوات ComM المعنية وكذلك قنوات NM المقابلة [SWS_ComM_91003]. يضمن ذلك إيقاف تشغيل PNC متزامن إلى حد كبير عبر طوبولوجيا PN الهرمية بدءًا من المنسق الأعلى للمستوى وصولاً إلى عقد PNC التابعة [SWS_ComM_91003].
معالجة الأخطاء والشروط الحدية: نظرًا لأن الواجهة ليس لها قيمة إرجاع ولم يتم توثيق أي رموز خطأ محددة، فمن المرجح أن تتم معالجة الأخطاء داخليًا أو عبر DET. سؤال Q-618a8c1da055cdf5 (مفتوح) تم تصنيف العنصر كمسودة Draft في الإصدار R20-11 [SWS_ComM_91003].
تم إنشاء ملاحظة الاستخدام هذه تلقائياً بالاستناد إلى مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_DCM_ActiveDiagnostic [SWS_ComM_00873] 📄 PDF
void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);
Indication of active diagnostic by the DCM.
الاستخدام وسياق الاستدعاء
تُستخدم الواجهة المتزامنة ComM_DCM_ActiveDiagnostic بواسطة Diagnostic Communication Manager (DCM) لإخطار Communication Manager (ComM) بأنشطة التشخيص النشطة على قناة اتصال معينة [SWS_ComM_00873]. تُعرَّف الدالة في ملف الترويسة ComM_Dcm.h ومبينة بمعرّف الخدمة 0x1f [SWS_ComM_00873].
تعمل معلمة الإدخال Channel من نوع البيانات NetworkHandleType كمعلمة استدعاء وحيدة، وتحدد بشكل فريد القناة المعنية لاتصال التشخيص القادم [SWS_ComM_00873]. لا تحتوي الواجهة على قيمة مرجعة (نوع الإرجاع void)، ولا توجد معلمات إدخال/إخراج أو معلمات إخراج [SWS_ComM_00873].
التزامن والقيود
فيما يتعلق بالتزامن، حُدد عنصر الخدمة بأنه قابل لإعادة الدخول (reentrant) [SWS_ComM_00873]. يتيح ذلك إجراء استدعاءات متزامنة متوازية للدالة من سياقات تنفيذ مختلفة، على سبيل المثال عندما يتعين على DCM إدارة عدة قنوات شبكة أو خدمتها في الوقت نفسه.
معالجة الأخطاء والتفاعل
لم تُحدد لهذا الاستدعاء رموز أخطاء خاصة أو رسائل موجهة إلى إدارة أخطاء التطوير (DET) أو إدارة ذاكرة أخطاء التشخيص (DEM) [SWS_ComM_00873]. يقتصر التفاعل على تبادل الإشارات بين DCM وComM؛ تفسير: يُرجح أن يُستخدم الاستدعاء في ComM للإبقاء على القناة المعنية في حالة اتصال نشطة طوال مدة نشاط التشخيص [SWS_ComM_00873]. سؤال Q-bfd91da2e435fbb6 (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR Classic الإصدار R20-11.
دالة ComM_DCM_InactiveDiagnostic [SWS_ComM_00874] 📄 PDF
void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);
Indication of inactive diagnostic by the DCM.
الاستخدام
تُستخدم الدالة المتزامنة ComM_DCM_InactiveDiagnostic لتمكين Diagnostic Communication Manager (DCM) من الإشارة إلى Communication Manager (ComM) بأن اتصال التشخيص على قناة معينة غير نشط ولم يعد مطلوباً [SWS_ComM_00874]. يتم توفير التصريح عن هذه الواجهة عبر ملف الرأس ComM_Dcm.h مع Service-ID 0x20 [SWS_ComM_00874].
يتم تمرير Channel من النوع NetworkHandleType كمعلمة إدخال، والتي تحدد قناة الاتصال المعنية [SWS_ComM_00874]. ولا تحتوي الدالة على معلمات إدخال/إخراج أو معلمات إخراج، ولا ترجع أي قيمة (void) [SWS_ComM_00874].
التزامن ومعالجة الأخطاء
تم تحديد الواجهة بأنها قابلة لمعاودة الدخول [SWS_ComM_00874]، بحيث تكون الاستدعاءات المتزامنة — على سبيل المثال لقنوات اتصال مختلفة — مسموحاً بها. ولم يتم تحديد رموز أخطاء معينة أو رسائل خطأ لـ DET أو أحداث لـ DEM لهذه الدالة في الحمولة [SWS_ComM_00874]. ويُرجح أن تستخدم وحدة ComM إشعار عدم النشاط داخلياً لسحب طلبات التشخيص الحالية للقناة وتعديل حالة القناة وفقاً لذلك. سؤال Q-148d39d8c17e936c (مفتوح)
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويلخص المواصفة بناءً على إصدار AUTOSAR R20-11.
دالة ComM_EcuM_WakeUpIndication [SWS_ComM_00275] 📄 PDF
void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);
Notification of a wake up on the corresponding channel.
تُستخدم الدالة ComM_EcuM_WakeUpIndication لإخطار Communication Manager (ComM) بحدث إيقاظ وقع على قناة الاتصال المعنية [SWS_ComM_00275]. ومن المرجح عادةً أن يتم الاستدعاء بواسطة ECU State Manager (EcuM) بمجرد تسجيله لإيقاظ مطابق على إحدى القنوات. سؤال Q-5f8c43b9df10dc8e (مفتوح)
الاستخدام وسياق الاستدعاء
عُرِّفت الواجهة بأنها متزامنة ولها معرّف الخدمة 0x2a [SWS_ComM_00275]. وعبر معامل الإدخال Channel من النوع NetworkHandleType، يتم تمرير معرّف قناة الاتصال التي تم اكتشاف الإيقاظ عليها [SWS_ComM_00275]. وليس للدالة قيمة إرجاع (void) ويتم التصريح عنها عبر ملف الرأس ComM_EcuM.h [SWS_ComM_00275].
التزامن والقيود
وفقاً للمواصفات، صُنِّفت ComM_EcuM_WakeUpIndication على أنها قابلة لإعادة الدخول [SWS_ComM_00275]. وبذلك يجوز استدعاء الدالة بشكل متوازٍ لقنوات مختلفة أو من سياقات متزامنة. ولا توجد رموز أخطاء محددة أو قيم إرجاع أو بلاغات DET/DEM موضحة في تعريف العنصر [SWS_ComM_00275].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي. جميع البيانات مأخوذة حصرياً من حمولة مواصفات إصدار AUTOSAR رقم R20-11.
دالة ComM_EcuM_PNCWakeUpIndication [SWS_ComM_91001] 📄 PDF
void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);
Notification of a wake up on the corresponding partial network cluster.
الاستخدام وسياق الاستدعاء
تخدم الدالة المتزامنة ComM_EcuM_PNCWakeUpIndication إخطار Communication Manager بحدوث تنبيه (Wake-up) على Partial Network Cluster (PNC) [SWS_ComM_91001]. ويتم التصريح عنها عبر الترويسة ComM_EcuM.h وتتوقع كمعلمة إدخال PNCid معرف المجموعة المتأثرة؛ ولا توجد قيم إرجاع [SWS_ComM_91001]. تفسير: يتم الاستدعاء نمطيًا بواسطة ECU State Manager (EcuM) عند اكتشاف حدث PNC المقابل. سؤال Q-fee4a70f73cde8ea (مفتوح)
التزامن وانتقالات الحالة
حُددت الواجهة بأنها قابلة لإعادة الدخول (reentrant) [SWS_ComM_91001]. يؤدي استدعاؤها إلى إحداث تغييرات موجهة في الحالة داخل آلات حالة PNC والقناة الخاصة بـ ComM:
- إذا كان العنقود المشار إليه في حالة PNC الرئيسية
PNC_NO_COMMUNICATION، يتم الخروج منها والانتقال إلى حالة PNC الفرعيةPNC_PREPARE_SLEEP[SWS_ComM_00964]. - إذا تم الاستدعاء في الحالة الفرعية
COMM_NO_COM_NO_PENDING_REQUESTمع تفعيل دعم PNC (ComMPncSupport=TRUE) وتعطيل الاستيقاظ المتزامن (ComMSynchronousWakeUp=FALSE)، ينقل المكون آلات حالة قنوات ComM المشار إليها بواسطة PNC المحدد إلى الحالة الفرعيةCOMM_NO_COM_REQUEST_PENDING[SWS_ComM_01014]. - أما إذا كان
ComMSynchronousWakeUp=TRUEمهيأً مع تفعيلComMPncSupport، فإن الاستدعاء في الحالة الفرعيةCOMM_NO_COM_NO_PENDING_REQUESTيحوّل جميع آلات حالة قنوات ComM بلا استثناء إلى الحالة الفرعيةCOMM_NO_COM_REQUEST_PENDING[SWS_ComM_01015].
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_CommunicationAllowed [SWS_ComM_00871] 📄 PDF
void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);
Ecu M or Bsw M shall indicate to Com M when communication is allowed. If Ecu M/ Flex is used: Bsw M AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager
عبر الدالة ComM_CommunicationAllowed ([SWS_ComM_00871])، يتم التوضيح لوحدة ComM بواسطة EcuM أو BswM ما إذا كان الاتصال مسموحًا به لقناة معينة.
الاستخدام وسياق الاستدعاء
تُستدعى الواجهة بواسطة الوحدة EcuM أو BswM؛ وفي حال استخدام EcuM Flex، تتولى BswM هذه المهمة ([SWS_ComM_00871]). يتم التصريح عن الدالة عبر الترويسة ComM_BswM.h وتحمل معرّف الخدمة 0x35 ([SWS_ComM_00871]).
لا تمتلك الدالة أي قيمة مرجعة (void) وتتوقع معلمات التمرير التالية ([SWS_ComM_00871]):
Channel(النوعNetworkHandleType): يحدد قناة الاتصال المعنية ([SWS_ComM_00871]).Allowed(النوعboolean): يمرر حالة الإتاحة معTRUEللاتصال المسموح به أوFALSEللاتصال غير المسموح به ([SWS_ComM_00871]).
التزامن والقيود
تعمل الدالة وفقًا للمواصفة بشكل غير متزامن (Asynchronous) ومصنفة على أنها غير قابلة لإعادة الدخول (Non Reentrant) ([SWS_ComM_00871]). وبسبب عدم قابلية إعادة الدخول، يُفترض أن يتعين على المتصل ضمان عدم إجراء أي استدعاءات متوازية أو مقاطِعة للواجهة. سؤال Q-e6688e3286d9ed60 (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على المواصفة SWS_ComM_00871.
دالة ComM_BusSM_ModeIndication [SWS_ComM_00675] 📄 PDF
void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);
Indication of the actual bus mode by the corresponding Bus State Manager. Com M shall propagate the indicated state to the users with means of the RTE and Bsw M.
الاستخدام والتوقيع
تُستخدم الواجهة ComM_BusSM_ModeIndication لإشارة وضع الناقل الفعلي بواسطة Bus State Manager المسؤول إلى الوحدة ComM [SWS_ComM_00675]. تتوفر دالة C عبر ملف الرأس ComM.h وتدار تحت Service-ID 0x33 [SWS_ComM_00675]. وبنيتها النحوية هي void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675].
تستقبل الدالة معلمتي إدخال:
Channel: قناة الاتصال المعنية من النوعNetworkHandleType[SWS_ComM_00675].ComMode: الوضع الفعلي للناقل من النوعComM_ModeType[SWS_ComM_00675].
لا تمتلك الواجهة قيمة إرجاع (void) ولا تحدد معلمات إدخال/إخراج أو معلمات إرجاع بحتة [SWS_ComM_00675].
التزامن والمزامنة
بالنسبة لسلوك وقت التشغيل، تم تحديد أن الاستدعاء يتم بشكل غير متزامن (Asynchronous) وأنه يمكن تنفيذ الدالة مع إمكانية معاودة الدخول (Reentrant) [SWS_ComM_00675].
التفاعل في النظام الكلي
تقوم الوحدة ComM بتمرير الحالة المبلغ عنها عبر هذا الاستدعاء إلى المستخدمين [SWS_ComM_00675]. ويتم نشر حالة الناقل هذه عبر واجهات RTE و BswM [SWS_ComM_00675].
تم إنشاء ملاحظة الاستخدام هذه بصورة آلية بناءً على مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة ComM_BusSM_BusSleepMode [SWS_ComM_91000] 📄 PDF
void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);
Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep. Only applicable for Com M channels with Com MNm Variant set to SLAVE_ ACTIVE or SLAVE_ PASSIVE. E.g. LIN slaves (Com MNMVariant = SLAVE_ ACTIVE) or Ethernet channels with OA TC10 compliant Ethernet hardware which act as passive communication slave (Com MNMVariant = SLAVE_ PASSIVE and Eth Trcv Act As Slave Passive Enabled set to TRUE)
الاستخدام
تُستخدم دالة الخدمة المتزامنة ComM_BusSM_BusSleepMode بواسطة Bus State Manager (BusSM) المسؤول كإشعار إلى Communication Manager (ComM) بأن وضع الناقل الفعلي لقناة اتصال قد انتقل إلى الحالة Bus-Sleep [SWS_ComM_91000]. يتم تحديد القناة المعنية عبر معلمة الإدخال Channel من النوع NetworkHandleType [SWS_ComM_91000]. لا تصرح الدالة عن معلمات إخراج ولا عن قيمة إرجاع (void) [SWS_ComM_91000].
الصلاحية المعتمدة على التكوين
الاستدعاء ليس مسموحاً به عالمياً، بل يقتصر صراحة على قنوات ComM التي تم ضبط معلمتها ComMNmVariant على SLAVE_ACTIVE أو SLAVE_PASSIVE [SWS_ComM_91000]. وتذكر المواصفة سيناريوهين نموذجيين للاستخدام في هذا الصدد:
- توابع LIN مع التكوين
ComMNmVariant = SLAVE_ACTIVE[SWS_ComM_91000]. - قنوات Ethernet ذات عتاد متوافق مع OPEN Alliance TC10 والتي تعمل كتوابع اتصال سلبية، حيث يتم تعيين
ComMNmVariant = SLAVE_PASSIVEوالمعلمةEthTrcvActAsSlavePassiveEnabledعلىTRUE[SWS_ComM_91000].
التزامن والتكامل
تمتلك الواجهة Service-ID 0x34، وهي مصرح بها عبر ملف الرأس ComM.h ومصنفة بأنها قابلة لمعاودة الدخول [SWS_ComM_91000]. ولا يتم توضيح أي رموز أخطاء محددة أو سلوك منفصل في حالة الخطأ في تعريف الدالة [SWS_ComM_91000].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComM_InitStatusType [SWS_ComM_00668] 📄 PDF
Initialization status of Com M.
يُستخدم نوع التعداد ComM_InitStatusType لتمثيل حالة تهيئة الوحدة ComM (COM Manager) وهو متاح عبر ملف الرأس ComM.h [SWS_ComM_00668].
يتضمن نطاق القيم حالتين اثنتين بالضبط للتمييز بين الجاهزية التشغيلية [SWS_ComM_00668]:
COMM_UNINIT(مشفر بالقيمة0x00أو0): يشير إلى أن COM Manager غير مهيأ أو غير قابل للاستخدام. تكون هذه الحالة إجبارياً هي القيمة الافتراضية مباشرة بعد إعادة الضبط [SWS_ComM_00668].COMM_INIT(مشفر بالقيمة0x01): يشير إلى أنه تم تهيئة COM Manager بشكل صحيح وأنه جاهز للاستخدام [SWS_ComM_00668].
فيما يتعلق بالترتيب الزمني واستخدام الوحدة، تحدد هذه الحالة إمكانية الاستخدام الأساسية لـ COM Manager [SWS_ComM_00668]. تفسير: يُرجح أن تقوم جهات الاستدعاء أو الروتينات الداخلية للوحدة بتقييم هذه الحالة للتأكد من عدم معالجة أي طلبات اتصال في الحالة COMM_UNINIT، نظراً لأن COM Manager محدد صراحة في هذه الحالة بأنه غير قابل للاستخدام [SWS_ComM_00668]. سؤال Q-2c4da2e5c40a0f4b (مفتوح) ولا تصبح الوحدة متاحة للتفاعلات الأعلى مستوى إلا بعد الانتقال الناجح إلى COMM_INIT.
تم إنشاء هذا النص بواسطة ذكاء اصطناعي؛ وتظل المواصفة وحدها ملزمة.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComM_PncModeType [SWS_ComM_00673] 📄 PDF
Current mode of a PNC
يحدد نوع التعداد ComM_PncModeType حالة التشغيل الحالية لـ Partial Network Cluster (PNC) في Communication Manager [SWS_ComM_00673]. يُتاح هذا النوع عبر ملف الرأس ComM.h ويتضمن خمس حالات منفصلة [SWS_ComM_00673]:
COMM_PNC_REQUESTED(0x00): يتم طلب PNC بواسطة مستخدم ComM محلي.COMM_PNC_READY_SLEEP(0x01): يتم طلب PNC بواسطة مستخدم ComM بعيد.COMM_PNC_PREPARE_SLEEP(0x02): الـ PNC نشط، ولكن بدون مراقبة المواعيد النهائية (Deadline Monitoring).COMM_PNC_NO_COMMUNICATION(0x03): لا يحدث أي اتصال للـ PNC.COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST(0x04): طلب PNC محلي مع مطالبة إضافية بإيقاظ العتاد إلى BswM.
في إطار التفاعل مع BswM، يُستخدم الوضع COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST للإشارة إلى أن الطلب النشط يجب أن يُطلق أيضاً عملية إيقاظ عتاد الاتصال [SWS_ComM_00673]. يتطلب ذلك أن تكون الوظيفة مدعومة ومكونة، على سبيل المثال في تبديل المنافذ (Port-Switching) لمفاتيح Ethernet وفقاً لـ OA TC10 [SWS_ComM_00673]. كأحد القيود، تجدر الإشارة إلى أن هذا الوضع مميز بالحالة draft في الإصدار R20-11 [SWS_ComM_00673].
نظراً لأنه مجرد تعريف نوع، فلا توجد روتينات خاصة لمعالجة الأخطاء أو متطلبات معاودة الدخول (Reentrancy) لـ ComM_PncModeType.
تفسير: نظراً لأن النوع مصرح به في ComM.h ويتم توجيهه إلى BswM كمستلم لمعلومات الوضع، فمن المرجح استخدام نوع البيانات كمعلمة واجهة لرسائل حالة PNC عبر الوحدات النمطية. سؤال Q-88ad945ffcf90e9e (مفتوح)
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComM_StateType [SWS_ComM_00674] 📄 PDF
State and sub - state of Com M state machine Com M states vs. Communication Modes: COMM_ NO_ COM* : Communication Mode='No Communication' COMM_ FULL_ COM*: Communication Mode='Full Communication' COMM_ SILENT_ COM: Communicatio Mode='Silent Communication'
الاستخدام والتعريف
يمثل النوع ComM_StateType الحالات والحالات الفرعية لآلة الحالة الداخلية لـ Communication Manager (ComM) في منصة AUTOSAR Classic [SWS_ComM_00674]. وهو معرف كنوع مستقل بناءً على النوع القياسي uint8 ويتم توفيره عبر ملف الترويسة ComM.h لمكونات البرمجيات ووحدات BSW [SWS_ComM_00674].
نطاق القيم والحالات الفرعية
يشمل نطاق القيم خمس قيم محددة تمثل بدقة مرحلة آلة حالة الاتصال [SWS_ComM_00674]:
COMM_NO_COM_NO_PENDING_REQUEST(القيمة 0): يميز الحالة داخل No Communication، عندما لا يوجد حاليًا أي طلب اتصال [SWS_ComM_00674].COMM_NO_COM_REQUEST_PENDING(القيمة 1): يميز الحالة داخل No Communication، أثناء وجود طلب اتصال معلق [SWS_ComM_00674].COMM_FULL_COM_NETWORK_REQUESTED(القيمة 2): يميز الحالة داخل Full Communication، حيث تكون الشبكة مطلوبة بنشاط [SWS_ComM_00674].COMM_FULL_COM_READY_SLEEP(القيمة 3): يميز الحالة داخل Full Communication، حيث لم يعد هناك أي طلبات نشطة وتكون الشبكة جاهزة للانتقال إلى وضع السكون [SWS_ComM_00674].COMM_SILENT_COM(القيمة 4): يطابق نمط الاتصال Silent Communication [SWS_ComM_00674].
التعيين إلى أنماط الاتصال
ترتبط قيم ComM_StateType بعلاقة مباشرة بأنماط الاتصال (Communication Modes) العليا لـ ComM [SWS_ComM_00674]. جميع الحالات ذات البادئة COMM_NO_COM* مخصصة للنمط No Communication، بينما تطابق الحالات ذات البادئة COMM_FULL_COM* النمط Full Communication [SWS_ComM_00674]. وتمثل القيمة COMM_SILENT_COM نمط الاتصال الذي يحمل الاسم نفسه Silent Communication [SWS_ComM_00674].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى المواصفة R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComM_ConfigType [SWS_ComM_00162] 📄 PDF
This type contains the implementation - specific post build configuration structure.
نوع ComM_ModeType [SWS_ComM_00672] 📄 PDF
Current mode of the Communication Manager (main state of the state machine).
يمثل نوع البيانات ComM_ModeType وضع الاتصال الحالي، وبالتالي الحالة الأساسية لآلة حالة قناة ComM في Communication Manager [SWS_ComM_00672]. وهو مشتق من النوع الأساسي uint8 ويتم توفيره عبر ملف الرأس Rte_ComM_Type.h للاستخدام من قِبل مكونات البرمجيات ووحدات BSW الأخرى [SWS_ComM_00672].
يتضمن نطاق القيم أربعة أوضاع تشغيل منفصلة تحدد قدرة الاتصال للقناة المعنية [SWS_ComM_00672]:
COMM_NO_COMMUNICATION(0): تكون القناة المكونة في حالة خمول ولا تمتلك القدرة على الإرسال أو الاستقبال [SWS_ComM_00672].COMM_SILENT_COMMUNICATION(1): تقتصر القناة على القدرة على الاستقبال السلبي؛ ويتم منع إرسال الرسائل [SWS_ComM_00672].COMM_FULL_COMMUNICATION(2): تكون القناة في وضع الاتصال الكامل مع قدرة نشطة على الإرسال والاستقبال [SWS_ComM_00672].COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST(3): تمتلك القناة قدرة الإرسال والاستقبال إلى الطبقة السفلية، على سبيل المثال لأجهزة Ethernet وفقاً لـ OPEN Alliance TC10 [SWS_ComM_00672].
تنطبق قيود وظيفية أساسية عند الاستخدام: الوضع COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST مزود بالعلامة atp.Status=draft ومخصص صراحة للاستخدام الداخلي البحت داخل آلة حالة قناة ComM [SWS_ComM_00672]. وبالتالي، يُفترض ألا يُسمح للمستخدمين الخارجيين أو مكونات البرمجيات المتراكبة بطلب هذه الحالة كوضع مستهدف ولا بتوقعها مباشرة عبر الواجهات. سؤال Q-e5f4abe0d6543c82 (مفتوح) ولا توجد رموز أخطاء محددة أو عمليات فحص وقت التشغيل أو رسائل تم الإبلاغ عنها إلى DET أو DEM محددة لهذا النوع [SWS_ComM_00672].
تم إنشاء ملاحظة الاستخدام هذه آلياً وتستند إلى متطلبات AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComM_UserHandleType [SWS_ComM_00670] 📄 PDF
Handle to identify a user. For each user, a unique value must be defined at system generation time. Maximum number of users is 255. Legal user IDs are in the range 0 .. 254; user ID 255 is reserved and shall have the symbolic representation COMM_ NOT_ USED _ USER_ ID.
نوع ComM_UserHandleArrayType [SWS_ComM_00906] 📄 PDF
number Of Requesters contains the number of valid user handle entries in the "handle Array" member. If no user keeps the channel requested, this is zero {LOWER - LIMIT=0, UPPER - LIMIT= MAX_ CHANNEL_ REQUESTER }
نوع ComM_UserHandleSubArrayType [SWS_ComM_01005] 📄 PDF
This element contains the user handles of the users which keep the channel requested (if any), starting in its first entries. The size of the array MAX_ CHANNE L_ REQUESTERS is the maximum of the number of users requesting a channel.
نوع ComM_PncMembershipType [SWS_ComM_91103] 📄 PDF
Array of uint8 with
نوع modeLimitation [SWS_ComM_01009] 📄 PDF
-
تم تعريف عنصر المواصفة modeLimitation وفقاً لـ [SWS_ComM_01009] كمنفذ مُقدَّم (Provided Port) لمدير الاتصالات (ComM) للواجهة ComM_ECUModeLimitation. تفسير: من المرجح أن توفر الوحدة ComM عبر واجهة المنفذ هذه آليات لمكونات البرمجيات الأعلى مستوى أو لـ BswM للحد المستهدف من أوضاع الاتصال النشطة على مستوى وحدة التحكم الإلكترونية (ECU)، لتأمين استهلاك الطاقة أو أوضاع التشغيل على سبيل المثال. سؤال Q-337c6b40bd72cf76 (مفتوح)
يخضع توفير هذا المنفذ في النظام لشرط تباين صريح: وفقاً لـ [SWS_ComM_01009]، لا يتوفر العنصر في النظام إلا إذا تم ضبط خيار التكوين {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true. يُفترض أن يؤدي إلغاء تنشيط هذه المعلمة إلى حذف المنفذ أثناء توليد التعليمات البرمجية. سؤال (مفتوح) ولذلك، لا يجوز لمكونات البرمجيات التطبيقية والأساسية ربط هذه الواجهة معمارياً إلا عند تنشيط الخيار.
فيما يتعلق بعمليات الواجهة الملموسة والمعلمات ومعاودة الدخول بالإضافة إلى رسائل الخطأ إلى DET أو DEM، لا يتضمن [SWS_ComM_01009] أي أحكام منفصلة. وبالتالي، يجب على القائمين على الدمج قبل كل شيء التأكد من تفعيل التكوين المطلوب في الحاوية ComMGeneral قبل ربط المكونات بالمنفذ modeLimitation.
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة SWS_ComM_01009.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع ComMMode [SWS_ComM_01012] 📄 PDF
-
تم تحديد النوع ComMMode في الوحدة ComM كـ Mode Declaration Group [SWS_ComM_01012]. العنصر مخصص للفئة ALPHABETIC_ORDER ويحدد أوضاع الاتصال الأساسية للوحدة [SWS_ComM_01012].
تتضمن المجموعة ثلاث حالات إلزامية [SWS_ComM_01012]:
COMM_NO_COMMUNICATION: يُستخدم كوضع أولي للمجموعة [SWS_ComM_01012].COMM_SILENT_COMMUNICATION: يمثل وضع اتصال سلبي [SWS_ComM_01012].COMM_FULL_COMMUNICATION: يميز عملية الاتصال غير المقيدة [SWS_ComM_01012].
تم تحديد COMM_NO_COMMUNICATION كوضع أولي، وبذلك يبدأ النظام افتراضياً بدون اتصال نشط [SWS_ComM_01012]. لم يتم تحديد قيمة خاصة للانتقالات («On transition value») [SWS_ComM_01012]؛ تفسير: يعني هذا على الأرجح أن تغييرات الحالة تتم مباشرة دون حالات وسيطة محددة. سؤال Q-f0e73d26f85073b4 (مفتوح) تفسير: يُرجح أن تعكس الأوضاع حالة الاتصال للقنوات أو مستخدمي الاتصال في الوحدة. سؤال Q-ef5fa29f6af152c7 (مفتوح) تفسير: يُرجح أن الفئة ALPHABETIC_ORDER تحدد بالدرجة الأولى التعداد والتمثيل المعياريين لواجهات RTE. سؤال Q-12af3dde3a4cc95e (مفتوح)
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على SWS_ComM_01012.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_ComM- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_ComM@rel:R20-11#11ba6cc4- Content hash
11ba6cc4- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_COMManager.pdf#nameddest=SWS_ComM_00146
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني