비행 스탠드 소프트웨어 사용자 매뉴얼

Flight Stand Software User Manual

Flight Stand 15, 50, 150, 500과 함께 제공되는 Flight Stand 소프트웨어의 전체 사용자 설명서입니다.

Flight Stand 소프트웨어 사용자 설명서(PDF)를 다운로드하세요.

목차

  1. 소프트웨어 다운로드
  2. 시뮬레이션 보드 설정(선택 사항)
  3. 소프트웨어 구성
    1. 측정 단위
    2. 하드웨어 연결 확인
    3. 안전 한계
    4. 파워트레인 매핑
  4.  수동 테스트
  5. 자동 테스트
    • 값 테이블
    • .CSV 업로드 / 비행 재현
    • Python API 준비된 테스트 스크립트
      • 사인파
      • 처프 신호
      • 톱니파
      • PID 튜닝
  6. 테스트 설정 및 데이터 처리
    • 모터 속도 제한기
    • 실시간 데이터 플롯 사용자 지정
    • 노이즈 제거
    • 데이터 리샘플링
    1. CAN ESC 연결
    2. 소프트웨어 원격 제어

    1. 소프트웨어 다운로드

      Flight Stand 소프트웨어를 컴퓨터에 다운로드하고 설치하세요.

      단계:

      1. tytorobotics.com/download
      2. "Flight Stand Software" 섹션을 찾아 "download" 버튼을 클릭하세요.
        download flight stand software
      3. 다운로드가 완료되면 컴퓨터에서 설치 프로그램을 실행하여 소프트웨어를 설치하세요.

      컴퓨터에 소프트웨어를 설치하는 중에 문제가 발생하면 관리자 모드에서 설치를 시도해 보세요.

      2. 시뮬레이션 보드 설정

      소프트웨어에는 사용자가 추력 스탠드를 구매하기 전에 소프트웨어를 테스트하고 살펴볼 수 있는 시뮬레이션 보드 기능이 포함되어 있습니다. 시뮬레이션 보드를 연결하는 것은 선택 사항이지만, 구매할 필요 없이 소프트웨어에 익숙해질 수 있는 좋은 방법입니다.

      시뮬레이션의 데이터 출력은 성능 모델을 만드는 데 사용된 실제 모터 테스트를 기반으로 합니다.

      비디오 튜토리얼: https://www.youtube.com/watch?v=oszJTbkftbE


      단계: 

      1. Flight Stand 소프트웨어를 열고 Hardware 탭으로 이동하세요.
      2. "Connect Simulated Board" 버튼을 클릭하세요. 왼쪽 패널에 시뮬레이션 데이터가 들어오는 것을 볼 수 있습니다.
        simulated thrust stand setup
      3. 듀얼 모터 시스템을 시뮬레이션하려면 Hardware 탭으로 돌아가 "Connect Simulated Board"를 다시 클릭하고 다른 시뮬레이션 파워트레인을 추가하세요.

      시뮬레이션 보드가 연결되면 실제 추력 스탠드인 것처럼 계속 진행하여 다음 섹션에서 설명하는 설정, 테스트 및 데이터 시각화를 수행할 수 있습니다.

      3. 소프트웨어 구성

        최적의 성능과 안전을 보장하려면 테스트를 시작하기 전에 소프트웨어를 구성하세요. 드롭다운 메뉴의 처음 네 가지 옵션에서 설정을 살펴보겠습니다.

        configure the flight stand software

        비디오 튜토리얼: https://youtu.be/JUSK1Mns0TA?si=jojtv8rcm57Np1vZ&t=27

        단계:

        1. Flight Stand 소프트웨어를 여세요.
        2. Flight Stand를 컴퓨터의 USB 포트에 연결하세요. 왼쪽 패널에 Force Measurement Unit과 Electrical Measurement가 나타납니다.
          1. 분산 전기 추진(DEP) 테스트를 위해 최대 8개의 파워트레인을 동시에 연결할 수 있습니다.
        3. 'Setup'을 클릭하세요. 여기에서 측정 단위를 원하는 대로 사용자 지정할 수 있습니다.
        4. 'Hardware'를 클릭하세요. 여기에서 시리얼 번호, 펌웨어, 서보 컨트롤러 및 프로브와 같이 현재 연결된 시스템을 포함하여 연결된 Flight Stand(들)에 대한 세부 정보를 볼 수 있습니다.
        5. 'Safety limits'를 클릭하세요. 여기에서 추력, 토크, 전압, 전류 및 RPM이 얼마나 높거나 낮아질 수 있는지 제한하는 안전 차단값을 설정할 수 있습니다.
        6. 'Powertrains'를 클릭하세요. 여기에서 모터, 프로펠러, ESC 및 전원에 이름을 할당하여 파워트레인을 매핑할 수 있습니다. 여기에서 파워트레인이 올바른 힘 및 전기 측정 단위와 연결되어 있는지 확인할 수도 있습니다.

        4. 수동 테스트

          ESC 스로틀 슬라이더를 사용하여 수동 제어 테스트를 수행하세요.

          비디오 튜토리얼: https://youtu.be/FzfvaZogpwQ?si=6XANU7NCvHQAaHju

          단계:

          1. 테스트 스탠드 또는 시뮬레이션 보드가 올바르게 연결되어 있는지 확인하세요.
          2. 드롭다운 메뉴에서 'Manual Control' 탭을 클릭하세요.
          3. 테스트에 이름을 지정하세요.
          4. 데이터를 어떻게 기록할지 결정하세요. 'Record'를 클릭하여 연속으로 기록하거나 'Take sample' 버튼을 사용하여 스냅샷 판독값을 가져옵니다.
          5. 슬라이더 옆의 상자를 확인하여 ESC를 활성화하세요.
          6. 스로틀 슬라이더를 드래그하여 테스트를 시작하거나 텍스트 상자에 스로틀 값을 입력하세요.
            manual test in flight stand software
          7. 창 하단에서 확장할 수 있는 실시간 플롯을 사용하여 들어오는 데이터를 확인하세요.
          8. 슬라이더 옆의 상자를 해제하여 ESC를 비활성화하세요.
          9. 'Record' 버튼을 다시 클릭하여 연속 녹화를 중단하세요
          10. 'Save and new'를 클릭하여 테스트를 저장하세요.
          11. 'Test' 탭에서 결과를 확인하고 데이터를 내보낼 수도 있습니다.

          5. 자동 테스트

            여러 가지 방법 중 하나를 사용하여 자동 테스트를 설정하고 프로그래밍하세요.

            a. 값 테이블

            비디오 튜토리얼: https://youtu.be/0RqCtd3qnwc?si=l44I6jeJQab18dnr

            단계:

            1. 'Manual Control' 탭에서 ESC를 활성화하세요.
            2. 'Automatic Control' 탭에서 테스트 유형(Step 또는 Ramp)을 선택하세요.
              step or manual test with thrust stand
            3. 'Controlled outputs' 아래에서 테스트하려는 파워트레인 옆의 상자를 확인하세요.
            4. 'Sequence form' 아래에서 'Add Row' 상자를 사용하여 스로틀을 변경하려는 시점을 입력하세요.
            5. 'Powertrain throttle' 열에 'Time' 열의 시점과 일치하도록 원하는 스로틀 값을 추가하세요.
              automatic control test table for thrust stand
            6. 데이터를 수집할 방법을 선택하세요.
              • 각 시점에서 샘플을 가져오려면 테이블에서 'Take sample' 상자를 확인하세요.
              • 데이터를 연속으로 기록하려면 아래로 스크롤하여 'Sequence runner'로 이동하고 'Continuous recording"을 켜세요.
              1. 아래로 스크롤하여 'Sequence Preview'에서 테스트가 어떻게 보이는지 확인하세요.
              2. 중단하지 않고 테스트 시퀀스를 여러 번 실행하려면 'Loop sequence' 상자에 반복 횟수를 입력하세요.
              3. 'Title' 상자에 테스트 이름을 지정하세요.
              4. 'Execute sequence'를 클릭하여 테스트를 실행하세요.
              5. 테스트가 완료되면 왼쪽 패널에 노란색 상자가 나타나며 여기서 데이터를 저장하거나 버릴 수 있습니다.

              b. CSV 업로드 / 비행 재현

              비디오 튜토리얼: https://youtu.be/FroCYgVlPgQ?si=3QrXeoAZ26-I1jBM

              단계:

              1. 자동 테스트 유형을 선택한 후 'Sequence editor' 아래에서 'Tools' 드롭다운을 클릭하고 'Load demo example'을 선택하세요.
              2. 다시 'Tools' 드롭다운 아래에서 'Export sequence from CSV'를 선택하세요.
              3. 내보낸 CSV 파일을 템플릿으로 사용하고 원하는 시간과 스로틀 지점을 추가하세요.
              4. 파일이 준비되면 'Tools' 드롭다운으로 돌아가 'Import sequence from CSV'를 선택하고 컴퓨터에서 편집된 CSV 파일을 업로드하세요.
                upload sequence from CSV flight stand software
              5. 아래로 스크롤하여 시퀀스를 미리 보고 실행하세요. 테스트가 완료되면 왼쪽 패널에 노란색 상자가 나타나며 여기서 데이터를 저장하거나 버릴 수 있습니다.

              c. Python API

              비디오 튜토리얼: https://youtu.be/Gkf0dAnA1w4?si=nV3WNBGPCv49miR8

              단계:

              1. 시작하기 전에 컴퓨터에 Flight Stand 소프트웨어의 최신 버전과 Python 컴파일러가 포함된 텍스트 편집기가 설치되어 있는지 확인하세요.
              2. Flight Stand 소프트웨어의 'Hardware' 탭에서 Flight Stand 또는 시뮬레이션 회로 보드를 연결하세요.
              3. 'Automatic Control' 탭으로 이동하고 테스트 옵션에서 'Python API'를 선택하세요.
              4. 다음 저장소에서 저장소를 열고 'README' 파일을 읽으세요: https://gitlab.com/TytoRobotics/flightstand-api.
                flight stand api repository gitlab
              5. 선호하는 텍스트 편집기(예: PyCharm)를 여세요.
              6. PyCharm에서는 가상 환경을 구성해야 합니다.
                1. VS Code와 같은 다른 텍스트 편집기를 사용하는 경우 Python 또는 Python 확장 프로그램을 설치해야 합니다.
              7. PyCharm에서 저장소의 Python 폴더를 여세요.
              8. 폴더에서 터미널을 열고 다음 명령어를 실행하세요: py -m pip install grpcio grpcio-tools
                python command grpcio tools
              9. 연결을 확인하려면 Flight Stand 소프트웨어를 열고 실시간 플롯을 표시하세요. 그런 다음 Python에서 example.py를 실행하세요.
                • PyCharm에서 터미널 출력에 사용 가능한 모든 보드가 표시되고 시뮬레이션 보드가 자동으로 연결된 후 해당 보드에서 사용 가능한 모든 입력과 출력이 나열되는 것을 볼 수 있습니다.
                • 연결이 성공하면 터미널의 마지막 몇 줄에 Flight Stand 소프트웨어에서 볼 수 있는 ESC 스로틀 값이 표시됩니다.
                  python api successful connection

                d. 준비된 테스트 스크립트

                이 Google 시트(https://docs.google.com/spreadsheets/d/1XvXoo7h2_0t1s1L2px2kDtGj2X2kDnwxDqttWxkEFus/edit?usp=sharing)에는 사인파, 처프 신호 및 톱니파 테스트 템플릿이 포함되어 있습니다. 템플릿을 사용하려면 '파일' → '사본 만들기'로 이동한 다음 Google 드라이브에 추가하세요.

                i. 사인파

                비디오 튜토리얼: https://youtu.be/0pu8JYqnV80

                단계:

                1. 위의 Google 시트 복사본을 열고 ‘Sine/Chirp Generation’ 탭으로 이동합니다.
                2. 2행에서 라인 수, 가속도, 주파수, 진폭 및 오프셋 값을 조정하여 사인파를 설계합니다. 그러면 ‘Throttle vs. Time’ 그래프의 미리보기가 조정됩니다.
                3. ‘Time’ 및 ‘Throttle - Sine’ 열의 데이터를 ‘Sine Wave Data for Export’ 탭으로 복사합니다.
                4. 데이터를 해당 열에 추가한 후, 파일을 CSV 파일로 다운로드합니다(파일 → 다운로드 → .csv).
                5. Flight Stand 소프트웨어를 열고 ‘Automated Control’ 탭으로 이동한 후 ‘Step test’를 클릭합니다.
                  사인파 테스트 Flight Stand 소프트웨어
                6. ‘Tools’에서 ‘Import sequence from CSV’를 선택합니다.
                7. Google 시트에서 다운로드한 CSV 파일을 선택하고 가져옵니다.
                8. 사인파 데이터 포인트가 표에 표시되고 Sequence 미리보기 창에 파형 미리보기가 표시됩니다.
                9. ‘Execute sequence’를 클릭하여 테스트를 실행합니다.
                10. 테스트가 완료되면 왼쪽 패널에 노란색 상자가 나타나며, 여기서 데이터를 저장하거나 삭제할 수 있습니다.

                ii. 칩 신호

                  비디오 튜토리얼: https://youtu.be/0pu8JYqnV80?si=GQYjKerpszKwcb5q&t=129

                  단계:

                  1. 위의 Google 시트 복사본을 열고 ‘Sine/Chirp Generation’ 탭으로 이동합니다.
                  2. 2행에서 라인 수, 가속도, 주파수, 진폭 및 오프셋 값을 조정하여 파형을 설계합니다. 그러면 ‘Throttle vs. Time’ 그래프의 미리보기가 조정됩니다.
                  3. ‘Speedup of chirp’ 값을 조정합니다.
                  4. ‘Time’ 및 ‘Throttle - Chirp’ 열의 데이터를 ‘Chirp Data for Export’ 탭으로 복사합니다.
                  5. 데이터를 해당 열에 추가한 후, 파일을 CSV 파일로 다운로드합니다(파일 → 다운로드 → .csv).
                  6. Flight Stand 소프트웨어를 열고 ‘Automated Control’ 탭으로 이동한 후 ‘Step test’를 클릭합니다.
                  7. ‘Tools’에서 ‘Import sequence from CSV’를 선택합니다.
                  8. Google 시트에서 다운로드한 CSV 파일을 선택하고 가져옵니다.
                  9. 칩 테스트 데이터 포인트가 표에 표시되고 주파수가 증가하는 파형 미리보기가 Sequence 미리보기 창에 표시됩니다.
                  10. ‘Execute sequence’를 클릭하여 테스트를 실행합니다.
                    칩 신호 테스트 Flight Stand 소프트웨어
                  11. 테스트가 완료되면 왼쪽 패널에 노란색 상자가 나타나며, 여기서 데이터를 저장하거나 삭제할 수 있습니다.

                  iii. 톱니파

                    비디오 튜토리얼: https://youtu.be/0pu8JYqnV80?si=c1WeU3UYjajHE6Bu&t=204

                    단계:

                    1. Flight Stand 소프트웨어를 열고 ‘Automated Control’ 탭으로 이동합니다.
                    2. ‘Ramp test’를 클릭합니다.
                    3. ‘Sequence editor’ 표에 시간, 스로틀 및 변화율에 대한 2행의 데이터를 입력합니다.
                    4. 아래 ‘Sequence preview’ 창에 간단한 상승/하강 패턴(톱니파) 미리보기가 표시됩니다.
                      톱니파 테스트 추력 스탠드
                    5. ‘Loop sequence’ 상자에 원하는 반복 횟수를 입력하고 ‘Execute sequence’를 클릭합니다.
                    6. 테스트가 완료되면 왼쪽 패널에 노란색 상자가 나타나며, 여기서 데이터를 저장하거나 삭제할 수 있습니다.

                    iv. PID 튜닝

                      참고: 이 섹션에서는 비디오 튜토리얼을 시청할 것을 강력히 권장합니다.

                      PID 컨트롤러는 특정 센서를 특정 값으로 유지하는 것을 목표로 하는 특수 알고리즘입니다. PID 컨트롤러는 추진 시스템이 원하는 센서 값으로 수렴하도록 필요한 스로틀 출력을 지속적으로 계산하여 이를 달성합니다.

                      이 튜토리얼을 완료하기 전에 저장소의 첫 번째 example.py 파일을 성공적으로 실행할 수 있어야 합니다. 아직 실행하지 않은 경우, PID 예제를 실행하려면 특정 패키지를 설치해야 하므로 이 사용자 설명서의 5c 섹션으로 이동하여 방법을 알아보세요.

                      비디오 튜토리얼: https://youtu.be/8HSNoONR3yg

                      단계:

                      1. example.py 파일(5c 섹션)을 성공적으로 실행할 수 있다고 가정하고 Flight Stand 소프트웨어를 엽니다.
                      2. Python 컴파일러(예: PyCharm)를 열고 콘솔을 열어 simple-pid가 설치되어 있는지 확인합니다. 다음 명령어를 실행하여 설치할 수 있습니다: py -m pip install simple-pid
                      3. .proto 파일을 열어 목표로 하는 변수의 신호에 해당하는 번호를 찾습니다(예시로 추력을 사용합니다). 그런 다음 입력 신호 목록이 보일 때까지 아래로 스크롤합니다. 추력(FZ)은 11번에 해당하므로 이를 기록해 둡니다.
                        PID 튜닝 추력 스탠드 소프트웨어
                      4. example 4를 열고 입력 및 출력 신호를 Flight Stand 소프트웨어의 파워트레인과 일치하도록 변경합니다. 이 정보는 Flight Stand 소프트웨어에서 ‘Hardware’ 탭으로 이동하여 파워트레인을 클릭하고 ‘Identification’ 탭 아래의 첫 번째 텍스트 줄을 강조 표시하면 확인할 수 있습니다.
                        PID 경로 Flight Stand 소프트웨어
                      5. 이 정보를 Python 파일의 입력/출력 보드 정보에 복사하여 붙여넣습니다.
                      6. Python 파일을 실행합니다. 터미널에 사용 가능한 입력 목록이 표시됩니다. 
                      7. 목표 변수의 신호와 동일한 번호에 해당하는 입력(추력의 경우 #11)을 찾아 target input board 다음에 입력합니다.
                      8. 아래로 스크롤하여 ‘Target value’를 찾고, 파일이 SI 단위를 사용하므로 목표로 하는 추력 값을 뉴턴 단위로 입력합니다.
                        PID 튜닝 모터 테스트
                      9. 주기 길이에 대한 설정을 확인하고 PID 매개변수인 Kp, Ki, Kd의 시작 값을 설정합니다.
                        1. Ki 항(적분 항)은 오차의 적분값에 곱해지는 상수입니다. 그런 다음 그 곱을 오차를 상쇄하는 데 사용합니다.
                        2. Kd 항(미분 항)은 오차의 미분값에 곱하는 상수입니다.
                        3. Kp 항(비례 항)은 적분 및 미분 항과 유사하지만 오차와 상수의 곱입니다.
                      10. 스크립트를 실행하고 Flight Stand가 그에 따라 반응하는지 관찰합니다.
                      11. 만족스러운 PID 응답이 나올 때까지 필요에 따라 Kp, Ki, Kd 값을 조정합니다.

                      6. 테스트 설정 및 데이터 처리

                      a. 모터 속도 제한기

                      스로틀 가속도를 제어하여 토크 또는 전류 과부하로부터 모터를 보호합니다.

                      단계(수동 테스트):

                      1. 수동 테스트를 수행하는 경우, ESC를 활성화하기 전에 스로틀 슬라이더 왼쪽에 있는 기어 아이콘을 클릭합니다.
                      2. ‘Rate limiter’ 텍스트 상자에 µs/s 단위의 최대 가속도 값을 입력합니다. 
                      3. 입력하면 소프트웨어에서 최대 스로틀에서 얼마나 빨리 가속하거나 감속할 수 있는지 예시를 제공합니다.
                        • 예를 들어, 500 µs/s 속도에서는 최대 스로틀인 2000 µs에 도달하는 데 2초가 걸립니다. 
                        1. ESC를 활성화하고 스로틀을 올립니다. 주황색 막대가 속도 제한기가 적용된 스로틀 위치를 보여줍니다.
                          모터 속도 제한기 Flight Stand 소프트웨어

                        단계(자동 테스트):

                        1. 수동 제어 탭에서 속도 제한기를 켜두면 자동 제어 테스트에도 적용됩니다. 테스트 전체에 동일한 속도 제한을 적용하려면 이 옵션이 가장 좋습니다.
                        2. 또한 자동 제어 탭에서 테스트의 각 단계에 고유한 속도 제한을 구성할 수 있습니다. 시작하려면 ‘Automated Control’ 탭으로 이동합니다.
                        3. 테스트 유형을 선택하고 표에 시퀀스 단계를 입력합니다.
                        4. 표의 네 번째 열은 속도 제한기입니다. 이 열에 각 단계에 대한 원하는 제한 값을 입력합니다.
                        5. 아래로 스크롤하여 Sequence 미리보기를 확인하고 테스트 실행 시 어떻게 표시되는지 확인합니다.
                        6. ‘Execute sequence’를 클릭하여 속도 제한기가 적용된 테스트를 실행합니다.

                        b. 실시간 데이터 플롯 사용자 지정

                        테스트 중 실시간 플롯에 데이터가 표시되는 방식을 사용자 지정합니다.

                        단계:

                        1. 하단에서 위로 드래그하거나 ‘Real-time plots’ 창의 오른쪽에 있는 화살표를 사용하여 실시간 데이터 플롯 창을 확대합니다.
                        2. 파워트레인이 여러 개인 경우, 왼쪽 상단 모서리에서 각 파워트레인 옆의 상자를 확인하여 플롯에 표시할 파워트레인을 먼저 선택할 수 있습니다.
                          실시간 데이터 플롯 사용자 지정
                        3. 다음으로, 중앙의 Timespan 슬라이더를 사용하여 x축에 표시되는 시간의 양을 제어합니다. 기본값은 30초이지만 원하는 대로 더 많거나 적은 시간을 볼 수 있습니다. 
                        4. 슬라이더 오른쪽의 ‘Layout’ 버튼을 클릭하면 플롯 보기 방식을 제어할 수 있는 창이 나타납니다. 순서를 변경하고 차트를 켜거나 끄며 열 수를 조정하여 차트를 더 크게 또는 작게 만들 수 있습니다.
                          추력 스탠드 데이터 플롯 레이아웃
                        5. 오른쪽의 ‘Pause’ 토글 스위치를 클릭하면 특정 시점을 볼 수 있도록 데이터가 일시 중지됩니다. 스위치를 끄면 실시간 데이터로 건너뜁니다.
                        6. ‘Show unfiltered’ 토글 스위치를 사용하면 필터링되지 않은 데이터를 볼 수 있습니다. 기본적으로 읽기 값을 부드럽게 하기 위해 1 Hz 저역 통과 필터가 적용되지만, 이 스위치를 사용하면 필터가 제거됩니다.

                        c. 노이즈 제거

                        데이터에 적용되는 노이즈 필터를 제어합니다. 실시간 데이터 플롯의 노이즈 필터를 제어하려면 이전 섹션의 6항을 참조하세요.

                        참고: 모든 데이터는 노이즈 필터 없이 기록됩니다. 이 기능은 선택 가능한 차단 주파수를 갖는 소프트웨어 저역 통과 필터를 구현합니다.

                        저장된 데이터의 노이즈 수준을 제어하려면 아래 단계를 따르세요.

                        단계:

                        1. ‘Tests’ 탭으로 이동하여 편집하려는 테스트를 엽니다.
                        2. ‘Plots’ 탭으로 이동하여 ‘Noise filter’ 슬라이더를 사용하여 노이즈 제거 수준을 조정합니다.
                          • 자동 1 Hz 필터가 적용되지만, 완전히 끄거나 더 높거나 낮은 필터를 적용할 수 있습니다.
                            노이즈 필터 Flight Stand 소프트웨어

                          d. 데이터 재샘플링

                          테스트 후 데이터를 사용자 지정 샘플링 속도로 내보냅니다.

                          단계:

                          1. 테스트를 완료한 후 ‘Tests’ 탭으로 이동하여 테스트를 클릭합니다.
                          2. 모든 데이터 포인트가 표시된 표가 있는 내보내기 탭으로 이동합니다.
                          3. ‘Time resolution’에서 ‘Resample’ 옆의 옵션을 확인하고 나타나는 텍스트 상자에 원하는 해상도를 입력합니다. 입력하는 숫자는 샘플을 몇 초마다 제공할지 나타냅니다.
                            • 기본 재샘플링 속도는 0.1초 또는 초당 10개 샘플입니다.
                            • 유일한 제한 사항은 테스트 스탠드의 한계를 초과하여 샘플링 속도를 높일 수 없다는 것입니다(Standard Flight Stands는 초당 100개 샘플, Pro는 초당 1000개 샘플).
                              데이터 재샘플링 Flight Stand 소프트웨어
                          4. ‘Export to CSV’를 클릭하여 원하는 샘플링 속도로 테스트를 컴퓨터에 저장합니다.

                          7. CAN ESC 연결

                            Flight Stand는 대부분의 ESC 프로토콜을 지원하지만, CAN ESC 프로토콜의 경우 추가 설정이 필요합니다.

                            본 예제에서는 Zubax 장치 전용으로 제공되는 Yukon 소프트웨어를 사용합니다. 다른 CAN 제품은 다른 서드파티 소프트웨어를 사용할 수 있습니다.

                            비디오 튜토리얼: https://youtu.be/BiZuCrVQNnU?si=V2gVWdD7fGlJeMeZ

                            단계: 

                            1. Flight Stand 소프트웨어를 다운로드하고 엽니다.
                            2. 다음 주소에서 저장소를 다운로드하고https://gitlab.com/TytoRobotics/flightstand-api컴퓨터에 저장소를 압축 해제합니다.
                            3. Python 최신 버전과 PyCharm Community 에디션을 다운로드합니다.
                            4. PyCharm을 열고 다운로드한 저장소를 엽니다.
                            5. 다운로드한 폴더에서 languages → python → examples → canbus-cyphal로 이동합니다.
                              • 실행할 예제가 있는 위치입니다.
                                canbus esc connection flight stand software
                            6. “File” → “Settings” → “Project” → “Python interpreter”로 이동한 다음 팝업에서 “Add interpreter” → “Add local interpreter”를 클릭하여 Python 인터프리터를 구성합니다.
                            7. ‘Apply’를 클릭하면 PyCharm이 가상 환경을 자동으로 설정합니다. 
                              • 가상 환경이 올바르게 설정되었는지 확인하려면 가상 환경 경로에서 확인하거나 명령줄 앞에 가상 환경이 표시되는 터미널을 열면 됩니다.
                              1. ‘examples’ 아래에 있는 ‘README’ 파일을 엽니다.
                              2. README 파일에 나열된 세 가지 명령어를 실행하면 Python API를 실행하는 데 필요한 패키지가 올바르게 설치됩니다. 
                                • 연결이 작동하는지 확인하려면 Flight Stand 소프트웨어를 열고 “Hardware” 아래에 시뮬레이션 보드가 연결되어 있으며 ESC 스로틀 입력이 있는지 확인합니다.
                                  can esc setup examples
                              3. ‘examples’ 아래에서 canvas.cyphal 폴더를 열고 example_1_main을 엽니다.
                              4. 코드의 15행에 있는 명령어를 복사하여 콘솔에 붙여넣고 엔터를 눌러 추가 패키지를 설치합니다.
                                command line 15 can esc setup
                              5. 20~24행의 환경 변수를 드래그하여 선택한 다음 마우스 오른쪽 버튼을 클릭하고 ‘Modify Run Configuration’을 선택합니다. 
                              6. 환경 변수 줄에서 Ctrl A를 누른 다음 Ctrl V를 눌러 변수를 교체합니다.
                              7. ‘OK’를 클릭한 다음 마우스 오른쪽 버튼을 클릭하고 ‘Run example 1 Main’을 클릭합니다.
                              8. 이 기능을 사용하려면 라이선스 키가 필요하므로 오류가 발생할 수 있습니다 → Flight Stand와 관련된 라이선스 키를 요청하려면 support@tytorobotics.com으로 이메일을 보내세요.
                              9. 라이선스 키를 받으면 Flight Stand 소프트웨어를 열고 ‘Setup’ 탭에서 ‘License’를 클릭한 다음 라이선스 키를 입력하고 ‘Enter’를 누릅니다.
                                license key flight stand software
                              10. Flight Stand 소프트웨어가 다시 시작되고 라이선스 키 탭에 라이선스가 활성화되었음을 표시합니다.
                              11. PyCharm으로 돌아가 ‘Run example 1 Main’을 클릭합니다.
                              12. Flight Stand 소프트웨어로 돌아가면 시뮬레이션된 히터가 연결된 것을 확인할 수 있습니다.
                              13. example_1_plant.py를 엽니다.
                              14. 환경 변수를 런타임 구성에 복사하여 붙여넣고 실행을 클릭합니다.
                                • Flight Stand 소프트웨어의 ‘Manual control’ 탭에서 히터용 출력 제어 항목이 표시됩니다.
                                  heater in manual control tab
                              15. CAN bus Cyphal 장치와 상호 작용할 수 있는 Yukon 소프트웨어를 설정합니다. www.github.com/opencyphal/yukon으로 이동한 다음 GitHub releases로 스크롤을 내려 하이퍼링크를 클릭하고 다시 스크롤하여 Yukon.exe 파일을 다운로드합니다.
                              16. Yukon 파일을 엽니다. 여기에서 DSDL 네임스페이스를 설정합니다.
                                • Zubax DSDL 파일은 Zubax Cyphal CAN 장치 전용이므로 다른 제조업체의 DSDL 파일은 가져와야 할 수 있습니다.
                                1. ‘Settings’ 탭을 클릭하고 “Add path”를 클릭한 다음 “Browse”를 클릭하고 다운로드한 Flight Stand API 폴더로 이동합니다. “languages” → “python” → “examples” → “canbus_cyphal”로 이동하고 “public_regulated_data_types”를 선택합니다.
                                  add path cyphal can esc setup
                                2. 다시 “Add path”를 클릭하고 “Browse”를 클릭한 다음 동일한 하위 폴더로 이동하되, 이번에는 “zubax_dsdl” 폴더를 선택합니다. 페이지 맨 아래로 스크롤하여 “Save configuration”을 클릭합니다.
                                3. Cyphal 소프트웨어를 닫고 다시 시작합니다. 
                                4. 오른쪽 상단 근처의 “UDP interface” 필드에서 127.0.0.1 값을 변경합니다.
                                  udp interface can esc setup
                                5. “Start this transport”를 클릭합니다.
                                  • “wcap.dll 라이브러리를 찾을 수 없습니다”라는 오류 메시지가 표시되는 경우 www.npcap.com에서 Npcap 소프트웨어(무료)를 다운로드해야 합니다. 홈페이지에서 “Downloading and Installing Npcap Free Edition”으로 스크롤을 내려 Npcap 설치 프로그램을 클릭하고 다운로드한 다음 설치 과정을 완료합니다.
                                  1. 설치가 완료되면 Yukon으로 돌아가 다시 “Start this transport”를 클릭합니다.
                                  2. PyCharm에서 example_1_plant만 실행 중인지 확인한 다음 Yukon에서 2346 옆의 줄을 마우스 오른쪽 버튼으로 클릭합니다. “Subscribe to 2346”을 클릭한 다음 팝업 창에서 다시 “Subscribe”를 클릭합니다. 그러면 Flight Stand 소프트웨어에서 시뮬레이션된 온도를 실시간으로 볼 수 있습니다.
                                    subscribe to 2346 can esc setup
                                  3. 2347행도 동일하게 수행하되, “Publish to 2347”을 클릭하고 “Add number field”를 클릭합니다. “volt”를 선택하고 마지막 텍스트 상자에 “5”를 입력하여 전압을 5V로 설정합니다. 
                                  4. 활성화를 클릭하면 위 창에서 켈빈 온도 측정이 천천히 증가하기 시작하는 것을 볼 수 있습니다.
                                    publish to 2347 can esc setup
                                  5. PyCharm에서 이전 두 예제를 종료하고 example_3을 엽니다.
                                  6. ESC를 컴퓨터에 연결합니다. Zubax ESC의 경우 USB 케이블 하나는 ESC에 전원을 공급하는 데 사용하고, 다른 USB 케이블은 Babel 장치를 연결하는 데 사용합니다.
                                  7. Yukon을 열고 하드웨어가 올바르게 설정되어 있는지 확인합니다. “Settings”로 이동하여 Zubax DSDL과 같은 모든 필수 DSDL 파일이 있는지 확인합니다.
                                  8. 오른쪽 패널에서 “CAN” 및 “SL/CAN”으로 이동하고 COM3를 사용하는지 확인한 다음 “Start this transport”를 클릭합니다.
                                  9. Unassigned ports 표로 스크롤하여 필드를 해당 포트에 연결합니다:
                                    • “zubax.physics.dynamics” 옆에 “100”을 입력합니다. 
                                    • “zubax.physics.electronics” 옆에 “101”을 입력합니다. 
                                    • “setpoint_rat_torque” 옆에 “111”을 입력합니다.
                                      Assign ports Yukon CAN ESC setup
                                  10. 왼쪽 패널에서 “Restart”를 클릭하여 연결을 다시 시작합니다.
                                  11. “Monitor” 탭에서 “power” 화살표를 마우스 오른쪽 버튼으로 클릭하고 “Subscribe to 101”을 선택한 다음 “dynamics” 화살표를 마우스 오른쪽 버튼으로 클릭하고 “Subscribe to 100”을 선택합니다. 두 팝업 창에서 다시 “Subscribe”를 클릭합니다.
                                  12. “setpoint_rat_torque”를 마우스 오른쪽 버튼으로 클릭하고 “Publish to 111”을 선택합니다. “Publisher” 창에서 “Add number field”를 클릭하고 “value (0)”를 선택한 다음 가장 오른쪽 텍스트 상자에 토크(Nm 단위)로 0.05를 입력합니다.
                                  13. “Enable”을 클릭하면 ESC가 모터를 회전시킵니다. 모터에 부하가 있었다면 속도는 0.05 Nm와 관련된 RPM으로 제한됩니다.
                                    CAN ESC throttle control
                                  14. example_3_telega_ESC.py를 열고 ESC가 연결된 포트인 COM3로 44행의 포트를 변경합니다.
                                    COM port connection CAN ESC setup
                                  15. 환경 변수를 구성에 복사하여 붙여넣어 런타임 환경을 설정합니다(마우스 오른쪽 버튼 → ‘Modify Run Configuration’ → 환경 변수 줄에서 Ctrl A를 누른 다음 Ctrl V를 눌러 변수 교체 → Apply).
                                  16. Flight Stand 소프트웨어가 열려 있는지 확인한 다음 마우스 오른쪽 버튼을 클릭하고 “Run example_3_telega_ESC.py”를 선택합니다.
                                  17. Flight Stand 소프트웨어의 “Hardware” 아래에 “Zubax ESC”가 표시되면 연결에 성공한 것입니다.
                                    Connect Zubax CAN ESC
                                  18. “Powertrain Mappings” 탭에서 CAN /Zubax ESC가 올바르게 매핑되어 있는지 확인합니다.
                                  19. “Manual Control” 탭에서 ESC를 활성화하여 연결을 테스트합니다.

                                  8. 소프트웨어 원격 제어

                                    소프트웨어를 원격으로 제어하면 Python API를 사용하여 다른 운영 체제를 사용하거나 사용자 안전을 강화하는 등 여러 가지 이유로 유용할 수 있습니다. 이 섹션에서는 동일한 네트워크에 있는 두 대의 컴퓨터를 사용하여 원격 연결을 설정하는 방법을 설명합니다. 하나는 USB를 통해 Flight Stand의 동기화 허브에 연결되고, 다른 하나는 원격으로 사용됩니다.

                                    이 기능에는 몇 가지 안전상의 문제가 따르므로 주의해야 합니다. 네트워크에 있는 누구나 프로펠러를 회전시킬 수 있으므로 팀과 원활하게 소통하고 환경을 완전히 제어하고 있으며 개인 네트워크를 사용하는지 확인하세요.

                                    비디오 튜토리얼: https://youtu.be/kfvCMsBG8mg

                                    단계: 

                                    1. Flight Stand 소프트웨어가 닫혀 있는지 확인한 다음 소프트웨어 바로가기에서 마우스 오른쪽 버튼을 클릭합니다.
                                    2. “Properties”를 클릭한 다음 “Target” 필드를 찾아 줄 끝에 명령줄 인수 “ --remote”를 추가합니다.
                                      • 이름이 유효하지 않다는 오류 메시지가 표시되는 경우 "--remote" 앞에 공백을 추가했는지 확인하세요.
                                        Flight stand remote connection computer 1
                                    3. 소프트웨어를 열면 원격 연결을 수락하고 있다는 것을 상기시켜 주는 경고 메시지가 나타납니다. 이는 몇 가지 안전상의 문제가 따르기 때문입니다.
                                      Thrust stand remote control safety feature
                                    4. 동일한 컴퓨터에서 컴퓨터의 IP 주소를 찾습니다. 명령 프롬프트에 “ipconfig” 명령어를 입력하여 확인할 수 있습니다.
                                      Retrieve IP address
                                    5. 두 번째 컴퓨터에서 Flight Stand 소프트웨어 바로가기를 찾아 마우스 오른쪽 버튼을 클릭합니다.
                                    6. “Properties”를 클릭한 다음 “Target” 필드를 찾아 줄 끝에 명령줄 인수 “--target=192.168.86.57:50051”을 추가합니다. 콜론 앞의 숫자는 첫 번째 컴퓨터의 IP 주소입니다.
                                    7. 소프트웨어를 실행하면 동일한 경고 메시지가 표시됩니다.
                                    8. 연결을 테스트하려면 “Manual Control” 탭으로 이동하여 ESC를 활성화하고 스로틀을 높여 봅니다. 첫 번째 컴퓨터와 Flight Stand에 입력한 내용이 그대로 반영되어야 합니다.