ADC Driver (Adc)
Provides initialization and conversion services for analog-to-digital converters.
Funktionen — Übersicht
void Adc_Init (const Adc_ConfigType* ConfigPtr);Initializes the ADC hardware units and driver.Std_ReturnType Adc_SetupResultBuffer (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);Initializes ADC driver with the group specific result buffer start address where the conversion results will be stored.void Adc_DeInit (void);Returns all ADC HW Units to a state comparable to their power on reset state.void Adc_StartGroupConversion (Adc_GroupType Group);Starts the conversion of all channels of the requested ADC Channel group.void Adc_StopGroupConversion (Adc_GroupType Group);Stops the conversion of the requested ADC Channel group.Std_ReturnType Adc_ReadGroup (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);Reads the group conversion result of the last completed conversion round of the requested group and stores the channe l values...void Adc_EnableHardwareTrigger (Adc_GroupType Group);Enables the hardware trigger for the requested ADC Channel group.void Adc_DisableHardwareTrigger (Adc_GroupType Group);Disables the hardware trigger for the requested ADC Channel group.void Adc_EnableGroupNotification (Adc_GroupType Group);Enables the notification mechanism for the requested ADC Channel group.void Adc_DisableGroupNotification (Adc_GroupType Group);Disables the notification mechanism for the requested ADC Channel group.Adc_StatusType Adc_GetGroupStatus (Adc_GroupType Group);Returns the conversion status of the requested ADC Channel group.Adc_StreamNumSampleType Adc_GetStreamLastPointer (Adc_GroupType Group, Adc_ValueGroupType* * PtrToSamplePtr);Returns the number of valid samples per channel, stored in the result buffer.void Adc_GetVersionInfo (Std_VersionInfoType* versioninfo);Returns the version information of this module.Std_ReturnType Adc_SetPowerState (Adc_PowerStateRequestResultType* Result);This API configures the Adc module so that it enters the already prepared power state, chosen between a predefined set of...Std_ReturnType Adc_GetCurrentPowerState (Adc_PowerStateType* CurrentPowerState, Adc_PowerStateRequestResultType* Result);Service Adc_GetCurrentPowerState.Std_ReturnType Adc_GetTargetPowerState (Adc_PowerStateType* TargetPowerState, Adc_PowerStateRequestResultType* Result);Service Adc_GetTargetPowerState.Std_ReturnType Adc_PreparePowerState (Adc_PowerStateType PowerState, Adc_PowerStateRequestResultType* Result);This API starts the needed process to allow the ADC HW module to enter thevoid Adc_Main_PowerTransitionManager (void);This API is cyclically called and supervises the power state transitions, checking for the readiness of the module and issuing...void IoHwAb_Adc_NotifyReadyForPower (void);The API shall be invoked by the ADC Driver when the requested power state preparation for mode is completed.
Typen — Übersicht
struct Adc_ConfigTypeData structure containing the set of configuration parameters required for initializing the ADC Driver and ADC HW Unit(s).Adc_ChannelTypeNumeric ID of an ADC channel.Adc_GroupTypeNumeric ID of an ADC channel group.Adc_ValueGroupTypeType for reading the converted values of a channel group (raw, without further scaling, alignment according precompile switch...Adc_PrescaleTypeType of clock prescaler factor.Adc_ConversionTimeTypeType of conversion time, i.Adc_SamplingTimeTypeType of sampling time, i.Adc_ResolutionTypeType of channel resolution in number of bits.enum Adc_StatusTypeCurrent status of the conversion of the requested ADC Channel group.Adc_TriggerSourceTypeType for configuring the trigger source for an ADC Channel group.enum Adc_GroupConvModeTypeType for configuring the conversion mode of an ADC Channel group.Adc_GroupPriorityTypePriority level of the channel.Adc_GroupDefTypeType for assignment of channels to a channel group (this is not an API type).Adc_StreamNumSampleTypeType for configuring the number of group conversions in streaming access mode (in single access mode, parameter is 1).enum Adc_StreamBufferModeTypeType for configuring the streaming access mode buffer type.enum Adc_GroupAccessModeTypeType for configuring the access mode to group conversion results.Adc_HwTriggerSignalTypeType for configuring on which edge of the hardware trigger signal the driver should react, i.Adc_HwTriggerTimerTypeType for the reload value of the ADC module embedded timer (only if supported by the ADC hardware).Adc_PriorityImplementationTypeType for configuring the prioritization mechanism.Adc_GroupReplacementTypeReplacement mechanism, which is used on ADC group level, if a group conversion is interrupted by a group which has a higher...Adc_ChannelIn case of active limit checking: defines which conversion values are taken into account related to the boardes defineed with...Adc_ResultAlignmentTypeType for alignment of ADC raw results in ADC result buffer (left/ right alignment).enum Adc_PowerStateTypePower state currently active or set as target power state.enum Adc_PowerStateRequestResultTypeType Adc_PowerStateRequestResultType.
Funktionen & Typen — Detailansicht
دالة Adc_Init [SWS_Adc_00365] 📄 PDF
void Adc_Init (const Adc_ConfigType* ConfigPtr);
Initializes the ADC hardware units and driver.
تُستخدم الدالة المتزامنة Adc_Init (معرّف الخدمة 0x00) للتكوين الأولي والتشغيل لجميع وحدات عتاد ADC وكذلك لبرنامج تشغيل ADC وفقًا لـ [SWS_Adc_00365]. يتم توفير الواجهة عبر ملف الرأس Adc.h وليس لها قيمة إرجاع.
المعلمات ومتغيرات التكوين
يتم تمرير بيانات التكوين عبر معلمة المؤشر ConfigPtr من النوع const Adc_ConfigType* [SWS_Adc_00365]. تعتمد الوسيطة المطلوبة على متغير البناء المُختار:
- عند استخدام تكوين ما بعد البناء (
Variant PB)، يجب أن يشيرConfigPtrإلى بنية البيانات المناسبة التي تحتوي على قيم التهيئة. - إذا تم استخدام متغير ما قبل التجميع (
Variant PC)، فإن الواجهة تطلب صراحةً تمريرNULL_PTR[SWS_Adc_00365].
التزامن وتكامل النظام
تم تحديد الدالة Adc_Init على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Adc_00365]. تفسير: نظرًا لتكوين وحدات العتاد بشكل عام وعدم وجود إمكانية لإعادة الدخول، فمن المفترض أن يتم الاستدعاء عادةً بشكل مركزي أثناء تهيئة النظام، وذلك قبل بدء وظائف الوحدة الأخرى أو عمليات التحويل. سؤال Q-a82e9204ae7a5ab7 (مفتوح)
فيما يتعلق بإدارة الطاقة، هناك ارتباط مباشر بمتطلبات ذات صلة: إذا طُلبت حالة الطاقة العادية (normal Power State) أثناء التشغيل، فيجب على API المقابلة الرجوع إلى معلمات التكوين الموجودة في نفس الحاويات كمعلمات التهيئة الخاصة بـ Adc_Init [SWS_Adc_00483].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_SetupResultBuffer [SWS_Adc_91000] 📄 PDF
Std_ReturnType Adc_SetupResultBuffer (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);
Initializes ADC driver with the group specific result buffer start address where the conversion results will be stored. The applicatio n has to ensure that the application buffer, where Data Buffer Ptr points to, can hold all the conversion results of the specified group. The initialization with Adc_ Setup Result Buffer is required after reset, before a group conversion can be started.
تقوم الدالة Adc_SetupResultBuffer بتهيئة مشغل ADC بعنوان البداية لمخزن مؤقت خاص بالمجموعة لتخزين نتائج التحويل [SWS_Adc_91000]. هذا الاستدعاء إلزامي بعد إعادة التعيين قبل التمكن من بدء تحويل المجموعة [SWS_Adc_91000].
المعلمات وسياق الاستدعاء
Group: المعرّف العددي لمجموعة قنوات ADC المطلوبة [SWS_Adc_91000].DataBufferPtr: مؤشر إلى مخزن البيانات المؤقت (النوعAdc_ValueGroupType*) الذي تُخزَّن فيه النتائج [SWS_Adc_91000].
تم التصريح عن الدالة على أنها قابلة لإعادة الدخول وغير متزامنة، وهي متاحة عبر ملف الترويسة Adc.h (معرّف الخدمة 0x0c) [SWS_Adc_91000].
قيم الإرجاع ومعالجة الأخطاء
نوع الإرجاع هو Std_ReturnType [SWS_Adc_91000]:
E_OK: تمت تهيئة المؤشر إلى مخزن النتائج المؤقت بنجاح [SWS_Adc_91000].E_NOT_OK: فشلت العملية أو حدث خطأ أثناء التطوير [SWS_Adc_91000].
واجبات التطبيق
يجب على التطبيق المستدعي ضمان أن المخزن المؤقت الذي يشير إليه DataBufferPtr يوفّر مساحة ذاكرة كافية لجميع نتائج تحويل مجموعة القنوات المحددة [SWS_Adc_91000].
تم توليد ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفة AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_DeInit [SWS_Adc_00366] 📄 PDF
void Adc_DeInit (void);
Returns all ADC HW Units to a state comparable to their power on reset state.
تُستخدم الدالة Adc_DeInit لإلغاء تهيئة برنامج تشغيل ADC ونقل جميع وحدات عتاد ADC التابعة له إلى حالة مماثلة للحالة التي تلي إعادة التعيين عند التشغيل مباشرةً [SWS_Adc_00366]. وبذلك تستعيد الحالة الأولية للعتاد قبل إجراء تهيئة جديدة.
الاستدعاء والواجهة
تم الإعلان عن الدالة في ملف الرأس Adc.h وتمتلك معرّف الخدمة 0x01 [SWS_Adc_00366]. يتم الاستدعاء بشكل متزامن (Synchronous) ولا يتطلب أي معلمات (لا In ولا InOut ولا Out)؛ كما لا يتم توفير قيمة إرجاع (التوقيع void Adc_DeInit(void)) [SWS_Adc_00366]. ولا يتم تقييم أو إنشاء معلمات إدخال أو قيم إرجاع. ونظرًا للدلالات المتزامنة، فإن التنفيذ يحظر المتصل حتى تكتمل إعادة تعيين جميع الوحدات [SWS_Adc_00366].
التزامن والقيود
فيما يتعلق بالتزامن، تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (Non Reentrant) [SWS_Adc_00366]. وينتج عن ذلك التفسير التالي: الاستدعاءات المتزامنة أو المتداخلة لـ Adc_DeInit من مهام متعددة أو طبقات برمجية مختلفة غير مسموح بها ويجب على المتصل تنسيقها وتجنبها.
بما أن Adc_DeInit تُعيد تعيين جميع وحدات عتاد ADC بالكامل إلى حالة إعادة التعيين [SWS_Adc_00366]، فيُفترض التأكد قبل الاستدعاء من عدم وجود أي عمليات قياس أو تحويل نشطة، وذلك لمنع السلوك غير المحدد للعتاد. سؤال Q-15bfa2b822826786 (مفتوح)
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويُستخدم كدليل توثيقي توجيهي.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_StartGroupConversion [SWS_Adc_00367] 📄 PDF
void Adc_StartGroupConversion (Adc_GroupType Group);
Starts the conversion of all channels of the requested ADC Channel group.
الاستخدام
تبدأ الدالة Adc_StartGroupConversion تحويل جميع قنوات مجموعة قنوات ADC المُمرَّرة وفقًا لـ [SWS_Adc_00367]. يتم تمرير معرّف المجموعة الرقمي Group من النوع Adc_GroupType كمعلمة. ليس للدالة قيمة إرجاع (void) وتعمل بشكل غير متزامن ([SWS_Adc_00367]).
التزامن والقيود
وفقًا للمواصفة، تم تصنيف الخدمة على أنها قابلة لإعادة الدخول ([SWS_Adc_00367]). تفسير: يُرجح أن يعني هذا أنه يمكن استدعاء الدالة بشكل متزامن لمجموعات قنوات مختلفة. سؤال Q-8283232f222f7b0a (مفتوح) ونظرًا لأن البدء يتم بشكل غير متزامن، فإن الاستدعاء يعود قبل اكتمال التحويل الفعلي.
معالجة الأخطاء والتفاعل
الخدمة متاحة عبر ملف الرأس Adc.h وتمتلك معرّف الخدمة 0x02 ([SWS_Adc_00367]). أكواد أخطاء DET أو DEM المحددة غير موثقة في حمولة البيانات الحالية.
تستند ملاحظة الاستخدام هذه إلى مواصفة AUTOSAR R20-11 وتم إنشاؤها تلقائيًا.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_StopGroupConversion [SWS_Adc_00368] 📄 PDF
void Adc_StopGroupConversion (Adc_GroupType Group);
Stops the conversion of the requested ADC Channel group.
تُنهي الدالة المتزامنة Adc_StopGroupConversion التحويل الجاري لمجموعة قنوات ADC المطلوبة [SWS_Adc_00368]. تم الإعلان عن الواجهة في ملف الرأس Adc.h وتحديدها تحت معرّف الخدمة 0x03 [SWS_Adc_00368].
يتم تمرير قيمة الإدخال Group من النوع Adc_GroupType كمعلمة وحيدة، والتي تمثل المعرّف الرقمي لمجموعة قنوات ADC المعنية [SWS_Adc_00368]. لا يمتلك الاستدعاء قيمة إرجاع (void) ولا يستخدم معلمات إدخال/إخراج أو معلمات إخراج خالصة [SWS_Adc_00368].
فيما يتعلق بسلوك التزامن، تم تصنيف الخدمة على أنها قابلة لإعادة الدخول وتتميز بدلالات تنفيذ متزامنة [SWS_Adc_00368]. وبالتالي فإن الاستدعاءات المتوازية للواجهة مسموح بها. يشير السلوك المتزامن ضمناً إلى أن العملية تكتمل فور استدعاء الدالة [SWS_Adc_00368].
تفسير: يُرجح أن يتطلب الاستدعاء وظيفيًا بدء تحويل للمجموعة المعنية مسبقًا لإجراء الإيقاف. سؤال Q-644ca5344ab849b0 (مفتوح) أكواد الأخطاء المحددة، أو قيم الإرجاع للإشارة إلى الخطأ، أو الرسائل المرسلة إلى أجهزة التطوير (DET/DEM) غير محددة في مقتطف المواصفة الحالي لهذه الخدمة [SWS_Adc_00368].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة Adc_ReadGroup [SWS_Adc_00369] 📄 PDF
Std_ReturnType Adc_ReadGroup (Adc_GroupType Group, Adc_ValueGroupType* DataBufferPtr);
Reads the group conversion result of the last completed conversion round of the requested group and stores the channe l values starting at the Data Buffer Ptr address. The group channel values are stored in ascending channel number order ( in contrast to the storage layout of the result buffer if streaming access is configured).
تُستخدم الدالة المتزامنة Adc_ReadGroup لقراءة نتائج تحويل مجموعة قنوات ADC من آخر جولة تحويل مكتملة ([SWS_Adc_00369]). وهي متاحة عبر ملف الرأس Adc.h وتمتلك معرّف الخدمة 0x04 ([SWS_Adc_00369]).
المعلمات وتخطيط المخزن المؤقت
Group: المعرّف الرقمي لمجموعة قنوات ADC المطلوبة ([SWS_Adc_00369]).DataBufferPtr: مؤشر إلى المخزن المؤقت الوجهة (Adc_ValueGroupType*)، والذي يتم تخزين نتائج تحويل جميع قنوات المجموعة بدءًا من عنوانه ([SWS_Adc_00369]).
يتم تخزين قيم القنوات بدءًا من عنوان الوجهة بترتيب القنوات تصاعديًا ([SWS_Adc_00369]). يختلف تخطيط الذاكرة هذا صراحةً عن ترتيب المخزن المؤقت في حالة الوصول المتدفق (streaming access) المكوّن ([SWS_Adc_00369]). تفسير: يُرجح أن يكون المتصل مسؤولاً عن توفير مخزن مؤقت ذي سعة كافية لجميع قنوات المجموعة. سؤال Q-f22a12a6c7ab0eb3 (مفتوح)
قيم الإرجاع ومعالجة الأخطاء
تشير قيمة الإرجاع من النوع Std_ReturnType إلى حالة عملية القراءة ([SWS_Adc_00369]):
E_OK: النتائج متاحة وتمت كتابتها بنجاح في المخزن المؤقت للبيانات ([SWS_Adc_00369]).E_NOT_OK: لا توجد نتائج متاحة أو حدث خطأ تطويري ([SWS_Adc_00369]).
التزامن
تم تحديد الدالة على أنها قابلة لإعادة الدخول ([SWS_Adc_00369]). وبالتالي يمكن تنفيذها بالتوازي طالما يتم استخدام مناطق تخزين مؤقت منفصلة للوصول المتزامن.
تم إنشاء هذا النص تلقائيًا استنادًا إلى مواصفة AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_EnableHardwareTrigger [SWS_Adc_91001] 📄 PDF
void Adc_EnableHardwareTrigger (Adc_GroupType Group);
Enables the hardware trigger for the requested ADC Channel group.
الاستخدام والمعلمات
تنشط الدالة Adc_EnableHardwareTrigger المشغل العتادي لمجموعة قنوات ADC مهيأة [SWS_Adc_91001]. وهي معرفة كخدمة برقم الخدمة 0x05 في الوحدة Adc ومتاحة عبر ملف الترويسة Adc.h [SWS_Adc_91001].
- معاملات الإدخال: يتم عبر المعامل
Groupمن النوعAdc_GroupTypeتمرير المعرّف (ID) العددي لمجموعة قنوات ADC المطلوبة [SWS_Adc_91001]. ولا توجد معاملات إدخال/إخراج أو إخراج إضافية [SWS_Adc_91001]. - القيمة المرجعة: لا تُرجع الواجهة أي قيمة (
void) [SWS_Adc_91001]. - دلالات غير متزامنة: تم تحديد سلوك التنفيذ على أنه غير متزامن [SWS_Adc_91001]. يتيح الاستدعاء عملية الإطلاق، بينما لا يبدأ التحويل الفعلي للقنوات إلا من خلال أحداث عتادية لاحقة.
التزامن
يحدد المشغل Adc_EnableHardwareTrigger على أنها قابلة لإعادة الدخول [SWS_Adc_91001]. تفسير: من المرجح أن تشير إمكانية إعادة الدخول في المقام الأول إلى الاستدعاء المتزامن مع مجموعات قنوات منفصلة، نظراً لتنشيط المشغل العتادي لكل مجموعة قنوات. سؤال Q-5750576df9f0284d (مفتوح)
تستند ملاحظة الاستخدام هذه إلى مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة Adc_DisableHardwareTrigger [SWS_Adc_91002] 📄 PDF
void Adc_DisableHardwareTrigger (Adc_GroupType Group);
Disables the hardware trigger for the requested ADC Channel group.
تُستخدم الدالة Adc_DisableHardwareTrigger لتعطيل التحفيز عبر العتاد لمجموعة قنوات ADC المطلوبة [SWS_Adc_91002].
الاستخدام والدلالات
- المعلمات: يتم تمرير المعلمة
Groupمن النوعAdc_GroupType، والتي تحدد المعرف العددي لمجموعة قنوات ADC المطلوبة [SWS_Adc_91002]. - قيمة الإرجاع: لا تمتلك الدالة أي قيمة إرجاع (
void) [SWS_Adc_91002]. - سلوك التنفيذ: يُصنف الاستدعاء بأنه غير متزامن (Sync/Async: Asynchronous) [SWS_Adc_91002]. وهذا يعني على الأرجح أن الإيقاف الفعلي أو فصل حدث العتاد يمكن أن يصبح ساري المفعول مع إزاحة زمنية من جانب العتاد. سؤال Q-b0e613163b254242 (مفتوح)
التزامن والتكامل
تم التصريح عن الواجهة بأنها قابلة لإعادة الدخول (Reentrancy: Reentrant) ويتم توفيرها عبر ملف الرأس Adc.h؛ ومعرّف الخدمة الخاص بها هو 0x06 [SWS_Adc_91002]. لا يتضمن مقتطف المواصفة الحالي رموز خطأ محددة، أو سياقات استدعاء، أو رسائل DET/DEM.
تم إنشاء هذا النص تلقائيًا. تستند جميع المعلومات حصريًا إلى مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة Adc_EnableGroupNotification [SWS_Adc_91003] 📄 PDF
void Adc_EnableGroupNotification (Adc_GroupType Group);
Enables the notification mechanism for the requested ADC Channel group.
تُستخدم الدالة Adc_EnableGroupNotification لتنشيط آلية الإخطار لمجموعة قنوات ADC مطلوبة [SWS_Adc_91003]. ويُوفَّر تصريح هذه الواجهة للمستخدمين عبر ملف الترويسة Adc.h [SWS_Adc_91003].
يتم تمرير Group من نوع البيانات Adc_GroupType كمعامل إدخال وحيد، والذي يحدد المعرّف (ID) العددي لمجموعة قنوات ADC المطلوبة [SWS_Adc_91003]. ولا تمتلك الدالة معاملات إدخال/إخراج ولا معاملات إخراج، ولا تُرجع أي قيمة (void) [SWS_Adc_91003]. تُدار الخدمة تحت معرّف الخدمة 0x07 وتتسم بدلالات تنفيذ غير متزامنة [SWS_Adc_91003].
فيما يتعلق بسلوك التزامن، تم تحديد Adc_EnableGroupNotification على أنها قابلة لإعادة الدخول (reentrant) [SWS_Adc_91003]. وبالتالي يُسمح بإجراء استدعاءات متوازية متعددة. ومن المرجح أن التصنيف غير المتزامن للتنفيذ يعني أن تفعيل إشعار المجموعة يتم تحديده مسبقًا في المشغّل أو تنفيذه في الخلفية دون حظر سياق الاستدعاء أثناء المعالجة [SWS_Adc_91003]. سؤال Q-bae8fba7810fa269 (مفتوح)
لا يحدد مقتطف المواصفة الحالي أي تفاصيل إضافية بخصوص أخطاء التطوير أو الإنتاج المحددة (DET أو DEM) أو شروط الاستدعاء الدقيقة أو سياقات المهام.
تستند ملاحظة الاستخدام هذه حصريًا إلى متطلبات المواصفة لإصدار AUTOSAR رقم R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة Adc_DisableGroupNotification [SWS_Adc_91004] 📄 PDF
void Adc_DisableGroupNotification (Adc_GroupType Group);
Disables the notification mechanism for the requested ADC Channel group.
تُستخدم الدالة Adc_DisableGroupNotification المصرح عنها في الترويسة Adc.h في مشغل ADC لإيقاف آلية الإشعار لمجموعة قنوات ADC المطلوبة بشكل مستهدف [SWS_Adc_91004]. تمتلك الخدمة معرف الخدمة 0x08 وهي محددة بالتوقيع void Adc_DisableGroupNotification (Adc_GroupType Group) [SWS_Adc_91004].
المعلمات والواجهة
لتنفيذ الدالة، تم تحديد تمرير معامل دخل فردي:
Group: يمرر المعرّف الفريد ID لمجموعة قنوات ADC المرغوبة كمعرّف رقمي من النوعAdc_GroupType، والتي يُراد تعطيل إشعارها [SWS_Adc_91004].
لا تُرجع الدالة أي قيمة إرجاع (void) إلى المتصل [SWS_Adc_91004]. بالإضافة إلى ذلك، وفقًا للمواصفة، لا تُستخدم معاملات دخل/خرج مدمجة (inout) ولا معاملات خرج خالصة (out) [SWS_Adc_91004].
سلوك التنفيذ والتزامن
فيما يتعلق بسلوك التزامن، تم تصنيف Adc_DisableGroupNotification على أنها قابلة لإعادة الدخول (reentrant) [SWS_Adc_91004]. يتيح ذلك من حيث المبدأ الاستدعاء المتوازي أو المقاطع للخدمة من قِبل سياقات برمجية مختلفة [SWS_Adc_91004].
فيما يخص التزامن الزمني، تم تصنيف الدالة على أنها غير متزامنة [SWS_Adc_91004]. التفسير: نظرًا لأن السلوك الزمني مصرح عنه صراحةً بأنه غير متزامن، فمن المرجح أن يتم إيقاف آلية الإشعار داخليًا في المشغل أو في عتاد ADC في الخلفية، دون حظر سياق الاستدعاء حتى الاكتمال التام. سؤال Q-a1a30a254aa96655 (مفتوح)
تم إنشاء ملاحظة الاستخدام هذه آليًا وتعمل كدليل توجيهي تكميلي للمواصفة.
الغرض والاستخدام
تُستخدم دالة Adc_DisableGroupNotification لتعطيل آلية الإخطار (Notification Mechanism) الخاصة بمجموعة قنوات محددة ضمن مشغل محول الإشارات التناظرية إلى رقمية (ADC) [SWS_Adc_91004]. تستقبل الدالة معلماً واحداً فقط من معلمات الإدخال هو Group من النوع Adc_GroupType، والذي يمثل المعرف العددي لمجموعة قنوات ADC المطلوب إلغاء إخطاراتها [SWS_Adc_91004]. لا تتضمن هذه الدالة أي معلمات إخراج ولا معلمات إدخال/إخراج، كما أنها لا تقوم بإرجاع أي قيمة حالة أو نتيجة حيث أن نوع الإرجاع هو void [SWS_Adc_91004].
خصائص التنفيذ والتزامن
تم تصنيف الخدمة كدالة غير متزامنة (Asynchronous)، كما أنها قابلة لإعادة الدخول (Reentrant) بالكامل [SWS_Adc_91004]. تتيح خاصية إعادة الدخول استدعاء الوظيفة بأمان وبشكل متزامن من سياقات أو مسارات تنفيذ مختلفة طالما أنها تخص مجموعات قنوات منفصلة [SWS_Adc_91004]. تفسير: يُرجَّح أن وصف الدالة بأنها غير متزامنة يعني أن عملية تعطيل آلية الإخطار قد تُعالج في الخلفية على مستوى العتاد أو مشغل ADC دون اشتراط اكتمال التغيير الفعلي لحظة انتهاء استدعاء الدالة مباشرة. سؤال (مفتوح)
التكامل والواجهة
يتم توفير الدالة والإعلان عنها للاستخدام البرمجي عبر ملف الترويسة القياسي Adc.h، وتحمل معرّف الخدمة المعياري ذي القيمة الست عشرية 0x08 [SWS_Adc_91004].
تم إنشاء هذه الإرشادات الفنية آلياً بواسطة الذكاء الاصطناعي استناداً إلى مواصفة AUTOSAR المعنية.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة Adc_GetGroupStatus [SWS_Adc_00374] 📄 PDF
Adc_StatusType Adc_GetGroupStatus (Adc_GroupType Group);
Returns the conversion status of the requested ADC Channel group.
دالة Adc_GetStreamLastPointer [SWS_Adc_00375] 📄 PDF
Adc_StreamNumSampleType Adc_GetStreamLastPointer (Adc_GroupType Group, Adc_ValueGroupType* * PtrToSamplePtr);
Returns the number of valid samples per channel, stored in the result buffer. Reads a pointer, pointing to a position in the group result buffer. With the pointer position, the results of all group channels of the last completed conversion round can be acc essed. With the pointer and the return value, all valid group conversion results can be accessed (the user has to take the layout of the result buffer into account).
دالة Adc_GetVersionInfo [SWS_Adc_00376] 📄 PDF
void Adc_GetVersionInfo (Std_VersionInfoType* versioninfo);
Returns the version information of this module.
دالة Adc_SetPowerState [SWS_Adc_00475] 📄 PDF
Std_ReturnType Adc_SetPowerState (Adc_PowerStateRequestResultType* Result);
This API configures the Adc module so that it enters the already prepared power state, chosen between a predefined set of configured ones.
تنقل دالة الخدمة المتزامنة Adc_SetPowerState وحدة ADC إلى حالة طاقة تم إعدادها مسبقًا وتم اختيارها من مجموعة تم تكوينها مسبقًا [SWS_Adc_00475].
الاستخدام
الدالة متاحة عبر ملف الرأس Adc.h وتمتلك معرّف الخدمة 0x10 [SWS_Adc_00475]. ولا تقبل أي معلمات إدخال، بل تسلّم النتيجة عبر معلمة الإخراج Result من النوع Adc_PowerStateRequestResultType* [SWS_Adc_00475]. عند تنشيط حالة الطاقة بنجاح، تُرجع الدالة E_OK وتشير عبر Result إلى الحالة ADC_SERVICE_ACCEPTED [SWS_Adc_00475].
معالجة الأخطاء
إذا رُفض الطلب، فإن الاستدعاء يُرجع قيمة الإرجاع E_NOT_OK [SWS_Adc_00475]. وتميز الوحدة في المعلمة Result بين ثلاثة أسباب محددة للخطأ:
ADC_NOT_INIT: وحدة ADC لم تكن مهيأة بعد في وقت الاستدعاء [SWS_Adc_00475].ADC_SEQUENCE_ERROR: يوجد ترتيب خاطئ لاستدعاءات API [SWS_Adc_00475].ADC_HW_FAILURE: خطأ في العتاد حدث يمنع الوصول إلى الحالة المطلوبة [SWS_Adc_00475].
التزامن والقيود
Adc_SetPowerState غير قابلة لإعادة الدخول (Non Reentrant) وتحظر المتصل حتى قبول الحالة بشكل متزامن [SWS_Adc_00475]. والتفسير هو أنه يجب تنفيذ خطوة إعداد للحالة المستهدفة بشكل إلزامي قبل الاستدعاء، حيث تطلب الدالة صراحةً حالة تم إعدادها بالفعل وترفض أخطاء الترتيب بـ ADC_SEQUENCE_ERROR [SWS_Adc_00475].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي استنادًا إلى مواصفات AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_GetCurrentPowerState [SWS_Adc_00476] 📄 PDF
Std_ReturnType Adc_GetCurrentPowerState (Adc_PowerStateType* CurrentPowerState, Adc_PowerStateRequestResultType* Result);
Service Adc_GetCurrentPowerState.
دالة Adc_GetTargetPowerState [SWS_Adc_00477] 📄 PDF
Std_ReturnType Adc_GetTargetPowerState (Adc_PowerStateType* TargetPowerState, Adc_PowerStateRequestResultType* Result);
Service Adc_GetTargetPowerState.
دالة Adc_PreparePowerState [SWS_Adc_00478] 📄 PDF
Std_ReturnType Adc_PreparePowerState (Adc_PowerStateType PowerState, Adc_PowerStateRequestResultType* Result);
This API starts the needed process to allow the ADC HW module to enter the AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver requested power state.
الاستخدام وسياق الاستدعاء
تبدأ الدالة المتزامنة Adc_PreparePowerState عملية الإعداد المطلوبة لنقل وحدة عتاد ADC إلى حالة الطاقة المطلوبة [SWS_Adc_00478]. ويتم تمرير الحالة المستهدفة المرغوبة PowerState بالإضافة إلى مؤشر Result كمعلمات، والذي يتم عبره الإبلاغ عن حالة الطلب [SWS_Adc_00478]. وتشير قيمة الإرجاع بـ E_OK إلى أن عملية الإعداد قد بدأت، أو بـ E_NOT_OK إلى أن الخدمة قد تم رفضها [SWS_Adc_00478].
معالجة النتائج والأخطاء
في حالة النجاح (E_OK)، تُرجع معاملة الإخراج Result قيمة الحالة ADC_SERVICE_ACCEPTED [SWS_Adc_00478]. وإذا رُفضت الخدمة مع E_NOT_OK، فإن Result يحدد السبب الدقيق [SWS_Adc_00478]:
ADC_NOT_INIT: لم تتم تهيئة وحدة ADC بعد [SWS_Adc_00478].ADC_SEQUENCE_ERROR: تسلسل استدعاء غير مسموح به، نظراً لأن الحالة الحالية تطابق بالفعل الحالة الهدف [SWS_Adc_00478].ADC_POWER_STATE_NOT_SUPP: حالة الطاقة المطلوبة غير مدعومة من قِبل الوحدة [SWS_Adc_00478].ADC_TRANS_NOT_POSSIBLE: الانتقال المباشر غير ممكن أو أن الطرفية العتادية لا تزال مشغولة [SWS_Adc_00478].
التزامن والتفاعل
تم تحديد الدالة على أنها غير قابلة لإعادة الدخول (non-reentrant) [SWS_Adc_00478]. لذلك، يجب على جهة الاستدعاء التأكد من إجراء الاستدعاءات بالتسلسل ودون تداخل. ومن المرجح أن يتعين على جهات الاستدعاء إنهاء عمليات التحويل الجارية مسبقاً أو إيقافها، لأن وجود طرفية عتادية نشطة يؤدي إلى الرفض. سؤال Q-210c59a46a90d781 (مفتوح) بعد نجاح التحضير بواسطة Adc_PreparePowerState، تُنفَّذ الإجراءات اللاحقة غير الفعالة على الفور لوضع اللمسات الأخيرة على انتقال الحالة عبر واجهة API لاحقة مرافقة [SWS_Adc_00499].
تم إنشاء إشعار الاستخدام هذا تلقائياً ويستند حصرياً إلى بيانات المواصفة من SWS_Adc_00478 وSWS_Adc_00499.
دليل المنفِّذ قيد الإعداد (التعقيد I2)
دالة Adc_Main_PowerTransitionManager [SWS_Adc_00479] 📄 PDF
void Adc_Main_PowerTransitionManager (void);
This API is cyclically called and supervises the power state transitions, checking for the readiness of the module and issuing the callbacks Io Hw Ab_ Adc_ Notify Ready For Power State
الاستخدام وسياق الاستدعاء
تُستخدم الدالة الرئيسية Adc_Main_PowerTransitionManager للمراقبة والتنفيذ الدوري لانتقالات حالة الطاقة في وحدة ADC [SWS_Adc_00479]. تمتلك التوقيع void Adc_Main_PowerTransitionManager(void)، ولا تستقبل أي معلمات إدخال ولا تُرجع أي قيمة [SWS_Adc_00479]. يتم استدعاء الدالة دوريًا ويتم التصريح عنها عبر ملف الرأس SchM_Adc.h [SWS_Adc_00479]. وبالتالي، يُرجّح أن يتم الاستدعاء عادةً في سياق المهمة الدورية لجدولة BSW (SchM). سؤال Q-4fc01e5bed5b3b57 (مفتوح)
مراقبة الحالة والعمليات غير المتزامنة
أثناء التنفيذ الدوري، تتحقق الدالة باستمرار من الجاهزية التشغيلية للوحدة لحالة الطاقة المطلوبة [SWS_Adc_00479]. بمجرد التحقق من جاهزية الوحدة، تُرسل عمليات رد الاتصال الخاصة بالإشعار IoHwAb_Adc_NotifyReadyForPowerState<Mode>، والمشار إليها عبر معلمة التكوين AdcPowerStateReadyCbkRef [SWS_Adc_00479]. يمكن معالجة جميع العمليات غير المتزامنة المطلوبة للوصول إلى حالة الطاقة المستهدفة في الخلفية في سياق تنفيذ Adc_Main_PowerTransitionManager [SWS_Adc_00498].
معالجة الأخطاء والشروط الحدية
إذا تعذر الوصول إلى حالة الطاقة المطلوبة مباشرة من حالة الطاقة الحالية، تبلغ API عن خطأ وقت التشغيل ADC_E_TRANSITION_NOT_POSSIBLE [SWS_Adc_00498]. من خلال إسناد عمليات الانتقال الطويلة إلى دالة المدير الدورية هذه، لا يتم حظر المتصلين من المستويات الأعلى أثناء قيام وحدة ADC بإكمال تغيير الحالة في الخلفية [SWS_Adc_00498].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
دالة IoHwAb_Adc_NotifyReadyForPower [SWS_Adc_00480] 📄 PDF
void IoHwAb_Adc_NotifyReadyForPowerState<#Mode> (void);
The API shall be invoked by the ADC Driver when the requested power state preparation for mode <#Mode> is completed.
تُستخدم الدالة IoHwAb_Adc_NotifyReadyForPower كواجهة إخطار لتجريد عتاد الإدخال/الإخراج ويتم استدعاؤها من قِبل مشغل ADC بمجرد اكتمال التحضير لحالة طاقة مطلوبة في الوضع <#Mode> [SWS_Adc_00480]. يُوفَّر تصريح هذه الواجهة عبر ملف الترويسة IoHwAb_Adc.h [SWS_Adc_00480].
سياق الاستدعاء والدلالات البرمجية
تنطبق الشروط الإطارية التالية على الاستدعاء وفقاً للمواصفة [SWS_Adc_00480]:
- المعاملات والقيمة المرجعة: لا تحتوي الدالة على معاملات إدخال أو إخراج أو إدخال/إخراج، ولا تُرجع أي قيمة (
void) [SWS_Adc_00480]. - التزامنية: تم تحديد سلوك التنفيذ على أنه متزامن [SWS_Adc_00480].
- إعادة الدخول: تم تصنيف الدالة على أنها غير قابلة لإعادة الدخول (
Non Reentrant) [SWS_Adc_00480]. لذلك، يجب على جهات الاستدعاء التأكد من إجراء الاستدعاءات بشكل تسلسلي وعدم تراكبها بالتزامن.
التفاعل ومعالجة الأخطاء
لا توجد رموز أخطاء أو إخطارات لـ DET أو DEM مخزنة في بيانات المواصفة [SWS_Adc_00480]. ومن المرجح أن يشير بيان بناء الجملة IoHwAb_Adc_NotifyReadyForPowerState<#Mode> إلى أن المعرّف يُنشأ بشكل محدد وفقاً لوضع الطاقة المهيأ. سؤال Q-9e9c969f8a41d0de (مفتوح) وتعمل الدالة على الأرجح كمعاودة اتصال (callback) للمشغل لإبلاغ إدارة الطاقة ذات المستوى الأعلى بحالة الجاهزية للتغيير.
تم إنشاء هذا النص بواسطة ذكاء اصطناعي استناداً إلى المواصفة SWS_Adc_00480.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_ConfigType [SWS_Adc_00505] 📄 PDF
Data structure containing the set of configuration parameters required for initializing the ADC Driver and ADC HW Unit(s).
نوع Adc_ChannelType [SWS_Adc_00506] 📄 PDF
Numeric ID of an ADC channel.
نوع Adc_GroupType [SWS_Adc_00507] 📄 PDF
Numeric ID of an ADC channel group.
نوع Adc_ValueGroupType [SWS_Adc_00508] 📄 PDF
Type for reading the converted values of a channel group (raw, without further scaling, alignment according precompile switch ADC_ RESULT_ ALIGNMENT).
نوع Adc_PrescaleType [SWS_Adc_00509] 📄 PDF
Type of clock prescaler factor. (This is not an API type).
نوع Adc_ConversionTimeType [SWS_Adc_00510] 📄 PDF
Type of conversion time, i.e. the time during which the sampled analogue value is converted into digital representation. (This is not an API type).
نوع Adc_SamplingTimeType [SWS_Adc_00511] 📄 PDF
Type of sampling time, i.e. the time during which the value is sampled, (in clock - cycles). (This is not an API type).
نوع Adc_ResolutionType [SWS_Adc_00512] 📄 PDF
Type of channel resolution in number of bits. (This is not an API type).
نوع Adc_StatusType [SWS_Adc_00513] 📄 PDF
Current status of the conversion of the requested ADC Channel group.
يمثل نوع التعداد Adc_StatusType وفقاً لـ [SWS_Adc_00513] حالة التحويل الحالية لمجموعة قنوات ADC المطلوبة، ويُوفَّر عبر الترويسة Adc.h.
تعكس قيم التعداد تقدم التحويل التناظري الرقمي بالإضافة إلى توافر النتائج [SWS_Adc_00513]:
ADC_IDLE(0x00): لم يبدأ تحويل المجموعة المحددة بعد؛ ولا تتوفر أي نتائج قياس [SWS_Adc_00513].ADC_BUSY(0x01): بدأ تحويل المجموعة وهو قيد التشغيل حالياً؛ ولا تتوفر أي نتيجة حتى الآن [SWS_Adc_00513].ADC_COMPLETED(0x02): اكتملت جولة تحويل واحدة (ليست النهائية) للمجموعة؛ وتتوفر نتيجة لجميع قنوات المجموعة [SWS_Adc_00513].ADC_STREAM_COMPLETED(0x03): مخزن النتائج المؤقت ممتلئ تماماً؛ وتتوفر لكل قناة من المجموعة المختارة الكمية المطلوبة من قيم العينات [SWS_Adc_00513].
في التطبيقات، يُستخدم النوع عادةً للاستعلام عن تقدم المجموعة أو تقييمه، لتحديد ما إذا كان يمكن قراءة النتائج بالفعل أو إذا كانت هناك عينات إضافية معلقة.
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR CP R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_TriggerSourceType [SWS_Adc_00514] 📄 PDF
Type for configuring the trigger source for an ADC Channel group.
نوع Adc_GroupConvModeType [SWS_Adc_00515] 📄 PDF
Type for configuring the conversion mode of an ADC Channel group. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver
يُستخدم نوع التعداد Adc_GroupConvModeType لتهيئة وضع التحويل لمجموعة قنوات ADC ويُصرَّح عنه عبر ملف الترويسة Adc.h [SWS_Adc_00515]. يحدد النوع ما إذا كانت قنوات المجموعة تُحوَّل لمرة واحدة أو بشكل متكرر بعد حدث الإطلاق المهيأ [SWS_Adc_00515].
يتوفر وضعان للتهيئة [SWS_Adc_00515]:
-
ADC_CONV_MODE_ONESHOT(0x00): ينفذ تحويلاً واحداً بالضبط لكل قناة من مجموعة قنوات ADC بعد حدث المشغل (Trigger) المهيأ [SWS_Adc_00515]. وإذا تم تكوين مشغل برمجيات كمصدر تشغيل، فيمكن إيقاف التحويل الذي بدأ عبر استدعاء واجهة برمجة تطبيقات برمجية (Software-API) [SWS_Adc_00515]. أما إذا تم تعيين مصدر مشغل عتادي، فيمكن إيقاف تحويل الطلقة الواحدة (One-Shot) الذي بدأ عن طريق إلغاء تنشيط حدث المشغل، بشرط أن يكون ذلك مدعوماً من العتاد [SWS_Adc_00515]. -
ADC_CONV_MODE_CONTINUOUS(0x01): ينفذ تحويلات متكررة باستمرار لكل قناة داخل مجموعة القنوات [SWS_Adc_00515]. هذا الوضع المستمر متاح حصرياً للمجموعات ذات مصدر مشغل برمجيات [SWS_Adc_00515]. ويمكن إنهاء عملية التحويل المستمر التي بدأت بالفعل في أي وقت عبر استدعاء واجهة برمجة تطبيقات برمجية (Software-API) [SWS_Adc_00515].
فيما يتعلق بالقيود، يجب مراعاة أن ADC_CONV_MODE_CONTINUOUS مسموح به فقط مع التشغيل البرمجي (Software-Triggerung) ولا يمكن دمجه مع مصادر تشغيل عتادية (Hardware-Triggerquellen) [SWS_Adc_00515]. يتطلب إيقاف التحويلات الجارية عند المشغلات البرمجية استدعاء API برمجيًا مخصصًا، بينما تتطلب عمليات One-Shot التي يتم تشغيلها عتاديًا إيقاف حدث التشغيل (Trigger-Event) [SWS_Adc_00515].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند حصرياً إلى بيانات المواصفة من AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_GroupPriorityType [SWS_Adc_00516] 📄 PDF
Priority level of the channel. Lowest priority is 0.
نوع Adc_GroupDefType [SWS_Adc_00517] 📄 PDF
Type for assignment of channels to a channel group (this is not an API type).
نوع Adc_StreamNumSampleType [SWS_Adc_00518] 📄 PDF
Type for configuring the number of group conversions in streaming access mode (in single access mode, parameter is 1). Available Adc.h AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_ADCDriver via
نوع Adc_StreamBufferModeType [SWS_Adc_00519] 📄 PDF
Type for configuring the streaming access mode buffer type.
يُستخدم نوع التعداد Adc_StreamBufferModeType لتهيئة سلوك المخزن المؤقت في وضع الوصول بالتدفق لمشغل ADC، وهو متاح عبر ملف الترويسة Adc.h [SWS_Adc_00519].
يحدد النوع وضعي تشغيل محددين لإدارة المخزن المؤقت في تحويلات التدفق [SWS_Adc_00519]:
ADC_STREAM_BUFFER_LINEAR(القيمة0x00): يُنهي مشغل ADC التحويل تلقائياً بمجرد امتلاء المخزن المؤقت للتدفق أو الوصول إلى العدد المحدد من قيم العينات [SWS_Adc_00519].ADC_STREAM_BUFFER_CIRCULAR(القيمة0x01): يواصل مشغل ADC التحويل حتى بعد الوصول إلى سعة المخزن المؤقت الكاملة، وذلك بالرجوع إلى بداية المخزن المؤقت والكتابة فوقه بشكل دائري [SWS_Adc_00519].
يجب على طبقات التكامل وبرمجيات التطبيق تنسيق سلوك المخزن المؤقت مع استراتيجية المعالجة المعنية: فبينما يُخصص ADC_STREAM_BUFFER_LINEAR لسلاسل القياس المغلقة ذات حجم العينات الثابت، يُرجح أن يتطلب ADC_STREAM_BUFFER_CIRCULAR مراقبة مستمرة للمخزن المؤقت أو استرجاعاً سريعاً للبيانات لتجنب فقدان البيانات غير الملحوظ بسبب الكتابة التلقائية فوقها [SWS_Adc_00519]. سؤال Q-23b411e5e6c50591 (مفتوح)
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_GroupAccessModeType [SWS_Adc_00528] 📄 PDF
Type for configuring the access mode to group conversion results.
يُستخدم نوع التعداد Adc_GroupAccessModeType لتهيئة وضع الوصول إلى نتائج تحويل مجموعة قنوات ADC وفقاً لـ [SWS_Adc_00528]. يُوفَّر تعريف النوع عبر ملف الترويسة Adc.h ويحدد كيفية تخزين النتائج في الذاكرة.
تم تحديد قيمتين في المواصفة لتهيئة وضع الوصول للمجموعة [SWS_Adc_00528]:
ADC_ACCESS_MODE_SINGLE(القيمة0x00): يهيئ وضع الوصول لقيمة مفردة (Single value access mode) للمجموعة المعنية.ADC_ACCESS_MODE_STREAMING(القيمة0x01): يهيئ وضع الوصول بالتدفق (Streaming access mode) للمجموعة المعنية.
يُستخدم النوع عند تهيئة مشغل ADC للتحكم في سلوك الوصول إلى مخازن نتائج التحويل المؤقتة [SWS_Adc_00528]. تفسير: بينما يُصمم وضع القيمة المفردة على الأرجح لتوفير قيمة نتيجة حالية واحدة لكل قناة من قنوات المجموعة، يُرجح أن يكون وضع التدفق مصمماً لسلاسل قياس أكثر استمرارية مع قيم مخزن مؤقت متعددة. سؤال Q-8a933cffcd1132ef (مفتوح)
نظراً لأنه نوع تكوين بحت، فإن المتطلب لا يحدد رموز خطأ أو قيماً مرجعة أو رسائل DET/DEM خاصة به لهذا النوع [SWS_Adc_00528].
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على مواصفة AUTOSAR Classic R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_HwTriggerSignalType [SWS_Adc_00520] 📄 PDF
Type for configuring on which edge of the hardware trigger signal the driver should react, i.e. start the conversion (only if supported by the ADC hardware).
نوع Adc_HwTriggerTimerType [SWS_Adc_00521] 📄 PDF
Type for the reload value of the ADC module embedded timer (only if supported by the ADC hardware).
نوع Adc_PriorityImplementationType [SWS_Adc_00522] 📄 PDF
Type for configuring the prioritization mechanism.
نوع Adc_GroupReplacementType [SWS_Adc_00523] 📄 PDF
Replacement mechanism, which is used on ADC group level, if a group conversion is interrupted by a group which has a higher priority.
نوع Adc_Channel [SWS_Adc_00524] 📄 PDF
In case of active limit checking: defines which conversion values are taken into account related to the boardes defineed with Adc Channel Low Limit and Adc Channel High Limit.
نوع Adc_ResultAlignmentType [SWS_Adc_00525] 📄 PDF
Type for alignment of ADC raw results in ADC result buffer (left/ right alignment).
الاستخدام ومجال القيم
يتم توفير نوع التعداد Adc_ResultAlignmentType عبر ملف الرأس Adc.h ويُستخدم في الوحدة Adc لتحديد محاذاة القيم الخام لـ ADC في المخزن المؤقت للنتائج [SWS_Adc_00525]. وهو يشكل الواجهة المعيارية لتكوين تخزين المخزن المؤقت لبرنامج التشغيل [SWS_Adc_00525]. وباعتباره نوع بيانات خالصًا، فإنه لا يمتلك معلمات دالة خاصة به، أو قيم إرجاع، أو دلالات غير متزامنة [SWS_Adc_00525].
وفقًا للمواصفة، يشتمل نطاق قيم التعداد على قيمتين بالضبط [SWS_Adc_00525]:
-
ADC_ALIGN_LEFT(القيمة العددية0x00): يكوّن محاذاة لليسار لنتائج التحويل في المخزن المؤقت [SWS_Adc_00525]. -
ADC_ALIGN_RIGHT(القيمة العددية0x01): يكوّن محاذاة لليمين لنتائج التحويل في المخزن المؤقت [SWS_Adc_00525].
الأهمية والشروط الحدية
من خلال القيمة المختارة، يتم تحديد مواضع البتات في منطقة المخزن المؤقت التي يتم فيها تخزين البيانات الخام بعد التحويل [SWS_Adc_00525]. ويحدد ذلك ما إذا كانت بتات البيانات المعنوية تقع بمحاذاة اليسار أو اليمين في الذاكرة [SWS_Adc_00525]. تفسير: يُرجّح أن يكون تحديد المحاذاة لليسار أو لليمين وثيق الصلة بوجه خاص عندما تكون دقة عتاد محول الإشارات التناظرية إلى رقمية أقل من عرض العنصر لذاكرة المخزن المؤقت المخصصة. سؤال Q-54221124172a3d87 (مفتوح) يجب على مكونات البرمجيات اللاحقة مراعاة المحاذاة المكونة حتى تتمكن من قراءة القيم الخام دون أخطاء في الحساب أو إزاحة البتات.
لا توجد رموز خطأ محددة، أو رسائل DET أو DEM لهذا التعداد [SWS_Adc_00525].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا وتستند إلى مواصفة AUTOSAR R20-11.
نوع Adc_PowerStateType [SWS_Adc_00526] 📄 PDF
Power state currently active or set as target power state.
يحدد نوع التعداد Adc_PowerStateType في AUTOSAR Classic حالة الطاقة لبرنامج تشغيل ADC [SWS_Adc_00526]. يُستخدم في برنامج التشغيل إما لتمثيل حالة التشغيل المتخذة حاليًا للوحدة أو لتحديد حالة هدف جديدة يجب الانتقال إليها لإدارة الطاقة [SWS_Adc_00526]. يتم توفير التصريح عن نوع البيانات هذا عبر ملف الرأس Adc.h [SWS_Adc_00526].
بالنسبة للحالات الفردية للتعداد، تحدد المواصفة ترتيبًا هرميًا فيما يتعلق باستهلاك الطاقة [SWS_Adc_00526]:
ADC_FULL_POWER(القيمة العددية 0): يشير إلى وضع التشغيل والوظيفة الكامل لبرنامج تشغيل ADC دون قيود على التيار [SWS_Adc_00526].- نطاق القيم من 1 إلى 255: يمثل أوضاع توفير طاقة اختيارية مع انخفاض تدريجي في استهلاك الطاقة [SWS_Adc_00526].
فيما يتعلق بالتفاعل والتكامل في بيئة النظام، يسري التفسير التالي: يُرجّح أن يُستخدم النوع بشكل أساسي كمعلمة تمرير في دوال التحكم لانتقالات حالات الطاقة، وكذلك للإبلاغ عن الحالة إلى الوحدات ذات المستوى الأعلى مثل BSW أو إدارة حالة ECU. سؤال Q-e4f964bd79ad550c (مفتوح) ولأنه تعريف أولي لنوع بيانات، فإن الخصائص المحددة مثل سياقات الاستدعاء، ومتطلبات قابلية إعادة الدخول (Reentrancy)، والدلالات المتزامنة أو غير المتزامنة، بالإضافة إلى أخطاء وقت التشغيل ورسائل DET، لا يتم تعريفها إلا في واجهات برمجة التطبيقات (APIs) الخاصة ببرنامج التشغيل المرتبط وليست جزءًا من وصف هذا النوع [SWS_Adc_00526].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي. وهو يستند حصريًا إلى مواصفات إصدار AUTOSAR R20-11.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
نوع Adc_PowerStateRequestResultType [SWS_Adc_00527] 📄 PDF
Type Adc_PowerStateRequestResultType.
يحدد نوع التعداد Adc_PowerStateRequestResultType القيم المرجعة لطلبات انتقالات الحالة في إدارة الطاقة لمشغل ADC، ويُوفَّر عبر ملف الترويسة Adc.h [SWS_Adc_00527].
تمثل قيم النوع النجاح أو أسباب أخطاء محددة لتغيير حالة الطاقة المطلوب [SWS_Adc_00527]:
ADC_SERVICE_ACCEPTED(0): تم تنفيذ الانتقال إلى الحالة المطلوبة بنجاح [SWS_Adc_00527].ADC_NOT_INIT(1): فشل الاستدعاء لأن وحدة ADC لم تتم تهيئتها بعد [SWS_Adc_00527].ADC_SEQUENCE_ERROR(2): يوجد تسلسل غير صحيح عند استدعاء واجهات برمجة التطبيقات (APIs) [SWS_Adc_00527].ADC_HW_FAILURE(3): يمنع خطأ في العتاد الانتقال إلى الحالة المطلوبة [SWS_Adc_00527].ADC_POWER_STATE_NOT_SUPP(4): حالة الطاقة المطلوبة غير مدعومة من قِبل وحدة ADC [SWS_Adc_00527].ADC_TRANS_NOT_POSSIBLE(5): الانتقال المباشر من الحالة الحالية إلى الحالة المطلوبة غير ممكن أو أن الطرفية العتادية لا تزال مشغولة [SWS_Adc_00527].
يجب على جهات الاستدعاء تقييم القيمة المرجعة للتمييز بين التنفيذ العادي والظروف الخاطئة مثل التسلسل غير الصحيح، أو عدم تهيئة الوحدة، أو تعارضات العتاد [SWS_Adc_00527].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفات.
دليل المنفِّذ قيد الإعداد (التعقيد I1)
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_Adc- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_Adc@rel:R20-11#fc71b664- Content hash
fc71b664- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_ADCDriver.pdf#nameddest=SWS_Adc_00365
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني