هذه المقالة عبارة عن نظرة عامة على VEX Visual Studio Code Extension UI (واجهة المستخدم). يدعم الامتداد تطوير مشاريع C++ وPython لمنصات VEX IQ من الجيل الثاني وEXP وV5.
مكونات واجهة المستخدم
هناك 3 مكونات رئيسية لملحق كود VEX VS.
- شريط الأدوات
- شريط النشاط والشريط الجانبي
- لوحة المحطة الطرفية
شريط الأدوات
يوفر شريط الأدوات للمستخدمين طريقة سريعة للتفاعل مع مشاريع VEX VS Code الإضافية VEX Brains و VEX Controllers. لا يتم تفعيل شريط الأدوات إلا عند فتح مشروع VEX صالح في VS Code. مشروع VEX الصالح هو مشروع تم إنشاؤه أو استيراده بواسطة الامتداد. إن فتح مشروع VEXcode أو VEXcode Pro غير صالح ويجب استيراده.
منتقي الجهاز
منتقي الجهاز له وظيفتان رئيسيتان. أولاً، يعرض رمز الدماغ أو وحدة التحكم التي تمثل نوع جهاز VEX المتصل.
ثانيًا، عند النقر فوق أيقونة قائمة الأجهزة، تظهر قائمة اختيار سريع مع جميع أجهزة VEX المتصلة. يمكن للمستخدم تحديد الجهاز الذي سيتصل به الامتداد.
سيظهر دائمًا الجهاز المتصل الحالي في أعلى القائمة متبوعًا بجميع الأجهزة الأخرى مرتبة حسب نوع الجهاز (الدماغ أو جهاز التحكم) والنظام الأساسي (IQ 2nd Generation وEXP وV5).
يحتوي كل عنصر جهاز على معلومات اسم الدماغ والنظام الأساسي ونوع الجهاز ومسار الجهاز.
مهم
إذا كانت وحدة التحكم متصلة بجهاز كمبيوتر، ولكن ليس لديها ارتباط لاسلكي بالدماغ، فلن يتم عرض اسم الدماغ بجوار عنصر القائمة أو رمز شريط حالة قائمة الأجهزة.
محدد الفتحة
يتيح رمز محدد الفتحة للمستخدم اختيار الفتحة التي سيقوم الملحق بتنزيل برنامج المستخدم أو تشغيله عليها.
عند النقر فوق أيقونة محدد الفتحة، تظهر قائمة اختيار سريع بفتحات برنامج المستخدم المتوفرة من 1 إلى 8.
بناء / تنزيل
تعمل أيقونة البناء/التنزيل على تغيير الوظائف إذا كان VEX Brain أو وحدة تحكم VEX متصلة.
إذا لم يكن جهاز VEX متصلاً، فسيتم عرض أيقونة البناء. عند النقر عليه، سيتم بناء المشروع فقط.
إذا كان جهاز VEX متصلاً، فسيتم عرض أيقونة التنزيل. عند النقر عليه، سيتم إنشاء المشروع، وإذا نجح، سيتم تنزيله على جهاز VEX.
يلعب
يقوم رمز التشغيل، عند النقر عليه، بتشغيل برنامج المستخدم في الفتحة المحددة.
قف
تقوم أيقونة الإيقاف، عند النقر عليها، بإيقاف برنامج المستخدم.
مساحة العمل المحددة
يدعم VS Code مشاريع مساحات العمل المتعددة. يسمح محدد المشروع للمستخدمين بالتبديل بين مشاريع VEX عند وجود عدة مشاريع داخل مساحة العمل.
عند النقر على أيقونة محدد المشروع، تظهر قائمة اختيار سريعة تتضمن جميع المشاريع الصالحة.
هام
إذا كان المشروع غير صالح، فلن يظهر في قائمة الاختيار السريع للمشروع. لا يُعتبر المشروع صالحًا إلا إذا تم إنشاؤه أو استيراده بواسطة إضافة VEX VS Code.
محدد ملف بايثون (بايثون فقط)
عند تحديد مشروع VEX بايثون، سيظهر محدد ملف بايثون في شريط الأدوات. يدعم Python for VEX تنزيلات الملفات الفردية فقط حاليًا.
عند النقر على الأيقونة، تظهر قائمة اختيار سريعة تحتوي على جميع ملفات python الموجودة في دليل مساحة العمل.
يسمح محدد ملف python للمستخدم بالتبديل بين ملفات مصدر python(.py)
شريط نشاط VEX والشريط الجانبي
إجراءات المشاريع
يحتوي شريط نشاط vex على عرض إجراءات المشروع وعرض معلومات جهاز VEX.
يتم استخدام عرض إجراءات المشروع لإنشاء مشروع جديد أو استيراد مشروع VEXcode أو VEXcode Pro موجود.
لمزيد من المعلومات حول إنشاء مشروع جديد، راجع هذه المقالة!
يتم أيضًا عرض معلومات الإصدار في الركن السفلي الأيسر والأيمن من العرض.
هام
إذا كان مشروع VEXcode أو VEXcode Pro مفتوحًا في المحرر، فلن يتم اعتباره مشروع VEX صالحًا، ويجب استيراد المشروع باستخدام زر الاستيراد في الشريط الجانبي VEX.
معلومات جهاز VEX
توفر طريقة عرض معلومات جهاز VEX للمستخدم نظرة عامة على VEX Brain أو وحدة التحكم VEX المتصلة. يمكن العثور على إصدار VEXos ومسار المنفذ التسلسلي وبرنامج المستخدم ومعلومات الجهاز في طريقة العرض هذه. يمكن أيضًا تنفيذ وظائف أخرى مثل تحديثات البرامج الثابتة VEXos ولقطات الشاشة وتعيين اسم الدماغ ورقم فريق الإعدادات من خلال هذا العرض أيضًا.
معلومات النظام
توفر معلومات النظام نظرة عامة مختصرة على جهاز VEX المتصل. يتضمن ذلك إصدار VEXos للجهاز واسم Brain ورقم الفريق ومعرف Brain ومعلومات إصدار وقت تشغيل python.
معلومات المنفذ التسلسلي
تعرض معلومات المنفذ التسلسلي مسار الجهاز لكل منفذ متاح لجهاز VEX. يتم تعداد معظم أجهزة VEX كمنفذين تسلسليين. يستخدم المنفذ التسلسلي للاتصالات لتنزيل البرامج والتحكم في وظائف المخ. يُستخدم المنفذ التسلسلي للمستخدم لنقل البيانات بين تطبيق المستخدم الذي يعمل على Brain والكمبيوتر المضيف المتصل عبر USB. وحدة التحكم V5 هي جهاز VEX الوحيد الذي يحتوي فقط على منفذ تسلسلي للاتصالات ولا يوجد به منفذ تسلسلي للمستخدم.
معلومات البرامج
تعرض معلومات البرنامج قائمة بجميع برامج المستخدم التي تم تنزيلها على VEX Brain.
يمكن توسيع كل عنصر في قائمة البرامج لإظهار معلومات إضافية حول كل برنامج مستخدم، مثل موقع الفتحة واسم الملف ونوع اللغة والملف ووقت التنزيل.
معلومات الأجهزة
تعرض معلومات الأجهزة قائمة بجميع أجهزة المنافذ الذكية المتصلة بـ VEX Brain. يعرض كل عنصر في القائمة رقم المنفذ الذكي ونوع الجهاز.
يمكن توسيع كل عنصر في قائمة الأجهزة لإظهار معلومات إصدار البرنامج الثابت حول كل جهاز منفذ ذكي.
يتم عرض حالة ربط وحدة التحكم عند توصيلها بجهاز VEX Brain.
يرتبط VEX Brain بوحدة تحكم VEX
VEX Brain غير مرتبط بوحدة تحكم VEX
وحدة التحكم VEX V5 مرتبطة بدماغ VEX V5
لقطات الشاشة
من خلال النقر على أيقونة الكاميرا، يمكن للمستخدم التقاط لقطة شاشة وتنزيلها من VEX Brain.
لا تتوفر لقطات الشاشة إلا عند توصيلها مباشرة بـ VEX Brain عبر USB
طبيب البطارية (V5 Brain فقط)
من خلال النقر على أيقونة القلب، سيقوم الملحق بتنزيل وتشغيل برنامج مستخدم مسعف البطارية.
تعيين اسم الدماغ
من خلال النقر على أيقونة القلم الرصاص بجوار اسم النظام>، يمكن للمستخدم تعيين اسم لـ VEX Brain.
بعد النقر على أيقونة القلم الرصاص، سيظهر مربع إدخال أعلى محرر VS Code. اكتب اسم الدماغ الجديد في مربع الإدخال واضغط على زر الإدخال للضبط.
تعيين رقم الفريق
من خلال النقر على أيقونة القلم الرصاص بجوار فريق System->، يمكن للمستخدم تعيين رقم الفريق لـ VEX Brain.
بعد النقر على أيقونة القلم الرصاص، سيظهر مربع إدخال أعلى محرر VS Code. اكتب رقم الفريق الجديد في مربع الإدخال واضغط على زر الإدخال للضبط.
مسح برنامج المستخدم
من خلال النقر على أيقونة Trashcan بجوار اسم مشروع البرامج>، يمكن للمستخدم مسح برنامج في فتحة معينة. هام، بمجرد مسح برنامج ما، لا يمكن استعادته. يرجى توخي الحذر عند استخدام هذه الميزة.
تحذيرات معلومات الجهاز
تحديث فيكسوس
عندما يصبح إصدار VEXos الخاص بـ VEX Brain قديمًا، تظهر أيقونة رسالة تحذير بجوار إصدار VEXos ويتحول رمزا Brain إلى اللون الأصفر.
لحل هذا التحذير، يجب على المستخدم تحديث VEXos لـ VEXos Brain.
يمكن تحديث VEXos بالنقر فوق السهم لأعلى بجوار أيقونة VEX Brain.
سيظهر أيضًا مربع إعلام في الركن الأيمن السفلي من محرر VS Code عندما يكون VEXos قديمًا. يمكن للمستخدم بدء تحديث VEXos بالنقر فوق الزر "تحديث" أو النقر فوق الزر "تجاهل" لتخطي تحديث VEXos.
الدماغ غير مرتبط بوحدة التحكم المتصلة
سيتحول رمز وحدة التحكم VEX إلى اللون الأصفر عندما تكون وحدة التحكم VEX متصلة بجهاز كمبيوتر، ولكنها غير مرتبطة بـ VEX Brain.
لحل هذا التحذير، يجب على المستخدم ربط وحدة تحكم VEX بدماغ VEX
لوحة المحطة الطرفية
يوفر ملحق رمز VEX VS محطتين عند بدء التشغيل، محطة السجل والمحطة التفاعلية
محطة السجل
تعرض محطة السجل مخرجات البناء وخطأ البناء ونتائج التنزيل.
المحطة التفاعلية
تحتوي الوحدة الطرفية التفاعلية على وظيفتين، عرض سجلات الطباعة وإرسال ضغطات المفاتيح الأولية مرة أخرى إلى برنامج المستخدم. من أجل الاستفادة من المحطة التفاعلية، يجب توصيل الدماغ أو وحدة التحكم بجهاز كمبيوتر يقوم بتشغيل ملحق VEX VS Code. يتم مسح مخرجات المحطة التفاعلية افتراضيًا بعد إنشاء برنامج مستخدم وتنزيله.
إعدادات المستخدم
إعدادات المستخدم هي إعدادات إعدادات عامة يقدمها كود الاستوديو المرئي لكل ملحق. يتم تطبيق إعدادات المستخدم على كل مشروع ملحق VEX VS Code.
كيفية الوصول إلى إعدادات مستخدم VEX
انقر فوق الترس الموجود في الزاوية اليسرى من VS Code وستظهر قائمة السياق
في قائمة السياق، انقر فوق عنصر "الإعدادات" وستظهر صفحة الإعدادات.
في عرض القائمة على الجانب الأيسر، انقر فوق عنصر "الامتدادات". بعد ذلك، قم بالتمرير لأسفل إلى الأسفل وابحث عن العنصر المسمى "VEX".
انقر فوق عنصر القائمة "VEX".
ستظهر إعدادات مستخدم VEX في اللوحة اليمنى.
نظرة عامة على الإعدادات
قناة وحدة التحكم (وحدة التحكم V5 فقط)
يتحكم إعداد قناة التحكم في نوع قناة الاتصال اللاسلكي بين V5 Brain وV5 Controller.
ينطبق هذا الإعداد فقط عندما يكون VS Code متصلاً بوحدة تحكم V5 عبر USB وتكون وحدة التحكم متصلة بـ V5 Brain عبر VEXnet. يمكن للمستخدم الاختيار بين تنزيل و قنوات. عند التعيين على تنزيل، سينتقل الراديو إلى قناة تنزيل VEXnet بمجرد بدء تنزيل برنامج المستخدم. تتيح قناة التنزيل معدلات بيانات أعلى وتنزيلات أكثر كفاءة. عند الضبط على Pit، سيبقى الراديو على قناة Pit وسيستغرق التنزيل وقتًا أطول بكثير. افتراضيًا، يتم تعيين هذا الإعداد على تنزيل.
الصفحة الرئيسية لمشروع Cpp SDK
لا تقم بتحرير هذا الإعداد.
مسار سلسلة أدوات Cpp
مسار سلسلة أدوات C++ يحدد مسار سلسلة الأدوات المستخدمة عند إنشاء مشروع C++ VEX VS Code.
تمكين محطة المستخدم
يسمح الإعداد Enable User Terminal للامتداد بفتح المنفذ التسلسلي للمستخدم عند اكتشاف VEX Brain أو وحدة تحكم VEX بواسطة الامتداد. ينطبق الاستثناء الوحيد على وحدة التحكم V5 التي لا تتضمن منفذًا تسلسليًا للمستخدم.
Enable يسمح للامتداد بالاتصال بمنفذ مستخدم عند بدء التشغيل وسيقوم بإنشاء المحطة التفاعلية. إذا تم تحديد تمكين أثناء تشغيل الامتداد، فسيحاول الامتداد فتح منفذ المستخدم إذا كان الجهاز متصلاً.
Disable يمنع الامتداد من الاتصال بمنفذ المستخدم عند بدء التشغيل ولن يقوم بإنشاء محطة طرفية تفاعلية. إذا تم تحديد تعطيل أثناء تشغيل الملحق، فسيقوم الملحق بإغلاق منفذ المستخدم وإزالة الوحدة الطرفية التفاعلية.
نوع بناء المشروع
نوع إنشاء المشروع يحدد كيفية إنشاء الامتداد لمشروع C++. يمكن للمستخدم ضبط نوع البناء على Build أو Rebuild.
Build يقوم ببناء المشروع فقط عندما يكتشف Make أي تغييرات في الكود المصدري للمشروع.
Rebuild ينظف دليل بناء المشروع، ثم يبني المشروع. عادةً ما يكون هذا الخيار أبطأ بكثير.
الصفحة الرئيسية للمشروع
Project Home يقوم بتعيين الدليل الرئيسي الافتراضي لمشروع جديد عند إكمال معالج المشروع الجديد.
تشغيل بعد التحميل
التشغيل بعد التنزيل عند تمكينه، يؤدي إلى تشغيل برنامج المستخدم بعد تنزيله على VEX Brain.
الصفحة الرئيسية لبيثون SDK
لا تقم بتحرير هذا الإعداد.
تعليمات أمر VEX
تسمح VEX Command Help بالوصول إلى الوثائق الخاصة بوظائف محددة مضمنة في C++ وPython API (واجهة برمجة التطبيقات). التوثيق خاص بكل منصة VEX (IQ 2nd Generation، EXP، V5).
للوصول إلى تعليمات VEX Command، قم أولاً بتمييز نص الوظيفة المطلوب البحث عنها.
انقر بزر الماوس الأيمن على النص المحدد، وسوف تظهر قائمة السياق.
التالي انقر فوق تعليمات VEX Command للوصول إلى الوثائق.
إذا وجدت مساعدة VEX Command تطابقًا تامًا، فسوف يظهر عرض ويب جديد مع الوثائق ذات الصلة.
إذا تطابقت عدة مستندات مع النص المحدد، فستظهر قائمة منسدلة تحتوي على قائمة تمت تصفيتها بالوثائق ذات الصلة.