Open Source Robotics

고품질 오픈소스 로봇 프로젝트, 도구 및 소프트웨어의 엄선된 컬렉션.

Berkeley Humanoid Lite 조립 가이드

3D 프린팅 기어박스와 완전한 Sim-to-Real 파이프라인을 갖춘 5,000달러 미만 오픈소스 휴머노이드 로봇

라이선스

MIT

조립 가이드

1. 자재와 부품(BOM)

모터, 베어링, ESC, 엔코더, 전자부품, 3D 프린팅 필라멘트 등 전 부품을 준비. 수량과 구매처는 공식 BOM 시트 참조.

1.1 액추에이터 부품 조달

두 액추에이터 타입의 부품을 모두 주문: M6C12(고토크, 10개)와 5010(중토크, 12개).

  1. 공식 BOM 스프레드시트를 열고 세 개의 탭 M6C12 Actuator, 5010 Actuator, Humanoid를 검토합니다. 두 액추에이터 탭에는 액추에이터 한 개에 필요한 부품이 나와 있습니다. Humanoid 탭에는 로봇 전체에 필요한 액추에이터별 수량이 나와 있습니다.
  2. MAD Components M6C12 150KV 모터 10개를 M6C12 액추에이터마다 하나씩 주문합니다. M6C12 Actuator 탭에는 액추에이터당 ‘MAD Components M6C12 150KV’ 하나가 나와 있습니다. Humanoid 탭에는 다리용 M6C12 액추에이터 8개와 팔용 2개가 나와 있습니다. 논문과 릴리스 노트에서는 이것을 6512 액추에이터라고 부릅니다.
  3. MAD Components 5010 110KV 모터 12개를 5010 액추에이터마다 하나씩 주문합니다. 5010 Actuator 탭에는 ‘MAD Components 5010 110KV’가 나와 있습니다. Humanoid 탭에는 다리용 5010 액추에이터 4개와 팔용 8개가 나와 있습니다. 구입하는 모터의 KV를 확인하십시오. 펌웨어에는 다른 5010 모터용 프로필도 들어 있지만(Flashing 페이지의 310KV와 370KV, 2025-09-07에 펌웨어에 추가된 200KV 프로필), BOM의 모터는 110KV입니다.
  4. B-G431B-ESC1 모터 컨트롤러(총 22개)를 Digikey 등에서 주문한다.
  5. AS5600 자기 엔코더(22개)를 방사형 자화 자석 포함으로 주문한다.
  6. 각 액추에이터 탭에 나와 있는 베어링을 주문합니다. M6C12 액추에이터, 액추에이터당: MR106-2RS 13개, 6701-2RS 2개, 6811ZZ 2개. 5010 액추에이터, 액추에이터당: MR106-2RS 13개, 6701-2RS 2개, 6809ZZ 2개. Humanoid 탭에는 6803-2RS 6개도 나와 있으며, ‘다리 피치 액추에이터의 링키지 사이 베어링’으로 설명되어 있습니다. 릴리스 로그에 따르면 6803 베어링과 M2 인서트는 2025-05-29까지 Humanoid 탭에 빠져 있었고, MR106-2RS와 6701-2RS의 설명은 2025-05-23까지 서로 바뀌어 있었으므로, 이전 사본을 보고 구입했다면 현재 시트를 확인하십시오.
  7. M3 나사, M2/M3 인서트 너트, M4 육각 스탠드오프를 BOM 수량대로 주문한다.

1.2 전자부품·구조재 조달

주요 전자기기(컴퓨터, IMU, CAN 어댑터)와 구조 재료를 주문.

  1. 온보드 컴퓨터용 Intel N95 미니 PC(또는 동급)를 주문한다.
  2. BNO085 9축 IMU 또는 Hiwonder의 IM10A IMU 모듈을 주문합니다. 문서에서는 USB로 직접 연결된다는 이유로 IM10A를 강력히 권장합니다. 초기 BNO085 버전은 IMU를 컴퓨터에 연결하는 데 Arduino Nano를 사용했는데, BOM에는 Arduino Nano가 나와 있지 않습니다.
  3. USB-CAN 어댑터(1 Mbps) 4개와 USB 허브 2개를 주문한다.
  4. 6S LiPo 배터리를 주문합니다. BOM에는 ‘LiPo battery 6S’가 나와 있고, 논문에는 로봇의 배터리가 6S 4000 mAh로 나와 있습니다.
  5. Humanoid 탭에는 로봇 전체용으로 다음 부품도 나와 있습니다: 24V to 12V regulator (1), 12V to 5V regulator (1), Voltage monitor (1), Current monitor (1), Circuit breaker (1), Aluminum extrusion 250 mm (2), 200 mm (4), 150 mm (2), 100 mm (3), Aluminum inner bracket (24), Servo motor claw (2). 또한 다리용과 팔용에 각각 1인 3D print filament 행도 나와 있습니다.
  6. LiPo 안전 수칙, 저자의 실험실 노트에서 발췌(제작 가이드의 일부가 아님): 충전 중인 배터리를 절대 방치하지 마십시오. 충전기에 설정한 셀 유형, 셀 수, 최대 충전 전류가 배터리 라벨과 일치하는지 확인하십시오. 최대 충전 전류는 용량을 한 시간으로 나눈 값으로, 예를 들어 2200 mAh이면 2.2 A입니다. 부하가 걸린 상태에서 LiPo를 3 V 미만으로 절대 방전하지 마십시오. 배터리가 부풀어 오르면 즉시 중단하고 폐기하십시오.
  7. PLA 필라멘트를 주문한다 — Bambu Lab PLA Basic 또는 Hatchbox PLA 권장.
  8. 배선재를 주문한다: 14 AWG 전원선, 30 AWG 신호선, XT60·XT30 커넥터, WAGO 커넥터.

2. 공구 준비

조립 시작 전 필요한 공구를 모두 작업대에 준비.

2.1 3D 프린터와 작업대 준비

프린터가 요건을 충족하고 작업대가 준비됐는지 확인.

  1. 3D 프린터의 출력 볼륨이 200 x 200 x 200 mm 이상인지 확인합니다. Bambu Lab X1C Carbon을 권장합니다. Creality Ender-3 V3 SE도 테스트에 성공했습니다.
  2. SUGON A9 210 또는 동급 인두로 납땜 스테이션을 준비한다.
  3. 출력물에 인서트 너트를 넣을 히트 인서트 스탠드를 준비한다.
  4. 모터 축에 자석을 붙일 글루건을 준비한다.
  5. 육각 렌치 세트를 준비한다: M2, M2.5, M3, M4, M6.
  6. 십자 (+) 드라이버와 일자 (-) 드라이버를 준비합니다. 구입한 부품에 포함되어 있는 경우가 많습니다.

3. 3D 프린팅

제공된 STL과 Releases 페이지 권장 프린트 프로파일로 전 구조 부품을 출력.

3.1 액추에이터 부품 출력

Actuator Housing과 Actuator Shaft 프로파일로 사이클로이드 감속기 하우징·축·모터 셸을 출력.

  1. Releases 페이지에서 3D 프린팅 파일을 내려받는다(Bambu Lab MakerWorld 링크 제공).
  2. 하우징, 출력축, 모터 셸에는 Actuator Housing Profile을 사용합니다. 프로필 설정은 3D Printing Instructions 페이지에 스크린샷으로 나와 있습니다(탭 Quality, Strength, Speed, Support, Others).
  3. 릴리스 로그, 2025-05-21: 업스트림이 6512 액추에이터의 MakerWorld .3mf 파일을 수정했습니다. 릴리스 로그, 2025-08-23: 업스트림이 MakerWorld의 3D 출력 파일을 수정하여 ‘잘못된 5010-5010 하우징 부품을 교체하고 누락된 리밋 스토퍼 부품을 추가’했으며, 모터 축에 자석을 장착하는 방법에 대한 설명을 추가했습니다. 이 날짜 이전에 액추에이터 부품을 다운로드하거나 출력했다면 현재 파일과 비교하십시오.
  4. 사이클로이드 디스크·입력축·모터축·스페이서는 Actuator Shaft 프로파일로 — 더 높은 정밀도 필요.
  5. 프로파일은 Bambu Lab X1C에 맞춰져 있다. 다른 프린터면 설정을 조정한다.
  6. M6C12 액추에이터 부품 세트 10벌과 5010 액추에이터 부품 세트 12벌을 출력한다.

3.2 몸체 구조 부품 출력

상체·하체와 모든 프레임 부품을 출력.

  1. 상체 부품 출력 — 각 부품을 두 번, 두 번째는 X축 미러로.
  2. 하체 부품 출력 — 미러 요건은 상체와 동일.
  3. 구조 부품은 정밀도가 덜 중요하므로 더 빠른 설정으로 출력해도 된다.
  4. BOM에는 그리퍼가 구매 부품 ‘Servo motor claw’로 나와 있으며, Humanoid 탭의 수량은 2입니다. 3D Printing Instructions 페이지에는 그리퍼 출력에 대한 설명이 없습니다.
  5. 조립 전에 출력 부품을 정리합니다. M6C12 액추에이터 영상은 ‘Clean up parts’라는 챕터로 시작합니다.
  6. 히트 인서트 스탠드와 인두로 M2·M3 인서트 너트를 지정된 모든 구멍에 넣는다.

4. 액추에이터 제작

영상 가이드에 따라 사이클로이드 액추에이터 22개(M6C12 고토크×10, 5010 중토크×12)를 조립.

4.1 자기 엔코더 준비

AS5600 인코더 보드를 액추에이터 하우징 통합용으로 개조.

  1. -T.K.-의 'AS5600 Encoder Modification' 영상 가이드를 따른다.
  2. AS5600 인코더에 동봉된 방사형 자화 자석을 사용한다 — 일반 자석으로 대체 금지.
  3. 같은 절차로 22개 인코더 보드 전부를 개조한다.
  4. 자세한 내용은 외부 튜토리얼 notes.tk233.xyz/electrical/as5600-modification 참조.
  5. 개조는 보드의 저항을 변경하여 수행합니다. AS5600 Modification 페이지에는 다음 옵션이 나와 있습니다: VCC 포트에서 5V를 사용하려면 R1을 제거합니다. PGO를 정상 동작으로 되돌리려면 R4를 제거합니다. 반시계 방향 회전을 위해서는 DIR을 VDD에 연결합니다. 0R 점퍼로 DIR 패드를 VCC에 연결된 R1 상단에 연결할 수 있습니다(‘R1’ 글자가 있는 쪽 근처).
  6. 저항을 옮긴 후 VCC, GND, SDA, SCL 전선도 해당 패드에 납땜합니다.

4.2 모터 준비

모터 축에 자석을 붙여 액추에이터 통합을 준비.

  1. 핫글루를 조금 사용하여 자석을 모터 로터 축에 붙입니다. 페이지에서는 축에 클립이 있는 5010 모터를 예로 보여 줍니다. M6C12 모터는 대신 축 끝에 나사가 있지만 자석을 장착하는 방법은 같습니다.
  2. M6C12 모터 10개와 5010 모터 12개를 모두 준비한다.

4.3 M6C12 액추에이터 조립

사이클로이드 감속기·베어링·엔코더로 고토크 액추에이터를 제작.

  1. -T.K.-의 'Assembling the M6C12 Actuator' 영상 가이드를 따른다.
  2. BOM의 설명대로 베어링을 장착합니다. MR106-2RS: 입력축과 사이클로이드 디스크 사이, 입력축과 출력축 사이. 6701-2RS: 사이클로이드 디스크와 출력축 사이. 6811ZZ: 출력축과 하우징 사이.
  3. 출력한 사이클로이드 디스크와 입력축으로 15:1 감속기를 조립한다.
  4. M6C12 모터를 모터 셸에 넣고 감속기와 연결한다.
  5. 개조한 AS5600 인코더를 모터 로터 축에 붙인 자석 위에 부착합니다(영상 챕터 ‘Attach encoder’). 인코더는 모터 축을 읽습니다. 업스트림에 따르면 관절 액추에이터에는 모터 축의 인코더 하나만 있습니다.
  6. M6C12 액추에이터 10개 전부에 반복한다.

4.4 5010 액추에이터 조립

같은 과정으로 5010 전용 부품을 써서 중토크 액추에이터를 제작.

  1. 업스트림은 M6C12 액추에이터용 조립 영상만 공개합니다. 5010용 조립 영상이나 텍스트는 따로 공개하지 않습니다. 5010 액추에이터는 BOM 탭, Onshape CAD, MakerWorld 출력 파일로 다루어지며, 모두 Releases 페이지에 링크되어 있습니다.
  2. 5010 액추에이터는 더 작지만 같은 사이클로이드 원리를 쓴다.
  3. 5010 Actuator 탭에 나와 있는 베어링을 장착합니다: MR106-2RS, 6701-2RS, 6809ZZ.
  4. 5010 액추에이터 12개 전부에 반복한다.

4.5 ESC 납땜

모든 B-G431B-ESC1에 전원·CAN·신호 케이블을 납땜.

  1. 전원선은 14 AWG(양극=흰/빨강, 접지=검정).
  2. CAN 케이블에는 30 AWG 연선 실리콘 전선을 사용합니다. 색상 구분: CAN-H와 SDA는 노란색, CAN-L과 SCL은 녹색입니다.
  3. 경고: ESC의 CAN 포트 납땜 패드는 매우 약하고 FR4 기판층에서 매우 쉽게 떨어집니다. 납땜하거나 기판을 다룰 때 각별히 주의하십시오. 케이블과 패드에 과도한 힘을 가하지 마십시오.
  4. 일관된 색 규칙으로 22개 ESC 보드 전부를 납땜한다.
  5. 인코더와 CAN의 납땜 패드는 다루기 까다롭습니다. 업스트림은 플럭스를 더 추가할 것을 제안하며, 그러면 더 튼튼한 납땜 접합을 만들기 쉬워집니다.
  6. Building the Actuator 페이지의 배선도에 따라 인코더, 모터, 모터 컨트롤러를 연결합니다. 배선도는 이미지이며 여기에 다시 싣지 않았습니다.

5. 모터 컨트롤러 플래싱

모든 B-G431B-ESC1에 펌웨어를 굽고 각 액추에이터를 교정.

5.1 STM32CubeIDE로 펌웨어 플래싱

각 ESC에 Recoil Motor Controller 펌웨어를 설치·플래시.

  1. 컴퓨터에 STM32CubeIDE를 설치한다.
  2. 다음 명령으로 펌웨어를 다운로드합니다: git clone https://github.com/T-K-233/Recoil-Motor-Controller-BESC.git
  3. Core/Inc/motor_controller_conf.h를 열고 FIRST_TIME_BOOTUP 플래그를 1로 설정합니다. STM32의 내부 Flash에 모터 설정 파라미터가 저장되므로, 이렇게 하면 Flash 보호가 설정됩니다.
  4. 컨트롤러 보드의 Micro USB 포트를 통해 모터 컨트롤러를 컴퓨터에 연결합니다. STM32CubeIDE가 새 장치를 감지해야 합니다. Run 버튼을 클릭합니다. 새 보드에서는 ST-LINK 디버거 펌웨어 업데이트를 묻는 메시지가 나타납니다. 이를 수락하고 안내에 따른 다음 Run을 다시 클릭합니다.
  5. USB 케이블을 뽑았다가 다시 꽂아 보드의 전원을 껐다 켭니다. 그런 다음 FIRST_TIME_BOOTUP 플래그를 다시 0으로 변경합니다.
  6. 'Flashing the Motor Controller Firmware' 영상 가이드를 따른다.
  7. 22개 ESC 보드 전부를 플래시한다.

5.2 액추에이터 파라미터 설정

각 액추에이터에 대해 motor_controller_conf.h에서 CAN ID를 설정하고 모터 프로필을 선택한 다음 플래시합니다.

  1. M6C12 액추에이터의 경우 #define MOTORPROFILE_MAD_M6C12_150KV의 주석을 해제합니다. 현재 펌웨어를 사용하십시오. M6C12 프로필은 2025-09-07에 다시 측정되었습니다(토크 상수 0.08958, 이전 값 0.0919).
  2. 5010 액추에이터의 경우 #define MOTORPROFILE_MAD_5010_110KV의 주석을 해제합니다. BOM의 모터가 MAD Components 5010 110KV이기 때문입니다. MOTORPROFILE_MAD_5010_310KV 또는 MOTORPROFILE_MAD_5010_370KV를 사용하지 마십시오. 펌웨어에서 이 두 프로필은 MOTOR_TORQUE_CONSTANT 줄이 주석 처리되어 있습니다. 로봇에 저장된 관절 설정의 5010 관절 토크 상수는 0.1176이며, 이는 110KV 프로필의 값입니다.
  3. Joint ID Mapping 페이지에 따라 motor_controller_conf.h의 DEVICE_CAN_ID를 설정합니다. ID는 로봇 전체가 아니라 각 CAN 버스에서 고유합니다. 왼팔(CAN0): 1, 3, 5, 7, 9. 오른팔(CAN1): 2, 4, 6, 8, 10. 왼쪽 다리(CAN2): 고관절 롤 1, 고관절 요 3, 고관절 피치 5, 무릎 피치 7, 발목 피치 11, 발목 롤 13. 오른쪽 다리(CAN3): 고관절 롤 2, 고관절 요 4, 고관절 피치 6, 무릎 피치 8, 발목 피치 12, 발목 롤 14. 펌웨어는 1에서 63까지의 값을 허용합니다.
  4. 같은 파일에서 아래로 스크롤하여 LOAD_ID_FROM_FLASH와 LOAD_CONFIG_FROM_FLASH를 0으로 설정합니다. 그러면 프로그램이 Flash의 기본 무작위 값을 덮어씁니다. Run을 클릭합니다. 그런 다음 USB 케이블을 뽑았다가 다시 꽂아 Flash 옵션이 로드되었는지 확인합니다. LED는 약 1 Hz로 깜박여야 하며, 이는 프로그램이 로드되어 실행 중임을 나타냅니다.
  5. LOAD_ID_FROM_FLASH와 LOAD_CONFIG_FROM_FLASH를 다시 1로 변경하고 Run을 클릭하여 마지막으로 플래시합니다. 이 시점에서 Run 버튼을 네 번 클릭한 것이며, 펌웨어와 설정 파라미터가 모두 로드되었습니다.

5.3 전 액추에이터 교정

제공된 Python 스크립트로 CAN을 통해 각 액추에이터에 교정 루틴을 실행.

  1. USB-CAN 어댑터를 통해 액추에이터의 CAN 버스를 컴퓨터에 연결한 다음 액추에이터의 전원을 켭니다. 다음 명령으로 CAN 전송을 시작합니다: sudo ip link set can0 up type can bitrate 1000000
  2. 다음 명령으로 연결을 확인합니다: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1 (-c 인수는 CAN 전송, -i 인수는 CAN ID입니다). 스크립트는 ‘Motor is online’을 출력해야 합니다. ‘Motor is offline’을 출력하면 신호 케이블 연결, 전원, CAN ID 설정을 확인하십시오.
  3. 액추에이터에 아무것도 부착되어 있지 않고 자유롭게 회전할 수 있는지 확인합니다. 다음을 실행합니다: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/calibrate_electrical_offset.py -c can0 -i 1. 업스트림의 경고: 모터가 회전하며 상당한 전류(전원 공급 장치에서 약 1 A)를 소모합니다. 전원 케이블이 제대로 연결되어 있고 액추에이터가 자유롭게 회전할 수 있는지 확인하십시오. 모터는 상전류가 목표값에 도달할 때까지 유지 토크를 천천히 높이고, 반시계 방향으로 기계적으로 한 바퀴 회전한 다음, 시계 방향으로 한 바퀴 되돌아옵니다.
  4. 회전 방향이 뒤집혀 있으면(시계 방향 먼저, 그다음 반시계 방향) 세 모터 상선 중 아무 두 개를 서로 바꾸거나 펌웨어의 MOTOR_PHASE_ORDER를 -1로 변경합니다. 릴리스 로그는 2025-07-07에 이 주의 사항을 추가했습니다.
  5. 'Motor Calibration' 영상으로 올바른 절차를 익힌다.
  6. 액추에이터를 확인하려면 다음을 실행합니다: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/move_actuator.py -c can0 -i 1. 이 스크립트는 액추에이터를 사인파 위치 곡선을 따라 움직입니다. 업스트림의 주의 사항: 모터가 회전합니다. 작은 kP, kD, 토크 제한 값으로 시작하십시오. 예상치 못한 일이 발생하면 Ctrl+C를 눌러 프로그램과 액추에이터를 정지하십시오.
  7. 22개 전부를 교정한다.

6. 로봇 조립

교정된 액추에이터와 3D 프린팅 구조 부품으로 팔·다리·전신을 조립.

6.1 팔 조립

어깨(3 자유도)와 팔꿈치(2 자유도: 팔꿈치 피치와 팔꿈치 요) 관절이 있는 팔 어셈블리 두 개를 모두 제작한 다음, 각각에 그리퍼를 부착합니다.

  1. -T.K.-의 'Assembling the Arm' 영상 가이드를 따른다.
  2. 어깨 롤, 어깨 요, 팔꿈치 피치, 팔꿈치 요에 5010 액추에이터를 설치합니다. 팔당 5010 액추에이터 네 개입니다. Humanoid 탭에는 두 팔용 5010 액추에이터 8개가 나와 있습니다.
  3. 어깨 피치 관절에 M6C12 액추에이터를 팔당 하나씩 설치합니다. Humanoid 탭에는 팔용 M6C12 액추에이터 2개가 나와 있습니다. 업스트림의 텍스트에는 팔 관절별 액추에이터가 명시되어 있지 않습니다. 이는 Assembling the Arm 영상에 나와 있는데, 이 영상은 시청하지 않았습니다. 이 배정은 BOM 수량과 로봇에 저장된 관절 설정을 따른 것입니다.
  4. 각 팔에 그리퍼 어셈블리를 부착한다.
  5. 좌우 양팔을 제작한다(미러 조립).

6.2 다리 조립

고관절(3 자유도)·무릎(1)·발목(2)으로 양다리를 제작.

  1. -T.K.-의 'Assembling the Leg' 영상 가이드를 따른다.
  2. 고관절 롤, 고관절 요, 고관절 피치, 무릎 피치에 M6C12 액추에이터를 설치합니다. 다리당 M6C12 액추에이터 네 개입니다. Humanoid 탭에는 다리용 M6C12 액추에이터 8개가 나와 있습니다.
  3. 발목 피치와 발목 롤에 5010 액추에이터를 설치합니다. 다리당 5010 액추에이터 두 개입니다. Humanoid 탭에는 다리용 5010 액추에이터 4개가 나와 있습니다. 업스트림의 텍스트에는 관절별 액추에이터가 명시되어 있지 않습니다. 이 배정은 BOM 수량과 위에 언급된 파일을 따른 것이며, Assembling the Leg 영상에 나와 있을 수 있습니다. 이 영상은 시청하지 않았습니다.
  4. Assembling the Leg 영상의 챕터는 다음과 같습니다: Hip Base, Hip Roll, Hip Yaw, Hip Pitch, Knee Pitch, Ankle Pitch & Roll. 영상 설명의 정정 내용: ‘영상에서 저는 고관절 구조를 잘못 조립했습니다. hip pitch는 반대 방향으로 장착해야 합니다 --- 왼쪽 다리와 오른쪽 다리를 혼동했습니다.’ hip pitch는 영상과 반대 방향으로 장착하십시오.
  5. Humanoid 탭에는 다리용 6803-2RS 베어링 6개가 나와 있으며, ‘다리 피치 액추에이터의 링키지 사이 베어링’으로 설명되어 있습니다.
  6. 좌우 양다리를 제작한다(미러 조립).

6.3 전신 조립

팔·다리·몸통을 완전한 휴머노이드로 결합.

  1. -T.K.-의 'Assembling the Body' 영상 가이드를 따른다.
  2. Assembling the Body 영상의 챕터는 다음과 같습니다: Attaching the battery holder, Preparing the hip, Base structure, Attaching the base, Attach the arm.

6.4 배선과 전자부

CAN 버스·배전·온보드 컴퓨터까지 전기 연결을 완료.

  1. CAN 케이블을 USB-CAN 어댑터 보드의 나사 단자에 직접 연결합니다. 순서는 CAN-L, CAN-H, GND이며, 신호 이름은 PCB 뒷면에도 표시되어 있습니다. 로봇은 네 개의 버스를 사용합니다: CAN0 왼팔, CAN1 오른팔, CAN2 왼쪽 다리, CAN3 오른쪽 다리.
  2. 신호 케이블: 직접 납땜하여 연결하고 접합부를 열수축 튜브로 보호합니다. 전원 케이블: 처음 연결할 때는 WAGO 커넥터(로봇은 두 포트, 세 포트, 다섯 포트 유형을 사용)로 납땜 없이 각 액추에이터를 메인 전원 버스에 연결하고 분리할 수 있어 디버깅이 쉬워집니다. 더 영구적으로 제작하려면 케이블을 직접 납땜하여 연결합니다.
  3. 액추에이터 사이의 케이블은 XT30 및 XT60 커넥터로 연결할 수 있습니다. 업스트림은 메인 케이블을 연결하는 데 XT60을 사용하며, 각 액추에이터는 XT30 커넥터로 메인 전원 버스에 연결합니다.
  4. Intel N95 미니 PC를 장착하고 USB 허브를 연결한다.
  5. USB-CAN 어댑터를 USB 허브에 연결한다.
  6. IMU(IM10A 권장)를 온보드 컴퓨터에 USB 직결로 설치한다.
  7. 6S LiPo 배터리를 몸통에 장착한다.
  8. 업스트림 홈페이지의 경고: ‘이것은 단순한 소프트웨어 프로젝트가 아닙니다. 고출력 전자 장치 설계를 포함합니다. 아직 UC Berkeley 연구실이나 누구의 집도 태운 적은 없지만, 보장은 없습니다 : )’ ‘모든 단계를 각별히 주의하여 따르십시오.’ 전원을 연결하기 전에 극성을 확인하십시오. 업스트림의 색상 구분에서 흰색 또는 빨간색은 양극이고 검은색은 접지입니다.

7. 소프트웨어 설정과 테스트

소프트웨어 환경을 구축하고 정책을 배포해 동작을 확인.

7.1 온보드 컴퓨터 설정

Intel N95 미니 PC에 OS와 필요한 소프트웨어를 설치.

  1. 온보드 컴퓨터에 Ubuntu 22.04를 설치합니다. 업스트림에 따르면 22.04는 자체 소프트웨어 및 하드웨어 스택과 잘 맞으며, 컴퓨터는 BeeLink N95 NUC로 명시되어 있습니다. 페이지에는 BIOS 키가 ‘XXXX’로 남아 있습니다.
  2. Berkeley-Humanoid-Lite 저장소를 클론한다.
  3. 페이지에 나와 있는 패키지를 설치합니다: sudo apt install build-essential cmake net-tools can-utils python3-pip. 명령은 uv를 통해 Python을 실행합니다. uv를 설치하는 명령은 Training Environment 페이지에 나와 있습니다. 워크스페이스의 pyproject.toml은 Python 3.11을 요구합니다(requires-python >=3.11,<3.12).
  4. 업스트림에 따르면 로봇에는 source/berkeley_humanoid_lite_lowlevel/의 내용만 필요합니다.
  5. 다음 명령으로 CAN 전송을 시작합니다: source ./scripts/start_can_transports.sh. can0부터 can3까지 비트레이트 1000000으로 시작합니다. 중지하려면: source ./scripts/stop_can_transports.sh

7.2 액추에이터 통신 테스트

온보드 컴퓨터에서 22개 액추에이터 모두가 CAN 버스를 통해 올바르게 응답하는지 확인합니다.

  1. ping 스크립트로 액추에이터 하나를 테스트합니다. Flashing 페이지에는 다음 명령이 나와 있습니다: uv run ./source/berkeley_humanoid_lite_lowlevel/scripts/motor/ping.py -c can0 -i 1. On-board Computer 페이지에는 이전 경로와 플래그(python ./berkeley_humanoid_lite_lowlevel/motor/ping.py --port can0 --id 1)가 나와 있는데, 이는 Lowlevel 저장소에 더 이상 존재하지 않습니다. 두 팔과 두 다리를 연결한 경우 CAN 포트는 can0, can1, can2, can3 중 하나이고 CAN ID는 1에서 14 범위입니다.
  2. 이전 단계의 move_actuator.py 스크립트로 각 관절을 확인하되, 작은 kP, kD, 토크 제한으로 시작합니다.
  3. 각 액추에이터의 CAN ID와 버스가 Joint ID Mapping 페이지와 일치하는지 확인합니다. 소프트웨어가 사용하는 관절 목록은 berkeley_humanoid_lite_lowlevel/robot/humanoid.py에 있으며, 다리가 나열되어 있고 팔 관절은 주석 처리되어 있습니다.

7.3 보행 정책 배포

학습된 보행 정책을 로드해 기본 걷기를 테스트.

  1. 저장소의 checkpoints/에는 ONNX 정책(예: policy_humanoid.onnx, policy_humanoid_legs.onnx)이 있고 configs/에는 이에 맞는 YAML 파일이 있습니다. play.py 학습 스크립트는 학습된 정책을 ONNX로 내보내고 configs/policy_latest.yaml을 업데이트합니다.
  2. 모두 함께 실행하려면 먼저 CAN 전송이 시작되어 있는지 확인합니다. 저수준 코드를 실행하는 방법은 두 가지입니다. C 코드베이스는 실시간 보장이 더 좋아 보행에 권장됩니다: ./csrc/에서 make를 실행한 다음 ./build/real_humanoid를 실행합니다. USB-CAN 어댑터가 통신 주파수를 따라가지 못하면 페이지에서는 xanmod 실시간 커널을 제안합니다. Python 코드베이스: lowlevel 디렉터리에서 uv run ./scripts/python/run_locomotion.py를 실행합니다. 현재 Lowlevel 저장소에서 스크립트는 scripts/run_locomotion.py이므로 페이지의 경로는 오래된 것입니다. 로봇은 MuJoCo sim2sim 시뮬레이션과 동일한 상태 전환을 따릅니다.

이 웹사이트는 JavaScript가 필요합니다. 오픈소스 로봇 프로젝트를 탐색하려면 JavaScript를 활성화하세요.