드라이브 모델 파일
서보 드라이브 연결하기에서 쓰는 YAML 파일(schema: cia402_)의 키 레퍼런스입니다. plem drive check 나 plem drive run 의 메시지에 schema §4.1 이 나오면 이 페이지의 §4.1 절을 보세요. 버스가 도는 방식, 명령 검사, 정지, 벤치는 드라이브 버스 API 문서에 있습니다. 실제 드라이브로 돌려 본 규칙은 그렇다고 적었고, 그 범위는 하드웨어 검증 범위에 있습니다.
§1 필수 키와 생략
아래 표에 적은 곳 말고는 모든 키가 필수입니다. 빠진 키는 거부되고, 직접 정해야 하는 값을 기본값이 대신하지 않습니다. 키를 빼는 것이 뜻을 갖는 곳은 다음뿐입니다.
| 뺀 키 | 뜻 |
|---|---|
cia402_ | 내장 CiA 402 전이표를 씁니다(§4.8) |
bus. 일 때의 dc, fault_ 일 때의 pacing | 꺼 둔 기능에는 하위 블록을 적지 않습니다. 적으면 거부됩니다 |
csp·csv 축의 limits., cst 축의 limits. | 다른 모드의 키입니다(§4.4). 적으면 거부됩니다 |
슬레이브의 stored_ | 저장값을 읽지 않습니다(§4.9) |
dc 블록의 write_ | 0x1C32:02를 쓰지 않습니다(§5) |
approval | 미승인입니다(§6) |
mode_ | pre_ 입니다(§4.2a) |
factors., 위치·속도의 unit | 값이 하나뿐인 rotary_ 입니다(§4.2) |
error_ | 슬레이브 매핑에 Error code(0x603F)가 있을 때만 그 항목을 씁니다(§4.2) |
bus. | 로더는 읽지만 plem drive check 와 run 이 거부합니다(§4.5) |
값이 없다는 것은 정해진 표기로 적습니다. null 은 error_·approval.·식별값·기계적 끝단이 없는 축(무한 회전 축)의 limits. 에, [] 는 startup_ 와 메일박스 SM 쪽 pdos 에 씁니다. 스키마에 없는 키도 거부되므로 오탈자가 생략으로 읽히지 않습니다. 이 버전이 지원하지 않는 기능(§9)도 거부됩니다.
§2 파일 형식
로더는 YAML 문법의 좁은 부분집합만 읽습니다.
| 항목 | 규칙 |
|---|---|
| 문서 | 파일 하나에 문서 하나. 맨 앞 --- 하나는 허용. 지시어(%YAML)는 거부 |
| 금지 문법 | anchor·alias(&·*), 모든 명시 태그(!!int 포함), 블록 스칼라(|·>), merge key <<. 중첩은 16단까지 |
| 키 | 문자열 키만. 같은 키 두 번은 거부 |
| bool | 따옴표 없는 true·false 만. yes·on 은 거부 |
| null | null 만. ~·빈 값은 거부 |
| 정수 | 앞자리 0 없는 10진수 또는 0x 16진수. +·_·0X·음의 16진수·1536.0·따옴표는 거부. 음수는 부호 있는 필드(zero_, dc.)에만. 범위 밖의 값은 감아 돌리지(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_ | 링 위치(ethercat slaves 의 번호). 순서는 자유이고 같은 값 두 번은 거부. 목록으로 적으면 똑같은 드라이브 여러 대입니다(아래) |
vendor_, product_ | ethercat slaves -v 에 나오는 값. 0은 거부. 그 링 위치의 드라이브와 다르면 두 값을 함께 보여 주며 기동을 멈춥니다(the configuration declares vendor 0x… product 0x…, but the slave at that ring position is …). 예제의 vendor 0x00c0ffee가 남아 있으면 plem drive check 가 경고합니다 |
pdo_ | generated, scanned 또는 매핑 선언(아래) |
dc | §5 |
startup_ | §4.7. 없으면 [] |
stored_ | 선택, §4.9. 없으면 키를 뺍니다([] 는 거부) |
axes | 이 드라이브의 축. 빈 목록은 거부 |
pdo_ 은 세 가지 중 하나입니다.
| 값 | PLEM 동작 | 쓰는 경우 |
|---|---|---|
generated | 축에서 매핑을 만들어 PREOP 상태에서 드라이브에 씁니다 | 매핑 변경을 받고, PLEM 쪽에서 읽고 쓰는 객체만 있으면 되는 드라이브. 드라이브 하나에 축 4개까지 |
scanned | 기동 때 드라이브의 지금 매핑을 읽어 필수 항목을 검사하고 그대로 씁니다. 드라이브에 쓰지 않습니다 | 매핑 변경을 받지 않는 드라이브 |
sync_ (매핑 선언) | 이 매핑을 PREOP 상태에서 드라이브에 씁니다 | 특정 PDO, 또는 다른 객체(터치 프로브, 디지털 입력 등)가 필요한 드라이브 |
generated. 축마다 채널 순서로, 각 객체를 그 축 채널의 주소로 담습니다.
| PDO | SM | 담는 객체 |
|---|---|---|
RxPDO 0x1600 + 채널 − 1 | SM 2, watchdog 켬 | Controlword(0x6040), Modes of operation(0x6060), 모드의 목표(cst 0x6071 · csp 0x607A · csv 0x60FF) |
TxPDO 0x1A00 + 채널 − 1 | SM 3 | Statusword(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_) 한 항목으로 씁니다.
- 드라이브마다 다른 것은 축의
name·flip·zero_뿐입니다. 이 셋은 링 위치 수만큼 목록으로 적습니다(offset_ count name: [axis0, axis1]). - 나머지 키는 모두에 똑같이 적용됩니다. 하나라도 다른 드라이브는 따로 적습니다.
- 로더가 목록을 펼치므로 digest·승인 기록은 한 대씩 적은 파일과 같습니다.
check --json과 debug 로그의slaves[k]는 펼친 뒤의 순서입니다.
§4.2 axes
| 키 | 값 |
|---|---|
name | joint_ 의 관절 이름. 규칙은 §4.5 |
channel | 드라이브 안의 몇 번째 CiA 402 축인지(1–8). n번 채널의 객체 주소는 1번 채널보다 (n − 1) × 0x800 큽니다. 0x6000–0x9FFF를 0x800 블록 8개로 나누는 CiA 402 배치입니다 |
mode | cst(토크), csp(위치), csv(속도). §4.2b |
mode_ | pre_(기본값) 또는 post_. §4.2a |
factors | 단위 환산. 아래 표 |
flip | true 면 드라이브와 주고받는 값의 부호를 PLEM 안에서 뒤집습니다. 드라이브의 Polarity(0x607E)는 쓰지 않습니다 |
zero_ | 관절 0 rad 일 때의 드라이브 위치 카운트(부호 있는 32비트). 드라이브가 보고하는 값 그대로이고 flip 을 먼저 적용하지 않습니다. 드라이브의 Home offset(0x607C)·Position offset(0x60B0)과는 별개이며, 이 두 객체는 PLEM 쪽에서 쓰지 않습니다 |
error_ | null(드라이브가 오류 코드를 매핑하지 않음) 또는 { index, subindex, bits } |
limits | 안전 한계. §4.4 |
error_:
- 빼면 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. | 드라이브가 토크(0x6071·0x6077)를 세는 단위. 단위마다 적는 키가 다르고, 다른 단위의 키는 거부됩니다. scaled_: CiA 402 밖의 벤더 전류 카운트. 카운트 = τ × counts_ ÷ (torque_ × gear_). rated_: CiA 402 단위로, 한 카운트가 모터 정격 토크(0x6076)의 1/1000. 카운트 = τ × 1000 ÷ (motor_ × gear_) |
torque. | (scaled_) 암페어당 전류 카운트. 드라이브 매뉴얼의 값 |
torque. | (scaled_) 모터 토크 상수 Nm/A. 모터 명판의 값 |
torque. | (rated_) 모터축 기준 정격 토크 Nm. 드라이브의 0x6076은 mNm 단위이므로 1000으로 나눠 적습니다(0x6076이 1270이면 1.27) |
gear_ | 출력축 한 바퀴당 모터 회전 수. 감속기가 없으면 1.0. 축 값(limits·명령·joint_)은 출력축 기준 rad·rad/s·Nm 단위입니다. 드라이브 값(startup_·stored_·zero_·dc)은 드라이브 매뉴얼의 원시 값이고 감속비를 타지 않습니다. 감속기를 바꾸면 이 값과 축 값을 함께 고칩니다 |
position., velocity. | rotary_ 만. 위치 카운트 = rad × encoder_ × gear_ ÷ 2π |
encoder_ | 모터 한 바퀴당 위치(0x6064) 카운트, 정수. 드라이브의 전자 기어가 1:1 일 때만 모터의 엔코더 분해능과 같습니다 |
velocity. | 속도 카운트 하나에 해당하는 위치 카운트 수(1.0 = 같은 단위). 드라이브 매뉴얼의 0x606C 단위에서 얻습니다. 틀리면 속도 한계와 joint_ 속도가 조용히 어긋납니다 |
motor_ rated_ torque_ nm 이 틀리면 모든 토크가 어긋납니다모든 토크 명령과 측정 토크가 같은 비율로 어긋납니다. 값이 크면 명령이 약해지고, 작으면 명령이 세져 드라이브 토크 범위 끝까지 갈 수 있습니다.
벤치가 0x6076을 한 번 읽어 이 값과 1 %(최소 1 mNm) 넘게 다르면 경고하고, 그 경고를 승인 기록(conditions.)에 남깁니다. 벤치는 멈추지 않습니다. 객체가 없거나 값이 0·0xFFFFFFFF이거나 읽기에 실패하면 대조하지 않습니다.
§4.2a mode_display_timing
드라이브가 0x6061(표시 모드)을 0x6060(요청 모드)에 언제 맞추는지 적습니다.
| 값 | 드라이브 동작 |
|---|---|
pre_(뺐을 때) | enable 전에 맞춥니다 |
post_ | 처음 enable 할 때까지 0x6061이 0입니다 |
pre_ 이 더 엄격합니다. 0x6061이 선언한 모드를 보여야 해제를 받습니다. 쉬는 동안 0x6061이 0이고 enable 한 뒤에야 모드를 보이는 드라이브는 MODES_(표시값 0)로 거부되고, Bus. 와 벤치의 거부 문장이 post_ 을 적으라고 알려 줍니다. CiA 402 규격이 정하지 않은 드라이브 특성이며 고장이 아닙니다. 키를 빼면 pre_ 을 적은 파일과 digest 값이 같고, 값을 바꾸면 승인이 풀립니다.
§4.2b mode
mode 는 그 축의 0x6060 값입니다: cst 10 · csp 8 · csv 9. 축마다 정하고 한 버스에 섞어도 됩니다. 기동부터 매 주기 보내며 실행 중에는 바뀌지 않습니다.
| 모드 | 명령 단위 | plem drive run 의 컨트롤러 | 중립 명령 |
|---|---|---|---|
cst | Nm | 스트림 컨트롤러 | 0 Nm |
csp | rad | 궤적 컨트롤러 | 그 주기의 실측 위치 |
csv | rad/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_ 항목의 index | 절대 주소 | statusword 0x6841 |
error_ | 1번 채널의 주소. 채널 오프셋은 자동으로 더해집니다 | 0x603F(0x683F 가 아님) |
startup_·stored_ 의 index | 절대 주소 | 2번 채널의 모드는 0x6860 |
error_ 에 0x683F 를 적으면 채널 오프셋이 더해져 0x703F 를 찾게 되고, 그 주소가 매핑에 없으면 검사가 거부합니다.
§4.4 limits: 안전 한계
한계에는 기본값이 없고, 값이 맞는지는 파일을 쓰는 사람의 책임입니다. 로더는 모양만 봅니다. 검사는 PLEM 안에서 합니다. 드라이브 자체의 한계 객체는 쓰지 않습니다. 소프트웨어 위치 한계 0x607D, 속도 0x607F·0x6080, Max torque 0x6072, 정지 감속 0x6084·0x6085가 그 객체입니다.
| 키 | 단위 | 거부 조건 | 넘으면 |
|---|---|---|---|
position: { min_ 또는 null | 출력축 rad, zero_ 기준 | 유한하지 않음, min ≥ max. null 인데 zero_ 가 0이 아님 | 보호 정지 + 브레이크 강제 체결 |
velocity_ | 출력축 rad/s | 유한하지 않음, 0 이하 | 보호 정지 + 브레이크 강제 체결 |
acceleration_ | 출력축 rad/s². csp·csv 축만, 거기서는 필수 | csp·csv 축에서 빠짐·0 이하. cst 축에 적음 | 한계가 아니라 요청 정지의 감속입니다 |
torque_ | 출력축 Nm. cst 축만 | cst 축에서 빠짐, 유한하지 않음, min < 0 < max 조건을 어김. csp·csv 축에 적음 | cst 명령을 그 범위로 자릅니다 |
acceleration_: 축이 실제로 낼 수 있고 드라이브의 0x6085(Quick stop deceleration)를 넘지 않는 값을 적습니다. digest 계산에 들어가므로, 이 키가 생기기 전에 승인한rad_ s2 csp·csv파일은 키를 더하고 다시 벤치합니다.torque_:nm csp·csv축은 토크 명령을 보내지 않습니다. 그 축의 토크는 드라이브 안의 루프가 내고, 드라이브의 0x6072가 묶습니다.- 위치 한계 밖에서 멈춘 축은 해제되지 않습니다.
limits.이 이position zero_·offset_ count flip으로 드라이브의 32비트 위치가 나타낼 수 있는 각도를 넘으면plem drive check가 경고합니다. 그 바깥의 한계는 지켜지지 않습니다.- 유한한 한계를 둔 축에서 위치가 32비트 관절 카운트로 표현되지 않으면(아주 큰
zero_에서 카운트가 끝에 닿은 경우) 보호 정지가 걸리고, 표현될 때까지 reset 요청이 거부됩니다. 그 동안의 위치는 축이 움직여도 한 값이라 한계를 판정할 수 없기 때문입니다.offset_ count
실제 드라이브(A6B)에서는 범위 밖 위치 명령, 기동 때 이미 범위 밖인 축, 실측 속도 초과, 한계를 넘는 csv 명령의 정지를 확인했습니다. 움직이던 축이 위치 한계를 넘는 경우는 확인하지 않았습니다.
전제. 파일에 적을 키가 없어 로더가 어긋나는 드라이브를 거부하지 못합니다.
| 전제 | 쓰면 안 되는 것 |
|---|---|
| 브레이크가 전원 결합이고, disable 뒤 하중을 붙잡습니다 | 0x60FE 출력 브레이크, 외부 브레이크, 브레이크 없음 |
| 축마다 브레이크가 따로 있습니다 | 브레이크 하나가 여러 축을 함께 푸는 드라이브. 벤치 승인 대상도 아닙니다 |
| 엔코더가 절대값입니다 | 증분 엔코더(아래) |
PLEM 소프트웨어에는 홈잉이 없습니다. zero_ 와 위치 한계는 드라이브가 전원을 넣을 때마다 같은 위치를 보고할 때만 제자리를 가리킵니다. 증분 엔코더는 켤 때마다 카운트를 새로 시작하므로 한계가 아무것도 지키지 못합니다. 엔코더 종류를 적을 키가 없어 로더도 벤치도 거부하지 못합니다. 그런 드라이브는 쓰지 마세요. 무한 회전 축(아래)은 지킬 위치 한계가 없습니다.
무한 회전 축
출력축이 한 방향으로 계속 도는 축은 position: null 과 zero_ 을 적습니다. 모드는 무엇이든 됩니다.
zero_offset_count: 0
limits: { position: null, velocity_rad_s: 20.0 } # cst 축이면 torque_nm 도 적습니다
드라이브가 보낸 위치를 PLEM 쪽에서 프레임마다 따라가며 넘어간 바퀴를 셉니다.
| 상황 | 한계 | 결과 |
|---|---|---|
| 속도 | 속도 한계는 그대로 필요하고 끌 수 없습니다 | 넘으면 보호 정지 |
| 드라이브의 32비트 카운트가 끝을 넘음 | 없음 | joint_ 와 명령의 위치가 끊기지 않고 이어집니다. 속도·토크는 영향이 없습니다 |
| PLEM 재시작 | 저장해 두는 원점이 없음 | 드라이브 값부터 다시 셉니다(23비트 엔코더·기어비 1이면 약 ±1608 rad 안). 위치 축은 그때의 위치를 기준으로 명령하세요 |
| PLEM 시작 뒤 한 방향 순이동 | 2⁴⁸ 카운트(23비트 엔코더면 모터 약 3,350만 회전. 400 rad/s 속도면 약 6일, 20 rad/s 속도면 약 122일) | 보호 정지(LIMIT_ 사유 3)이고, PLEM 재시작 전까지 reset 요청이 거부됩니다. 이를 넘는 위치 명령은 사유 7 |
| 프레임을 받지 못하는 사이의 이동 | 2³¹ 카운트 미만(23비트 엔코더면 모터 256 회전, 6000 rpm 속도면 2.56초) | 넘으면 보고 위치가 2³² 카운트의 배수만큼 어긋납니다. 이 어긋남은 감지되지 않습니다 |
| 좌표를 바꾸는 정비(원점 복귀, 다회전 클리어, 드라이브 설정 도구 조작, 전자 기어·극성 변경) | 정지 상태에서 하고, 끝나면 PLEM 재시작 | 움직임과 구분하지 못하고 그대로 셉니다 |
드라이브 쪽에서 맞춰 둘 조건입니다. PLEM 쪽에서는 검사하지 않습니다.
| 조건 | 방법 |
|---|---|
| 드라이브 위치가 32비트 전 범위로 돕니다 | 드라이브 위치 범위 0x607B를 좁히지 않고, 벤더 고유의 연속 회전 절대 모드를 쓰지 않습니다 |
| 위치 목표 0x607A가 넘어가는 것을 연속 이동으로 받습니다 | 드라이브 매뉴얼 |
| 드라이브의 소프트웨어 위치 한계 0x607D가 꺼져 있습니다 | 0x607D는 PLEM 쪽에서 쓰지 않습니다. 기대값을 stored_ 에 적어 두면 기동 때 다르면 경고합니다(아래 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)와 상관없습니다.
그런 드라이브는 다음 중 하나를 합니다.
- 엔코더를 증분 모드로 씁니다.
- 32비트 전 범위 순환(wrap)은 유지하면서 넘침만 무시하는 설정을 켭니다. A6B 드라이브는 Pr6.98 bit 3 = 1이며, 기능 확장 버전 3 이후에 있습니다. 전자 기어에 따라 전원을 다시 넣은 뒤 위치가 끄기 전과 다를 수 있습니다(매뉴얼 SX-DSV03242 R10.1, p.255-256).
- 둘 다 없으면 위치 한계를 둬 그 범위 안에서만 움직이게 합니다.
실제 A6B 두 대로 32비트 경계를 여러 번 넘겨 봤을 때 위치·명령이 끊기지 않았습니다. 다만 Pr6.98 bit 3 = 0(공장값)인 그 드라이브들은 다음 기동을 Err29.1 알람으로 거부했습니다.
정지할 때, 그 실행에서 센 위치(기동 때 드라이브 값에서 시작)가 32비트 범위 밖에서 끝난 축마다 경고가 한 번 남습니다. 앞선 실행의 넘김, 드라이브 자체 오프셋, 1:1이 아닌 전자 기어는 보지 못하므로 경고가 없다고 다음 기동이 보장되지는 않습니다.
§4.5 이름
| 키 | 규칙 |
|---|---|
model. | 1–31바이트(UTF-8 바이트 기준). 공백만으로는 안 되고 제어 문자도 안 됩니다. 길면 자르지 않고 거부합니다 |
axes[]. | [a-z_][a-z0-9_]*, 31바이트 이하, 파일 안에서 중복 금지. joint_ 의 관절 이름이 됩니다 |
bus. | 영문·숫자·_ 만, 숫자로 시작하지 않고 64바이트 이하. plem drive run 은 버스를 /<name> 네임스페이스에 띄우고, Python 클라이언트는 Bus("<name>") 로 붙습니다. 이 키가 없는 파일은 plem drive check 와 run 이 거부합니다. digest 계산에 들어가지 않아 이름을 바꿔도 승인이 유지됩니다 |
§4.6 fault_reset
버스 전체에 한 번 정합니다.
policy | pacing |
|---|---|
none | 적지 않습니다 |
bounded_ | { interval_ 필수. interval_ > 0, max_ 1–10000 |
max_ 는 횟수 상한일 뿐이고, 그 횟수까지 안전하다는 뜻이 아닙니다. interval_ 는 제어 주기의 횟수로 나타낼 수 있어야 하며, 이것은 기동 때 판정합니다.
pulse_(필수, 0–1000)는 fault reset 한 번에 controlword bit 7을 켜 두는 최소 시간(ms)입니다.
policy와 상관없이reset_요청과 자동 reset 모두에 씁니다.error - 제어 주기로 올림한 프레임 수(최소 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_ |
| 동기 객체(0x1C32·0x1C33) | sync_ 와 dc. 이 중 PLEM 쪽에서 쓰는 것은 dc. 의 0x1C32:02 뿐입니다 |
| 축마다(채널 주소로): controlword 0x6040, 모드 0x6060, 목표값 0x6071·0x607A·0x60FF | PLEM, mode |
| 축마다: 한계 0x607D·0x6072·0x6080, Home offset 0x607C | limits, zero_. 이 객체들은 PLEM 쪽에서 쓰지 않습니다. 한 값의 출처가 파일 안에 둘 생기지 않게 거부할 뿐입니다 |
그 밖의 객체는 받아들이며, 무엇을 하는지는 파일을 쓰는 사람의 책임입니다. 미승인 파일도 기동 때 쓰고, 쓴 것을 로그에 전부 남깁니다. 드라이브가 쓰기를 거부해도 그 원인이 startup_ 라고 짚어 주지는 않습니다.
드라이브 RAM 안에 남아 전원을 다시 넣을 때까지 갑니다. 다른 파일로 바꿔 띄우면 그 값을 그대로 물려받습니다. A6B 드라이브에서는 앞선 시험 파일이 낮춰 둔 토크 한계와 위치 편차 한계가 남아, 다음 파일의 평범한 이동이 위치 편차 알람(Err24.0)으로 멈췄습니다. 쓰는 객체가 적은 파일로 바꿀 때는 드라이브 전원을 다시 넣으세요.
§4.8 cia402_profile
이 키를 빼면 모든 축이 내장 전이표를 씁니다. CiA 402 표준 전이의 부분집합 12행이고, 표준 밖의 행은 없습니다.
화살표의 값은 PLEM 쪽에서 보내는 controlword 값입니다. fault reset 신호는 따로 보내므로(bit 7, §4.6) fault 행이 없습니다. switch_ 에서 나가는 행(Shutdown)과 들어가는 행(Disable voltage)은 표준에서 가져온 것이고 실제 드라이브로 확인하지 않았습니다.
표준과 다르게 전이하는 드라이브만 최상위에 행 목록을 적습니다. 파일에 하나이고 모든 축에 적용됩니다. 예를 들어 전원 투입 뒤 not_ 에서 Shutdown 명령을 받아 ready_ 으로 가는 드라이브는 내장 표 앞에 그 행을 더한 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_(0x0002) 행이 있어야 하고, 없으면 거부됩니다.stop_ active - 키를 빼면
plem drive check --json에profile_이 나옵니다. 업데이트로 내장 표가 바뀌면 이 키를 뺀 파일의 승인이 풀립니다(§6).source: built_ in
§4.9 stored_sdo
드라이브에 저장돼 있어야 할 값의 목록입니다(선택). 버스가 기동할 때 값마다 한 번 읽고, 다르면 경고를 남깁니다. 이 값을 쓰거나 저장하지는 않으며, 값이 다르거나 읽지 못해도 기동을 막지 않습니다. 원소의 모양은 startup_ 와 같습니다.
stored_sdo:
- { index: 0x3401, subindex: 0, size: 4, value: 0 }
- { index: 0x3015, subindex: 0, size: 2, value: 2 }
size·value는startup_규칙을 따릅니다. 음수는 그 폭의 2의 보수를 16진수로 적습니다. 드라이브마다 16개까지이고, 필요 없으면 키를 뺍니다(sdo []는 거부).- 거부되는 것은 형식 오류뿐입니다: 한 드라이브에 같은 주소 두 번, 같은 드라이브의
startup_가 쓰는 주소.sdo startup_로 쓴 값은 다음 전원 재투입까지 RAM 안에 남아 읽어도 알 수 있는 것이 없으니,sdo startup_로 옮긴 객체는 여기서 뺍니다.sdo - 출력 PDO 안에 매핑된 객체(마스터가 매 주기 보냄)와 PDO 매핑·배정 객체(0x1600–0x17FF, 0x1A00–0x1BFF, 0x1C10–0x1C2F)는 읽지 않고 하나마다 경고합니다. 0x1C32·0x1C33에는 드라이브가 운전 중 채우는 항목이 있으니 저장 설정 항목만 적습니다.
- 일치해도 값이 저장됐거나 적용됐다는 뜻은 아닙니다. 지금 값만 읽습니다. 써 놓고 저장하지 않은 값은 다음 전원 재투입까지 일치로 나옵니다.
- 승인과 무관합니다. 승인된 파일의
stored_를 고쳐도 승인이 유지되고, 승인은 이 목록도, 벤치 때 드라이브가 가졌던 값도 보증하지 않습니다.sdo plem drive check는 버스를 읽지 못하므로 형식만 검사합니다.
값이 다르다는 경고에는 두 갈래가 함께 적힙니다.
| 맞는 쪽 | 할 일 |
|---|---|
| 파일(드라이브 매뉴얼이 그 객체를 쓰고 저장할 수 있다고 할 때) | PLEM 프로세스를 멈춘 채로 드라이브 전원을 껐다 켜고, 값을 쓰고, 드라이브가 CiA 301 저장(0x1010:01)을 지원하면 저장합니다(드라이브 매뉴얼 참조). 전원을 켤 때 적용되는 객체면 다시 껐다 켭니다. 저장은 보통 드라이브가 그 순간 가진 저장 가능한 값을 전부 저장하므로, 먼저 껐다 켜야 지난 기동의 startup_ 값이 함께 저장되지 않습니다 |
| 드라이브(예: 이 기계에서 튜닝한 값) | 파일의 stored_ 를 고칩니다 |
읽기 때문에 기동이 기다릴 수 있습니다.
- 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_ 과 실행의 끝(plem drive run 터미널의 Ctrl-C)은 축을 limits. 로 먼저 감속한 뒤 브레이크를 물립니다. 제때 확인되지 않으면 드라이브 자체 Quick stop 단계로 넘어가고 보호 정지가 걸립니다. 그 밖의 정지는 곧바로 disable 합니다. 진행 순서, 시간, 이벤트는 드라이브 버스 API 문서에 있습니다.
이 정지를 위해 파일에 적을 값입니다.
| 값 | 적는 곳 |
|---|---|
| 드라이브의 0x6085를 넘지 않는 감속 | 모든 csp·csv 축의 limits.(§4.4) |
| 드라이브의 Quick stop 감속 0x6085와 option code 0x605A(정지 뒤 드라이브가 스스로 Switch on disabled 상태로 가도록, 드라이브가 지원하는 1–3의 값) | startup_. PLEM 쪽에서는 쓰지 않습니다 |
| 즉시 정지에 쓰는 정지 객체(0x605C·0x6084) | startup_. csp·csv 축이 0x605A·0x605C·0x6084·0x6085 중 빠뜨린 것은 plem drive check 가 축마다 한 줄로 경고합니다. 드라이브는 저장값을 씁니다 |
operation_ → quick_(0x0002) 행 | cia402_ 을 적었다면 그 표. 내장 표에는 있습니다(§4.8) |
벤치의 stop-decel 항목이 이 정지의 평균 감속을 잽니다(§6.1).
§5 주기와 분산 클록
| 키 | 값 |
|---|---|
bus. | 제어 주기(ns). EtherCAT Cycle time(0x1C32:02)과 같은 단위. 200000–1000000, 1000의 배수. 그 밖의 값은 거부하며 반올림하지 않습니다 |
bus. | drive_ 또는 dc_. 그 밖의 값은 거부 |
sync_ | PLEM 동작 |
|---|---|
drive_ | DC 기능을 켜지 않고 동기 설정을 쓰지 않습니다. 드라이브 자체 설정을 따릅니다. A6B 드라이브는 이 값에서 Free Run 모드로 돌았습니다(OP 상태에서 0x1C32:01·0x0981이 0) |
dc_ | 모든 드라이브의 DC(AssignActivate, SYNC0 주기)를 켭니다. 모든 드라이브가 dc 블록을 적습니다 |
값 이름은 ETG Sync mode(0x1C32:01)에서 빌렸습니다.
dc 블록(dc_ 일 때만):
| 키 | 값 |
|---|---|
assign_ | 0이 아닌 값. 드라이브 ESI 파일의 AssignActivate |
sync0_ | 0이 아닌 값, 버스 주기(ns)의 정수배. 배수인지는 기동 때만 판정합니다 |
sync0_ | 부호 있는 ns. 마스터가 SYNC0 신호를 주기 시작보다 이만큼 늦춥니다. SYNC0 shift. 0이면 plem drive check 가 경고합니다 |
write_ | 선택. true 만 받습니다(빼면 쓰지 않음, false 는 거부) |
write_ 면 기동 때(PREOP) 드라이브마다 0x1C32:02 = sync0_ 를 한 번 씁니다. 0x1C32:01과 0x1C33은 쓰지 않습니다. 드라이브의 ESI 파일이나 매뉴얼이 0x1C32:02를 읽기·쓰기(rw)로 적고 마스터가 설정한다고 할 때만 켭니다. 켜면 digest 값이 바뀝니다(재승인).
| 드라이브 | 0x1C32:02 | write_ |
|---|---|---|
| A6B | rw, 마스터가 설정 | 적습니다 |
| MR-J4-TM | rw. 다만 매뉴얼은 :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_ 로 거부됩니다(rt_events).
- DC 기준 클록은 파일 순서와 무관하게 링 위치가 가장 낮은 드라이브입니다. 드라이브의 0x1C32는 읽지 않습니다.
- 드라이브가 돌 수 없는 주기는 드라이브가 거부합니다. 기동 중(PREOP→SAFEOP)에 거부하거나, 운전 중 동기 오류로 OP 밖으로 떨어지는 형태입니다. A6B 문서의 동작과 참조 모델이며 모든 드라이브의 보장은 아닙니다.
dc_은 A6B 두 대에서만 실제로 돌려 봤습니다(0x1C32:02를 손으로 쓴 구성과sync0 write_구성). 다른 드라이브는 그 드라이브에서 돌려 보기 전에는 DC 지원을 주장하지 않습니다.cycle_ time
SYNC0 shift
sync0_ 는 마스터 쪽 SYNC0 shift 값입니다. RT 루프는 깨어날 때 DC 기준 시각을 정하고, 그 뒤에 그 주기의 프레임을 보냅니다. SYNC0 신호는 그 기준 시각에서 sync0_ 뒤에 울립니다. 드라이브 자신의 Shift time(0x1C32:03)과는 다른 값이며, A6B 드라이브는 0x1C32:03을 지원하지 않습니다.
SYNC0 신호는 그 주기의 프레임이 드라이브에 닿은 뒤에, 여유를 두고 울려야 합니다. 주기에 대한 비율로 생각하고 다음 범위에서 고릅니다.
- 하한: 호스트가 깨어나 프레임을 보내기까지의 최악 시간 + 드라이브까지의 전송 시간 + 여유
- 상한: 제어 주기 − 드라이브 자체 처리 시간(드라이브 매뉴얼)
너무 작으면 보내는 목표는 고른데 토크가 가끔 튀거나 추종 오차가 갑자기 뜁니다.
A6B 두 대, 1 ms 주기에서 잰 값입니다.
sync0_ | 결과 |
|---|---|
| (시각) | 프레임은 깨어난 뒤 약 12 µs 에 나갔습니다(p99 15 µs, 최대 55 µs) |
| 0, 20000 | SYNC0 신호가 프레임보다 먼저 울려, 드라이브가 가끔 한 주기의 목표를 건너뛰거나 되풀이했습니다 |
| 300000 | 10 번 돌려 한 번도 없었습니다 |
A6B 두 축 예제(a6b_)의 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_입니다(§4.9). 로더가 잡는 편집은 아래 대조에 걸리는 것뿐이고, 증거의 조건이나 항목 설명을 고친 것은 잡지 못합니다.sdo
approved 파일은 다음이 모두 성립해야 적재됩니다. 하나라도 어긋나면 적재가 실패하고(미승인으로 내려가지 않습니다), plem drive check 가 이유를 한 줄씩 전부 보여 줍니다(--json 에서는 reasons).
- 기록에 적힌 digest 값이 지금 파일의 설정·전이표와 같습니다(§7).
- 드라이브마다 식별값이 하나씩 있습니다.
- 기록 안 벤치 증거의
claims가 1·2와 기록의implementation_과 같고, 지금 소프트웨어의 필수 항목이 전부revision PASS입니다(§6.1). 한쪽만 고친 실수(예:check가 찍은 새 digest 값을 기록 머리에만 붙여 넣기)를 잡을 뿐, 벤치가 실제로 돌았다는 증명은 아닙니다. 두 사본을 함께 고친 것은 잡지 못합니다.
승인은 소프트웨어 업데이트 뒤에도 유지됩니다. implementation_ 은 벤치를 돌린 버전의 기록일 뿐 지금 버전과 비교하지 않습니다. 승인이 풀리는 경우는 다음과 같습니다.
| 바뀐 것 | 참고 |
|---|---|
| 파일의 값 | 주석·들여쓰기·키 순서·bus.·stored_ 는 상관없습니다(§7). cia402_ 을 뺀 파일은 업데이트로 내장 전이표가 바뀔 때도 풀립니다 |
| 드라이브가 기록한 식별값이나 스캔한 매핑과 다름 | 기동 때 대조합니다(아래) |
| 기록 안 벤치 증거가 기록 머리와 어긋남 | 되돌리면 다시 열립니다 |
| 업데이트가 필수 항목을 더하거나 기준을 올림 | 변경 이력에 「드라이브 재벤치 필요」로 알립니다(§6.1) |
다시 벤치할 때는 같은 파일로 합니다. 기록이 더는 성립하지 않는 파일도 벤치가 기록을 바꿉니다. 승인이 성립하는 파일은 벤치가 거부합니다.
기동 때 버스는 활성화 전에 드라이브를 기록과 대조합니다. 대조하는 값은 SII 시리얼, SII revision number, 0x1009(하드웨어 버전), 0x100A(소프트웨어 버전), 그리고 scanned 드라이브는 스캔한 매핑의 digest 값입니다. 기록에 적은 항목만 대조하고 null 항목은 건너뜁니다. 다르거나 기록한 값을 읽지 못하면 기동을 거부합니다. 매핑 digest 값이 다르면 두 값을 보여 주되 원인(드라이브·펌웨어 교체, 기록 오기 등)을 하나로 좁히지 않습니다. 명판을 확인하고 다시 벤치하세요. 승인이 어느 드라이브에서 열리는지(identity_)는 벤치 세부에 있습니다.
판정은 기록끼리의 일치입니다. 측정이 참이라는 증명은 아닙니다.
§6.1 bench 파일과 필수 항목
벤치(미승인 파일에 plem drive run 이 제안)는 잰 값을 임시 디렉터리의 이 파일에 쓰고, C++ 판정 도구에 넘긴 뒤 지웁니다. schema 줄 뒤의 내용은 모델 파일의 approval. 로 통째로 옮겨지므로, 승인 뒤에는 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_(SII 시리얼)와number revision_(SII revision number,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_ 의 축, 스캔한 매핑 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_ 없음, 모든 축 정지·체결, 축마다 평균 감속 ≤ 1.1 × limits. | csp·csv 축이 있고 cst 축이 없는 버스 |
disable-engage | 서 있는 축에 protective_: 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 값이 바뀜(승인이 풀림) | 바뀌지 않음 |
|---|---|
모든 값. model. 과 축 이름 포함 | 주석, 들여쓰기, 키 순서 |
slaves·axes·sync_·pdos·entries·startup_ 의 순서 | 0x0600 과 1536(정수는 값으로 비교) |
mode_, write_, acceleration_ | mode_ 을 뺀 것과 pre_ 을 적은 것 |
실제로 쓰는 전이표(profile_ 도) | bus., stored_, approval 블록 |
§8 어디서 검사하는지
| 검사 대상 | 검사하는 곳 |
|---|---|
| 형식, 키, 값 범위, 이름, 한계, SDO 목록, 전이표, 승인 기록 | 로더. plem drive check 와 plem drive run 이 같게 판정합니다 |
generated·선언 매핑의 필수 항목과 주소 겹침 | 드라이브 없이 plem drive check, 그리고 기동 때 버스 |
scanned 매핑, sync0_ 가 주기의 배수인지, 기록과 드라이브 식별값의 대조, stored_ 값 | 기동 때 버스만 |
factors·flip·한계가 기계에 맞는지, 브레이크와 엔코더 종류 | 아무도 판정하지 않습니다. 일부는 벤치가 확인합니다(§6.1) |
§9 제공하지 않는 것
다음은 값과 상관없이 거부됩니다.
- 축의
ramp블록(예전 버스 루프 안 보간). 지우라는 메시지가 나옵니다. 이동은 클라이언트(plem drive run의 궤적 컨트롤러, Pythonplem.의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_ 만 받습니다. 기존 v1 파일을 같은 값·digest 그대로 읽는 변경이면 스키마는 v1 그대로입니다. 움직임을 막는 것은 버전 표시가 아니라 승인입니다(§6).
0.10 버전 파일은 옛 키 이름을 씁니다. 그대로 두면 거부되고, 메시지는 새 키가 없다거나 옛 키·값을 모른다고 나옵니다. 아래처럼 이름만 바꾸면 됩니다. digest 값이 바뀌지 않으므로 기존 승인은 그대로 유지됩니다.
| 0.10 | 지금 |
|---|---|
cia402_ | controlword |
axes[]. | mode_ |
승인 기록과 벤치 claims. 의 serial | serial_ |
pdo_ | pdo_ |
bus. | bus. |