यह आलेख VEX विज़ुअल स्टूडियो कोड एक्सटेंशन UI (यूज़र इंटरफ़ेस) का अवलोकन है। यह एक्सटेंशन VEX IQ 2nd Generation, EXP, और V5 प्लेटफॉर्म के लिए C++ और Python परियोजनाओं के विकास का समर्थन करता है।
UI घटक
VEX VS कोड एक्सटेंशन के 3 प्रमुख घटक हैं।
- उपकरण पट्टी
- गतिविधि बार और साइड बार
- टर्मिनल पैनल
उपकरण पट्टी
यह टूलबार उपयोगकर्ताओं को VEX VS Code एक्सटेंशन प्रोजेक्ट्स, VEX Brains और VEX Controllers के साथ तेजी से इंटरैक्ट करने का एक आसान तरीका प्रदान करता है। यह टूलबार तभी सक्रिय होता है जब VS Code में कोई वैध VEX प्रोजेक्ट खुला हो। एक वैध VEX परियोजना वह परियोजना है जो एक्सटेंशन द्वारा बनाई या आयात की जाती है। VEXcode या VEXcode Pro प्रोजेक्ट खोलना मान्य नहीं है और उसे आयात करना होगा।
डिवाइस पिकर
डिवाइस पिकर के दो मुख्य कार्य हैं। सबसे पहले, यह कनेक्टेड VEX डिवाइस प्रकार का प्रतिनिधित्व करने वाला एक मस्तिष्क या नियंत्रक आइकन प्रदर्शित करता है।
दूसरा, जब डिवाइस सूची आइकन पर क्लिक किया जाता है, तो सभी कनेक्टेड VEX डिवाइसों के साथ एक त्वरित चयन सूची दिखाई देती है। उपयोगकर्ता चुन सकता है कि एक्सटेंशन किस डिवाइस से कनेक्ट होगा।
वर्तमान कनेक्टेड डिवाइस हमेशा सूची में सबसे ऊपर दिखाई देगा, उसके बाद डिवाइस प्रकार (ब्रेन या कंट्रोलर) और प्लेटफॉर्म (IQ 2nd जनरेशन, EXP, और V5) द्वारा क्रमबद्ध अन्य सभी डिवाइस दिखाई देंगे।
प्रत्येक डिवाइस आइटम में ब्रेन नाम, प्लेटफॉर्म, डिवाइस प्रकार और डिवाइस पथ की जानकारी होती है।
महत्वपूर्ण
यदि कोई नियंत्रक कंप्यूटर से जुड़ा है, लेकिन उसका मस्तिष्क से रेडियो लिंक नहीं है, तो सूची आइटम या डिवाइस सूची स्थिति बार आइकन के आगे कोई मस्तिष्क नाम प्रदर्शित नहीं किया जाएगा।
स्लॉट चयनकर्ता
स्लॉट चयनकर्ता आइकन उपयोगकर्ता को यह चुनने की अनुमति देता है कि एक्सटेंशन किस स्लॉट पर उपयोगकर्ता प्रोग्राम डाउनलोड करेगा या चलाएगा।
जब स्लॉट चयनकर्ता आइकन पर क्लिक किया जाता है, तो उपलब्ध उपयोगकर्ता प्रोग्राम स्लॉट 1-8 के साथ एक त्वरित चयन सूची दिखाई देती है।
निर्माण/डाउनलोड
यदि VEX ब्रेन या VEX कंट्रोलर कनेक्ट किया गया है तो बिल्ड/डाउनलोड आइकन कार्य बदल देता है।
यदि कोई VEX डिवाइस कनेक्ट नहीं है तो बिल्ड आइकन दिखाया जाता है। क्लिक करने पर, प्रोजेक्ट केवल निर्मित होगा।
यदि कोई VEX डिवाइस कनेक्ट है, तो डाउनलोड आइकन दिखाया जाता है। क्लिक करने पर, प्रोजेक्ट निर्मित हो जाएगा और सफल होने पर, VEX डिवाइस पर डाउनलोड हो जाएगा।
खेल
प्ले आइकन पर क्लिक करने पर, चयनित स्लॉट में उपयोगकर्ता प्रोग्राम चलता है।
रुकना
स्टॉप आइकन पर क्लिक करने पर उपयोगकर्ता प्रोग्राम रुक जाता है।
चयनित कार्यक्षेत्र
वीएस कोड बहु कार्यक्षेत्र परियोजनाओं का समर्थन करता है। प्रोजेक्ट चयनकर्ता उपयोगकर्ताओं को VEX परियोजनाओं के बीच स्विच करने की अनुमति देता है, जब कार्यक्षेत्र के अंदर कई परियोजनाएं मौजूद हों।
जब प्रोजेक्ट चयनकर्ता आइकन पर क्लिक किया जाता है, तो सभी मान्य परियोजनाओं के साथ एक त्वरित चयन सूची दिखाई देती है।
महत्वपूर्ण
यदि कोई प्रोजेक्ट मान्य नहीं है, तो उसे प्रोजेक्ट त्वरित चयन सूची में नहीं दिखाया जाएगा। कोई प्रोजेक्ट तब तक मान्य नहीं होता जब तक उसे VEX VS Code एक्सटेंशन द्वारा बनाया या आयात नहीं किया गया हो।
पायथन फ़ाइल चयनकर्ता (केवल पायथन)
जब एक VEX पायथन प्रोजेक्ट का चयन किया जाता है तो पायथन फ़ाइल चयनकर्ता टूलबार में दिखाई देगा। VEX के लिए पायथन वर्तमान में केवल एकल फ़ाइल डाउनलोड का समर्थन करता है।
जब आइकन पर क्लिक किया जाता है, तो वर्कस्पेस निर्देशिका में स्थित सभी पायथन फ़ाइलों के साथ एक त्वरित चयन सूची दिखाई देती है।
पायथन फ़ाइल चयनकर्ता उपयोगकर्ता को पायथन स्रोत फ़ाइलों (.py) के बीच स्विच करने की अनुमति देता है।
VEX गतिविधि बार और साइडबार
परियोजनाएँ क्रियाएँ
VEX गतिविधि बार में प्रोजेक्ट क्रिया दृश्य और VEX डिवाइस जानकारी दृश्य शामिल होते हैं।
प्रोजेक्ट क्रिया दृश्य का उपयोग एक नया प्रोजेक्ट बनाने या मौजूदा VEXcode या VEXcode प्रो प्रोजेक्ट को आयात करने के लिए किया जाता है।
नया प्रोजेक्ट बनाने के बारे में अधिक जानकारी के लिए, देखें!
संस्करण जानकारी दृश्य के निचले बाएँ और दाएँ कोने में भी प्रदर्शित होती है।
महत्वपूर्ण
यदि कोई VEXcode या VEXcode Pro प्रोजेक्ट संपादक में खुला है तो इसे वैध VEX प्रोजेक्ट नहीं माना जाएगा, प्रोजेक्ट को VEX साइडबार में आयात बटन का उपयोग करके आयात करने की आवश्यकता है।
VEX डिवाइस जानकारी
VEX डिवाइस जानकारी दृश्य उपयोगकर्ता को कनेक्टेड VEX ब्रेन या VEX नियंत्रक का अवलोकन प्रदान करता है। VEXos संस्करण, सीरियल पोर्ट पथ, उपयोगकर्ता प्रोग्राम और डिवाइस जानकारी सभी इस दृश्य में पाई जा सकती हैं। अन्य कार्य जैसे VEXos फर्मवेयर अपडेट, स्क्रीन शॉट, ब्रेन नाम और सेटिंग टीम नंबर भी इस दृश्य के माध्यम से किए जा सकते हैं।
व्यवस्था जानकारी
सिस्टम जानकारी कनेक्टेड VEX डिवाइस का संक्षिप्त अवलोकन प्रदान करती है। इसमें डिवाइस का VEXos संस्करण, ब्रेन नाम, टीम नंबर, ब्रेन आईडी और पायथन रनटाइम संस्करण जानकारी शामिल है।
सीरियल पोर्ट जानकारी
सीरियल पोर्ट जानकारी VEX डिवाइस के लिए उपलब्ध प्रत्येक पोर्ट के लिए डिवाइस पथ प्रदर्शित करती है। अधिकांश VEX डिवाइस दो सीरियल पोर्ट के रूप में सूचीबद्ध होते हैं। संचार सीरियल पोर्ट का उपयोग प्रोग्राम डाउनलोड करने और मस्तिष्क के कार्यों को नियंत्रित करने के लिए किया जाता है। उपयोगकर्ता सीरियल पोर्ट का उपयोग ब्रेन पर चल रहे उपयोगकर्ता ऐप और यूएसबी के माध्यम से जुड़े होस्ट कंप्यूटर के बीच डेटा स्थानांतरित करने के लिए किया जाता है। V5 नियंत्रक एकमात्र VEX डिवाइस है जिसमें केवल संचार सीरियल पोर्ट है और कोई उपयोगकर्ता सीरियल पोर्ट नहीं है।
कार्यक्रम की जानकारी
प्रोग्राम जानकारी VEX ब्रेन पर सभी डाउनलोड किए गए उपयोगकर्ता प्रोग्रामों की सूची प्रदर्शित करती है।
प्रत्येक प्रोग्राम सूची आइटम को प्रत्येक उपयोगकर्ता प्रोग्राम के बारे में अतिरिक्त जानकारी दिखाने के लिए विस्तारित किया जा सकता है, जैसे स्लॉट स्थान, फ़ाइल नाम, भाषा प्रकार, फ़ाइल आकार और डाउनलोड का समय।
उपकरणों की जानकारी
डिवाइस जानकारी VEX ब्रेन से जुड़े सभी स्मार्ट पोर्ट डिवाइसों की सूची दिखाती है। प्रत्येक सूची आइटम स्मार्ट पोर्ट नंबर और डिवाइस प्रकार दिखाता है।
प्रत्येक डिवाइस सूची आइटम को प्रत्येक स्मार्ट पोर्ट डिवाइस के बारे में फर्मवेयर संस्करण जानकारी दिखाने के लिए विस्तारित किया जा सकता है।
VEX ब्रेन डिवाइस से कनेक्ट होने पर नियंत्रक लिंक स्थिति प्रदर्शित होती है।
VEX ब्रेन एक VEX नियंत्रक से जुड़ा हुआ है
VEX ब्रेन किसी VEX कंट्रोलर से जुड़ा नहीं है
VEX V5 नियंत्रक एक VEX V5 ब्रेन से जुड़ा हुआ है
स्क्रीन शॉट्स
कैमरा आइकन पर क्लिक करके, उपयोगकर्ता VEX ब्रेन से स्क्रीनशॉट ले सकता है और डाउनलोड कर सकता है।
केवल तभी उपलब्ध होते हैं जब USB के माध्यम से सीधे VEX ब्रेन से कनेक्ट किया जाता है।
बैटरी मेडिक (केवल V5 ब्रेन)
हार्ट आइकन पर क्लिक करने से, एक्सटेंशन बैटरी मेडिक उपयोगकर्ता प्रोग्राम को डाउनलोड और चलाएगा।
मस्तिष्क का नाम निर्धारित करें
सिस्टम>नाम के आगे पेंसिल आइकन पर क्लिक करके, उपयोगकर्ता VEX ब्रेन के लिए नाम सेट कर सकता है।
पेंसिल आइकन पर क्लिक करने के बाद, वीएस कोड एडिटर के शीर्ष पर एक इनपुट बॉक्स दिखाई देगा। इनपुट बॉक्स में नया मस्तिष्क नाम टाइप करें और सेट करने के लिए एंटर दबाएं।
टीम संख्या निर्धारित करें
सिस्टम>टीम के बगल में पेंसिल आइकन पर क्लिक करके, उपयोगकर्ता VEX ब्रेन के लिए टीम नंबर सेट कर सकता है।
पेंसिल आइकन पर क्लिक करने के बाद वीएस कोड एडिटर के शीर्ष पर एक इनपुट बॉक्स दिखाई देगा। इनपुट बॉक्स में नई टीम संख्या टाइप करें और सेट करने के लिए एंटर दबाएं।
उपयोगकर्ता प्रोग्राम मिटाएँ
प्रोग्राम>प्रोजेक्ट नाम के आगे ट्रैशकैन आइकन पर क्लिक करके, उपयोगकर्ता किसी विशिष्ट स्लॉट में प्रोग्राम को मिटा सकता है। महत्वपूर्ण, एक बार जब आप कोई प्रोग्राम मिटा देते हैं तो उसे पुनर्प्राप्त नहीं किया जा सकता है। कृपया इस सुविधा का उपयोग करते समय सावधानी बरतें।
डिवाइस जानकारी चेतावनियाँ
VEXos अपडेट
जब VEX ब्रेन का VEXos संस्करण पुराना हो जाता है, तो VEXos संस्करण के बगल में एक चेतावनी संदेश आइकन दिखाई देता है और दोनों ब्रेन आइकन पीले हो जाते हैं।
इस चेतावनी को हल करने के लिए उपयोगकर्ता को अपने VEXos ब्रेन के लिए VEXos को अपडेट करना चाहिए।
VEXos को VEX ब्रेन आइकन के बगल में ऊपर तीर पर क्लिक करके अपडेट किया जा सकता है।
इसके अलावा, जब VEXos पुराना हो जाएगा तो VS कोड संपादक के निचले दाएं कोने में एक अधिसूचना बॉक्स दिखाई देगा। उपयोगकर्ता "अपडेट" बटन पर क्लिक करके VEXos अपडेट शुरू कर सकता है या VEXos अपडेट को छोड़ने के लिए "अनदेखा" बटन पर क्लिक कर सकता है।
मस्तिष्क कनेक्टेड नियंत्रक से जुड़ा नहीं है
जब VEX नियंत्रक किसी कंप्यूटर से जुड़ा होता है, लेकिन VEX ब्रेन से लिंक नहीं होता है, तो VEX नियंत्रक आइकन पीले रंग में बदल जाएगा।
इस चेतावनी को हल करने के लिए उपयोगकर्ता को VEX कंट्रोलर को VEX ब्रेन से लिंक करना चाहिए
टर्मिनल पैनल
VEX VS कोड एक्सटेंशन स्टार्टअप पर दो टर्मिनल प्रदान करता है, लॉग टर्मिनल और इंटरैक्टिव टर्मिनल
लॉग टर्मिनल
लॉग टर्मिनल बिल्ड आउटपुट, बिल्ड त्रुटि और डाउनलोड परिणाम प्रदर्शित करता है।
इंटरैक्टिव टर्मिनल
इंटरएक्टिव टर्मिनल के दो कार्य हैं, प्रिंट लॉग प्रदर्शित करना और उपयोगकर्ता प्रोग्राम को कच्चे कीस्ट्रोक्स भेजना। इंटरैक्टिव टर्मिनल का लाभ उठाने के लिए ब्रेन या कंट्रोलर को VEX VS कोड एक्सटेंशन चलाने वाले कंप्यूटर से जोड़ा जाना चाहिए। उपयोगकर्ता प्रोग्राम बनाने और डाउनलोड करने के बाद इंटरैक्टिव टर्मिनल आउटपुट डिफ़ॉल्ट रूप से साफ़ हो जाता है।
उपयोगकर्ता सेटिंग्स
उपयोगकर्ता सेटिंग्स वैश्विक सेटिंग्स हैं जो विज़ुअल स्टूडियो कोड प्रत्येक एक्सटेंशन के लिए प्रदान करता है। उपयोगकर्ता सेटिंग्स प्रत्येक VEX VS कोड एक्सटेंशन प्रोजेक्ट पर लागू होती हैं।
VEX उपयोगकर्ता सेटिंग्स तक कैसे पहुँचें
वीएस कोड के बाएं कोने में गियर पर क्लिक करें और एक संदर्भ मेनू दिखाई देगा
संदर्भ मेनू में, “सेटिंग्स” आइटम पर क्लिक करें और एक सेटिंग पृष्ठ दिखाई देगा।
बाएं हाथ की सूची दृश्य में, “एक्सटेंशन” आइटम पर क्लिक करें। इसके बाद, नीचे स्क्रॉल करें और “VEX” लेबल वाला आइटम ढूंढें।
“VEX” सूची आइटम पर क्लिक करें।
VEX उपयोगकर्ता सेटिंग्स दाहिने पैनल में दिखाई देंगी।
सेटिंग्स अवलोकन
नियंत्रक चैनल (केवल V5 नियंत्रक)
नियंत्रक चैनल सेटिंग V5 ब्रेन और V5 नियंत्रक के बीच रेडियो संचार चैनल प्रकार को नियंत्रित करती है।
यह सेटिंग केवल तभी लागू होती है जब VS कोड USB के माध्यम से V5 नियंत्रक से जुड़ा हो और नियंत्रक VEXnet के माध्यम से V5 ब्रेन से जुड़ा हो। उपयोगकर्ता डाउनलोड और पिट चैनलों के बीच चयन कर सकता है। जब डाउनलोडपर सेट किया जाता है, तो उपयोगकर्ता प्रोग्राम डाउनलोड शुरू होने पर रेडियो डाउनलोड VEXnet चैनल पर चला जाएगा। डाउनलोड चैनल उच्च डेटा दर और अधिक कुशल डाउनलोड की अनुमति देता है। जब पिटपर सेट किया जाता है, तो रेडियो पिट चैनल पर ही रहेगा और डाउनलोड में अधिक समय लगेगा। डिफ़ॉल्ट रूप से यह सेटिंग डाउनलोडपर सेट है।
Cpp प्रोजेक्ट SDK होम
इस सेटिंग को संपादित न करें.
सीपीपी टूलचेन पथ
Cpp टूलचेन पथ C++ VEX VS कोड प्रोजेक्ट बनाते समय उपयोग किए जाने वाले टूलचेन के लिए पथ सेट करता है।
उपयोगकर्ता टर्मिनल सक्षम करें
उपयोगकर्ता टर्मिनल सक्षम करें सेटिंग एक्सटेंशन को उपयोगकर्ता सीरियल पोर्ट खोलने की अनुमति देती है जब एक्सटेंशन द्वारा VEX ब्रेन या VEX नियंत्रक का पता लगाया जाता है। एकमात्र अपवाद V5 नियंत्रक पर लागू होता है जो उपयोगकर्ता सीरियल पोर्ट के साथ सूचीबद्ध नहीं होता है।
सक्षम एक्सटेंशन को स्टार्टअप पर यूजरपोर्ट से कनेक्ट करने की अनुमति देता है और इंटरैक्टिव टर्मिनल बनाएगा। यदि एक्सटेंशन चालू होने के दौरान सक्षम का चयन किया जाता है, तो यदि कोई डिवाइस कनेक्ट है तो एक्सटेंशन यूजरपोर्ट को खोलने का प्रयास करेगा।
अक्षम स्टार्टअप पर एक्सटेंशन को यूजर पोर्ट से कनेक्ट होने से रोकता है और एक इंटरैक्टिव टर्मिनल नहीं बनाएगा। यदि एक्सटेंशन चालू होने के दौरान अक्षम का चयन किया जाता है, तो एक्सटेंशन उपयोगकर्ता पोर्ट को बंद कर देगा और इंटरैक्टिव टर्मिनल को हटा देगा।
परियोजना निर्माण प्रकार
प्रोजेक्ट बिल्ड प्रकार यह निर्धारित करता है कि एक्सटेंशन C++ प्रोजेक्ट का निर्माण कैसे करेगा। उपयोगकर्ता बिल्ड प्रकार को बिल्ड या रीबिल्ड पर सेट कर सकता है।
बिल्ड केवल तभी प्रोजेक्ट का निर्माण करता है जब मेक प्रोजेक्ट के स्रोत कोड में कोई परिवर्तन का पता लगाता है।
रीबिल्ड प्रोजेक्ट की बिल्ड निर्देशिका को साफ करता है, फिर प्रोजेक्ट का निर्माण करता है। यह विकल्प सामान्यतः बहुत धीमा होता है।
प्रोजेक्ट होम
प्रोजेक्ट होम नया प्रोजेक्ट विज़ार्ड पूरा करते समय नए प्रोजेक्ट के लिए डिफ़ॉल्ट होम निर्देशिका सेट करता है।
डाउनलोड के बाद चलाएँ
डाउनलोड के बाद चलाएँ जब सक्षम किया जाता है, तो उपयोगकर्ता प्रोग्राम को VEX ब्रेन पर डाउनलोड किए जाने के बाद चलाया जाता है।
पायथन SDK होम
इस सेटिंग को संपादित न करें.
VEX कमांड सहायता
VEX कमांड सहायता C++ और पायथन API (एप्लिकेशन प्रोग्रामिंग इंटरफ़ेस) में शामिल विशिष्ट कार्यों के लिए दस्तावेज़ तक पहुंच की अनुमति देती है। दस्तावेज़ीकरण प्रत्येक VEX प्लेटफ़ॉर्म (IQ 2nd Generation, EXP, V5) के लिए विशिष्ट है।
VEX कमांड सहायता तक पहुंचने के लिए, सबसे पहले खोजने के लिए फ़ंक्शन के पाठ को हाइलाइट करें।
चयनित पाठ पर राइट क्लिक करें, और एक संदर्भ मेनू दिखाई देगा।
अगला दस्तावेज़ तक पहुँचने के लिए VEX कमांड सहायता पर क्लिक करें।
यदि VEX कमांड सहायता को सटीक मिलान मिलता है, तो प्रासंगिक दस्तावेज़ों के साथ एक नया वेबव्यू दिखाई देगा।
यदि एकाधिक दस्तावेज़ चयनित पाठ से मेल खाते हैं, तो प्रासंगिक दस्तावेज़ों की फ़िल्टर की गई सूची के साथ एक ड्रॉप डाउन दिखाई देगा।