AUTOSAR COM
The AUTOSAR COM module provides signal-based communication services for inter-ECU exchange across diverse bus systems.
Funktionen — Übersicht
void Com_Init (const Com_ConfigType* config);This service initializes internal and external interfaces and variables of the AUTO- SAR COM module layer for the further...void Com_DeInit (void);This service stops the inter - ECU communication.void Com_IpduGroupStart (Com_IpduGroupIdType IpduGroupId, boolean initialize);Starts a preconfigured I - PDU group.void Com_IpduGroupStop (Com_IpduGroupIdType IpduGroupId);Stops a preconfigured I - PDU group.void Com_EnableReceptionDM (Com_IpduGroupIdType IpduGroupId);Enables the reception deadline monitoring for the I - PDUs within the given I - PDU group.void Com_DisableReceptionDM (Com_IpduGroupIdType IpduGroupId);Disables the reception deadline monitoring for the I - PDUs within the given I - PDU group.Com_StatusType Com_GetStatus (void);Returns the status of the AUTOSAR COM module.void Com_GetVersionInfo (Std_VersionInfoType* versioninfo);Returns the version information of this module.uint8 Com_SendSignal (Com_SignalIdType SignalId, const void* SignalDataPtr);The service Com_ Send Signal updates the signal object identified by Signal Id with the signal referenced by the Signal Data...uint8 Com_SendDynSignal (Com_SignalIdType SignalId, const void* SignalDataPtr, uint16 Length);The service Com_ Send Dyn Signal updates the signal object identified by Signal Id with the signal referenced by the Signal...uint8 Com_ReceiveSignal (Com_SignalIdType SignalId, void* SignalDataPtr);Com_ Receive Signal copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr.uint8 Com_ReceiveDynSignal (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length);Com_ Receive Dyn Signal copies the data of the signal identified by Signal Id to the lo cation specified by Signal Data Ptr...uint8 Com_SendSignalGroup (Com_SignalGroupIdType SignalGroupId);The service Com_ Send Si gnal Group copies the content of the associated shadow buffer to the associated I - PDU.uint8 Com_ReceiveSignalGroup (Com_SignalGroupIdType SignalGroupId);The service Com_ Receive Signal Group copies the received signal group from the I - PDU to the shadow buffer.uint8 Com_SendSignalGroupArray (Com_SignalGroupIdType SignalGroupId, const uint8* SignalGroupArrayPtr);The service Com_ Send Signal Group Array copies the conte nt of the provided Signal Group Array Ptr to the associated I - PDU.uint8 Com_ReceiveSignalGroupArray (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr);The service Com_ Receive Signal Group Array copies the re ceived signal group arrayuint8 Com_ReceiveSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr);Com_ Receive Signal With Meta Data copies the data of the signal identified by Signal Id to the location specified by Signal...uint8 Com_ReceiveDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length, uint8* MetaDataPtr);Com_ Receive Dyn Signal With Meta Da ta copies the data of the signal identified by Signal Id to the location specified by...uint8 Com_ReceiveSignalGroupWith MetaData (Com_SignalGroupIdType SignalGroupId, uint8* MetaDataPtr); ⚠️The service Com_ Receive Signal Group With Meta Data copies the received signal group from the I - PDU to the shadow buffer.void Com_ReceiveSignalGroupArrayWith MetaData (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr, uint8* MetaDataPtr); ⚠️The service Com_ Receive Signal Group Array With Meta Data copies the received si gnal group array representation from the PDU...uint8 Com_SendSignalWith MetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr); ⚠️The service Com_ Send Si gnal With Meta Data updates the signal object identified by Signal Id with the signal referenced by...uint8 Com_SendDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16 Length, uint8* MetaDataPtr);The service Com_ Send Dyn Signal With Meta Data updates the signal object identified by Signal Id wit h the signal referenced...uint8 Com_SendSignalGroupWith MetaData (Com_SignalGroupIdType SignalGroupId, uint8* MetaDataPtr); ⚠️The service Com_ Send Signal Group With Meta Data copies the content of the associated shadow buffer to the associated I - PDU.uint8 Com_SendSignalGroupArrayWithMetaData (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr, uint8* MetaDataPtr);The service Com_ Send Signal Group Array With Meta Data copies the content of the provided Signal Group Array Ptr to the...uint8 Com_InvalidateSignal (Com_SignalIdType SignalId);The service Com_ In validate Signal invalidates the signal with the given Signal Id by setting its value to its configured Com...uint8 Com_InvalidateSignalGroup (Com_SignalGroupIdType SignalGroupId);The service Co m_ Invalidate Signal Group invalidates all group signals of the signal group with the given Signal Group Id by...Std_ReturnType Com_TriggerIPDUSend (PduIdType PduId);By a call to Com_ Trigger IPDUSend the I - PDU with the given ID is triggered for transmission.Std_ReturnType Com_TriggerIPDUSendWithMetaData (PduIdType PduId, const uint8* MetaData);By a call to Com_ Trigger IPDUSend With Meta Data the AUTOSAR COM module updates its internal metadata for the I - PDU with...void Com_SwitchIpduTxMode (PduIdType PduId, booleanMode); ⚠️The service Com_ Switch Ipdu Tx Mode sets the transmi ssion mode of the I - PDU refe- renced by Pdu Id to Mode.Std_ReturnType Com_TriggerTransmit (PduIdType TxPduId, PduInfoType* PduInfoPtr);Within this API , the upper layer module (called module) shall check whether the available data fits into the buffer size...void Com_RxIndication (PduIdType RxPduId, const PduInfoType* PduInfoPtr);Indication of a received PDU from a lower layer communication interface module.void Com_TpRxIndication (PduIdType id, Std_ReturnType result);Called after an I - PDU has been received via the TP API, the result indicates whe- ther the transmission was successful or not.void Com_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);The lower layer communication interface module confirms the transmission of avoid Com_TpTxConfirmation (PduIdType id, Std_ReturnType result);This function is called after the I - PDU has been transmitted on its network, the result indicates whether the transmission...BufReq_ReturnType Com_StartOfReception (PduIdType id, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);Service Com_StartReception.BufReq_ReturnType Com_CopyRxData (PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr);Service Com_CopyRxData.BufReq_ReturnType Com_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);Service Com_CopyTxData.void Com_MainFunctionRx (void);This function performs the processing of the AUTOSAR COM module's receive processing that are not directly handled within the...void Com_MainFunctionTx (void);This function performs the processing of the AUTOSAR COM module's transmissi- on activities that are not directly handled...void Com_MainFunction RouteSignals (void); ⚠️Calls the signal gateway part of the AUTOSAR COM module to forward received signals to be routed.void Com_CbkTxAck (void);This callback represents notification class 2 of [17].void Com_CbkTxErr (void);This callback corresponds to notification class 4 of [17].void Com_CbkTxTOut (void);This callback corresponds to notification class 4 of [17].void Com_CbkRxAck (void);This callback represents notification class 1 of [17].void Com_CbkRxTOut (void);This callback corresponds to notification class 3 of [17].void Com_CbkInv (void);This callback function corresponds to SWS_ Com_00680.void Com_CbkCounterErr (PduIdType ComPduId, uint8 ExpectedCounter, uint8 ReceivedCounter);This function is called immediately, if the AUTOSAR COM module receives an I - PDU counter that differs from the expected one.void Com_CbkTxPrep (void);This callback function indicates that the signals/ signal groups of a dedicated Com_ Main Function Tx instance will now be...boolean Com_RxIpduCallout (PduIdType PduId, const PduInfoType* PduInfoPtr);The I - PDU callout on receiver side can be configured to implement user - defined receive filtering mechanisms.boolean Com_TxIpduCallout (PduIdType PduId, PduInfoType* PduInfoPtr);The I - PDU callout on sender side can be configured for example to implement user - defined transmission filtering or user -...
Typen — Übersicht
enum Com_StatusTypeThis is a status value returned by the API service Com_ Get Status().Com_SignalIdTypeThe AUTOSAR COM module's signal object identifier.Com_SignalGroupIdTypeThe AUTOSAR COM module's signal group object identifier.Com_IpduGroupIdTypeThe AUTOSAR COM I - PDU module's group object identifier.struct Com_ConfigTypeThis is the type of the data structure containing the initialization data for COM.
Funktionen & Typen — Detailansicht
फ़ंक्शन Com_Init [SWS_Com_00432] 📄 PDF
void Com_Init (const Com_ConfigType* config);
This service initializes internal and external interfaces and variables of the AUTO- SAR COM module layer for the further processing. After calling this function the inter - ECU communication is still disabled. In configurations, in which Com is assigned to mo re than one partition (i.e. Com_ Main Functions are mapped to partitions), Com may provide one init function per AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM partition.
उपयोग और सिमेंटिक्स
फ़ंक्शन Com_Init बाद के प्रसंस्करण ([SWS_Com_00432]) के लिए AUTOSAR-COM परत के आंतरिक और बाहरी इंटरफ़ेस के साथ-साथ चरों को इनिशियलाइज़ करता है। कॉल सिंक्रोनस रूप से होती है और नॉन-रीएंट्रेंट है (Non Reentrant) ([SWS_Com_00432])। COM मॉड्यूल के कॉन्फ़िगरेशन डेटा के पॉइंटर के रूप में config पासिंग पैरामीटर के रूप में कार्य करता है (const Com_ConfigType* config); कोई रिटर्न मान मौजूद नहीं है ([SWS_Com_00432])। मल्टी-पार्टीशन कॉन्फ़िगरेशन में, जहाँ COM मॉड्यूल के मुख्य फ़ंक्शन कई पार्टीशन को सौंपे जाते हैं, COM प्रति पार्टीशन एक समर्पित इनिशियलाइज़ेशन फ़ंक्शन प्रदान कर सकता है ([SWS_Com_00432])।
अनुक्रम शर्तें और त्रुटि हैंडलिंग
Com_Init के माध्यम से इनिशियलाइज़ेशन COM इंटरफ़ेस के नियमित उपयोग के लिए कार्यात्मक पूर्वापेक्षा है: यदि Com_Init से पहले या Com_DeInit के कॉल के बाद कोई API सेवा कॉल की जाती है, तो त्रुटि कोड COM_E_UNINIT (0x02) जनरेट होता है ([SWS_Com_00804])। इस त्रुटि जाँच से केवल Com_GetStatus, Com_GetVersionInfo, Com_MainFunctionRx, Com_MainFunctionTx और Com_MainFunctionRouteSignals के कॉल को बाहर रखा गया है ([SWS_Com_00804])।
PDU और सिग्नल इनिशियलाइज़ेशन में सहभागिता
Com_Init के निष्पादन के बाद, वास्तविक इंटर-ECU संचार शुरू में निष्क्रिय ही रहता है ([SWS_Com_00432])। व्याख्या: इसलिए नियमित ट्रांसमिशन और रिसेप्शन संचालन के लिए संबंधित I-PDU समूहों का बाद में सक्रियण आवश्यक होने की संभावना है। प्रश्न Q-8407f9a6281c3764 (खुला) हालांकि, कुछ डेटा संरचनाओं के लिए, Com_Init पहले से ही सीधे इनिशियलाइज़ेशन करता है:
- यदि कोई I-PDU किसी I-PDU समूह को नहीं सौंपा गया है, तो COM इस I-PDU को
Com_Initके भीतर ही इस प्रकार शुरू करता है, जैसे कि इसे सेट इनिशियलाइज़ेशन पैरामीटर के साथCom_IpduGroupStartके माध्यम से शुरू किया गया हो ([SWS_Com_00840])। - कॉन्फ़िगर किए गए ऐरे एक्सेस (
ComSignalGroupArrayAccess) वाले सिग्नल समूहों के लिए,Com_Initसभी शामिल समूह सिग्नलों ([SWS_Com_00850]) के प्रारंभिक मानों (ComSignalInitValue) के आधार पर I-PDU के संबंधित बफ़र क्षेत्र को इनिशियलाइज़ करता है।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर एक AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Init [SWS_Com_00130] 📄 PDF
void Com_DeInit (void);
This service stops the inter - ECU communication. All started I - PDU groups are stop- ped and have to be started again, if needed, after Com_ Init is called. By a call to Com_ De Init the AUTOSAR COM module is put into an not initialized state.
उपयोग और कॉल संदर्भ
सिंक्रोनस फ़ंक्शन [SWS_Com_00130] (व्याख्या: पेलोड में 'Init' के रूप में सूचीबद्ध है, लेकिन हस्ताक्षर void Com_DeInit(void) निर्दिष्ट करता है) इंटर-ECU संचार को समाप्त करता है और AUTOSAR COM मॉड्यूल को अनप्रारंभीकृत स्थिति ([SWS_Com_00130]) में रखता है। प्रश्न Q-3e91d7d0a140cee0 (खुला) सेवा की सेवा ID 0x02 है, इसके लिए किसी इनपुट पैरामीटर की आवश्यकता नहीं है, यह कोई रिटर्न मान नहीं देती है और हेडर फ़ाइल Com.h के माध्यम से प्रदान की जाती है ([SWS_Com_00130])।
समवर्तीता और प्रतिबंध
कॉल संदर्भ के संबंध में, फ़ंक्शन को गैर-रीएंट्रेंट (Non Reentrant) के रूप में परिभाषित किया गया है ([SWS_Com_00130])। इसलिए पूर्व पुनरारंभीकरण के बिना समानांतर या एकाधिक कॉल अस्वीकार्य है।
अंतःक्रिया और जीवन चक्र
डी-इनिशियलाइज़ेशन पहले शुरू किए गए सभी I-PDU समूहों को रोक देता है ([SWS_Com_00130])। बाद में संचार को फिर से शुरू करने के लिए निम्नलिखित अनुक्रम शर्तें लागू होती हैं:
- कॉन्फ़िगरेशन पॉइंटर
configपास करके सिंक्रोनस, गैर-रीएंट्रेंट सेवाCom_Initके माध्यम से मॉड्यूल को पुनरारंभीकृत किया जाना चाहिए ([SWS_Com_00432])। - चूंकि
Com_Initके कॉल के बाद इंटर-ECU संचार निष्क्रिय रहता है ([SWS_Com_00432]), इसलिए आवश्यक I-PDU समूहों को बाद में फिर से स्पष्ट रूप से शुरू किया जाना चाहिए ([SWS_Com_00130])।
यह उपयोग संबंधी निर्देश AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_IpduGroupStart [SWS_Com_91001] 📄 PDF
void Com_IpduGroupStart (Com_IpduGroupIdType IpduGroupId, boolean initialize);
Starts a preconfigured I - PDU group. For example, cyclic I - PDUs will be sent out cyclically after the call of Com_ Ipdu Group Start(). If Initialize is true all I - PDUs of the I - PDU group shall be (r e - )initialized before the I - PDU group is started. That is they shall behave like after a start - up of COM, for example the old_ value of the filter ob- jects and shadow buffers of signal groups have to be (re - )initialized.
सिंक्रोनस फ़ंक्शन Com_IpduGroupStart (सर्विस-ID 0x03, हेडर Com.h) एक पूर्व-कॉन्फ़िगर किए गए I-PDU समूह को शुरू करने का काम करता है [SWS_Com_91001]। कॉल के बाद, संबंधित I-PDUs का ट्रांसमिशन सक्रिय हो जाता है; उदाहरण के लिए, चक्रीय I-PDUs इसके बाद चक्रीय रूप से भेजे जाते हैं [SWS_Com_91001]।
उपयोग और पैरामीटर
फ़ंक्शन का कोई रिटर्न मान नहीं होता है और यह दो इनपुट पैरामीटर स्वीकार करता है [SWS_Com_91001]:
IpduGroupId: शुरू किए जाने वाले पूर्व-कॉन्फ़िगर किए गए I-PDU समूह का अद्वितीय आइडेंटिफ़ायर [SWS_Com_91001]।initialize: शुरू करने से पहले इस समूह के I-PDUs के डेटा इनिशियलाइज़ेशन का अनुरोध करने वाला एक बूलियन फ़्लैग [SWS_Com_91001]।
यदि initialize को true पर सेट किया गया है, तो शुरू करने से पहले समूह के सभी I-PDUs को (पुनः) इनिशियलाइज़ किया जाना चाहिए [SWS_Com_91001]। इसके बाद I-PDUs वैसा ही व्यवहार करते हैं जैसा COM मॉड्यूल के स्टार्टअप के तुरंत बाद होता है [SWS_Com_91001]। इसमें विशेष रूप से फ़िल्टर ऑब्जेक्ट्स के पिछले मान (old_value) के साथ-साथ सिग्नल समूहों के लिए शैडो बफ़र्स का पुनरारंभ शामिल है [SWS_Com_91001]।
समवर्तीता और प्रतिबंध
समवर्तीता के संबंध में, Com_IpduGroupStart विभिन्न I-PDU समूहों के लिए रीएंट्रेंट है, लेकिन समान I-PDU समूह के लिए स्पष्ट रूप से रीएंट्रेंट नहीं है [SWS_Com_91001]।
यह पाठ AUTOSAR R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_IpduGroupStop [SWS_Com_91002] 📄 PDF
void Com_IpduGroupStop (Com_IpduGroupIdType IpduGroupId);
Stops a preconfigured I - PDU group. For example, cyclic I - PDUs will be stopped after the call of Com_ Ipdu Group Stop().
उपयोग
फ़ंक्शन Com_IpduGroupStop AUTOSAR COM मॉड्यूल में पूर्व-कॉन्फ़िगर किए गए I-PDU समूह को रोकने का काम करता है [SWS_Com_91002]। डिक्लेरेशन हेडर फ़ाइल Com.h के माध्यम से उपलब्ध है और इसकी सर्विस-ID 0x04 है [SWS_Com_91002]।
- कॉल सिंटैक्स:
void Com_IpduGroupStop (Com_IpduGroupIdType IpduGroupId)[SWS_Com_91002]। - पैरामीटर: एकमात्र पैरामीटर के रूप में
Com_IpduGroupIdTypeप्रकार का इनपुट पैरामीटरIpduGroupIdपास किया जाता है, जो रोके जाने वाले I-PDU समूह के आइडेंटिफ़ायर को निर्दिष्ट करता है [SWS_Com_91002]। कोई अतिरिक्त इनपुट/आउटपुट (inout) या आउटपुट पैरामीटर (out) मौजूद नहीं हैं [SWS_Com_91002]। - रिटर्न मान: इंटरफ़ेस कोई रिटर्न मान नहीं देता है (
void) [SWS_Com_91002]। - निष्पादन व्यवहार: कॉल को सिंक्रोनस रूप से संसाधित किया जाता है [SWS_Com_91002]।
Com_IpduGroupStopको कॉल करने के बाद, प्रभावित समूह का संचार रोक दिया जाता है; इससे, उदाहरण के लिए, समूह के चक्रीय I-PDUs अब नहीं भेजे जाते हैं [SWS_Com_91002]।
समवर्तीता और प्रतिबंध
समवर्तीता और रीएंट्रेंसी के संबंध में, यह निर्धारित किया गया है कि Com_IpduGroupStop विभिन्न I-PDU समूहों के लिए रीएंट्रेंट है, लेकिन एक ही I-PDU समूह के लिए इसे गैर-रीएंट्रेंट रूप से निष्पादित किया जाना चाहिए [SWS_Com_91002]। यदि फ़ंक्शन को मल्टीटास्किंग या मल्टीकोर परिवेशों में कॉल किया जाता है, तो कॉल करने वाले सॉफ़्टवेयर को यह सुनिश्चित करना चाहिए कि एक ही समूह-ID के लिए समवर्ती कॉल अपवर्जित हों।
यह पाठ AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_EnableReceptionDM [SWS_Com_91004] 📄 PDF
void Com_EnableReceptionDM (Com_IpduGroupIdType IpduGroupId);
Enables the reception deadline monitoring for the I - PDUs within the given I - PDU group.
सिंक्रोनस फ़ंक्शन Com_EnableReceptionDM किसी दिए गए I-PDU समूह के भीतर सभी I-PDUs के लिए रिसेप्शन डेडलाइन मॉनिटरिंग (Reception Deadline Monitoring) को सक्रिय करने का काम करता है [SWS_Com_91004]।
उपयोग और कॉल संदर्भ: फ़ंक्शन हेडर फ़ाइल Com.h के माध्यम से घोषित है और इसकी सर्विस-ID 0x06 है [SWS_Com_91004]। एकमात्र पासिंग पैरामीटर के रूप में, सिग्नेचर void Com_EnableReceptionDM (Com_IpduGroupIdType IpduGroupId) Com_IpduGroupIdType प्रकार के इनपुट पैरामीटर IpduGroupId की अपेक्षा करता है, जो I-PDU समूह के आइडेंटिफ़ायर का प्रतिनिधित्व करता है, जिसके शामिल I-PDUs के लिए डेडलाइन मॉनिटरिंग चालू की जानी चाहिए [SWS_Com_91004]। निष्पादन सिंक्रोनस होता है [SWS_Com_91004]। कोई इनपुट/आउटपुट पैरामीटर या आउटपुट पैरामीटर मौजूद नहीं हैं, और कोई रिटर्न मान प्रदान नहीं किया जाता है (रिटर्न प्रकार void) [SWS_Com_91004]।
समवर्तीता और सीमाएं: समवर्तीता के संबंध में, Com_EnableReceptionDM विभिन्न I-PDU समूहों के लिए रीएंट्रेंट है, लेकिन समान I-PDU समूह के लिए रीएंट्रेंट नहीं है [SWS_Com_91004]। इसलिए समान समूह-ID के लिए समवर्ती कॉल की अनुमति नहीं है और कॉल संदर्भ में इससे बचा जाना चाहिए [SWS_Com_91004]।
यह उपयोग नोट AUTOSAR Classic रिलीज़ R20-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन Com_DisableReceptionDM [SWS_Com_91003] 📄 PDF
void Com_DisableReceptionDM (Com_IpduGroupIdType IpduGroupId);
Disables the reception deadline monitoring for the I - PDUs within the given I - PDU group.
सिंक्रोनस फ़ंक्शन Com_DisableReceptionDM पास किए गए I-PDU समूह के भीतर सभी I-PDUs के लिए रिसेप्शन डेडलाइन मॉनिटरिंग (Reception Deadline Monitoring) को निष्क्रिय करता है [SWS_Com_91003]।
उपयोग
कॉल इनपुट पैरामीटर के रूप में प्रभावित I-PDU समूह के आइडेंटिफ़ायर के साथ इंटरफ़ेस void Com_DisableReceptionDM(Com_IpduGroupIdType IpduGroupId) के माध्यम से किया जाता है IpduGroupId [SWS_Com_91003]। फ़ंक्शन में न तो इनपुट/आउटपुट और न ही आउटपुट पैरामीटर हैं और यह कोई रिटर्न मान नहीं देता है (void) [SWS_Com_91003]। सर्विस हेडर फ़ाइल Com.h में सर्विस-ID 0x05 के साथ घोषित है [SWS_Com_91003]।
समवर्तीता और प्रतिबंध
समवर्तीता व्यवहार के संबंध में, सर्विस विभिन्न I-PDU समूहों के लिए रीएंट्रेंट है, लेकिन समान I-PDU समूह के लिए इसे समवर्ती रूप से (non-reentrant) कॉल नहीं किया जाना चाहिए [SWS_Com_91003]।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
फ़ंक्शन Com_GetStatus [SWS_Com_00194] 📄 PDF
Com_StatusType Com_GetStatus (void);
Returns the status of the AUTOSAR COM module. Availab le via Com.h
फ़ंक्शन Com_GetVersionInfo [SWS_Com_00426] 📄 PDF
void Com_GetVersionInfo (Std_VersionInfoType* versioninfo);
Returns the version information of this module.
फ़ंक्शन Com_SendSignal [SWS_Com_00197] 📄 PDF
uint8 Com_SendSignal (Com_SignalIdType SignalId, const void* SignalDataPtr);
The service Com_ Send Signal updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter. Avai lable via Com.h
फलन Com_SendSignal SignalId द्वारा पहचाने गए सिग्नल ऑब्जेक्ट को उस डेटा के साथ अपडेट करने का कार्य करता है जिसे पॉइंटर SignalDataPtr संदर्भित करता है [SWS_Com_00197]। कॉल एसिंक्रोनस रूप से संसाधित की जाती है [SWS_Com_00197]।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन प्रकार uint8 की स्थिति लौटाता है [SWS_Com_00197]:
E_OK: सेवा स्वीकार कर ली गई [SWS_Com_00197]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रोक दिया गया था या विकास त्रुटि के कारण कॉल विफल हो गई [SWS_Com_00197]।COM_BUSY: तब होता है जब बड़े डेटा प्रकारों के प्रसंस्करण के लिए TP बफर लॉक हो [SWS_Com_00197]।
समवर्तीता और प्रतिबंध
पुन:प्रवेशिता (reentrancy) के संबंध में, Com_SendSignal समान सिग्नल के लिए गैर-पुन:प्रवेशी है, लेकिन विभिन्न सिग्नलों के लिए समवर्ती रूप से कॉल किया जा सकता है [SWS_Com_00197]। इंटरफ़ेस हेडर Com.h के माध्यम से प्रदान किया जाता है [SWS_Com_00197]।
इंटरेक्शन और कॉन्फ़िगरेशन
यदि किसी सिग्नल समूह के लिए कॉन्फ़िगरेशन ComSignalGroupArrayAccess परिभाषित है, तो उस सिग्नल समूह के समूह सिग्नलों के लिए Com_SendSignal की कॉल समर्थित नहीं है [SWS_Com_00843]।
यह पाठ AUTOSAR विनिर्देश के आधार पर एक AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_SendDynSignal [SWS_Com_00627] 📄 PDF
uint8 Com_SendDynSignal (Com_SignalIdType SignalId, const void* SignalDataPtr, uint16 Length);
The service Com_ Send Dyn Signal updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter.
Classic AUTOSAR फ़ंक्शन Com_SendDynSignal पास किए गए पेलोड ([SWS_Com_00627]) के आधार पर डायनेमिक लंबाई वाले सिग्नल ऑब्जेक्ट को अपडेट करने का कार्य करता है। इस सेवा का सर्विस ID 0x21 है और यह अतुल्यकालिक रूप से कार्य करती है ([SWS_Com_00627])। इनपुट पैरामीटर के रूप में, इंटरफ़ेस लक्ष्य सिग्नल के पहचानकर्ता (SignalId), प्रेषित किए जाने वाले सिग्नल पेलोड के पॉइंटर (SignalDataPtr) और डायनेमिक सिग्नल की वर्तमान लंबाई (Length) की अपेक्षा करता है; कोई आउटपुट पैरामीटर मौजूद नहीं हैं ([SWS_Com_00627])।
प्रकार uint8 का रिटर्न मान कार्य स्वीकृति के परिणाम की रिपोर्ट करता है ([SWS_Com_00627]):
E_OK: सर्विस कॉल सफलतापूर्वक स्वीकार कर लिया गया था ([SWS_Com_00627])।E_NOT_OK: पैरामीटरLengthइस सिग्नल के लिए कॉन्फ़िगर की गई अधिकतम लंबाईComSignalLengthसे अधिक है ([SWS_Com_00627])।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रुका हुआ है या विकास त्रुटि के परिणामस्वरूप सेवा विफल हो गई है ([SWS_Com_00627])।COM_BUSY: TP बफ़र लॉक है ([SWS_Com_00627])।
समवर्तीता के संबंध में, Com_SendDynSignal विभिन्न सिग्नलों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल के लिए पुनःप्रवेशी नहीं है ([SWS_Com_00627])। फ़ंक्शन घोषणा हेडर Com.h के माध्यम से उपलब्ध है ([SWS_Com_00627])।
यह पाठ एक AI द्वारा तैयार किया गया था और एक मार्गदर्शन के रूप में कार्य करता है। विनिर्देश निर्णायक है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_ReceiveSignal [SWS_Com_00198] 📄 PDF
uint8 Com_ReceiveSignal (Com_SignalIdType SignalId, void* SignalDataPtr);
Com_ Receive Signal copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr.
सिंक्रोनस फ़ंक्शन Com_ReceiveSignal SignalId के माध्यम से निर्दिष्ट सिग्नल के डेटा को पॉइंटर SignalDataPtr के माध्यम से प्रदान किए गए मेमोरी पते ([SWS_Com_00198]) पर कॉपी करता है।
उपयोग और सिमेंटिक्स
कॉल सिग्नल ट्रांसफर को सिंक्रोनस रूप से प्रोसेस करता है और इनपुट पैरामीटर के रूप में पहचानकर्ता SignalId (प्रकार Com_SignalIdType) और आउटपुट पैरामीटर के रूप में लक्ष्य बफ़र के लिए पॉइंटर SignalDataPtr (void*) स्वीकार करता है ([SWS_Com_00198])। इंटरफ़ेस हेडर Com.h के माध्यम से उपलब्ध है ([SWS_Com_00198])।
रिटर्न मान और त्रुटि प्रबंधन
प्रकार uint8 का रिटर्न मान फ़ंक्शन निष्पादन के परिणाम का संकेत देता है ([SWS_Com_00198]):
E_OK: सेवा को सफलतापूर्वक स्वीकार और निष्पादित किया गया ([SWS_Com_00198])।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह को रोक दिया गया था या विकास त्रुटि के कारण सेवा विफल रही ([SWS_Com_00198])।COM_BUSY: तब घटित होता है, यदि बड़े डेटा प्रकारों के प्रसंस्करण के लिए TP बफ़र लॉक हो ([SWS_Com_00198])।
समवर्तीता और प्रतिबंध
रीएंट्रेंसी के संबंध में, Com_ReceiveSignal समान सिग्नल के लिए रीएंट्रेंट नहीं है, लेकिन विभिन्न सिग्नलों के लिए रीएंट्रेंट है ([SWS_Com_00198])। समान सिग्नल-IDs पर समानांतर एक्सेस के मामले में, कॉलर्स को उपयुक्त सिंक्रोनाइज़ेशन सुनिश्चित करना होगा।
इसके अलावा, एक महत्वपूर्ण कॉन्फ़िगरेशन प्रतिबंध है: यदि किसी सिग्नल समूह के लिए ऐरे-आधारित एक्सेस ComSignalGroupArrayAccess कॉन्फ़िगर किया गया है, तो इस सिग्नल समूह के शामिल समूह सिग्नलों के लिए Com_ReceiveSignal का कॉल समर्थित नहीं है ([SWS_Com_00843])।
यह पाठ विनिर्देश आवश्यकताओं के आधार पर एक AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_ReceiveDynSignal [SWS_Com_00690] 📄 PDF
uint8 Com_ReceiveDynSignal (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length);
Com_ Receive Dyn Signal copies the data of the signal identified by Signal Id to the lo cation specified by Signal Data Ptr and stores the length of the dynamical length signal at the position given by the Length parameter.
उपयोग और सिमेंटिक्स
तुल्यकालिक फ़ंक्शन Com_ReceiveDynSignal अपने SignalId के आधार पर डायनेमिक लंबाई वाले सिग्नल को प्राप्त करने का कार्य करता है [SWS_Com_00690]। प्राप्त सिग्नल डेटा को उस मेमोरी स्थान पर कॉपी किया जाता है जिसे SignalDataPtr इंगित करता है [SWS_Com_00690]। इन-आउट पैरामीटर Length के माध्यम से, कॉलर इनपुट मान के रूप में अधिकतम समायोजित की जा सकने वाली लंबाई पास करता है; सफल प्रतिलिपि प्रक्रिया के बाद, प्राप्त डायनेमिक सिग्नल की वास्तविक लंबाई वहां संग्रहीत की जाती है [SWS_Com_00690]।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन प्रकार uint8 का एक स्टेटस मान लौटाता है [SWS_Com_00690]:
E_OK: सेवा कॉल स्वीकार कर ली गई थी और डेटा सफलतापूर्वक कॉपी किया गया था [SWS_Com_00690]।E_NOT_OK: प्रदान किया गया बफ़र बहुत छोटा है, क्योंकिLengthका इनपुट मान प्राप्त सिग्नल की वास्तविक लंबाई से कम है [SWS_Com_00690]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह को रोक दिया गया था या विकास त्रुटि के कारण सेवा विफल रही [SWS_Com_00690]।COM_BUSY: TP बफ़र वर्तमान में लॉक है [SWS_Com_00690]।
समवर्तीता और एकीकरण
पुनःप्रवेश्यता के संबंध में, Com_ReceiveDynSignal समान सिग्नल के लिए पुनःप्रवेशी नहीं है, लेकिन विभिन्न सिग्नलों के लिए पुनःप्रवेशी रूप से कॉल किया जा सकता है [SWS_Com_00690]। घोषणा Com.h के माध्यम से उपलब्ध है [SWS_Com_00690]।
यह पाठ AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI प्रणाली द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_SendSignalGroup [SWS_Com_00200] 📄 PDF
uint8 Com_SendSignalGroup (Com_SignalGroupIdType SignalGroupId);
The service Com_ Send Si gnal Group copies the content of the associated shadow buffer to the associated I - PDU.
एसिंक्रोनस फ़ंक्शन Com_SendSignalGroup का उपयोग संबंधित शैडो बफ़र की सामग्री को संबंधित I-PDU में कॉपी करने के लिए किया जाता है [SWS_Com_00200]। इनपुट पैरामीटर के रूप में, यह प्रेषित किए जाने वाले सिग्नल समूह का पहचानकर्ता SignalGroupId स्वीकार करता है [SWS_Com_00200]।
रिटर्न मान और त्रुटि प्रबंधन
रिटर्न मान सेवा की निष्पादन स्थिति को इंगित करता है [SWS_Com_00200]:
E_OK: सर्विस कॉल सफलतापूर्वक स्वीकार किया गया [SWS_Com_00200]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह को रोक दिया गया था या विकास त्रुटि के कारण सेवा विफल रही [SWS_Com_00200]।COM_BUSY: बड़े डेटा प्रकारों के ट्रांसमिशन के लिए TP बफ़र अस्थायी रूप से लॉक है [SWS_Com_00200]।
समवर्तीता और प्रतिबंध
समवर्तीता के संबंध में, कॉल समान समूह सिग्नल के लिए रीएंट्रेंट नहीं है, लेकिन विभिन्न समूह सिग्नलों के लिए रीएंट्रेंट है [SWS_Com_00200]। व्याख्या: यह प्रतिबंध संभवतः समान सिग्नल समूह पर समवर्ती एक्सेस से संबंधित है। प्रश्न Q-2f3a6da092b51794 (खुला) इसके अलावा, किसी सिग्नल समूह के लिए Com_SendSignalGroup का कॉल समर्थित नहीं है, यदि इसके लिए ComSignalGroupArrayAccess कॉन्फ़िगर किया गया हो [SWS_Com_00843]।
इंटरैक्शन
AUTOSAR-COM मॉड्यूल ट्रांसमिशन विशेषताओं, I-PDU ट्रांसमिशन मोड के चयन और सिग्नल प्रवाह के संबंध में Com_SendSignalGroupArray के कॉल को Com_SendSignalGroup के समतुल्य मानता है [SWS_Com_00847]।
यह उपयोग नोट AUTOSAR विनिर्देश के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_ReceiveSignalGroup [SWS_Com_00201] 📄 PDF
uint8 Com_ReceiveSignalGroup (Com_SignalGroupIdType SignalGroupId);
The service Com_ Receive Signal Group copies the received signal group from the I - PDU to the shadow buffer.
उपयोग
सिंक्रोनस फ़ंक्शन Com_ReceiveSignalGroup सिग्नल समूहों को प्राप्त करने का कार्य करता है। यह प्राप्त सिग्नल समूह के डेटा को संबंधित I-PDU से निर्दिष्ट शैडो बफर (Shadow Buffer) में कॉपी करता है [SWS_Com_00201]। इनपुट पैरामीटर के रूप में, फ़ंक्शन प्रकार Com_SignalGroupIdType के सिग्नल समूह SignalGroupId के पहचानकर्ता की अपेक्षा करता है [SWS_Com_00201]। सेवा हेडर फ़ाइल Com.h में घोषित की गई है [SWS_Com_00201]।
त्रुटि प्रबंधन और रिटर्न मान
सेवा प्रकार uint8 का एक स्थिति मान लौटाती है, जो सफलता या त्रुटि के कारण के बारे में जानकारी प्रदान करता है [SWS_Com_00201]:
E_OK: सेवा सफलतापूर्वक स्वीकार कर ली गई और सिग्नल समूह को कॉपी कर लिया गया [SWS_Com_00201]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रोक दिया गया था या विकास त्रुटि के कारण कॉल विफल हो गई [SWS_Com_00201]।COM_BUSY: यदि बड़े डेटा प्रकारों को संभालने के लिए TP बफर लॉक है, तो सेवा इस स्थिति की रिपोर्ट करती है [SWS_Com_00201]।
समवर्तीता और प्रतिबंध
समवर्ती व्यवहार के संबंध में, Com_ReceiveSignalGroup को उसी सिग्नल समूह के लिए गैर-रीएंट्रेंट के रूप में निष्पादित किया जाता है, लेकिन विभिन्न सिग्नल समूहों के लिए रीएंट्रेंट के रूप में [SWS_Com_00201]।
इसके अतिरिक्त, ऐरे एक्सेस के साथ परस्पर क्रिया में एक महत्वपूर्ण प्रतिबंध है: यदि किसी सिग्नल समूह के लिए कॉन्फ़िगरेशन ComSignalGroupArrayAccess (ECUC_Com_10003) परिभाषित किया गया है, तो उस सिग्नल समूह के लिए Com_ReceiveSignalGroup का कॉल विनिर्देश के अनुसार समर्थित नहीं है [SWS_Com_00843]।
यह उपयोग नोट स्वचालित रूप से तैयार किया गया था और विनिर्देश AUTOSAR Classic R20-11 पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_SendSignalGroupArray [SWS_Com_00851] 📄 PDF
uint8 Com_SendSignalGroupArray (Com_SignalGroupIdType SignalGroupId, const uint8* SignalGroupArrayPtr);
The service Com_ Send Signal Group Array copies the conte nt of the provided Signal Group Array Ptr to the associated I - PDU. The provided data shall correspond to the array representation of the signal group.
एसिंक्रोनस फ़ंक्शन Com_SendSignalGroupArray पॉइंटर SignalGroupArrayPtr के माध्यम से किसी सिग्नल समूह के डेटा को सीधे असाइन किए गए I-PDU [SWS_Com_00851] में कॉपी करता है। पास किया गया डेटा संबंधित सिग्नल समूह के ऐरे प्रतिनिधित्व के बिल्कुल अनुरूप होना चाहिए [SWS_Com_00851], [SWS_Com_00852]।
इनपुट पैरामीटर के रूप में सिग्नल समूह का आइडेंटिफ़ायर (SignalGroupId) और सिग्नल समूह ऐरे का संदर्भ (SignalGroupArrayPtr) पास किया जाता है [SWS_Com_00851]। सर्विस निम्नलिखित रिटर्न मान प्रदान करती है [SWS_Com_00851]:
E_OK: सर्विस कॉल सफलतापूर्वक स्वीकार कर लिया गया।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रोक दिया गया था या डेवलपमेंट त्रुटि के कारण कॉल विफल रहा।COM_BUSY: बड़े डेटा प्रकारों के प्रसंस्करण के लिए ट्रांसपोर्ट प्रोटोकॉल बफ़र (TP बफ़र) लॉक है।
समवर्तीता के संबंध में, फ़ंक्शन समान सिग्नल समूह के लिए रीएंट्रेंट नहीं है, लेकिन विभिन्न सिग्नल समूहों के लिए इसे रीएंट्रेंट रूप से कॉल किया जा सकता है [SWS_Com_00851]। कॉल केवल तभी उपलब्ध होता है जब कॉन्फ़िगरेशन स्विच ComEnableSignalGroupArrayApi सक्रिय हो [SWS_Com_00853]।
सिग्नल समूहों की ट्रांसमिशन विशेषताओं, I-PDU ट्रांसमिशन मोड के चयन और सिग्नल प्रवाह के संबंध में, AUTOSAR COM मॉड्यूल द्वारा Com_SendSignalGroupArray को पूरी तरह से Com_SendSignalGroup के अनुरूप माना जाता है [SWS_Com_00847]।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI-समर्थित प्रक्रिया द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_ReceiveSignalGroupArray [SWS_Com_00854] 📄 PDF
uint8 Com_ReceiveSignalGroupArray (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr);
The service Com_ Receive Signal Group Array copies the re ceived signal group array AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM representation from the PDU to the location designated by Signal Group Ar - ray Ptr.
उपयोग और कॉन्फ़िगरेशन
सिंक्रोनस फ़ंक्शन Com_ReceiveSignalGroupArray प्राप्त सिग्नल समूह को बाइट ऐरे प्रतिनिधित्व के रूप में I-PDU से उस मेमोरी क्षेत्र में कॉपी करता है जिसे SignalGroupArrayPtr संदर्भित करता है [SWS_Com_00854], [SWS_Com_00855]। यह फ़ंक्शन केवल तभी उपलब्ध होता है जब कॉन्फ़िगरेशन स्विच ComEnableSignalGroupArrayApi सक्रिय हो [SWS_Com_00856]। यह फ़िल्टर ALWAYS, NEVER, MASKED_NEW_EQUALS_X, MASKED_NEW_DIFFERS_X, MASKED_NEW_DIFFERS_MASKED_OLD और ONE_EVERY_N के साथ रिसेप्शन फ़िल्टरिंग और Transmission Mode Selection का समर्थन करता है [SWS_Com_00848]।
डेटा कॉपी और एरर हैंडलिंग
कॉल किए जाने पर, SignalGroupId और लक्ष्य ऐरे का एक पॉइंटर पास किया जाता है, जिसकी स्थिति पर AUTOSAR COM मॉड्यूल I-PDU के डेटा को कॉपी करता है [SWS_Com_00849]। भले ही I-PDU समूह रुका हुआ हो और सर्विस COM_SERVICE_NOT_AVAILABLE लौटाती हो, मॉड्यूल हमेशा अंतिम ज्ञात डेटा या प्रारंभिक मानों को कॉपी करता है ComSignalInitValues, यदि पहले कोई डेटा नहीं लिखा गया था [SWS_Com_00857]।
रिटर्न मान और समवर्तीता
सर्विस के संभावित रिटर्न मान हैं [SWS_Com_00854]:
E_OK: सेवा सफलतापूर्वक स्वीकार कर ली गई थी।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रोक दिया गया है या डेवलपमेंट त्रुटि के कारण सर्विस विफल रही।COM_BUSY: बड़े डेटा प्रकारों के प्रसंस्करण के लिए TP बफ़र लॉक है।
समवर्तीता के संबंध में, फ़ंक्शन विभिन्न सिग्नल समूहों के लिए रीएंट्रेंट है, लेकिन समान सिग्नल समूह के लिए रीएंट्रेंट नहीं है [SWS_Com_00854]।
यह उपयोग नोट विनिर्देश AUTOSAR CP R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_ReceiveSignalWithMetaData [SWS_Com_91005] 📄 PDF
uint8 Com_ReceiveSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr);
Com_ Receive Signal With Meta Data copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr. The received meta data is stored at the position given by the Meta Data Ptr parameter. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM
सिंक्रोनस फलन Com_ReceiveSignalWithMetaData संचार मॉड्यूल Com से प्राप्त सिग्नल डेटा को उसके मेटाडेटा के साथ पढ़ने का कार्य करता है [SWS_Com_91005]। कॉल किए जाने पर, सेवा SignalId के माध्यम से संबोधित सिग्नल के डेटा को उस मेमोरी स्थान पर कॉपी करती है जिसे SignalDataPtr संदर्भित करता है, और प्राप्त मेटाडेटा को स्थिति MetaDataPtr पर संग्रहीत करती है [SWS_Com_91005]।
पैरामीटर और कॉल संदर्भ
इंटरफ़ेस हेडर Com.h के माध्यम से उपलब्ध है और इसे सर्विस ID 0x49 द्वारा पहचाना जाता है [SWS_Com_91005]। पैरामीटर संरचना को निम्नानुसार संरचित किया गया है:
SignalId(in): प्राप्त किए जाने वाले सिग्नल का पहचानकर्ता [SWS_Com_91005]।SignalDataPtr(out): प्राप्त सिग्नल डेटा को संग्रहीत करने के लिए मेमोरी स्थान का पॉइंटर [SWS_Com_91005]।MetaDataPtr(out): सिग्नल मेटाडेटा [SWS_Com_91005] प्राप्त करने के लिए मेमोरी क्षेत्र का पॉइंटर।
यह फ़ंक्शन uint8 प्रकार का एक रिटर्न मान लौटाता है, जिसके लिए वर्तमान मानक अनुभाग में कोई विशिष्ट त्रुटि मान प्रलेखित नहीं हैं [SWS_Com_91005]।
समवर्तीता और प्रतिबंध
रीएंट्रेंसी के संदर्भ में, यह सेवा विभिन्न सिग्नलों के लिए रीएंट्रेंट है, लेकिन समान सिग्नल के लिए रीएंट्रेंट नहीं है [SWS_Com_91005]। परिणामस्वरूप, समान SignalId के साथ समानांतर या इंटरप्ट करने वाले कॉल्स के मामले में डेटा स्थिरता सुनिश्चित करने के लिए कॉलर द्वारा बाहरी सुरक्षा की आवश्यकता हो सकती है। प्रश्न Q-51cbdce3d4f59f24 (खुला)
यह उपयोग संबंधी निर्देश AI द्वारा जनरेट किया गया है और केवल AUTOSAR विनिर्देश पर आधारित है।
फ़ंक्शन Com_ReceiveDynSignalWithMetaData [SWS_Com_91006] 📄 PDF
uint8 Com_ReceiveDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length, uint8* MetaDataPtr);
Com_ Receive Dyn Signal With Meta Da ta copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr and stores the length of the dy- namical length signal at the position given by the Length parameter. The received meta data is stored at the position given by the Meta Data Ptr parameter.
उपयोग और सिमेंटिक्स
फ़ंक्शन Com_ReceiveDynSignalWithMetaData हेडर फ़ाइल Com.h के माध्यम से प्रदान किया जाता है और इसके मेटाडेटा सहित डायनेमिक लंबाई वाले सिग्नलों के तुल्यकालिक रिसेप्शन के लिए कार्य करता है [SWS_Com_91006]। कॉल किए जाने पर, सेवा SignalId के माध्यम से पहचाने गए सिग्नल के डेटा को SignalDataPtr द्वारा संदर्भित बफ़र में कॉपी करती है [SWS_Com_91006]। प्राप्त मेटाडेटा पॉइंटर MetaDataPtr पर संग्रहीत किया जाता है, जबकि प्राप्त डायनेमिक सिग्नल की वास्तविक लंबाई Length की स्थिति पर लिखी जाती है [SWS_Com_91006]।
रिटर्न मान और त्रुटि प्रबंधन
सेवा प्रकार uint8 का एक स्थिति मान वापस करती है [SWS_Com_91006]:
E_OK: रिसेप्शन सेवा सफलतापूर्वक स्वीकार कर ली गई [SWS_Com_91006]।E_NOT_OK: तब होता है जबLengthका पास किया गया मान प्राप्त डायनेमिक सिग्नल की वास्तविक लंबाई से कम होता है [SWS_Com_91006]। व्याख्या: कॉलर कोLengthके माध्यम से पहले से बफ़र का आकार प्रदान करना होगा, जिससे यह पैरामीटर प्रभावी रूप से संयुक्त इनपुट और आउटपुट के रूप में कार्य करता है। प्रश्न Q-8ad420c74748f219 (खुला)COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रुका हुआ है या विकास त्रुटि के कारण कॉल विफल रही [SWS_Com_91006]।COM_BUSY: TP बफ़र वर्तमान में लॉक है [SWS_Com_91006]।
समवर्तीता और प्रतिबंध
समवर्तीता के संबंध में, फ़ंक्शन विभिन्न सिग्नलों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल के लिए इसे पुनःप्रवेशी रूप से कॉल नहीं किया जाना चाहिए [SWS_Com_91006]। इसलिए समान SignalId के लिए समानांतर कॉलों को कॉलर स्तर पर सिंक्रनाइज़ किया जाना चाहिए।
यह उपयोग नोट स्वचालित रूप से उत्पन्न किया गया था और विशेष रूप से AUTOSAR रिलीज़ R20-11 के विनिर्देश डेटा पर आधारित है।
फ़ंक्शन Data [SWS_Com_91007] 📄 PDF
uint8 Com_ReceiveSignalGroupWithMetaData (Com_SignalGroupIdType SignalGroupId, uint8* MetaDataPtr);
The service Com_ Receive Signal Group With Meta Data copies the received signal group from the I - PDU to the shadow buffer. The received meta data is stored at the position given by the Meta Data Ptr parameter.
तुल्यकालिक फ़ंक्शन Com_ReceiveSignalGroupWithMetaData इंटरफ़ेस Com.h के माध्यम से संबंधित मेटाडेटा सहित सिग्नल समूह को प्राप्त करने का कार्य करता है [SWS_Com_91007]। यह इनपुट पैरामीटर के रूप में पहचानकर्ता SignalGroupId लेता है और सिग्नल समूह के प्राप्त डेटा को I-PDU से स्थानीय शैडो-बफ़र में कॉपी करता है [SWS_Com_91007]। साथ ही, सेवा आउटपुट पैरामीटर MetaDataPtr द्वारा संदर्भित लक्ष्य पते पर प्राप्त मेटाडेटा को संग्रहीत करती है [SWS_Com_91007]।
त्रुटि और रिटर्न व्यवहार में तीन स्थिति मान शामिल हैं: E_OK सेवा की सफल स्वीकृति का संकेत देता है [SWS_Com_91007]। रिटर्न मान COM_SERVICE_NOT_AVAILABLE इंगित करता है कि संबंधित I-PDU समूह रुका हुआ है या कोई विकास त्रुटि मौजूद है [SWS_Com_91007]। यदि त्रुटि कोड COM_BUSY उत्पन्न होता है, तो बड़े डेटा प्रकारों के प्रसंस्करण के लिए TP बफ़र लॉक होता है [SWS_Com_91007]। समवर्तीता के संबंध में, फ़ंक्शन विभिन्न सिग्नल समूहों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल समूह के लिए पुनःप्रवेशी नहीं है [SWS_Com_91007]। चूँकि विनिर्देश किसी भी ISR प्रतिबंध का उल्लेख नहीं करता है, इसलिए कॉल उच्च स्तरीय सॉफ्टवेयर घटक द्वारा टास्क स्तर पर तुल्यकालिक रूप से किया जाना चाहिए। प्रश्न Q-a23cf67bae724ae1 (खुला)
परस्पर क्रिया में, यह फ़ंक्शन एकल सिग्नलों के लिए Com_ReceiveSignalWithMetaData के अनुरूप रिसेप्शन पथ को मेटाडेटा के साथ विस्तारित करता है [SWS_Com_91005]। प्रदान किया गया मेटाडेटा पहले इंटरफ़ेस पर Com_RxIndication के माध्यम से प्राप्त PDU जानकारी से मेल खाता है [SWS_Com_00123]। समग्र प्रक्रिया में अमान्य डेटा सामग्री को इंगित करने के लिए Com_InvalidateSignalGroup का भी उपयोग किया जा सकता है [SWS_Com_00557]।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
फ़ंक्शन Data [SWS_Com_91008] 📄 PDF
void Com_ReceiveSignalGroupArrayWithMetaData (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr, uint8* MetaDataPtr);
The service Com_ Receive Signal Group Array With Meta Data copies the received si gnal group array representation from the PDU to the location designated by Signal Group Ar - ray Ptr. The received meta data is stored at the position given by the Meta Data Ptr parameter.
उपयोग
तुल्यकालिक सेवा Com_ReceiveSignalGroupArrayWithMetaData (सर्विस ID 0x4c, Com.h के माध्यम से उपलब्ध) I-PDU से प्राप्त सिग्नल समूह ऐरे प्रतिनिधित्व को उस मेमोरी स्थान पर कॉपी करती है जो पॉइंटर SignalGroupArrayPtr के माध्यम से प्रदान किया गया है [SWS_Com_91008]। साथ ही, प्राप्त मेटाडेटा पैरामीटर MetaDataPtr द्वारा निर्दिष्ट स्थिति पर लिखा जाता है [SWS_Com_91008]। फ़ंक्शन का कोई रिटर्न मान नहीं है (void) [SWS_Com_91008]।
त्रुटि प्रबंधन
विनिर्देश इस सेवा के लिए कोई रिटर्न मान परिभाषित नहीं करता है और कोई विशिष्ट त्रुटि कोड सूचीबद्ध नहीं करता है [SWS_Com_91008]। व्याख्या: कॉल पैरामीटर में किसी भी त्रुटि स्थिति को संभवतः आंतरिक रूप से संभाला जाना चाहिए और मॉड्यूल की त्रुटि रिपोर्टिंग के माध्यम से प्रबंधित किया जाना चाहिए; हालाँकि, ठोस DET या DEM संदेश विनिर्देश के अंश से स्पष्ट नहीं होते हैं। प्रश्न (खुला)
समवर्तीता और प्रतिबंध
समवर्तीता के संबंध में, फ़ंक्शन विभिन्न सिग्नल समूहों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल समूह के लिए पुनःप्रवेशी नहीं है [SWS_Com_91008]। समान SignalGroupId के साथ समानांतर कॉलों को कॉलर द्वारा रोका जाना चाहिए। व्याख्या: कॉलर पर्याप्त आयाम वाले लक्ष्य बफ़र प्रदान करने के लिए भी बाध्य होने चाहिए, क्योंकि इंटरफ़ेस में कोई लंबाई पैरामीटर शामिल नहीं है। प्रश्न (खुला)
इंटरैक्शन
PDU बफ़र में डेटा का प्रावधान यह पूर्वकल्पित करता है कि पहले Com_RxIndication के माध्यम से एक रिसेप्शन संकेत प्राप्त हुआ है, जो COM मॉड्यूल को मेटाडेटा भी वितरित करता है [SWS_Com_00123]। यह फ़ंक्शन एकल सिग्नलों के लिए Com_ReceiveSignalWithMetaData के अनुरूप मेटाडेटा के लिए रिसेप्शन इंटरफेस का विस्तार करता है [SWS_Com_91005] और Com_ReceiveSignal के माध्यम से नियमित सिग्नल पुनर्प्राप्ति से भिन्न है [SWS_Com_00198]।
यह उपयोग नोट AUTOSAR विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
फ़ंक्शन Data [SWS_Com_91009] 📄 PDF
uint8 Com_SendSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr);
The service Com_ Send Si gnal With Meta Data updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter. The meta data is provided via the Meta Data Ptr parameter.
फ़ंक्शन Com_SendSignalWithMetaData ([SWS_Com_91009]) SignalId द्वारा निर्दिष्ट सिग्नल ऑब्जेक्ट को SignalDataPtr के माध्यम से पेलोड और MetaDataPtr के माध्यम से संबंधित मेटाडेटा के साथ अतुल्यकालिक रूप से अपडेट करने का कार्य करता है। यह सेवा हेडर Com.h के माध्यम से उपलब्ध है।
- कॉल और समवर्तीता: कॉल अतुल्यकालिक रूप से किया जाता है ([SWS_Com_91009])। फ़ंक्शन विभिन्न सिग्नलों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल पहचानकर्ता (
SignalId) के लिए पुनःप्रवेशी नहीं है ([SWS_Com_91009])। - रिटर्न मान और त्रुटि प्रबंधन: फ़ंक्शन प्रकार
uint8का एक स्थिति मान लौटाता है ([SWS_Com_91009]):E_OK: प्रेषण अनुरोध मॉड्यूल द्वारा सफलतापूर्वक स्वीकार कर लिया गया ([SWS_Com_91009])।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रुका हुआ है या विकास त्रुटि के कारण कॉल विफल रही ([SWS_Com_91009])।COM_BUSY: बड़े डेटा प्रकारों को संसाधित करने के लिए TP बफ़र लॉक है ([SWS_Com_91009])।
- परस्पर क्रिया: बुनियादी प्रेषण सेवा
Com_SendSignal([SWS_Com_00197]) के विपरीत, यह फ़ंक्शन स्पष्ट मेटाडेटा पास करता है। यह रिसेप्शन सेवाCom_ReceiveSignalWithMetaData([SWS_Com_91005]) के लिए प्रेषण-पक्ष समकक्ष बनाता है औरCom_TriggerIPDUSendWithMetaData([SWS_Com_00858]) जैसी I-PDU-संबंधित मेटाडेटा सेवाओं का पूरक है।
यह उपयोग नोट विनिर्देश के आधार पर स्वचालित रूप से तैयार किया गया था।
फ़ंक्शन Com_SendDynSignalWithMetaData [SWS_Com_91010] 📄 PDF
uint8 Com_SendDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16 Length, uint8* MetaDataPtr);
The service Com_ Send Dyn Signal With Meta Data updates the signal object identified by Signal Id wit h the signal referenced by the Signal Data Ptr parameter. The meta data is provided via the Meta Data Ptr parameter. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM
उपयोग और सिमेंटिक्स
फ़ंक्शन Com_SendDynSignalWithMetaData SignalId (प्रकार Com_SignalIdType) के माध्यम से पहचाने गए सिग्नल ऑब्जेक्ट को डायनेमिक लंबाई के सिग्नल डेटा और संबंधित मेटाडेटा [SWS_Com_91010] के साथ अतुल्यकालिक रूप से अपडेट करने का कार्य करता है। प्रेषित किए जाने वाले पेलोड को पॉइंटर SignalDataPtr (प्रकार void*) के माध्यम से संदर्भित किया जाता है, जबकि MetaDataPtr (प्रकार uint8*) मेटाडेटा को इंगित करता है [SWS_Com_91010]। पैरामीटर Length (प्रकार uint16) के माध्यम से, भेजे जाने वाले डायनेमिक सिग्नल की वास्तविक लंबाई पास की जाती है [SWS_Com_91010]।
रिटर्न मान और त्रुटि प्रबंधन
प्रकार uint8 का रिटर्न मान यह संकेत देता है कि सेवा स्वीकार कर ली गई थी या कौन सी त्रुटि मौजूद है [SWS_Com_91010]:
E_OK: सेवा कॉल प्रसंस्करण के लिए सफलतापूर्वक स्वीकार कर ली गई [SWS_Com_91010]।E_NOT_OK: पास किया गयाLengthइस सिग्नल के लिए कॉन्फ़िगर किए गएComSignalLengthसे अधिक है [SWS_Com_91010]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह को रोक दिया गया था या विकास त्रुटि के कारण कॉल विफल रही [SWS_Com_91010]।COM_BUSY: TP बफ़र वर्तमान में लॉक है, जिसके कारण सिग्नल नहीं भेजा जा सकता है [SWS_Com_91010]।
समवर्तीता और एकीकरण
समवर्तीता के संबंध में, फ़ंक्शन विभिन्न सिग्नलों के लिए पुनःप्रवेशी है, लेकिन समान सिग्नल के लिए पुनःप्रवेशी नहीं है [SWS_Com_91010]। इंटरफ़ेस का सर्विस ID 0x4e है और इसे मॉड्यूल Com में हेडर फ़ाइल Com.h के माध्यम से उपलब्ध कराया गया है [SWS_Com_91010]।
उपयोग नोट AUTOSAR रिलीज़ R20-11 के विनिर्देश तत्वों के आधार पर तैयार किया गया है।
फ़ंक्शन Data [SWS_Com_91011] 📄 PDF
uint8 Com_SendSignalGroupWithMetaData (Com_SignalGroupIdType SignalGroupId, uint8* MetaDataPtr);
The service Com_ Send Signal Group With Meta Data copies the content of the associated shadow buffer to the associated I - PDU. The meta data is provided via the Meta Data Ptr parameter.
फ़ंक्शन Com_SendSignalGroupWithMetaData (डेटा मॉडल में Data के रूप में संदर्भित) मेटाडेटा के साथ एक सिग्नल समूह को मॉड्यूल Com में अतुल्यकालिक रूप से संचारित करने का कार्य करता है [SWS_Com_91011]। कॉल किए जाने पर, सेवा संबंधित I-PDU में संबद्ध शैडो-बफ़र की वर्तमान सामग्री की प्रतिलिपि बनाती है, जहां मेटाडेटा पॉइंटर MetaDataPtr के माध्यम से प्रदान किया जाता है [SWS_Com_91011]।
स्थानांतरण पैरामीटरों में सिग्नल समूह का पहचानकर्ता (SignalGroupId) और मेटाडेटा का पॉइंटर (MetaDataPtr) शामिल हैं [SWS_Com_91011]। रिटर्न मान सेवा अनुरोध के परिणाम की रिपोर्ट करते हैं:
E_OK: सेवा सफलतापूर्वक स्वीकार कर ली गई [SWS_Com_91011]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह को रोक दिया गया था या निष्पादन विकास त्रुटि के कारण विफल रहा [SWS_Com_91011]।COM_BUSY: बड़े डेटा प्रकारों के ट्रांसमिशन के लिए TP बफ़र लॉक है [SWS_Com_91011]।
समवर्तीता के संबंध में, विभिन्न सिग्नलों के लिए कॉल पुनःप्रवेशी है, लेकिन समान समूह सिग्नल के लिए पुनःप्रवेशी नहीं है; पैरामीटर SignalGroupId के अनुरूप, यह संबंधित सिग्नल समूह को संदर्भित करना चाहिए [SWS_Com_91011]। प्रश्न Q-91171d77370ae50a (खुला) मॉड्यूल Com के साथ परस्पर क्रिया में, यह सेवा व्यक्तिगत सिग्नलों के प्रेषण जैसे कि Com_SendSignal [SWS_Com_00197] और Com_InvalidateSignalGroup [SWS_Com_00557] के माध्यम से सिग्नल समूहों को अमान्य करने का पूरक है। इसके अतिरिक्त, यह रिसेप्शन सेवा Com_ReceiveSignalWithMetaData [SWS_Com_91005] और PDU-आधारित प्रेषण कॉल Com_TriggerIPDUSendWithMetaData [SWS_Com_00858] से मेल खाती है।
यह उपयोग नोट विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन Com_SendSignalGroupArrayWithMetaData [SWS_Com_91012] 📄 PDF
uint8 Com_SendSignalGroupArrayWithMetaData (Com_SignalGroupIdType SignalGroupId, uint8* SignalGroupArrayPtr, uint8* MetaDataPtr);
The service Com_ Send Signal Group Array With Meta Data copies the content of the provided Signal Group Array Ptr to the associated I - PDU. The provided data shall c orrespond to the array representation of the signal group. The meta data is provi- ded via the Meta Data Ptr parameter.
उपयोग और पैरामीटर
फ़ंक्शन Com_SendSignalGroupArrayWithMetaData संबंधित मेटाडेटा सहित सिग्नल समूह को अतुल्यकालिक रूप से संचारित करने का कार्य करता है [SWS_Com_91012]। कॉल किए जाने पर, सेवा पास किए गए पॉइंटर SignalGroupArrayPtr की सामग्री को सीधे निर्दिष्ट I-PDU में कॉपी करती है [SWS_Com_91012]। प्रदान किए गए डेटा को अनिवार्य रूप से सिग्नल समूह के ऐरे प्रतिनिधित्व के अनुरूप होना चाहिए, जिसे प्रकार Com_SignalGroupIdType के पैरामीटर SignalGroupId के माध्यम से पहचाना जाता है [SWS_Com_91012]। सिग्नल समूह का अतिरिक्त मेटाडेटा पॉइंटर MetaDataPtr के माध्यम से संचार परत को दिया जाता है [SWS_Com_91012]।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन प्रकार uint8 का एक स्थिति मान लौटाता है, जो स्थानांतरण की सफलता या संबंधित त्रुटि कारण को दर्शाता है [SWS_Com_91012]:
E_OK: सेवा कॉल COM परत द्वारा सफलतापूर्वक स्वीकार कर ली गई थी [SWS_Com_91012]।COM_SERVICE_NOT_AVAILABLE: संबंधित I-PDU समूह रुका हुआ है या विकास त्रुटि के कारण कॉल विफल रही [SWS_Com_91012]।COM_BUSY: बड़े डेटा प्रकारों के प्रसंस्करण के लिए ट्रांसपोर्ट प्रोटोकॉल बफ़र (TP-Buffer) लॉक है [SWS_Com_91012]।
समवर्तीता और प्रतिबंध
विनिर्देश के अनुसार, सेवा को गैर-पुनःप्रवेशी (Non Reentrant) के रूप में वर्गीकृत किया गया है, जिसके कारण समवर्ती या बाधित करने वाले कॉल अस्वीकार्य हैं [SWS_Com_91012]। इंटरफ़ेस का सर्विस ID 0x50 है और इसे हेडर फ़ाइल Com.h के माध्यम से प्रदान किया जाता है [SWS_Com_91012]।
यह उपयोग निर्देश AUTOSAR स्पेसिफिकेशन स्थिति R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन Com_InvalidateSignal [SWS_Com_00203] 📄 PDF
uint8 Com_InvalidateSignal (Com_SignalIdType SignalId);
The service Com_ In validate Signal invalidates the signal with the given Signal Id by setting its value to its configured Com Signal Data Invalid Value.
फ़ंक्शन Com_InvalidateSignal संचार मॉड्यूल [SWS_Com_00203] में किसी सिग्नल को अमान्य घोषित करने का काम करता है। यह पास किए गए सिग्नल के मान को कॉन्फ़िगरेशन में संग्रहीत अमान्य मान पर सेट करता है Com Signal Data Invalid Value [SWS_Com_00203]। प्रसंस्करण असमकालिक रूप से होता है [SWS_Com_00203]। सिग्नल की पहचान करने के लिए इनपुट पैरामीटर SignalId को एकमात्र पैरामीटर के रूप में पास किया जाता है; कोई इनपुट/आउटपुट या आउटपुट पैरामीटर मौजूद नहीं हैं [SWS_Com_00203]।
रिटर्न मान के रूप में, कॉल प्रकार uint8 की एक स्थिति प्रदान करता है, जो स्वीकृति और त्रुटि व्यवहार को दर्शाता है [SWS_Com_00203]:
E_OK: अमान्यकरण सेवा (Invalidation-Service) सफलतापूर्वक स्वीकार कर ली गई थी [SWS_Com_00203]।COM_SERVICE_NOT_AVAILABLE: सेवा उपलब्ध नहीं है। ऐसा तब होता है जब संबंधित I-PDU समूह रोक दिया जाता है, यदि निर्दिष्टSignalIdके लिए कोईCom Signal Data Invalid Valueकॉन्फ़िगर नहीं किया गया है या यदि विकास त्रुटि के कारण निष्पादन विफल हो जाता है [SWS_Com_00203]।COM_BUSY: सेवा वर्तमान में निष्पादित नहीं की जा सकती क्योंकि TP बफ़र लॉक है [SWS_Com_00203]।
संगामिति के संबंध में, Com_InvalidateSignal समान सिग्नल के लिए गैर-पुनःप्रवेशी है, लेकिन विभिन्न सिग्नलों के लिए समानांतर और पुनःप्रवेशी रूप से निष्पादित किया जा सकता है [SWS_Com_00203]। सेवा को सर्विस-ID 0x10 के तहत घोषित किया गया है और यह हेडर Com.h के माध्यम से उपलब्ध है [SWS_Com_00203]।
यह उपयोग संबंधी निर्देश AUTOSAR CP R20-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_InvalidateSignalGroup [SWS_Com_00557] 📄 PDF
uint8 Com_InvalidateSignalGroup (Com_SignalGroupIdType SignalGroupId);
The service Co m_ Invalidate Signal Group invalidates all group signals of the signal group with the given Signal Group Id by setting their values to their configured Com Signal Data Invalid Values.
फ़ंक्शन Com_InvalidateSignalGroup का उपयोग पास किए गए सिग्नल समूह के सभी समूह सिग्नलों को उनके संबंधित कॉन्फ़िगर किए गए ComSignalDataInvalidValue मानों पर सेट करने और इस प्रकार सिग्नल समूह को अमान्य करने के लिए किया जाता है [SWS_Com_00557]।
उपयोग और सिमेंटिक्स
इनपुट पैरामीटर के रूप में, सेवा अमान्य किए जाने वाले सिग्नल समूह की ID (प्रकार Com_SignalGroupIdType का SignalGroupId) की अपेक्षा करती है [SWS_Com_00557]। कॉल को एसिंक्रोनस रूप से संसाधित किया जाता है और यह प्रकार uint8 का स्थिति मान लौटाता है [SWS_Com_00557]।
रिटर्न मान और त्रुटि प्रबंधन
निम्नलिखित रिटर्न मान निर्दिष्ट हैं [SWS_Com_00557]:
E_OK: अमान्यता का अनुरोध सफलतापूर्वक स्वीकार कर लिया गया।COM_SERVICE_NOT_AVAILABLE: सेवा उपलब्ध नहीं है क्योंकि संबंधित I-PDU समूह रुका हुआ है, किसी भी समूह सिग्नल के लिए कोईComSignalDataInvalidValueकॉन्फ़िगर नहीं किया गया है, या कॉल किसी विकास त्रुटि के कारण विफल हो जाती है।COM_BUSY: ट्रांसपोर्ट प्रोटोकॉल बफ़र (TP-Buffer) वर्तमान में लॉक है।
कन्करेंसी और रीएंट्रेंसी
यह फ़ंक्शन समान सिग्नल समूह के लिए reentrant नहीं है, लेकिन विभिन्न सिग्नल समूहों के लिए इसे समवर्ती (reentrant) रूप से कॉल किया जा सकता है [SWS_Com_00557]। इसका डिक्लेरेशन Com.h के माध्यम से उपलब्ध है [SWS_Com_00557]।
यह उपयोग नोट विशेष रूप से AUTOSAR CP R20-11 के विनिर्देश डेटा पर आधारित है।
फ़ंक्शन Com_TriggerIPDUSend [SWS_Com_00348] 📄 PDF
Std_ReturnType Com_TriggerIPDUSend (PduIdType PduId);
By a call to Com_ Trigger IPDUSend the I - PDU with the given ID is triggered for transmission.
सिंक्रोनस फ़ंक्शन Com_TriggerIPDUSend पैरामीटर PduId द्वारा पहचाने गए I-PDU के ट्रांसमिशन को ट्रिगर करता है [SWS_Com_00348]। यह हेडर Com.h के माध्यम से उपलब्ध है [SWS_Com_00348]।
कॉल की शर्तें और रिटर्न मान
कॉल ट्रांसमिशन को केवल तभी ट्रिगर करता है जब संबंधित I-PDU शुरू किया गया हो [SWS_Com_00861]। तदनुसार, प्रकार Std_ReturnType का रिटर्न मान I-PDU की स्थिति में अंतर करता है [SWS_Com_00348]:
E_OK: I-PDU को ट्रांसमिशन के लिए सफलतापूर्वक ट्रिगर किया गया था [SWS_Com_00348]।E_NOT_OK: I-PDU रोकी गई स्थिति में है, इसलिए ट्रांसमिशन ट्रिगर नहीं किया जा सका [SWS_Com_00348]।
बफर और समवर्ती व्यवहार
फ़ंक्शन को गैर-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_Com_00348]। बड़े I-PDUs के लिए एक बफरिंग तंत्र प्रदान किया गया है: यदि किसी बड़े I-PDU को Com_TriggerIPDUSend के माध्यम से ट्रिगर किया जाता है जबकि उसका बफर लॉक होता है, तो AUTOSAR COM ट्रांसमिशन अनुरोध को बफर करता है और बफर के पुनः उपलब्ध होने पर ही I-PDU को प्रसारित करता है [SWS_Com_00867]।
यह उपयोग संबंधी निर्देश AUTOSAR Classic R20-11 के विनिर्देश डेटा के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_TriggerIPDUSendWithMetaData [SWS_Com_00858] 📄 PDF
Std_ReturnType Com_TriggerIPDUSendWithMetaData (PduIdType PduId, const uint8* MetaData);
By a call to Com_ Trigger IPDUSend With Meta Data the AUTOSAR COM module updates its internal metadata for the I - PDU with the given ID by copying the metada- ta from the given position and with respect to length of the globally configured Meta Data Type of this I - PDU. Then the I - PDU is triggered for transmission.
फ़ंक्शन Com_TriggerIPDUSendWithMetaData का उपयोग किसी I-PDU के ट्रांसमिशन को सिंक्रोनस रूप से ट्रिगर करने और पहले AUTOSAR COM मॉड्यूल में उसके आंतरिक मेटाडेटा को अपडेट करने के लिए किया जाता है [SWS_Com_00858]। कॉल को पैरामीटर PduId के रूप में भेजी जाने वाली I-PDU के पहचानकर्ता और MetaData के साथ प्रदान किए जाने वाले मेटाडेटा के पॉइंटर की अपेक्षा होती है [SWS_Com_00858]। COM मॉड्यूल I-PDU के मेटाडेटा प्रकार की विश्व स्तर पर कॉन्फ़िगर की गई लंबाई को ध्यान में रखते हुए संदर्भित पते से डेटा को अपने आंतरिक डेटा स्टोरेज में कॉपी करता है और उसके तुरंत बाद ट्रांसमिशन को ट्रिगर करता है [SWS_Com_00858]।
[SWS_Com_00862] के अनुसार, COM मॉड्यूल को I-PDU का ट्रांसमिशन केवल तभी ट्रिगर करने की अनुमति है जब I-PDU प्रारंभ (started) स्थिति में हो। यदि, इसके विपरीत, I-PDU रुकी हुई (stopped) है, तो ट्रांसमिशन का ट्रिगर नहीं किया जाता है।
निष्पादन का परिणाम रिटर्न मान के माध्यम से संकेतित किया जाता है:
E_OK: I-PDU का ट्रांसमिशन सफलतापूर्वक ट्रिगर किया गया था [SWS_Com_00858]।E_NOT_OK: I-PDU रुकी हुई है; ट्रांसमिशन ट्रिगर नहीं किया जा सका [SWS_Com_00858]।
DET या DEM के लिए विशिष्ट त्रुटि कोड इस सेवा के लिए पेलोड में प्रलेखित नहीं हैं।
समवर्तीता (concurrency) के संबंध में, इंटरफ़ेस को नॉन-रीएंट्रेंट (Non Reentrant) के रूप में परिभाषित किया गया है [SWS_Com_00858], यही कारण है कि समानांतर कॉल को बाहर रखा जाना चाहिए या सिंक्रोनाइज़ किया जाना चाहिए। संभवतः यह कॉलर की ज़िम्मेदारी है कि वह पॉइंटर MetaData की वैधता और कॉन्फ़िगर की गई मेटाडेटा लंबाई के अनुसार पर्याप्त बफ़र आकार सुनिश्चित करे। प्रश्न Q-66c6abae0bbde275 (खुला)
यह उपयोग निर्देश AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_SwitchIpduTxMode [SWS_Com_00784] 📄 PDF
void Com_SwitchIpduTxMode (PduIdType PduId, booleanMode); ⚠️
The service Com_ Switch Ipdu Tx Mode sets the transmi ssion mode of the I - PDU refe- renced by Pdu Id to Mode. In case the transmission mode changes, the new mode shall immediately be effective (see SWS_ Com_00239). In case the requested transmission mode was already active for this I - PDU, the call will have no effect.
सिंक्रोनस इंटरफ़ेस Com_SwitchIpduTxMode का उपयोग किसी I-PDU के ट्रांसमिशन मोड को स्विच करने के लिए किया जाता है और इसे हेडर Com.h में Service-ID 0x27 के तहत निर्दिष्ट किया गया है [SWS_Com_00784]। संबंधित I-PDU का आइडेंटिफ़ायर (PduId) और बूलियन मान (Mode) के रूप में वांछित ट्रांसमिशन मोड पैरामीटर के रूप में पास किए जाते हैं; कोई रिटर्न मान या आउटपुट पैरामीटर मौजूद नहीं है [SWS_Com_00784]। यह कॉल निष्पादन के दौरान ट्रांसमिशन विशेषताओं को सिंक्रोनस और सीधे स्विच करता है [SWS_Com_00784]।
मोड परिवर्तन के प्रभावी होने के लिए विनिर्देश दो मामलों को परिभाषित करता है:
- यदि कॉल के कारण ट्रांसमिशन मोड बदलता है, तो संदर्भित I-PDU के लिए नया ऑपरेटिंग मोड तुरंत प्रभावी हो जाता है [SWS_Com_00784], [SWS_Com_00239]।
- यदि संबंधित I-PDU के लिए अनुरोधित ट्रांसमिशन मोड पहले से ही सक्रिय था, तो कॉल पूरी तरह से अप्रभावी रहता है [SWS_Com_00784]।
आगे के ट्रांसमिशन अनुक्रम के संबंध में, चक्रीय ट्रांसमिशन के साथ इंटरैक्शन पर निम्नलिखित लागू होता है: यदि किसी I-PDU का ट्रांसमिशन मोड स्पष्ट रूप से Com_SwitchIpduTxMode के माध्यम से सेट किया गया है, तो AUTOSAR COM मॉड्यूल उस I-PDU के बाद के चक्रीय ट्रांसमिशन को समय ऑफ़सेट ComTxModeTimeOffset से विलंबित करता है [SWS_Com_00881]।
समवर्तीता (concurrency) के संबंध में, फ़ंक्शन को विभिन्न I-PDU इंस्टैंस के लिए reentrant होने के लिए डिज़ाइन किया गया है [SWS_Com_00784]। इसके विपरीत, समान PduId के लिए समवर्ती या समानांतर कॉल को नॉन-reentrant के रूप में परिभाषित किया गया है और कॉलर द्वारा इसे रोका जाना चाहिए [SWS_Com_00784]।
यह उपयोग नोट विनिर्देश दस्तावेजों के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_TriggerTransmit [SWS_Com_00001] 📄 PDF
Std_ReturnType Com_TriggerTransmit (PduIdType TxPduId, PduInfoType* PduInfoPtr);
Within this API , the upper layer module (called module) shall check whether the available data fits into the buffer size reported by Pdu Info Ptr - >Sdu Length. If it fits, it shall copy its data into the buffer provided by Pdu Info Ptr - >Sdu Data Ptr and update the length of the actual copied data in Pdu Info Ptr - >Sdu Length. If not, it returns E_ NOT_ OK without changing Pdu Info Ptr.
सिंक्रोनस फ़ंक्शन [SWS_Com_00001] प्रेषित किए जाने वाले ट्रांसमिट-PDU (TxPduId) के SDU डेटा को कॉलर द्वारा प्रदान किए गए बफ़र में सिंक्रोनस रूप से प्राप्त करने और कॉपी करने का काम करता है। कॉलर इनपुट और आउटपुट पैरामीटर PduInfoPtr के माध्यम से लक्ष्य पता SduDataPtr और SduLength में अधिकतम उपलब्ध बफ़र क्षमता दोनों पास करता है। यदि SDU डेटा बफ़र में पूरी तरह से फिट बैठता है, तो इसे कॉपी किया जाता है, PduInfoPtr->SduLength को वास्तव में कॉपी किए गए बाइट्स की संख्या में अपडेट किया जाता है और सेवा E_OK के साथ सफलतापूर्वक समाप्त होती है [SWS_Com_00001]।
त्रुटि प्रबंधन और सीमा शर्तें
फ़ंक्शन निष्पादन को निरस्त कर देता है, कोई डेटा कॉपी नहीं करता है और E_NOT_OK लौटाता है, यदि निम्नलिखित स्थितियों में से कोई एक लागू होती है:
PduInfoPtr->SduLengthमें प्रदान किया गया बफ़र आकार वास्तविक PDU लंबाई [SWS_Com_00001], [SWS_Com_00869] से छोटा है। इस स्थिति मेंPduInfoPtrअपरिवर्तित रहता है [SWS_Com_00001]।- संबंधित I-PDU रोकी गई स्थिति में है [SWS_Com_00884]।
त्रुटि के मामले में (E_NOT_OK), कॉलर को पॉइंटर PduInfoPtr का मूल्यांकन या आगे उपयोग नहीं करना चाहिए, क्योंकि यह अमान्य डेटा को संदर्भित कर सकता है या एक NULL पॉइंटर का प्रतिनिधित्व कर सकता है [SWS_Com_00001]।
संगामिति
समवर्तीता के संबंध में, इंटरफ़ेस को विभिन्न PDU-IDs के लिए रीएंट्रेंट डिज़ाइन किया गया है, लेकिन इसे समान TxPduId के लिए समवर्ती रूप से कॉल नहीं किया जाना चाहिए [SWS_Com_00001]।
यह उपयोग निर्देश AUTOSAR स्पेसिफिकेशन के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_RxIndication [SWS_Com_00123] 📄 PDF
void Com_RxIndication (PduIdType RxPduId, const PduInfoType* PduInfoPtr);
Indication of a received PDU from a lower layer communication interface module.
फलन Com_RxIndication किसी अंतर्निहित संचार इंटरफ़ेस मॉड्यूल से AUTOSAR COM मॉड्यूल को प्राप्त PDU को संकेतित करने और स्थानांतरित करने का कार्य करता है [SWS_Com_00123]। फलन घोषणा हेडर फ़ाइल Com.h के माध्यम से प्रदान की जाती है और इसमें सर्विस ID 0x42 होती है [SWS_Com_00123]।
कॉल सिंक्रोनस सेमांटिक्स के साथ होती है और कोई वापसी मान नहीं लौटाती है (void) [SWS_Com_00123]। इंटरफ़ेस न तो इनपुट/आउटपुट पैरामीटर परिभाषित करता है और न ही केवल आउटपुट पैरामीटर, बल्कि विशेष रूप से दो इनपुट पैरामीटर परिभाषित करता है [SWS_Com_00123]:
RxPduId(डेटा प्रकारPduIdType): प्राप्त PDU के अद्वितीय पहचानकर्ता का प्रतिनिधित्व करता है [SWS_Com_00123]।PduInfoPtr(स्थिरPduInfoTypeका पॉइंटर): उस डेटा संरचना को संदर्भित करता है जिसमें प्राप्त PDU की लंबाई (SduLength), PDU डेटा वाले बफर का पॉइंटर (SduDataPtr) और संबंधित मेटाडेटा शामिल होता है [SWS_Com_00123]।
समवर्ती व्यवहार के संबंध में, Com_RxIndication को भिन्न PDU ID वाली कॉल्स के लिए पुन:प्रवेशी (reentrant) के रूप में परिभाषित किया गया है, लेकिन समान PDU ID के लिए स्पष्ट रूप से गैर-पुन:प्रवेशी (non-reentrant) के रूप में परिभाषित किया गया है [SWS_Com_00123]। Interpretation: डेटा सुसंगतता बनाए रखने के लिए अंतर्निहित संचार इंटरफ़ेस के कॉलिंग मॉड्यूल समान PDU ID के लिए समवर्ती कॉल्स को सिंक्रनाइज़ या क्रमबद्ध करने के लिए बाध्य हो सकते हैं। प्रश्न Q-f3b6194f96c15091 (खुला)
यह पाठ AUTOSAR Classic R20-11 विनिर्देश के आधार पर AI द्वारा जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_TpRxIndication [SWS_Com_00650] 📄 PDF
void Com_TpRxIndication (PduIdType id, Std_ReturnType result);
Called after an I - PDU has been received via the TP API, the result indicates whe- ther the transmission was successful or not.
जैसे ही TP API के माध्यम से I-PDU प्राप्त होता है, सिंक्रोनस सेवा फ़ंक्शन Com_TpRxIndication को कॉल किया जाता है [SWS_Com_00650]। यह AUTOSAR-COM मॉड्यूल को रिसेप्शन प्रक्रिया के पूरा होने और उसके परिणाम के बारे में सूचित करता है। प्रभावित I-PDU की पहचान पैरामीटर id के माध्यम से की जाती है, जबकि पैरामीटर result इंगित करता है कि ट्रांसमिशन सफल रहा या विफल रहा [SWS_Com_00650]। फ़ंक्शन का कोई रिटर्न मान नहीं है और इसे हेडर Com.h में सेवा ID 0x45 के साथ परिभाषित किया गया है [SWS_Com_00650]। कॉलर के रूप में, संभवतः एक अंतर्निहित ट्रांसपोर्ट लेयर जैसे PduR- या एक TP मॉड्यूल कार्य करता है। प्रश्न Q-d7006169cd162db4 (खुला)
त्रुटि प्रबंधन
यदि Com_TpRxIndication को पैरामीटर result के लिए परिणाम मान E_NOT_OK के साथ कॉल किया जाता है, तो COM मॉड्यूल प्राप्त बड़े I-PDU के सभी सिग्नलों को बिल्कुल अमान्य हो चुके सिग्नलों की तरह ही मानता है [SWS_Com_00838]। इस त्रुटि की स्थिति में मॉड्यूल सभी शामिल सिग्नलों और सिग्नल समूहों के लिए सभी कॉन्फ़िगर किए गए ComDataInvalidActions निष्पादित करता है [SWS_Com_00838]।
समवर्तीता और सीमांत शर्तें
फ़ंक्शन को रीएंट्रेंट के रूप में निर्दिष्ट किया गया है और यह सिंक्रोनस रूप से काम करता है [SWS_Com_00650]। इसलिए इसे विभिन्न I-PDUs के लिए समानांतर में कॉल किया जा सकता है, लेकिन इसे कॉलिंग इंस्टेंस के संदर्भ में बिना किसी देरी के संसाधित किया जाना चाहिए।
यह उपयोग निर्देश AUTOSAR स्पेसिफिकेशन R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_TxConfirmation [SWS_Com_00124] 📄 PDF
void Com_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);
The lower layer communication interface module confirms the transmission of a AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM PDU, or the failure to transmit a PDU.
सिंक्रोनस कॉलबैक फ़ंक्शन Com_TxConfirmation को हेडर Com.h के माध्यम से घोषित किया गया है और यह AUTOSAR-COM मॉड्यूल के केंद्रीय पुष्टिकरण इंटरफ़ेस के रूप में कार्य करता है [SWS_Com_00124]। इसके साथ एक अंतर्निहित संचार इंटरफ़ेस मॉड्यूल Com मॉड्यूल को PDU के सफल प्रसारण या ट्रांसमिशन प्रक्रिया की विफलता की रिपोर्ट करता है [SWS_Com_00124]।
कॉल संदर्भ और पैरामीटर
फ़ंक्शन को सिंक्रोनस रूप से निष्पादित किया जाता है, इसकी Service-ID 0x40 है और यह कोई रिटर्न मान नहीं देता है (void) [SWS_Com_00124]। यह दो इनपुट पैरामीटर की अपेक्षा करता है:
TxPduId(प्रकारPduIdType): PDU का विशिष्ट पहचानकर्ता, जिसका ट्रांसमिशन पूर्ण या विफल हो गया है [SWS_Com_00124]।result(प्रकारStd_ReturnType): ट्रांसमिशन प्रक्रिया की परिणाम स्थिति [SWS_Com_00124]। मानE_OKPDU के सफल संचरण की पुष्टि करता है, जबकिE_NOT_OKPDU ट्रांसमिशन की विफलता का संकेत देता है [SWS_Com_00124]।
समवर्तीता और प्रतिबंध
Com_TxConfirmation विभिन्न PDU-IDs के लिए रीएंट्रेंट है, लेकिन समान PDU-ID के लिए रीएंट्रेंट नहीं है [SWS_Com_00124]। व्याख्या: अंतर्निहित परत से कॉलर्स को अलग-अलग निष्पादन संदर्भों से समान TxPduId के साथ क्रमिक या बाधित करने वाले कॉल्स से बचना होगा, ताकि Com मॉड्यूल की आंतरिक प्रसंस्करण स्थिति सुसंगत बनी रहे। प्रश्न Q-146c1c92403b64fa (खुला)
त्रुटि प्रबंधन
विनिर्देश इस सेवा के लिए किसी विशिष्ट रिटर्न मान को परिभाषित नहीं करता है और कोई अलग DET या DEM त्रुटि संदेश प्रदर्शित नहीं करता है [SWS_Com_00124]। त्रुटिपूर्ण प्रसारण केवल पैरामीटर result के माध्यम से त्रुटि मान E_NOT_OK के साथ Com मॉड्यूल को प्रेषित किए जाते हैं [SWS_Com_00124]।
यह उपयोग नोट विनिर्देश AUTOSAR R20-11 के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_TpTxConfirmation [SWS_Com_00725] 📄 PDF
void Com_TpTxConfirmation (PduIdType id, Std_ReturnType result);
This function is called after the I - PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
उपयोग और सिमेंटिक्स
फ़ंक्शन Com_TpTxConfirmation को नेटवर्क पर एक I-PDU प्रसारित होने के बाद कॉल किया जाता है, ताकि COM मॉड्यूल को ट्रांसमिशन प्रक्रिया के परिणाम के बारे में सूचित किया जा सके [SWS_Com_00725]। PduIdType प्रकार के पैरामीटर id के माध्यम से प्रसारित I-PDU की पहचान की जाती है, जबकि Std_ReturnType प्रकार का result इंगित करता है कि ट्रांसमिशन सफल रहा या विफल रहा [SWS_Com_00725]। फ़ंक्शन का कोई रिटर्न मान नहीं होता है (void) और इसमें सिंक्रोनस निष्पादन सिमेंटिक्स होते हैं [SWS_Com_00725]। यह हेडर फ़ाइल Com.h के माध्यम से उपलब्ध है और इसकी सर्विस-ID 0x48 है [SWS_Com_00725]।
त्रुटि प्रबंधन
इस इंटरफ़ेस पर एरर ट्रांसमिशन विशेष रूप से पैरामीटर result के माध्यम से होता है, जो I-PDU ट्रांसफर की सफलता या विफलता को मैप करता है [SWS_Com_00725]। फ़ंक्शन विनिर्देश में विशिष्ट एरर कोड के साथ-साथ Default Error Tracer (DET) या Diagnostic Event Manager (DEM) मॉड्यूल को भेजे जाने वाले एरर संदेश नहीं दर्शाए गए हैं [SWS_Com_00725]।
समवर्तीता और सीमांत शर्तें
इंटरफ़ेस को रीएंट्रेंट के रूप में निर्दिष्ट किया गया है और इसलिए इसे समानांतर रूप से निष्पादित किया जा सकता है [SWS_Com_00725]। एक समय संबंधी बाधा के रूप में, यह कॉल नेटवर्क पर I-PDU का ट्रांसमिशन पूरा होने के बाद ही किया जा सकता है [SWS_Com_00725]। व्याख्या: नामकरण परंपरा और मॉड्यूल संरचना के कारण, कॉल आमतौर पर एक अंतर्निहित ट्रांसपोर्ट प्रोटोकॉल मॉड्यूल द्वारा शुरू किया जाना चाहिए। प्रश्न Q-8320e76ff63f62ce (खुला)
यह पाठ AUTOSAR R20-11 विनिर्देश पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)
फ़ंक्शन Com_StartReception [SWS_Com_00691] 📄 PDF
BufReq_ReturnType Com_StartOfReception (PduIdType id, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);
Service Com_StartReception.
सिंक्रोनस और reentrant फ़ंक्शन Com_StartReception (Com.h के माध्यम से उपलब्ध, Service-ID 0x46) को N-SDU के रिसेप्शन की शुरुआत में कॉल किया जाता है, जिसे सिंगल फ़्रेम (SF) के रूप में अनफ़्रेग्मेंटेड या बाद के Consecutive Frames (CF) के साथ First Frame (FF) के माध्यम से फ़्रेग्मेंटेड रूप में प्रेषित किया जाता है [SWS_Com_00691]।
पैरामीटर id के माध्यम से I-PDU की पहचान की जाती है और TpSduLength प्राप्त की जाने वाली N-SDU की कुल लंबाई निर्दिष्ट करता है [SWS_Com_00691]। पॉइंटर info पहले या अलग फ़्रेम के पेलोड और उपयोगी लंबाई के साथ-साथ संबद्ध मेटाडेटा को संदर्भित करता है; यदि न तो फ़्रेम डेटा और न ही मेटाडेटा उपलब्ध है, तो NULL_PTR पास किया जाता है [SWS_Com_00691]। आउटपुट पैरामीटर bufferSizePtr के माध्यम से फ़ंक्शन उपलब्ध बफ़र आकार प्रदान करता है, जिसका उपयोग ट्रांसपोर्ट प्रोटोकॉल मॉड्यूल Block Size (BS) निर्धारित करने के लिए करता है [SWS_Com_00691]। यदि इस सर्विस को 0 के TpSduLength के साथ कॉल किया जाता है, तो यह वर्तमान में अधिकतम उपलब्ध बफ़र आकार लौटाती है [SWS_Com_00691]।
अनुरोध का परिणाम BufReq_ReturnType के रूप में वापस किया जाता है [SWS_Com_00691]:
BUFREQ_OK: कनेक्शन स्वीकार कर लिया जाता है और रिसेप्शन जारी रहता है;bufferSizePtrउपलब्ध बफ़र को इंगित करता है या यदि अनुरोधित आकार में कोई बफ़र उपलब्ध नहीं है तो 0 का संकेत देता है [SWS_Com_00691]।BUFREQ_E_NOT_OK: कनेक्शन अस्वीकार कर दिया जाता है और रिसेप्शन निरस्त कर दिया जाता है;bufferSizePtrका मान अपरिवर्तित रहता है [SWS_Com_00691]।BUFREQ_E_OVFL: अनुरोधित लंबाई का कोई बफ़र उपलब्ध नहीं कराया जा सकता है, जिसके परिणामस्वरूप रिसेप्शन निरस्त हो जाता है;bufferSizePtrअपरिवर्तित रहता है [SWS_Com_00691]।
यह पाठ विनिर्देश AUTOSAR R20-11 के आधार पर AI द्वारा तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_CopyRxData [SWS_Com_00692] 📄 PDF
BufReq_ReturnType Com_CopyRxData (PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr);
Service Com_CopyRxData.
उपयोग और कॉल सिमेंटिक्स
सिंक्रोनस फ़ंक्शन Com_CopyRxData को किसी I-PDU सेगमेंट (N-PDU) के प्राप्त डेटा को ऊपरी लेयर में स्थानांतरित करने के लिए कॉल किया जाता है [SWS_Com_00692]। सेगमेंटेड ट्रांसमिशन के मामले में, इस इंटरफ़ेस का प्रत्येक क्रमिक कॉल संपूर्ण I-PDU डेटा का अगला भाग उपलब्ध कराता है [SWS_Com_00692]।
पैरामीटर और बफ़र प्रबंधन
id: प्राप्त I-PDU को विशिष्ट रूप से पहचानता है [SWS_Com_00692]।info:PduInfoTypeप्रकार की संरचना का पॉइंटर। यहSduDataPtrके माध्यम से सोर्स बफ़र का पॉइंटर औरSduLengthके माध्यम से कॉपी किए जाने वाले बाइट्स की संख्या पास करता है [SWS_Com_00692]।SduLengthके लिए0का विनिर्देश ऊपरी लेयर के वर्तमान में उपलब्ध बफ़र आकार को क्वेरी करने के लिए कार्य करता है; इस विशुद्ध क्वेरी स्थिति मेंSduDataPtrकोNULL_PTRपर सेट किया जा सकता है [SWS_Com_00692]।bufferSizePtr:PduLengthTypeप्रकार के वेरिएबल का पॉइंटर, जिसमें कॉपी ऑपरेशन के बाद प्राप्त बफ़र का शेष आकार लिखा जाता है [SWS_Com_00692]।
रिटर्न मान और विशेषताएँ
फ़ंक्शन प्रकार BufReq_ReturnType की स्थिति लौटाता है [SWS_Com_00692]:
BUFREQ_OK: डेटा सफलतापूर्वक डेस्टिनेशन बफ़र में कॉपी कर दिया गया था [SWS_Com_00692]।BUFREQ_E_NOT_OK: डेटा कॉपी करना विफल रहा क्योंकि कोई त्रुटि उत्पन्न हुई [SWS_Com_00692]।
इंटरफ़ेस की Service-ID 0x44 है, इसे reentrant के रूप में निर्दिष्ट किया गया है और यह हेडर Com.h के माध्यम से उपलब्ध है [SWS_Com_00692]।
यह पाठ AI द्वारा तैयार किया गया था और AUTOSAR मानक R20-11 पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_CopyTxData [SWS_Com_00693] 📄 PDF
BufReq_ReturnType Com_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);
Service Com_CopyTxData.
COM मॉड्यूल के ट्रांसमिशन बफर से किसी I-PDU के सेगमेंट (N-PDUs) के लिए ट्रांसमिशन डेटा को चरणबद्ध रूप से प्राप्त करने के लिए अंतर्निहित मॉड्यूल (जैसे ट्रांसपोर्ट प्रोटोकॉल) द्वारा सिंक्रोनस और रीएंट्रेंट फ़ंक्शन Com_CopyTxData को कॉल किया जाता है [SWS_Com_00693]।
उपयोग और पैरामीटर
प्रत्येक कॉल I-PDU डेटा का अगला भाग प्रदान करता है [SWS_Com_00693]:
id: प्रेषित किए जाने वाले I-PDU की पहचान करता है [SWS_Com_00693]।info:SduDataPtrके माध्यम से गंतव्य बफर औरSduLengthके माध्यम से कॉपी किए जाने वाले बाइट्स की संख्या निर्दिष्ट करता है।retryके माध्यम से स्थिति परिवर्तनों को संप्रेषित करने या उपलब्ध डेटा मात्रा को क्वेरी करने के लिए 0 की लंबाई अनुमत है; इस स्थिति मेंSduDataPtrएकNULL_PTRहो सकता है [SWS_Com_00693]।retry: भेजे गए डेटा की पुष्टि करता है या पुनर्संचरण (retransmissions) की शुरुआत करता है। यदिretryएकNULL_PTRहै, तो डेटा को कॉपी करने के तुरंत बाद बफर से हटाया जा सकता है। यदिretryएकRetryInfoTypeसंरचना की ओर इंगित करता है, तोTpDataStateबफर रखरखाव को नियंत्रित करता है:TP_CONFPENDINGत्रुटि निवारण के लिए बफर में डेटा छोड़ता है,TP_DATACONFकॉल से पहले कॉपी किए गए डेटा को हटाने के लिए पुष्टि करता है, औरTP_DATARETRYऑफ़सेटTxTpDataCntसे पहले पढ़े गए डेटा को फिर से कॉपी करता है [SWS_Com_00693]।availableDataPtr: ट्रांसमिशन बफर में उपलब्ध बाइट्स की शेष संख्या लौटाता है, जो उदाहरण के लिए गतिशील ट्रांसपोर्ट प्रोटोकॉल (जैसे FrIsoTp) को बाद के सेगमेंट आकारों को निर्धारित करने की अनुमति देता है [SWS_Com_00693]।
रिटर्न मान और त्रुटि प्रबंधन
फ़ंक्शन परिणाम BufReq_ReturnType के माध्यम से बफर अनुरोध की सफलता का संकेत देता है [SWS_Com_00693]:
BUFREQ_OK: अनुरोध के अनुसार डेटा पूरी तरह से गंतव्य बफर में कॉपी किया गया था [SWS_Com_00693]।BUFREQ_E_BUSY: अनुरोधित डेटा मात्रा ट्रांसमिशन बफर में उपलब्ध नहीं है। कोई डेटा कॉपी नहीं किया जाता है, और अंतर्निहित मॉड्यूल बाद के समय में कॉल दोहरा सकता है [SWS_Com_00693]।BUFREQ_E_NOT_OK: अनुरोध विफल रहा; कोई डेटा कॉपी नहीं किया गया [SWS_Com_00693]।
यह उपयोग नोट विनिर्देश AUTOSAR CP R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_MainFunctionRx [SWS_Com_00398] 📄 PDF
void Com_MainFunctionRx (void);
This function performs the processing of the AUTOSAR COM module's receive processing that are not directly handled within the COM's functions invoked by the PDU - R, for example Com_ Rx Indication. Per configured Com Main Function Rx instance one Com_ Main F unction Rx_
उपयोग
सिंक्रोनस फ़ंक्शन Com_MainFunctionRx उन प्रक्रियाओं के लिए AUTOSAR-COM मॉड्यूल के आंतरिक रिसेप्शन प्रसंस्करण को संभालता है जो सीधे PDU राउटर (PduR) द्वारा कॉल किए गए API (जैसे कि Com_RxIndication) के निष्पादन संदर्भ में संसाधित नहीं होते हैं [SWS_Com_00398]। इसमें न तो इनपुट और न ही आउटपुट पैरामीटर हैं और यह कोई रिटर्न मान नहीं देता है [SWS_Com_00398]। घोषणा हेडर SchM_Com.h के माध्यम से की जाती है; इसलिए कॉल संदर्भ संभवतः Schedule Manager (SchM) द्वारा समय-समय पर होना चाहिए [SWS_Com_00398]। प्रश्न Q-48d121e36f62c6de (खुला)
त्रुटि प्रबंधन और आरंभीकरण
यदि फ़ंक्शन को Com_Init के माध्यम से मॉड्यूल आरंभीकरण से पहले या Com_DeInit के कॉल के बाद निष्पादित किया जाता है, तो अधिकांश नियमित COM API के विपरीत कोई त्रुटि COM_E_UNINIT (0x02) उत्पन्न नहीं होती है, क्योंकि Com_MainFunctionRx को इससे स्पष्ट रूप से छूट दी गई है [SWS_Com_00804]। इस इंटरफ़ेस के लिए कोई विशिष्ट त्रुटि या रिटर्न कोड मौजूद नहीं हैं [SWS_Com_00398]।
समवर्ती और बहु-इंस्टेंस संचालन
निष्पादन संदर्भ और रीएंट्रेंसी के संबंध में, निम्नलिखित आवश्यकताएं लागू होती हैं [SWS_Com_00398]:
- रीएंट्रेंसी: फ़ंक्शन एक ही इंस्टेंस के लिए रीएंट्रेंट नहीं है, लेकिन इसे विभिन्न इंस्टेंस के लिए समानांतर में कॉल किया जा सकता है [SWS_Com_00398]।
- इंस्टेंस-विशिष्ट रूप: ECU कॉन्फ़िगरेशन में परिभाषित प्रत्येक कंटेनर
ComMainFunctionRxके लिए,Com_MainFunctionRx_<shortName>के रूप में एक स्वतंत्र फ़ंक्शन कार्यान्वित किया जाता है, जहाँ<shortName>कॉन्फ़िगरेशन कंटेनर के Short-Name से मेल खाता है [SWS_Com_00398]।
यह पाठ एक AI द्वारा तैयार किया गया था और अभिविन्यास के रूप में कार्य करता है। संदर्भित AUTOSAR विनिर्देश निर्णायक हैं।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_MainFunctionTx [SWS_Com_00399] 📄 PDF
void Com_MainFunctionTx (void);
This function performs the processing of the AUTOSAR COM module's transmissi- on activities that are not directly handled within the COM's function invoked by the AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM RTE, for example Com_ Send Signal. Per configured Com Main Function Tx instance one Com_ Main F unction Tx_
उपयोग और कार्यप्रणाली
फ़ंक्शन Com_MainFunctionTx AUTOSAR-COM मॉड्यूल की उन ट्रांसमिशन गतिविधियों को निष्पादित करता है जो RTE द्वारा कॉल किए गए COM फ़ंक्शनों (जैसे कि Com_SendSignal) के भीतर सीधे नियंत्रित नहीं होती हैं ([SWS_Com_00399])। निष्पादन सिंक्रोनस रूप से होता है। इसमें इनपुट, इनपुट/आउटपुट या आउटपुट पैरामीटर नहीं हैं और यह कोई रिटर्न मान नहीं देता है ([SWS_Com_00399])। इंटरफ़ेस SchM_Com.h के माध्यम से घोषित किया गया है; व्याख्या: इस हेडर संबद्धता के कारण, कॉल संदर्भ Schedule-Management (SchM) में होना चाहिए। प्रश्न Q-c33cfcf81700bcc5 (खुला)
ECU कॉन्फ़िगरेशन में Com Main Function Tx के प्रत्येक कॉन्फ़िगर किए गए कंटेनर के लिए, नामकरण योजना Com_MainFunctionTx_<shortName> के अनुसार एक विशिष्ट इंस्टेंस फ़ंक्शन लागू किया जाना चाहिए, जहाँ <shortName> कॉन्फ़िगरेशन कंटेनर के संक्षिप्त नाम (Short Name) से मेल खाता है ([SWS_Com_00399])।
समवर्तीता और प्रतिबंध
रीएंट्रेंसी के संबंध में, Com_MainFunctionTx को विभिन्न इंस्टेंस के लिए रीएंट्रेंट होने के लिए डिज़ाइन किया गया है, लेकिन इसे उसी इंस्टेंस के लिए रीएंट्रेंट रूप से कॉल नहीं किया जाना चाहिए ([SWS_Com_00399])।
त्रुटि प्रबंधन और आरंभीकरण स्थिति
[SWS_Com_00804] के अनुसार, Com_Init के माध्यम से आरंभीकरण से पहले या Com_DeInit के माध्यम से डी-इनिशियलाइज़ेशन के बाद COM सेवाओं को कॉल करने पर नियमित रूप से त्रुटि COM_E_UNINIT (0x02) उत्पन्न होती है। हालाँकि, Com_MainFunctionTx को इससे स्पष्ट रूप से छूट दी गई है और यह इन स्थितियों में ऐसी कोई आरंभीकरण त्रुटि उत्पन्न नहीं करता है ([SWS_Com_00804])।
यह पाठ कृत्रिम बुद्धिमत्ता (AI) द्वारा तैयार किया गया था और AUTOSAR विनिर्देश R20-11 पर आधारित है।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Signals [SWS_Com_00400] 📄 PDF
void Com_MainFunctionRouteSignals (void);
Calls the signal gateway part of the AUTOSAR COM module to forward received signals to be routed. Per configured Com Main Function Route Signals instance one Com_ Main Functi on Route Signals_
मुख्य फ़ंक्शन Com_MainFunctionRouteSignals (सेवा ID 0x1a) AUTOSAR-COM मॉड्यूल में सिग्नल अग्रेषण ([SWS_Com_00400]) के लिए केंद्रीय सिंक्रोनस इंटरफ़ेस के रूप में कार्य करता है। इसका कार्य COM मॉड्यूल के सिग्नल गेटवे भाग को कॉल करना है ताकि रूटिंग के लिए अभीष्ट प्राप्त सिग्नलों को उनके कॉन्फ़िगर किए गए गंतव्यों पर अग्रेषित किया जा सके ([SWS_Com_00400])।
कॉल और सिमेंटिक्स
पैरामीटर-रहित C इंटरफ़ेस का हस्ताक्षर void Com_MainFunctionRouteSignals(void) है ([SWS_Com_00400])। यह सिंक्रोनस रूप से निष्पादित होता है और इसमें इनपुट, इनपुट/आउटपुट या आउटपुट के लिए न तो पैरामीटर हैं और न ही कोई रिटर्न मान ([SWS_Com_00400])। मुख्य फ़ंक्शन की घोषणा हेडर फ़ाइल SchM_Com.h के माध्यम से प्रदान की जाती है ([SWS_Com_00400])। व्याख्या: SchM_Com.h के माध्यम से इस प्रावधान के कारण, टास्क संदर्भ में निर्धारित कॉल संभवतः BSW-Scheduler (SchM) द्वारा समय-समय पर किया जाना चाहिए। प्रश्न Q-0f0b57034d6d6bf1 (खुला)
इंस्टेंसिएशन और रीएंट्रेंसी
एकीकरण, नामकरण और समवर्तीता के लिए, [SWS_Com_00400] निम्नलिखित बाध्यकारी आवश्यकताओं को परिभाषित करता है:
- इंस्टेंस-विशिष्ट कार्यान्वयन: ECU कॉन्फ़िगरेशन में मौजूद कॉन्फ़िगरेशन कंटेनर
ComMainFunctionRouteSignalsके प्रत्येक इंस्टेंस के लिए, नामकरण योजनाCom_MainFunctionRouteSignals_<shortName>के अनुसार एक अलग फ़ंक्शन लागू किया जाना चाहिए ([SWS_Com_00400])। यहाँ<shortName>संबंधित कॉन्फ़िगरेशन कंटेनर के संक्षिप्त नाम के अनुरूप है। - रीएंट्रेंसी व्यवहार: विभिन्न इंस्टेंस के कॉल के लिए फ़ंक्शन रीएंट्रेंट है ([SWS_Com_00400])। हालाँकि, एक ही इंस्टेंस के लिए, यह स्पष्ट रूप से गैर-रीएंट्रेंट है और इसलिए इसे समवर्ती रूप से निष्पादित नहीं किया जाना चाहिए ([SWS_Com_00400])।
यह उपयोग निर्देश विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन Com_CbkTxAck [SWS_Com_00468] 📄 PDF
void Com_CbkTxAck (void);
This callback represents notification class 2 of [17]. It is called immediately after successful transmission of the I - PDU containing the message.
Com मॉड्यूल में कॉलबैक फ़ंक्शन Com_CbkTxAck किसी संदेश के सफल प्रेषण की अधिसूचना प्रदान करने के लिए कार्य करता है [SWS_Com_00468]। यह अधिसूचना वर्ग 2 (notification class 2) का प्रतिनिधित्व करता है और उस I-PDU के सफल ट्रांसमिशन के ठीक बाद कॉल किया जाता है, जिसमें संबंधित संदेश शामिल होता है [SWS_Com_00468]।
कॉल संदर्भ और इंटरफ़ेस विशेषताओं के लिए विनिर्देश के अनुसार निम्नलिखित आवश्यकताएं लागू होती हैं [SWS_Com_00468]:
- हस्ताक्षर और पैरामीटर: कॉलबैक फ़ंक्शन का हस्ताक्षर
void Com_CbkTxAck (void)है। यह न तो कोई इनपुट, इन/आउटपुट और न ही कोई आउटपुट पैरामीटर स्वीकार करता है तथा कोई रिटर्न मान वापस नहीं करता है [SWS_Com_00468]। - तुल्यकालिता: इस कॉल को तुल्यकालिक (Synchronous) के रूप में निर्दिष्ट किया गया है [SWS_Com_00468]।
- पुनःप्रवेश्यता: पुनःप्रवेश्यता व्यवहार को don't care के रूप में वर्गीकृत किया गया है [SWS_Com_00468]।
- कॉन्फ़िगरेशन: इंटरफ़ेस को कॉन्फ़िगर करने योग्य (configurable) घोषित किया गया है [SWS_Com_00468]। व्याख्या: कॉन्फ़िगरेशन टूल में कॉलबैक फ़ंक्शन के वास्तविक नाम को संदेश- अथवा सिग्नल-विशिष्ट रूप से पैरामीटरीकृत किए जाने की संभावना है। प्रश्न Q-3670b7b04fd7c74c (खुला)
विनिर्देश में इस तत्व के लिए विशिष्ट त्रुटि कोड, त्रुटि प्रतिक्रियाएं और DET या DEM को भेजे जाने वाले संदेश परिभाषित नहीं हैं [SWS_Com_00468]। अन्य कॉलों के संबंध में आगे की अनुक्रम शर्तें भी सूचीबद्ध नहीं हैं [SWS_Com_00468]।
यह पाठ AUTOSAR R20-11 पर आधारित एक AI द्वारा जनरेट किया गया था।
फ़ंक्शन Com_CbkTxErr [SWS_Com_00491] 📄 PDF
void Com_CbkTxErr (void);
This callback corresponds to notification class 4 of [17]. It is called in case the transmission is not possible because the corresponding I - PDU group is stopped.
कॉलबैक फ़ंक्शन Com_CbkTxErr को तुल्यकालिक रूप से तब कॉल किया जाता है जब ट्रांसमिशन संभव नहीं होता है, क्योंकि संबंधित I-PDU समूह रुका हुआ है [SWS_Com_00491]। यह अंतर्निहित विनिर्देशों के अनुसार अधिसूचना वर्ग 4 से मेल खाता है [SWS_Com_00491]।
कॉल और सिमेंटिक्स
- हस्ताक्षर और पैरामीटर: फ़ंक्शन में न तो इनपुट, इन/आउटपुट और न ही आउटपुट पैरामीटर (
void Com_CbkTxErr (void)) हैं तथा यह कोई रिटर्न मान वापस नहीं करता है [SWS_Com_00491]। - निष्पादन व्यवहार: कॉल तुल्यकालिक रूप से (“Synchronous”) किया जाता है, जबकि पुनःप्रवेश्यता के लिए “don't care” निर्दिष्ट है [SWS_Com_00491]।
- उपलब्धता: कॉलबैक इंटरफ़ेस कॉन्फ़िगर करने योग्य (“configurable”) है [SWS_Com_00491]।
त्रुटि प्रबंधन और परस्पर क्रिया
यह फ़ंक्शन विशेष रूप से रोके गए I-PDU समूह के कारण बाधित प्रेषण अनुरोध के त्रुटि मामले को कॉलिंग या उच्च स्तरीय परत को संकेत देने का काम करता है [SWS_Com_00491]। चूँकि कोई पैरामीटर पास नहीं किया जाता है, इसलिए प्रभावित सिग्नल या I-PDU का संदर्भ संभवतः कॉन्फ़िगरेशन या मॉड्यूल-विशिष्ट मैपिंग के माध्यम से पूर्वनिर्धारित होना चाहिए। प्रश्न Q-d7153324d2eb2995 (खुला)
यह उपयोग नोट विनिर्देश डेटा के आधार पर एक AI प्रणाली द्वारा स्वचालित रूप से उत्पन्न किया गया था।
फ़ंक्शन Com_CbkTxTOut [SWS_Com_00554] 📄 PDF
void Com_CbkTxTOut (void);
This callback corresponds to notification class 4 of [17]. It is called immediately after a message transmission error has been detected by the deadline monitoring mechanism.
उपयोग और कॉल संदर्भ
कॉलबैक फ़ंक्शन Com_CbkTxTOut एक सफल ट्रांसमिशन के अभाव के बारे में अधिसूचना इंटरफ़ेस के रूप में कार्य करता है। [SWS_Com_00554] के अनुसार, समय सीमा निगरानी तंत्र (deadline monitoring mechanism) द्वारा किसी संदेश की ट्रांसमिशन त्रुटि का पता लगाए जाने के ठीक बाद इसे कॉल किया जाता है। कॉल तुल्यकालिक रूप से होता है और अधिसूचना वर्ग 4 से मेल खाता है। चूँकि हस्ताक्षर void Com_CbkTxTOut(void) में न तो इनपुट और न ही रिटर्न मान हैं, उच्च स्तरीय परत को सिग्नलिंग बिना पैरामीटर के होती है।
समवर्तीता और कॉन्फ़िगरेशन
पुनःप्रवेश्यता के संबंध में, [SWS_Com_00554] के अनुसार फ़ंक्शन don't care के साथ निर्दिष्ट है। इसलिए संभवतः कॉल किए गए अनुप्रयोग सॉफ्टवेयर का यह दायित्व है कि यदि निगरानी घटनाएं समवर्ती रूप से आ सकती हैं, तो थ्रेड-सुरक्षा के लिए उपयुक्त उपाय किए जाएं। प्रश्न Q-793a6c18d81de85e (खुला) संचार मॉड्यूल में कॉलबैक फ़ंक्शन की उपलब्धता कॉन्फ़िगर करने योग्य है और इसे संबंधित निगरानी आवश्यकताओं के अनुसार अनुकूलित किया जाता है।
त्रुटि प्रबंधन
[SWS_Com_00554] में Com_CbkTxTOut के लिए कोई अलग DET या DEM त्रुटि संदेश और त्रुटि पावती के लिए कोई रिटर्न मान परिभाषित नहीं हैं। कॉलबैक का ट्रिगर होना ही समाप्त प्रेषण समय सीमा के प्रति त्रुटि प्रतिक्रिया का प्रतिनिधित्व करता है।
यह पाठ AUTOSAR विनिर्देश R20-11 के आधार पर AI द्वारा उत्पन्न किया गया था।
फ़ंक्शन Com_CbkRxAck [SWS_Com_00555] 📄 PDF
void Com_CbkRxAck (void);
This callback represents notification class 1 of [17]. It is called immediately after the message has been stored in the receiving message object.
कॉलबैक फ़ंक्शन Com_CbkRxAck AUTOSAR COM मॉड्यूल में कॉन्फ़िगर करने योग्य रिसेप्शन पावती के रूप में कार्य करता है और [17] के अनुसार अधिसूचना वर्ग 1 का प्रतिनिधित्व करता है [SWS_Com_00555]। COM मॉड्यूल इस कॉलबैक रूटीन को प्राप्त संदेश के निर्धारित रिसेप्शन संदेश ऑब्जेक्ट में सफलतापूर्वक रखे जाने और संग्रहीत किए जाने के तुरंत बाद कॉल करता है [SWS_Com_00555]।
उपयोग और कॉल संदर्भ
- तुल्यकालिक निष्पादन व्यवहार: फ़ंक्शन को तुल्यकालिक के रूप में निर्दिष्ट किया गया है [SWS_Com_00555]। इसे सीधे भंडारण प्रक्रिया के दौरान निष्पादित किया जाता है, जिससे COM मॉड्यूल का कॉलिंग संदर्भ कॉलबैक के निष्पादन की प्रतीक्षा करता है।
- पैरामीटर और रिटर्न मान: हस्ताक्षर
void Com_CbkRxAck (void)के अनुसार, कोई इनपुट पैरामीटर नहीं, कोई इन/आउटपुट पैरामीटर नहीं और कोई आउटपुट पैरामीटर पास नहीं किए जाते हैं [SWS_Com_00555]। इसके अतिरिक्त, फ़ंक्शन कॉलिंग मॉड्यूल को कोई रिटर्न मान वापस नहीं करता है [SWS_Com_00555]। - उपलब्धता: कॉल तंत्र सिस्टम के लिए एक कॉन्फ़िगर करने योग्य इंटरफ़ेस के रूप में उपलब्ध है [SWS_Com_00555]।
समवर्तीता और त्रुटि प्रबंधन
पुनःप्रवेश्यता के लिए गुण “don't care” निर्धारित किया गया है [SWS_Com_00555]। इसका अर्थ यह होना चाहिए कि COM विनिर्देश पुनःप्रवेशी कॉल के लिए कोई आवश्यकता नहीं रखता है और एक साथ होने वाली पहुंच के विरुद्ध सुरक्षा तंत्र उपयोगकर्ता की जिम्मेदारी है। प्रश्न (खुला) चूँकि DET या DEM के लिए न तो रिटर्न मान और न ही विशिष्ट त्रुटि कोड या त्रुटि संदेश परिभाषित हैं [SWS_Com_00555], इसलिए प्रसंस्करण के दौरान किसी भी त्रुटि को पूरी तरह से कॉलबैक फ़ंक्शन के भीतर स्थानीय रूप से संभाला जाना चाहिए।
यह पाठ विनिर्देश R20-11 के आधार पर एक AI द्वारा जनरेट किया गया था।
फ़ंक्शन Com_CbkRxTOut [SWS_Com_00556] 📄 PDF
void Com_CbkRxTOut (void);
This callback corresponds to notification class 3 of [17]. It is called immediately after a message reception error has been detected by the deadline monitoring mechanism.
उपयोग और सिमेंटिक्स
कॉलबैक फ़ंक्शन Com_CbkRxTOut अपेक्षित संदेश के न मिलने की सूचना देने का कार्य करता है। [SWS_Com_00556] के अनुसार, मॉड्यूल के डेडलाइन मॉनिटरिंग तंत्र द्वारा संदेश रिसेप्शन में त्रुटि का पता चलते ही इसे तुरंत कॉल किया जाता है। यह अधिसूचना रिपोर्टिंग वर्ग 3 (“notification class 3 of [17]”) से मेल खाती है और एक कॉन्फ़िगर करने योग्य इंटरफ़ेस के रूप में उपलब्ध है [SWS_Com_00556]।
कॉल बिना किसी इनपुट पैरामीटर और बिना रिटर्न मान (void Com_CbkRxTOut(void)) के तुल्यकालिक रूप से (Synchronous) होता है [SWS_Com_00556]। इस प्रकार यह फ़ंक्शन कॉल में सीधे संदर्भ डेटा प्रेषित किए बिना, कॉलिंग प्राप्तकर्ता या उच्च स्तरीय सॉफ्टवेयर परत को विशुद्ध रूप से टाइमआउट घटना का संकेत देता है।
समवर्तीता और प्रतिबंध
फ़ंक्शन की पुनःप्रवेश्यता के लिए विनिर्देश में don't care निर्धारित किया गया है [SWS_Com_00556]। चूँकि कॉल त्रुटि का पता चलने के तुरंत बाद और तुल्यकालिक रूप से होता है, कॉलबैक रूटीन का कार्यान्वयन संभवतः इस तरह से डिज़ाइन किया जाना चाहिए कि यह न्यूनतम ब्लॉकिंग के साथ चले, ताकि COM मॉड्यूल की डेडलाइन मॉनिटरिंग में अस्वीकार्य देरी न हो। प्रश्न Q-88055efc50f5843b (खुला)
यह पाठ एक AI द्वारा उत्पन्न किया गया था और एक दिशानिर्देश के रूप में कार्य करता है। संदर्भित AUTOSAR विनिर्देश आधिकारिक हैं।
फ़ंक्शन Com_CbkInv [SWS_Com_00536] 📄 PDF
void Com_CbkInv (void);
This callback function corresponds to SWS_ Com_00680. It is called after recepti- on of an invalid signal or signal group respectively.
कॉलबैक फ़ंक्शन Com_CbkInv AUTOSAR COM मॉड्यूल में त्रुटिपूर्ण या अमान्य संचार डेटा प्राप्त होने पर उच्च स्तरीय सॉफ्टवेयर परतों को सूचित करता है [SWS_Com_00536]। इसे अमान्य सिग्नल या अमान्य सिग्नल समूह प्राप्त होने के ठीक बाद कॉल किया जाता है और यह प्राप्तकर्ता को अमान्य सिग्नल मान की उपस्थिति के बारे में सूचित करता है [SWS_Com_00536]।
इंटरफ़ेस का हस्ताक्षर void Com_CbkInv(void) है, फलस्वरूप यह कोई इनपुट पैरामीटर स्वीकार नहीं करता है और कॉलर को कोई रिटर्न मान नहीं देता है [SWS_Com_00536]। कॉल तुल्यकालिक रूप से होता है, जबकि विनिर्देश में पुनःप्रवेश्यता व्यवहार को “don't care” के रूप में निर्दिष्ट किया गया है [SWS_Com_00536]। चूँकि प्रभावित सिग्नल की पहचान के लिए कोई पैरामीटर पास नहीं किया जाता है, इसलिए पहचानकर्ता Com_CbkInv संभवतः सिग्नल-विशिष्ट सूचनाओं के लिए एक कॉन्फ़िगर करने योग्य हस्ताक्षर टेम्पलेट के रूप में कार्य करता है। प्रश्न Q-6e02e6bcf324eb93 (खुला)
एकीकरण और सिस्टम व्यवहार के संबंध में निम्नलिखित सीमा शर्तें लागू होती हैं:
- फ़ंक्शन का प्रावधान कॉन्फ़िगर करने योग्य है, जिससे आवश्यकतानुसार प्रति सिग्नल या सिग्नल समूह अधिसूचना को सक्रिय किया जा सकता है [SWS_Com_00536]।
- तकनीकी रूप से, फ़ंक्शन COM मॉड्यूल में प्राप्त सिग्नलों के अमान्यकरण प्रबंधन के लिए आवश्यकता
SWS_Com_00680से मेल खाता है [SWS_Com_00536]। - इस इंटरफ़ेस के लिए विशिष्ट त्रुटि प्रबंधन दिनचर्या, त्रुटि कोड या विकास अथवा डायग्नोस्टिक मॉड्यूल जैसे DET या DEM को भेजे जाने वाले त्रुटि संदेश निर्दिष्ट नहीं हैं [SWS_Com_00536]।
यह उपयोग नोट विनिर्देश डेटा के आधार पर स्वचालित रूप से जनरेट किया गया था।
फ़ंक्शन Com_CbkCounterErr [SWS_Com_00726] 📄 PDF
void Com_CbkCounterErr (PduIdType ComPduId, uint8 ExpectedCounter, uint8 ReceivedCounter);
This function is called immediately, if the AUTOSAR COM module receives an I - PDU counter that differs from the expected one. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM
कॉन्फ़िगर करने योग्य कॉलबैक फ़ंक्शन Com_CbkCounterErr [SWS_Com_00726] के अनुसार I-PDU काउंटर मॉनिटरिंग में त्रुटियों को संकेत देने का काम करता है। यह AUTOSAR COM मॉड्यूल द्वारा तुरंत और सिंक्रोनस रूप से कॉल किया जाता है जब किसी प्राप्त I-PDU में ऐसा काउंटर मान पाया जाता है जो अपेक्षित काउंटर मान से मेल नहीं खाता है। यह संदेश प्राप्ति पर अनुक्रम त्रुटियों की शीघ्र पहचान को सक्षम बनाता है।
इंटरफ़ेस का कोई रिटर्न मान नहीं है (void) और कॉल किए जाने पर एरर विश्लेषण के लिए तीन इनपुट पैरामीटर पास करता है ([SWS_Com_00726]):
ComPduId(PduIdType): प्रभावित I-PDU का आइडेंटिफ़ायर, जिसमें काउंटर त्रुटि उत्पन्न हुई है।ExpectedCounter(uint8): COM मॉड्यूल द्वारा अपेक्षित I-PDU का काउंटर मान।ReceivedCounter(uint8): प्राप्त संदेश में वास्तव में पाया गया काउंटर मान।
समवर्तीता के संबंध में, विनिर्देश में फ़ंक्शन की रीएंट्रेंसी को "don't care" घोषित किया गया है ([SWS_Com_00726])। [SWS_Com_00726] में इस इंटरफ़ेस के लिए विशिष्ट DET या DEM एरर संदेश निर्दिष्ट नहीं हैं। चूंकि कॉलबैक फ़ंक्शन को कॉन्फ़िगर करने योग्य के रूप में परिभाषित किया गया है, इसलिए इसे संभवतः ट्रांसमिशन त्रुटियों या पैकेट हानि पर एप्लिकेशन-विशिष्ट प्रतिक्रिया देने के लिए एप्लिकेशन जैसी उच्च स्तर की परत में लागू किया जाएगा। व्याख्या: चूंकि कॉल COM प्राप्ति प्रसंस्करण के संदर्भ में तुरंत और सिंक्रोनस रूप से होता है ([SWS_Com_00726]), इसलिए कॉल किए गए रूटीन को कोई ब्लॉकिंग ऑपरेशन नहीं करना चाहिए। प्रश्न Q-a745eb5416fc156b (खुला)
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर एक AI द्वारा उत्पन्न किया गया था।
फ़ंक्शन Com_CbkTxPrep [SWS_Com_91013] 📄 PDF
void Com_CbkTxPrep (void);
This callback function indicates that the signals/ signal groups of a dedicated Com_ Main Function Tx instance will now be prepared for transmission.
कॉलबैक फ़ंक्शन Com_CbkTxPrep इस बात की अधिसूचना के रूप में कार्य करता है कि Com_MainFunctionTx के एक समर्पित इंस्टेंस के सिग्नल या सिग्नल समूह अब ट्रांसमिशन के लिए तैयार किए जा रहे हैं [SWS_Com_91013]। फ़ंक्शन का निष्पादन कॉल करने वाले इंस्टेंस के सिंक्रोनस होता है [SWS_Com_91013]। इसके सिग्नेचर void Com_CbkTxPrep(void) के अनुसार, यह न तो इनपुट पैरामीटर स्वीकार करता है और न ही इनपुट और आउटपुट पैरामीटर या आउटपुट पैरामीटर, और इसका कोई रिटर्न मान नहीं होता है [SWS_Com_91013]।
इंटरफ़ेस का प्रावधान एक कॉन्फ़िगरेशन के माध्यम से उपलब्ध होता है [SWS_Com_91013]। यदि कॉन्फ़िगरेशन पैरामीटर ComPreparationNotification कॉन्फ़िगर किया गया है, तो संबंधित MainFunctionTx के भीतर संबंधित फ़ंक्शन Com_CbkTxPrep को कॉल किया जाना चाहिए [SWS_Com_00886]। इस प्रक्रिया में, एक निश्चित समय अनुक्रम स्थिति का कड़ाई से पालन किया जाना चाहिए: Tx मुख्य फ़ंक्शन के भीतर I-PDUs का वास्तविक प्रसंस्करण शुरू होने से पहले कॉल पूरी तरह से होना चाहिए [SWS_Com_00886]।
समवर्तीता व्यवहार और संभावित सीमाओं के संबंध में, Com_CbkTxPrep को गैर-रीएंट्रेंट (Non Reentrant) के रूप में निर्दिष्ट किया गया है [SWS_Com_91013]। कॉल संदर्भ MainFunctionTx के संबंधित इंस्टेंस के निष्पादन से दृढ़ता से जुड़ा हुआ है [SWS_Com_91013]। चूंकि कॉलबैक को I-PDU प्रसंस्करण शुरू होने से ठीक पहले निष्पादित किया जाना चाहिए, इसलिए फ़ंक्शन सिंक्रोनस रूप से संबंधित ट्रांसमिट रूटीन में एकीकृत होता है [SWS_Com_00886]।
यह उपयोग नोट AUTOSAR विनिर्देश R20-11 के आधार पर स्वचालित रूप से जनरेट किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
फ़ंक्शन Com_RxIpduCallout [SWS_Com_00700] 📄 PDF
boolean Com_RxIpduCallout (PduIdType PduId, const PduInfoType* PduInfoPtr);
The I - PDU callout on receiver side can be configured to implement user - defined receive filtering mechanisms.
फ़ंक्शन Com_RxIpduCallout रिसीवर साइड पर एक कॉन्फ़िगर करने योग्य कॉलआउट है, जो I-PDUs के लिए उपयोगकर्ता-विशिष्ट रिसीव फ़िल्टरिंग तंत्र को लागू करने का काम करता है [SWS_Com_00700]। इसका निष्पादन सिंक्रोनस होता है, और रीएंट्रेंसी के संबंध में इंटरफ़ेस को don't care के रूप में निर्दिष्ट किया गया है [SWS_Com_00700]।
कॉल को प्राप्त PDU का आइडेंटिफ़ायर और डेटा पास किया जाता है [SWS_Com_00700]:
PduId: प्राप्त I-PDU का आइडेंटिफ़ायर [SWS_Com_00700]।PduInfoPtr: एकPduInfoTypeसंरचना का पॉइंटर, जो प्राप्त I-PDU की लंबाई (SduLength) और पेलोड डेटा (SduDataPtr) का पॉइंटर प्रदान करता है [SWS_Com_00700]।
डेटा प्रावधान के संबंध में, [SWS_Com_00816] की आवश्यकता है कि AUTOSAR COM मॉड्यूल प्राप्त I-PDU के सभी डेटा को Com_RxIpduCallout पर पूरी तरह से अग्रेषित करे, ठीक वैसे ही जैसे वे PDU राउटर लेयर (PduR) द्वारा प्रदान किए गए थे।
बूलियन रिटर्न मान के माध्यम से कॉलआउट COM मॉड्यूल में I-PDU के बाद के प्रसंस्करण को नियंत्रित करता है [SWS_Com_00700]:
true: प्राप्त I-PDU को सामान्य रूप से आगे संसाधित किया जाता है [SWS_Com_00700]।false: I-PDU को आगे संसाधित नहीं किया जाता है और इस प्रकार इसे डिस्कार्ड कर दिया जाता है [SWS_Com_00700]।
इस कॉलआउट के लिए विनिर्देश में विशिष्ट एरर कोड, फ़ीडबैक कोड स्थिरांक या DET और DEM संदेश प्रदान नहीं किए गए हैं [SWS_Com_00700]।
नोट: यह उपयोग नोट AUTOSAR R20-11 विनिर्देश के आधार पर एक AI प्रणाली द्वारा स्वचालित रूप से तैयार किया गया था।
फ़ंक्शन Com_TxIpduCallout [SWS_Com_00346] 📄 PDF
boolean Com_TxIpduCallout (PduIdType PduId, PduInfoType* PduInfoPtr);
The I - PDU callout on sender side can be configured for example to implement user - defined transmission filtering or user - defined pre - transmission - processing of the outgoing I - PDU.
फ़ंक्शन Com_TxIpduCallout प्रेषक पक्ष पर एक कॉन्फ़िगर करने योग्य कॉलआउट के रूप में कार्य करता है और आउटगोइंग I-PDU के उपयोगकर्ता-विशिष्ट प्री-प्रोसेसिंग या ट्रांसमिशन फ़िल्टरिंग करने के लिए सिंक्रोनस रूप से कॉल किया जाता है [SWS_Com_00346]।
पैरामीटर और रिटर्न मान
PduId(in): प्रेषित किए जाने वाले I-PDU का पहचानकर्ता पास करता है [SWS_Com_00346]।PduInfoPtr(inout): इसमें पेलोड लंबाई (SduLength) के साथ-साथ I-PDU के पेलोड (SduDataPtr) का एक पॉइंटर शामिल होता है [SWS_Com_00346]। इसका उपयोग भेजने से पहले I-PDU डेटा का निरीक्षण या संशोधन करने के लिए किया जा सकता है।- रिटर्न मान (
boolean): I-PDU के आगे के प्रसंस्करण को नियंत्रित करता है [SWS_Com_00346]।trueका रिटर्न मान I-PDU के नियमित प्रेषण का कारण बनता है, जबकिfalseकिसी भी आगे के प्रसंस्करण और इस प्रकार ट्रांसमिशन को रद्द कर देता है [SWS_Com_00346]।
समवर्तीता और कॉन्फ़िगरेशन
कॉलआउट की सेवा ID 0x29 है और इसकी रीएंट्रेंसी को विनिर्देश में \"don't care\" के रूप में परिभाषित किया गया है [SWS_Com_00346]। व्याख्या: चूंकि रीएंट्रेंसी अप्रतिबंधित है, इसलिए ट्रिगर करने वाले ट्रांसमिशन कार्य के आधार पर कॉल विभिन्न टास्क संदर्भों में हो सकते हैं, यही कारण है कि साझा संसाधनों के मामले में उपयोगकर्ता-पक्ष कार्यान्वयन थ्रेड-सुरक्षित होना चाहिए। प्रश्न Q-3ce35701879bb60c (खुला)
यह पाठ स्वचालित रूप से बनाया गया था। सभी जानकारी विशेष रूप से AUTOSAR विनिर्देश स्थिति R20-11 पर आधारित है।
टाइप Com_StatusType [SWS_Com_00819] 📄 PDF
This is a status value returned by the API service Com_ Get Status().
गणना प्रकार Com_StatusType AUTOSAR COM मॉड्यूल के लिए स्थिति मान को परिभाषित करता है और हेडर फ़ाइल Com.h के माध्यम से प्रदान किया जाता है [SWS_Com_00819]। यह प्रकार API सर्विस Com_GetStatus() के रिटर्न मान के रूप में कार्य करता है, जिसके साथ कॉल करने वाले संचार मॉड्यूल की वर्तमान इनिशियलाइज़ेशन और परिचालन स्थिति की क्वेरी कर सकते हैं [SWS_Com_00819]।
Com_StatusType का निर्दिष्ट मान दायरा ठीक दो स्थितियों के बीच अंतर करता है [SWS_Com_00819]:
COM_UNINIT: इंगित करता है कि AUTOSAR COM मॉड्यूल इनिशियलाइज़ नहीं है या उपयोग करने योग्य नहीं है [SWS_Com_00819]। इस स्थिति का संख्यात्मक मान अनिवार्य रूप से0x00(या मान0) होता है और सिस्टम रीसेट के तुरंत बाद बाध्यकारी डिफ़ॉल्ट मान बनाता है [SWS_Com_00819]।COM_INIT: संकेत देता है कि AUTOSAR COM मॉड्यूल ठीक से इनिशियलाइज़ किया गया है और इस प्रकार संचालन के लिए तैयार और उपयोग करने योग्य है [SWS_Com_00819]।
कॉल करने वाले सॉफ़्टवेयर के लिए, इस रिटर्न मान का मूल्यांकन संचार मॉड्यूल के उपयोग से पहले उसकी परिचालन तत्परता की जाँच करने का काम करता है [SWS_Com_00819]। जब तक सर्विस Com_GetStatus() मान COM_UNINIT लौटाती है, तब तक COM मॉड्यूल को गैर-इनिशियलाइज़्ड या अनुपयोगी माना जाता है [SWS_Com_00819]। केवल जब स्थिति मान COM_INIT दिखाती है, तो मॉड्यूल इनिशियलाइज़्ड और संचालन के लिए तैयार होता है [SWS_Com_00819]। इस गणना प्रकार के लिए आगे कोई एरर कोड या रिटर्न मान निर्दिष्ट नहीं हैं [SWS_Com_00819]।
यह उपयोग नोट विनिर्देश के आधार पर स्वचालित रूप से तैयार किया गया था।
इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)
टाइप Com_SignalIdType [SWS_Com_00820] 📄 PDF
The AUTOSAR COM module's signal object identifier.
टाइप Com_SignalGroupIdType [SWS_Com_00821] 📄 PDF
The AUTOSAR COM module's signal group object identifier.
टाइप Com_IpduGroupIdType [SWS_Com_00822] 📄 PDF
The AUTOSAR COM I - PDU module's group object identifier.
टाइप Com_ConfigType [SWS_Com_00825] 📄 PDF
This is the type of the data structure containing the initialization data for COM.
Request a governed re-review of this record. The record is not changed immediately.
- Record
AUTOSAR/AP/record/CP_MOD_Com- Status
- unspecified
- Version
AUTOSAR/AP/record/CP_MOD_Com@rel:R20-11#f0f2bc33- Content hash
f0f2bc33- Source
- https://www.autosar.org/fileadmin/standards/R20-11/CP/AUTOSAR_SWS_COM.pdf#nameddest=SWS_Com_00432
gemini-3.8-flash-low· 2026-10-13 · जर्मन मूल