Skip to content

역학 기능


1. 충돌 감지

충돌 감지 스위치 설정

필드타입설명
0x7406COLLISION_DETECTION_SET

요청 파라미터:

파라미터명타입필수설명
switchbool충돌 감지 스위치
json
{
  "switch": true
}

충돌 감지 스위치 상태 획득

필드타입설명
0x7407COLLISION_DETECTION_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7408COLLISION_DETECTION_RESPOND

응답 파라미터:

파라미터명타입설명
is_identificationbool식별 상태
restrart_switchbool재시작 스위치
switchbool충돌 감지 스위치
json
{
  "is_identification": true,
  "restrart_switch": true,
  "switch": true
}

충돌 감지 파라미터 설정

필드타입설명
0x7409COLLISION_DETECTION_PARAM_SET

요청 파라미터:

파라미터명타입필수설명
Co_De_paraarray[double]임계값, 배열 길이 6
error_enable_timedouble오차 허용 시간
pos_delay_timedouble명령 위치 응답 시간
json
{
  "Co_De_para": [3.0, 4.0, 5.0, 6.0, 7.0, 8.0],
  "error_enable_time": 2.0,
  "pos_delay_time": 1.0
}

충돌 감지 파라미터 획득

필드타입설명
0x740ACOLLISION_DETECTION_PARAM_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x740BCOLLISION_DETECTION_PARAM_RESPOND

응답 파라미터: 0x7409와 동일


2. 토크 피드포워드

토크 피드포워드 스위치 설정

필드타입설명
0x740CTORQ_FEEDBACK_SET

요청 파라미터:

파라미터명타입필수설명
torqFeedbackbool토크 피드포워드 스위치
json
{
  "torqFeedback": true
}

토크 피드포워드 상태 조회

필드타입설명
0x740DTORQ_FEEDBACK_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x740ETORQ_FEEDBACK_RESPOND

응답 파라미터: 0x740C와 동일


3. 드래그 티치

드래그 티치 조회

필드타입설명
0x7501DRAG_TRAJ_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7502DRAG_TRAJ_RESPOND

응답 파라미터:

파라미터명타입필수설명
TrajNamearray[string]궤적 이름 목록
json
{
  "TrajName": ["RRR", "TTT"]
}

드래그 티치 파라미터 설정

필드타입설명
0x7504DRAG_PARAM_SET

요청 파라미터:

파라미터명타입필수설명
DecareLimitdouble데카르트 공간 선속도 제한
JointVelLimitdouble관절 공간 속도 제한
drag_modeint드래그 모드: 0-자유 드래그, 1-위치 드래그, 2-자세 드래그
frictionOffsetarray[double]1-6관절 마찰력 보상 보정 계수
dragCoefficientarray[double]관절 한계 초과 저항 계수, 길이 6, 범위 [1,100]
json
{
  "DecareLimit": 1.0,
  "JointVelLimit": 2.0,
  "drag_mode": 0,
  "frictionOffset": [3.0, 3.0, 3.0, 3.0, 3.0, 3.0],
  "dragCoefficient": [5.0, 5.0, 5.0, 5.0, 5.0, 5.0]
}

드래그 티치 파라미터 획득

필드타입설명
0x7505DRAG_PARAM_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7506DRAG_PARAM_RESPOND

응답 파라미터: 0x7504와 동일


4. 드래그 궤적 관련

드래그 티치 궤적 재생 파라미터 설정

필드타입설명
0x7507DRAG_TRAJ_PARAM_SET

요청 파라미터:

파라미터명타입필수설명
MaxSamplingNumdouble최대 샘플링 포인트 수
SamplingIntervaldouble샘플링 간격
Startboolfalse-종료, true-시작
json
{
  "MaxSamplingNum": 3000.0,
  "SamplingInterval": 0.030,
  "Start": false
}

드래그 궤적 파라미터 조회

필드타입설명
0x7508DRAG_TRAJ_PARAM_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7509DRAG_TRAJ_PARAM_RESPOND

응답 파라미터: 0x7507과 동일

궤적 기록 여부 조회

필드타입설명
0x750ADRAG_TRAJ_RECORD_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x750BDRAG_TRAJ_RECORD_RESPOND

응답 파라미터:

파라미터명타입필수설명
recordbool드래그 궤적 기록 여부
json
{
  "record": true
}

궤적 재생

필드타입설명
0x750CDRAG_TRAJ_PLAYBACK

요청 파라미터:

파라미터명타입필수설명
trajNamestring궤적 이름
velint궤적 재생 속도, 티치 펜던트가 고정적으로 100 전송
json
{
  "trajName": "",
  "vel": 100
}

궤적 저장

필드타입설명
0x750DDRAG_TRAJ_SAVE

요청 파라미터:

파라미터명타입필수설명
TrajNamestring궤적 이름
json
{
  "TrajName": "SSSSS"
}

궤적 삭제

필드타입설명
0x750EDRAG_TRAJ_DELETE

요청 파라미터:

파라미터명타입필수설명
TrajNamestring궤적 이름
json
{
  "TrajName": "SSSSS"
}

드래그 모드 설정

필드타입설명
0x750FDRAG_MODE

요청 파라미터:

파라미터명타입필수설명
modeint드래그 모드: 0-없음, 1-3D 마우스, 2-토크
portint외부 트리거 신호 포트 번호
valueint외부 트리거 신호 값
json
{
  "mode": 2,
  "port": 3,
  "value": 1
}

드래그 모드 조회

필드타입설명
0x7510DRAG_MODE_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7511DRAG_MODE_RESPOND

응답 파라미터: 0x750F와 동일


5. 외부 버튼

기능 제어 파라미터 조회

필드타입설명
0x9114FUNCTIONALCONTROL_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x9115FUNCTIONALCONTROL_RESPOND

배열 인덱스 설명: 0-드래그 모드, 1-점동 모드, 2-궤적 수집 시작, 3-궤적 수집 종료, 4-궤적 재생 시작, 5-上활성화, 6-下활성화, 7-그립 열기, 8-그립 닫기, 9-궤적 저장

응답 파라미터:

파라미터명타입필수설명
IoInPortArrarray[int]트리거 포트(DIN), 배열 길이 11
hardwareTypeArrarray[int]하드웨어 타입: 0-IO, 배열 길이 11
modeArrarray[int]트리거 방식: 0-길게 눌러 트리거 포트, 1-짧게 눌러 트리거 포트, 배열 길이 11
parameterArrarray[int]파라미터: 0-트리거 포트 닫힐 때 트리거, 1-트리거 포트 열릴 때 트리거, 배열 길이 11
json
{
  "IoInPortArr": [1, 2, 3, 4, 5, 0, 6, 7, 8, 9, 10],
  "hardwareTypeArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "modeArr": [0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0],
  "parameterArr": [0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0]
}

상태 알림 조회

필드타입설명
0x9116STATUSPROMPT_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x9117STATUSPROMPT_RESPOND

배열 인덱스 설명: 0-드래그 모드, 1-점동 모드, 2-궤적 수집 시작, 3-궤적 수집 종료, 4-궤적 재생 시작, 5-上활성화, 6-下활성화, 7-그립 열기, 8-그립 닫기

응답 파라미터:

파라미터명타입필수설명
IoDoutPortArrarray[int]트리거 포트(DOUT), 배열 길이 11
hardwareTypeArrarray[int]하드웨어 타입: 0-IO, 배열 길이 11
parameterArrarray[int]파라미터: 0-트리거 포트 닫힘, 1-트리거 포트 열림, 2-깜빡임, 배열 길이 11
json
{
  "IoDoutPortArr": [1, 2, 3, 4, 5, 0, 6, 7, 0, 0, 0],
  "hardwareTypeArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "parameterArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
}

외부 버튼 파라미터 설정

필드타입설명
0x9118EXTERNKEYPARA_SET

요청 파라미터:

파라미터명타입필수설명
_isFunctionalControlbooltrue-기능 제어 파라미터 설정, false-상태 알림 파라미터 설정
hardwareTypeArrarray[int]하드웨어 타입: 0-IO, 배열 길이 11
isClearTrackint저장 후 궤적 제거 여부
modeArrarray[int]트리거 방식: 0-길게 눌러 트리거 포트, 1-짧게 눌러 트리거 포트, 배열 길이 11
parameterArrarray[int]파라미터, 배열 길이 11
portArrarray[int]트리거 포트, 배열 길이 11
json
{
  "_isFunctionalControl": true,
  "hardwareTypeArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "isClearTrack": 1,
  "modeArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "parameterArr": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "portArr": [1, 2, 3, 4, 5, 0, 6, 7, 8, 9, 10]
}

6. 동역학 파라미터

동역학 식별은 정장 일반 6축, 무부하만 지원하며, 식별 관련 파라미터 설정

궤적 파라미터 설정

필드타입설명
0x7601TRAJECTORY_PARAM_SET

요청 파라미터:

파라미터명타입필수설명
traSizedouble궤적 범위
traVeldouble궤적 속도
json
{
  "traSize": 10.0,
  "traVel": 100.0
}

식별 궤적 파라미터 조회

필드타입설명
0x7602TRAJECTORY_PARAM_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7603TRAJECTORY_PARAM_RESPOND

응답 파라미터:

파라미터명타입필수설명
traSizedouble궤적 범위, 범위 0-100
traVeldouble궤적 속도, 범위 0-100
alreadyIdenbooltrue-식별 완료, false-식별 미완료
json
{
  "traSize": 50.0,
  "traVel": 50.0,
  "alreadyIden": false
}

궤적 Z축 최대/최소값 조회

필드타입설명
0x7609TRAJECTORY_ZMAXMIN

0x7601 설정 후 0x7609 반환

응답 파라미터:

파라미터명타입필수설명
zMaxdouble현재 궤적 Z 최대값
zMindouble현재 궤적 Z 최소값
json
{
  "zMax": 100.0,
  "zMin": 100.0
}

궤적 안전 테스트 확정

필드타입설명
0x7604SAFE_CHECK_SET

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7605SAFE_CHECK_RESPOND

응답 파라미터:

파라미터명타입필수설명
Finishint안전 확정
json
{
  "Finish": 1
}

식별 시작

필드타입설명
0x7606IDENTITY_SET

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x7607IDENTITY_RESPOND

응답 파라미터:

파라미터명타입필수설명
errorarray[double]오차 배열, 총 10회 전송
json
{
  "error": [100.0, 100.0, 100.0, 100.0, 100.0, 100.0]
}

식별 완료

필드타입설명
0x7608IDENTITY_FINISH

컨트롤러가 능동적으로 전송, 10회 후 Finish 전송하여 완료 알림

응답 파라미터:

파라미터명타입필수설명
Finishint완료 식별
json
{
  "Finish": 1
}

식별 오류 중지

필드타입설명
0x760AIDENTITY_ERRORSTOP

응답 파라미터:

파라미터명타입필수설명
ErrorStopint오류 중지 식별
json
{
  "ErrorStop": 1
}

7. 부하 활성화

부하 파라미터 설정

필드타입설명
0x8130PAYLOAD_PARA_SET

요청 파라미터:

파라미터명타입필수설명
axis1_actual_torq_conversion_ratiodouble1축 실제 토크 변환비
axis2_actual_torq_conversion_ratiodouble2축 실제 토크 변환비
axis3_actual_torq_conversion_ratiodouble3축 실제 토크 변환비
axis4_actual_torq_conversion_ratiodouble4축 실제 토크 변환비
axis5_actual_torq_conversion_ratiodouble5축 실제 토크 변환비
axis6_actual_torq_conversion_ratiodouble6축 실제 토크 변환비
payload_enablebool부하 활성화
json
{
  "axis1_actual_torq_conversion_ratio": 6.4120,
  "axis2_actual_torq_conversion_ratio": 6.4120,
  "axis3_actual_torq_conversion_ratio": 11.7730,
  "axis4_actual_torq_conversion_ratio": 11.7730,
  "axis5_actual_torq_conversion_ratio": 33.4450,
  "axis6_actual_torq_conversion_ratio": 33.3380,
  "payload_enable": true
}

부하 파라미터 조회

필드타입설명
0x8131PAYLOAD_PARA_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x8132PAYLOAD_PARA_RESPOND

응답 파라미터: 0x8130과 동일


8. 적응형 가감속

적응형 가감속 파라미터 설정

필드타입설명
0x8140AUTO_MODIFY_ACC_PARA_SET

요청 파라미터:

파라미터명타입필수설명
arm_inertiaarray[double]관절 1~3 팔 관성, 배열 길이 3
auto_modify_acc_enablebool활성화
joint1_massdouble관절 1 질량
joint1_mass_center_to_motor_distancedouble관절 1 질량중심에서 모터까지 거리
joint2_massdouble관절 2 질량
joint2_mass_center_to_motor_distancedouble관절 2 질량중심에서 모터까지 거리
joint4_massdouble관절 4 질량
json
{
  "arm_inertia": [4.0, 5.0, 6.0],
  "auto_modify_acc_enable": true,
  "joint1_mass": 1.0,
  "joint1_mass_center_to_motor_distance": 7.0,
  "joint2_mass": 2.0,
  "joint2_mass_center_to_motor_distance": 8.0,
  "joint4_mass": 3.0
}

적응형 가감속 파라미터 조회

필드타입설명
0x8141AUTO_MODIFY_ACC_PARA_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x8142AUTO_MODIFY_ACC_PARA_RESPOND

응답 파라미터: 0x8140과 동일

임계값 파라미터 설정

필드타입설명
0x8147AUTO_MODIFY_ACC_THRESHOLD_PARA_SET

요청 파라미터:

파라미터명타입필수설명
acc_threshold_lowlimitarray[double]가속도 임계값 하한, 배열 길이 4
acc_threshold_lowlimit_valuearray[double]가속도 임계값 하한값, 배열 길이 4
acc_threshold_uplimitarray[double]가속도 임계값 상한, 배열 길이 4
acc_threshold_uplimit_valuearray[double]가속도 임계값 상한값, 배열 길이 4
vel_threshold_lowlimitarray[double]속도 임계값 하한, 배열 길이 4
vel_threshold_lowlimit_valuearray[double]속도 임계값 하한값, 배열 길이 4
vel_threshold_uplimitarray[double]속도 임계값 상한, 배열 길이 4
vel_threshold_uplimit_valuearray[double]속도 임계값 상한값, 배열 길이 4
json
{
  "acc_threshold_lowlimit": [13.0, 14.0, 15.0, 16.0],
  "acc_threshold_lowlimit_value": [13.0, 14.0, 15.0, 16.0],
  "acc_threshold_uplimit": [5.0, 6.0, 7.0, 8.0],
  "acc_threshold_uplimit_value": [5.0, 6.0, 7.0, 8.0],
  "vel_threshold_lowlimit": [9.0, 10.0, 11.0, 12.0],
  "vel_threshold_lowlimit_value": [9.0, 10.0, 11.0, 12.0],
  "vel_threshold_uplimit": [1.0, 2.0, 3.0, 4.0],
  "vel_threshold_uplimit_value": [1.0, 2.0, 3.0, 4.0]
}

임계값 파라미터 조회

필드타입설명
0x8148AUTO_MODIFY_ACC_THRESHOLD_PARA_INQUIRE

요청 파라미터: 없음

컨트롤러 응답

필드타입설명
0x8149AUTO_MODIFY_ACC_THRESHOLD_PARA_RESPOND

응답 파라미터: 0x8147과 동일