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 (सर्विस ID 0x00) [SWS_Adc_00365] के अनुसार सभी ADC हार्डवेयर इकाइयों और ADC ड्राइवर के प्रारंभिक कॉन्फ़िगरेशन और चालू करने (commissioning) का काम करता है। यह इंटरफ़ेस हेडर फ़ाइल Adc.h के माध्यम से प्रदान किया जाता है और इसका कोई रिटर्न मान नहीं होता है।
पैरामीटर और कॉन्फ़िगरेशन वेरिएंट
कॉन्फ़िगरेशन डेटा को const Adc_ConfigType* प्रकार के पॉइंटर पैरामीटर ConfigPtr के माध्यम से पास किया जाता है [SWS_Adc_00365]। अपेक्षित तर्क (argument) चुने गए बिल्ड वेरिएंट पर निर्भर करता है:
- पोस्ट-बिल्ड कॉन्फ़िगरेशन (
Variant PB) का उपयोग करते समय,ConfigPtrको इनिशियलाइज़ेशन मानों वाले संगत डेटा संरचना को संदर्भित करना चाहिए। - यदि प्री-कंपाइल वेरिएंट (
Variant PC) का उपयोग किया जाता है, तो इंटरफ़ेस स्पष्ट रूप सेNULL_PTRको पास करने की मांग करता है [SWS_Adc_00365]।
कन्करेंसी और सिस्टम एकीकरण
फ़ंक्शन Adc_Init को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_Adc_00365]। व्याख्या: चूँकि हार्डवेयर इकाइयों को विश्व स्तर पर कॉन्फ़िगर किया जाता है और कोई रीएंट्रेंसी नहीं होती है, इसलिए अन्य मॉड्यूल फ़ंक्शन या रूपांतरण शुरू होने से पहले, सिस्टम इनिशियलाइज़ेशन के दौरान यह कॉल आम तौर पर केंद्रीय रूप से होना चाहिए। प्रश्न Q-a82e9204ae7a5ab7 (खुला)
ऊर्जा प्रबंधन (energy management) के संबंध में संबंधित आवश्यकताओं से सीधा जुड़ाव है: यदि संचालन के दौरान सामान्य ऊर्जा स्थिति (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]।
फ़ंक्शन को पुन:प्रवेशी (reentrant) और एसिंक्रोनस घोषित किया गया है तथा यह हेडर फ़ाइल Adc.h (सर्विस ID 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 में घोषित है और इसकी सर्विस ID 0x01 है [SWS_Adc_00366]। कॉल सिंक्रोनस रूप से (Synchronous) होता है और इसके लिए किसी पैरामीटर (न In, न InOut, न ही Out) की आवश्यकता नहीं होती है; कोई रिटर्न मान भी प्रदान नहीं किया जाता है (हस्ताक्षर void Adc_DeInit(void)) [SWS_Adc_00366]। इस दौरान न तो इनपुट पैरामीटरों का मूल्यांकन किया जाता है और न ही रिटर्न मान उत्पन्न होते हैं। सिंक्रोनस सेमांटिक्स के कारण, निष्पादन कॉलर को तब तक ब्लॉक रखता है जब तक कि सभी इकाइयों का रीसेट पूरा न हो जाए [SWS_Adc_00366]।
समवर्तीता और प्रतिबंध
समानांतरता (concurrency) के संबंध में, फ़ंक्शन को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_Adc_00366]। इससे यह व्याख्या निकलती है: एकाधिक कार्यों (tasks) या विभिन्न सॉफ़्टवेयर परतों से Adc_DeInit के समवर्ती या ओवरलैपिंग कॉल की अनुमति नहीं है और कॉलर द्वारा इन्हें समन्वित और टाला जाना चाहिए।
चूँकि Adc_DeInit सभी ADC हार्डवेयर इकाइयों को पूरी तरह से रीसेट स्थिति में लौटा देता है [SWS_Adc_00366], इसलिए हार्डवेयर के अपरिभाषित व्यवहार को रोकने के लिए कॉल से पहले यह सुनिश्चित किया जाना चाहिए कि कोई माप या रूपांतरण प्रक्रियाएं अब सक्रिय नहीं हैं। प्रश्न Q-15bfa2b822826786 (खुला)
यह पाठ एक AI द्वारा जनरेट किया गया था और यह एक दिशानिर्देशक दस्तावेज़ीकरण सहायता के रूप में कार्य करता है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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 [SWS_Adc_00367] के अनुसार पास किए गए ADC चैनल समूह के सभी चैनलों का रूपांतरण शुरू करता है। पैरामीटर के रूप में Adc_GroupType प्रकार का संख्यात्मक समूह ID Group पास किया जाता है। फ़ंक्शन का कोई रिटर्न मान नहीं है (void) और यह एसिंक्रोनस रूप से कार्य करता है ([SWS_Adc_00367])।
समवर्तीता और प्रतिबंध
विनिर्देश के अनुसार, सेवा को रीएंट्रेंट के रूप में वर्गीकृत किया गया है ([SWS_Adc_00367])। व्याख्या: इसका संभवतः यह अर्थ है कि फ़ंक्शन को विभिन्न चैनल समूहों के लिए समवर्ती रूप से कॉल किया जा सकता है। प्रश्न Q-8283232f222f7b0a (खुला) चूँकि शुरुआत एसिंक्रोनस रूप से होती है, कॉल वास्तविक रूपांतरण पूरा होने से पहले ही लौट आती है।
त्रुटि प्रबंधन और परस्पर क्रिया
यह सेवा हेडर Adc.h के माध्यम से उपलब्ध है और इसकी सर्विस ID 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 में घोषित किया गया है और सर्विस ID 0x03 के अंतर्गत निर्दिष्ट किया गया है [SWS_Adc_00368]।
एकमात्र पैरामीटर के रूप में Adc_GroupType प्रकार का इनपुट मान Group पास किया जाता है, जो संबंधित ADC चैनल समूह के संख्यात्मक ID का प्रतिनिधित्व करता है [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 अंतिम रूप से पूर्ण हुए रूपांतरण दौर ([SWS_Adc_00369]) से ADC चैनल समूह के रूपांतरण परिणामों को पढ़ने का काम करता है। यह हेडर फ़ाइल Adc.h के माध्यम से उपलब्ध है और इसकी सर्विस ID 0x04 ([SWS_Adc_00369]) है।
पैरामीटर और बफ़र लेआउट
Group: अनुरोधित ADC चैनल समूह का संख्यात्मक पहचानकर्ता ([SWS_Adc_00369])।DataBufferPtr: गंतव्य बफ़र (Adc_ValueGroupType*) का पॉइंटर, जिसके पते से समूह के सभी चैनलों के रूपांतरण परिणाम संग्रहीत किए जाते हैं ([SWS_Adc_00369])।
चैनल मानों का भंडारण गंतव्य पते से बढ़ते चैनल क्रम ([SWS_Adc_00369]) में होता है। यह मेमोरी लेआउट कॉन्फ़िगर किए गए स्ट्रीमिंग एक्सेस ([SWS_Adc_00369]) के बफ़र लेआउट से स्पष्ट रूप से भिन्न है। व्याख्या: समूह के सभी चैनलों के लिए पर्याप्त आकार का बफ़र प्रदान करने के लिए कॉलर स्वयं ज़िम्मेदार होना चाहिए। प्रश्न Q-f22a12a6c7ab0eb3 (खुला)
रिटर्न मान और त्रुटि प्रबंधन
प्रकार Std_ReturnType का रिटर्न मान पढ़ने के ऑपरेशन की स्थिति को इंगित करता है ([SWS_Adc_00369]):
E_OK: परिणाम उपलब्ध हैं और डेटा बफ़र में सफलतापूर्वक लिखे गए हैं ([SWS_Adc_00369])।E_NOT_OK: कोई परिणाम उपलब्ध नहीं हैं या कोई विकास त्रुटि (development error) हुई है ([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]। इसे मॉड्यूल Adc में सर्विस ID 0x05 के साथ एक सेवा के रूप में परिभाषित किया गया है और यह हेडर फ़ाइल Adc.h के माध्यम से उपलब्ध है [SWS_Adc_91001]।
- इनपुट पैरामीटर: प्रकार
Adc_GroupTypeके पैरामीटरGroupके माध्यम से वांछित ADC चैनल समूह की संख्यात्मक ID पास की जाती है [SWS_Adc_91001]। कोई अतिरिक्त इनपुट/आउटपुट या आउटपुट पैरामीटर मौजूद नहीं हैं [SWS_Adc_91001]। - रिटर्न मान: इंटरफ़ेस कोई रिटर्न मान नहीं देता है (
void) [SWS_Adc_91001]। - एसिंक्रोनस सिमेंटिक्स: निष्पादन व्यवहार को एसिंक्रोनस के रूप में निर्धारित किया गया है [SWS_Adc_91001]। कॉल ट्रिगरिंग को सक्षम करता है, जबकि चैनलों का वास्तविक रूपांतरण बाद के हार्डवेयर इवेंट्स द्वारा ही शुरू किया जाता है।
संगामिति
ड्राइवर Adc_EnableHardwareTrigger को पुन:प्रवेशी (reentrant) के रूप में निर्दिष्ट करता है [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]।
उपयोग और सिमेंटिक्स
- पैरामीटर: प्रकार
Adc_GroupTypeका पैरामीटरGroupपास किया जाता है, जो वांछित ADC चैनल समूह की संख्यात्मक ID निर्दिष्ट करता है [SWS_Adc_91002]। - रिटर्न मान: फ़ंक्शन का कोई रिटर्न मान (
void) नहीं है [SWS_Adc_91002]। - निष्पादन व्यवहार: कॉल को एसिंक्रोनस (Sync/Async: Asynchronous) के रूप में वर्गीकृत किया गया है [SWS_Adc_91002]। इसका संभवतः अर्थ यह है कि हार्डवेयर इवेंट का वास्तविक रुकना या डिकपल होना हार्डवेयर स्तर पर समय-विलंबित रूप से प्रभावी हो सकता है। प्रश्न Q-b0e613163b254242 (खुला)
समवर्तीता और एकीकरण
इंटरफ़ेस को रीएंट्रेंट (Reentrancy: Reentrant) के रूप में घोषित किया गया है और हेडर फ़ाइल Adc.h के माध्यम से प्रदान किया जाता है; इसकी सर्विस-ID 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]।
एकमात्र इनपुट पैरामीटर के रूप में डेटा प्रकार Adc_GroupType का Group पास किया जाता है, जो अनुरोधित ADC चैनल समूह की संख्यात्मक ID निर्धारित करता है [SWS_Adc_91003]। फ़ंक्शन में न तो कोई इनपुट/आउटपुट पैरामीटर है और न ही आउटपुट पैरामीटर, और यह कोई रिटर्न मान (void) वापस नहीं करता है [SWS_Adc_91003]। यह सेवा सर्विस ID 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.h में घोषित फ़ंक्शन Adc_DisableGroupNotification का उपयोग ADC ड्राइवर में अनुरोधित ADC चैनल समूह के लिए अधिसूचना तंत्र को लक्षित रूप से बंद करने के लिए किया जाता है [SWS_Adc_91004]। सर्विस की सर्विस-ID 0x08 है और इसे हस्ताक्षर void Adc_DisableGroupNotification (Adc_GroupType Group) के साथ निर्दिष्ट किया गया है [SWS_Adc_91004]।
पैरामीटर और इंटरफ़ेस
फ़ंक्शन के निष्पादन के लिए एक एकल इनपुट पैरामीटर का स्थानांतरण निर्धारित है:
Group: प्रकारAdc_GroupTypeके एक संख्यात्मक पहचानकर्ता के रूप में वांछित ADC चैनल समूह की अद्वितीय ID पास करता है, जिसकी अधिसूचना को निष्क्रिय किया जाना है [SWS_Adc_91004]।
फ़ंक्शन कॉलर को कोई रिटर्न मान (void) नहीं लौटाता है [SWS_Adc_91004]। इसके अलावा, विनिर्देश के अनुसार न तो संयुक्त इनपुट/आउटपुट पैरामीटर (inout) और न ही केवल आउटपुट पैरामीटर (out) का उपयोग किया जाता है [SWS_Adc_91004]।
निष्पादन व्यवहार और समवर्तीता (concurrency)
कॉनकरेंसी व्यवहार के संबंध में, Adc_DisableGroupNotification को रीएंट्रेंट के रूप में वर्गीकृत किया गया है [SWS_Adc_91004]। यह मूल रूप से विभिन्न प्रोग्राम संदर्भों द्वारा सेवा के समानांतर या इंटरप्टिंग कॉल की अनुमति देता है [SWS_Adc_91004]।
समय तुल्यकालन (temporal synchronization) के संबंध में, फ़ंक्शन को एसिंक्रोनस के रूप में वर्गीकृत किया गया है [SWS_Adc_91004]। व्याख्या: चूंकि समय व्यवहार को स्पष्ट रूप से एसिंक्रोनस घोषित किया गया है, अधिसूचना तंत्र को बंद करना ड्राइवर के आंतरिक रूप से या ADC हार्डवेयर में पृष्ठभूमि में हो सकता है, बिना कॉलिंग संदर्भ को पूर्ण समापन तक अवरुद्ध किए। प्रश्न Q-a1a30a254aa96655 (खुला)
यह उपयोग निर्देश स्वचालित रूप से जनरेट किया गया था और विनिर्देश के लिए एक पूरक मार्गदर्शन के रूप में कार्य करता है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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 के माध्यम से उपलब्ध है और इसकी सर्विस ID 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 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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: सीधा संक्रमण संभव नहीं है या हार्डवेयर परिधीय (hardware peripheral) अभी भी व्यस्त है [SWS_Adc_00478]।
समवर्तीता और परस्पर क्रिया
फ़ंक्शन को नॉन-रीएंट्रेंट के रूप में निर्दिष्ट किया गया है [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 I/O हार्डवेयर एब्स्ट्रैक्शन के एक अधिसूचना इंटरफ़ेस के रूप में कार्य करता है और ADC ड्राइवर द्वारा जैसे ही मोड <#Mode> में अनुरोधित ऊर्जा स्थिति की तैयारी पूरी होती है, कॉल किया जाता है [SWS_Adc_00480]। इस इंटरफ़ेस की घोषणा हेडर फ़ाइल IoHwAb_Adc.h के माध्यम से प्रदान की जाती है [SWS_Adc_00480]।
कॉल संदर्भ और सिमेंटिक्स
कॉल के लिए विनिर्देश के अनुसार निम्नलिखित रूपरेखा शर्तें लागू होती हैं [SWS_Adc_00480]:
- पैरामीटर और रिटर्न मान: फ़ंक्शन में न तो इनपुट, न आउटपुट और न ही इनपुट/आउटपुट पैरामीटर होते हैं और यह कोई रिटर्न मान नहीं देता है (
void) [SWS_Adc_00480]। - समकालिकता (Synchronicity): निष्पादन व्यवहार को सिंक्रोनस के रूप में परिभाषित किया गया है [SWS_Adc_00480]।
- रीएंट्रेंसी: फ़ंक्शन को नॉन-रीएंट्रेंट (
Non Reentrant) के रूप में वर्गीकृत किया गया है [SWS_Adc_00480]। इसलिए कॉलर को यह सुनिश्चित करना चाहिए कि कॉल क्रमिक रूप से हों और समवर्ती रूप से ओवरलैप न हों।
इंटरैक्शन और एरर हैंडलिंग
विनिर्देश डेटा में कोई त्रुटि कोड या DET अथवा DEM को सूचनाएं संग्रहीत नहीं हैं [SWS_Adc_00480]। सिंटैक्स विनिर्देश IoHwAb_Adc_NotifyReadyForPowerState<#Mode> संभवतः यह इंगित करता है कि पहचानकर्ता कॉन्फ़िगर किए गए पावर मोड के आधार पर विशेष रूप से जनरेट किया गया है। प्रश्न Q-9e9c969f8a41d0de (खुला) फ़ंक्शन संभवतः परिवर्तन के लिए तत्परता स्थिति को उच्च-स्तरीय पावर प्रबंधन को इंगित करने के लिए ड्राइवर के कॉलबैक के रूप में कार्य करता है।
यह पाठ विनिर्देश SWS_Adc_00480 के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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.
गणना प्रकार (enumeration type) 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): परिणाम बफ़र पूरी तरह से भर गया है; चयनित समूह के प्रत्येक चैनल के लिए नमूनों (samples) की अपेक्षित संख्या उपलब्ध है [SWS_Adc_00513]।
अनुप्रयोगों में, यह प्रकार आम तौर पर समूह की प्रगति को क्वेरी करने या उसका मूल्यांकन करने के लिए उपयोग किया जाता है, ताकि यह निर्धारित किया जा सके कि परिणाम पहले ही पढ़े जा सकते हैं या आगे के नमूने (samplings) लंबित हैं।
यह पाठ AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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 चैनल समूह के प्रत्येक चैनल का ठीक एक रूपांतरण निष्पादित करता है [SWS_Adc_00515]। यदि ट्रिगर स्रोत के रूप में सॉफ़्टवेयर ट्रिगर कॉन्फ़िगर किया गया था, तो शुरू किए गए रूपांतरण को सॉफ़्टवेयर API कॉल के माध्यम से रोका जा सकता है [SWS_Adc_00515]। दूसरी ओर, यदि कोई हार्डवेयर ट्रिगर स्रोत असाइन किया गया है, तो शुरू किए गए वन-शॉट रूपांतरण को ट्रिगर इवेंट को निष्क्रिय करके रोका जा सकता है, बशर्ते यह हार्डवेयर द्वारा समर्थित हो [SWS_Adc_00515]। -
ADC_CONV_MODE_CONTINUOUS(0x01): चैनल समूह के भीतर प्रत्येक चैनल के लगातार दोहराए जाने वाले रूपांतरण करता है [SWS_Adc_00515]। यह निरंतर मोड विशेष रूप से सॉफ़्टवेयर ट्रिगर स्रोत वाले समूहों के लिए उपलब्ध है [SWS_Adc_00515]। पहले से शुरू किए गए निरंतर रूपांतरण रन को सॉफ़्टवेयर API कॉल के माध्यम से किसी भी समय समाप्त किया जा सकता है [SWS_Adc_00515]।
प्रतिबंधों के संबंध में, यह ध्यान दिया जाना चाहिए कि ADC_CONV_MODE_CONTINUOUS केवल सॉफ़्टवेयर ट्रिगरिंग के साथ अनुमत है और इसे हार्डवेयर ट्रिगर स्रोतों के साथ संयोजित नहीं किया जा सकता है [SWS_Adc_00515]। चल रहे रूपांतरणों को रोकने के लिए सॉफ़्टवेयर ट्रिगर्स के मामले में एक समर्पित सॉफ़्टवेयर API कॉल की आवश्यकता होती है, जबकि हार्डवेयर-ट्रिगर वन-शॉट अनुक्रमों के लिए ट्रिगर इवेंट को बंद करने की आवश्यकता होती है [SWS_Adc_00515]।
यह पाठ एक AI द्वारा बनाया गया था और पूरी तरह से 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 निश्चित नमूना आकार (sample size) के साथ स्व-निहित माप श्रृंखलाओं के लिए अभिप्रेत है, ADC_STREAM_BUFFER_CIRCULAR को स्वचालित ओवरराइटिंग के कारण ध्यान न दिए गए डेटा हानि से बचने के लिए संभवतः निरंतर बफ़र निगरानी या त्वरित डेटा पुनर्प्राप्ति की आवश्यकता होती है [SWS_Adc_00519]। प्रश्न Q-23b411e5e6c50591 (खुला)
यह पाठ AUTOSAR Classic R20-11 विनिर्देश के आधार पर AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
टाइप Adc_GroupAccessModeType [SWS_Adc_00528] 📄 PDF
Type for configuring the access mode to group conversion results.
गणना प्रकार (enumeration type) Adc_GroupAccessModeType का उपयोग [SWS_Adc_00528] के अनुसार किसी ADC चैनल समूह के रूपांतरण परिणामों के लिए एक्सेस मोड को कॉन्फ़िगर करने हेतु किया जाता है। प्रकार परिभाषा हेडर फ़ाइल 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 विनिर्देश के आधार पर AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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]। इससे यह निर्धारित होता है कि महत्वपूर्ण डेटा बिट्स मेमोरी में बाएँ-संरेखित (left-aligned) हैं या दाएँ-संरेखित (right-aligned) [SWS_Adc_00525]। व्याख्या: बाएँ या दाएँ संरेखण का निर्धारण विशेष रूप से तब प्रासंगिक हो सकता है, जब एनालॉग-टू-डिजिटल कनवर्टर का हार्डवेयर रिज़ॉल्यूशन असाइन किए गए बफ़र मेमोरी की एलिमेंट चौड़ाई से कम हो। प्रश्न Q-54221124172a3d87 (खुला) डाउनस्ट्रीम सॉफ़्टवेयर घटकों को कॉन्फ़िगर किए गए संरेखण को ध्यान में रखना चाहिए, ताकि बिना किसी गणना या बिट-शिफ्टिंग त्रुटियों के रॉ मानों को पढ़ा जा सके।
इस गणन (enumeration) के लिए कोई विशिष्ट त्रुटि कोड, 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 (खुला) चूंकि यह एक मौलिक डेटा प्रकार परिभाषा है, इसलिए विशिष्ट गुण जैसे कि कॉल संदर्भ, रीएंट्रेंसी आवश्यकताएं, सिंक्रोनस या एसिंक्रोनस सिमेंटिक्स के साथ-साथ रनटाइम त्रुटियां और DET संदेश संबंधित ड्राइवर API में परिभाषित होते हैं और इस प्रकार विवरण का हिस्सा नहीं होते हैं [SWS_Adc_00526]।
यह पाठ एक AI द्वारा तैयार किया गया था। यह पूरी तरह से 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): API कॉल करने के क्रम में त्रुटि है [SWS_Adc_00527]।ADC_HW_FAILURE(3): एक हार्डवेयर त्रुटि आवश्यक स्थिति में परिवर्तन को रोकती है [SWS_Adc_00527]।ADC_POWER_STATE_NOT_SUPP(4): अनुरोधित Power-State, ADC मॉड्यूल द्वारा समर्थित नहीं है [SWS_Adc_00527]।ADC_TRANS_NOT_POSSIBLE(5): वर्तमान स्थिति से वांछित स्थिति में प्रत्यक्ष संक्रमण (transition) संभव नहीं है या हार्डवेयर परिधीय (hardware peripheral) अभी व्यस्त है [SWS_Adc_00527]।
नियमित निष्पादन और त्रुटिपूर्ण स्थितियों जैसे कि गलत अनुक्रम, अनुपलब्ध मॉड्यूल आरंभीकरण या हार्डवेयर संघर्षों के बीच अंतर करने के लिए कॉलर्स को रिटर्न मान का मूल्यांकन करना चाहिए [SWS_Adc_00527]।
यह पाठ विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता 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#188e0e8c- Content hash
188e0e8c- 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 · जर्मन मूल