1.33 1.32 1.31 1.30 1.29 1.28 1.20 Korean English Chinese Czech Dutch French German Hungarian Italian Japanese Polish Portuguese Spanish
1.33 1.32 1.31 1.30 1.29 1.28 1.20 Korean English Chinese Czech Dutch French German Hungarian Italian Japanese Polish Portuguese Spanish
Breadcrumbs

API manual (V1.33)

● 머리말

두산로보틱스의 API는 프로그래밍 언어 C/C++로 개발되었으며, 두산 로봇 컨트롤러를 티치 펜던트가 아닌 별도의 사용자 어플리케이션에서 직접 제어하기 위해 사용할 수 있습니다. 본 API 매뉴얼은 위한 API 함수 및 기능에 대해 설명하고 있습니다.

본 매뉴얼의 내용은 작성된 시점을 기준으로 하며, 제품에 대한 정보는 사용자에게 사전 고지 없이 변경될 수 있습니다.

개정된 매뉴얼에 대한 상세 정보는 Robot LAB (https://robotlab.doosanrobotics.com/)에서 확인하십시오.


● 저작권

본 매뉴얼의 모든 내용과 도안에 대한 저작권 및 지적재산권은 두산로보틱스에 있습니다. 따라서 두산로보틱스의 서면 허가 없이 사용, 복사, 유포하는 어떠한 행위도 금지됩니다. 또한 특허권을 오용하거나 변용하는데 따르는 책임은 전적으로 사용자에게 있습니다.

본 매뉴얼은 신뢰할 수 있는 정보지만 오류 또는 오탈자로 인한 손실에 대해 어떠한 책임도 지지 않습니다. 제품 개선에 따라 매뉴얼에 포함된 정보는 예고 없이 변경될 수 있습니다.

© Doosan Robotics Inc., All rights reserved


문서 제/개정 이력

개정번호

제/개정 페이지 및 내용

개정 일자

1.0

최초 작성 및 배포

2018-06-29

1.1

신규 기능 추가

2020-05-13

1.11

함수 이름 변경(DRL Style)

2020-05-28

1.12

헤더 분할(CDRFLEx 추가)

2020-06-08

1.13

Flange_serial 기능 등 추가

2020-10-19

1.14

오타수정 / 일부 함수 수정

(movesj/set_safe_stop_reset_type/

close_connection 등)

2021-02-18

1.15

누락 함수 추가

set_user_home

flange_serial_read 파라미터 추가(timeout)

2021-03-19

1.16

누락 함수 추가

servo_off 함수

flange_serial_read 기능 추가

2021-03-24

1.17

버전정보 수정 : GL010110

2021-06-09

1.18

버전 정보 수정 : GL010111

신규 기능 추가 : get_override_speed

2021-09-15

1.19

버전 정보 수정 : GL010112

신규 기능 추가

. ikin(extension) 추가

. set_monitoring_robot_system 추가

. change_collision_detection 추가

. add_sw_module 추가

. del_sw_module 추가

. update_sw_module 추가

. release_protective_stop 추가

. set_on_monitoring_update_module 추가

2021-11-22

1.2

버전 정보 수정 : GL010113

신규 기능 추가

. 실시간 제어 위한 함수 추가(별도 매뉴얼 참고)

. set_safety_mode 추가

. set_on_monitoring_state 추가

2021-12-16

1.21

신규 기능 추가

. set_auto_servo_off

2021-12-19

1.22

버전 정보 수정 : GL010114

get_robot_state 중복 변경(오기) -> get_program_state로 변경

set_safe_stop_reset_type 예제에 enum 파라미터 수정

so 파일 관련 설명 수정(64bits POCO 라이브러리)

신규 기능 추가

. servoj / servol / speedj / speedl

. get_safety_configuration

안전 설정 반환값을 위한 신규 구조체 추가 : SAFETY_CONFIGURATION_EX

2022-02-11

1.23

3.3.21 : 인수 부분TOnMonitoringSafetyState -> TOnMonitoringSafetyStateCB로 변경

strcut.MESSAGE_PROGRESS 추가

3.7.14 : 인수 부분 TYPE_TYPE -> DATA_TYPE으로 변경

열거형 상수 SAFETY_MODE / SAFETY_EVENT 추가

3.8.11 인수 부분에 enum -> enum.MODBUS_REGISTER_TYPE으로 수정

열거형 상수 COORDINATE_SYSTEM 추가

열거형 상수 ROBOT_STATE 표기 오류 해결

get_override_speed 삭제

실시간 제어 관련 내용 추가(chapter 4)

2022-03-10

1.24

enum.SAFETY_MODE_EVENT 관련 내용 수정

set_safety_mode 예제의 SAFETY_MODE_EVENT 파라미터 관련 내용 수정

flange_serial 관련 명령어에 port 파라미터 추가 (신규 플랜지에서 사용 가능함을 명시)

버전 정보 변경 -> GL010115

신규 함수 추가

  • set_workpiece_weight

  • set_mode_tool_analog_input

  • set_tool_digital_output_type

  • set_tool_digital_output_level

  • get_tool_analog_input

enum.COG_REFERNCE 추가

enum.ADD_UP 추가

enum.OUTPUT_TYPE 추가

2022-04-29

1.25

flange_serial_open/close 함수 port 삭제

set_tool / set_workpiece_weight 함수 경고 문구 추가

2022-05-04

1.26

enum.CONTROL_SPACE 오타 수정

set_on_monitoring_safety_state 오타 수정

MOVE_REFERENCE enum에 월드 / 사용자 좌표계 추가

change_operation_speed 값 범위 변경

TOnRobotSystemCB 수정

property 함수 10개 추가

get_current_posj

get_control_space

get_current_velj

get_desired_posj

get_current_tool_flange_posx

get_current_velx

get_desired_velx

get_joint_torque

get_external_torque

get_tool_force


enum추가 : ROBOT_SPACE

struct 추가 : ROBOT_VEL /ROBOT_FORCE

2022-06-02

1.27

drl_stop 함수 파라미터 수정 : enum.STOP_TYPE -> unsigned char

2022-07-04

1.28

enum.ROBOT_STATE 설명 수정

enum.ROBOT_MODE 내용 추가

enum.ROBOT_SPACE 중복 부분 삭제

set_palletizing_mode 명령어 추가

move_home 주의사항 추가

2023-02-20

1.29

query_modbus_data_list 명령어 추가

2023-03-24

1.30

Arm64용 Drfl 바이너리 추가

Ubuntu 22.04 버전 지원

Realtime 성능 개선

Blending 모션 관련 이슈 개선

enum 추가 : MOVE_ORIENTATION, SPIRAL_DIR, ROT_DIR, DR_SERVOJ_TYPE

struct 추가 : SAFETY_CONFIGURATION_EX2, CONFIG_SAFETY_IO_OP

movej 각 축별 속도 및 가속도 조절 인자 추가

flange_serial_read : 리턴 값 변경

movejx : 확장 movejx 인자 추가

amovej : 확장 amovej 인자 추가

amovejx : 확장 amovejx 인자 추가

servoj : 확장 인자 추가 

신규 함수 추가

  • get_safety_configuration(Extension)

  • ikin(Add_iter_threshold)

  • ikin_norm

  • movec(Extension)

  • amovec(Extension)

  • move_spiral(Extension)

  • amove_spiral(Extension)

  • servoj (Extension)

2024-11-26

1.31

제어기(DRCF) 버전 선언 옵션 추가 ( #define DRCF_VERSION)

신규 제어기 용 인터페이스

  • MONITORING_CTRLIO_EX2 추가

  • READ_CTRLIO_INPUT_EX2 추가 

  • READ_CTRLIO_OUTPUT_EX2 추가 

  • GPIO_CTRLBOX_DIGITAL_INDEX 확장

  • SAFETY_CONFIGURATION_EX2_V3 추가

신규 제어기 용 API 추가

  • get_safety_configuration_ex 삭제

  • get_safety_configuration 신규 기능으로 업데이트

중복 함수 제거 

  • SetOnMonitoringData 함수 제거 (set_on_monitoring_data 와 중복)

  • SetOnMonitoringCtrlIO 함수 제거(set_on_monitoring_ctrl_io 와 중복)

2024-12-03

1.32

업데이트 기능

  • 용접 관련 API 추가

업데이트 정의

  • struct.ROBOT_WELDING_DATA

  • struct.WELDING_CHANNEL

  • struct.CONFIG_WELDING_INTERFACE

  • struct.CONFIG_WELD_SETTING

  • struct.GET_WELDING_SETTING_RESPONSE

  • struct.ADJUST_WELDING_SETTING

  • struct.CONFIG_TRAPEZOID_WEAVING_SETTING

  • struct.CONFIG_ZIGZAG_WEAVING_SETTING

  • struct.CONFIG_CIRCULE_WEAVING_SETTING

  • struct.CONFIG_SINE_WEAVING_SETTING

  • struct.CONFIG_WELDING_DETAIL_INFO

  • struct.CONFIG_ANALOG_WELDING_INTERFACE

  • struct.CONFIG_ANALOG_WELDING_SETTING

  • struct.ANALOG_WELDING_ADJUST_SETTING

  • struct.CONFIG_DIGITAL_WELDING_IF_MAPPING_DATA

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_PROCESS

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_MODE

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_TEST

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_CONDITION

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_OPTION

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_PROCESS2

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_MONITORING

  • struct.CONFIG_DIGITAL_WELDING_INTERFACE_OTHER

  • struct.DIGITAL_WELDING_RESET

  • struct.CONFIG_DIGITAL_WELDING_MODE

  • struct.CONFIG_DIGITAL_WELDING_CONDITION

  • struct.CONFIG_DIGITAL_WELDING_ADJUST

  • struct.MEASURE_TCP_WELDING

  • struct.TACK_WELDING_SETTING

  • struct.DIGITAL_FORCE_WRITE_DATA

  • struct.ROBOT_DIGITAL_WELDING_DATA

  • struct.DIGITAL_WELDING_COMM_STATE

업데이트 함수

  • set_on_monitoring_welding_data

  • set_on_monitoring_analog_welding_data

  • set_on_monitoring_digital_welding_data

  • app_weld_weave_cond_trapezoidal

  • app_weld_weave_cond_zigzag

  • app_weld_weave_cond_circular

  • app_weld_weave_cond_sinusoidal

  • app_weld_enable_analog

  • app_weld_set_weld_cond_analog

  • app_weld_adj_welding_cond_analog

  • app_weld_set_interface_eip_m2r_process

  • app_weld_set_interface_eip_r2m_mode

  • app_weld_set_interface_eip_r2m_process

  • app_weld_set_interface_eip_r2m_test

  • app_weld_set_interface_eip_r2m_condition

  • app_weld_set_interface_eip_r2m_option

  • app_weld_set_interface_eip_m2r_process2

  • app_weld_set_interface_eip_m2r_monitoring

2025-01-15

1.33

버전 정보 수정 : GL013300

업데이트 기능 :

  • 모든 Auto mode 는 safety event 가 move(점등)모드로 변경

  • Monitoring 내 force control 모니터링이 제대로 올라오지 않는 부분 수정

  • Update flange serial command for Flange Version rev2

업데이트 함수:

  • 로봇 설정 함수 - LED 관련 함수 추가

    • state_led_reset

    • set_state_led_off

    • set_state_led_color

    • get_state_led_rule

  • I/O 제어 함수 - Flange serial open / close 에 port 입력변수 추가

    • flange_serial_open

    • flange_serial_close

2025-09-02