📇 🎯 🧛🏾 RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 25 डेटा चैनल: परिचय और बुनियादी सेवाएं 👇🏽 💨 ♀️

चैनलों का उपयोग करना

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

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

चैनल और कतार

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

चैनल सेटअप

चैनलों की संख्या

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

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

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

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

NUSE_PIPE_SEND
NUSE_PIPE_RECEIVE
NUSE_PIPE_JAM
NUSE_PIPE_RESET
NUSE_PIPE_INFORMATION
NUSE_PIPE_COUNT

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

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

#define NUSE_PIPE_NUMBER 0 /* Number of pipes in the system - 0-16 */ /* Service call enablers */ #define NUSE_PIPE_SEND FALSE #define NUSE_PIPE_RECEIVE FALSE #define NUSE_PIPE_JAM FALSE #define NUSE_PIPE_RESET FALSE #define NUSE_PIPE_INFORMATION FALSE #define NUSE_PIPE_COUNT FALSE

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

ओवरहेड चैनल कॉल

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

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

अधिक विस्तार से इनमें से प्रत्येक सेवा कॉल के कार्यान्वयन पर विचार करें।

सेवा कॉल चैनलों से लिखने और पढ़ने के लिए

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

चैनल रिकॉर्डिंग

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

न्यूक्लियस आरटीओएस एक चैनल प्रसारण सेवा भी प्रदान करता है, लेकिन न्यूक्लियस एसई पर समर्थित नहीं है। यह अगले लेख के अनारक्षित एपीआई कॉल अनुभाग में वर्णित किया जाएगा।

न्यूक्लियस आरटीओएस में एक चैनल को संदेश भेजने के लिए कॉल करें

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

STATUS NU_Send_To_Pipe (NU_PIPE * पाइप, VOID * संदेश, UNSIGNED आकार, UNSIGNED सस्पेंड);

विकल्प:

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

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_PIPE - चैनल को अमान्य सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SIZE - संदेश आकार चैनल द्वारा समर्थित संदेश आकार के साथ संगत नहीं है;
NU_INVALID_SUSPEND - गैर-कार्य-संबंधित थ्रेड से निलंबित करने का प्रयास;
NU_PIPE_FULL - चैनल भरा हुआ है और कार्य निलंबन का प्रकार निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - चैनल एक निर्दिष्ट अवधि के लिए कार्य स्थगित होने के बाद भी भरा हुआ है;
NU_PIPE_DELETED - कार्य स्थगित होने के दौरान चैनल को हटा दिया गया था;
NU_PIPE_RESET - कार्य स्थगित होने के दौरान चैनल रीसेट कर दिया गया था।

न्यूक्लियस एसई में एक चैनल को संदेश भेजने के लिए कॉल करें

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

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

स्थिति NUSE_Pipe_Send (NUSE_PIPE पाइप, U8 * संदेश, U8 निलंबन);

विकल्प:

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

वापसी मूल्य:

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

न्यूक्लियस एसई में चैनल पोस्टिंग को लागू करना

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

यदि लॉकिंग अक्षम है, तो इस API कॉल के लिए कोड बहुत सरल है:

 if (NUSE_Pipe_Items[pipe] == NUSE_Pipe_Size[pipe]) /* pipe full */ { return_value = NUSE_PIPE_FULL; } else /* pipe element available */ { data = &NUSE_Pipe_Data[pipe][NUSE_Pipe_Head[pipe]]; for (i=0; i<msgsize; i++) { *data++ = *message++; } NUSE_Pipe_Head[pipe] += msgsize; if (NUSE_Pipe_Head[pipe] == (NUSE_Pipe_Size[pipe] * msgsize)) { NUSE_Pipe_Head[pipe] = 0; } NUSE_Pipe_Items[pipe]++; return_value = NUSE_SUCCESS; }

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

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

 do { if (NUSE_Pipe_Items[pipe] == NUSE_Pipe_Size[pipe]) /* pipe full */ { if (suspend == NUSE_NO_SUSPEND) { return_value = NUSE_PIPE_FULL; } else { /* block task */ NUSE_Pipe_Blocking_Count[pipe]++; NUSE_Suspend_Task(NUSE_Task_Active, (pipe << 4) | NUSE_PIPE_SUSPEND); return_value = NUSE_Task_Blocking_Return[NUSE_Task_Active]; if (return_value != NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } } } else /* pipe element available */ { data = &NUSE_Pipe_Data[pipe][NUSE_Pipe_Head[pipe]]; for (i=0; i<msgsize; i++) { *data++ = *message++; } NUSE_Pipe_Head[pipe] += msgsize; if (NUSE_Pipe_Head[pipe] == (NUSE_Pipe_Size[pipe] * msgsize)) { NUSE_Pipe_Head[pipe] = 0; } NUSE_Pipe_Items[pipe]++; if (NUSE_Pipe_Blocking_Count[pipe] != 0) { U8 index; /* check whether a task is blocked on this pipe */ NUSE_Pipe_Blocking_Count[pipe]--; for (index=0; index<NUSE_TASK_NUMBER; index++) { if ((LONIB(NUSE_Task_Status[index]) == NUSE_PIPE_SUSPEND) && (HINIB(NUSE_Task_Status[index]) == pipe)) { 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_PIPE_FULL मान के साथ समाप्त होता है। यदि निलंबित पैरामीटर NUSE_SUSPEND है , तो कार्य रुक जाता है। पूरा होने पर (अर्थात, जब कार्य फिर से शुरू होता है), यदि रिटर्न मान NUSE_SUCCESS है , अर्थात , कार्य फिर से शुरू किया गया क्योंकि संदेश पढ़ा गया था (और इसलिए नहीं कि चैनल रीसेट हो गया था), कोड लूप की शुरुआत में लौटता है।

यदि चैनल भरा हुआ नहीं है, तो चैनल डेटा क्षेत्र में NUSE_Pipe_Head [] सूचकांक का उपयोग करके प्रदान किया गया संदेश सहेजा जाता है। यह देखने के लिए जांचें कि क्या चैनल ने कार्यों (लंबित संदेशों) को रोक दिया है। यदि ऐसे कार्य हैं, तो उनमें से सबसे पहले शुरू होता है। निलंबित चर NUSE_NO_SUSPEND पर सेट किया गया है , और API कॉल NUSE_SUSCCESS के साथ पूरा होता है ।

चैनल से पढ़ना

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

नाभिक आरटीओएस में चैनल रीड चैलेंज

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

STATUS NU_Receive_From_Pipe (NU_PIPE * पाइप, VOID * संदेश, UNSIGNED आकार, UNSIGNED * वास्तविक_ आकार, UNSIGNED निलंबित);

विकल्प:

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

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_PIPE - चैनल को अमान्य सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SUSPEND - कार्य से जुड़े नहीं थ्रेड से किसी कार्य को रोकने का प्रयास;
NU_PIPE_EMPTY - चैनल खाली है, और कार्य निलंबन का प्रकार निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - निर्दिष्ट टाइमआउट मान के लिए कार्य स्थगित होने के बाद भी चैनल खाली है;
NU_PIPE_DELETED - कार्य स्थगित होने के दौरान चैनल को हटा दिया गया था;
NU_PIPE_RESET - कार्य स्थगित होने के दौरान चैनल को हटा दिया गया था।

न्यूक्लियस एसई में चैनल रीड चैलेंज

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

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

स्थिति NUSE_Pipe_Reive (NUSE_PIPE पाइप, U8 * संदेश, U8 निलंबित);

विकल्प:

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

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_PIPE - अमान्य चैनल सूचकांक;
NUSE_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NUSE_INVALID_SUSPEND - कार्य से संबद्ध या कार्य निलंबन अक्षम के समर्थन के साथ किसी कार्य को निलंबित करने का प्रयास;
NUSE_PIPE_EMPTY - चैनल खाली है, और कार्य निलंबन का प्रकार निर्दिष्ट नहीं किया गया था;
NUSE_PIPE_WAS_RESET - कार्य स्थगित होने के दौरान चैनल रीसेट कर दिया गया था।

न्यूक्लियस एसई में फीड रीडर को लागू करना

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

यदि लॉक अक्षम है, तो इस API कॉल के लिए कोड बहुत सरल है:

 if (NUSE_Pipe_Items[pipe] == 0) /* pipe empty */ { return_value = NUSE_PIPE_EMPTY; } else { /* message available */ data = &NUSE_Pipe_Data[pipe][NUSE_Pipe_Tail[pipe]]; for (i=0; i<msgsize; i++) { *message++ = *data++; } NUSE_Pipe_Tail[pipe] += msgsize; if (NUSE_Pipe_Tail[pipe] == (NUSE_Pipe_Size[pipe] * msgsize)) { NUSE_Pipe_Tail[pipe] = 0; } NUSE_Pipe_Items[pipe]--; *actual_size = msgsize; return_value = NUSE_SUCCESS; }

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

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

 do { if (NUSE_Pipe_Items[pipe] == 0) /* pipe empty */ { if (suspend == NUSE_NO_SUSPEND) { return_value = NUSE_PIPE_EMPTY; } else { /* block task */ NUSE_Pipe_Blocking_Count[pipe]++; NUSE_Suspend_Task(NUSE_Task_Active, (pipe << 4) | NUSE_PIPE_SUSPEND); return_value = NUSE_Task_Blocking_Return[NUSE_Task_Active]; if (return_value != NUSE_SUCCESS) { suspend = NUSE_NO_SUSPEND; } } } else { /* message available */ data = &NUSE_Pipe_Data[pipe][NUSE_Pipe_Tail[pipe]]; for (i=0; i<msgsize; i++) { *message++ = *data++; } NUSE_Pipe_Tail[pipe] += msgsize; if (NUSE_Pipe_Tail[pipe] == (NUSE_Pipe_Size[pipe] * msgsize)) { NUSE_Pipe_Tail[pipe] = 0; } NUSE_Pipe_Items[pipe]--; if (NUSE_Pipe_Blocking_Count[pipe] != 0) { U8 index; /* check whether a task is blocked */ /* on this pipe */ NUSE_Pipe_Blocking_Count[pipe]--; for (index=0; index<NUSE_TASK_NUMBER; index++) { if ((LONIB(NUSE_Task_Status[index]) == NUSE_PIPE_SUSPEND) && (HINIB(NUSE_Task_Status[index]) == pipe)) { NUSE_Task_Blocking_Return[index] = NUSE_SUCCESS; NUSE_Wake_Task(index); break; } } } *actual_size = msgsize; return_value = NUSE_SUCCESS; suspend = NUSE_NO_SUSPEND; } } while (suspend == NUSE_SUSPEND);

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

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

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

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

चैनल की शुरुआत में रिकॉर्ड

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

न्यूक्लियस आरटीओएस में चैनल की शुरुआत के लिए लिखने के लिए कॉल करें

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

स्टेटस NU_Send_To_Front_Of_Pipe (NU_PIPE * पाइप, VOID * संदेश, UNSIGNED आकार, UNSIGINED सस्पेंड);

विकल्प:

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

वापसी मूल्य:

NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_PIPE - चैनल को अमान्य सूचक;
NU_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NU_INVALID_SIZE - संदेश आकार चैनल द्वारा समर्थित संदेश आकार के साथ असंगत है;
NU_INVALID_SUSPEND - कार्य से संबंधित थ्रेड से निलंबित करने का प्रयास;
NU_PIPE_FULL - चैनल भरा हुआ है, और कार्य निलंबन का प्रकार निर्दिष्ट नहीं किया गया था;
NU_TIMEOUT - चैनल एक निर्दिष्ट अवधि के लिए कार्य स्थगित होने के बाद भी भरा हुआ है;
NU_PIPE_DELETED - कार्य स्थगित होने के दौरान चैनल को हटा दिया गया था;
NU_PIPE_RESET - कार्य स्थगित होने के दौरान चैनल रीसेट कर दिया गया था।

न्यूक्लियस एसई में चैनल की शुरुआत के लिए लिखने के लिए कॉल करें

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

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

स्थिति NUSE_Pipe_Jam (NUSE_PIPE पाइप, ADDR * संदेश, U8 निलंबित);

विकल्प:

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

वापसी मूल्य:

NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_PIPE - अमान्य चैनल सूचकांक;
NUSE_INVALID_POINTER - एक संदेश ( NULL ) के लिए अशक्त सूचक;
NUSE_INVALID_SUSPEND - किसी कार्य से संबद्ध कार्य को निलंबित करने का प्रयास या कार्य लॉक अक्षम होने पर;
NUSE_PIPE_FULL - चैनल भरा हुआ है, और कार्य निलंबन का प्रकार निर्दिष्ट नहीं किया गया था;
NUSE_PIPE_WAS_RESET - कार्य स्थगित होने के दौरान चैनल रीसेट कर दिया गया था।

न्यूक्लियस एसई में चैनल एंट्री रिकॉर्डिंग को लागू करना

NUSE_Pipe_Jam () फ़ंक्शन का भिन्न कोड NUSE_Pipe_Send () के समान है, सिवाय इसके कि सूचकांक NUSE_Pipe_Tail [] का उपयोग इसमें डेटा संग्रहीत करने के लिए किया जाता है, इसलिए:

 if (NUSE_Pipe_Items[pipe] == NUSE_Pipe_Size[pipe]) /* pipe full */ { return_value = NUSE_PIPE_FULL; } else /* pipe element available */ { if (NUSE_Pipe_Tail[pipe] == 0) { NUSE_Pipe_Tail[pipe] = (NUSE_Pipe_Size[pipe] - 1) * msgsize; } else { NUSE_Pipe_Tail[pipe] -= msgsize; } data = &NUSE_Pipe_Data[pipe][NUSE_Pipe_Tail[pipe]]; for (i=0; i<msgsize; i++) { *data++ = *message++; } NUSE_Pipe_Items[pipe]++; return_value = NUSE_SUCCESS; }

अगले लेख में, हम चैनलों से संबंधित अतिरिक्त सेवा कॉलों, साथ ही संबंधित डेटा संरचनाओं पर विचार करेंगे।

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

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