บทความนี้เป็นภาพรวมของ VEX Visual Studio Code Extension UI (อินเทอร์เฟซผู้ใช้) ส่วนขยายรองรับการพัฒนาโปรเจ็กต์ C++ และ Python สำหรับแพลตฟอร์ม VEX IQ 2nd Generation, EXP และ V5
ส่วนประกอบ UI
มีองค์ประกอบหลัก 3 ส่วนใน VEX VS Code Extension
- แถบเครื่องมือ
- แถบกิจกรรมและแถบด้านข้าง
- แผงเทอร์มินัล
แถบเครื่องมือ
แถบเครื่องมือช่วยให้ผู้ใช้สามารถโต้ตอบกับโปรเจ็กต์ส่วนขยาย VEX VS Code ได้แก่ VEX Brains และ VEX Controllers ได้อย่างรวดเร็ว แถบเครื่องมือจะทำงานก็ต่อเมื่อเปิดโปรเจ็กต์ VEX ที่ถูกต้องใน VS Code เท่านั้น โครงการ VEX ที่ถูกต้องคือโครงการที่สร้างหรือนำเข้าโดยส่วนขยาย การเปิดโปรเจ็กต์ VEXcode หรือ VEXcode Pro ไม่ถูกต้องและจะต้องนำเข้า
เครื่องมือเลือกอุปกรณ์
ตัวเลือกอุปกรณ์มีสองฟังก์ชันหลัก ขั้นแรก จะแสดงไอคอนสมองหรือตัวควบคุมซึ่งแสดงถึงประเภทอุปกรณ์ VEX ที่เชื่อมต่อ
ประการที่สอง เมื่อคลิกไอคอนรายการอุปกรณ์ รายการเลือกด่วนจะปรากฏขึ้นพร้อมกับอุปกรณ์ VEX ที่เชื่อมต่อทั้งหมด ผู้ใช้สามารถเลือกอุปกรณ์ที่จะเชื่อมต่อส่วนขยายได้
อุปกรณ์ที่เชื่อมต่ออยู่ในปัจจุบันจะปรากฏที่ด้านบนของรายการเสมอ ตามด้วยอุปกรณ์อื่นๆ ทั้งหมดโดยจัดเรียงตามประเภทอุปกรณ์ (สมองหรือตัวควบคุม) และแพลตฟอร์ม (IQ รุ่นที่ 2, EXP และ V5)
แต่ละรายการอุปกรณ์ประกอบด้วยชื่อสมอง แพลตฟอร์ม ประเภทอุปกรณ์ และข้อมูลเส้นทางของอุปกรณ์
สำคัญ
หากคอนโทรลเลอร์เชื่อมต่อกับคอมพิวเตอร์ แต่ไม่มีลิงก์วิทยุไปยังสมอง จะไม่มีชื่อสมองปรากฏถัดจากรายการหรือไอคอนแถบสถานะรายการอุปกรณ์
ตัวเลือกสล็อต
ไอคอนตัวเลือกช่องช่วยให้ผู้ใช้สามารถเลือกช่องที่จะดาวน์โหลดส่วนขยายหรือเล่นโปรแกรมของผู้ใช้ได้
เมื่อคลิกไอคอนตัวเลือกช่อง รายการเลือกด่วนจะปรากฏขึ้นพร้อมกับช่องโปรแกรมผู้ใช้ที่มีอยู่ 1-8
สร้าง/ดาวน์โหลด
ไอคอนสร้าง/ดาวน์โหลดจะเปลี่ยนการทำงานหากมีการเชื่อมต่อ VEX Brain หรือ VEX Controller
หากไม่ได้เชื่อมต่ออุปกรณ์ VEX ไอคอนบิลด์จะปรากฏขึ้น เมื่อคลิกแล้ว โปรเจ็กต์จะถูกสร้างขึ้นเท่านั้น
หากมีการเชื่อมต่ออุปกรณ์ VEX ไอคอนดาวน์โหลดจะปรากฏขึ้น เมื่อคลิก โครงการจะถูกสร้างขึ้น และหากสำเร็จ จะถูกดาวน์โหลดไปยังอุปกรณ์ VEX
เล่น
เมื่อคลิกไอคอนเล่น จะรันโปรแกรมผู้ใช้ในช่องที่เลือก
หยุด
เมื่อคลิกไอคอนหยุด จะหยุดโปรแกรมของผู้ใช้
พื้นที่ทำงานที่เลือก
VS Code รองรับโปรเจ็กต์พื้นที่ทำงานหลายรายการ ตัวเลือกโปรเจ็กต์อนุญาตให้ผู้ใช้สลับระหว่างโปรเจ็กต์ VEX เมื่อมีหลายโปรเจ็กต์ภายในเวิร์กสเปซ
เมื่อคลิกไอคอนตัวเลือกโครงการ รายการเลือกด่วนจะปรากฏขึ้นพร้อมกับโครงการที่ถูกต้องทั้งหมด
สิ่งสำคัญ
หากโครงการไม่ถูกต้อง โครงการจะไม่ปรากฏในรายการเลือกด่วนของโครงการ โปรเจ็กต์จะไม่ถูกต้องหากไม่ได้สร้างหรือนำเข้าโดยใช้ส่วนขยาย VEX สำหรับ VS Code
ตัวเลือกไฟล์ Python (Python เท่านั้น)
เมื่อเลือกโปรเจ็กต์ VEX python ตัวเลือกไฟล์ Python จะปรากฏในแถบเครื่องมือ Python สำหรับ VEX รองรับการดาวน์โหลดไฟล์เดียวในปัจจุบันเท่านั้น
เมื่อคลิกไอคอน รายการเลือกด่วนจะปรากฏขึ้นพร้อมไฟล์ Python ทั้งหมดที่อยู่ในไดเร็กทอรีเวิร์กสเปซ
ตัวเลือกไฟล์หลามอนุญาตให้ผู้ใช้สลับระหว่างไฟล์ต้นฉบับหลาม (.py)
แถบกิจกรรม VEX และแถบด้านข้าง
การดำเนินการโครงการ
แถบกิจกรรม vex ประกอบด้วยมุมมองการดำเนินการโครงการและมุมมองข้อมูลอุปกรณ์ VEX
มุมมองการดำเนินการของโครงการใช้สำหรับการสร้างโครงการใหม่หรือนำเข้าโครงการ VEXcode หรือ VEXcode Pro ที่มีอยู่
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการสร้างโครงการ
ข้อมูลเวอร์ชันจะแสดงที่มุมล่างซ้ายและขวาของมุมมองด้วย
สิ่งสำคัญ
หากโปรเจ็กต์ VEXcode หรือ VEXcode Pro เปิดอยู่ในโปรแกรมแก้ไข จะไม่ถือว่าเป็นโปรเจ็กต์ VEX ที่ถูกต้อง จะต้องนำเข้าโปรเจ็กต์โดยใช้ปุ่มนำเข้าในแถบด้านข้าง VEX
ข้อมูลอุปกรณ์ VEX
มุมมองข้อมูลอุปกรณ์ VEX ช่วยให้ผู้ใช้สามารถเห็นภาพรวมของ VEX Brain หรือ VEX Controller ที่เชื่อมต่ออยู่ สามารถดูเวอร์ชัน VEXos, เส้นทางพอร์ตอนุกรม, โปรแกรมผู้ใช้ และข้อมูลอุปกรณ์ได้ในมุมมองนี้ ฟังก์ชั่นอื่นๆ เช่น การอัพเดตเฟิร์มแวร์ VEXos, ภาพหน้าจอ, การตั้งชื่อสมอง และหมายเลขทีมการตั้งค่า ก็สามารถทำได้ผ่านมุมมองนี้เช่นกัน
ข้อมูลระบบ
ข้อมูลระบบให้ภาพรวมโดยย่อของอุปกรณ์ VEX ที่เชื่อมต่อ ซึ่งรวมถึงเวอร์ชัน VEXos ของอุปกรณ์ ชื่อ Brain หมายเลขทีม Brain ID และข้อมูลเวอร์ชันรันไทม์ของ Python
ข้อมูลพอร์ตอนุกรม
ข้อมูลพอร์ตอนุกรมจะแสดงเส้นทางอุปกรณ์สำหรับแต่ละพอร์ตที่มีอยู่สำหรับอุปกรณ์ VEX อุปกรณ์ VEX ส่วนใหญ่ระบุเป็นพอร์ตอนุกรมสองพอร์ต พอร์ตอนุกรมการสื่อสารใช้เพื่อดาวน์โหลดโปรแกรมและควบคุมการทำงานของสมอง พอร์ตอนุกรมของผู้ใช้ใช้เพื่อถ่ายโอนข้อมูลระหว่างแอปผู้ใช้ที่ทำงานบน Brain และคอมพิวเตอร์โฮสต์ที่เชื่อมต่อผ่าน USB คอนโทรลเลอร์ V5 เป็นอุปกรณ์ VEX เพียงตัวเดียวที่มีเพียงพอร์ตอนุกรมการสื่อสารและไม่มีพอร์ตอนุกรมของผู้ใช้
ข้อมูลโปรแกรม
ข้อมูลโปรแกรมแสดงรายการโปรแกรมผู้ใช้ที่ดาวน์โหลดทั้งหมดบน VEX Brain
แต่ละรายการโปรแกรมสามารถขยายเพื่อแสดงข้อมูลเพิ่มเติมเกี่ยวกับแต่ละโปรแกรมของผู้ใช้ เช่น ตำแหน่งสล็อต ชื่อไฟล์ ประเภทภาษา ขนาดไฟล์ และเวลาที่ดาวน์โหลด
ข้อมูลอุปกรณ์
ข้อมูลอุปกรณ์แสดงรายการอุปกรณ์พอร์ตอัจฉริยะทั้งหมดที่เชื่อมต่อกับ VEX Brain แต่ละรายการจะแสดงหมายเลขพอร์ตอัจฉริยะและประเภทอุปกรณ์
รายการอุปกรณ์แต่ละรายการสามารถขยายเพื่อแสดงข้อมูลเวอร์ชันเฟิร์มแวร์เกี่ยวกับอุปกรณ์พอร์ตอัจฉริยะแต่ละเครื่องได้
สถานะการเชื่อมโยงคอนโทรลเลอร์จะปรากฏขึ้นเมื่อเชื่อมต่อกับอุปกรณ์สมอง VEX
VEX Brain เชื่อมโยงกับ VEX Controller
VEX Brain ไม่ได้เชื่อมโยงกับ VEX Controller
คอนโทรลเลอร์ VEX V5 เชื่อมโยงกับ VEX V5 Brain
ภาพหน้าจอ
เมื่อคลิกที่ไอคอนกล้อง ผู้ใช้จะสามารถถ่ายและดาวน์โหลดภาพหน้าจอจาก VEX Brain
ภาพหน้าจอจะใช้ได้เมื่อเชื่อมต่อโดยตรงกับ VEX Brain ผ่าน USB เท่านั้น
แบตเตอรี่ Medic (สมอง V5 เท่านั้น)
เมื่อคลิกที่ไอคอนรูปหัวใจ ส่วนขยายจะดาวน์โหลดและรันโปรแกรมผู้ใช้ด้านการแพทย์แบตเตอรี่
ตั้งชื่อสมอง
เมื่อคลิกที่ไอคอนดินสอถัดจากชื่อระบบ>ผู้ใช้สามารถตั้งชื่อให้กับ VEX Brain ได้
หลังจากคลิกไอคอนดินสอ ช่องป้อนข้อมูลจะปรากฏที่ด้านบนของโปรแกรมแก้ไข VS Code พิมพ์ชื่อสมองใหม่ลงในช่องป้อนข้อมูลแล้วกด Enter เพื่อตั้งค่า
กำหนดหมายเลขทีม
เมื่อคลิกที่ไอคอนดินสอถัดจากทีมระบบ>ผู้ใช้สามารถกำหนดหมายเลขทีมสำหรับ VEX Brain
หลังจากคลิกไอคอนดินสอ กล่องป้อนข้อมูลจะปรากฏขึ้นที่ด้านบนของโปรแกรมแก้ไข VS Code พิมพ์หมายเลขทีมใหม่ในช่องป้อนข้อมูลแล้วกด Enter เพื่อตั้งค่า
ลบโปรแกรมผู้ใช้
เมื่อคลิกที่ไอคอน ถังขยะ ถัดจากชื่อโปรแกรม->ชื่อโครงการ ผู้ใช้สามารถลบโปรแกรมในช่องเฉพาะได้ ข้อสำคัญเมื่อคุณลบโปรแกรมแล้วจะไม่สามารถกู้คืนได้ โปรดใช้ความระมัดระวังเมื่อใช้คุณสมบัตินี้
คำเตือนข้อมูลอุปกรณ์
อัพเดต VEXos
เมื่อเวอร์ชัน VEXos ของ VEX Brain ล้าสมัย ไอคอนข้อความเตือนจะปรากฏขึ้นถัดจากเวอร์ชัน VEXos และไอคอน Brain ทั้งสองจะเปลี่ยนเป็นสีเหลือง
เพื่อแก้ไขคำเตือนนี้ ผู้ใช้ควรอัปเดต VEXos สำหรับ VEXos Brain
สามารถอัปเดต VEX ได้โดยคลิกลูกศรขึ้นถัดจากไอคอน VEX Brain
นอกจากนี้ กล่องการแจ้งเตือนจะปรากฏที่มุมขวาล่างของโปรแกรมแก้ไข VS Code เมื่อ VEXos ล้าสมัย ผู้ใช้สามารถเริ่มการอัปเดต VEXos ได้โดยคลิกปุ่ม "อัปเดต" หรือคลิกปุ่ม "ละเว้น" เพื่อข้ามการอัปเดต VEXos
สมองไม่ได้เชื่อมโยงกับคอนโทรลเลอร์ที่เชื่อมต่ออยู่
ไอคอน VEX Controller จะเปลี่ยนเป็นสีเหลืองเมื่อ VEX Controller เชื่อมต่อกับคอมพิวเตอร์ แต่ไม่ได้เชื่อมโยงกับ VEX Brain
เพื่อแก้ไขคำเตือนนี้ ผู้ใช้ควรเชื่อมโยง VEX Controller กับ VEX Brain
แผงเทอร์มินัล
VEX VS Code Extension มีเทอร์มินัลสองเครื่องเมื่อเริ่มต้นระบบ ได้แก่ Log Terminal และ Interactive Terminal
ล็อกเทอร์มินัล
Log Terminal จะแสดงเอาต์พุตของบิลด์ ข้อผิดพลาดของบิลด์ และผลลัพธ์การดาวน์โหลด
เทอร์มินัลแบบโต้ตอบ
Interactive Terminal มี 2 ฟังก์ชัน ได้แก่ การแสดงบันทึก printf และส่งการกดแป้นพิมพ์ดิบกลับไปยังโปรแกรมผู้ใช้ เพื่อใช้ประโยชน์จากเทอร์มินัลแบบโต้ตอบ Brain หรือคอนโทรลเลอร์จะต้องเชื่อมต่อกับคอมพิวเตอร์ที่ใช้ VEX VS Code Extension เอาต์พุตเทอร์มินัลแบบโต้ตอบจะถูกล้างตามค่าเริ่มต้นหลังจากสร้างและดาวน์โหลดโปรแกรมผู้ใช้
การตั้งค่าผู้ใช้
การตั้งค่าผู้ใช้คือการตั้งค่าส่วนกลางที่โค้ด Visual Studio เสนอให้สำหรับแต่ละส่วนขยาย การตั้งค่าผู้ใช้จะถูกนำไปใช้กับทุกโครงการส่วนขยายรหัส VEX VS
วิธีเข้าถึงการตั้งค่าผู้ใช้ VEX
คลิกเฟืองที่มุมซ้ายของ VS Code แล้วเมนูบริบทจะปรากฏขึ้น
ในเมนูบริบทคลิกรายการ "การตั้งค่า" และหน้าการตั้งค่าจะปรากฏขึ้น
ในมุมมองรายการด้านซ้ายมือ ให้คลิกที่รายการ "ส่วนขยาย" จากนั้นเลื่อนลงไปด้านล่างและค้นหารายการที่มีป้ายกำกับ “VEX”
คลิกที่รายการ “VEX”
การตั้งค่าผู้ใช้ VEX จะปรากฏในแผงด้านขวามือ
ภาพรวมการตั้งค่า
ช่องคอนโทรลเลอร์ (คอนโทรลเลอร์ V5 เท่านั้น)
การตั้งค่า Controller Channel จะควบคุมประเภทช่องสัญญาณการสื่อสารทางวิทยุระหว่าง V5 Brain และ V5 Controller
การตั้งค่านี้ใช้เฉพาะเมื่อ VS Code เชื่อมต่อกับคอนโทรลเลอร์ V5 ผ่าน USB และคอนโทรลเลอร์เชื่อมต่อกับ V5 Brain ผ่าน VEXnet ผู้ใช้สามารถเลือกระหว่าง ดาวน์โหลด และ Pit ช่อง เมื่อตั้งค่าเป็น ดาวน์โหลดวิทยุจะข้ามไปยังช่องดาวน์โหลด VEXnet เมื่อการดาวน์โหลดโปรแกรมของผู้ใช้เริ่มต้นขึ้น ช่องทางการดาวน์โหลดช่วยให้อัตราข้อมูลสูงขึ้นและการดาวน์โหลดมีประสิทธิภาพมากขึ้น เมื่อตั้งค่าเป็น Pitวิทยุจะยังคงอยู่ในช่อง Pit และการดาวน์โหลดจะใช้เวลานานกว่ามาก ตามค่าเริ่มต้น การตั้งค่านี้ตั้งไว้ที่ ดาวน์โหลด
หน้าแรกของโครงการ Cpp SDK
อย่าแก้ไขการตั้งค่านี้
เส้นทาง Cpp Toolchain
Cpp Toolchain Path กำหนดเส้นทางสำหรับชุดเครื่องมือที่ใช้ในการสร้างโปรเจ็กต์ C++ VEX VS Code
เปิดใช้งานเทอร์มินัลผู้ใช้
การตั้งค่า เปิดใช้งานเทอร์มินัลผู้ใช้ อนุญาตให้ส่วนขยายเปิดพอร์ตอนุกรมของผู้ใช้เมื่อส่วนขยายตรวจพบ VEX Brain หรือ VEX Controller ข้อยกเว้นเดียวที่ใช้กับคอนโทรลเลอร์ V5 ซึ่งไม่ได้ระบุพอร์ตอนุกรมของผู้ใช้
เปิดใช้งาน อนุญาตให้ส่วนขยายเชื่อมต่อกับพอร์ตผู้ใช้เมื่อเริ่มต้น และจะสร้าง Interactive Terminal หากเลือกเปิดใช้งานในขณะที่ส่วนขยายกำลังทำงาน ส่วนขยายจะพยายามเปิดพอร์ตผู้ใช้หากมีการเชื่อมต่ออุปกรณ์อยู่
ปิดใช้งาน ป้องกันไม่ให้ส่วนขยายเชื่อมต่อกับพอร์ตผู้ใช้เมื่อเริ่มต้นระบบ และจะไม่สร้างเทอร์มินัลแบบโต้ตอบ หากเลือกปิดใช้งานในขณะที่ส่วนขยายกำลังทำงาน ส่วนขยายจะปิดพอร์ตผู้ใช้และลบเทอร์มินัลแบบโต้ตอบออก
ประเภทการสร้างโครงการ
Project Build Type กำหนดวิธีที่ส่วนขยายจะสร้างโปรเจ็กต์ C++ ผู้ใช้สามารถตั้งค่าประเภทบิลด์เป็น Build หรือ Rebuild
Build สร้างโปรเจ็กต์เมื่อ Make ตรวจพบการเปลี่ยนแปลงในซอร์สโค้ดของโปรเจ็กต์เท่านั้น
สร้างใหม่ ทำความสะอาดไดเร็กทอรี build ของโปรเจ็กต์ จากนั้นจึงสร้างโปรเจ็กต์ โดยปกติตัวเลือกนี้จะช้ากว่ามาก
โครงการบ้าน
Project Home ตั้งค่าโฮมไดเร็กทอรีเริ่มต้นสำหรับโปรเจ็กต์ใหม่เมื่อดำเนินการวิซาร์ดโปรเจ็กต์ใหม่เสร็จแล้ว
เรียกใช้หลังจากดาวน์โหลด
เรียกใช้หลังจากดาวน์โหลด เมื่อเปิดใช้งาน ทำให้โปรแกรมผู้ใช้ทำงานหลังจากดาวน์โหลดไปยัง VEX Brain
หน้าแรกของ Python SDK
อย่าแก้ไขการตั้งค่านี้
วิธีใช้คำสั่ง VEX
วิธีใช้คำสั่ง VEX ช่วยให้สามารถเข้าถึงเอกสารประกอบสำหรับฟังก์ชันเฉพาะที่รวมอยู่ใน C++ และ Python API (Application Programming Interface) เอกสารประกอบเป็นข้อมูลเฉพาะสำหรับแต่ละแพลตฟอร์ม VEX (IQ 2nd Generation, EXP, V5)
หากต้องการเข้าถึงวิธีใช้คำสั่ง VEX ก่อนอื่นให้เลือกข้อความของฟังก์ชันที่ต้องการค้นหา
คลิกขวาที่ข้อความที่เลือก จากนั้นเมนูบริบทจะปรากฏขึ้น
ถัดไป คลิกที่วิธีใช้คำสั่ง VEX เพื่อเข้าถึงเอกสาร
หาก VEX Command Help พบว่าตรงกันทุกประการ webview ใหม่จะปรากฏขึ้นพร้อมกับเอกสารที่เกี่ยวข้อง
หากเอกสารหลายฉบับตรงกับข้อความที่เลือก รายการแบบเลื่อนลงจะปรากฏขึ้นพร้อมกับรายการเอกสารที่เกี่ยวข้องที่กรองแล้ว