본문으로 건너뛰기

서보 드라이브 연결하기

로봇팔 없이 CiA 402 서보 드라이브를 EtherCAT 버스에 붙여 돌리는 방법입니다. 드라이브는 YAML 파일 하나(드라이브 모델 파일)로 정의합니다. C++ 코드를 쓰지 않고, 화면 없이 Python·ROS 2·명령줄로 다룹니다.

대상은 CoE(CANopen over EtherCAT)로 CiA 402를 쓰는 드라이브입니다. 운전 모드는 축마다 파일의 mode 로 하나 고르고, 한 버스에 여러 모드를 섞어도 됩니다.

mode운전 모드명령 단위명령을 보내는 곳
csp위치rad궤적 컨트롤러 (Bus.move_to, FollowJointTrajectory)
csv속도rad/s스트림 컨트롤러 (Bus.stream, 토픽)
cst토크Nm스트림 컨트롤러 (Bus.stream, 토픽)

csv·cst 축은 매 주기 명령을 받으므로 이 문서들에서는 스트림 축이라고 부릅니다. 파일의 키는 드라이브 모델 파일에, 인터페이스·오류·정지·벤치는 드라이브 버스 API에 있습니다.

내 드라이브를 붙이는 전체 순서입니다.

mkdir -p "$HOME/drives" && cp "$(ros2 pkg prefix --share plem_drive)/examples/example_drive.yaml" "$HOME/drives/my_drive.yaml" # 1절
# 내 드라이브의 값을 채웁니다 (2절)
plem drive check "$HOME/drives/my_drive.yaml" # 3절
plem drive run "$HOME/drives/my_drive.yaml" # 처음 한 번 벤치(7절), 그다음 버스가 뜹니다(4절)

plem drive 의 동사는 check 와 run 두 개이고, 목록은 plem drive --help 로 봅니다. plem 은 명령을 plem-drive 도구에 그대로 넘깁니다. 드라이브 패키지(plem-drive)만 설치한 기기에도 plem-cli 패키지가 함께 들어오므로 plem 을 씁니다. 소스 빌드에서는 워크스페이스를 source 하면(source install/setup.bash) 같은 이름으로 씁니다.

처음 여는 축은 중력 하중이 없는 축으로

아래 절차는 중립 명령으로 브레이크를 해제합니다. 토크 축의 중립은 0 Nm입니다. 드라이브 계층에는 중력 보상이 없으므로, 하중이 걸린 토크 축은 브레이크가 풀리는 즉시 떨어집니다. 위치·속도 축은 드라이브 안의 루프가 버티지만, 그 거동은 드라이브마다 다르고 실제 드라이브로 확인하지 않았습니다. 첫 시험은 하중 없는 축에서, 비상 정지에 손이 닿는 자리에서 하세요.

준비​

  1. PLEM 패키지를 설치합니다. 전체 설치든 드라이브 패키지(plem-drive)만이든 됩니다. 패키지는 담당자가 준 토큰으로 Depot 저장소를 등록하고 ROS 2 apt 저장소도 등록한 Jetson(aarch64, Ubuntu 22.04·24.04)에서 받습니다. 전체 설치(install.sh)는 두 저장소를 모두 등록합니다. 드라이브 패키지만 설치하는 순서는 ROS 2 인터페이스에 있습니다.

  2. IgH EtherCAT 마스터가 /opt/etherlab 에 있어야 합니다. plem-drive 패키지에도, PLEM 설치 스크립트에도 들어 있지 않습니다. 없으면 담당자에게 문의하세요.

  3. 운영 계정을 realtime 그룹에 넣고 다시 로그인합니다. 버스 루프는 실시간 스케줄링(SCHED_FIFO)과 메모리 잠금을 씁니다. 그룹의 권한 파일 /etc/security/limits.d/99-plem-realtime.conf 가 우선순위 99와 잠금 메모리 무제한을 줍니다. 그룹과 파일은 plem-drive 패키지가 만들고, 계정은 설치·업데이트 스크립트가 넣습니다. apt 로 패키지만 설치했다면 직접 넣으세요.

    sudo usermod -aG realtime "$USER" # 그 뒤 로그아웃했다가 다시 로그인
    ulimit -r # 99
    ulimit -l # unlimited
  4. PREEMPT_RT 커널과 CPU 격리를 권장합니다. 없어도 plem drive run 은 경고만 하고 띄웁니다.

1. 예제를 복사합니다​

mkdir -p "$HOME/drives"
cp "$(ros2 pkg prefix --share plem_drive)/examples/example_drive.yaml" "$HOME/drives/my_drive.yaml"

example_drive.yaml 은 위치 축 하나이고, 값은 어떤 드라이브에도 맞지 않는 합성 값입니다. 모양만 두고 값은 전부 내 드라이브의 것으로 바꾸세요.

코딩 에이전트에게 맡기기​

패키지에 에이전트 스킬 add-drive 가 함께 설치됩니다. 이 스킬은 복사한 파일로 2절까지 진행합니다.

  1. 읽기 전용 ethercat 명령만으로 드라이브를 읽습니다. 에이전트가 실행하려는 명령은 직접 확인하세요.
  2. 드라이브·모터·감속기가 무엇인지 묻고 그 문서를 읽은 뒤, 값마다 출처를 주석으로 달아 적습니다.
  3. 한계·정지 감속·주기처럼 정해야 하는 값은 모두 사용자에게 묻습니다.
  4. 스키마의 전제가 맞지 않으면 그 자리에서 멈춥니다. 전제는 축마다 드라이브가 직접 여닫는 유지 브레이크와 절대 엔코더입니다.
  5. 근거가 없는 값은 키를 빼고 # OPEN 으로 표시합니다. 파일이 통과하거나 열린 키에서만 거부될 때까지 plem drive check 를 돌립니다.

벤치(7절)는 사용자 몫입니다. Claude Code 사용자는 스킬 폴더에 링크합니다.

mkdir -p ~/.claude/skills
ln -s "$(ros2 pkg prefix plem_drive)/share/skills/add-drive" ~/.claude/skills/

plem-code·plem-drive 패키지를 함께 설치한 기기에서는 링크하지 않아도 plem code 에이전트가 스킬을 찾습니다(bare·safe 모드 제외). 스킬은 시작할 때 읽으므로 패키지를 설치하거나 갱신한 뒤에는 에이전트를 다시 시작하세요. 다른 에이전트에는 같은 SKILL.md 를 지시문으로 줍니다.

에이전트가 쓴 값은 직접 확인하세요

주석이 출처를 알려 주지만, 틀린 값도 그대로 로드됩니다.

A6B 두 축 예제​

같은 자리의 a6b_pair 폴더는 실제 드라이브로 만든 예제입니다. Panasonic MINAS A6B 두 대(MDDLN55BE, 모터 MSMF102L1H5)의 위치 축을 하나씩, DC 동기와 21:1 감속기로 정의합니다. 폴더에는 drive.yaml, 두 축을 거울처럼 움직이는 demo.py, sync 탭이 든 레이아웃 plotjuggler.xml, README.md 가 있습니다. 순서·안전 수칙·값마다의 근거는 README.md 에 있습니다. 승인은 파일 안에 기록되므로 쓸 수 있는 곳으로 폴더째 복사합니다.

cp -r "$(ros2 pkg prefix --share plem_drive)/examples/a6b_pair" "$HOME/drives/"

다른 A6B 모델이나 모터면 product_code 와 motor_rated_torque_nm 이, 다른 감속기면 gear_ratio 와 모든 축 값이 바뀝니다. zero_offset_count 는 내 드라이브에서 잽니다.

정지 감속은 설비에 맞게 정하세요

예제의 정지 감속 3200 rad/s²(모터축)는 감속기 출력축을 풀어 둔 무부하 벤치에서 고른 값입니다. 하중이 있으면 정지 토크와 회생 에너지가 커집니다. 설비에 맞게 정하고, 첫 정지는 하중 없이 해 보세요.

2. 값을 채웁니다​

키가 빠진 파일은 거부됩니다. 값이 없을 때는 null 이나 [] 로 적습니다. 빼도 되는 키와 그때 쓰이는 값은 드라이브 모델 파일 §1에 있습니다. 똑같은 드라이브 여러 대는 링 위치를 목록으로 적어(ring_position: [0, 1]) 한 항목으로 쓰고, name·flip·zero_offset_count 만 드라이브마다 하나씩 적습니다(§4.1).

키어디서 얻나주의
vendor_id, product_code, ring_positionethercat slaves -v
pdo_mappingscanned(드라이브가 켜질 때의 매핑), generated(PLEM 쪽에서 쓰는 CiA 402 객체로 만들어 PREOP 상태에서 씀), 또는 ESI 파일·ethercat pdos·scanned 기동 로그에서 옮긴 선언generated 는 A6B(csp)에서만 실제로 돌려 봤습니다
busname(버스는 /<name> 으로 뜸, 영문·숫자·_, 숫자로 시작하지 않음), cycle_time_ns(1000의 배수), sync_modedrive_default 는 드라이브 자신의 동기 설정을 따릅니다. dc_sync0 이면 모든 슬레이브에 dc 블록이 필요합니다
name직접 정합니다소문자·숫자·_, 31바이트 이하, 파일 안에서 겹치지 않게
channel드라이브 안의 몇 번째 CiA 402 축인지(1~8)
modecst, csp, csv 중 하나. 드라이브 매뉴얼로 확인매핑에 그 모드의 목표 객체(0x6071, 0x607A, 0x60FF)가 있어야 합니다
mode_display_timing뺍니다(pre_enable)enable 뒤에야 0x6061에 모드를 표시하는 드라이브만 post_enable 을 적습니다. 적기 전에는 해제가 거부되고, 거부 메시지가 이를 알려 줍니다
factors드라이브 매뉴얼과 모터 명판매뉴얼이 0x6071·0x6077을 정격 토크의 ‰로 적으면 rated_per_mille(motor_rated_torque_nm 함께), 전류 카운트로 적으면 scaled_current
velocity_factor드라이브 매뉴얼의 0x606C 단위틀려도 로드되며, 속도 한계와 joint_states 속도가 조용히 어긋납니다
flip, zero_offset_count실측합니다절대 엔코더에서만 뜻이 있습니다(지원하지 않는 것)
limits선언하는 사람의 책임입니다. 기본값이 없습니다기계적 끝단이 없는 축(무한 회전 축)은 position: null. 위치·속도 축은 요청 정지의 감속 acceleration_rad_s2 도 적습니다. 축이 실제로 낼 수 있고 드라이브의 0x6085를 넘지 않는 값이어야 합니다
startup_sdo드라이브 매뉴얼. 없으면 []정지 객체 0x605A, 0x605C, 0x6084, 0x6085도 여기서 줍니다(정지)
fault_resetpolicy 는 직접 정하고, pulse_ms 는 드라이브 매뉴얼매뉴얼에 요구가 없으면 0(한 제어 주기)
cia402_profile표준대로 전이하는 드라이브는 뺍니다전원 투입 뒤 not_ready_to_switch_on 에서 Shutdown 명령을 받는 드라이브는 그 행을 넣은 표를 적습니다(cia402_profile)
approval적지 않습니다벤치가 씁니다(7절)

3. 파일을 검사합니다​

드라이브 없이 파일만 검사합니다.

plem drive check "$HOME/drives/my_drive.yaml"

거부되면 키 경로와 고치는 방법을 알려 줍니다. 메시지의 schema §4.1 은 드라이브 모델 파일의 같은 번호 절입니다. 버스가 기동할 때 거부할 파일도 드라이브 없이 거부합니다. 모드의 필수 PDO 객체가 매핑에 없거나 한 채널을 두 축이 쓰는 경우 등입니다.

통과하면 버스, 축, 승인 상태, 경고, 다음 할 일을 보여 줍니다. 경고는 파일을 거부하지 않고 종료 코드도 바꾸지 않습니다. 스크립트에서는 plem drive check --json <파일> 을 씁니다. 필드와 경고는 plem drive check 출력에 있습니다.

종료 코드뜻
0파일이 주장한 승인 상태가 그대로 성립합니다
1파일이 거부됐거나, 주장한 승인이 성립하지 않습니다(이유는 stderr 또는 approval: 아래)
2명령 사용법이 틀렸습니다

check 를 통과해도 기동이 통과한 것은 아닙니다. --json 출력의 not_judged 에 버스가 기동할 때 판정하는 것이 나옵니다. 스캔한 슬레이브의 매핑, 실물 드라이브 식별(시리얼, revision number, 0x1009, 0x100A, 스캔한 매핑), 제어 주기 대비 fault reset 간격, DC 규칙입니다.

4. 버스를 띄웁니다​

plem drive run "$HOME/drives/my_drive.yaml"

버스는 띄운 터미널에서 /<bus.name> 네임스페이스로 돕니다. 예제는 /my_drive 입니다. 버스 이름을 바꿔도 승인은 유지됩니다. 모션 승인이 없는 파일이면 먼저 벤치를 제안합니다(7절). PREEMPT_RT 커널이 아니거나, CPU 격리가 없거나, Jetson 기기의 nvpps PTP-TSC 잠금이 켜져 있으면 경고만 하고 띄웁니다.

다음 줄이 나온 뒤에 움직이세요. every slave in OP (working counter complete) … s after the loop started. 60초 안에 OP 상태에 들지 않은 슬레이브가 있으면 버스를 세우고 기동에 실패합니다. Ctrl-C 키를 누르면 모든 축을 세운 뒤 버스를 놓습니다.

축의 모드가 컨트롤러를 정합니다. csp 축은 joint_trajectory_controller, 스트림 축은 stream_controller 입니다. 옵션, 기동 순서, 인터페이스 이름은 plem drive run과 ROS 인터페이스에 있습니다.

버스가 둘이면 마스터마다 plem drive run 을 하나씩 띄우고, bus.name·--master·--rt-cpu 를 서로 다르게 줍니다. 격리된 CPU 코어가 하나뿐이면 둘째 루프는 격리되지 않은 코어에서 돌아 지터가 늘 수 있습니다. 로봇 스택이나 다른 프로그램이 같은 마스터를 쓰고 있으면 기동에 실패합니다.

매 주기 기록 보기(PlotJuggler)​

plem drive run "$HOME/drives/my_drive.yaml" --plot

rt_raw 는 최대 40 주기를 한 메시지로 묶으므로, 그대로 그리면 메시지마다 한 점만 나옵니다. --plot 은 한 주기씩 /my_drive/rt_raw/samples 로 다시 내는 중계 노드를 띄우고(메시지마다 그 주기의 RT 시각), 이 버스의 축으로 만든 레이아웃으로 PlotJuggler 창을 엽니다. 중계 노드는 보통 스케줄링으로 돌고 제어 루프는 건드리지 않습니다. 둘 다 버스와 함께 끝납니다.

레이아웃의 탭은 넷입니다. 위치(축마다 그래프 칸 하나: actual_position, applied_command, command_position), 속도와 토크, 타이밍(loop_exec_us, loop_jitter_us), 버스(wkc_mismatch, deadline_miss, dc_sync_monitor_ns)입니다.

  • 처음 띄우면 몇 가지를 묻는 대화 상자가 뜰 수 있습니다. 지난번 스트리밍 플러그인 재시작은 Yes, 구독 창에서는 /<bus.name>/rt_raw/samples 를 고르고 header stamp 사용을 켠 채로 두고, 없는 곡선은 빈 자리표시자를 만드는 쪽을 고릅니다. 시각 기준은 header.stamp 로 두세요. 끄면 한 묶음의 40 주기가 한꺼번에 도착해 점이 몰립니다. 대화 상자의 문구는 PlotJuggler 버전마다 다를 수 있고, header stamp 선택은 실제 버스에서 확인하지 않았습니다.
  • CSV 파일은 PlotJuggler 내보내기 기능으로 만듭니다.
  • dc_sync0 버스에서는 dc_sync_monitor_ns 가 주기마다의 DC 동기 편차입니다. 4294967295 로 튀는 점은 그 주기에 값을 얻지 못했다는 뜻입니다. 기동 직후 수십 초는 편차가 크고, 가라앉은 뒤에도 가끔 튑니다. PLEM 쪽에서는 이 정착을 기다리지 않습니다.
  • 실측 위치·속도·토크만 보려면 중계 없이 /my_drive/joint_states 를 구독하면 됩니다.

PlotJuggler 패키지는 PLEM 설치·업데이트 때 ROS apt 저장소(packages.ros.org)에 닿으면 함께 설치됩니다. 소스 빌드, --no-install-recommends 설치, 그 저장소에 닿지 못한 설치에는 없을 수 있습니다. PlotJuggler 패키지나 plotjuggler_ros 가 없으면 --plot 은 아무것도 띄우기 전에 sudo apt install ros-$ROS_DISTRO-plotjuggler-ros 를 알리고 거부합니다.

버스 타이밍을 터미널에서 보기​

plem drive run <파일> --monitor 는 버스 곁에서 루프 타이밍과 드라이브 상태를 1초에 한 줄씩 찍고, 상태가 바뀌면 따로 한 줄, Ctrl-C 때는 합계를 찍습니다. 칸의 뜻은 --monitor 출력에 있습니다.

5. 해제하고 움직입니다​

해제는 브레이크를 풀고 모든 축을 Operation enabled 상태로 만드는 일입니다(서비스 release_brake, Python API release()). 해제된 축은 명령이 올 때까지 자리를 지킵니다.

Python​

plem.drive 의 Bus 로 떠 있는 버스에 bus.name 으로 붙습니다. 그 이름의 버스가 없으면 제한 시간 뒤 버스 이름을 밝힌 DriveError 를 냅니다.

from plem.drive import Bus, SCurve

with Bus("my_drive") as bus: # 파일의 bus.name
print(bus.axes, bus.positions) # 축 이름, 위치(rad)
bus.reset() # 버스가 지난번 멈출 때 래치된 fault 해제
bus.release() # 해제: 축은 지금 자리를 지킵니다
start = bus.positions
bus.move_to({name: start[name] + 0.5 for name in bus.axes},
velocity_scale=0.2, acceleration_scale=0.2) # 도착해야 반환합니다
bus.move_to(start, profile=SCurve())
bus.stop() # 감속해 세운 뒤 브레이크

스트림 축은 내 제어 루프가 매 주기 명령을 보냅니다(예: 축 j0 하나).

import threading, time
from plem.drive import Bus

with Bus("my_drive") as bus:
command = {"j0": 0.0} # 스트림 축마다 rad/s(csv) 또는 Nm(cst)
running = True

def control(): # 내 제어 루프: 한 번 부를 때마다 한 주기의 명령
while running:
bus.stream(command)
time.sleep(0.005)

loop = threading.Thread(target=control)
loop.start() # 토크 축이 있는 버스는 스트림이 살아 있어야 해제됩니다
try:
bus.reset() # 스트림이 살아 있을 때(끊긴 스트림의 정지는 남습니다)
bus.release()
command["j0"] = 0.3
time.sleep(2.0)
command["j0"] = 0.0
bus.stop()
finally:
running = False # 위에서 예외가 나도 루프를 끝냅니다
loop.join()
  • release() 전에 reset() 을 부르세요. fault_reset.policy: none 이면 fault 상태인 축이 있을 때 release() 가 바로 실패합니다.
  • 스트림을 한 번 보냈다면 release() 와 reset() 동안에도 스레드에서 stream() 을 계속 부르세요.
  • stream() 호출이 멈추면 마지막 호출 뒤 약 100 ms 뒤에 버스가 보호 정지합니다. 스트림 루프는 가볍게 두세요.
  • with 블록을 나가면(Ctrl-C 포함, 어떻게 끝나든) 축을 세웁니다. 해제된 채 두려면 with 없이 Bus(...) 를 만들고 close() 로 끝냅니다.

메서드마다 기다리는 것과 내는 오류는 Python plem.drive에 있습니다.

명령줄​

csp 축은 다른 FollowJointTrajectory 클라이언트로도 움직입니다. MoveIt 역시 이 액션을 쓰지만 이 경로로 돌려 보지는 않았습니다.

토크(cst) 축이 있는 버스는 순서가 정해져 있습니다. 스트림을 먼저 흘리고, 그다음에 해제하세요. 중립은 토크 축 0 Nm, 속도 축 0 rad/s이고, 위치 축은 해제 때의 위치를 지킵니다.

# ① 스트림 축에 중립을 계속 보냅니다 (스트림 축 수만큼. 토크 축 하나라면 0 Nm)
ros2 topic pub -r 200 /my_drive/stream_controller/commands \
std_msgs/msg/Float64MultiArray '{data: [0.0]}'

# ② 다른 터미널에서 해제합니다 (Python 이면 bus.release())
ros2 service call /my_drive/plem_drive/control_command \
plem_rt_msgs/srv/SetControlCommand '{release_brake: true}'
  • 길이가 스트림 축 수와 다르거나 유한하지 않은 값이 든 명령은 받지 않습니다. 그것만 보내면 아무것도 보내지 않은 것과 같습니다.
  • 위치·속도 축만 있는 버스는 해제할 때 명령을 기다리지 않습니다. 해제 전에 쓴 명령은 적용하지 않고, 50 ms 명령 감시는 해제 뒤 첫 명령부터 셉니다.
  • 응답이 success: true 여도 해제가 끝난 것은 아닙니다. status 의 operation_enabled 와 brake_engaged 로 확인하세요(해제 응답).
  • ros2 topic pub 은 값을 YAML 형식으로 읽으므로 1e-05 는 숫자가 아닙니다. 1.0e-05 로 적으세요.
명령 값은 자르지 않습니다

한계를 넘는 위치·속도 명령, 한 주기 이동량보다 멀리 뛰는 위치 명령은 보호 정지를 겁니다. 해제 직후 첫 위치 명령이 한 주기 이동량 안이면 그대로 적용되어 축이 움직입니다. 세부는 명령 검사에 있습니다.

6. 멈춥니다​

움직이는 버스는 bus.stop() 이나 protective_stop 서비스로 세웁니다. FollowJointTrajectory goal 취소로는 서지 않습니다. 정지마다 무슨 일이 일어나는지(감속해 세우는 요청 정지, 곧바로 끄는 정지), 드라이브가 정하는 것, 보호 정지에서 돌아오는 순서는 정지와 보호 정지에서 돌아오기에 있습니다.

7. 벤치와 승인​

모션을 여는 것은 모델 파일 안의 approval 블록 하나입니다. 미승인 파일을 터미널에서 plem drive run 하면 다음 한 줄 뒤에 벤치가 이어집니다.

/home/…/drives/my_drive.yaml is not approved for motion. Starting the drive bench.

벤치는 한 번 묻고([y/N]) 브레이크를 몇 번 풀었다 물립니다. 토크 축이 없는 버스에서는 위치·속도 축을 한 번, 최대 0.5 rad 움직입니다. 통과하면 승인 기록을 모델 파일 안에 쓰고 run 이 버스를 띄웁니다. 보관할 파일은 이것 하나입니다. 통과하지 못하면 파일은 그대로 두고 my_drive.bench.log 를 남깁니다. 그 뒤의 기동은 버스의 드라이브를 기록과 대조합니다.

벤치의 조건, 확인하는 것, 승인이 풀리는 경우, 승인이 증명하지 않는 것은 벤치와 승인에 있습니다. --unapproved 는 승인을 쓰지 않고 어떤 파일이든 벤치 모드로 띄웁니다. 드라이브 앞에 사람이 있을 때만 쓰세요.

지원하지 않는 것​

  • 모드는 cst, csp, csv 셋뿐이고 기동 때 정해집니다. 실행 중 모드 전환, 버스 루프 안의 궤적 보간(폐지된 ramp 블록이 있는 축은 거부), 피드포워드(0x60B1, 0x60B2), 홈잉은 없습니다. Quick stop 기능은 요청 정지의 대비로만 씁니다.
  • 궤적은 호스트가 만듭니다. 위치 축은 궤적 컨트롤러와 plem.drive 가, 스트림 축은 스트림을 보내는 쪽이 만듭니다. cst 는 위치를 유지하지 않습니다.
  • 한 드라이브에 축이 여럿인 것은 8개까지 지원하며 실제 드라이브로 확인하지 않았습니다. 축마다 channel 을 적고, 두 번째 채널의 객체는 +0x800(예: 0x6841)에 있습니다.
  • 드라이브 계층에는 중력 보상도 Freedrive(free_drive)도 없습니다.
  • IO 슬레이브는 붙이지 못합니다. 버스는 파일에 적은 드라이브만 구성하고, 링의 나머지 슬레이브는 구성하지 않은 채(PREOP) 둡니다.
제품이 거부하지 못하는 드라이브

다음은 파일에 적을 키가 없어 제품이 거부하지 못합니다. 맞지 않는 드라이브는 쓰지 마세요.

  • 유지 브레이크는 드라이브가 서보와 함께 직접 여닫는 것만 지원합니다. 0x60FE 디지털 출력으로 여는 브레이크, 외부 브레이크, 브레이크가 없는 축은 지원하지 않습니다.
  • 한 브레이크를 여러 축이 함께 쓰는 드라이브는 쓰지 마세요. 브레이크는 축마다 따로 여닫습니다. 공유를 적을 수도 감지할 수도 없어서, 한 축의 브레이크 동작이 다른 축을 풀 수 있고 그 축은 제품이 모르는 사이에 떨어질 수 있습니다.
  • 엔코더는 절대 엔코더만 됩니다. PLEM 소프트웨어에는 홈잉이 없습니다. zero_offset_count 와 위치 한계는 드라이브가 전원을 넣을 때마다 같은 위치를 보고할 때만 축의 자리를 가리킵니다. 증분 엔코더는 켤 때마다 카운트가 새로 시작하므로 위치 한계가 아무것도 지키지 못합니다. 무한 회전 축(position: null)은 지킬 위치 한계가 없고, 재기동 뒤의 위치도 어차피 상대 좌표입니다.

하드웨어 검증 범위​

plem drive run 은 A6B 두 대의 위치(csp) 축으로 Jetson AGX Orin(JetPack 7.2.1, ROS 2 Jazzy)에서 돌렸습니다. 두 감속기 출력축을 조 커플링으로 연결한 상태와 푼 상태 모두입니다.

파일확인한 것
A6B 예제두 프로필의 이동, 정지, 벤치와 승인, 10분 동안 230번 이동
그 파일의 csv 사본스트림, 스트림 끊김, 벤치
그 파일의 cst 사본1.5 N·m까지의 토크, 스트림 끊김 정지
flip 사본, pdo_mapping: generated 사본벤치와 승인

하드웨어로 아직 확인하지 않은 것입니다.

  • 토크로 결합한 두 축을 함께 돌리기, 1.5 N·m를 넘는 토크
  • --rt-cpu, 한 Jetson 기기의 두 버스
  • cst 축이 있는 버스의 벤치
  • 요청 정지의 Quick stop 대비(RAMP_STOP_TIMEOUT)와 예제의 0x605A = 2
  • example_drive.yaml 그대로, 거부되는 scanned 매핑, A6B 외 드라이브의 generated
  • 빠른 csv 축의 보호 정지, 움직이는 cst 축의 스트림 끊김
  • 움직이던 축의 실측 위치가 한계를 넘는 보호 정지
  • 자동 fault reset(bounded_auto_reset)과 0이 아닌 pulse_ms
  • 한 드라이브의 여러 축, 세 대 이상, A6B 외 드라이브의 DC
  • 1 ms 이외 주기의 SYNC0 shift, 드라이브 쪽 입력 shift(0x1C33)
  • 브레이크를 연 뒤 위치·속도 축이 하중을 버티는 거동