Serial.readString() फ़ंक्शन को समझना
Serial.readString () फ़ंक्शन Arduino सीरियल लाइब्रेरी का एक हिस्सा है, जो माइक्रोकंट्रोलर और कंप्यूटर या अन्य बाहरी उपकरणों के बीच संचार को सक्षम बनाता है।
यह फ़ंक्शन माइक्रोकंट्रोलर को सीरियल कनेक्शन से भेजे गए वर्णों की एक स्ट्रिंग को पढ़ने की अनुमति देता है। फ़ंक्शन सीरियल बफर से डेटा पढ़ता है और डेटा को स्ट्रिंग ऑब्जेक्ट के रूप में लौटाता है।
यह फ़ंक्शन स्ट्रीम क्लास से विरासत में मिला है।
वाक्य - विन्यास
इस फ़ंक्शन का सिंटैक्स इस प्रकार है:
धारावाहिक। readString ( )
पैरामीटर
यह फ़ंक्शन कोई पैरामीटर नहीं लेता है। यह केवल सीरियल पोर्ट ऑब्जेक्ट को पढ़ता है।
रिटर्न
एक स्ट्रिंग लौटाता है जिसमें सीरियल पोर्ट के माध्यम से प्राप्त वर्ण होते हैं। प्राप्त अंतिम वर्ण के साथ स्ट्रिंग समाप्त होती है, जो अक्सर एक नई पंक्ति वर्ण (\n) होती है। यदि सीरियल बफ़र में कोई वर्ण उपलब्ध नहीं है, तो फ़ंक्शन एक खाली स्ट्रिंग ('') लौटाता है।
टिप्पणी: यदि डेटा में अंतिम पंक्ति वर्ण उपलब्ध है, तो फ़ंक्शन समय से पहले समाप्त नहीं होगा। लौटाई गई स्ट्रिंग में कैरिज रिटर्न वर्ण हो सकते हैं।
उदाहरण कोड
कोड नीचे Arduino प्रोग्रामिंग में Serial.readString() फ़ंक्शन का उपयोग प्रदर्शित करता है:
कोड नीचे Arduino प्रोग्रामिंग में Serial.readString() फ़ंक्शन का उपयोग प्रदर्शित करता है:
खालीपन स्थापित करना ( ) {धारावाहिक। शुरू ( 9600 ) ;
}
खालीपन कुंडली ( ) {
धारावाहिक। println ( 'डेटा दर्ज करें:' ) ;
जबकि ( धारावाहिक। उपलब्ध ( ) == 0 ) { } // उपलब्ध डेटा की प्रतीक्षा करें
स्ट्रिंग टेस्टस्ट्र = धारावाहिक। readString ( ) ; // टाइमआउट तक पढ़ें
teststr. काट-छांट करना ( ) ; // स्ट्रिंग एंड से किसी भी \r \n व्हाइटस्पेस को हटा दें
धारावाहिक। छपाई ( 'डेटा इनपुट: ' ) ;
धारावाहिक। println ( teststr ) ;
अगर ( teststr == 'नमस्ते' ) {
धारावाहिक। println ( 'हैलो आप को भी!' ) ;
} अन्य {
धारावाहिक। println ( 'मुझे खेद है, मैं आपका इनपुट समझ नहीं पाया।' ) ;
}
}
में स्थापित करना() फ़ंक्शन सीरियल संचार 9600 की बॉड दर का उपयोग करके सक्षम किया गया है।
में कुंडली() फ़ंक्शन, कोड उपयोगकर्ता को सीरियल मॉनीटर पर 'डेटा दर्ज करें:' प्रिंट करके डेटा दर्ज करने का संकेत देता है। यह तब डेटा के उपलब्ध होने की प्रतीक्षा करता है, यदि सीरियल बफर सीरियल.उपलब्ध () फ़ंक्शन का उपयोग करके खाली है।
एक बार डेटा उपलब्ध हो जाने के बाद, कोड Serial.readString() फ़ंक्शन का उपयोग करके डेटा को एक स्ट्रिंग के रूप में पढ़ता है और ट्रिम() फ़ंक्शन का उपयोग करके स्ट्रिंग के अंत में किसी भी व्हाइटस्पेस वर्ण को हटा देता है।
कोड तब इनपुट स्ट्रिंग की तुलना स्ट्रिंग 'हैलो' से करता है। यदि इनपुट स्ट्रिंग है 'नमस्ते' , कोड प्रिंट करके प्रतिक्रिया करता है 'हैलो आप को भी!' सीरियल मॉनिटर के लिए। अन्यथा, यह 'मुझे क्षमा करें, मुझे आपका इनपुट समझ में नहीं आया' प्रिंट करता है। सीरियल मॉनिटर के लिए। लूप () फ़ंक्शन तब दोहराता है, उपयोगकर्ता को अधिक इनपुट के लिए प्रेरित करता है।
उत्पादन
आउटपुट में हम अलग-अलग स्ट्रिंग्स देख सकते हैं जो कोड उपयोगकर्ता से पढ़ता है और स्ट्रिंग 'हैलो' से मेल खाता है।
निष्कर्ष
Arduino में Serial.readString () फ़ंक्शन कंप्यूटर या अन्य उपकरणों से बोर्ड को भेजे गए सीरियल डेटा को पढ़ता है। इस फ़ंक्शन का उपयोग करके, हम सेंसर और हार्डवेयर उपकरणों को नियंत्रित करने जैसे आउटपुट प्रतिक्रियाओं को उत्पन्न करने के लिए इनपुट सीरियल स्ट्रिंग डेटा को पढ़ और तुलना कर सकते हैं।