RTOS के बारे में पूरी सच्चाई। अनुच्छेद # 28 सॉफ्टवेयर टाइमर

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

टाइमर का उपयोग करना

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

टाइमर सेटिंग्स

टाइमर की संख्या

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

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

समापन समारोह का सक्रियण

न्यूक्लियस एसई में, मैंने कार्यक्षमता को वैकल्पिक बनाने का अवसर खोजने की कोशिश की, जहां यह स्मृति को बचाएगा। एक अच्छा उदाहरण टाइमर पूरा होने वाले कार्यों के लिए समर्थन है। इस तथ्य के अलावा कि यह सुविधा प्रत्येक टाइमर के लिए वैकल्पिक है, NUSE_TIMER_EXPIRATION_ROUTINE_SUPPORT पैरामीटर का उपयोग nuse_config.h में पूरे एप्लिकेशन के लिए तंत्र को सक्रिय (या नहीं) किया जा सकता है। इस पैरामीटर को FALSE में सेट करना ROM में दो डेटा संरचनाओं की परिभाषा को अवरुद्ध करता है, जिसे इस लेख में विस्तार से वर्णित किया जाएगा।

एपीआई सक्रियण

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

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

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

#define NUSE_TIMER_NUMBER 0/*      0-16 */ /*    */ #define NUSE_TIMER_CONTROL FALSE #define NUSE_TIMER_GET_REMAINING FALSE #define NUSE_TIMER_RESET FALSE #define NUSE_TIMER_INFORMATION FALSE #define NUSE_TIMER_COUNT FALSE 

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

टाइमर सेवा कॉल

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

• प्रबंधन (स्टार्ट / स्टॉप) टाइमर। Nucle_Timer_Control () फ़ंक्शन में न्यूक्लियस एसई लागू किया गया है।
• शेष टाइमर समय को पुनः प्राप्त करना। न्यूक्लियस एसई में, NUSE_Timer_Get_Remaining () में लागू किया गया।
• टाइमर को उसकी मूल स्थिति में पुनर्स्थापित करना (रीसेट)। NUSE_Timer_Reset () में न्यूक्लियस एसई लागू किया गया।
• एक विशिष्ट टाइमर के बारे में जानकारी प्रदान करना। Nucle_Timer_Information () में न्यूक्लियस एसई लागू किया गया है।
• एप्लिकेशन में कॉन्फ़िगर किए गए (वर्तमान में) टाइमर की संख्या लौटाता है। न्यूक्लियस एसई को NUSE_Timer_Count () में लागू किया गया है।
• एप्लिकेशन (निर्माण) में एक नया टाइमर जोड़ना। न्यूक्लियस एसई को लागू नहीं किया जाता है।
• एप्लिकेशन से टाइमर निकाल रहा है। न्यूक्लियस एसई को लागू नहीं किया जाता है।
• आवेदन में सभी टाइमर पर लौटने वाले बिंदु। न्यूक्लियस एसई को लागू नहीं किया जाता है।

प्रत्येक सेवा कॉल के कार्यान्वयन पर नीचे विस्तार से चर्चा की जाएगी।

टाइमर सेवाएँ

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

समय पर नियंत्रण

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

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

स्थिति NU_Control_Timer (NU_TIMER * टाइमर, विकल्प सक्षम);

विकल्प:
टाइमर - उपयोगकर्ता द्वारा प्रदान की गई टाइमर नियंत्रण ब्लॉक को सूचक;
सक्षम आवश्यक फ़ंक्शन है, यह NU_ENABLE_TIMER या NU_DISABLE_TIMER मान ले सकता है।

वापसी मूल्य:
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INAVLID_TIMER - अमान्य टाइमर सूचक;
NU_INAVLID_ENABLE - अमान्य फ़ंक्शन।

न्यूक्लियस एसई में टाइमर कंट्रोल चैलेंज
यह एपीआई कॉल न्यूक्लियस आरटीओएस एपीआई की पूर्ण कार्यक्षमता का समर्थन करता है।

सेवा कॉल प्रोटोटाइप:
स्थिति NUSE_Timer_Control (NUSE_TIMER टाइमर, विकल्प सक्षम);

विकल्प:
टाइमर - प्रयुक्त टाइमर का सूचकांक (आईडी);
सक्षम आवश्यक फ़ंक्शन है, यह NUSE_ENABLE_TIMER या NUSE_DISABLE_TIMER मान ले सकता है।

वापसी मूल्य:
NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INCALID_TIMER - अमान्य टाइमर सूचकांक;
NUSE_INVALID_ENABLE एक अमान्य फ़ंक्शन है।

न्यूक्लियस एसई में टाइमर प्रबंधन लागू करें
API फ़ंक्शन कोड NUSE_Timer_Control () (मापदंडों की जाँच करने के बाद) काफी सरल है:

 NUSE_CS_Enter(); if (enable == NUSE_ENABLE_TIMER) { NUSE_Timer_Status[timer] = TRUE; if (NUSE_Timer_Expirations_Counter[timer] == 0) { NUSE_Timer_Value[timer] = NUSE_Timer_Initial_Time[timer]; } else { NUSE_Timer_Value[timer] = NUSE_Timer_Reschedule_Time[timer]; } } else /* enable == NUSE_DISABLE_TIMER */ { NUSE_Timer_Status[timer] = FALSE; } NUSE_CS_Exit(); 

यदि NUSE_DISABLE_TIMER फ़ंक्शन निर्दिष्ट किया गया था, तो टाइमर स्थिति ( NUSE_Timer_Status [] पैरामीटर) FALSE पर सेट है, जो कि बाधा हैंडलर द्वारा टाइमर को अनदेखा करता है।

जब आप NUSE_ENABLE_TIMER फ़ंक्शन का चयन करते हैं , टाइमर काउंटर ( NUSE_Timer_Value [] ) NUSE_Timer_initial_Time [] पर सेट होता है, बशर्ते कि अंतिम रीसेट के बाद से टाइमर कभी भी बंद न हो। अन्यथा, इसे NUSE_Timer_Reschedule_Time [] मान दिया जाता है। तब टाइमर स्थिति (पैरामीटर NUSE_Timer_Status [] ) TRUE पर सेट है, जिसके कारण टाइमर को बाधा हैंडलर द्वारा संसाधित किया जा सकता है।

समय पढ़ने

शेष टाइमर समय प्राप्त करने के लिए, न्यूक्लियस आरटीओएस एपीआई सेवा कॉल उपायों की संख्या को समाप्त कर देता है जब तक कि यह समाप्त नहीं होता है। न्यूक्लियस एसई समान कार्यक्षमता प्रदान करता है।

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

सेवा कॉल प्रोटोटाइप:
STATUS NU_Get_Remaining_Time (NU_TIMER * टाइमर, UNSIGNED * शेष_टाइम);

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

वापसी मूल्य
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_TIMER - अमान्य टाइमर सूचक।

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

सेवा कॉल प्रोटोटाइप:
STATUS NUSE_Timer_Get_Remaining (NUSE_TIMER टाइमर, U16 * शेष_ समय);

विकल्प:
टाइमर - प्रयुक्त टाइमर का सूचकांक (आईडी);
शेष_ समय - शेष समय मान के भंडारण के लिए एक सूचक, जो U16 प्रकार का एक चर है।

वापसी मूल्य:
NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_TIMER - अमान्य टाइमर सूचकांक;
NUSE_INVALID_POINTER - शेष समय ( NULL ) के लिए नल सूचक।

न्यूक्लियस एसई में एक टाइमर को लागू करना
एपीआई फ़ंक्शन कोड वेरिएंट NUSE_Timer_Get_Remaining () (मापदंडों की जांच करने के बाद) तुच्छ सरल है। NUSE_Timer_Value [] मान प्राप्त किया गया है और फिर महत्वपूर्ण अनुभाग में वापस आ गया है।

सहायक टाइमर सेवाएँ

न्यूक्लियस आरटीओएस में चार एपीआई कॉल होते हैं जो टाइमर से संबंधित सहायक कार्य प्रदान करते हैं: टाइमर को रीसेट करना, टाइमर की जानकारी प्राप्त करना, किसी एप्लिकेशन में टाइमर की संख्या प्राप्त करना, और किसी एप्लिकेशन में सभी टाइमर को पॉइंटर्स प्राप्त करना। पहले तीन कार्य न्यूक्लियस एसई में कार्यान्वित किए जाते हैं।

टाइमर रीसेट करें

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

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

सेवा कॉल प्रोटोटाइप:
STATUS NU_Reset_Timer (NU_TIMER * टाइमर, VOID (* expiration_routine) (UNSIGNED), UNSIGNED initial_time, UNSIGNED reschedule_time, OPTION enable);

विकल्प:
टाइमर - एक संकेतक के लिए एक रीसेट टाइमर;
expiration_routine - उस फ़ंक्शन को इंगित करता है जिसे लूप समाप्त होने पर निष्पादित किया जाएगा;
initial_time - टाइमर की प्रारंभिक संख्या लूप समाप्त होने तक टिक जाती है;
reschedule_time - टाइमर की संख्या दूसरी और बाद में चक्र पूरा होने तक टिक जाती है;
सक्षम करें - रीसेट के बाद टाइमर की आवश्यक स्थिति, मान NU_ENABLE_TIMER या NU_DISABLE_TIMER ले सकते हैं।

वापसी मूल्य:
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_TIMER - टाइमर नियंत्रण इकाई के लिए अमान्य सूचक;
NU_INVALID_FUNCTION - पूर्ण कार्य के लिए अशक्त सूचक ( NULL );
NU_INVALID_ENABLE - निर्दिष्ट स्थिति गलत है;
NU_NOT_DISABLED - टाइमर पहले से ही चल रहा है (इस फ़ंक्शन को कॉल करने से पहले इसे रोक दिया जाना चाहिए)।

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

सेवा कॉल प्रोटोटाइप:
स्थिति NUSE_Timer_Reset (NUSE_TIMER टाइमर, विकल्प सक्षम);

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

वापसी मूल्य:
NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_TIMER - अमान्य टाइमर सूचकांक;
NUSE_INVALID_ENABLE - निर्दिष्ट स्थिति गलत है;
NUSE_NOT_DISABLED - टाइमर पहले से ही चल रहा है (इस फ़ंक्शन को कॉल करने से पहले इसे रोक दिया जाना चाहिए)।

न्यूक्लियस एसई में एक टाइमर रीसेट लागू करना
API फ़ंक्शन कोड NUSE_Timer_Reset () (मापदंडों और वर्तमान स्थिति की जांच के बाद ) का संस्करण काफी सरल है:

 NUSE_CS_Enter(); NUSE_Init_Timer(timer); if (enable == NUSE_ENABLE_TIMER) { NUSE_Timer_Status[timer] = TRUE; } /*  enable == NUSE_DISABLE_TIMER    FALSE */ NUSE_CS_Exit(); 

NUSE_Init_Timer () के लिए एक कॉल समय मान को आरंभ करता है और पूरा होने वाले काउंटर को साफ करता है। उसके बाद, यदि आवश्यक हो, तो आवश्यक स्थिति के मूल्य की जांच की जाती है और क्या टाइमर चालू है।

समय की जानकारी

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

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

सेवा कॉल प्रोटोटाइप:
स्थिति NU_Timer_Information (NU_TIMER * टाइमर, CHAR * नाम, विकल्प * सक्षम, UNSIGNED * समाप्ति, UNSIGNED * id, UNSIGNED * initial_time, UNISIGNED * reschedule_time);

विकल्प:
टाइमर - एक टाइमर के लिए एक संकेतक जिसके बारे में जानकारी का अनुरोध किया जाता है;
नाम - टाइमर नाम के लिए 8-वर्ण क्षेत्र का सूचक;
सक्षम - टाइमर एक्टिवेटर की वर्तमान स्थिति लेने वाले चर के लिए पॉइंटर: NU_ENABLE_TIMER या NU_DISABLE_TIMER ;
समाप्ति - एक चर के लिए एक संकेतक जो अपने अंतिम रीसेट के बाद से टाइमर चक्र के पूर्णता की संख्या का एक काउंटर लेता है;
आईडी - एक चर के लिए सूचक जो टाइमर चक्र के अंत फ़ंक्शन के लिए पारित पैरामीटर का मूल्य लेता है;
initial_time - एक वैरिएबल के लिए एक पॉइंटर जो एक मान लेता है जिसमें रीसेट के बाद टाइमर को इनिशियलाइज़ किया जाएगा;
reschedule_time - एक वैरिएबल का एक संकेतक जो एक मान लेता है जिसमें पूरा होने के बाद टाइमर को इनिशियलाइज़ किया जाएगा।

वापसी मूल्य:
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_TIMER - अमान्य टाइमर सूचक।

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

सेवा कॉल प्रोटोटाइप:
STATUS NUSE_Timer_Information (NUSE_TIMER टाइमर, विकल्प * सक्षम, U8 * समाप्ति, U8 * id, U16 * initial_time, U16 * reschedule_time);

विकल्प:
टाइमर - टाइमर का सूचकांक जिसके बारे में जानकारी का अनुरोध किया जाता है;
सक्षम करें - एक चर के लिए एक सूचक जो मान लेता है TRUE या FALSE , इस पर निर्भर करता है कि टाइमर सक्रिय है या नहीं;
expirations - U8 के एक चर के लिए एक सूचक जो अपने अंतिम रीसेट के बाद से टाइमर पूर्णता की संख्या का मूल्य लेता है;
आईडी - U8 के एक चर के लिए पॉइंटर जो टाइमर पूरा होने वाले फ़ंक्शन के लिए पारित पैरामीटर का मूल्य लेता है (यदि पूर्ण फ़ंक्शन अक्षम हैं तो एक खाली मान लौटाएगा);
initial_time - U16 के एक चर के लिए एक संकेतक जो एक मूल्य लेता है जिसके द्वारा टाइमर को रीसेट के बाद प्रारंभ किया जाएगा;
reschedule_time - U16 के एक चर के लिए एक संकेतक, जो मान लेता है जिसके द्वारा टाइमर पूरा होने के बाद आरंभीकृत किया जाएगा।

वापसी मूल्य:
NUSE_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NUSE_INVALID_TIMER - अमान्य टाइमर सूचकांक;
NUSE_INVALID_POINTER - एक या अधिक पॉइंटर पैरामीटर गलत हैं।

न्यूक्लियस एसई में टाइमर की जानकारी लागू करना
इस एपीआई कॉल को लागू करना बहुत सरल है:

 NUSE_CS_Enter(); if (NUSE_Timer_Status[timer]) { *enable = NUSE_ENABLE_TIMER; } else { *enable = NUSE_DISABLE_TIMER; } *expirations = NUSE_Timer_Expirations_Counter[timer]; #if NUSE_TIMER_EXPIRATION_ROUTINE_SUPPORT *id = NUSE_Timer_Expiration_Routine_Parameter[timer]; #endif *initial_time = NUSE_Timer_Initial_Time[timer]; *reschedule_time = NUSE_Timer_Reschedule_Time[timer]; NUSE_CS_Exit(); 

फ़ंक्शन टाइमर की स्थिति देता है। समाप्ति फ़ंक्शन का पैरामीटर मान केवल तभी लौटाया जाता है जब उनका समर्थन अनुप्रयोग में सक्रिय किया गया हो।

टाइमर की संख्या प्राप्त करना

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

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

सेवा कॉल प्रोटोटाइप:
UNSIGNED NU_Established_Timers (VOID);

पैरामीटर: कोई नहीं

वापसी मूल्य: सिस्टम में निर्मित टाइमर की संख्या।

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

सेवा कॉल प्रोटोटाइप:
U8 NUSE_Timer_Count (शून्य);

पैरामीटर: कोई नहीं

वापसी मूल्य:
आवेदन में कॉन्फ़िगर टाइमर की संख्या

टाइमर काउंटर कार्यान्वयन

इस API कॉल का कार्यान्वयन काफी सरल है: #define NUSE_TIMER_NUMBER प्रतीक का मान वापस आ गया है ।

डेटा संरचनाएं

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

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

रैम डेटा

इस डेटा में निम्न संरचना है:
NUSE_Timer_Status [] प्रकार का एक प्रकार है U8 जिसमें प्रत्येक कॉन्फ़िगर किए गए टाइमर के लिए एक प्रविष्टि है और टाइमर की स्थिति को संग्रहीत करता है (चल रहा है या बंद हो गया: TRUE या FALSE )।
NUSE_Timer_Value [] प्रकार का एक प्रकार है U16 जिसमें प्रत्येक कॉन्फ़िगर किए गए टाइमर के लिए एक प्रविष्टि है और टाइमर काउंटर के वर्तमान मूल्य को संग्रहीत करता है।
NUSE_Timer_Expirations_Counter [] - प्रकार U8 की एक सरणी, जिसमें मामलों की संख्या का एक काउंटर होता है जब टाइमर अपने अंतिम रीसेट के बाद से चक्र के अंत तक पहुंच गया।

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

Nuse_init.c फ़ाइल में इन डेटा संरचनाओं की परिभाषाएँ निम्नलिखित हैं:
RAM U8 Timer_Status [NUSE_TIMER_NUMBER];
RAM U16 NUSE_Timer_Value [NUSE_TIMER_NUMBER];
RAM U8 NUSE_Timer_Expirations_Counter [NUSE_TIMER_NUMBER];

ROM डेटा

इस डेटा की संरचना:
NUSE_Timer_Initial_Time [] प्रकार का एक प्रकार है U16 जिसमें प्रत्येक कॉन्फ़िगर किए गए टाइमर के लिए एक प्रविष्टि है और प्रत्येक टाइमर का मान संग्रहीत करता है।
NUSE_Timer_Reschedule_Time [] प्रकार का एक प्रकार है U16 जिसमें प्रत्येक कॉन्फ़िगर किए गए टाइमर के लिए एक प्रविष्टि है और वह मान संग्रहीत करता है जिसके पूरा होने के बाद टाइमर सेट किया जाएगा। शून्य का मान इंगित करता है कि टाइमर "एक बार" है और स्वचालित रूप से पुनरारंभ नहीं होना चाहिए।
NUSE_Timer_Expiration_Routine_Address [] - टाइमर समाप्ति प्रक्रियाओं के पते वाले ADDR प्रकार की एक सरणी। यह सरणी केवल तभी मौजूद है जब टाइमर की समय सीमा समाप्ति प्रक्रिया के लिए समर्थन सक्रिय हो गया है।
NUSE_Timer_Expiration_Routine_Parameter [] - प्रकार का एक सरणी U8 जिसमें पैरामीटर के मान सम्‍मिलित हैं जो टाइमर पूर्णता समारोह में पास किए जाते हैं। यह सरणी केवल तभी मौजूद है जब पूर्ण होने वाले कार्यों के लिए समर्थन सक्रिय हो गया है।

ये डेटा संरचनाएँ nuse_config.c फ़ाइल में घोषित और आरंभिक (स्टैटिकली) हैं, इस प्रकार:

 ROM U16 NUSE_Timer_Initial_Time[NUSE_TIMER_NUMBER] = { /*   ------ */ }; ROM U16 NUSE_Timer_Reschedule_Time[NUSE_TIMER_NUMBER] = { /*      ------ */ }; #if NUSE_TIMER_EXPIRATION_ROUTINE_SUPPORT || NUSE_INCLUDE_EVERYTHING /*    */ ROM ADDR NUSE_Timer_Expiration_Routine_Address[NUSE_TIMER_NUMBER] = { /*     ------ */ /*   NULL */ }; ROM U8 NUSE_Timer_Expiration_Routine_Parameter[NUSE_TIMER_NUMBER] = { /*     ------ */ }; #endif 

टाइमर के लिए स्मृति की मात्रा

अन्य सभी न्यूक्लियस एसई ऑब्जेक्ट्स की तरह, टाइमर के लिए आवश्यक डेटा की मात्रा अनुमानित है।

आवेदन में सभी टाइमर के लिए रैम (बाइट्स) में डेटा की मात्रा की गणना निम्नानुसार की जा सकती है:
NUSE_TIMER_NUMBER * 4

अनुप्रयोग में सभी टाइमर के लिए ROM (बाइट्स) में डेटा की मात्रा, यदि पूरा होने वाले कार्यों के लिए समर्थन अक्षम है, तो इसकी गणना की जा सकती है:
NUSE_TIMER_NUMBER * 4

अन्यथा, यह बराबर है:
NUSE_TIMER_NUMBER * (आकार (ADDR) + 5)

अवास्तविक एपीआई कॉल

न्यूक्लियस एसई उन तीन एपीआई कॉल को लागू नहीं करता है जो आरटीओएस में पाए जा सकते हैं।

समय निर्माण

यह एपीआई कॉल एक टाइमर बनाता है। न्यूक्लियस एसई को इसकी आवश्यकता नहीं है, क्योंकि टाइमर सांख्यिकीय रूप से बनाए जाते हैं।

सेवा कॉल प्रोटोटाइप:
STATUS NU_Create_Timer (NU_TIMER * टाइमर, CHAR * नाम, VOID (* expiration_routine) (UNSIGNED), UNSIGNED id, UNSIGNED initial_time, UNSIGNED reschedule_time, OPTION enable);

विकल्प:
टाइमर - उपयोगकर्ता द्वारा प्रदान की गई टाइमर नियंत्रण ब्लॉक को सूचक; इसका उपयोग अन्य एपीआई कॉल में टाइमर को नियंत्रित करने के लिए किया जाएगा;
नाम - एक समाप्ति शून्य के साथ टाइमर के 7-चरित्र नाम के लिए सूचक;
expiration_routine - उस फ़ंक्शन को इंगित करता है जिसे टाइमर समाप्त होने के बाद निष्पादित किया जाना चाहिए;
आईडी - समाप्ति के फ़ंक्शन के लिए पारित प्रकार का एक डेटा तत्व: इस पैरामीटर का उपयोग उसी समाप्ति फ़ंक्शन के साथ टाइमर की पहचान करने के लिए किया जा सकता है;
initial_time - टाइमर समाप्त होने से पहले टाइमर की प्रारंभिक संख्या को इंगित करता है;
reschedule_time - दूसरी और बाद में चक्र पूरा होने तक टाइमर टिकों की संख्या को इंगित करता है; यदि यह पैरामीटर शून्य के बराबर है, तो टाइमर केवल एक बार बंद हो जाता है;
सक्षम - यह पैरामीटर NU_ENABLE_TIMER और NU_DISABLE_TIMER मान ले सकता है; NU_ENABLE_TIMER टाइमर बनाने के बाद उसे सक्रिय करता है; NU_DISABLE_TIMER टाइमर को अक्षम कर देता है; NU_DISABLE_TIMER पैरामीटर के साथ बनाई गई टाइमर NU_Control_Timer को कॉल करके सक्रिय किया जाना चाहिए।

वापसी मूल्य:
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_TIMER - टाइमर नियंत्रण इकाई ( NULL ) के लिए एक अशक्त सूचक, या नियंत्रण इकाई पहले से ही उपयोग में है;
NU_INVALID_FUNCTION - पूर्ण कार्यक्रम के लिए अशक्त सूचक ( NULL );
NU_INVALID_ENABLE - अमान्य सक्षम पैरामीटर;
NU_INVALID_OPERATION - प्रारंभिक_टाइम पैरामीटर शून्य था।

टाइमर हटाएं

यह एपीआई कॉल पहले से निर्मित टाइमर को हटा देता है। न्यूक्लियस एसई को इसकी आवश्यकता नहीं है, क्योंकि टाइमर सांख्यिकीय रूप से बनाए जाते हैं और हटाए नहीं जा सकते।

सेवा कॉल प्रोटोटाइप:
स्थिति NU_Delete_Timer (NU_TIMER * टाइमर);

विकल्प:
टाइमर - पॉइंटर को टाइमर कंट्रोल ब्लॉक।

वापसी मूल्य:
NU_SUCCESS - कॉल सफलतापूर्वक पूरा हो गया था;
NU_INVALID_TIMER - अमान्य टाइमर सूचक;
NU_NOT_DISABLED - निर्दिष्ट टाइमर अक्षम नहीं है।

टाइमर संकेत

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

सेवा कॉल प्रोटोटाइप:
UNSIGNED NU_Timer_Pointers (NU_TIMER ** पॉइंटर_लिस्ट, UNSIGNED मैक्सिमम_पोइंटर्स);

विकल्प:
पॉइंटर_लिस्ट - पॉइंटर्स ऑफ़ द पॉइंट ऑफ़ एनयर्स NU_TIMER ; यह सिस्टम में कॉन्फ़िगर किए गए टाइमर से संकेत भर जाएगा;
अधिकतम_ पॉइंटर्स - सरणी में पॉइंटर्स की अधिकतम संख्या।

वापसी मूल्य:
सरणी में रखे गए NU_TIMER पॉइंटर्स की संख्या।

नाभिक RTOS संगत

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

ऑब्जेक्ट पहचानकर्ता

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

समय का आकार

न्यूक्लियस आरटीओएस में, टाइमर को 32-बिट काउंटरों का उपयोग करके लागू किया जाता है। मैंने न्यूक्लियस एसई में इस मूल्य को 16 बिट्स तक कम करने का फैसला किया। इससे स्मृति दक्षता और क्रम में उल्लेखनीय सुधार हुआ है। न्यूक्लियस एसई को संशोधित किया जा सकता है यदि एप्लिकेशन को लंबे समय तक चलने की आवश्यकता होती है।

पूर्ण कार्य

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

अवास्तविक एपीआई कॉल

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

निम्नलिखित लेख रुकावटों की जांच करेगा।