BCBTuner 프로그램 사용 매뉴얼

작성 기준일: 2026-11-02

프로그램 버전: BCBTuner 1.0.1 (빌드 번호 1)

• BCBTuner 프로그램 다운로드 (ZIP)

이 문서는 현재 BCBTuner의 Flutter 앱을 기준으로 작성했습니다. BCBTuner는 서보·브러시리스·휠 구동 드라이브의 파라미터 설정, 시운전, 입출력 설정, 파형 확인과 진단을 위한 프로그램입니다.

화면은 macOS에서 실행한 BCBTuner 앱을 직접 캡처했습니다. 아래 그림의 운전 상태와 파형은 연결 해제 또는 시뮬레이터 상태입니다.

목차

1. 실행 및 빠른 시작

2. 화면 구성과 공통 메뉴

3. 프로젝트 생성·열기·저장

4. 통신 설정과 연결

5. 시운전

6. 디지털 입출력

7. 파라미터

8. 객체 사전

9. 원점복귀 설정

10. 파형 모니터

11. 알람 진단

12. 파라미터 전송

13. 펌웨어 업데이트

14. 파일 형식과 저장의 차이

15. 문제 해결과 현재 제한

16. 참고 문서와 캡처 목록

1. 실행 및 빠른 시작

1.1 소스에서 실행

프로젝트는 Flutter 3.44.6 / Dart 3.12.2에서 개발되었습니다. 작업 폴더 amps에서 다음 명령을 실행합니다.

1.2 장비 없이 확인하기

1. 앱을 실행하고 기본 화면인 시운전을 확인합니다.

2. 필요하면 새로 만들기/열기에서 제품을 선택합니다. 기본 제품은 서보입니다.

3. 우측 상단 시뮬레이터 연결을 누릅니다.

4. 상단에 시뮬레이터, 하단에 통신: 시뮬레이터가 표시되는지 확인합니다.

5. 시운전의 전원 모양 서보 버튼으로 운전 허가를 켭니다. 하단 상태가 서보 ON으로 바뀝니다.

6. 조그 운전, 파라미터 조회 또는 파형 수집을 확인합니다.

7. 마치면 하단 정지를 누르고 연결 해제를 누릅니다.

시뮬레이터의 값은 로컬 모의 데이터입니다. 시뮬레이터에 다시 연결하면 값과 파형이 초기화되므로, 남길 결과는 파일로 저장하십시오.

2. 화면 구성과 공통 메뉴

위치	기능
상단 메뉴	프로젝트, 드라이브, 언어 선택
상단 도구 모음	프로젝트 열기·저장, 통신 설정, 제어값·모터값 저장, 재시작, 연결·해제
좌측 작업 영역	9개 작업 화면으로 이동
중앙 상단 탭	한 번 연 작업 화면으로 다시 이동
중앙 작업 화면	선택한 기능의 설정값, 표, 그래프 표시
하단 드라이브 상태	서보 ON/OFF, 위치, 속도, 전류 표시 및 정지 명령
맨 아래 상태 표시줄	알람·통신 상태, 최근 처리 결과 또는 오류 표시

언어 → 한국어 / English로 표시 언어를 바꿉니다. 언어 변경은 선택한 항목의 코드값을 보존하며, 언어 전환 자체로 드라이브에 쓰기 명령을 보내지 않습니다.

영어로 전환해도 창 제목과 앱 이름은 BCBTuner로 유지됩니다.

프로젝트 → 프로그램 정보에서 BCBTuner 아이콘과 버전을 확인합니다.

작은 창에서는 가로·세로 스크롤로 나머지 컨트롤을 확인합니다. 표에서 —는 현재 표시할 값이 없다는 뜻입니다. 설정값 칸에 보이는 0은 아직 읽지 않은 항목의 편집용 기본 표시일 수 있으므로 실제 장비값으로 간주하지 마십시오. 하단 드라이브 펌웨어 버전 —도 현재 고정 표시입니다.

3. 프로젝트 생성·열기·저장

3.1 새 프로젝트

1. 도구 모음 새로 만들기/열기 또는 프로젝트 → 프로젝트 새로 만들기/열기를 선택합니다.

2. 서보 모터, 브러시리스 모터, 휠 구동 모터 중 대상 제품을 선택합니다.

3. 기존 프로젝트 파일 열기를 해제한 상태에서 완료를 누릅니다.

4. 좌측 드라이브 제품 표시와 파라미터 목록을 확인합니다.

제품	내부 식별자	객체 수
서보 모터	servo	827
브러시리스 모터(BLDC)	brushless	711
휠 구동 모터	wheel	612

프로젝트 설정을 완료하면 기존 통신 연결이 해제되고 화면 입력값·사용자 그룹·캐시된 파라미터값이 새 제품 기준으로 초기화됩니다. 유지할 프로젝트는 먼저 저장하십시오.

제품별 기능과 접근 권한

선택한 제품의 객체 사전과 R(읽기)·W(쓰기) 권한을 기준으로 메뉴·입력·버튼의 사용 가능 여부를 결정합니다. 운전에 필요한 객체나 권한이 없으면 해당 운전 입력과 실행 버튼이 비활성화됩니다. 기능에 필요한 지원 객체가 없는 화면은 열 수 없습니다. 읽기 가능한 객체가 남아 있는 원점복귀 설정 화면은 조회할 수 있으며, 쓰기 권한이 없는 항목만 비활성화됩니다. 통신 연결과 운전 허가가 필요한 버튼은 해당 조건도 충족해야 합니다.

사전 기준 항목	Servo	BLDC	Wheel
파라미터 기본 그룹	11개	10개	7개
디지털 입력 기능 설정	DIN1~8	DIN1~8	DIN1~3
디지털 출력 기능 설정	OUT1~8	OUT1~8	OUT1~2
입력 / 출력 기능 선택지	22 / 13개	22 / 13개	7 / 3개
제어·모터·비휘발성 저장	지원 객체로 실행	지원 객체로 실행	Wheel 전용 저장 객체로 실행
제어 파라미터 초기화	지원	지원	현재 명령의 지원 객체가 없어 비활성화
토크 지령 6071:00	쓰기 가능	쓰기 가능	객체가 없어 전송 차단

조그·위치 이동·원점복귀 관련 객체는 세 제품의 사전에 모두 있습니다. 제품명만으로 일괄 제거하지 않으며, 각 기능에 필요한 객체의 권한과 단위 변환 참조 객체까지 검사합니다. 이 표는 제공된 사전을 기준으로 하며, 실제 모델·펌웨어의 지원과 물리 IO 수를 자동 검출한 결과는 아닙니다.

제품을 변경하면 파형 수집·반복 운전을 해제하고 이전 제품의 전송 목록·저장값·감시 객체도 초기화합니다. 사전에 없는 객체, 권한이 없는 요청, 지원하지 않는 자료형은 시뮬레이터와 실제 UART 통신 모두에서 거부합니다. 여러 객체를 쓰는 운전·저장 명령은 필요한 객체와 권한을 먼저 검사하며, 파일의 일괄 쓰기는 전체 값의 범위도 먼저 검사합니다. 장비 응답 오류가 발생한 뒤 이미 전송된 명령을 되돌리는 기능은 없습니다.

3.2 기존 프로젝트 열기

1. 같은 설정 창에서 기존 프로젝트 파일 열기를 체크합니다.

2. 완료를 누르고 .prj 파일을 선택합니다.

3. 파일의 제품 종류, 사용자 그룹과 저장값을 불러옵니다. 제품 종류는 파일 내용이 우선합니다.

프로젝트를 여는 동작은 드라이브에 저장값을 일괄 쓰지 않습니다. 실제 장비를 연결한 뒤 필요한 값을 읽고 적용합니다. 시뮬레이터를 새로 연결하면 프로젝트에서 불러온 로컬 값도 시뮬레이터 초기값으로 재설정됩니다.

3.3 프로젝트 저장

프로젝트 저장을 누르고 저장 위치를 선택합니다. 기본 파일명은 BCBTuner.prj입니다. 기본 그룹·사용자 그룹에 포함된 객체와 앱이 보유한 값을 기록합니다. 값이 없는 항목은 0으로 기록되므로, 장비 백업을 만들 때는 필요한 항목을 먼저 읽어야 합니다. 전체 객체 사전의 모든 값이나 모든 화면 설정을 저장하는 기능은 아닙니다.

4. 통신 설정과 연결

통신 설정에서 다음 항목을 지정합니다.

항목	설정
시리얼 포트	시뮬레이터 또는 운영체제가 제공하는 실제 포트
통신 속도(bps)	4800, 9600, 14400, 19200, 38400, 56000, 57600, 115200
드라이브 ID	0~255, 초기 표시값 127
포트 새로고침	현재 장치 목록 재검색
연결 / 연결 해제	선택한 통신 경로 열기 또는 현재 연결 닫기

초기 통신 속도는 115200 bps입니다. 실제 장비와 속도·ID를 일치시키고 연결을 누릅니다. 이미 연결된 상태라면 먼저 연결 해제한 후 포트나 설정을 바꿔 다시 연결합니다.

실제 포트가 열렸다는 표시만으로 장비 응답까지 확인된 것은 아닙니다. 파라미터 읽기가 정상 처리되고 상태값이 갱신되는지 확인합니다. 장치 주소를 자동으로 탐색하는 기능은 없습니다.

일반 도구 모음 우측 버튼은 미연결 상태에서 시뮬레이터 연결을 실행합니다. 실제 장비 연결은 통신 설정을 사용합니다.

현재 구현에서는 시뮬레이터 연결을 해제한 뒤에도 상단의 시뮬레이터 표기가 남을 수 있습니다. 연결 여부는 우측 버튼과 하단 통신: 연결 해제 표시를 함께 확인하십시오.

5. 시운전

화면은 속도 조그, 위치 이동, 자동 왕복 운전(드라이브 제어) 영역으로 구성됩니다. 속도는 rpm, 가속도·감속도는 rps/s, 위치 목표는 엔코더 카운트 단위로 입력합니다. 아래 그림의 수치는 화면 초기 입력 예시이며, 실제 장비에 권장하는 운전값이 아닙니다.

5.1 속도 조그

1. 조그 속도, 조그 가속도, 조그 감속도를 입력합니다.

2. 속도 조그 영역의 서보 버튼을 눌러 운전 허가를 켭니다.

3. 역회전 유지(←) 또는 정회전 유지(→) 버튼을 누르고 있는 동안 조그 명령이 전송됩니다.

4. 버튼에서 손을 떼면 속도 0 명령을 전송합니다.

5. 연속 운전을 체크하면 설정한 양의 속도 명령이 유지되고, 해제하면 속도 0을 지령합니다.

다른 화면으로 이동할 때 누름 상태의 조그는 정지 처리됩니다. 연속 운전과 자동 왕복을 종료할 때는 해당 운전 선택을 해제하거나 정지 명령을 사용하십시오.

5.2 위치 이동과 반복

1. 이동 속도, 가속도, 감속도를 입력합니다.

2. 좌우 화살표 아래 목표 위치를 입력합니다.

3. 위치 이동 영역의 서보 버튼을 켭니다.

4. 왼쪽 또는 오른쪽 화살표를 누르면 해당 목표 위치로 이동 명령을 보냅니다.

5. 왕복하려면 남은 횟수, **대기시간(ms)**를 설정하고 반복 이동을 체크합니다.

6. 진행 중 완료 횟수와 남은 횟수를 확인합니다. 반복 이동을 해제하면 반복을 취소하고 서보를 끕니다.

5.3 자동 왕복 운전

왕복 운전 기준에서 위치 기준, 속도 기준, 시간 기준 또는 프로파일 위치 왕복을 선택합니다. 0: 사용 안 함 상태에서는 실행할 수 없습니다. 상·하한값, 속도, 가속도·감속도와 정지 대기시간을 지정한 뒤 해당 영역의 서보와 **운전/정지(▶)**를 사용합니다. 다시 운전/정지를 누르면 드라이브 자동 운전을 해제합니다.

이 기능은 드라이브 내부의 자동 운전 파라미터를 설정합니다. 우측 반복 이동의 앱 제어 왕복과 구분하여 사용합니다.

하단 정지는 통신을 통한 서보 비활성화 명령입니다. 물리 비상정지 장치를 대신하지 않습니다. 운전을 종료한 뒤 연결을 해제하십시오.

6. 디지털 입출력

1. 좌측 디지털 입출력을 선택합니다.

2. 대상 채널의 할당 기능에서 기능을 선택합니다.

3. 접점 논리에서 a접점(NO) 또는 b접점(NC)을 선택합니다.

4. 신호 모의 입력 버튼으로 해당 채널의 모의 입력 비트를 전환합니다.

기능·접점 선택과 모의 입력 버튼은 연결 상태에서 쓰기 명령을 보냅니다. 실제 장비에서의 모의 입력은 드라이브에 쓰는 기능이므로, 장비 없이 연습하려면 통신 경로를 시뮬레이터로 선택합니다.

현재 사전 기준 쓰기 범위는 Servo·BLDC: DIN1~8 / OUT1~8, Wheel: DIN1~3 / OUT1~2입니다. 범위를 벗어난 채널의 콤보박스와 모의 신호 버튼은 비활성화됩니다. 입력·출력 기능 선택지도 제품별 사전을 따릅니다. 극성·모의 신호·물리/유효 신호는 각 제품의 해당 객체 주소로 처리합니다. 특히 Wheel의 출력 극성·모의 신호 주소는 Servo·BLDC와 다릅니다. 시뮬레이터 표시등은 모의 신호로 갱신되며 실제 장비 측정값이 아닙니다.

7. 파라미터

7.1 조회와 검색

1. 좌측 파라미터를 선택합니다.

2. 내부 그룹 목록에서 기본 운전, 위치 제어, 속도 제어, 모터 설정 등 원하는 그룹을 선택합니다.

3. 검색란에 인덱스·서브인덱스 조합 또는 한국어·영어 이름 일부를 입력합니다. 예: 606C, 606C00, 속도.

4. 읽기를 누르면 현재 그룹과 검색 조건으로 표시된 항목 중 읽기 권한이 있는 지원 숫자형 객체를 순서대로 읽습니다.

5. 행을 선택하면 아래쪽에 용도·기술 설명이 나타납니다.

표에는 인덱스, 서브인덱스, 자료형, 이름, 접근 권한, 설정값, 읽은 값이 표시됩니다. 통신이 연결되어 있고 접근 권한에 W가 포함된 8/16/32비트 숫자형 객체만 편집할 수 있습니다. 편집창에서는 객체의 정수 원시값을 입력하며, 별도 공학 단위 변환 입력창은 아닙니다.

7.2 값 변경

1. 쓰기 가능한 행의 **설정값(✎)**을 누르거나 행을 두 번 클릭합니다.

2. 설명·자료형·허용 범위를 확인합니다.

3. 10진수 또는 0x로 시작하는 16진수를 입력합니다.

4. 적용을 누르면 즉시 쓰기를 요청합니다. 취소는 변경 없이 닫습니다.

5. 필요하면 다시 읽기하여 값을 확인합니다.

현재 쓰기는 8/16/32비트 숫자형 객체를 지원합니다. 읽기 전용, 지원하지 않는 자료형, 허용 범위를 벗어난 입력은 오류로 처리됩니다. 전원을 껐다 켜도 유지할 설정은 별도의 드라이브 저장 명령이 필요합니다.

7.3 사용자 그룹

사용자 그룹 만들기로 Custom 1 등의 그룹을 생성한 뒤 객체 추가에서 객체를 검색·선택합니다. 사용자 그룹에서 삭제를 누르면 선택된 객체가 해당 그룹에서 제거되며, 선택된 객체가 그룹에 없으면 그룹 자체를 삭제합니다. 이는 앱의 그룹 구성 변경이며 드라이브의 객체를 삭제하지 않습니다. 사용자 그룹은 프로젝트 파일로 보관합니다.

8. 객체 사전

선택 제품의 전체 객체를 검색하고 설명·형식·접근 권한을 확인합니다. 검색 방식은 파라미터 화면과 같으며, 읽기는 현재 검색 결과 전체를 대상으로 합니다. 객체 사전 화면에는 설정값 편집 기능이 없으므로 변경하려면 파라미터 화면의 기본 그룹 또는 사용자 그룹을 사용합니다.

문자열 객체도 사전에 표시됩니다. 일괄 읽기는 읽기 권한이 있는 8/16/32비트 숫자형 객체만 대상으로 하며, 문자열·지원하지 않는 형식·읽기 권한이 없는 항목은 자동 제외합니다. 해당 항목의 읽은 값은 —로 표시됩니다.

9. 원점복귀 설정

1. 원점 검출 신호, 방향 전환 기준, 최초 탐색 방향, 원점 확정 위치, 리미트 스위치 사용을 선택합니다.

2. 선택 조합에 따라 바뀌는 동작 그림과 아래 설명을 확인합니다. 적용할 수 없는 선택 항목은 비활성화됩니다.

3. 설정할 방식 번호를 확인하고 방식 적용을 누릅니다. 이 명령은 원점복귀 방식 객체 6098:00을 씁니다.

4. 원점 오프셋, 스위치·저속 탐색 속도, 가속도, 전류와 오프셋 적용 방식을 필요에 맞게 설정합니다.

5. 전원 투입 시 원점복귀는 연결된 드라이브의 해당 설정을 변경합니다.

한국어·영어 각각 34개 원점복귀 선택 조합을 제공합니다. 방식 선택만 바꾸는 동작과 방식 적용을 구분하십시오. 부가 숫자 입력은 값을 입력한 뒤 Enter를 눌러 쓰기를 요청합니다. 다른 칸을 클릭하는 것만으로는 전송되지 않습니다. 오프셋 적용 방식과 전원 투입 시 원점복귀는 선택·체크 변경 시 해당 파라미터 쓰기를 요청합니다.

현재 화면은 원점복귀 조건 설정용이며 수동 원점복귀 시작 버튼은 제공하지 않습니다. 방식 적용을 원점복귀 운전 시작으로 해석하지 마십시오. 드라이브 방식 번호는 앱에 읽어 둔 6098:00 값이며, —이면 파라미터 화면에서 해당 객체를 읽어 확인합니다.

10. 파형 모니터

10.1 수집과 표시

1. 연결 후 파형 모니터로 이동합니다.

2. CH1~CH4에서 수집 객체를 선택합니다. 기본값은 속도 피드백, 위치 피드백, q축 전류 피드백, 목표 속도입니다.

3. 채널별 숨김, 배율, 세로 이동으로 표시를 조정합니다. > 버튼은 객체 선택창을 엽니다.

4. 샘플 수를 지정하고 수집 시작을 누릅니다. 실제 수집 목표는 10~1000개 범위로 제한됩니다.

5. 목표 수에 도달하면 자동 종료되며, 중간에는 상단 정지로 수집을 멈춥니다. 이 버튼은 모터 정지 버튼이 아닙니다.

6. 현재 데이터 갱신은 드라이브 모니터링 버퍼를 표시 데이터로 다시 가져옵니다.

수집 시작은 기존 파형 버퍼를 비웁니다. 연결 중에는 수집 버튼을 누르기 전에도 모니터링 버퍼의 값이 보일 수 있습니다. 현재 캡처 그림은 모터를 움직이지 않은 시뮬레이터의 정지 상태 값입니다.

측정 커서 X1/X2를 체크하고 그래프를 클릭하면 시간 위치를 표시할 수 있습니다. 현재 두 X 선택은 하나의 세로 커서를 공유합니다. Y1/Y2 선택 UI는 있으나 독립적인 Y 커서·두 지점 차이 측정은 구현되지 않았습니다.

10.2 파일과 수집 제한

버튼	동작
복사	파형 파일 형식의 텍스트를 클립보드에 복사
불러오기	.wave 파형 데이터 불러오기
내보내기	기본 파일명 capture.wave로 저장

수집 조건은 우측 채널 설정 영역을 아래로 스크롤하면 확인할 수 있습니다. 현재 데이터는 UART 폴링 기반입니다. 화면의 샘플 주기·트리거 이전 샘플·트리거 기준값·상승/하강 에지 설정으로 원본의 고속 트리거 수집이 실행되지는 않습니다. 원본 드라이브의 62.5 µs 하드웨어 버퍼 수집은 미구현입니다. 샘플 주기 입력을 바꿔도 실제 폴링 주기가 그 값으로 바뀌지 않습니다. 시뮬레이터 갱신은 약 50 ms, 실제 통신 모니터링 타이머는 약 250 ms이며 통신 지연의 영향을 받습니다.

11. 알람 진단

1. 알람 진단에서 상단 현재 알람 코드를 확인합니다.

2. 검색란에 코드나 알람 내용 일부를 입력합니다.

3. 목록에서 알람을 선택하면 원인/조치 탭에 설명이 표시됩니다.

4. 알람 이력 탭에서 현재 앱 세션이 수집한 이력을 확인합니다.

5. 알람 코드 탭에서 통신 로그를 확인합니다.

6. 원인을 조치한 뒤 연결 상태에서 알람 해제를 누릅니다.

사전의 해제 가능 표시는 해당 오류에 대한 사전 정보입니다. 해제 명령이 전송되어도 원인이 남아 있으면 알람이 다시 발생할 수 있습니다. 목록 선택은 사전 내용을 조회하는 동작이므로 실제 현재 알람 코드를 바꾸지 않습니다. 이력·로그는 장비의 영구 오류 기록 전체를 읽어 온 결과가 아닙니다.

12. 파라미터 전송

12.1 파일의 값을 드라이브에 쓰기

1. 파라미터 전송 → 드라이브에 쓰기 탭을 선택합니다.

2. 파일 열기로 .iparam 파일을 불러옵니다.

3. 객체 목록과 제품 종류를 확인합니다. 파일에서 유효 표시가 False인 항목, 현재 제품 사전에 없는 객체, 쓰기 권한이 없는 객체와 지원하지 않는 자료형은 제외됩니다.

4. 연결 후 드라이브에 쓰기를 눌러 불러온 값을 순서대로 적용합니다. 읽기 전용 항목은 건너뜁니다.

5. 필요한 값을 읽어 확인한 뒤 비휘발성 메모리에 저장으로 드라이브 저장 명령을 보냅니다.

이 탭에서 설정값(✎)을 편집하면 해당 값은 즉시 쓰기 요청됩니다. 일괄 드라이브에 쓰기는 파일에서 불러온 값 목록을 사용하므로, 편집한 셀을 나중에 다시 일괄 전송할 값으로 간주하지 마십시오. 처리 완료 개수에는 건너뛴 항목도 포함될 수 있습니다.

12.2 드라이브의 값을 파일로 백업

1. 드라이브에서 읽기 탭으로 이동합니다.

2. 읽기 목록 열기에서 .oparam 파일을 선택합니다.

3. 연결 후 드라이브에서 읽기를 누릅니다.

4. 정상적으로 읽힌 값들을 확인합니다.

5. 파일 저장으로 parameters.iparam을 저장합니다.

두 탭은 객체 목록을 공유합니다. 처음 보이는 목록은 사전 앞쪽 30개 객체이며 전송용 파일을 불러온 목록이 아닙니다. 작업에 맞는 .oparam 또는 .iparam을 먼저 여십시오. 일괄 읽기·쓰기는 중간에 오류가 발생하면 중단되며, 앞서 성공한 작업을 자동으로 되돌리지 않습니다. 읽지 않은 항목을 저장하면 0 등이 포함될 수 있으므로 완료 여부를 확인해야 합니다.

13. 펌웨어 업데이트

현재 구현은 파일 전송 절차를 제공하며 시뮬레이터 전송은 지원하지 않습니다. 이번 매뉴얼 작성에서는 화면만 확인했고 실제 장비 전송은 수행하지 않았습니다.

1. 대상 장비에 맞는 펌웨어 파일을 준비하고 펌웨어 파일 열기로 선택합니다. 펌웨어는 프로젝트에 포함되어 있지 않습니다.

2. 표시된 파일명과 바이트 수를 확인합니다. 빈 파일이나 지원하지 않는 파일명은 거부됩니다. 파일명은 ASCII 문자로 준비합니다.

3. 통신 설정에서 실제 포트와 통신 속도를 지정하여 연결합니다.

4. 펌웨어 전송을 누릅니다. 앱은 일반 통신을 해제하고 같은 포트를 펌웨어 전송용으로 엽니다.

5. 진행률과 처리 내역을 확인합니다. 필요하면 취소를 누릅니다.

6. 완료 또는 오류 후 일반 통신은 자동 복구되지 않으므로 다시 연결하여 장비 상태를 확인합니다.

표시 상태는 부트로더 진입 → 파일 정보 전송 → 펌웨어 전송 중 → 전송 마무리 → 드라이브 재시작 → 전송 완료 · 설치 미확인 순서입니다. 오류나 취소 시에는 별도 상태가 표시됩니다.

진행률 100%와 전송 완료 · 설치 미확인은 설치·기동·모델 호환성을 보증하지 않습니다. 앱은 파일과 장비의 호환성을 자동 판별하지 않습니다. 취소·실패 후에는 장비가 부트로더 상태에 남을 수 있으며, 자동 재부팅이나 복구를 보장하지 않습니다.

14. 파일 형식과 저장의 차이

확장자	용도	사용하는 화면
.prj	제품 종류, 기본·사용자 그룹과 앱에 보유한 값 보관	프로젝트 열기·저장
.oparam	읽을 객체의 매핑 목록	파라미터 전송 → 드라이브에서 읽기
.iparam	객체 매핑, 값, 유효 여부를 가진 전송·백업 파일	파라미터 전송의 읽기 결과 저장·쓰기 파일 열기
.wave	4채널 파형과 수집 메타데이터	파형 모니터

확장자만 바꾸면 서로 변환되는 형식이 아닙니다. 파일 대화상자가 열리더라도 해당 기능이 요구하는 내용 형식과 일치해야 합니다.

명령	저장 또는 적용 대상
프로젝트 저장	PC의 .prj 파일
파라미터 전송 → 파일 저장	PC의 .iparam 파일
파형 내보내기	PC의 .wave 파일
설정값 적용 / 드라이브에 쓰기	연결된 장비의 객체값 또는 시뮬레이터의 로컬 값
제어값 저장 / 제어 파라미터 저장	드라이브 제어 파라미터 저장 명령
모터값 저장 / 모터 파라미터 저장	드라이브 모터 파라미터 저장 명령
비휘발성 메모리에 저장	드라이브 전체 파라미터 저장 명령
제어 파라미터 초기화	드라이브 제어 파라미터 초기화 명령
드라이브 재시작	드라이브 재부팅 명령

드라이브 명령은 연결 상태에서 사용합니다. 현재 UI는 저장·초기화·재시작에 추가 확인창을 제공하지 않습니다. 메뉴를 선택하면 명령을 요청하므로, 초기화 전에 필요한 값을 파일로 보관하십시오. 성공 메시지는 명령 전송 결과를 뜻하며 장비의 비휘발성 저장 완료나 재기동 완료까지 확인한 결과는 아닙니다.

15. 문제 해결과 현재 제한

15.1 문제 해결

현상	확인 및 조치
통신이 연결되지 않았다는 오류	시뮬레이터 연결 또는 통신 설정에서 실제 포트 연결 후 다시 시도합니다.
실제 포트가 목록에 없음	장치 연결·운영체제 드라이버·포트 접근 권한을 확인하고 포트 새로고침을 누릅니다.
포트는 열렸지만 값이 갱신되지 않음	속도·ID·장비 전원·배선을 확인합니다. 연결 표시와 장비 응답 성공은 별개입니다.
읽기 도중 타임아웃 또는 통신 오류	최근 오류 메시지와 알람 진단의 통신 로그를 확인합니다. 대상 객체를 좁혀 다시 읽습니다.
문자열 객체에 값이 표시되지 않음	문자열·지원하지 않는 숫자형·읽기 권한 없는 객체는 일괄 읽기에서 제외됩니다.
값 변경이 거부됨	연결, 접근 권한의 W, 8/16/32비트 숫자형 여부, 정수 형식과 허용 범위를 확인합니다.
변환 객체 누락·0 나눗셈 등 단위 변환 오류	제품을 확인하고 엔코더 분해능·기어비 등 참조 객체값을 읽어 확인합니다.
객체 추가를 할 수 없음	사용자 그룹을 먼저 만들거나 선택합니다.
자동 왕복을 시작할 수 없음	사용 안 함 이외의 왕복 기준을 선택하고 서보 허가·설정값을 확인합니다.
IO 채널이나 운전·저장 버튼이 비활성화됨	선택 제품의 지원 객체·읽기/쓰기 권한을 확인하고 필요한 통신 연결·운전 허가 조건을 충족합니다. Wheel은 DIN1~3 / OUT1~2가 사전 기준 범위입니다.
파형이 일정하거나 0으로 보임	시뮬레이터/실제 연결 상태와 수집 객체를 확인합니다. 정지 상태라면 일정한 파형이 정상일 수 있습니다.
파일 열기 형식 오류	사용한 기능과 확장자·파일 내용이 맞는지 확인합니다.
파일을 저장했는데 재연결 후 값이 다름	PC 파일 저장과 장비 내부 저장을 구분합니다. 시뮬레이터 재연결은 값을 초기화합니다.
펌웨어 전송 버튼이 비활성화됨	펌웨어 파일을 먼저 선택합니다.
펌웨어에서 실제 포트를 선택하라는 오류	시뮬레이터 대신 실제 시리얼 포트를 통신 설정에서 지정합니다.
알람이 다시 발생함	알람 해제만 반복하지 말고 사전에 표시된 원인·조치와 실제 장비 상태를 확인합니다.

15.2 현재 지원 범위

항목	현재 상태
파일 저장 위치 선택	macOS·Windows·Linux 지원, Web 다운로드
파라미터 쓰기	8/16/32비트 숫자형; 범위·접근 권한 검사
고속 하드웨어 파형·트리거	미구현; 현재 UART 폴링 데이터 표시
독립 커서·IO 실측 표시	일부 화면 요소의 의미와 구현 범위에 제한 있음; 해당 절 참고
원점복귀 수동 시작	현재 설정 화면에 시작 버튼 없음
펌웨어	전송 기능 구현; 설치·기동·제품 호환성 자동 확인 없음

한국어·영어의 9개 화면·정보 창, 추출된 21개 폼의 표시 문구와 좁은 창의 입력 높이·통신 설정 유지 동작을 검사합니다. macOS 배포 앱과 캡처 20장은 보존했습니다.

16. 참고 문서와 캡처 목록

파일명	화면
01_main_offline.jpg	연결 해제 상태의 시작 화면
02_project_setup.jpg	프로젝트 제품 선택
03_connection_settings.jpg	통신 설정
04_commissioning_simulator.jpg	시뮬레이터 시운전
05_digital_io.jpg	디지털 입출력
06_parameters.jpg	파라미터
07_parameter_edit.jpg	파라미터 편집
08_object_dictionary.jpg	객체 사전
09_homing_setup.jpg	원점복귀 설정
10_waveform_monitor.jpg	파형 모니터
11_alarm_diagnostics.jpg	알람 원인·조치
12_parameter_transfer_write.jpg	파라미터 쓰기 탭
13_parameter_transfer_read.jpg	파라미터 읽기 탭
14_firmware_update.jpg	펌웨어 업데이트
15_drive_menu.jpg	드라이브 저장·초기화·재시작 메뉴
16_about_bcbtuner.jpg	BCBTuner 아이콘과 프로그램 정보
17_main_english.jpg	영어 시작 화면의 BCBTuner 이름
18_about_english.jpg	영어 프로그램 정보의 BCBTuner 이름
19_wheel_io.jpg	Wheel 지원 채널과 미지원 채널 비활성화
20_wheel_driver_menu.jpg	Wheel 제어 초기화 비활성화