본문으로 건너뛰기

드라이브 모델 파일

서보 드라이브 연결하기에서 쓰는 YAML 파일(schema: cia402_drive/v1)의 키 레퍼런스입니다. plem drive check 나 plem drive run 의 메시지에 schema §4.1 이 나오면 이 페이지의 §4.1 절을 보세요. 버스가 도는 방식, 명령 검사, 정지, 벤치는 드라이브 버스 API 문서에 있습니다. 실제 드라이브로 돌려 본 규칙은 그렇다고 적었고, 그 범위는 하드웨어 검증 범위에 있습니다.

§1 필수 키와 생략​

아래 표에 적은 곳 말고는 모든 키가 필수입니다. 빠진 키는 거부되고, 직접 정해야 하는 값을 기본값이 대신하지 않습니다. 키를 빼는 것이 뜻을 갖는 곳은 다음뿐입니다.

뺀 키뜻
cia402_profile내장 CiA 402 전이표를 씁니다(§4.8)
bus.sync_mode: drive_default 일 때의 dc, fault_reset.policy: none 일 때의 pacing꺼 둔 기능에는 하위 블록을 적지 않습니다. 적으면 거부됩니다
csp·csv 축의 limits.torque_nm, cst 축의 limits.acceleration_rad_s2다른 모드의 키입니다(§4.4). 적으면 거부됩니다
슬레이브의 stored_sdo저장값을 읽지 않습니다(§4.9)
dc 블록의 write_cycle_time0x1C32:02를 쓰지 않습니다(§5)
approval미승인입니다(§6)
mode_display_timingpre_enable 입니다(§4.2a)
factors.position, 위치·속도의 unit값이 하나뿐인 rotary_motor_encoder 입니다(§4.2)
error_code_pdo슬레이브 매핑에 Error code(0x603F)가 있을 때만 그 항목을 씁니다(§4.2)
bus.name로더는 읽지만 plem drive check 와 run 이 거부합니다(§4.5)

값이 없다는 것은 정해진 표기로 적습니다. null 은 error_code_pdo·approval.record·식별값·기계적 끝단이 없는 축(무한 회전 축)의 limits.position 에, [] 는 startup_sdo 와 메일박스 SM 쪽 pdos 에 씁니다. 스키마에 없는 키도 거부되므로 오탈자가 생략으로 읽히지 않습니다. 이 버전이 지원하지 않는 기능(§9)도 거부됩니다.

§2 파일 형식​

로더는 YAML 문법의 좁은 부분집합만 읽습니다.

항목규칙
문서파일 하나에 문서 하나. 맨 앞 --- 하나는 허용. 지시어(%YAML)는 거부
금지 문법anchor·alias(&·*), 모든 명시 태그(!!int 포함), 블록 스칼라(|·>), merge key <<. 중첩은 16단까지
키문자열 키만. 같은 키 두 번은 거부
bool따옴표 없는 true·false 만. yes·on 은 거부
nullnull 만. ~·빈 값은 거부
정수앞자리 0 없는 10진수 또는 0x 16진수. +·_·0X·음의 16진수·1536.0·따옴표는 거부. 음수는 부호 있는 필드(zero_offset_count, dc.sync0_shift_ns)에만. 범위 밖의 값은 감아 돌리지(wrap) 않고 거부
실수-1.5·2e-3 같은 유한값. .5·1.·+1.0·.inf·nan 은 거부. 정수 표기(121)는 받음
문자열숫자·true/false·null 로 읽히는 값(12, true, 0x1f)은 따옴표로 감쌈. 제어 문자는 거부
인코딩·크기UTF-8, 최대 1 MiB

거부 메시지가 가리키는 곳은 이렇습니다.

  • 구문 오류는 줄과 열을, 인코딩 오류는 바이트 위치를 알려 줍니다.
  • 나머지 거부는 파일의 키 경로로 알려 줍니다. 예: slaves[1].axes[0].channel, slaves[0].axes[1].limits.position. ring_position 목록의 드라이브 한 대에 대한 거부는 for the drive at slaves[e].ring_position[copy]: 로 시작합니다.
  • plem drive check --json 은 축 번호를 펼친 순서(axes[i])로 셉니다. PLEM_LOG_LEVEL=debug 로 돌리면 로더가 axes[i] = slaves[s].axes[k] (이름) 대응을 로그에 남깁니다.

§3 전체 모양​

schema: cia402_drive/v1 # §10 — 이 문자열만 받습니다
model: { name: my_drive } # §4.5 — 파일 버전은 주석으로 적습니다
bus: { name: my_drive, cycle_time_ns: 1000000, sync_mode: drive_default } # §4.5, §5
fault_reset: { policy: none, pulse_ms: 0 } # §4.6
# cia402_profile: [...] # §4.8 — 표준과 다르게 전이하는 드라이브만
slaves: # §4.1 — 드라이브마다 한 항목, 1개 이상
- ring_position: 0
vendor_id: 0x00c0ffee
product_code: 0x00001001
pdo_mapping: scanned
startup_sdo: [] # §4.7
axes: # §4.2 — 이 드라이브의 축, 1개 이상
- name: j0
channel: 1
mode: csp # §4.2b — cst | csp | csv, 축마다
mode_display_timing: post_enable # §4.2a
factors:
gear_ratio: 100.0
encoder_resolution: 65536
torque: { unit: scaled_current, counts_per_amp: 50.0, torque_constant: 0.12 }
velocity: { velocity_factor: 1.0 }
flip: false
zero_offset_count: 0
error_code_pdo: null # §4.2 — scanned 매핑이면 적어야 합니다
limits: # §4.4
position: { min_rad: -3.05, max_rad: 3.05 }
velocity_rad_s: 2.6
acceleration_rad_s2: 5.0 # csp·csv 축. cst 축은 대신 torque_nm 을 적습니다
# approval: ... # §6 — 없으면 미승인. 벤치가 씁니다

모양을 보이려는 값이고, 실제 드라이브의 값이 아닙니다.

  • 관절 순서는 파일에 적은 축 순서입니다. 드라이브를 오가며 섞을 수 없습니다(j0 = 드라이브 A, j1 = B, j2 = 다시 A 같은 순서).
  • 버스 하나에 축은 8개까지입니다.
  • 파일은 버스가 뜰 때 한 번 읽습니다. 어떤 설정도 파일 값을 덮어쓰지 않습니다. 바꾸려면 멈추고 다시 띄우세요.
  • 상대 경로는 작업 디렉터리 기준이고 ~ 는 풀지 않습니다. 절대 경로를 쓰세요.

§4 드라이브와 축​

slaves 의 항목 하나는 물리 드라이브 하나(EtherCAT 장치 하나)입니다. 그 axes 의 항목 하나는 CiA 402 축 하나이고, 호스트에는 관절 하나로 보입니다.

§4.1 slaves: 드라이브와 PDO 매핑​

키값
ring_position링 위치(ethercat slaves 의 번호). 순서는 자유이고 같은 값 두 번은 거부. 목록으로 적으면 똑같은 드라이브 여러 대입니다(아래)
vendor_id, product_codeethercat slaves -v 에 나오는 값. 0은 거부. 그 링 위치의 드라이브와 다르면 두 값을 함께 보여 주며 기동을 멈춥니다(the configuration declares vendor 0x… product 0x…, but the slave at that ring position is …). 예제의 vendor 0x00c0ffee가 남아 있으면 plem drive check 가 경고합니다
pdo_mappinggenerated, scanned 또는 매핑 선언(아래)
dc§5
startup_sdo§4.7. 없으면 []
stored_sdo선택, §4.9. 없으면 키를 뺍니다([] 는 거부)
axes이 드라이브의 축. 빈 목록은 거부

pdo_mapping 은 세 가지 중 하나입니다.

값PLEM 동작쓰는 경우
generated축에서 매핑을 만들어 PREOP 상태에서 드라이브에 씁니다매핑 변경을 받고, PLEM 쪽에서 읽고 쓰는 객체만 있으면 되는 드라이브. 드라이브 하나에 축 4개까지
scanned기동 때 드라이브의 지금 매핑을 읽어 필수 항목을 검사하고 그대로 씁니다. 드라이브에 쓰지 않습니다매핑 변경을 받지 않는 드라이브
sync_managers: (매핑 선언)이 매핑을 PREOP 상태에서 드라이브에 씁니다특정 PDO, 또는 다른 객체(터치 프로브, 디지털 입력 등)가 필요한 드라이브

generated. 축마다 채널 순서로, 각 객체를 그 축 채널의 주소로 담습니다.

PDOSM담는 객체
RxPDO 0x1600 + 채널 − 1SM 2, watchdog 켬Controlword(0x6040), Modes of operation(0x6060), 모드의 목표(cst 0x6071 · csp 0x607A · csv 0x60FF)
TxPDO 0x1A00 + 채널 − 1SM 3Statusword(0x6041), Modes of operation display(0x6061), 위치·속도·토크 실제값(0x6064·0x606C·0x6077), Error code(0x603F)

채널별 PDO 번호는 CiA 402 규칙이 아니라 PLEM 자체 규칙을 따릅니다. 이 번호를 받지 않는 드라이브는 PREOP→SAFEOP 전이에서 거부합니다. 그런 드라이브는 매뉴얼이 허용하는 매핑을 선언하거나 scanned 를 쓰세요. generated 는 A6B 두 대(csp)에서 실제로 돌려 봤습니다.

scanned.

  • 필수 항목이 빠져 있으면 활성화 전에 거부합니다. 메시지에 드라이브, 리비전, 빠진 항목이 나옵니다.
  • 따옴표 친 "scanned", null, 빈 목록은 거부됩니다.
  • 기동 로그 INFO 줄에 매핑 요약과 sha256:… 값이 남습니다. PLEM_LOG_LEVEL=debug 로 띄우면 매핑 전문도 남습니다. 그 전문을 pdo_mapping: 아래에 들여쓰기만 맞춰 붙이면 같은 매핑의 선언이 됩니다.

매핑 선언.

pdo_mapping:
sync_managers:
- { sm: 0, direction: output, watchdog: false, pdos: [] } # 메일박스 SM 은 pdos: []
- { sm: 1, direction: input, watchdog: false, pdos: [] }
- sm: 2
direction: output # output = 마스터→드라이브(Rx), input = 드라이브→마스터(Tx)
watchdog: true
pdos:
- index: 0x1600
entries:
- { index: 0x6040, subindex: 0, bits: 16 }
- { index: 0x0000, subindex: 0, bits: 8 } # index 0 = 폭만큼 자리를 차지하는 빈칸
- { index: 0x6071, subindex: 0, bits: 16 }
- sm: 3
direction: input
watchdog: false
pdos: [ ... ]
  • SM 개수는 4개까지, SM 당 PDO 4개까지, PDO 당 항목 16개까지입니다. 빈 sync_managers 와 빈 entries 는 거부됩니다.
  • 항목 주소는 절대 주소입니다(§4.3).
  • 출력 SM 중 watchdog: true 가 하나도 없으면 거부됩니다. watchdog 시간은 드라이브 기본값(ESI)이며 PLEM 쪽에서 정하지 않습니다. PLEM 프로세스가 죽었을 때 이 watchdog 기능이 드라이브를 멈춘다는 것은 전제이며 측정하지 않았습니다. scanned 드라이브는 자기 SM 설정을 그대로 쓰므로 이 검사를 하지 않습니다.

generated 와 선언 매핑에 필수 항목(공통 항목과 모드의 목표)이 다 있는지, 주소가 겹치지 않는지는 plem drive check 가 드라이브 없이 판정하고, 버스도 기동 때 같은 판정을 합니다. scanned 매핑은 기동 때만 판정합니다.

똑같은 드라이브 여러 대. 드라이브·모터·감속기·설정이 같으면 링 위치를 목록으로 적어(ring_position: [0, 1]) 한 항목으로 씁니다.

  • 드라이브마다 다른 것은 축의 name·flip·zero_offset_count 뿐입니다. 이 셋은 링 위치 수만큼 목록으로 적습니다(name: [axis0, axis1]).
  • 나머지 키는 모두에 똑같이 적용됩니다. 하나라도 다른 드라이브는 따로 적습니다.
  • 로더가 목록을 펼치므로 digest·승인 기록은 한 대씩 적은 파일과 같습니다. check --json 과 debug 로그의 slaves[k] 는 펼친 뒤의 순서입니다.

§4.2 axes​

키값
namejoint_states 의 관절 이름. 규칙은 §4.5
channel드라이브 안의 몇 번째 CiA 402 축인지(1–8). n번 채널의 객체 주소는 1번 채널보다 (n − 1) × 0x800 큽니다. 0x6000–0x9FFF를 0x800 블록 8개로 나누는 CiA 402 배치입니다
modecst(토크), csp(위치), csv(속도). §4.2b
mode_display_timingpre_enable(기본값) 또는 post_enable. §4.2a
factors단위 환산. 아래 표
fliptrue 면 드라이브와 주고받는 값의 부호를 PLEM 안에서 뒤집습니다. 드라이브의 Polarity(0x607E)는 쓰지 않습니다
zero_offset_count관절 0 rad 일 때의 드라이브 위치 카운트(부호 있는 32비트). 드라이브가 보고하는 값 그대로이고 flip 을 먼저 적용하지 않습니다. 드라이브의 Home offset(0x607C)·Position offset(0x60B0)과는 별개이며, 이 두 객체는 PLEM 쪽에서 쓰지 않습니다
error_code_pdonull(드라이브가 오류 코드를 매핑하지 않음) 또는 { index, subindex, bits }
limits안전 한계. §4.4

error_code_pdo:

  • 빼면 Error code(0x603F)를 씁니다. 뺄 수 있는 것은 generated 매핑이거나, 그 축 채널의 0x603F를 담은 선언 매핑일 때뿐입니다. scanned 매핑(기동 때에야 읽음)과 0x603F가 없는 선언 매핑은 적어야 합니다.
  • index 는 2번 채널 축이라도 1번 채널의 주소(0x603F)로 적습니다(§4.3).
  • index: 0 은 거부됩니다. 선언하지 않으려면 null 을 적습니다.

factors. 위치·속도의 unit 은 값이 하나뿐이라 빼도 되고, 나머지 키는 모두 필수입니다.

  • 로더는 단위 이름과 수가 양수인지만 봅니다. 값이 틀려도 파일은 통과합니다.
  • 기어비와 엔코더 분해능은 축마다 한 번 적고, 토크·위치·속도 환산이 모두 그 값을 씁니다.
  • 이 환산은 PLEM 안에서 합니다. 드라이브의 Factor group 객체(0x608F–0x60A9)는 쓰지 않습니다.
  • PLEM 안에서 토크는 늘 Nm 단위이고, 통신 경계에서 한 번만 드라이브의 숫자로 바꿉니다. 그 숫자의 뜻을 torque.unit 으로 적습니다.
키뜻
torque.unit드라이브가 토크(0x6071·0x6077)를 세는 단위. 단위마다 적는 키가 다르고, 다른 단위의 키는 거부됩니다. scaled_current: CiA 402 밖의 벤더 전류 카운트. 카운트 = τ × counts_per_amp ÷ (torque_constant × gear_ratio). rated_per_mille: CiA 402 단위로, 한 카운트가 모터 정격 토크(0x6076)의 1/1000. 카운트 = τ × 1000 ÷ (motor_rated_torque_nm × gear_ratio)
torque.counts_per_amp(scaled_current) 암페어당 전류 카운트. 드라이브 매뉴얼의 값
torque.torque_constant(scaled_current) 모터 토크 상수 Nm/A. 모터 명판의 값
torque.motor_rated_torque_nm(rated_per_mille) 모터축 기준 정격 토크 Nm. 드라이브의 0x6076은 mNm 단위이므로 1000으로 나눠 적습니다(0x6076이 1270이면 1.27)
gear_ratio출력축 한 바퀴당 모터 회전 수. 감속기가 없으면 1.0. 축 값(limits·명령·joint_states)은 출력축 기준 rad·rad/s·Nm 단위입니다. 드라이브 값(startup_sdo·stored_sdo·zero_offset_count·dc)은 드라이브 매뉴얼의 원시 값이고 감속비를 타지 않습니다. 감속기를 바꾸면 이 값과 축 값을 함께 고칩니다
position.unit, velocity.unitrotary_motor_encoder 만. 위치 카운트 = rad × encoder_resolution × gear_ratio ÷ 2π
encoder_resolution모터 한 바퀴당 위치(0x6064) 카운트, 정수. 드라이브의 전자 기어가 1:1 일 때만 모터의 엔코더 분해능과 같습니다
velocity.velocity_factor속도 카운트 하나에 해당하는 위치 카운트 수(1.0 = 같은 단위). 드라이브 매뉴얼의 0x606C 단위에서 얻습니다. 틀리면 속도 한계와 joint_states 속도가 조용히 어긋납니다
경고
motor_rated_torque_nm 이 틀리면 모든 토크가 어긋납니다

모든 토크 명령과 측정 토크가 같은 비율로 어긋납니다. 값이 크면 명령이 약해지고, 작으면 명령이 세져 드라이브 토크 범위 끝까지 갈 수 있습니다.

벤치가 0x6076을 한 번 읽어 이 값과 1 %(최소 1 mNm) 넘게 다르면 경고하고, 그 경고를 승인 기록(conditions.notes)에 남깁니다. 벤치는 멈추지 않습니다. 객체가 없거나 값이 0·0xFFFFFFFF이거나 읽기에 실패하면 대조하지 않습니다.

§4.2a mode_display_timing​

드라이브가 0x6061(표시 모드)을 0x6060(요청 모드)에 언제 맞추는지 적습니다.

값드라이브 동작
pre_enable(뺐을 때)enable 전에 맞춥니다
post_enable처음 enable 할 때까지 0x6061이 0입니다

pre_enable 이 더 엄격합니다. 0x6061이 선언한 모드를 보여야 해제를 받습니다. 쉬는 동안 0x6061이 0이고 enable 한 뒤에야 모드를 보이는 드라이브는 MODES_OF_OPERATION_MISMATCH(표시값 0)로 거부되고, Bus.release 와 벤치의 거부 문장이 post_enable 을 적으라고 알려 줍니다. CiA 402 규격이 정하지 않은 드라이브 특성이며 고장이 아닙니다. 키를 빼면 pre_enable 을 적은 파일과 digest 값이 같고, 값을 바꾸면 승인이 풀립니다.

§4.2b mode​

mode 는 그 축의 0x6060 값입니다: cst 10 · csp 8 · csv 9. 축마다 정하고 한 버스에 섞어도 됩니다. 기동부터 매 주기 보내며 실행 중에는 바뀌지 않습니다.

모드명령 단위plem drive run 의 컨트롤러중립 명령
cstNm스트림 컨트롤러0 Nm
csprad궤적 컨트롤러그 주기의 실측 위치
csvrad/s스트림 컨트롤러0 rad/s
  • 위치·속도는 zero_offset_count 기준의 관절 좌표입니다. flip 은 드라이브와 값을 주고받는 경계에서 한 번 적용됩니다.
  • 버스는 모드를 info 의 modes_of_operation 으로 알리고, plem drive check 는 축마다 보여 줍니다(--json 에서는 axes[i].mode).
  • 명령은 모든 축이 Operation Enabled 상태이고, 보호 정지가 없고, 모든 축의 명령이 검사를 통과한 주기에만 드라이브로 나갑니다. 그 밖의 주기에는 모든 축이 중립 명령을 받습니다.
  • csp·csv 명령은 자르지 않습니다. 한계를 넘으면 보호 정지입니다. cst 토크는 limits.torque_nm 으로 자릅니다. 검사 내용과 해제 직후의 동작은 명령 검사에 있습니다.
  • plem drive check --json 이 axes[i].velocity_cap_rad_s 를 보여 줍니다. csp 축에서는 속도 한계에서 제어 주기당 위치 카운트 하나(무한 회전 축은 둘)를 뺀 값이고, plem drive run 은 궤적을 이 속도 이하로 계획합니다.

§4.3 주소 세 가지​

위치적는 주소예: 2번 채널의 객체
pdo_mapping 항목의 index절대 주소statusword 0x6841
error_code_pdo.index1번 채널의 주소. 채널 오프셋은 자동으로 더해집니다0x603F(0x683F 가 아님)
startup_sdo·stored_sdo 의 index절대 주소2번 채널의 모드는 0x6860

error_code_pdo 에 0x683F 를 적으면 채널 오프셋이 더해져 0x703F 를 찾게 되고, 그 주소가 매핑에 없으면 검사가 거부합니다.

§4.4 limits: 안전 한계​

한계에는 기본값이 없고, 값이 맞는지는 파일을 쓰는 사람의 책임입니다. 로더는 모양만 봅니다. 검사는 PLEM 안에서 합니다. 드라이브 자체의 한계 객체는 쓰지 않습니다. 소프트웨어 위치 한계 0x607D, 속도 0x607F·0x6080, Max torque 0x6072, 정지 감속 0x6084·0x6085가 그 객체입니다.

키단위거부 조건넘으면
position: { min_rad, max_rad } 또는 null출력축 rad, zero_offset_count 기준유한하지 않음, min ≥ max. null 인데 zero_offset_count 가 0이 아님보호 정지 + 브레이크 강제 체결
velocity_rad_s출력축 rad/s유한하지 않음, 0 이하보호 정지 + 브레이크 강제 체결
acceleration_rad_s2출력축 rad/s². csp·csv 축만, 거기서는 필수csp·csv 축에서 빠짐·0 이하. cst 축에 적음한계가 아니라 요청 정지의 감속입니다
torque_nm: { min, max }출력축 Nm. cst 축만cst 축에서 빠짐, 유한하지 않음, min < 0 < max 조건을 어김. csp·csv 축에 적음cst 명령을 그 범위로 자릅니다
  • acceleration_rad_s2: 축이 실제로 낼 수 있고 드라이브의 0x6085(Quick stop deceleration)를 넘지 않는 값을 적습니다. digest 계산에 들어가므로, 이 키가 생기기 전에 승인한 csp·csv 파일은 키를 더하고 다시 벤치합니다.
  • torque_nm: csp·csv 축은 토크 명령을 보내지 않습니다. 그 축의 토크는 드라이브 안의 루프가 내고, 드라이브의 0x6072가 묶습니다.
  • 위치 한계 밖에서 멈춘 축은 해제되지 않습니다.
  • limits.position 이 이 zero_offset_count·flip 으로 드라이브의 32비트 위치가 나타낼 수 있는 각도를 넘으면 plem drive check 가 경고합니다. 그 바깥의 한계는 지켜지지 않습니다.
  • 유한한 한계를 둔 축에서 위치가 32비트 관절 카운트로 표현되지 않으면(아주 큰 zero_offset_count 에서 카운트가 끝에 닿은 경우) 보호 정지가 걸리고, 표현될 때까지 reset 요청이 거부됩니다. 그 동안의 위치는 축이 움직여도 한 값이라 한계를 판정할 수 없기 때문입니다.

실제 드라이브(A6B)에서는 범위 밖 위치 명령, 기동 때 이미 범위 밖인 축, 실측 속도 초과, 한계를 넘는 csv 명령의 정지를 확인했습니다. 움직이던 축이 위치 한계를 넘는 경우는 확인하지 않았습니다.

전제. 파일에 적을 키가 없어 로더가 어긋나는 드라이브를 거부하지 못합니다.

전제쓰면 안 되는 것
브레이크가 전원 결합이고, disable 뒤 하중을 붙잡습니다0x60FE 출력 브레이크, 외부 브레이크, 브레이크 없음
축마다 브레이크가 따로 있습니다브레이크 하나가 여러 축을 함께 푸는 드라이브. 벤치 승인 대상도 아닙니다
엔코더가 절대값입니다증분 엔코더(아래)
위치 한계는 절대값 엔코더를 전제합니다

PLEM 소프트웨어에는 홈잉이 없습니다. zero_offset_count 와 위치 한계는 드라이브가 전원을 넣을 때마다 같은 위치를 보고할 때만 제자리를 가리킵니다. 증분 엔코더는 켤 때마다 카운트를 새로 시작하므로 한계가 아무것도 지키지 못합니다. 엔코더 종류를 적을 키가 없어 로더도 벤치도 거부하지 못합니다. 그런 드라이브는 쓰지 마세요. 무한 회전 축(아래)은 지킬 위치 한계가 없습니다.

무한 회전 축​

출력축이 한 방향으로 계속 도는 축은 position: null 과 zero_offset_count: 0 을 적습니다. 모드는 무엇이든 됩니다.

zero_offset_count: 0
limits: { position: null, velocity_rad_s: 20.0 } # cst 축이면 torque_nm 도 적습니다

드라이브가 보낸 위치를 PLEM 쪽에서 프레임마다 따라가며 넘어간 바퀴를 셉니다.

상황한계결과
속도속도 한계는 그대로 필요하고 끌 수 없습니다넘으면 보호 정지
드라이브의 32비트 카운트가 끝을 넘음없음joint_states 와 명령의 위치가 끊기지 않고 이어집니다. 속도·토크는 영향이 없습니다
PLEM 재시작저장해 두는 원점이 없음드라이브 값부터 다시 셉니다(23비트 엔코더·기어비 1이면 약 ±1608 rad 안). 위치 축은 그때의 위치를 기준으로 명령하세요
PLEM 시작 뒤 한 방향 순이동2⁴⁸ 카운트(23비트 엔코더면 모터 약 3,350만 회전. 400 rad/s 속도면 약 6일, 20 rad/s 속도면 약 122일)보호 정지(LIMIT_STOP 사유 3)이고, PLEM 재시작 전까지 reset 요청이 거부됩니다. 이를 넘는 위치 명령은 사유 7
프레임을 받지 못하는 사이의 이동2³¹ 카운트 미만(23비트 엔코더면 모터 256 회전, 6000 rpm 속도면 2.56초)넘으면 보고 위치가 2³² 카운트의 배수만큼 어긋납니다. 이 어긋남은 감지되지 않습니다
좌표를 바꾸는 정비(원점 복귀, 다회전 클리어, 드라이브 설정 도구 조작, 전자 기어·극성 변경)정지 상태에서 하고, 끝나면 PLEM 재시작움직임과 구분하지 못하고 그대로 셉니다

드라이브 쪽에서 맞춰 둘 조건입니다. PLEM 쪽에서는 검사하지 않습니다.

조건방법
드라이브 위치가 32비트 전 범위로 돕니다드라이브 위치 범위 0x607B를 좁히지 않고, 벤더 고유의 연속 회전 절대 모드를 쓰지 않습니다
위치 목표 0x607A가 넘어가는 것을 연속 이동으로 받습니다드라이브 매뉴얼
드라이브의 소프트웨어 위치 한계 0x607D가 꺼져 있습니다0x607D는 PLEM 쪽에서 쓰지 않습니다. 기대값을 stored_sdo 에 적어 두면 기동 때 다르면 경고합니다(아래 A6B 예)
32비트 범위를 넘게 이동한 뒤에도 다음 기동이 됩니다아래 경고와 드라이브 매뉴얼(A6B: SX-DSV03242 R10.1, p.261·p.100-101)
stored_sdo: # A6B: 소프트웨어 위치 한계 끔 (607Dh-01h >= 607Dh-02h)
- { index: 0x607D, subindex: 1, size: 4, value: 0 }
- { index: 0x607D, subindex: 2, size: 4, value: 0 }
다음 기동에서 멈추는 드라이브

다회전 절대값 엔코더 드라이브는 전원 투입 같은 초기화 때 엔코더에서 위치를 다시 만듭니다. 한 방향으로 32비트 범위(23비트 엔코더·전자 기어 1:1이면 모터 약 ±256 회전)보다 멀리 간 뒤에는 카운터 넘침 알람으로 기동하지 않는 드라이브가 있습니다. 엔코더는 늘 바퀴를 세므로 운전 모드(csp·csv·cst)와 상관없습니다.

그런 드라이브는 다음 중 하나를 합니다.

  1. 엔코더를 증분 모드로 씁니다.
  2. 32비트 전 범위 순환(wrap)은 유지하면서 넘침만 무시하는 설정을 켭니다. A6B 드라이브는 Pr6.98 bit 3 = 1이며, 기능 확장 버전 3 이후에 있습니다. 전자 기어에 따라 전원을 다시 넣은 뒤 위치가 끄기 전과 다를 수 있습니다(매뉴얼 SX-DSV03242 R10.1, p.255-256).
  3. 둘 다 없으면 위치 한계를 둬 그 범위 안에서만 움직이게 합니다.

실제 A6B 두 대로 32비트 경계를 여러 번 넘겨 봤을 때 위치·명령이 끊기지 않았습니다. 다만 Pr6.98 bit 3 = 0(공장값)인 그 드라이브들은 다음 기동을 Err29.1 알람으로 거부했습니다.

정지할 때, 그 실행에서 센 위치(기동 때 드라이브 값에서 시작)가 32비트 범위 밖에서 끝난 축마다 경고가 한 번 남습니다. 앞선 실행의 넘김, 드라이브 자체 오프셋, 1:1이 아닌 전자 기어는 보지 못하므로 경고가 없다고 다음 기동이 보장되지는 않습니다.

§4.5 이름​

키규칙
model.name1–31바이트(UTF-8 바이트 기준). 공백만으로는 안 되고 제어 문자도 안 됩니다. 길면 자르지 않고 거부합니다
axes[].name[a-z_][a-z0-9_]*, 31바이트 이하, 파일 안에서 중복 금지. joint_states 의 관절 이름이 됩니다
bus.name영문·숫자·_ 만, 숫자로 시작하지 않고 64바이트 이하. plem drive run 은 버스를 /<name> 네임스페이스에 띄우고, Python 클라이언트는 Bus("<name>") 로 붙습니다. 이 키가 없는 파일은 plem drive check 와 run 이 거부합니다. digest 계산에 들어가지 않아 이름을 바꿔도 승인이 유지됩니다

§4.6 fault_reset​

버스 전체에 한 번 정합니다.

policypacing
none적지 않습니다
bounded_auto_reset{ interval_ms, max_attempts } 필수. interval_ms > 0, max_attempts 1–10000

max_attempts 는 횟수 상한일 뿐이고, 그 횟수까지 안전하다는 뜻이 아닙니다. interval_ms 는 제어 주기의 횟수로 나타낼 수 있어야 하며, 이것은 기동 때 판정합니다.

pulse_ms(필수, 0–1000)는 fault reset 한 번에 controlword bit 7을 켜 두는 최소 시간(ms)입니다.

  • policy 와 상관없이 reset_error 요청과 자동 reset 모두에 씁니다.
  • 제어 주기로 올림한 프레임 수(최소 1)가 되므로 0 은 한 제어 주기입니다. 드라이브 매뉴얼이 유지 시간을 요구하면 그 값을 적습니다.
  • 축이 fault 상태를 벗어난 프레임에서는 시간이 남아도 bit 7을 내립니다.
  • PLEM 쪽에서 보장하는 것은 보내는 controlword 형태뿐입니다. 드라이브가 reset 됐는지는 status 로 확인합니다.

§4.7 startup_sdo​

기동 때 드라이브에 차례로 쓰는 SDO 목록입니다.

startup_sdo:
- { index: 0x6098, subindex: 0, size: 1, value: 35 }
  • 드라이브마다 16개까지입니다. 적은 순서와 반복을 그대로 지키며, 합치거나 정렬하지 않습니다.
  • size 는 1·2·4 바이트입니다. value 는 그 폭의 부호 없는 값(0 ≤ value < 2^(8 × size))이고 음수는 받지 않습니다.
  • index 는 절대 주소입니다(§4.3).
  • 전원을 켤 때만 적용되는 파라미터는 켠 뒤에 써도 소용이 없습니다. 드라이브가 갖고 있어야 할 값은 stored_sdo 에 적으세요.

PLEM 소프트웨어가 쓰거나 파일의 다른 키가 정하는 객체는 거부됩니다.

객체정하는 곳
PDO 배정·매핑(0x1C10–0x1C2F, 0x1600–0x17FF, 0x1A00–0x1BFF)pdo_mapping
동기 객체(0x1C32·0x1C33)sync_mode 와 dc. 이 중 PLEM 쪽에서 쓰는 것은 dc.write_cycle_time 의 0x1C32:02 뿐입니다
축마다(채널 주소로): controlword 0x6040, 모드 0x6060, 목표값 0x6071·0x607A·0x60FFPLEM, mode
축마다: 한계 0x607D·0x6072·0x6080, Home offset 0x607Climits, zero_offset_count. 이 객체들은 PLEM 쪽에서 쓰지 않습니다. 한 값의 출처가 파일 안에 둘 생기지 않게 거부할 뿐입니다

그 밖의 객체는 받아들이며, 무엇을 하는지는 파일을 쓰는 사람의 책임입니다. 미승인 파일도 기동 때 쓰고, 쓴 것을 로그에 전부 남깁니다. 드라이브가 쓰기를 거부해도 그 원인이 startup_sdo 라고 짚어 주지는 않습니다.

쓴 값은 PLEM 종료 뒤에도 드라이브에 남습니다

드라이브 RAM 안에 남아 전원을 다시 넣을 때까지 갑니다. 다른 파일로 바꿔 띄우면 그 값을 그대로 물려받습니다. A6B 드라이브에서는 앞선 시험 파일이 낮춰 둔 토크 한계와 위치 편차 한계가 남아, 다음 파일의 평범한 이동이 위치 편차 알람(Err24.0)으로 멈췄습니다. 쓰는 객체가 적은 파일로 바꿀 때는 드라이브 전원을 다시 넣으세요.

§4.8 cia402_profile​

이 키를 빼면 모든 축이 내장 전이표를 씁니다. CiA 402 표준 전이의 부분집합 12행이고, 표준 밖의 행은 없습니다.

화살표의 값은 PLEM 쪽에서 보내는 controlword 값입니다. fault reset 신호는 따로 보내므로(bit 7, §4.6) fault 행이 없습니다. switch_on_disabled 에서 나가는 행(Shutdown)과 들어가는 행(Disable voltage)은 표준에서 가져온 것이고 실제 드라이브로 확인하지 않았습니다.

표준과 다르게 전이하는 드라이브만 최상위에 행 목록을 적습니다. 파일에 하나이고 모든 축에 적용됩니다. 예를 들어 전원 투입 뒤 not_ready_to_switch_on 에서 Shutdown 명령을 받아 ready_to_switch_on 으로 가는 드라이브는 내장 표 앞에 그 행을 더한 13행 표를 적습니다.

cia402_profile:
- { from: switch_on_disabled, to: ready_to_switch_on, controlword: 0x0006 }
- { from: ready_to_switch_on, to: switched_on, controlword: 0x0007 }
# …
  • 상태 이름: not_ready_to_switch_on · switch_on_disabled · ready_to_switch_on · switched_on · operation_enabled · quick_stop_active · fault_reaction_active · fault.
  • 16행까지입니다. 빈 목록과 null 은 거부됩니다. 내장 표를 쓰려면 키를 뺍니다.
  • 검사는 표의 모양(중복, 필수 전이, controlword 값이 목적지로 가는지)만 봅니다. 드라이브가 실제로 그렇게 전이하는지는 보장하지 않습니다.
  • csp·csv 축에는 요청 정지에 쓰는 operation_enabled → quick_stop_active(0x0002) 행이 있어야 하고, 없으면 거부됩니다.
  • 키를 빼면 plem drive check --json 에 profile_source: built_in 이 나옵니다. 업데이트로 내장 표가 바뀌면 이 키를 뺀 파일의 승인이 풀립니다(§6).

§4.9 stored_sdo​

드라이브에 저장돼 있어야 할 값의 목록입니다(선택). 버스가 기동할 때 값마다 한 번 읽고, 다르면 경고를 남깁니다. 이 값을 쓰거나 저장하지는 않으며, 값이 다르거나 읽지 못해도 기동을 막지 않습니다. 원소의 모양은 startup_sdo 와 같습니다.

stored_sdo:
- { index: 0x3401, subindex: 0, size: 4, value: 0 }
- { index: 0x3015, subindex: 0, size: 2, value: 2 }
  • size·value 는 startup_sdo 규칙을 따릅니다. 음수는 그 폭의 2의 보수를 16진수로 적습니다. 드라이브마다 16개까지이고, 필요 없으면 키를 뺍니다([] 는 거부).
  • 거부되는 것은 형식 오류뿐입니다: 한 드라이브에 같은 주소 두 번, 같은 드라이브의 startup_sdo 가 쓰는 주소. startup_sdo 로 쓴 값은 다음 전원 재투입까지 RAM 안에 남아 읽어도 알 수 있는 것이 없으니, startup_sdo 로 옮긴 객체는 여기서 뺍니다.
  • 출력 PDO 안에 매핑된 객체(마스터가 매 주기 보냄)와 PDO 매핑·배정 객체(0x1600–0x17FF, 0x1A00–0x1BFF, 0x1C10–0x1C2F)는 읽지 않고 하나마다 경고합니다. 0x1C32·0x1C33에는 드라이브가 운전 중 채우는 항목이 있으니 저장 설정 항목만 적습니다.
  • 일치해도 값이 저장됐거나 적용됐다는 뜻은 아닙니다. 지금 값만 읽습니다. 써 놓고 저장하지 않은 값은 다음 전원 재투입까지 일치로 나옵니다.
  • 승인과 무관합니다. 승인된 파일의 stored_sdo 를 고쳐도 승인이 유지되고, 승인은 이 목록도, 벤치 때 드라이브가 가졌던 값도 보증하지 않습니다.
  • plem drive check 는 버스를 읽지 못하므로 형식만 검사합니다.

값이 다르다는 경고에는 두 갈래가 함께 적힙니다.

맞는 쪽할 일
파일(드라이브 매뉴얼이 그 객체를 쓰고 저장할 수 있다고 할 때)PLEM 프로세스를 멈춘 채로 드라이브 전원을 껐다 켜고, 값을 쓰고, 드라이브가 CiA 301 저장(0x1010:01)을 지원하면 저장합니다(드라이브 매뉴얼 참조). 전원을 켤 때 적용되는 객체면 다시 껐다 켭니다. 저장은 보통 드라이브가 그 순간 가진 저장 가능한 값을 전부 저장하므로, 먼저 껐다 켜야 지난 기동의 startup_sdo 값이 함께 저장되지 않습니다
드라이브(예: 이 기계에서 튜닝한 값)파일의 stored_sdo 를 고칩니다

읽기 때문에 기동이 기다릴 수 있습니다.

  • PLEM 쪽에는 자체 타임아웃이 없습니다. 전송이 시작되면 EtherCAT 마스터의 CoE 처리만 대기를 묶으므로, 다른 mailbox 응답을 계속 보내는 드라이브는 기동을 붙잡을 수 있습니다.
  • SDO abort 없이 실패한 읽기(무응답, CoE 미지원 드라이브, mailbox 오류)는 0.1·0.3·0.5초 뒤에 다시 읽습니다. 네 번째도 실패하면 그 드라이브의 나머지 값은 읽지 않습니다.
  • 직전 정지 뒤 곧바로 다시 기동하면 읽기가 실패할 수 있습니다. EtherCAT 마스터(IgH 1.6.13)가 드라이브가 PREOP 상태에 든 지 3초 뒤부터 같은 mailbox 채널로 SDO 사전을 한 번 읽기 때문입니다. 겹친 읽기는 경고에 ret=-5(mailbox 오류)가 찍힙니다. 기동은 그대로 진행됩니다. 비교가 필요하면 버스를 잠시 쉬게 한 뒤 다시 기동하세요.

§4.10 요청 정지​

cst 축이 없는 버스에서 해제 중일 때 protective_stop 과 실행의 끝(plem drive run 터미널의 Ctrl-C)은 축을 limits.acceleration_rad_s2 로 먼저 감속한 뒤 브레이크를 물립니다. 제때 확인되지 않으면 드라이브 자체 Quick stop 단계로 넘어가고 보호 정지가 걸립니다. 그 밖의 정지는 곧바로 disable 합니다. 진행 순서, 시간, 이벤트는 드라이브 버스 API 문서에 있습니다.

이 정지를 위해 파일에 적을 값입니다.

값적는 곳
드라이브의 0x6085를 넘지 않는 감속모든 csp·csv 축의 limits.acceleration_rad_s2(§4.4)
드라이브의 Quick stop 감속 0x6085와 option code 0x605A(정지 뒤 드라이브가 스스로 Switch on disabled 상태로 가도록, 드라이브가 지원하는 1–3의 값)startup_sdo. PLEM 쪽에서는 쓰지 않습니다
즉시 정지에 쓰는 정지 객체(0x605C·0x6084)startup_sdo. csp·csv 축이 0x605A·0x605C·0x6084·0x6085 중 빠뜨린 것은 plem drive check 가 축마다 한 줄로 경고합니다. 드라이브는 저장값을 씁니다
operation_enabled → quick_stop_active(0x0002) 행cia402_profile 을 적었다면 그 표. 내장 표에는 있습니다(§4.8)

벤치의 stop-decel 항목이 이 정지의 평균 감속을 잽니다(§6.1).

§5 주기와 분산 클록​

키값
bus.cycle_time_ns제어 주기(ns). EtherCAT Cycle time(0x1C32:02)과 같은 단위. 200000–1000000, 1000의 배수. 그 밖의 값은 거부하며 반올림하지 않습니다
bus.sync_modedrive_default 또는 dc_sync0. 그 밖의 값은 거부
sync_modePLEM 동작
drive_defaultDC 기능을 켜지 않고 동기 설정을 쓰지 않습니다. 드라이브 자체 설정을 따릅니다. A6B 드라이브는 이 값에서 Free Run 모드로 돌았습니다(OP 상태에서 0x1C32:01·0x0981이 0)
dc_sync0모든 드라이브의 DC(AssignActivate, SYNC0 주기)를 켭니다. 모든 드라이브가 dc 블록을 적습니다

값 이름은 ETG Sync mode(0x1C32:01)에서 빌렸습니다.

dc 블록(dc_sync0 일 때만):

키값
assign_activate0이 아닌 값. 드라이브 ESI 파일의 AssignActivate
sync0_cycle_ns0이 아닌 값, 버스 주기(ns)의 정수배. 배수인지는 기동 때만 판정합니다
sync0_shift_ns부호 있는 ns. 마스터가 SYNC0 신호를 주기 시작보다 이만큼 늦춥니다. SYNC0 shift. 0이면 plem drive check 가 경고합니다
write_cycle_time선택. true 만 받습니다(빼면 쓰지 않음, false 는 거부)

write_cycle_time: true 면 기동 때(PREOP) 드라이브마다 0x1C32:02 = sync0_cycle_ns 를 한 번 씁니다. 0x1C32:01과 0x1C33은 쓰지 않습니다. 드라이브의 ESI 파일이나 매뉴얼이 0x1C32:02를 읽기·쓰기(rw)로 적고 마스터가 설정한다고 할 때만 켭니다. 켜면 digest 값이 바뀝니다(재승인).

드라이브0x1C32:02write_cycle_time
A6Brw, 마스터가 설정적습니다
MR-J4-TMrw. 다만 매뉴얼은 :01이 DC 레지스터를 따른다고 하지 않습니다(기본 Free Run). :01은 PLEM 쪽에서 쓰지 않습니다미확인
Yaskawa Σ-7S, Inovance SV660N, LS L7NH, Beckhoff AX8000, Omron 1S, Kollmorgen AKD읽기 전용이거나 없음적지 않습니다

0x1C32:02가 읽기 전용이거나 없는 드라이브에 켜면 쓰기가 거부될 것으로 보입니다(읽기 전용 객체에 대한 CoE abort). 그러면 드라이브가 PREOP 상태에 남고(커널 로그에 0x1C32:02 SDO abort), 해제가 SLAVE_NOT_OPERATIONAL 로 거부됩니다(rt_events).

  • DC 기준 클록은 파일 순서와 무관하게 링 위치가 가장 낮은 드라이브입니다. 드라이브의 0x1C32는 읽지 않습니다.
  • 드라이브가 돌 수 없는 주기는 드라이브가 거부합니다. 기동 중(PREOP→SAFEOP)에 거부하거나, 운전 중 동기 오류로 OP 밖으로 떨어지는 형태입니다. A6B 문서의 동작과 참조 모델이며 모든 드라이브의 보장은 아닙니다.
  • dc_sync0 은 A6B 두 대에서만 실제로 돌려 봤습니다(0x1C32:02를 손으로 쓴 구성과 write_cycle_time 구성). 다른 드라이브는 그 드라이브에서 돌려 보기 전에는 DC 지원을 주장하지 않습니다.

SYNC0 shift​

sync0_shift_ns 는 마스터 쪽 SYNC0 shift 값입니다. RT 루프는 깨어날 때 DC 기준 시각을 정하고, 그 뒤에 그 주기의 프레임을 보냅니다. SYNC0 신호는 그 기준 시각에서 sync0_shift_ns 뒤에 울립니다. 드라이브 자신의 Shift time(0x1C32:03)과는 다른 값이며, A6B 드라이브는 0x1C32:03을 지원하지 않습니다.

SYNC0 신호는 그 주기의 프레임이 드라이브에 닿은 뒤에, 여유를 두고 울려야 합니다. 주기에 대한 비율로 생각하고 다음 범위에서 고릅니다.

  • 하한: 호스트가 깨어나 프레임을 보내기까지의 최악 시간 + 드라이브까지의 전송 시간 + 여유
  • 상한: 제어 주기 − 드라이브 자체 처리 시간(드라이브 매뉴얼)

너무 작으면 보내는 목표는 고른데 토크가 가끔 튀거나 추종 오차가 갑자기 뜁니다.

A6B 두 대, 1 ms 주기에서 잰 값입니다.

sync0_shift_ns결과
(시각)프레임은 깨어난 뒤 약 12 µs 에 나갔습니다(p99 15 µs, 최대 55 µs)
0, 20000SYNC0 신호가 프레임보다 먼저 울려, 드라이브가 가끔 한 주기의 목표를 건너뛰거나 되풀이했습니다
30000010 번 돌려 한 번도 없었습니다

A6B 두 축 예제(a6b_pair/drive.yaml)의 300000 은 이 측정값입니다. 주기가 약 300 µs 이하면 맞지 않습니다. 다른 주기, 다른 드라이브, 드라이브 쪽 입력 shift(0x1C33)는 돌려 보지 않았습니다.

§6 approval: 승인 기록​

선택 키입니다. 새 파일에는 없고, 없으면 미승인입니다. 다음처럼 적어도 같습니다.

approval:
status: unapproved
record: null

미승인 파일이면 plem drive run 이 터미널에서 벤치를 제안하고, 승인되면 이어서 버스를 띄웁니다. 터미널이 없으면 거부합니다. 드라이브 곁에 사람이 있는 실행은 --unapproved 로 띄웁니다(벤치와 승인). 예전 낱말 unverified·verified 는 거부됩니다.

  • 기록은 벤치가 이 파일 안에 씁니다. 벤치 증거(claims·conditions·items)를 통째로 담으므로 보관할 파일은 이 파일 하나입니다. 벤치가 기록을 쓰는 방식과 거부하는 경우는 벤치 세부에 있습니다. 블록을 제자리에서 찾을 수 없는 파일(따옴표 친 키 등)은 plem drive check 가 approve_blocker 로 알려 주고, 벤치가 시작 전에 거부합니다.
  • 기록을 손으로 쓰거나 고치지 않습니다. 예외는 승인 밖인 stored_sdo 입니다(§4.9). 로더가 잡는 편집은 아래 대조에 걸리는 것뿐이고, 증거의 조건이나 항목 설명을 고친 것은 잡지 못합니다.

approved 파일은 다음이 모두 성립해야 적재됩니다. 하나라도 어긋나면 적재가 실패하고(미승인으로 내려가지 않습니다), plem drive check 가 이유를 한 줄씩 전부 보여 줍니다(--json 에서는 reasons).

  1. 기록에 적힌 digest 값이 지금 파일의 설정·전이표와 같습니다(§7).
  2. 드라이브마다 식별값이 하나씩 있습니다.
  3. 기록 안 벤치 증거의 claims 가 1·2와 기록의 implementation_revision 과 같고, 지금 소프트웨어의 필수 항목이 전부 PASS 입니다(§6.1). 한쪽만 고친 실수(예: check 가 찍은 새 digest 값을 기록 머리에만 붙여 넣기)를 잡을 뿐, 벤치가 실제로 돌았다는 증명은 아닙니다. 두 사본을 함께 고친 것은 잡지 못합니다.

승인은 소프트웨어 업데이트 뒤에도 유지됩니다. implementation_revision 은 벤치를 돌린 버전의 기록일 뿐 지금 버전과 비교하지 않습니다. 승인이 풀리는 경우는 다음과 같습니다.

바뀐 것참고
파일의 값주석·들여쓰기·키 순서·bus.name·stored_sdo 는 상관없습니다(§7). cia402_profile 을 뺀 파일은 업데이트로 내장 전이표가 바뀔 때도 풀립니다
드라이브가 기록한 식별값이나 스캔한 매핑과 다름기동 때 대조합니다(아래)
기록 안 벤치 증거가 기록 머리와 어긋남되돌리면 다시 열립니다
업데이트가 필수 항목을 더하거나 기준을 올림변경 이력에 「드라이브 재벤치 필요」로 알립니다(§6.1)

다시 벤치할 때는 같은 파일로 합니다. 기록이 더는 성립하지 않는 파일도 벤치가 기록을 바꿉니다. 승인이 성립하는 파일은 벤치가 거부합니다.

기동 때 버스는 활성화 전에 드라이브를 기록과 대조합니다. 대조하는 값은 SII 시리얼, SII revision number, 0x1009(하드웨어 버전), 0x100A(소프트웨어 버전), 그리고 scanned 드라이브는 스캔한 매핑의 digest 값입니다. 기록에 적은 항목만 대조하고 null 항목은 건너뜁니다. 다르거나 기록한 값을 읽지 못하면 기동을 거부합니다. 매핑 digest 값이 다르면 두 값을 보여 주되 원인(드라이브·펌웨어 교체, 기록 오기 등)을 하나로 좁히지 않습니다. 명판을 확인하고 다시 벤치하세요. 승인이 어느 드라이브에서 열리는지(identity_scope)는 벤치 세부에 있습니다.

판정은 기록끼리의 일치입니다. 측정이 참이라는 증명은 아닙니다.

§6.1 bench 파일과 필수 항목​

벤치(미승인 파일에 plem drive run 이 제안)는 잰 값을 임시 디렉터리의 이 파일에 쓰고, C++ 판정 도구에 넘긴 뒤 지웁니다. schema 줄 뒤의 내용은 모델 파일의 approval.record.bench 로 통째로 옮겨지므로, 승인 뒤에는 bench 파일이 필요 없습니다. 형식은 §2의 YAML 부분집합입니다. 기록을 담은 모델 파일이 1 MiB 크기를 넘게 되면 기록을 거부합니다.

schema: cia402_bench/v1
claims:
config_digest: "sha256:…" # plem drive check --json 출력에서
profile_digest: "sha256:…" # 같음
implementation_revision: "…" # 같음
slaves:
- { slave: 0, serial_number: 0, revision_number: 0x00000002, hardware_version: "…", software_version: "…", pdo_mapping_digest: "sha256:…" }
conditions: { host: "…", master: "…", date: "YYYY-MM-DD", measured_by: "…", notes: "" }
items:
- { id: assembly-match, result: PASS, evidence: "…" }
# …
  • claims.slaves 는 slaves[] 순서(ring_position 목록을 펼친 뒤)로 드라이브마다 하나입니다.
    • serial_number(SII 시리얼)와 revision_number(SII revision number, ethercat slaves -v 의 Revision number)는 정수 또는 null, 두 버전은 31바이트까지의 문자열 또는 null 입니다.
    • 전부 비울 수는 없습니다. 시리얼 0은 빈 값으로 세고, revision number 0은 읽은 값으로 셉니다.
    • pdo_mapping_digest: scanned 드라이브면 벤치로 띄운 버스가 info(plem_drive_msgs/DriveInfo)에 낸 값이고, 기동 로그 줄 using the scanned PDO mapping — … sha256:… 의 값과 같습니다. 매핑을 선언한 드라이브면 null 입니다.
  • items: result 는 PASS·FAIL·NA. 같은 id 두 번은 거부됩니다.

필수 항목은 축 모드로 정해집니다.

id확인하는 것필수인 버스
assembly-match버스가 조립한 값, joint_states 의 축, 스캔한 매핑 digest 값이 파일과 같음전부
idle-non-oe기동 전 모든 축이 Operation Enabled 상태가 아님전부
start-rtso기동 뒤 모든 축이 브레이크가 체결된 휴지 상태(Switch on disabled 또는 Ready to Switch On), 대기 중인 동작 없음, 보호 정지 없음, 위치 한계 안전부
release-oe해제하면 모든 축이 Operation Enabled, 두 번째 해제는 무동작, 풀린 채 서 있는 축이 표류하지 않음전부
stale-engage스트림을 끊으면 명령이 오래되어 보호 정지와 브레이크 강제 체결csv·cst 축이 있는 버스
stop-decel움직이는 축의 범주 1 정지: RAMP_STOP_TIMEOUT 없음, 모든 축 정지·체결, 축마다 평균 감속 ≤ 1.1 × limits.acceleration_rad_s2csp·csv 축이 있고 cst 축이 없는 버스
disable-engage서 있는 축에 protective_stop: disable, 체결, 대기 없음, 보호 정지 없음전부
stop-quiesce해제 중 컨트롤러 매니저에 SIGINT: 종료 코드 0, 하드웨어 플러그인이 brakes confirmed engaged on stop 을 남기고 brakes were NOT confirmed engaged on stop 은 없음, 남은 프로세스 없음, 마스터 Idle, 끝난 뒤 enable 된 축 없음전부

각 항목이 벤치 중에 하는 일과 벤치의 경고는 벤치 세부에 있습니다.

  • 필수 항목이 없거나 PASS 가 아니면 승인되지 않습니다. FAIL 은 어떤 항목이든 거부됩니다. 드라이브가 제공하지 않는 항목은 NA 로 적거나 뺍니다.
  • 필수가 아닌 항목은 NA 이거나 없어도 됩니다. csp 축만 있는 버스에서 stale-engage 는 NA 입니다.
  • cst 축이 있는 버스의 기존 승인은 그대로 유효합니다. cst 축 없이 csp·csv 축이 있는 버스의 승인은 stop-decel 이 없으면 다시 벤치해야 합니다.
  • 지금 소프트웨어의 필수 항목은 plem drive check --json 의 required_bench_items 에 나옵니다.

업데이트가 어떤 항목의 합격 기준을 올리면 그 항목의 id 가 바뀝니다(stale-engage → stale-engage-2). 옛 증거에는 새 id 가 없으므로 승인이 풀리고, 그 업데이트의 변경 이력에 「드라이브 재벤치 필요」가 적힙니다.

브레이크 하나를 여러 축이 함께 쓰는 드라이브는 이 승인의 대상이 아닙니다

승인 판정은 브레이크 공유 여부를 검사하지 못합니다(§4.4).

실제 드라이브로는 stop-decel 을 포함한 벤치로 A6B 두 대의 파일(csp 축, csv 사본)을 승인했습니다. cst 축이 있는 버스는 실제 드라이브로 벤치하지 않았습니다.

§7 digest 계산 범위​

config_digest 는 파일의 글자가 아니라 검사를 마친 값으로 계산합니다.

digest 값이 바뀜(승인이 풀림)바뀌지 않음
모든 값. model.name 과 축 이름 포함주석, 들여쓰기, 키 순서
slaves·axes·sync_managers·pdos·entries·startup_sdo 의 순서0x0600 과 1536(정수는 값으로 비교)
mode_display_timing, write_cycle_time: true, acceleration_rad_s2mode_display_timing 을 뺀 것과 pre_enable 을 적은 것
실제로 쓰는 전이표(profile_digest 도)bus.name, stored_sdo, approval 블록

§8 어디서 검사하는지​

검사 대상검사하는 곳
형식, 키, 값 범위, 이름, 한계, SDO 목록, 전이표, 승인 기록로더. plem drive check 와 plem drive run 이 같게 판정합니다
generated·선언 매핑의 필수 항목과 주소 겹침드라이브 없이 plem drive check, 그리고 기동 때 버스
scanned 매핑, sync0_cycle_ns 가 주기의 배수인지, 기록과 드라이브 식별값의 대조, stored_sdo 값기동 때 버스만
factors·flip·한계가 기계에 맞는지, 브레이크와 엔코더 종류아무도 판정하지 않습니다. 일부는 벤치가 확인합니다(§6.1)

§9 제공하지 않는 것​

다음은 값과 상관없이 거부됩니다.

  • 축의 ramp 블록(예전 버스 루프 안 보간). 지우라는 메시지가 나옵니다. 이동은 클라이언트(plem drive run 의 궤적 컨트롤러, Python plem.drive 의 Bus.move_to)가 계획하고, 정지는 limits.acceleration_rad_s2 로 감속합니다. ramp 가 없는 파일의 digest 값은 이 키가 폐지되기 전과 같습니다.
  • axes[].brake.coupling 과 axes[].extra_sdo.
  • unit: raw, 그리고 cst·csp·csv 밖의 모드.

이 밖에 홈잉, 실행 중 모드 전환, feed-forward, IO 슬레이브도 없습니다(버스의 다른 장치는 마스터 기본값인 PREOP 상태로 남습니다).

§10 버전과 바뀐 키​

로더는 schema: cia402_drive/v1 만 받습니다. 기존 v1 파일을 같은 값·digest 그대로 읽는 변경이면 스키마는 v1 그대로입니다. 움직임을 막는 것은 버전 표시가 아니라 승인입니다(§6).

0.10 버전 파일은 옛 키 이름을 씁니다. 그대로 두면 거부되고, 메시지는 새 키가 없다거나 옛 키·값을 모른다고 나옵니다. 아래처럼 이름만 바꾸면 됩니다. digest 값이 바뀌지 않으므로 기존 승인은 그대로 유지됩니다.

0.10지금
cia402_profile[].control_wordcontrolword
axes[].mode_displaymode_display_timing
승인 기록과 벤치 claims.slaves 의 serialserial_number
pdo_mapping: standardpdo_mapping: generated
bus.sync_mode: smbus.sync_mode: drive_default