👢 ✔️ 🦗 RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 23। कतार: परिचय और बुनियादी सेवाएं 🕚 👵🏼 🆕

कतारों का उपयोग करना

न्यूक्लियस एसई में, बिल्ड चरण के दौरान कतारों को परिभाषित किया जाता है। एक आवेदन में 16 कतारें हो सकती हैं। यदि आवेदन में कोई कतार नहीं है, तो न तो डेटा संरचना और न ही सेवा से संबंधित कतार में आवेदन शामिल हैं।

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

कतारों और डेटा लिंक

न्यूक्लियस एसई डेटा चैनलों का समर्थन करता है, जिनका उल्लेख पिछले लेख (# 5) में भी किया गया था और निम्नलिखित में से एक पर विस्तार से चर्चा की जाएगी। कतारों और चैनलों के बीच मुख्य अंतर संदेश का आकार है। कतार में ADDR प्रकार (आमतौर पर संकेत) के एक एकल चर वाले संदेश होते हैं। चैनल में मनमाने आकार के संदेश होते हैं, जो अनुप्रयोग में प्रत्येक चैनल के लिए अलग-अलग होते हैं और पैरामीटर सेटिंग्स के दौरान असाइन किए जाते हैं।

कतार की स्थापना

कतारों की संख्या

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

नॉनज़रो मान का चयन कतारों के लिए मुख्य उत्प्रेरक के रूप में कार्य करता है। डेटा संरचनाओं को परिभाषित करते समय इस पैरामीटर का उपयोग किया जाता है और उनका आकार इसके मूल्य (अगले लेख में इस पर अधिक) पर निर्भर करता है। इसके अलावा, एक नॉनजरो मान एपीआई सेटिंग्स को सक्रिय करता है।

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

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

NUSE_QUEUE_SEND NUSE_QUEUE_RECEIVE NUSE_QUEUE_JAM NUSE_QUEUE_RESET NUSE_QUEUE_INFORMATION NUSE_QUEUE_COUNT

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

निम्नलिखित nuse_config.h फ़ाइल से कोड का एक स्निपेट है:

 #define NUSE_QUEUE_NUMBER 0 /* Number of queues in the system - 0-16 */ /* Service call enablers */ #define NUSE_QUEUE_SEND FALSE #define NUSE_QUEUE_RECEIVE FALSE #define NUSE_QUEUE_JAM FALSE #define NUSE_QUEUE_RESET FALSE #define NUSE_QUEUE_INFORMATION FALSE #define NUSE_QUEUE_COUNT FALSE

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

पंक्तिबद्ध कॉलिंग

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

एक संदेश पंक्तिबद्ध करना। न्यूक्लियस एसई NUSE_Queue_Send () फ़ंक्शन में कार्यान्वित किया जाता है।
कतार से एक संदेश स्वीकार करना। न्यूक्लियस एसई NUSE_Queue_Receive () फ़ंक्शन को लागू करता है।
कतार के प्रमुख के लिए पोस्टिंग। न्यूक्लियस एसई में, NUSE_Queue_Jam () में लागू किया गया।
सभी निलंबित कार्यों (रीसेट) की रिहाई के साथ एक अप्रयुक्त राज्य में कतार को पुनर्स्थापित करना। न्यूक्लियस एसई को NUSE_Queue_Reset () में लागू किया गया है।
एक विशिष्ट कतार के बारे में जानकारी प्रदान करना। NUSE_Queue_Information () में न्यूक्लियस एसई लागू किया गया।
वर्तमान में एप्लिकेशन में कॉन्फ़िगर की गई संख्याओं की संख्या लौटाता है। न्यूक्लियस एसई में, NUSE_Queue_Count () में लागू किया गया।
अनुप्रयोग में एक नई कतार जोड़ना (एक कतार बनाना)। न्यूक्लियस एसई को लागू नहीं किया जाता है।
एक आवेदन से एक कतार को हटाने। न्यूक्लियस एसई लागू नहीं है।
आवेदन में सभी कतारों को इंगित करें। न्यूक्लियस एसई को लागू नहीं किया जाता है।
कतार में प्रसारित सभी कार्यों के लिए एक संदेश भेजना (प्रसारण)। न्यूक्लियस एसई को लागू नहीं किया जाता है।

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

सेवा कतारों से लिखने और पढ़ने के लिए बुलाती है

कतारों पर किए जाने वाले मूल संचालन लिख रहे हैं (जिसे कभी-कभी पंक्तिबद्ध संदेश भी कहा जाता है) और पढ़ना (संदेश प्राप्त करना भी कहा जाता है)। कतार की शुरुआत (ठेला) लिखना भी संभव है। न्यूक्लियस आरटीओएस और न्यूक्लियस एसई इन ऑपरेशनों के लिए तीन बुनियादी एपीआई कॉल प्रदान करते हैं, जिनके बारे में नीचे चर्चा की जाएगी।

स्पूलन

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

न्यूक्लियस आरटीओएस में कॉलिंग कतार

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

STATUS NU_Send_To_Queue (NU_QUEUE * कतार, VOID * संदेश, UNSIGNED आकार, UNSIGNED सस्पेंड);

विकल्प:

कतार - उपयोगकर्ता द्वारा प्रदान की गई कतार नियंत्रण ब्लॉक के लिए एक सूचक;
संदेश - संदेश भेजने के लिए सूचक;
आकार - संदेश में UNSIGNED डेटा तत्वों की संख्या। यदि कतार चर लंबाई के संदेशों का समर्थन करती है, तो यह पैरामीटर संदेश के आकार के बराबर होना चाहिए या कतार द्वारा समर्थित संदेश के आकार से कम होना चाहिए। यदि कतार एक निश्चित आकार के संदेशों का समर्थन करती है, तो यह पैरामीटर कतार द्वारा समर्थित संदेश के आकार से बिल्कुल मेल खाना चाहिए;
सस्पेंड - कार्य के निलंबन का विनिर्देश, मान NU_NO_SUSPEND या NU_SUSPEND या टाइमआउट मान ले सकता है।

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_QUEUE - अमान्य कतार सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SIZE - संदेश आकार कतार द्वारा समर्थित संदेश आकार के साथ असंगत है;
NU_INVALID_SUSPEND - निलंबन एक गैर-कार्य-संबंधित थ्रेड से किया गया था;
NU_QUEUE_FULL - कतार पूर्ण है, और निलंबन निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - निर्दिष्ट टाइमआउट के लिए कार्य स्थगित होने के बाद भी कतार भरी हुई है;
NU_QUEUE_DELETED - कार्य स्थगित होने पर कतार हटा दी गई थी;
NU_QUEUE_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

न्यूक्लियस एसई में एक संदेश पंक्तिबद्ध करना
यह एपीआई सेवा कॉल न्यूक्लियस आरटीओएस एपीआई की मुख्य कार्यक्षमता का समर्थन करता है।

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

स्थिति NUSE_Queue_Send (NUSE_QUEUE कतार, ADDR * संदेश, U8 निलंबित);

विकल्प:

कतार - कतार सूचकांक (आईडी);
संदेश - भेजे जाने वाले संदेश के लिए एक सूचक; यह ADDR प्रकार का एक चर है;
निलंबन - कार्यों को रोकने के लिए विनिर्देश; यह NUSE_NO_SUSPEND या NUSE_SUSPEND मान ले सकता है।

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_QUEUE - अमान्य कतार सूचकांक;
NUSE_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NUSE_INVALID_SUSPEND - कार्य से संबद्ध थ्रेड से किसी कार्य को रोकने का प्रयास या जब एपीआई सेवा कॉल ब्लॉक कार्यों के लिए अक्षम हो;
NUSE_QUEUE_FULL - कतार पूर्ण है और निलंबन निर्दिष्ट नहीं किया गया था;
NUSE_QUEUE_WAS_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

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

यदि कार्य लॉकिंग सक्रिय नहीं है, तो इस सेवा कॉल के लिए कोड बहुत सरल है:

 if (NUSE_Queue_Items[queue] == NUSE_Queue_Size[queue]) /* queue full */ { return_value = NUSE_QUEUE_FULL; } else /* queue element available */ { NUSE_Queue_Data[queue][NUSE_Queue_Head[queue]++] = *message; if (NUSE_Queue_Head[queue] == NUSE_Queue_Size[queue]) { NUSE_Queue_Head[queue] = 0; } NUSE_Queue_Items[queue]++; return_value = NUSE_SUCCESS; }

फ़ंक्शन केवल यह देखने के लिए जाँच करता है कि क्या कतार में खाली स्थान है, और कतार के डेटा क्षेत्र में संदेश को संग्रहीत करने के लिए NUSE_Queue_Head [] सूचकांक का उपयोग करता है।

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

 do { if (NUSE_Queue_Items[queue] == NUSE_Queue_Size[queue]) /* queue full */ { if (suspend == NUSE_NO_SUSPEND) { return_value = NUSE_QUEUE_FULL; } else { /* block task */ NUSE_Queue_Blocking_Count[queue]++; NUSE_Suspend_Task(NUSE_Task_Active, (queue << 4) | NUSE_QUEUE_SUSPEND); return_value = NUSE_Task_Blocking_Return[NUSE_Task_Active]; if (return_value != NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } } } else { /* queue element available */ NUSE_Queue_Data[queue][NUSE_Queue_Head[queue]++] = *message; if (NUSE_Queue_Head[queue] == NUSE_Queue_Size[queue]) { NUSE_Queue_Head[queue] = 0; } NUSE_Queue_Items[queue]++; if (NUSE_Queue_Blocking_Count[queue] != 0) { U8 index; /* check whether a task is blocked on this queue */ NUSE_Queue_Blocking_Count[queue]--; for (index=0; index<NUSE_TASK_NUMBER; index++) { if ((LONIB(NUSE_Task_Status[index]) == NUSE_QUEUE_SUSPEND) && (HINIB(NUSE_Task_Status[index]) == queue)) { NUSE_Task_Blocking_Return[index] = NUSE_SUCCESS; NUSE_Wake_Task(index); break; } } } return_value = NUSE_SUCCESS; suspend = NUSE_NO_SUSPEND; } } while (suspend == NUSE_SUSPEND);

कुछ स्पष्टीकरण सहायक हो सकते हैं।

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

यदि कतार पूरी भरी हुई है और NUSE_NO_SUSPEND है , तो API कॉल NUSE_QUEUE_FULL के साथ समाप्त होती है । यदि निलंबित पैरामीटर NUSE_SUSPEND है , तो कार्य रुक जाता है। पूर्ण होने पर (अर्थात, जब कार्य फिर से शुरू होता है), यदि रिटर्न मान NUSE_SUCCESS है , अर्थात , कार्य फिर से शुरू किया गया था क्योंकि संदेश पढ़ा गया था (और क्योंकि कतार रीसेट नहीं किया गया था), कोड लूप की शुरुआत में लौटता है।
यदि कतार पूर्ण नहीं है, तो कतार के डेटा क्षेत्र में NUSE_Queue_Head [] सूचकांक का उपयोग करके प्रदान किया गया संदेश संग्रहीत किया जाता है। यह देखने के लिए जाँच करता है कि कतार में निलंबित कार्य (प्रतीक्षा संदेश) हैं या नहीं। यदि ऐसे कार्य हैं, तो उनमें से सबसे पहले शुरू होता है। निलंबित चर NUSE_NO_SUSPEND पर सेट किया गया है , और API कॉल NUSE_SUSCCESS के साथ पूरा होता है ।

कतार से पढ़ना

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

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

स्थिति NU_Receive_From_Queue (NU_QUEUE * कतार, VOID * संदेश, UNSIGNED आकार, UNSIGNED * वास्तविक_ आकार, UNSIGNED निलंबित);

विकल्प:

कतार - उपयोगकर्ता द्वारा प्रदान की गई कतार नियंत्रण ब्लॉक के लिए एक सूचक;
संदेश - प्राप्त संदेशों के लिए भंडारण के लिए एक सूचक;
आकार - संदेश में UNSIGNED डेटा तत्वों की संख्या। यह संख्या कतार से निर्मित होने पर परिभाषित संदेश के आकार से मेल खाना चाहिए;
सस्पेंड - कार्य के निलंबन का विनिर्देश, मान NU_NO_SUSPEND या NU_SUSPEND या टाइमआउट मान ले सकता है।

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_QUEUE - अमान्य कतार सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SUSPEND - कार्य से असंबंधित सूत्र से किसी कार्य को रोकने का प्रयास;
NU_QUEUE_EMPTY - कतार खाली है, और निलंबन निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - इंगित करता है कि कतार अभी भी खाली है, भले ही कार्य निर्दिष्ट अवधि के लिए निलंबित हो;
NU_QUEUE_DELETED - कार्य स्थगित होने पर कतार हटा दी गई थी;
NU_QUEUE_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

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

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

स्टेटस NUSE_Queue_Receive (NUSE_QUEUE कतार, ADDR * संदेश, U8 सस्पेंड);

विकल्प:

कतार - कतार सूचकांक (आईडी);
संदेश - प्राप्त संदेशों के लिए भंडार का एक सूचक; यह ADDR प्रकार का एक चर है;
निलंबन - कार्य के निलंबन की विशिष्टता, NUSE_NO_SUSPEND या NUSE_SUSPEND मान ले सकते हैं।

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_QUEUE - अमान्य कतार सूचकांक;
NUSE_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NUSE_INVALID_SUSPEND - कार्य से जुड़े थ्रेड से किसी कार्य को निलंबित करने का प्रयास या कार्य अवरुद्ध करने के लिए अक्षम समर्थन के साथ;
NUSE_QUEUE_EMPTY - कतार खाली है, और निलंबन निर्दिष्ट नहीं किया गया था;
NUSE_QUEUE_WAS_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

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

यदि लॉक सपोर्ट सक्रिय है, तो इस एपीआई कॉल के लिए कोड बहुत सरल है:

 if (NUSE_Queue_Items[queue] == 0) /* queue empty */ { return_value = NUSE_QUEUE_EMPTY; } else { /* message available */ *message = NUSE_Queue_Data[queue][NUSE_Queue_Tail[queue]++]; if (NUSE_Queue_Tail[queue] == NUSE_Queue_Size[queue]) { NUSE_Queue_Tail[queue] = 0; } NUSE_Queue_Items[queue]--; return_value = NUSE_SUCCESS; }

फ़ंक्शन केवल यह देखने के लिए जाँच करता है कि क्या कतार में कोई संदेश है, और कतार से संदेश प्राप्त करने के लिए NUSE_Queue_Tail [] सूचकांक का उपयोग करता है और संदेश के लिए एक सूचक का उपयोग करके डेटा वापस करता है।

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

 do { if (NUSE_Queue_Items[queue] == 0) /* queue empty */ { if (suspend == NUSE_NO_SUSPEND) { return_value = NUSE_QUEUE_EMPTY; } else { /* block task */ NUSE_Queue_Blocking_Count[queue]++; NUSE_Suspend_Task(NUSE_Task_Active, (queue << 4) | NUSE_QUEUE_SUSPEND); return_value = NUSE_Task_Blocking_Return[NUSE_Task_Active]; if (return_value != NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } } } else { /* message available */ *message = NUSE_Queue_Data[queue][NUSE_Queue_Tail[queue]++]; if (NUSE_Queue_Tail[queue] == NUSE_Queue_Size[queue]) { NUSE_Queue_Tail[queue] = 0; } NUSE_Queue_Items[queue]--; if (NUSE_Queue_Blocking_Count[queue] != 0) { U8 index; /* check whether a task is blocked */ /* on this queue */ NUSE_Queue_Blocking_Count[queue]--; for (index=0; index<NUSE_TASK_NUMBER; index++) { if ((LONIB(NUSE_Task_Status[index]) == NUSE_QUEUE_SUSPEND) && (HINIB(NUSE_Task_Status[index]) == queue)) { NUSE_Task_Blocking_Return[index] = NUSE_SUCCESS; NUSE_Wake_Task(index); break; } } } return_value = NUSE_SUCCESS; suspend = NUSE_NO_SUSPEND; } } while (suspend == NUSE_SUSPEND);

कुछ स्पष्टीकरण सहायक होंगे।

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

यदि कतार खाली है और निलंबित पैरामीटर NUSE_NO_SUSPEND है , तो API कॉल NUSE_QUEUE_EMPTY मान के साथ समाप्त होता है। यदि निलंबित पैरामीटर NUSE_SUSPEND है , तो कार्य रुक जाता है। पूर्ण होने पर (अर्थात, जब कार्य फिर से शुरू होता है), यदि रिटर्न मान NUSE_SUCCESS है , अर्थात , कार्य फिर से शुरू किया गया था क्योंकि संदेश भेजा गया था (और क्योंकि कतार रीसेट नहीं किया गया था), कोड लूप की शुरुआत में लौटता है।

यदि कतार में संदेश होते हैं, तो संग्रहीत संदेश NUSE_Queue_Tail [] अनुक्रमणिका का उपयोग करके लौटाया जाता है। यह देखने के लिए जाँच करता है कि क्या इस कतार में कोई रुका हुआ (लंबित) कार्य हैं या नहीं। यदि ऐसे कार्य हैं, तो उनमें से सबसे पहले शुरू होता है। निलंबित चर NUSE_NO_SUSPEND पर सेट है, और API कॉल NUSE_SUCCI कोड के साथ समाप्त हो गई है।

कतार के प्रमुख को लिखें

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

न्यूक्लियस आरटीओएस कतार के प्रमुख को संदेश लिखने के लिए कॉल करें
सेवा कॉल प्रोटोटाइप:

स्टेटस NU_Send_To_Front_Of_Queue (NU_QUEUE * कतार, VOID * संदेश, UNSIGNED आकार, UNSIGNED सस्पेंड);

विकल्प:

कतार - उपयोगकर्ता द्वारा प्रदान की गई कतार नियंत्रण ब्लॉक के लिए एक सूचक;
संदेश - संदेश भेजने के लिए सूचक;
आकार - संदेश में UNSIGNED डेटा तत्वों की संख्या। यदि कतार चर-लंबाई संदेशों का समर्थन करती है, तो यह पैरामीटर संदेश आकार के बराबर या कतार द्वारा समर्थित संदेश आकार से छोटा होना चाहिए। यदि कतार एक निश्चित लंबाई के संदेशों का समर्थन करती है, तो यह पैरामीटर कतार द्वारा समर्थित संदेश के आकार से बिल्कुल मेल खाना चाहिए;
सस्पेंड - कार्य के निलंबन का विनिर्देश, मान NU_NO_SUSPEND या NU_SUSPEND या टाइमआउट मान ले सकता है।

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_QUEUE - अमान्य कतार सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SIZE - संदेश का आकार कतार द्वारा समर्थित संदेश के आकार के साथ असंगत है;
NU_INVALID_SUSPEND - एक गैर-कार्य प्रवाह से रुकने का प्रयास
NU_QUEUE_FULL - कतार पूर्ण है, और निलंबन निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - कतार पूर्ण है, भले ही कार्य एक निश्चित समय समाप्ति के लिए निलंबित कर दिया गया हो;
NU_QUEUE_DELETED - कार्य स्थगित होने पर कतार हटा दी गई थी;
NU_QUEUE_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

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

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

स्थिति NUSE_Queue_Jam (NUSE_QUEUE कतार, ADDR * संदेश, U8 निलंबित);

विकल्प:

कतार - कतार सूचकांक (आईडी);
संदेश - एक संदेश के लिए एक संकेतक, प्रकार एडीआरडी का एक चर है;
निलंबन - कार्य के निलंबन की विशिष्टता, NUSE_NO_SUSPEND या NUSE_SUSPEND मान ले सकते हैं।

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_QUEUE - अमान्य कतार सूचकांक;
NUSE_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NUSE_INVALID_SUSPEND - कार्य से जुड़े थ्रेड से किसी कार्य को निलंबित करने का प्रयास या कार्य अवरुद्ध करने के लिए अक्षम समर्थन के साथ;
NUSE_QUEUE_FULL - कतार पूर्ण है और निलंबन निर्दिष्ट नहीं किया गया था;
NUSE_QUEUE_WAS_RESET - कार्य स्थगित होने पर कतार रीसेट कर दी गई थी।

न्यूक्लियस एसई में एक क्यू शीर्ष रिकॉर्ड को लागू करना
API फ़ंक्शन कोड वेरिएंट NUSE_Queue_Jam () NUSE_Queue_Send () के समान है, केवल NUSE_Queue_Tail [] इंडेक्स का उपयोग करके डेटा संग्रहीत किया जाता है, इस प्रकार:

 if (NUSE_Queue_Items[queue] == NUSE_Queue_Size[queue]) /* queue full */ { return_value = NUSE_QUEUE_FULL; } else /* queue element available */ { if (NUSE_Queue_Tail[queue] == 0) { NUSE_Queue_Tail[queue] = NUSE_Queue_Size[queue] - 1; } else { NUSE_Queue_Tail[queue]--; } NUSE_Queue_Data[queue][NUSE_Queue_Tail[queue]] = *message; NUSE_Queue_Items[queue]++; return_value = NUSE_SUCCESS; }

अगला लेख कतार के साथ जुड़े अतिरिक्त एपीआई कॉल, साथ ही डेटा संरचनाओं को देखेगा।

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

RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 23। कतार: परिचय और बुनियादी सेवाएं