Artikel ini adalah ikhtisar UI (Antarmuka Pengguna) Ekstensi VEX Visual Studio Code. Ekstensi ini mendukung pengembangan proyek C++ dan Python untuk platform VEX IQ Generasi ke-2, EXP, dan V5.
Komponen UI
Ada 3 komponen utama pada Ekstensi VEX VS Code.
- Bilah Alat
- Bilah Aktivitas dan Bilah Samping
- Panel Terminal
Bilah Alat
Bilah alat memberi pengguna cara cepat untuk berinteraksi dengan proyek ekstensi VEX VS Code VEX Brains, dan VEX Controllers. Bilah alat hanya aktif ketika proyek VEX yang valid dibuka di VS Code. Proyek VEX yang valid adalah proyek yang dibuat atau diimpor oleh ekstensi. Membuka proyek VEXcode atau VEXcode Pro tidak valid dan perlu diimpor.
Pemilih Perangkat
Pemilih perangkat memiliki dua fungsi utama. Pertama, ia menampilkan ikon otak atau pengontrol yang mewakili jenis Perangkat VEX yang terhubung.
Kedua, saat ikon daftar perangkat diklik, daftar pilihan cepat muncul dengan semua Perangkat VEX yang terhubung. Pengguna dapat memilih perangkat mana yang akan dihubungkan dengan ekstensi.
Perangkat yang terhubung saat ini akan selalu muncul di bagian atas daftar diikuti oleh semua perangkat lain yang diurutkan berdasarkan jenis perangkat (Brain atau Controller) dan platform (IQ Generasi ke-2, EXP, dan V5).
Setiap item perangkat berisi Nama Otak, Platform, Jenis perangkat, dan informasi jalur perangkat.
Penting
Jika pengontrol terhubung ke komputer, tetapi tidak memiliki tautan radio ke otak, nama otak tidak akan ditampilkan di samping ikon bilah status daftar item atau daftar perangkat.
Pemilih Slot
Ikon pemilih slot memungkinkan pengguna untuk memilih slot mana ekstensi akan mengunduh atau memutar program pengguna.
Saat ikon pemilih slot diklik, daftar pilihan cepat muncul dengan slot program pengguna yang tersedia 1-8.
Bangun/Unduh
Ikon Bangun/Unduh berubah fungsi jika VEX Brain atau VEX Controller terhubung.
Jika Perangkat VEX tidak terhubung maka ikon build akan ditampilkan. Bila diklik, proyek hanya akan dibangun.
Jika Perangkat VEX terhubung, maka ikon unduh akan ditampilkan. Ketika diklik, proyek akan dibangun dan jika berhasil, akan diunduh ke Perangkat VEX.
Bermain
Ikon putar, saat diklik, menjalankan program pengguna di slot yang dipilih.
Berhenti
Ikon berhenti, ketika diklik, menghentikan program pengguna.
Ruang Kerja Terpilih
VS Code mendukung proyek multi ruang kerja. Pemilih proyek memungkinkan pengguna untuk beralih di antara proyek VEX ketika ada beberapa proyek di dalam ruang kerja.
Saat ikon pemilih proyek diklik, daftar pilihan cepat akan muncul dengan semua proyek yang valid.
Penting
Jika suatu proyek tidak valid, proyek tersebut tidak akan ditampilkan dalam daftar pilihan cepat proyek. Suatu proyek tidak valid kecuali telah dibuat atau diimpor oleh Ekstensi VEX VS Code.
Pemilih Berkas Python (Hanya Python)
Saat proyek python VEX dipilih, pemilih berkas python akan muncul di bilah alat. Saat ini, Python untuk VEX hanya mendukung pengunduhan berkas tunggal.
Ketika ikon diklik, daftar pilihan cepat akan muncul dengan semua file python yang terletak di direktori ruang kerja.
Pemilih file python memungkinkan pengguna untuk beralih di antara file sumber python (.py)
Bilah Aktivitas dan Bilah Samping VEX
Proyek Tindakan
Bilah aktivitas vex berisi tampilan Tindakan Proyek dan tampilan Info Perangkat VEX.
Tampilan tindakan Proyek digunakan untuk membuat proyek baru atau mengimpor Proyek VEXcode atau VEXcode Pro yang ada.
Untuk informasi lebih lanjut tentang membuat proyek baru, lihat artikel ini!
Informasi versi juga ditampilkan di sudut kiri bawah dan kanan tampilan.
Penting
Jika proyek VEXcode atau VEXcode Pro terbuka di editor maka proyek tersebut tidak akan dianggap sebagai Proyek VEX yang valid, proyek tersebut perlu diimpor menggunakan tombol Impor di bilah sisi VEX.
Info Perangkat VEX
Tampilan Info Perangkat VEX memberi pengguna gambaran umum tentang VEX Brain atau VEX Controller yang terhubung. Versi VEXos, jalur port serial, program pengguna, dan informasi perangkat semuanya dapat ditemukan dalam tampilan ini. Fungsi lain seperti pembaruan firmware VEXos, tangkapan layar, pengaturan nama otak dan pengaturan nomor tim juga dapat dilakukan melalui tampilan ini.
Informasi Sistem
Informasi sistem menyediakan ikhtisar singkat tentang Perangkat VEX yang terhubung. Ini termasuk versi VEXos perangkat, nama Brain, nomor tim, ID Brain, dan informasi versi python runtime.
Informasi Port Serial
Informasi Port Serial menampilkan jalur perangkat untuk setiap port yang tersedia untuk Perangkat VEX. Sebagian besar perangkat VEX memiliki dua port serial. Port serial Komunikasi digunakan untuk mengunduh program dan mengendalikan fungsi otak. Port serial Pengguna digunakan untuk mentransfer data antara aplikasi pengguna yang berjalan di Brain dan komputer host yang terhubung melalui USB. Pengendali V5 adalah satu-satunya perangkat VEX yang hanya memiliki port serial Komunikasi dan tidak memiliki port serial Pengguna.
Informasi Program
Informasi program menampilkan daftar semua program pengguna yang diunduh pada VEX Brain.
Setiap item daftar program dapat diperluas untuk menampilkan informasi tambahan tentang setiap program pengguna, seperti lokasi slot, nama file, jenis bahasa, ukuran file, dan waktu pengunduhan.
Informasi Perangkat
Informasi perangkat menunjukkan daftar semua perangkat port pintar yang terhubung ke VEX Brain. Setiap item daftar menunjukkan nomor port pintar dan jenis perangkat.
Setiap item daftar Perangkat dapat diperluas untuk menampilkan informasi versi firmware tentang setiap perangkat port pintar.
Status tautan pengontrol ditampilkan saat terhubung ke Perangkat VEX Brain.
VEX Brain terhubung ke VEX Controller
VEX Brain tidak terhubung ke VEX Controller
Pengontrol VEX V5 terhubung ke Otak VEX V5
Tangkapan Layar
Dengan mengklik ikon Kamera, pengguna dapat mengambil dan mengunduh tangkapan layar dari VEX Brain.
Tangkapan layar hanya tersedia saat terhubung langsung ke VEX Brain melalui USB
Battery Medic (Hanya Otak V5)
Dengan mengklik ikon Hati, ekstensi akan mengunduh dan menjalankan program pengguna Battery Medic.
Atur Nama Otak
Dengan mengklik ikon Pensil di samping nama sistem>, pengguna dapat menetapkan nama untuk VEX Brain.
Setelah ikon Pensil diklik, kotak masukan akan muncul di bagian atas editor VS Code. Ketik nama otak baru di kotak input dan tekan enter untuk mengaturnya.
Tetapkan Nomor Tim
Dengan mengklik ikon Pensil di sebelah sistem>tim, pengguna dapat menetapkan nomor tim untuk VEX Brain.
Setelah ikon Pensil diklik maka kotak input akan muncul di bagian atas editor VS Code. Ketik nomor tim baru di kotak input dan tekan enter untuk mengaturnya.
Hapus Program Pengguna
Dengan mengklik ikon Tempat Sampah di samping program->nama proyek, pengguna dapat menghapus program di slot tertentu. PENTING, setelah Anda menghapus program, program tersebut tidak dapat dipulihkan. Harap berhati-hati saat menggunakan fitur ini.
Peringatan Info Perangkat
Pembaruan VEXos
Bila versi VEXos pada VEX Brain sudah kedaluwarsa, ikon pesan peringatan akan muncul di samping versi VEXos dan kedua ikon Brain akan berubah menjadi kuning.
Untuk mengatasi peringatan ini, pengguna harus memperbarui VEXos untuk VEXos Brain mereka.
VEXos dapat diperbarui dengan mengklik panah atas di samping Ikon Otak VEX.
Kotak pemberitahuan juga akan muncul di sudut kanan bawah editor VS Code saat VEXos kedaluwarsa. Pengguna dapat memulai pembaruan VEXos dengan mengklik tombol “Perbarui” atau mengklik tombol “Abaikan” untuk melewati pembaruan VEXos.
Otak tidak terhubung ke Pengontrol yang terhubung
Ikon VEX Controller akan berubah menjadi kuning ketika VEX Controller terhubung ke komputer, tetapi tidak terhubung ke VEX Brain.
Untuk mengatasi peringatan ini, pengguna harus menghubungkan Pengontrol VEX ke Otak VEX
Panel Terminal
Ekstensi VEX VS Code menyediakan dua terminal saat startup, Terminal Log dan Terminal Interaktif
Terminal Log
Terminal Log menampilkan keluaran build, kesalahan build, dan hasil unduhan.
Terminal Interaktif
Terminal Interaktif memiliki dua fungsi, menampilkan log printf dan mengirimkan kembali penekanan tombol mentah ke program pengguna. Untuk memanfaatkan terminal Interaktif, Otak atau Pengontrol harus terhubung ke komputer yang menjalankan Ekstensi VEX VS Code. Output terminal interaktif akan dihapus secara default setelah membuat dan mengunduh program pengguna.
Pengaturan Pengguna
Pengaturan pengguna adalah pengaturan global yang ditawarkan Visual Studio Code untuk setiap ekstensi. Pengaturan pengguna diterapkan ke setiap proyek ekstensi VEX VS Code.
Cara mengakses pengaturan pengguna VEX
Klik roda gigi di sudut kiri VS Code dan menu konteks akan muncul
Pada menu konteks, klik item “Pengaturan” dan halaman pengaturan akan muncul.
Pada tampilan daftar sebelah kiri, klik item “Ekstensi”. Selanjutnya, gulir ke bawah ke bagian paling bawah dan temukan item berlabel “VEX”.
Klik pada item daftar “VEX”.
Pengaturan Pengguna VEX akan muncul di panel sebelah kanan.
Ikhtisar Pengaturan
Saluran Pengontrol (Hanya Pengontrol V5)
Pengaturan Saluran Pengontrol mengontrol jenis saluran komunikasi radio antara V5 Brain dan Pengontrol V5.
Pengaturan ini hanya berlaku saat VS Code terhubung ke Pengontrol V5 melalui USB dan pengontrol terhubung ke V5 Brain melalui VEXnet. Pengguna dapat memilih antara saluran Unduh dan Pit. Bila diatur ke Unduh, radio akan melompat ke saluran unduhan VEXnet setelah pengunduhan program pengguna dimulai. Saluran unduhan memungkinkan kecepatan data yang lebih tinggi dan pengunduhan yang lebih efisien. Bila diatur ke Pit, radio akan tetap berada di saluran pit dan pengunduhan akan memakan waktu lebih lama. Secara default pengaturan ini ditetapkan ke Unduh.
Beranda SDK Proyek Cpp
JANGAN EDIT PENGATURAN INI.
Jalur Rantai Alat Cpp
Cpp Toolchain Path menetapkan Path untuk toolchain yang digunakan saat membangun proyek C++ VEX VS Code.
Aktifkan Terminal Pengguna
Pengaturan Aktifkan Terminal Pengguna memungkinkan ekstensi untuk membuka port serial pengguna saat VEX Brain atau VEX Controller terdeteksi oleh ekstensi. Satu-satunya pengecualian berlaku untuk Pengendali V5 yang tidak terdaftar dengan port serial pengguna.
Aktifkan memungkinkan ekstensi untuk terhubung ke userport saat memulai dan akan membuat Terminal Interaktif. Jika aktifkan dipilih saat ekstensi sedang berjalan, ekstensi akan mencoba membuka port pengguna jika ada perangkat yang tersambung.
Nonaktifkan mencegah ekstensi tersambung ke port pengguna saat memulai dan tidak akan membuat Terminal Interaktif. Jika nonaktifkan dipilih saat ekstensi sedang berjalan, ekstensi akan menutup port pengguna dan menghapus Terminal Interaktif.
Jenis Bangunan Proyek
Jenis Bangun Proyek menetapkan bagaimana ekstensi akan membangun proyek C++. Pengguna dapat mengatur tipe build ke Build atau Rebuild.
Build hanya membangun proyek ketika Make mendeteksi adanya perubahan pada kode sumber proyek.
Rebuild membersihkan direktori build proyek, lalu membangun proyek tersebut. Pilihan ini biasanya jauh lebih lambat.
Proyek Beranda
Project Home menetapkan direktori home default untuk proyek baru saat menyelesaikan panduan Proyek Baru.
Jalankan Setelah Unduh
Jalankan Setelah Pengunduhan bila diaktifkan, menyebabkan program pengguna berjalan setelah diunduh ke VEX Brain.
Beranda SDK Python
JANGAN EDIT PENGATURAN INI.
Bantuan Perintah VEX
Bantuan Perintah VEX memungkinkan akses ke dokumentasi untuk fungsi-fungsi spesifik yang disertakan dalam API (Antarmuka Pemrograman Aplikasi) C++ dan Python. Dokumentasi bersifat khusus untuk setiap Platform VEX (IQ Generasi ke-2, EXP, V5).
Untuk mengakses Bantuan Perintah VEX, pertama-tama sorot teks fungsi yang ingin dicari.
Klik kanan pada teks yang dipilih, dan menu konteks akan muncul.
Berikutnya Klik pada Bantuan Perintah VEX untuk mengakses dokumentasi.
Jika Bantuan Perintah VEX menemukan kecocokan yang tepat, tampilan web baru akan muncul dengan dokumentasi yang relevan.
Jika beberapa dokumen cocok dengan teks yang dipilih, maka akan muncul menu drop down berisi daftar dokumentasi relevan yang telah difilter.