vscode จุดสูงสุด

ส่วนขยายรหัส Raspberry Pi Pico Visual Studio

หมายเหตุ: ส่วนขยายนี้อยู่ระหว่างการพัฒนา

นี่คือส่วนขยายโค้ด Visual Studio อย่างเป็นทางการสำหรับการพัฒนา Raspberry Pi Pico ส่วนขยายนี้มาพร้อมกับชุดเครื่องมือที่ออกแบบมาเพื่อปรับปรุงโครงการ Pico ของคุณโดยใช้ Visual Studio Code และ Pico SDK อย่างเป็นทางการ

สำหรับคำแนะนำในการตั้งค่าที่ครอบคลุม โปรดดูคู่มือการเริ่มต้นใช้งาน PDF

ดาวน์โหลดเบต้าล่าสุด ?

คุณสมบัติ

การตั้งค่าโครงการและการจัดการ

• Project Generator : สร้างและกำหนดค่าโปรเจ็กต์ใหม่ได้อย่างง่ายดายด้วยการรองรับฟีเจอร์ Pico ขั้นสูง เช่น I2C และ PIO เครื่องกำเนิดไฟฟ้ากำหนดเป้าหมายไปที่ระบบการสร้างนินจาและอนุญาตให้ปรับแต่งระหว่างการสร้างโครงการ
• การตั้งค่าโครงการด่วน : เริ่มต้นโครงการ 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 v1.92.1 หรือใหม่กว่า

ระบบปฏิบัติการ Raspberry Pi และ Windows

ไม่จำเป็นต้องมีข้อกำหนดเพิ่มเติม

ระบบปฏิบัติการ macOS

เพื่อให้เป็นไปตามข้อกำหนดสำหรับ macOS ให้รันคำสั่งต่อไปนี้ใน Terminal เพื่อติดตั้งเครื่องมือที่จำเป็น:

xcode-select --install

คำสั่งนี้จะติดตั้งเครื่องมือที่จำเป็นทั้งหมด รวมถึงแต่ไม่จำกัดเฉพาะ:

• Git 2.28 หรือใหม่กว่า (ตรวจสอบให้แน่ใจว่าอยู่ใน PATH ของคุณ)
• Tar (ตรวจสอบให้แน่ใจว่าอยู่ใน PATH ของคุณ)

ลินุกซ์

• Python 3.9 หรือใหม่กว่า (ตรวจสอบให้แน่ใจว่าอยู่ใน PATH ของคุณหรือตั้งค่าไว้ในการตั้งค่า)
• Git 2.28 หรือใหม่กว่า (ตรวจสอบให้แน่ใจว่าอยู่ใน PATH ของคุณ)
• Tar (ตรวจสอบให้แน่ใจว่าอยู่ใน PATH ของคุณ)
• [ไม่บังคับ] 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 : ระบุเส้นทางที่กำหนดเองสำหรับนินจา
• raspberry-pi-pico.gitPath : ระบุเส้นทางที่กำหนดเองสำหรับ Git
• raspberry-pi-pico.cmakeAutoConfigure : จัดเตรียมโทเค็นการเข้าถึงส่วนบุคคล GitHub (คลาสสิก) ด้วยขอบเขต public_repo โทเค็นนี้ใช้เพื่อตรวจสอบ Pico SDK เวอร์ชันที่มีอยู่และเครื่องมืออื่นๆ หากไม่มีส่วนขยายดังกล่าว ส่วนขยายจะใช้ GitHub API ที่ไม่ได้รับการตรวจสอบสิทธิ์ ซึ่งมีขีดจำกัดอัตราที่ต่ำกว่า และอาจนำไปสู่ฟังก์ชันการทำงานที่ถูกจำกัดหากเกินขีดจำกัด ขีดจำกัดอัตราที่ไม่ได้รับการตรวจสอบสิทธิ์นั้นเป็นไปตามที่อยู่ 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 Tools และกำหนดเป้าหมายการสร้างและการเปิดตัวของคุณตามลำดับ ใช้เครื่องมือ CMake สำหรับการคอมไพล์ แต่ใช้ส่วนขยายนี้เพื่อแก้ไขข้อบกพร่องต่อไป เนื่องจากการดีบักเครื่องมือ CMake เข้ากันไม่ได้กับ Pico

โปรไฟล์รหัส VS

หากคุณทำงานกับ Toolchain ของไมโครคอนโทรลเลอร์หลายตัว ให้พิจารณาติดตั้งส่วนขยายนี้ลงใน VS Code Profile เพื่อหลีกเลี่ยงความขัดแย้งกับ Toolchain อื่นๆ ทำตามขั้นตอนเหล่านี้:

1. ดาวน์โหลดโปรไฟล์ตัวอย่างได้จากที่นี่
2. เปิด Command Palette ด้วย Ctrl+Shift+P (หรือ Cmd+Shift+P บน macOS) และเลือก Profiles: Import Profile
3. นำเข้าไฟล์ที่ดาวน์โหลดมาเพื่อติดตั้งส่วนขยายในโปรไฟล์ Pico เฉพาะ
4. การตั้งค่านี้ช่วยแยกส่วนขยาย Pico ออกจากส่วนขยายอื่นๆ ซึ่งช่วยลดความเสี่ยงของข้อขัดแย้ง

ปัญหาที่ทราบ

• เส้นทางที่กำหนดเอง: เส้นทางที่กำหนดเองสำหรับ Ninja, Python3 และ Git จะไม่ถูกจัดเก็บไว้ใน CMakeLists.txt เช่นเดียวกับเส้นทาง SDK และ Toolchain คุณต้องสร้างและกำหนดค่าโปรเจ็กต์ผ่านส่วนขยายเพื่อใช้เส้นทางที่กำหนดเองเหล่านี้

ขีดจำกัดอัตรา GitHub API ("ข้อผิดพลาดขณะเรียกข้อมูล SDK และเวอร์ชัน toolchain")

หากคุณพบปัญหาในการเรียกข้อมูลเวอร์ชัน Pico SDK ที่พร้อมใช้งาน อาจเนื่องมาจากขีดจำกัดอัตรา GitHub API หากต้องการแก้ไขปัญหานี้ ให้สร้างโทเค็นการเข้าถึงส่วนบุคคล (PAT แบบคลาสสิก) ด้วยขอบเขต public_repo และตั้งค่าในการตั้งค่าส่วนขยายส่วนกลาง (ผู้ใช้) เพื่อเพิ่มขีดจำกัดอัตราของคุณ

คำแนะนำในการสร้าง

สำหรับผู้ใช้ขั้นสูงที่ต้องการสร้างไฟล์นามสกุล .vsix ให้ทำตามขั้นตอนเหล่านี้:

1. ติดตั้ง nodejs (คำแนะนำ Windows)
2. ติดตั้ง Yarn ทั่วโลก: 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 หรือผ่าน GUI: Extensions > three dots > Install from VSIX