pico vscode

Ekstensi Kode Visual Studio Raspberry Pi Pico

Catatan: Ekstensi ini sedang dalam pengembangan.

Ini adalah ekstensi resmi Visual Studio Code untuk pengembangan Raspberry Pi Pico. Ekstensi ini membekali Anda dengan serangkaian alat yang dirancang untuk menyederhanakan proyek Pico Anda menggunakan Visual Studio Code dan Pico SDK resmi.

Untuk instruksi pengaturan yang komprehensif, lihat panduan Memulai PDF.

Unduh Beta terbaru?

Fitur

Pengaturan dan Manajemen Proyek

• Project Generator : Membuat dan mengonfigurasi proyek baru dengan mudah dengan dukungan fitur Pico tingkat lanjut seperti I2C dan PIO. Generator menargetkan sistem pembangunan Ninja dan memungkinkan penyesuaian selama pembuatan proyek.
• Pengaturan Proyek Cepat : Memulai proyek Pico baru langsung dari tampilan Explorer, ketika tidak ada ruang kerja yang terbuka.
• Dukungan MicroPython : Membuat dan mengembangkan proyek Pico berbasis MicroPython dengan dukungan yang diberikan melalui ekstensi MicroPico.

Konfigurasi dan Manajemen Alat

• Konfigurasi CMake Otomatis : Secara otomatis mengonfigurasi CMake saat memuat proyek.
• Peralihan Versi : Beralih dengan mulus di antara berbagai versi Pico SDK dan alat.
• Tidak Diperlukan Penyiapan Manual : Secara otomatis menangani variabel lingkungan, rantai alat, SDK, dan manajemen alat.
• Termasuk Uninstaller : Hapus ekstensi dengan mudah beserta semua alat dan SDK yang diinstal secara otomatis.

Bangun, Debug, dan Dokumentasi

• Kompilasi dan Debugging Sekali Klik : Secara otomatis mengkonfigurasi OpenOCD, Ninja, dan CMake, memungkinkan Anda untuk mengkompilasi dan men-debug dengan satu klik.

• Dokumentasi Offline : Akses dokumentasi Pico SDK dengan mudah langsung di dalam editor, bahkan saat offline.

• Peralihan Versi : Beralih dengan mulus di antara berbagai versi Pico SDK dan alat.

• Tidak Diperlukan Penyiapan Manual : Ekstensi ini menangani variabel lingkungan, rantai alat, SDK, dan manajemen alat untuk Anda.

• Kompilasi Sekali Klik : Kompilasi proyek langsung dari bilah status dengan SDK dan alat pilihan Anda.

• Dokumentasi Offline : Akses dokumentasi Pico SDK secara offline.

• Pengaturan Proyek Cepat : Buat proyek Pico baru dengan cepat dari tampilan Explorer ketika tidak ada ruang kerja yang terbuka.

• Dukungan MicroPython : Membuat proyek Pico berbasis MicroPython dengan dukungan yang diberikan melalui ekstensi MicroPico.

Persyaratan berdasarkan OS

Platform yang Didukung: Raspberry Pi OS (64-bit), Windows 10/11 (x86_64), macOS Sonoma (14.0) dan yang lebih baru, Linux x64 dan arm64

• Visual Studio Code v1.92.1 atau lebih baru

Raspberry Pi OS dan Windows

Tidak diperlukan persyaratan tambahan.

macOS

Untuk memenuhi persyaratan macOS, jalankan perintah berikut di Terminal untuk menginstal alat yang diperlukan:

xcode-select --install

Perintah ini menginstal semua alat yang diperlukan, termasuk namun tidak terbatas pada:

• Git 2.28 atau lebih baru (pastikan ada di PATH Anda)
• Tar (pastikan ada di PATH Anda)

Linux

• Python 3.9 atau lebih baru (pastikan itu ada di PATH Anda atau diatur di pengaturan)
• Git 2.28 atau lebih baru (pastikan ada di PATH Anda)
• Tar (pastikan ada di PATH Anda)
• [Opsional] gdb-multiarch untuk debugging (khusus x86_64)
• Untuk [Ubuntu 22.04] , instal paket libftdi1-2 dan libhidapi-hidraw0 untuk menggunakan OpenOCD

Pengaturan Ekstensi

Ekstensi ini menyediakan pengaturan berikut:

• raspberry-pi-pico.cmakePath : Tentukan jalur khusus untuk CMake.
• raspberry-pi-pico.python3Path : Tentukan jalur khusus untuk Python 3 (cakupan mesin) .
• raspberry-pi-pico.ninjaPath : Tentukan jalur khusus untuk Ninja.
• raspberry-pi-pico.gitPath : Tentukan jalur khusus untuk Git.
• raspberry-pi-pico.cmakeAutoConfigure : Menyediakan token akses pribadi GitHub (klasik) dengan cakupan public_repo . Token ini digunakan untuk memeriksa versi Pico SDK dan alat lainnya yang tersedia. Tanpanya, ekstensi akan menggunakan API GitHub yang tidak diautentikasi, yang memiliki batas kapasitas lebih rendah dan dapat menyebabkan fungsionalitas terbatas jika batas tersebut terlampaui. Batas tarif yang tidak diautentikasi adalah per alamat IP publik, jadi token lebih diperlukan jika IP Anda dibagikan dengan banyak pengguna.

Integrasi Ekstensi Alat CMake

Untuk proyek yang lebih kompleks, seperti proyek dengan beberapa executable atau ketika nama proyek didefinisikan sebagai variabel, ekstensi ini dapat berintegrasi dengan ekstensi CMake Tools untuk menyempurnakan penguraian CMake. Anda dapat mengaktifkan integrasi CMake Tools selama pembuatan proyek di bawah Opsi Lanjutan . Selain itu, untuk mengaktifkannya secara manual, sesuaikan pengaturan berikut di settings.json Anda :

• raspberry-pi-pico.cmakeAutoConfigure : Atur dari true ke false .
• raspberry-pi-pico.useCmakeTools : Atur dari false ke true .

Untuk fungsionalitas optimal, pertimbangkan untuk mengaktifkan:

• cmake.configureOnEdit : benar
• cmake.automaticReconfigure : benar
• cmake.configureOnOpen : benar

Saat diminta, pilih kit Pico di CMake Tools, dan tetapkan target pembuatan dan peluncuran Anda sesuai dengan itu. Gunakan CMake Tools untuk kompilasi, tetapi terus gunakan ekstensi ini untuk debugging, karena debugging CMake Tools tidak kompatibel dengan Pico.

Profil Kode VS

Jika Anda bekerja dengan beberapa rantai alat mikrokontroler, pertimbangkan untuk memasang ekstensi ini ke Profil Kode VS untuk menghindari konflik dengan rantai alat lainnya. Ikuti langkah-langkah berikut:

1. Unduh contoh profil dari sini.
2. Buka Command Palette dengan Ctrl+Shift+P (atau Cmd+Shift+P di macOS) dan pilih Profiles: Import Profile .
3. Impor file yang diunduh untuk menginstal ekstensi di profil Pico khusus.
4. Penyiapan ini membantu mengisolasi ekstensi Pico dari ekstensi lain, sehingga mengurangi risiko konflik.

Masalah yang Diketahui

• Jalur Khusus: Jalur khusus untuk Ninja, Python3, dan Git tidak disimpan di CMakeLists.txt seperti jalur SDK dan Toolchain. Anda perlu membangun dan mengonfigurasi proyek melalui ekstensi untuk menggunakan jalur khusus ini.

Batas Tingkat API GitHub ("Kesalahan saat mengambil versi SDK dan rantai alat")

Jika Anda mengalami masalah saat mengambil versi Pico SDK yang tersedia, hal ini mungkin disebabkan oleh batas laju API GitHub. Untuk mengatasinya, buat token akses pribadi (PAT klasik) dengan cakupan public_repo dan atur dalam pengaturan ekstensi global (Pengguna) untuk meningkatkan batas tarif Anda.

Petunjuk Pembuatan

Untuk pengguna tingkat lanjut yang ingin membuat file berekstensi .vsix , ikuti langkah-langkah berikut:

1. Instal nodejs (Instruksi Windows)
2. Instal Benang secara global: npm install -g yarn
3. Instal VSCE secara global: npm install -g @vscode/vsce
4. Jalankan yarn di direktori proyek untuk menginstal dependensi.
5. Bangun ekstensi dengan: vsce package .

Ini akan menghasilkan file .vsix , yang dapat Anda instal di VS Code menggunakan code --install-extension path-to.vsix atau melalui GUI: Extensions > three dots > Install from VSIX .