이 문서는 VEX Visual Studio Code 확장 UI(사용자 인터페이스)에 대한 개요입니다. 이 확장은 VEX IQ 2세대, EXP 및 V5 플랫폼용 C++ 및 Python 프로젝트 개발을 지원합니다.
UI 구성요소
VEX VS Code Extension에는 3가지 주요 구성 요소가 있습니다.
- 툴바
- 활동 표시줄 및 사이드바
- 터미널 패널
툴바
툴바를 사용하면 VEX VS Code 확장 프로젝트인 VEX 브레인 및 VEX 컨트롤러와 빠르게 상호 작용할 수 있습니다. 툴바는 VS Code에서 유효한 VEX 프로젝트가 열려 있을 때만 활성화됩니다. 유효한 VEX 프로젝트는 확장 프로그램을 통해 생성되거나 가져온 프로젝트입니다. VEXcode 또는 VEXcode Pro 프로젝트를 여는 것은 유효하지 않으며 가져와야 합니다.
장치 선택기
장치 선택기에는 두 가지 주요 기능이 있습니다. 먼저 연결된 VEX 장치 유형을 나타내는 브레인 또는 컨트롤러 아이콘이 표시됩니다.
둘째, 장치 목록 아이콘을 클릭하면 연결된 모든 VEX 장치가 포함된 빠른 선택 목록이 나타납니다. 사용자는 확장 프로그램이 연결할 장치를 선택할 수 있습니다.
현재 연결된 장치는 항상 목록 상단에 표시되며 그 다음에는 장치 유형(브레인 또는 컨트롤러) 및 플랫폼(IQ 2세대, EXP 및 V5)별로 정렬된 다른 모든 장치가 표시됩니다.
각 장치 항목에는 Brain 이름, 플랫폼, 장치 유형 및 장치 경로 정보가 포함됩니다.
중요한
컨트롤러가 컴퓨터에 연결되어 있지만 뇌에 대한 무선 링크가 없는 경우 목록 항목 또는 장치 목록 상태 표시줄 아이콘 옆에 뇌 이름이 표시되지 않습니다.
슬롯 선택기
슬롯 선택기 아이콘을 사용하면 사용자는 확장 프로그램이 사용자 프로그램을 다운로드하거나 재생할 슬롯을 선택할 수 있습니다.
슬롯 선택기 아이콘을 클릭하면 사용 가능한 사용자 프로그램 슬롯 1-8이 포함된 빠른 선택 목록이 나타납니다.
빌드/다운로드
VEX Brain 또는 VEX Controller가 연결되면 빌드/다운로드 아이콘의 기능이 변경됩니다.
VEX 장치가 연결되어 있지 않으면 빌드 아이콘이 표시됩니다. 클릭하면 프로젝트가 빌드만 됩니다.
VEX 장치가 연결되면 다운로드 아이콘이 표시됩니다. 클릭하면 프로젝트가 빌드되고 성공하면 VEX 장치에 다운로드됩니다.
놀다
재생 아이콘을 클릭하면 선택한 슬롯에서 사용자 프로그램이 실행됩니다.
멈추다
중지 아이콘을 클릭하면 사용자 프로그램이 중지됩니다.
선택한 작업공간
VS Code는 다중 작업 영역 프로젝트를 지원합니다. 프로젝트 선택기를 사용하면 작업 공간 내에 VEX 프로젝트가 여러 개 있을 때 사용자가 VEX 프로젝트 간에 전환할 수 있습니다.
프로젝트 선택기 아이콘을 클릭하면 유효한 모든 프로젝트가 포함된 빠른 선택 목록이 나타납니다.
중요
유효하지 않은 프로젝트는 프로젝트 빠른 선택 목록에 표시되지 않습니다. VEX VS Code 확장 프로그램을 통해 생성되거나 가져온 프로젝트만 유효합니다.
Python 파일 선택기(Python 전용)
VEX Python 프로젝트를 선택하면 Python 파일 선택기가 도구 모음에 나타납니다. VEX용 Python은 현재 단일 파일 다운로드만 지원합니다.
아이콘을 클릭하면 작업 공간 디렉터리에 있는 모든 Python 파일이 포함된 빠른 선택 목록이 나타납니다.
Python 파일 선택기를 사용하면 사용자가 Python 소스 파일(.py) 간에 전환할 수 있습니다.
VEX 활동 표시줄 및 사이드바
프로젝트 작업
VEX 활동 표시줄에는 프로젝트 작업 보기와 VEX 장치 정보 보기가 포함되어 있습니다.
프로젝트 작업 보기는 새 프로젝트를 생성하거나 기존 VEXcode 또는 VEXcode Pro 프로젝트를 가져오는 데 사용됩니다.
새로운 프로젝트를 만드는 방법에 대한 자세한 내용은 이 문서을 확인하세요!
버전 정보는 보기의 왼쪽 하단과 오른쪽 모서리에도 표시됩니다.
중요
VEXcode 또는 VEXcode Pro 프로젝트가 편집기에 열려 있으면 유효한 VEX 프로젝트로 간주되지 않습니다. VEX 사이드바의 가져오기 버튼을 사용하여 프로젝트를 가져와야 합니다.
VEX 장치 정보
VEX 장치 정보 보기는 사용자에게 연결된 VEX Brain 또는 VEX 컨트롤러에 대한 개요를 제공합니다. VEXos 버전, 직렬 포트 경로, 사용자 프로그램 및 장치 정보를 모두 이 보기에서 찾을 수 있습니다. VEXos 펌웨어 업데이트, 스크린샷, 브레인 이름 설정 및 팀 번호 설정과 같은 다른 기능도 이 보기를 통해 수행할 수 있습니다.
시스템 정보
시스템 정보는 연결된 VEX 장치에 대한 간략한 개요를 제공합니다. 여기에는 장치의 VEXos 버전, Brain 이름, 팀 번호, Brain ID 및 Python 런타임 버전 정보가 포함됩니다.
직렬 포트 정보
직렬 포트 정보는 VEX 장치에 사용 가능한 각 포트의 장치 경로를 표시합니다. 대부분의 VEX 장치는 두 개의 직렬 포트로 열거됩니다. 통신 직렬 포트는 프로그램을 다운로드하고 뇌 기능을 제어하는 데 사용됩니다. 사용자 직렬 포트는 Brain에서 실행되는 사용자 앱과 USB를 통해 연결된 호스트 컴퓨터 간에 데이터를 전송하는 데 사용됩니다. V5 컨트롤러는 통신 직렬 포트만 있고 사용자 직렬 포트는 없는 유일한 VEX 장치입니다.
프로그램 정보
프로그램 정보는 VEX Brain에 다운로드된 모든 사용자 프로그램 목록을 표시합니다.
각 프로그램 목록 항목을 확장하여 슬롯 위치, 파일 이름, 언어 유형, 파일 크기 및 다운로드 시간과 같은 각 사용자 프로그램에 대한 추가 정보를 표시할 수 있습니다.
장치 정보
장치 정보는 VEX Brain에 연결된 모든 스마트 포트 장치의 목록을 보여줍니다. 각 목록 항목에는 스마트 포트 번호와 장치 유형이 표시됩니다.
각 장치 목록 항목을 확장하여 각 스마트 포트 장치에 대한 펌웨어 버전 정보를 표시할 수 있습니다.
VEX Brain Device에 연결되면 컨트롤러 연결 상태가 표시됩니다.
VEX Brain은 VEX 컨트롤러에 연결됩니다.
VEX Brain은 VEX 컨트롤러에 연결되어 있지 않습니다.
VEX V5 컨트롤러는 VEX V5 Brain에 연결되어 있습니다.
스크린샷
카메라 아이콘을 클릭하면 사용자는 VEX Brain에서 스크린샷을 찍고 다운로드할 수 있습니다.
스크린샷은 USB를 통해 VEX Brain에 직접 연결된 경우에만 사용할 수 있습니다.
배터리 메딕(V5 브레인 전용)
하트 아이콘을 클릭하면 확장 프로그램이 배터리 메딕 사용자 프로그램을 다운로드하고 실행합니다.
두뇌 이름 설정
시스템>이름 옆에 있는 연필 아이콘을 클릭하면 사용자가 VEX Brain의 이름을 설정할 수 있습니다.
연필 아이콘을 클릭하면 VS Code 편집기 상단에 입력 상자가 나타납니다. 입력창에 새로운 뇌 이름을 입력하고 엔터를 눌러 설정하세요.
팀 번호 설정
시스템>팀 옆에 있는 연필 아이콘을 클릭하면 사용자는 VEX Brain의 팀 번호를 설정할 수 있습니다.
연필 아이콘을 클릭하면 VS Code 편집기 상단에 입력 상자가 나타납니다. 입력창에 새로운 팀 번호를 입력하고 엔터를 눌러 설정하세요.
사용자 프로그램 지우기
프로그램>프로젝트 이름 옆에 있는 휴지통 아이콘을 클릭하면 특정 슬롯에 있는 프로그램을 삭제할 수 있습니다. 중요프로그램을 삭제하면 복구할 수 없습니다. 이 기능을 사용할 때는 주의하시기 바랍니다.
장치 정보 경고
VEXos 업데이트
VEX Brain의 VEXos 버전이 오래된 경우 VEXos 버전 옆에 경고 메시지 아이콘이 나타나고 두 Brain 아이콘이 모두 노란색으로 변합니다.
이 경고를 해결하려면 사용자는 VEXos Brain용 VEXos를 업데이트해야 합니다.
VEX 두뇌 아이콘 옆에 있는 위쪽 화살표를 클릭하면 VEXos를 업데이트할 수 있습니다.
또한 VEXos가 오래된 경우 VS Code 편집기의 오른쪽 하단에 알림 상자가 나타납니다. 사용자는 "업데이트" 버튼을 클릭하여 VEXos 업데이트를 시작하거나 "무시" 버튼을 클릭하여 VEXos 업데이트를 건너뛸 수 있습니다.
연결된 컨트롤러에 두뇌가 연결되지 않았습니다.
VEX 컨트롤러 아이콘은 VEX 컨트롤러가 컴퓨터에 연결되어 있지만 VEX Brain에 연결되어 있지 않으면 노란색으로 변합니다.
이 경고를 해결하려면 사용자는 VEX 컨트롤러를 VEX Brain에 연결해야 합니다.
터미널 패널
VEX VS Code 확장은 시작 시 로그 터미널과 대화형 터미널이라는 두 개의 터미널을 제공합니다.
로그 터미널
로그 터미널에는 빌드 출력, 빌드 오류 및 다운로드 결과가 표시됩니다.
대화형 터미널
대화형 터미널에는 printf 로그를 표시하고 원시 키 입력을 사용자 프로그램으로 다시 보내는 두 가지 기능이 있습니다. 대화형 터미널을 활용하려면 Brain 또는 Controller가 VEX VS Code Extension을 실행하는 컴퓨터에 연결되어야 합니다. 대화형 터미널 출력은 사용자 프로그램을 빌드하고 다운로드한 후 기본적으로 지워집니다.
사용자 설정
사용자 설정은 Visual Studio 코드가 각 확장에 대해 제공하는 전역 설정입니다. 사용자 설정은 모든 VEX VS Code 확장 프로젝트에 적용됩니다.
VEX 사용자 설정에 액세스하는 방법
VS Code의 왼쪽 모서리에 있는 기어를 클릭하면 상황에 맞는 메뉴가 나타납니다.
상황에 맞는 메뉴에서 "설정" 항목을 클릭하면 설정 페이지가 나타납니다.
왼쪽 목록 보기에서 "확장" 항목을 클릭합니다. 그런 다음 아래로 스크롤하여 "VEX"라고 표시된 항목을 찾으세요.
“VEX” 목록 항목을 클릭하세요.
VEX 사용자 설정이 오른쪽 패널에 나타납니다.
설정 개요
컨트롤러 채널(V5 컨트롤러만 해당)
컨트롤러 채널 설정은 V5 Brain과 V5 컨트롤러 간의 무선 통신 채널 유형을 제어합니다.
이 설정은 VS Code가 USB를 통해 V5 컨트롤러에 연결되고 컨트롤러가 VEXnet을 통해 V5 Brain에 연결된 경우에만 적용됩니다. 사용자는 다운로드 과 Pit 채널 중에서 선택할 수 있습니다. 다운로드로 설정하면 사용자 프로그램 다운로드가 시작되면 라디오가 다운로드 VEXnet 채널로 이동합니다. 다운로드 채널을 사용하면 더 높은 데이터 속도와 더 효율적인 다운로드가 가능합니다. Pit로 설정하면 라디오가 피트 채널에 유지되고 다운로드 시간이 훨씬 더 오래 걸립니다. 기본적으로 이 설정은 다운로드로 설정됩니다.
Cpp 프로젝트 SDK 홈
이 설정을 편집하지 마십시오.
Cpp 툴체인 경로
Cpp 툴체인 경로 C++ VEX VS Code 프로젝트를 빌드할 때 사용되는 툴체인의 경로를 설정합니다.
사용자 터미널 활성화
사용자 터미널 활성화 설정을 사용하면 확장 프로그램에서 VEX Brain 또는 VEX 컨트롤러가 감지될 때 확장 프로그램이 사용자 직렬 포트를 열 수 있습니다. 유일한 예외는 사용자 직렬 포트를 열거하지 않는 V5 컨트롤러에 적용됩니다.
활성화 확장이 시작 시 사용자 포트에 연결되도록 허용하고 대화형 터미널을 생성합니다. 확장이 실행되는 동안 활성화를 선택하면 장치가 연결되어 있으면 확장이 사용자 포트를 열려고 시도합니다.
비활성화 확장이 시작 시 사용자 포트에 연결되는 것을 방지하고 대화형 터미널을 생성하지 않습니다. 확장이 실행되는 동안 비활성화를 선택하면 확장은 사용자 포트를 닫고 대화형 터미널을 제거합니다.
프로젝트 빌드 유형
프로젝트 빌드 유형 은 확장이 C++ 프로젝트를 빌드하는 방법을 설정합니다. 사용자는 빌드 유형을 빌드 또는 다시 빌드로 설정할 수 있습니다.
Build Make가 프로젝트 소스 코드에서 변경 사항을 감지한 경우에만 프로젝트를 빌드합니다.
Rebuild 는 프로젝트의 빌드 디렉터리를 정리한 다음 프로젝트를 빌드합니다. 이 옵션은 일반적으로 훨씬 느립니다.
프로젝트 홈
프로젝트 홈 은 새 프로젝트 마법사를 완료할 때 새 프로젝트의 기본 홈 디렉터리를 설정합니다.
다운로드 후 실행
다운로드 후 실행 활성화하면 VEX Brain에 다운로드된 후 사용자 프로그램이 실행됩니다.
Python SDK 홈
이 설정을 편집하지 마십시오.
VEX 명령 도움말
VEX 명령 도움말을 사용하면 C++ 및 Python API(응용 프로그래밍 인터페이스)에 포함된 특정 기능에 대한 문서에 액세스할 수 있습니다. 문서는 각 VEX 플랫폼(IQ 2세대, EXP, V5)에 따라 다릅니다.
VEX 명령 도움말에 액세스하려면 먼저 검색할 함수의 텍스트를 강조 표시하세요.
선택한 텍스트를 마우스 오른쪽 버튼으로 클릭하면 상황에 맞는 메뉴가 나타납니다.
다음 문서에 액세스하려면 VEX 명령 도움말을 클릭하세요.
VEX 명령 도움말이 정확히 일치하는 항목을 찾으면 관련 문서와 함께 새로운 웹뷰가 나타납니다.
여러 문서가 선택한 텍스트와 일치하는 경우 관련 문서의 필터링된 목록이 포함된 드롭다운이 나타납니다.