Open Duck Mini v2 제작 가이드 | 부품부터 첫 보행까지

Open Duck Mini v2 · STS3215 · 14 DOF. 끝까지 맞는 하드웨어와 런타임을 사용하세요. 서로 다른 프로젝트의 배선, 펌웨어, 보정값을 그대로 옮기지 마세요.

Done 표시 뒤에도 저장한 파일을 확인하세요

아래 14관절 ID·배선 점검에 이어 표준 v2 Runtime의 설정, 오프셋과 종료 절차를 보완합니다. 새 이미지나 사이트의 실기 검증이 아닙니다. STS3215 설정은 KISS HD1910·XL330과 구분합니다.

설치 경로와 실제 설정 파일 확인

수동 설치 README와 docs/INSTALL.md는 출발점이 다릅니다. 후자는 발 스위치로 자동 시작하는 서비스가 있는 이미지 설명이며 수동 설치에 그 서비스가 생기는 것은 아닙니다. 확인한 V2-Classic 릴리스 메타데이터에는 다운로드 첨부가 없어 설치 가능한 ISO는 검증하지 않았습니다. 자동 시작 이미지를 쓰면 현재 동작 세션을 먼저 확인하고 끝낸 뒤 보정합니다.

DuckConfig는 홈의 duck_config.json을 기본으로 읽고 보행 CLI는 --duck_config_path도 지원합니다. 기존 파일을 새 이름으로 백업하세요. example_config.json은 처음 만들 때만 쓰고 기존 보정을 덮어쓰지 않습니다. 아래 표준 라이브러리 명령은 하드웨어 코드를 가져오지 않고 JSON 문법만 확인합니다. 방향이나 모터 상태를 검증하지 않습니다.

python -m json.tool "$HOME/duck_config.json"

움직이기 전 전체 설정과 백업 준비

JSON 필드명확히 할 조건
start_paused예제 기본은 false입니다. 첫 정책 점검은 true로 설정하되 지지·시작·전원 점검을 별도로 합니다.
imu_upside_down실제 IMU 장착과 축 읽기에 맞추며 예제 값을 보정 결과로 쓰지 않습니다.
joints_offsets원래 14관절 이름을 모두 유지합니다. 로더는 일부 사전을 기본값과 합치지 않으므로 한 관절 수정이 다른 항목을 지우면 안 됩니다.
Open Duck Mini v2 원작자의 미조립 서보와 정렬된 혼 사진. 개별 오프셋 측정 전 조립 참고용.
원작자의 서보 혼 정렬 사진 · Antoine Pirrone 및 기여자 · Apache 2.0. 조립 참고이며 사이트의 보정·보행 시험이 아닙니다.

관절별 측정 후 확인된 값을 직접 저장

기체를 지지하고 영점 자세 공간을 확보합니다. Runtime/scripts의 find_soft_offsets.py는 저장된 보정 대신 모든 오프셋이 0인 임시 설정을 만듭니다. 보호된 관절별 루프에 들어가기 전 이미 모터를 켜고 영점을 명령하므로 읽기 전용 도구가 아닙니다. 앞 단계 조립 점검을 끝낸 뒤 진행합니다.

python find_soft_offsets.py

관절별 값과 확인 여부를 기록합니다. 스크립트는 값을 출력하고 duck_config.json에 직접 복사하라고 안내하며 JSON과 EEPROM을 쓰지 않습니다. 건너뛴 관절은 미측정이며 임시 사전에 0으로 남을 수 있습니다. 확인된 값만 본인의 완전한 14관절 joints_offsets에 합치고 다른 항목과 재측정하지 않은 기록을 보존합니다.

종료 상태와 파일 다시 읽기

고정 버전은 정상 Done 뒤 turn_off를 호출하지 않습니다. KeyboardInterrupt 처리는 관절 루프만 감싸고 모든 시작 동작을 감싸지 않으므로 어느 순간이나 Ctrl+C가 토크를 끈다고 보장할 수 없습니다. 전원 차단 접근을 유지하고 정지 상태를 확인한 뒤 만지세요. 저장 파일을 다시 읽고, 초기화된 Python 객체는 자동 재로딩하지 않음을 확인합니다. start_paused도 하드웨어 시작 뒤 정책을 멈출 뿐 모터를 끄지 않습니다.

백업·사용 파일 경로, Runtime 버전, 14관절 상태, 확인한 값, 수동 저장, 파일 재읽기, 정지를 기록합니다. 미측정·누락·건너뜀은 보류이며 터미널 메시지가 실기 보정 완료를 뜻하지 않습니다.

고정 버전 설정·보정 출처

2026년 11월 4일 Runtime376de654·설계b23317a4 문서, 구현 및 원본 사진을 대조했습니다. 이미지 부팅, 모터 동작, 보정, EEPROM 쓰기나 보행 시험은 하지 않았습니다. 11월 3일 ID 표와 고정 날짜 ZIP은 아래에 유지합니다.

전체 버스를 연결하기 전 14관절을 확인하세요

기존 제작 안내에 빠져 있던 관절별 번호와 설정 중단 지점을 원본 v2 문서 및 Runtime으로 보완했습니다. 새 로봇이나 이미지 발표가 아닙니다. STS3215 경로는 KISS HD1910·XL330과 구분하며 원본 배선도는 홈페이지에서도 연결됩니다.

버스 ID원본 관절 이름
10right_hip_yaw
11right_hip_roll
12right_hip_pitch
13right_knee
14right_ankle
20left_hip_yaw
21left_hip_roll
22left_hip_pitch
23left_knee
24left_ankle
30neck_pitch
31head_pitch
32head_yaw
33head_roll

라벨 부착을 위해 오른쪽 다리·왼쪽 다리·머리와 목 순서로 묶었습니다. Runtime 배열은 왼쪽 다리→목과 머리→오른쪽 다리입니다. 숫자 정렬을 정책 벡터 순서로 쓰지 마세요. 표준 14관절에는 입 ID 34가 없습니다.

Open Duck Mini v2 원본 도면의 배터리 보호, 서보 전원, Pi용 UBEC, 모터 버스 및 발바닥 스위치.
Open Duck Mini v2 원본 배선도 · Antoine Pirrone 및 기여자 · Apache 2.0. 출처 자료이며 이 사이트의 실기 테스트가 아닙니다.

원본 상세 배선도 열기 ↗

설정 결과와 실패 지점을 남기는 순서

  1. 배터리를 분리하고 원본 도면에서 BMS·스위치, 서보 전원, UBEC의 Pi 전원 경로를 확인합니다. Pi 물리 핀 번호와 GPIO 번호는 다릅니다. 커넥터 핀 순서는 상세 도면으로 확인하고 개요도만으로 배터리 보호를 우회하지 않습니다.

  2. 맞는 v2 Runtime을 설치한 뒤 해당 scripts 디렉터리로 이동합니다. 미조립 서보 하나만 호환 전원·어댑터에 연결하고 축 주변을 비웁니다. configure_motor.py는 ID 1부터 확인하고 없으면 작은 번호부터 탐색해 첫 응답에서 멈춥니다. 전체 버스 목록 도구가 아닙니다.

  3. 아래 예시는 left_hip_yaw를 20으로 설정합니다. 실제 어댑터 포트와 표의 ID로 바꾸세요. /dev/ttyACM0는 기본값입니다. 스크립트는 모드·가속도·PID·ID를 쓰고 영점 목표를 보내므로 읽기 전용이 아닙니다.

    python configure_motor.py --port /dev/ttyACM0 --id 20
  4. 이전·새 ID와 출력된 매개변수를 기록하고 라벨을 붙인 다음 다른 서보로 넘어갑니다. 영점 동작 뒤 원본 사진에 맞춰 혼을 설치합니다. 인코더 영점과 조립 오프셋은 다르며 한 개 성공이 14개 통신 통과를 뜻하지 않습니다.

  5. 고정 버전 HWI는 1,000,000 baud로 엽니다. configure_motor.py는 통신 속도를 설정하지 않습니다. 이전 속도 변경을 재번호 설정으로 고친다고 가정하지 말고 응답 없는 서보를 분리해 포트·어댑터·전원·설정을 확인합니다.

  6. 배선과 라벨이 맞으면 기체를 지지하고 기존 모터 점검 단계로 진행합니다. check_motors.py는 위치를 읽기 전에 게인을 쓰고 이후 움직일 수 있습니다. 응답 없는 관절이 있으면 계속 진행을 거절하고 원인부터 해결합니다.

14관절의 위치·ID·혼 정렬·포트·통신 결과·개별 오프셋을 기록합니다. 누락이나 중복이 해결되기 전 HOME 또는 정책 동작으로 넘어가지 않습니다.

고정 버전 문서와 구현

2026년 11월 3일 설계 b23317a4·Runtime 376de654를 확인했습니다. 서보·배선·전원·보정·보행 실험은 하지 않았습니다. 9월 9일 다운로드는 당시 날짜를 유지하며 이번 내용은 온라인 점검 보충입니다.

첫 통전 조립 시험 전에 확인할 세 단계

b23317a의 표준 Open Duck Mini v2용이며 원본 설명서와 함께 사용하세요. 사진과 CAD는 원작자 자료이고 이 사이트의 실물 조립 기록이 아닙니다.

1. 서보 ID와 혼 방향

준비: 조립 전 서보 한 개·전원·버스 어댑터·대응 configure_motors 문서. 설정은 ID를 기록하고 서보를 영점으로 움직입니다.

서보 혼 정렬 실물 사진 · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료
서보 혼 정렬 실물 사진 · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료 ↗

확인 순서

  1. 한 개씩 설정하고 움직일 공간을 확보하세요. 영점 이동 후 원본 사진에 맞춰 혼을 장착합니다.
  2. 왼쪽 다리 20–24, 오른쪽 10–14, 목 30, 머리 31–33을 표시하고 원본 관절명 대응을 보관하세요.
  3. 외장을 닫기 전에 ID·혼 정렬·추후 보정 오프셋을 기록하세요.

다음 단계로 갈 조건: 14개 관절의 고유 ID 기록이 있고 혼 방향을 원본 사진과 대조할 수 있어야 합니다.

일치하지 않을 때: HD1910 zero/limits 명령을 가져오지 말고 선택한 서보의 원본 설정 절차로 돌아가세요.

체크리스트 복사
1. 서보 ID와 혼 방향
1. 서보 ID와 혼 방향
준비: 조립 전 서보 한 개·전원·버스 어댑터·대응 configure_motors 문서. 설정은 ID를 기록하고 서보를 영점으로 움직입니다.
□ 한 개씩 설정하고 움직일 공간을 확보하세요. 영점 이동 후 원본 사진에 맞춰 혼을 장착합니다.
□ 왼쪽 다리 20–24, 오른쪽 10–14, 목 30, 머리 31–33을 표시하고 원본 관절명 대응을 보관하세요.
□ 외장을 닫기 전에 ID·혼 정렬·추후 보정 오프셋을 기록하세요.
다음 단계로 갈 조건: 14개 관절의 고유 ID 기록이 있고 혼 방향을 원본 사진과 대조할 수 있어야 합니다.
일치하지 않을 때: HD1910 zero/limits 명령을 가져오지 말고 선택한 서보의 원본 설정 절차로 돌아가세요.

2. 좌우 다리 조립

준비: 다리 출력 부품·ID가 붙은 서보·발부터 고관절까지의 원본 조립도.

양쪽 다리 조립 CAD · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료
양쪽 다리 조립 CAD · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료 ↗

확인 순서

  1. 양쪽 발은 같은 구조입니다. 모터 드라이버 쪽과 foot_top의 위치를 원본과 대조하세요.
  2. 고관절의 left_roll_to_pitch와 right_roll_to_pitch를 구별하고 ID가 해당 다리를 따라가게 하세요.
  3. 몸통에 고정하기 전에 hip_pitch 방향·케이블 경로·동작 공간을 확인하세요.

다음 단계로 갈 조건: 양쪽 다리가 원본 CAD와 맞고 ID를 읽을 수 있으며 케이블이 끼이지 않아야 합니다.

일치하지 않을 때: 해당 공정의 원본 도면으로 돌아가세요. 좌우 반전 이미지로 ID나 방향을 판단하지 않습니다.

체크리스트 복사
2. 좌우 다리 조립
2. 좌우 다리 조립
준비: 다리 출력 부품·ID가 붙은 서보·발부터 고관절까지의 원본 조립도.
□ 양쪽 발은 같은 구조입니다. 모터 드라이버 쪽과 foot_top의 위치를 원본과 대조하세요.
□ 고관절의 left_roll_to_pitch와 right_roll_to_pitch를 구별하고 ID가 해당 다리를 따라가게 하세요.
□ 몸통에 고정하기 전에 hip_pitch 방향·케이블 경로·동작 공간을 확인하세요.
다음 단계로 갈 조건: 양쪽 다리가 원본 CAD와 맞고 ID를 읽을 수 있으며 케이블이 끼이지 않아야 합니다.
일치하지 않을 때: 해당 공정의 원본 도면으로 돌아가세요. 좌우 반전 이미지로 ID나 방향을 판단하지 않습니다.

3. 전원·버스·IMU 배선

준비: 배터리를 분리하고 전체·상세 배선도와 Runtime 설정을 준비하세요.

전원·모듈 배선도 · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료
전원·모듈 배선도 · Antoine Pirrone · Open Duck Mini v2 · Apache 2.0 · 원본 참고 자료 ↗

확인 순서

  1. 원본을 따라 배터리·BMS·서보 전원의 극성과 핀 번호를 확인하세요.
  2. Pi는 별도로 조정된 5 V로 공급합니다. 배터리 전압을 Pi 5 V 핀에 직접 연결하지 않습니다.
  3. IMU 장착과 설정 방향을 대조하고 전원을 끊는 방법을 확인한 뒤 보정으로 진행하세요.

다음 단계로 갈 조건: 전원 분리 상태의 배선이 두 원본 도면 및 대응 설정과 일치해야 합니다.

일치하지 않을 때: 차이를 알 때까지 전원을 연결하지 마세요. 재시작 진단을 위해 배터리 보호를 우회하지 않습니다.

체크리스트 복사
3. 전원·버스·IMU 배선
3. 전원·버스·IMU 배선
준비: 배터리를 분리하고 전체·상세 배선도와 Runtime 설정을 준비하세요.
□ 원본을 따라 배터리·BMS·서보 전원의 극성과 핀 번호를 확인하세요.
□ Pi는 별도로 조정된 5 V로 공급합니다. 배터리 전압을 Pi 5 V 핀에 직접 연결하지 않습니다.
□ IMU 장착과 설정 방향을 대조하고 전원을 끊는 방법을 확인한 뒤 보정으로 진행하세요.
다음 단계로 갈 조건: 전원 분리 상태의 배선이 두 원본 도면 및 대응 설정과 일치해야 합니다.
일치하지 않을 때: 차이를 알 때까지 전원을 연결하지 마세요. 재시작 진단을 위해 배터리 보호를 우회하지 않습니다.

원본 조립·보정 단계로 계속 ↗

전체 출력 목록: 36종, 총 51개

원문은 PLA 채움 15%를 지정하며 foot_bottom_tpu.stl만 TPU 40%입니다. 층 높이, 벽 수, 지지대, 배치 방향, 온도는 전체 부품에 대해 지정하지 않았습니다. 발과 하중을 받는 연결 부품을 먼저 출력하여 결합을 확인한 뒤 전체를 출력하세요. 아래 링크는 고정 커밋의 원본 파일입니다.

전체 출력 목록: 36종, 총 51개
원본 STL 파일수량재료 / 채움
foot_top.stl2PLA / 15%
foot_side.stl2PLA / 15%
foot_bottom_pla.stl2PLA / 15%
foot_bottom_tpu.stl2TPU / 40%
knee_to_ankle_left_sheet.stl4PLA / 15%
knee_to_ankle_right_sheet.stl4PLA / 15%
leg_spacer.stl4PLA / 15%
left_roll_to_pitch.stl1PLA / 15%
right_roll_to_pitch.stl1PLA / 15%
roll_motor_bottom.stl2PLA / 15%
roll_motor_top.stl2PLA / 15%
trunk_bottom.stl1PLA / 15%
trunk_top.stl1PLA / 15%
neck_left_sheet.stl1PLA / 15%
neck_right_sheet.stl1PLA / 15%
head_pitch_to_yaw.stl1PLA / 15%
head_yaw_to_roll.stl1PLA / 15%
head_roll_mount.stl1PLA / 15%
head.stl1PLA / 15%
head_bot_sheet.stl1PLA / 15%
left_antenna_holder.stl1PLA / 15%
right_antenna_holder.stl1PLA / 15%
left_cache.stl1PLA / 15%
right_cache.stl1PLA / 15%
body_front.stl1PLA / 15%
body_middle_bottom.stl1PLA / 15%
body_middle_top.stl1PLA / 15%
body_back.stl1PLA / 15%
battery_pack_lid.stl1PLA / 15%
bulb.stl1PLA / 15%
flash_light_module.stl1PLA / 15%
flash_reflector_interface.stl1PLA / 15%
left_eye.stl1PLA / 15%
right_eye.stl1PLA / 15%
speaker_interface.stl1PLA / 15%
speaker_stand.stl1PLA / 15%

1. 하드웨어와 실행 코드 버전 고정

하드웨어 문서는 b23317a, Runtime은 376de65를 확인했습니다. 작업 폴더에 커밋, BOM, 출력 파일과 수정 사항을 함께 보관합니다. MicroDuck용 정책을 섞지 마세요.

2. 원본 부품표를 구매 목록으로

원본 BOM에는 Feetech STS3215 7.4V 서보 14개, Raspberry Pi Zero 2 W와 BNO055 등이 있습니다. 대체품은 전압, 버스, 커넥터와 치수를 확인합니다. 원화 총액을 임의로 정하지 말고 통화, 견적 날짜, 배송비와 세금을 분리해 기록하세요.

3. 출력 수량과 결합 확인

출력 안내는 대부분 PLA·채움 15%, 발바닥은 TPU·40%를 사용합니다. 여러 개 필요한 소형 부품을 빠뜨리지 않도록 수량을 확인하세요. 결합부를 먼저 시험하고 방향, 인서트와 나사 체결을 확인한 뒤 전체를 출력합니다.

4. 서보를 하나씩 연결해 설정

관절 ID는 왼쪽 다리 20–24, 오른쪽 10–14, 목 30, 머리 31–33입니다. 아래 명령은 ID를 기록하고 움직임을 발생시킵니다. 아직 조립하지 않은 서보 한 개를 연결하고 실제 포트와 가동 공간을 확인한 뒤 실행합니다.

복사 가능한 예제
python scripts/configure_motor.py --port /dev/ttyACM0 --id 20

ID뿐 아니라 중앙 위치와 회전 방향을 기록하세요. 버스 검색에 나타나는 것만으로 방향이 맞다고 판단하지 않습니다.

5. 조립과 배선 점검

그림 설명과 저자가 연결한 Tnkr 안내를 따릅니다. 전원을 끄고 극성, 선 순서, 가동 범위와 배선 간섭을 확인합니다. 나사 수량 등 TODO는 미확인 항목으로 남기고, 전원 문제를 해결하려고 배터리 보호를 우회하지 않습니다.

6. OS와 Runtime 설치

Runtime README의 Raspberry Pi OS Lite 64-bit 수동 설치 경로를 우선 확인합니다. 문서가 언급한 0.2.3 이미지는 공개 Release에서 해당 다운로드 첨부를 확인하지 못했습니다. 다음 명령은 소스만 고정하므로 시스템 의존성은 같은 버전 설명을 이어서 적용해야 합니다.

복사 가능한 예제
git clone https://github.com/apirrone/Open_Duck_Mini_Runtime Open_Duck_Mini_Runtime-reviewed
cd Open_Duck_Mini_Runtime-reviewed
git checkout --detach 376de65435c93486347cd601a31aa96951799896

7. 오프셋·IMU·정지 방법 확인

실행 전 체크리스트로 서보, 오프셋, IMU 방향과 발 접촉을 확인합니다. check_motors는 토크를 켜고 움직이므로 읽기 전용 검사가 아닙니다. 예제 설정의 start_paused는 false입니다. 실제 설정을 확인하고 게임패드 A의 일시정지와 전원 차단을 구분하세요.

8. 짧은 동작부터 관찰

보정과 입력 확인을 마친 Runtime 환경의 scripts 폴더에서 README의 BEST_WALK_ONNX_2.onnx를 사용합니다. 아래 경로를 실제 파일로 바꾸고 지지할 수 있는 빈 공간과 전원을 끌 수단을 준비한 뒤 실행합니다.

복사 가능한 예제
python v2_rl_walk_mujoco.py --onnx_model_path /absolute/path/BEST_WALK_ONNX_2.onnx

시작, 자세, 짧은 전진과 정지를 확인하며 기록합니다. 비정상적인 힘, IMU 오류나 전원 문제가 생기면 해당 단계로 돌아갑니다. 실제 입력은 보행 스크립트를 따르며 새 정책 학습은 별도 과정입니다. sim-to-real 자료에도 미완성 부분이 남아 있습니다.

원본 배선도

Open Duck Mini v2 원저자의 전원 및 모듈 배선도
Open Duck Mini v2 원본 도면 · Antoine Pirrone 저장소 · Apache 2.0. Pi는 별도의 5 V 조정기로 전원을 공급합니다. 배터리 전압을 Pi의 5 V 핀에 직접 연결하면 안 됩니다.

상세 배선도 원본 해상도로 보기 ↗

출처와 확인 날짜

자료 확인일 2026년 11월 4일 · 원문 확인

  1. 원문 자료 1 · github.com / README.md ↗
  2. 원문 자료 2 · docs.google.com / edit ↗
  3. 원문 자료 3 · tnkr.ai / open-duck-mini-v2 ↗
  4. 원문 자료 4 · github.com / print_guide.md ↗
  5. 원문 자료 5 · github.com / configure_motors.md ↗
  6. 원문 자료 6 · github.com / configure_motor.py ↗
  7. 원문 자료 7 · github.com / assembly_guide.md ↗
  8. 원문 자료 8 · github.com / README.md ↗
  9. 원문 자료 9 · github.com / INSTALL.md ↗
  10. 원문 자료 10 · github.com / releases ↗
  11. 원문 자료 11 · github.com / example_config.json ↗
  12. 원문 자료 12 · github.com / check_motors.py ↗
  13. 원문 자료 13 · github.com / checklist.md ↗
  14. 원문 자료 14 · github.com / v2_rl_walk_mujoco.py ↗
  15. 원문 자료 15 · github.com / sim2real.md ↗
  16. 원문 자료 16 · github.com / rustypot_position_hwi.py ↗
  17. 원문 자료 17 · github.com / open_duck_mini_v2_wiring_diagram.png ↗
  18. 원문 자료 18 · github.com / wiring.png ↗
  19. 원문 자료 19 · github.com / LICENSE ↗
  20. 원문 자료 20 · github.com / duck_config.py ↗
  21. 원문 자료 21 · github.com / find_soft_offsets.py ↗
  22. 원문 자료 22 · github.com / V2-Classic ↗