日志管理接口

log_download_by_quantity - 保存日志到文件

方法： download_logs(socket_fd: int, quantity: int, file_path: str)

功能描述： 下载并保存机械臂控制器的指定数量日志到本地文件系统。

参数：

socket_fd：已连接的机械臂控制器句柄，整型格式。
quantity：要下载的日志条数，整型格式。
file_path：日志文件的保存路径，字符串格式。

返回值：

int：安全断开执行状态码
- 0：成功。成功获取控制器指定条数的日志并写入本地文件。
- 非0：失败。句柄无效，或底层接口返回非 0 错误码，或触发通信异常。

使用示例：

Python

import nrc_interface as nrc

# 1. 校验句柄并调用底层接口下载日志
if self.socket_fd and self.socket_fd > 0:
    ret = nrc.log_download_by_quantity(self.socket_fd, count, save_path)

    # 2. 校验执行结果并透传状态码
    if ret == 0:
        print("日志下载成功")
        return 0
    else:
        print("日志下载失败")
        return ret
else:
    print("日志下载失败")
    return -1