4.8 알람 정보

개요

알람 모듈은 로봇 알람 정보를 읽고, 재설정하고, 쿼리하는 기능을 제공하여 작동 중 발생할 수 있는 이상 현상을 모니터링하고 처리할 수 있습니다.

핵심 기능

• 알람 재설정 지원
• 모든 활성 알람 수신 지원
• 우선순위가 가장 높은 알람 수신 지원
• 알람 출력 언어 지정 지원

사용 사례

• 로봇 동작 상태를 모니터링하고 이상 징후를 적시에 감지
• 로봇 작동 중 오류 및 알람 처리
• 로봇 알람 이력 기록 및 분석
• 자동화된 경보 처리 프로세스 구현
• 로봇 모니터링 시스템에 통합

4.8.1 알람 재설정

메서드 이름	alarm.reset() -> StatusCodeEnum
설명	현재 오류를 재설정합니다./alarms.
요청 매개변수	없음
반환 값	StatusCodeEnum: 함수 실행 결과.
호환 로봇 소프트웨어 버전	협업(Copper): v7.5.0.0+ 산업용(Bronze): v7.5.0.0+

4.8.2 모든 활성 알람 가져오기

메서드 이름	alarm.get_all_active_alarms( language : LanguageType) -> tuple[list, StatusCodeEnum]
설명	현재 활성화된 모든 알람을 가져옵니다.
요청 매개변수	language : LanguageType 출력 언어( LanguageType.English 또는 LanguageType.Chinese ).
반환 값	목록: 활성 알람 항목. StatusCodeEnum: 함수 실행 결과.
호환 로봇 소프트웨어 버전	협업(Copper): v7.5.0.0+ 산업용(Bronze): v7.5.0.0+

4.8.3 최우선 순위 알람 받기

메서드 이름	alarm.get_top_alarm() -> tuple[ROBOT_ALARM, StatusCodeEnum]
설명	가장 높은 우선순위로 알람을 가져옵니다.
요청 매개변수	없음
반환 값	ROBOT_ALARM : 우선순위가 가장 높은 경보입니다. StatusCodeEnum: 함수 실행 결과.
호환 로봇 소프트웨어 버전	협업(Copper): v7.5.0.0+ 산업용(Bronze): v7.5.0.0+

예제 코드

alarm.py

#!python
"""
Copyright © 2016 Agilebot Robotics Ltd. All rights reserved.
Instruction: 告警功能使用示例 / Example of using the alarm function
"""

from Agilebot import Arm, StatusCodeEnum

# [ZH] 初始化捷勃特机器人
# [EN] Initialize the robot
arm = Arm()

# [ZH] 连接捷勃特机器人
# [EN] Connect to the robot
ret = arm.connect("10.27.1.254")
if ret == StatusCodeEnum.OK:
    print("机器人连接成功 / Robot connected successfully")
else:
    print(f"机器人连接失败，错误代码 / Robot connection failed, error code: {ret.errmsg}")
    arm.disconnect()
    exit(1)

# [ZH] 获取所有的活动的报警
# [EN] Get all active alarms
alarms, ret = arm.alarm.get_all_active_alarms()
if ret == StatusCodeEnum.OK:
    print("获取报警信息成功 / Get alarm information successfully")
    for alarm in alarms:
        print(alarm)
else:
    print(f"获取报警信息失败，错误代码 / Failed to get alarm information, error code: {ret.errmsg}")
    arm.disconnect()
    exit(1)

# [ZH] 获取所有的活动的报警
# [EN] Get all active alarms
alarm, ret = arm.alarm.get_top_alarm()
if ret == StatusCodeEnum.OK:
    print("获取报警信息成功 / Get alarm information successfully")
    for alarm in alarm:
        print(alarm)
else:
    print(f"获取报警信息失败，错误代码 / Failed to get alarm information, error code: {ret.errmsg}")
    arm.disconnect()
    exit(1)

# [ZH] 重置报警
# [EN] Reset alarms
ret = arm.alarm.reset()
if ret == StatusCodeEnum.OK:
    print("报警重置成功 / Alarm reset successfully")
else:
    print(f"报警重置失败，错误代码 / Alarm reset failed, error code: {ret.errmsg}")
    arm.disconnect()
    exit(1)

# [ZH] 断开捷勃特机器人连接
# [EN] Disconnect from the robot
arm.disconnect()
print("机器人断开连接成功 / Robot disconnected successfully")

---