pico vscode

امتداد Raspberry Pi Pico Visual Studio Code

ملحوظة: الامتداد قيد التطوير حاليًا.

هذا هو امتداد Visual Studio Code الرسمي لتطوير Raspberry Pi Pico. يزودك هذا الامتداد بمجموعة من الأدوات المصممة لتبسيط مشاريع Pico الخاصة بك باستخدام Visual Studio Code وPico SDK الرسمي.

للحصول على تعليمات الإعداد الشاملة، راجع ملف PDF الخاص بدليل البدء.

تحميل أحدث بيتا؟

سمات

إعداد المشروع وإدارته

• مولد المشروع : يمكنك إنشاء مشاريع جديدة وتكوينها بسهولة مع دعم ميزات Pico المتقدمة مثل I2C وPIO. يستهدف المولد نظام بناء Ninja ويسمح بالتخصيص أثناء إنشاء المشروع.
• الإعداد السريع للمشروع : ابدأ مشاريع Pico الجديدة مباشرةً من عرض Explorer، عندما لا تكون هناك مساحة عمل مفتوحة.
• دعم MicroPython : إنشاء وتطوير مشاريع Pico المستندة إلى MicroPython مع الدعم المقدم من خلال ملحق MicroPico.

التكوين وإدارة الأدوات

• تكوين CMake التلقائي : يقوم بتكوين CMake تلقائيًا عند تحميل المشروع.
• تبديل الإصدار : التبديل بسلاسة بين الإصدارات المختلفة من Pico SDK والأدوات.
• لا يلزم الإعداد اليدوي : يتعامل تلقائيًا مع متغيرات البيئة وسلسلة الأدوات وSDK وإدارة الأدوات.
• يتضمن برنامج إلغاء التثبيت : قم بإزالة الامتداد بسهولة مع جميع الأدوات وحزم SDK المثبتة تلقائيًا.

البناء والتصحيح والتوثيق

• التجميع والتصحيح بنقرة واحدة : تكوين OpenOCD وNinja وCMake تلقائيًا، مما يسمح لك بالتجميع والتصحيح بنقرة واحدة.

• الوثائق دون اتصال : يمكنك الوصول بسهولة إلى وثائق Pico SDK مباشرة داخل المحرر، حتى في حالة عدم الاتصال بالإنترنت.

• تبديل الإصدار : التبديل بسلاسة بين الإصدارات المختلفة من Pico SDK والأدوات.

• لا يلزم الإعداد اليدوي : يتعامل الامتداد مع متغيرات البيئة وسلسلة الأدوات وSDK وإدارة الأدوات نيابةً عنك.

• التجميع بنقرة واحدة : قم بتجميع المشاريع مباشرةً من شريط الحالة باستخدام أدوات SDK والأدوات المحددة.

• التوثيق دون اتصال : الوصول إلى وثائق Pico SDK دون اتصال بالإنترنت.

• الإعداد السريع للمشروع : قم بإنشاء مشاريع Pico جديدة بسرعة من عرض Explorer عندما لا تكون هناك مساحة عمل مفتوحة.

• دعم MicroPython : قم بإنشاء مشاريع Pico المستندة إلى MicroPython مع الدعم المقدم من خلال ملحق MicroPico.

المتطلبات حسب نظام التشغيل

الأنظمة الأساسية المدعومة: Raspberry Pi OS (64 بت)، Windows 10/11 (x86_64)، macOS Sonoma (14.0) والأحدث، Linux x64 وarm64

• Visual Studio Code v1.92.1 أو الأحدث

نظام تشغيل راسبيري باي وويندوز

ليست هناك حاجة لمتطلبات إضافية.

ماك

لتلبية متطلبات نظام التشغيل macOS، قم بتشغيل الأمر التالي في الوحدة الطرفية لتثبيت الأدوات الضرورية:

xcode-select --install

يقوم هذا الأمر بتثبيت كافة الأدوات الضرورية، بما في ذلك على سبيل المثال لا الحصر:

• Git 2.28 أو الأحدث (تأكد من وجوده في المسار الخاص بك)
• القطران (تأكد من وجوده في المسار الخاص بك)

لينكس

• Python 3.9 أو الأحدث (تأكد من وجوده في PATH أو ضبطه في الإعدادات)
• Git 2.28 أو الأحدث (تأكد من وجوده في المسار الخاص بك)
• القطران (تأكد من وجوده في المسار الخاص بك)
• [اختياري] gdb-multiarch لتصحيح الأخطاء (x86_64 فقط)
• بالنسبة لـ [Ubuntu 22.04] ، قم بتثبيت حزم libftdi1-2 و libhidapi-hidraw0 لاستخدام OpenOCD

إعدادات الامتداد

يوفر هذا الملحق الإعدادات التالية:

• raspberry-pi-pico.cmakePath : حدد مسارًا مخصصًا لـ CMake.
• raspberry-pi-pico.python3Path : حدد مسارًا مخصصًا لـ Python 3 (تحديد نطاق الآلة) .
• raspberry-pi-pico.ninjaPath : حدد مسارًا مخصصًا لـ Ninja.
• raspberry-pi-pico.gitPath : حدد مسارًا مخصصًا لـ Git.
• raspberry-pi-pico.cmakeAutoConfigure : قم بتوفير رمز وصول شخصي لـ GitHub (كلاسيكي) باستخدام نطاق public_repo . يتم استخدام هذا الرمز للتحقق من الإصدارات المتوفرة من Pico SDK والأدوات الأخرى. وبدون ذلك، يستخدم الامتداد واجهة برمجة تطبيقات GitHub غير المصادق عليها، والتي لها حد أقل للسعر وقد يؤدي إلى تقييد الوظائف في حالة تجاوز الحد. الحد الأقصى لمعدل عدم المصادقة هو لكل عنوان IP عام، لذا يكون الرمز المميز أكثر أهمية إذا تمت مشاركة عنوان IP الخاص بك مع العديد من المستخدمين.

تكامل ملحق أدوات CMake

بالنسبة للمشروعات الأكثر تعقيدًا، مثل تلك التي تحتوي على ملفات تنفيذية متعددة أو عندما يتم تعريف اسم المشروع كمتغير، يمكن أن يتكامل هذا الامتداد مع ملحق CMake Tools لتحسين تحليل CMake. يمكنك تمكين تكامل أدوات CMake أثناء إنشاء المشروع ضمن الخيارات المتقدمة . بالإضافة إلى ذلك، لتمكينه يدويًا، اضبط الإعدادات التالية في settings.json الخاص بك:

• raspberry-pi-pico.cmakeAutoConfigure : اضبط من true إلى false .
• raspberry-pi-pico.useCmakeTools : اضبط من false إلى true .

للحصول على الأداء الأمثل، فكر في تمكين:

• cmake.configureOnEdit : صحيح
• cmake.automaticReconfigure : صحيح
• cmake.configureOnOpen : صحيح

عندما يُطلب منك ذلك، حدد مجموعة Pico في أدوات CMake، وقم بتعيين أهداف الإنشاء والتشغيل وفقًا لذلك. استخدم أدوات CMake للتجميع، ولكن استمر في استخدام هذا الامتداد لتصحيح الأخطاء، حيث أن تصحيح أخطاء CMake Tools غير متوافق مع Pico.

ملفات تعريف رمز VS

إذا كنت تعمل باستخدام سلاسل أدوات متعددة لوحدات التحكم الدقيقة، ففكر في تثبيت هذا الامتداد في ملف تعريف VS Code لتجنب التعارضات مع سلاسل الأدوات الأخرى. اتبع الخطوات التالية:

1. قم بتنزيل ملف التعريف النموذجي من هنا.
2. افتح لوحة الأوامر باستخدام Ctrl+Shift+P (أو Cmd+Shift+P على نظام التشغيل macOS) وحدد Profiles: Import Profile .
3. قم باستيراد الملف الذي تم تنزيله لتثبيت الامتداد في ملف تعريف Pico مخصص.
4. يساعد هذا الإعداد على عزل امتداد Pico عن الامتدادات الأخرى، مما يقلل من مخاطر التعارضات.

القضايا المعروفة

• المسارات المخصصة: لا يتم تخزين المسارات المخصصة لـ Ninja وPython3 وGit في CMakeLists.txt مثل مسارات SDK وToolchain. تحتاج إلى إنشاء المشاريع وتكوينها من خلال الامتداد لاستخدام هذه المسارات المخصصة.

حد معدل واجهة برمجة تطبيقات GitHub ("حدث خطأ أثناء استرداد إصدارات SDK وسلسلة الأدوات")

إذا واجهت مشكلات في استرداد إصدارات Pico SDK المتاحة، فقد يكون ذلك بسبب حدود معدل GitHub API. لحل هذه المشكلة، قم بإنشاء رمز وصول شخصي (PAT كلاسيكي) باستخدام نطاق public_repo وقم بتعيينه في إعدادات الامتداد العامة (المستخدم) لزيادة حد السعر الخاص بك.

تعليمات البناء

بالنسبة للمستخدمين المتقدمين الذين يريدون إنشاء الملف الملحق .vsix ، اتبع الخطوات التالية:

1. تثبيت العقدة (تعليمات Windows)
2. تثبيت الغزل على مستوى العالم: npm install -g yarn
3. تثبيت VSCE عالميًا: npm install -g @vscode/vsce
4. قم بتشغيل yarn في دليل المشروع لتثبيت التبعيات.
5. أنشئ الامتداد باستخدام: vsce package .

سيؤدي هذا إلى إنشاء ملف .vsix ، والذي يمكنك تثبيته في VS Code باستخدام code --install-extension path-to.vsix أو عبر واجهة المستخدم الرسومية: Extensions > three dots > Install from VSIX .