💡 🍅 🍏 RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 17 इवेंट फ़्लैग समूह: परिचय और बुनियादी सेवाएँ 🧖🏻 💇🏾 👨🏽‍🔧

इवेंट फ्लैग का उपयोग करना

न्यूक्लियस एसई में, घटना के झंडे को निर्माण चरण के दौरान परिभाषित किया जाता है। अनुप्रयोग में इवेंट फ़्लैग समूहों की अधिकतम संख्या 16 है। यदि ईवेंट फ़्लैग समूहों को परिभाषित नहीं किया जाता है, तो ईवेंट फ़्लैग समूहों की डेटा संरचनाओं और सेवा कॉल से संबंधित कोड को एप्लिकेशन में शामिल नहीं किया जाएगा।

इवेंट फ्लैग का समूह - आठ बिट्स फ्लैग का एक सेट, जिस तक पहुंच को विनियमित किया जाता है ताकि कई कार्य सुरक्षित रूप से एक ध्वज का उपयोग कर सकें। एक कार्य ईवेंट फ़्लैग के किसी भी संयोजन को सेट या साफ़ कर सकता है। एक अन्य कार्य किसी भी समय झंडे के एक समूह को पढ़ना है, और यह झंडे के एक निश्चित अनुक्रम के लिए भी इंतजार कर सकता है (पोल द्वारा या विराम के साथ)।

इवेंट फ़्लैग समूहों को कॉन्फ़िगर करना

ईवेंट ध्वज समूहों की संख्या

अधिकांश न्यूक्लियस एसई ऑब्जेक्ट्स के साथ, इवेंट फ्लैग ग्रुप्स का कॉन्फ़िगरेशन nde_config.h में #define निर्देशों द्वारा निर्दिष्ट किया गया है। मुख्य पैरामीटर NUSE_EVENT_GROUP_NUMBER है , जो निर्धारित करता है कि एप्लिकेशन में इवेंट फ़्लैग के कितने समूह परिभाषित किए जाएंगे। डिफ़ॉल्ट रूप से, यह पैरामीटर 0 पर सेट होता है (यानी, इवेंट फ़्लैग के समूहों का उपयोग नहीं किया जाता है) और 16 तक का कोई भी मान हो सकता है। एक गलत मान एक संकलन त्रुटि को जन्म देगा, जिसे nuse_config_check.h में चेक करके उत्पन्न किया जाएगा (यह nuse_config.c द्वारा सक्षम है ) , जिसका अर्थ है कि यह इस मॉड्यूल के साथ संकलित करता है), परिणामस्वरूप, #error निर्देश काम करेगा। नॉनज़ेरो वैल्यू का चयन करना इवेंट फ़्लैग ग्रुप के मुख्य कार्यकर्ता के रूप में कार्य करता है। डेटा संरचनाओं को परिभाषित करते समय इस पैरामीटर का उपयोग किया जाता है और उनका आकार इसके मूल्य (निम्नलिखित लेखों में इसके बारे में अधिक) पर निर्भर करता है। इसके अलावा, एक नॉनजरो मान एपीआई सेटिंग्स को सक्रिय करता है।

एपीआई कॉल को सक्रिय करें

नाभिक एसई में प्रत्येक एपीआई फ़ंक्शन (उपयोगिता कॉल) nuse_config.h में #define निर्देश द्वारा सक्रिय होता है। इवेंट फ़्लैग के समूहों के लिए, इनमें शामिल हैं:

NUSE_EVENT_GROUP_SET
NUSE_EVENT_GROUP_RETRIEVE
NUSE_EVENT_GROUP_INFORMATION
NUSE_EVENT_GROUP_COUNT

डिफ़ॉल्ट रूप से, वे FALSE पर सेट होते हैं, इस प्रकार प्रत्येक सेवा कॉल को अक्षम कर देते हैं और उन्हें लागू करने वाले कोड को शामिल करने से रोकते हैं। ईवेंट फ़्लैग के समूहों को कॉन्फ़िगर करने के लिए, आपको आवश्यक API कॉल का चयन करना होगा और TRUE के अनुरूप निर्देशों को सेट करना होगा।

निम्नलिखित डिफ़ॉल्ट nuse_config.h फ़ाइल का एक अंश है।

 #define NUSE_EVENT_GROUP_NUMBER 0 /* Number of event groups in the system - 0-16 */ #define NUSE_EVENT_GROUP_SET FALSE /* Service call enabler */ #define NUSE_EVENT_GROUP_RETRIEVE FALSE /* Service call enabler */ #define NUSE_EVENT_GROUP_INFORMATION FALSE /* Service call enabler */ #define NUSE_EVENT_GROUP_COUNT FALSE /* Service call enabler */

एक सक्रिय API फ़ंक्शन यदि अनुप्रयोग में कोई ईवेंट फ़्लैग समूह नहीं हैं, तो संकलन त्रुटि ( NUSE_Event_Group_Count () , जो हमेशा सक्षम है) को छोड़कर जाएगी । यदि आपका कोड API कॉल का उपयोग करता है जिसे सक्रिय नहीं किया गया है, तो एक लेआउट त्रुटि उत्पन्न होगी क्योंकि कार्यान्वयन कोड को एप्लिकेशन में शामिल नहीं किया गया था।

इवेंट कॉल यूटिलिटी कॉल्स

न्यूक्लियस आरटीओएस सात उपयोगिता कॉल का समर्थन करता है जो निम्नलिखित कार्यक्षमता प्रदान करते हैं:

इवेंट फ्लैग सेट करें। न्यूक्लियस एसई NUSE_Event_Group_Set () फ़ंक्शन में कार्यान्वित किया जाता है।
ईवेंट झंडे पढ़ना। न्यूक्लियस एसई में, NUSE_Event_Group_Retrieve () में लागू किया गया।
घटना के झंडे के एक विशिष्ट समूह के बारे में जानकारी प्रदान करना। न्यूक्लियस एसई में, NUSE_Event_Group_Information () में लागू किया गया।
अनुप्रयोग में वर्तमान में कॉन्फ़िगर किए गए इवेंट फ़्लैग समूहों की संख्या लौटाता है। न्यूक्लियस एसई में, NUSE_Event_Group_Count () में लागू किया गया।
अनुप्रयोग में ईवेंट फ़्लैग का एक नया समूह जोड़ना। न्यूक्लियस एसई को लागू नहीं किया जाता है।
अनुप्रयोग से इवेंट फ़्लैग के समूह को निकालना। न्यूक्लियस एसई को लागू नहीं किया जाता है।
आवेदन में घटना के झंडे के सभी समूहों के लिए रिटर्निंग पॉइंटर्स। न्यूक्लियस एसई को लागू नहीं किया जाता है।

इन प्रत्येक ओवरहेड कॉल के कार्यान्वयन पर नीचे विस्तार से चर्चा की गई है।

यह ध्यान देने योग्य है कि न्यूक्लियस आरटीओएस या न्यूक्लियस एसई में कोई रीसेट फ़ंक्शन नहीं है। यह जानबूझकर किया जाता है। रीसेट फ़ंक्शन का तात्पर्य झंडे की विशेष स्थिति के प्रसार से है। ईवेंट फ़्लैग के समूहों के लिए, एकमात्र "विशेष" स्थिति सभी फ़्लैग को रीसेट करने के लिए है, जिसे NUSE_Event_Group_Set () का उपयोग करके किया जा सकता है।

इवेंट फ़्लैग समूहों को सेट करने और पढ़ने के लिए सेवा कॉल

घटना के झंडे के समूह पर किए जाने वाले मूलभूत संचालन एक या अधिक झंडे का मूल्य निर्धारित कर रहे हैं, साथ ही साथ वर्तमान ध्वज मूल्यों को भी पढ़ रहे हैं। न्यूक्लियस आरटीओएस और न्यूक्लियस एसई इन ऑपरेशनों के लिए चार बुनियादी एपीआई कॉल प्रदान करते हैं।

चूंकि घटना के झंडे बिट्स होते हैं, इसलिए उन्हें बाइनरी नंबर के रूप में सबसे अच्छा माना जाता है। चूंकि मानक सी ने ऐतिहासिक रूप से द्विआधारी स्थिरांक (केवल अष्टाधारी और हेक्साडेसिमल) के प्रतिनिधित्व का समर्थन नहीं किया है, न्यूक्लियस एसई में एक उपयोगी हेडर फ़ाइल nuse_binary.h है जिसमें सभी 256 8-बिट मानों के लिए b01010101 जैसे #define वर्ण हैं।

इवेंट फ्लैग सेट करें

फ़्लैगिंग के लिए न्यूक्लियस आरटीओएस एपीआई यूटिलिटी कॉल बहुत लचीला है और आपको AND और OR ऑपरेशंस का उपयोग करके फ्लैग वैल्यू सेट और क्लियर करने की अनुमति देता है। न्यूक्लियस एसई समान कार्यक्षमता प्रदान करता है, लेकिन कार्य ठहराव वैकल्पिक है।

न्यूक्लियस आरटीओएस में झंडे सेट करने के लिए कॉल करें
सेवा कॉल प्रोटोटाइप:

स्थिति NU_Set_Events (NU_EVENT_GROUP * समूह, UNSIGNED event_flags, विकल्प संचालन);

विकल्प:

समूह - घटना झंडे के एक समूह के लिए एक उपयोगकर्ता-प्रदान नियंत्रण ब्लॉक के लिए एक सूचक;
event_flags - ध्वज समूह के बिट मास्क का मूल्य;
ऑपरेशन - प्रदर्शन किया जाने वाला ऑपरेशन , NU_OR (झंडे लगाने के लिए) या NU_AND (झंडे साफ़ करने के लिए)।

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_GROUP - ईवेंट झंडे के एक समूह को अमान्य सूचक;
NU_INVALID_OPERATION - निर्दिष्ट ऑपरेशन NU_OR और NU_AND से अलग है।

न्यूक्लियस एसई में झंडे लगाने के लिए कॉल करें
यह एपीआई कॉल न्यूक्लियस आरटीओएस एपीआई की मुख्य कार्यक्षमता का समर्थन करता है।

सेवा कॉल प्रोटोटाइप:

स्थिति NUSE_Event_Group_Set (NUSE_EVENT_GROUP समूह, U8 event_flags, विकल्प संचालन);

विकल्प:

समूह - घटना समूह का सूचकांक (आईडी) जिसके झंडे सेट / साफ हो गए हैं;
event_flags - झंडे के एक समूह की बिट मैक्सी का मूल्य;
ऑपरेशन - प्रदर्शन किया जाने वाला ऑपरेशन , NUSE_OR (झंडे सेट करने के लिए) या NUSE_AND (झंडे साफ़ करने के लिए)।

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_GROUP - ईवेंट झंडे के एक समूह का अमान्य सूचकांक;
NUSE_INVALID_OPERATION - निर्दिष्ट ऑपरेशन NUSE_OR और NUSE_AND से अलग है।

न्यूक्लियस एसई में इवेंट फ्लैग की स्थापना को लागू करना
NUSE_Event_Group_Set () API फ़ंक्शन का प्रारंभिक कोड सामान्य है (मापदंडों की जांच करने के बाद), चाहे कॉल को अवरुद्ध करने के लिए API समर्थन (कार्य निलंबन) सक्रिय हो या नहीं। तर्क बहुत आसान है:

 NUSE_CS_Enter(); if (operation == NUSE_OR) { NUSE_Event_Group_Data[group] |= event_flags; } else /* NUSE_AND */ { NUSE_Event_Group_Data[group] &= event_flags; }

इवेंट फ्लैग के चयनित समूह के मान पर event_flags बिटमास्क को ( AND या OR ऑपरेशन का उपयोग करके) सुपरइम्पोज़ किया जाता है ।

शेष कोड तभी सक्षम होता है जब कार्य लॉकिंग सक्रिय हो:

 #if NUSE_BLOCKING_ENABLE while (NUSE_Event_Group_Blocking_Count[group] != 0) { U8 index; /* check whether any tasks are blocked */ /* on this event group */ for (index=0; index<NUSE_TASK_NUMBER; index++) { if ((LONIB(NUSE_Task_Status[index]) == NUSE_EVENT_SUSPEND) && (HINIB(NUSE_Task_Status[index]) == group)) { NUSE_Task_Blocking_Return[index] = NUSE_SUCCESS; NUSE_Task_Status[index] = NUSE_READY; break; } } NUSE_Event_Group_Blocking_Count[group]--; } #if NUSE_SCHEDULER_TYPE == NUSE_PRIORITY_SCHEDULER NUSE_Reschedule(NUSE_NO_TASK); #endif #endif NUSE_CS_Exit(); return NUSE_SUCCESS;

यदि झंडे के इस समूह से किसी भी कार्य को (पढ़ने के लिए) रोका जाता है, तो वे फिर से शुरू होते हैं। जब उनके पास निष्पादन जारी रखने का अवसर होता है (यह अनुसूचक पर निर्भर करता है), तो वे यह निर्धारित कर सकते हैं कि उनके फिर से शुरू होने की शर्तें संतुष्ट हैं या नहीं (इवेंट फ्लैग रीडिंग देखें)।

ईवेंट झंडे पढ़ना

पढ़ने के लिए न्यूक्लियस आरटीओएस एपीआई उपयोगिता बहुत लचीली होती है और आपको कार्यों को अनिश्चित काल के लिए या एक विशिष्ट समय समाप्त होने पर अनुमति देती है यदि ऑपरेशन तुरंत पूरा नहीं किया जा सकता है (उदाहरण के लिए, यदि आप इवेंट फ्लैग के एक विशिष्ट अनुक्रम को पढ़ने की कोशिश करते हैं जो वर्तमान स्थिति का प्रतिनिधित्व नहीं करता है)। न्यूक्लियस एसई एक ही सुविधाएँ प्रदान करता है, केवल कार्य ठहराव वैकल्पिक है, और टाइमआउट लागू नहीं किया गया है।

न्यूक्लियस आरटीओएस में फ्लैग चैलेंज
सेवा कॉल प्रोटोटाइप:

STATUS NU_Retrieve_Events (NU_EVENT_GROUP * समूह, UNSIGNED अनुरोध किया गया_events, विकल्प संचालन, UNSIGNED * पुनर्प्राप्त_के लिए, UNSIGNED लंबित);

विकल्प:

समूह - घटना झंडे के एक समूह के लिए एक उपयोगकर्ता-प्रदान नियंत्रण ब्लॉक के लिए एक सूचक;
request_events - थोड़ा सा मुखौटा जो पढ़ने के लिए झंडे को परिभाषित करता है;
ऑपरेशन - चार ऑपरेशन उपलब्ध हैं: NU_AND , NU_AND_CONSUME , NU_OR और NU_OR_CONSUME । ऑपरेशन NU_AND और NU_AND_CONSUME इंगित करते हैं कि सभी अनुरोधित ध्वज आवश्यक हैं। ऑपरेशन NU_OR और NU_OR_CONSUME इंगित करते हैं कि एक या अधिक अनुरोधित ध्वज पर्याप्त हैं। CONSUME पैरामीटर एक सफल अनुरोध के बाद मौजूदा झंडे को स्वचालित रूप से साफ़ करता है;
पुनर्प्राप्त_वेन्ट - रीड इवेंट फ्लैग के मूल्यों के लिए स्टोरेज पॉइंटर;
सस्पेंड - कार्यों को रोकने के लिए विनिर्देश; NU_NO_SUSPEND या NU_SUSPEND , या सिस्टम टाइमर के टिक्स में टाइमआउट मान (1 से 4,294,967,293 तक) ले सकते हैं।

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_NOT_PRESENT - निर्दिष्ट ऑपरेशन ने घटनाओं को वापस नहीं किया (NU_OR के मामले में एक भी घटना नहीं और NU_AND के मामले में सभी घटनाएँ नहीं);
NU_INVALID_GROUP - ईवेंट झंडे के एक समूह को अमान्य सूचक;
NU_INVALID_OPERATION - निर्दिष्ट ऑपरेशन गलत था;
NU_INVALID_POINTER - इवेंट फ़्लैग (NULL) के स्टोर के लिए अशक्त सूचक;
NU_INVALID_SUSPEND - गैर-कार्य-संबंधित थ्रेड से रोकने का प्रयास;
NU_TIMEOUT - घटना के झंडे का आवश्यक संयोजन निर्दिष्ट समय समाप्त होने के बाद भी सेट नहीं किया गया था;
NU_GROUP_DELETED - जब कार्य स्थगित कर दिया गया था तब ईवेंट झंडे का समूह हटा दिया गया था।

न्यूक्लियस एसई में झंडे चुनौती
यह एपीआई कॉल न्यूक्लियस आरटीओएस एपीआई की मुख्य कार्यक्षमता का समर्थन करता है।

सेवा कॉल प्रोटोटाइप:

STATUS NUSE_Event_Group_Retrieve (NUSE_EVENT_GROUP समूह, U8 अनुरोध किया गया_events, विकल्प संचालन, U8 * पुनर्प्राप्त_के लिए, U8 निलंबित);

विकल्प:

समूह - घटना झंडे के पढ़ने के समूह का सूचकांक (आईडी);
request_events - थोड़ा सा मुखौटा जो पढ़ने के लिए झंडे को परिभाषित करता है;
ऑपरेशन - आवश्यक झंडे की संख्या को दर्शाता एक विनिर्देश: NUSE या (कुछ झंडे) या NUSE और (सभी झंडे);
पुनर्प्राप्त_देवाधिकार - रीड इवेंट फ्लैग के वास्तविक मूल्यों के लिए स्टोर के लिए एक पॉइंटर ( NUSE_AND ऑपरेशन के साथ , यह अनुरोध किए गए पैरामीटर पैरामीटर में पारित होने के समान होगा);
निलंबन - किसी कार्य को रोकने के लिए विनिर्देश; यह मानों को ले सकता है NUSE_NO_SUSPEND या NUSE_SUSPEND ।

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_NOT_PRESENT - निर्दिष्ट ऑपरेशन ने घटनाओं को वापस नहीं किया ( NUSE_OR के मामले में एक भी घटना नहीं और NUSE_AND के मामले में सभी घटनाएँ नहीं);
NUSE_INVALID_GROUP - ईवेंट झंडे के एक समूह का अमान्य सूचकांक;
NUSE_INVALID_OPERATION - निर्दिष्ट ऑपरेशन NUSE_OR या NUSE_AND से अलग है;
NUSE_INVALID_POINTER - रीड इवेंट फ्लैग ( NULL ) के स्टोर के लिए एक अशक्त सूचक;
NUSE_INVALID_SUSPEND - एक गैर-कार्य प्रवाह से विराम देने का प्रयास या जब एपीआई कॉल को अवरुद्ध करने के लिए समर्थन अक्षम है।

न्यूक्लियस एसई में इवेंट फ्लैग रीडिंग को लागू करना
API फ़ंक्शन कोड NUSE_Event_Group_Retrieve () (मापदंडों की जांच करने के बाद ) का संस्करण सशर्त संकलन के दौरान चुना गया है, इस पर निर्भर करता है कि एपीआई कॉल को ब्लॉक (निलंबित) कार्यों के लिए समर्थन सक्रिय है या नहीं। आइए इन दोनों विकल्पों पर अलग से विचार करें।

यदि लॉक अक्षम है, तो इस API कॉल का पूर्ण कोड इस तरह दिखाई देगा:

 temp_events = NUSE_Event_Group_Data[group] & requested_events; if (operation == NUSE_OR) { if (temp_events != 0) { return_value = NUSE_SUCCESS; } else { return_value = NUSE_NOT_PRESENT; } } else /* operation == NUSE_AND */ { if (temp_events == requested_events) { return_value = NUSE_SUCCESS; } else { return_value = NUSE_NOT_PRESENT; } }

आवश्यक ईवेंट ध्वज निर्दिष्ट ईवेंट फ़्लैग समूह से चुने गए हैं। मूल्य की तुलना आवश्यक घटनाओं के साथ की जाती है, और / या ऑपरेशन को ध्यान में रखते हुए, साथ ही लौटा परिणाम और अनुरोधित झंडे के तत्काल मूल्य।

यदि कार्य लॉकिंग सक्रिय है, तो कोड अधिक जटिल हो जाता है:

 do { temp_events = NUSE_Event_Group_Data[group] & requested_events; if (operation == NUSE_OR) { if (temp_events != 0) { return_value = NUSE_SUCCESS; } else { return_value = NUSE_NOT_PRESENT; } } else /* operation == NUSE_AND */ { if (temp_events == requested_events) { return_value = NUSE_SUCCESS; } else { return_value = NUSE_NOT_PRESENT; } } if (return_value == NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } else { if (suspend == NUSE_SUSPEND) /* block task */ { NUSE_Event_Group_Blocking_Count[group]++; NUSE_Suspend_Task(NUSE_Task_Active, (group << 4) | NUSE_EVENT_SUSPEND); return_value = NUSE_Task_Blocking_Return[NUSE_Task_Active]; if (return_value != NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } } } } while (suspend == NUSE_SUSPEND);

कोड एक लूप में रखा गया है ... जबकि लूप , जो काम करता है जबकि सस्पेंड पैरामीटर NUSE_SUSPEND है ।

अनुरोधित ईवेंट झंडे को ऐसे पढ़ा जाता है जैसे उन्हें बिना किसी अवरोध के बुलाया गया हो। यदि रीड असफल है और सस्पेंड पैरामीटर NUSE_NO_SUSPEND है , तो API कॉल NUSE_NOT_PRESENT पर सेट है। यदि निलंबित पैरामीटर NUSE_SUSPEND पर सेट किया गया था, तो कार्य रुक जाता है। लौटते समय (जब कार्य फिर से शुरू होता है), यदि वापसी मान NUSE_SUCCESS है , तो यह दर्शाता है कि कार्य फिर से शुरू किया गया था क्योंकि इस समूह में घटना के झंडे सेट या साफ़ किए गए थे, चक्र शुरू से शुरू होता है, झंडे पढ़े जाते हैं और जांचे जाते हैं। चूंकि इवेंट फ़्लैग समूहों को रीसेट करने के लिए कोई एपीआई फ़ंक्शन नहीं है, यह कार्य को फिर से शुरू करने का एकमात्र कारण है, लेकिन NUSE_Task_Blocking_Return [] चेक प्रक्रिया को अन्य प्रकार की वस्तुओं के साथ लॉकिंग नियंत्रण की संगतता के लिए सिस्टम पर छोड़ दिया गया है।

निम्न आलेख ईवेंट फ्लैग समूहों के साथ-साथ उनके डेटा संरचनाओं के साथ जुड़े अतिरिक्त एपीआई कॉल का वर्णन करेगा।

लेखक के बारे में: कॉलिन वाल्स तीस वर्षों से इलेक्ट्रॉनिक्स उद्योग में काम कर रहे हैं, अपने अधिकांश समय को फर्मवेयर के लिए समर्पित करते हैं। वह अब मेंटर एंबेडेड (मेंटर ग्राफिक्स का एक प्रभाग) में एक फर्मवेयर इंजीनियर है। कॉलिन वाल्स अक्सर सम्मेलनों और सेमिनारों में बोलते हैं, कई तकनीकी लेखों के लेखक और फर्मवेयर पर दो किताबें हैं। ब्रिटेन में रहता है। कॉलिन का पेशेवर ब्लॉग , ई-मेल: colin_walls@mentor.com।

RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 17 इवेंट फ़्लैग समूह: परिचय और बुनियादी सेवाएँ