Python SDK#
安装统一 robobaton_sdk,直接订阅公开 HTTP,不复制 RBH1 解析实现。
获取与运行#
先在 统一 SDK 接入 下载并解压 SDK,在包含 SDK/ 的目录使用 Python 3.8+:
python3 -m pip install -e SDK/python
python3 SDK/python/examples/odometry.py http://192.168.11.1 --messages 10
python3 SDK/python/examples/odometry.py http://192.168.11.1 --channel imu
Windows 可将 python3 替换为 py -3。核心客户端仅依赖标准库;不安装时可把 SDK/python 加入 PYTHONPATH,再运行同一示例。系统禁止全局 pip 安装时使用自己的虚拟环境,不强制修改系统 Python。
接入自己的程序#
SDK 包公开入口,直接来自本次源码快照#
from .client import Device
__all__ = ['Device']
from robobaton_sdk import Device
stream = Device('http://192.168.11.1').observe(['odometry'])
try:
for name, fmt, sequence, message in stream:
if name == 'odometry':
print(message['header'], message['pose'], message['twist'])
finally:
stream.close()
每个连接只选择一个通道:odometry、imu、preview、color、gray、gray_jpeg 或 depth。 同时需要多个通道时分别创建连接,不把到达顺序当同步关系。图像 data 是二进制,不直接按 JSON 打印像素。 Device 也保留公开管理方法;本页接收示例不调用写接口,写操作应另读 HTTP API 接入 的幂等和并发规则。
完整位姿 / IMU 示例#
直接来自 SDK/python/examples/odometry.py#
import argparse
import json
from robobaton_sdk import Device
def main():
parser = argparse.ArgumentParser(description='只读订阅 Neo HTTP 数据')
parser.add_argument('origin', nargs='?', default='http://192.168.11.1')
parser.add_argument('--channel', choices=['odometry', 'imu'], default='odometry')
parser.add_argument('--messages', type=int, default=10)
args = parser.parse_args()
if args.messages < 1:
parser.error('--messages 必须大于 0')
stream = Device(args.origin).observe([args.channel])
remaining = args.messages
try:
for name, fmt, sequence, message in stream:
if name == 'control':
continue
print(json.dumps(message, ensure_ascii=False))
remaining -= 1
if remaining == 0:
break
if remaining:
raise ConnectionError('数据流提前结束,请检查设备后重新建立会话')
finally:
stream.close()
if __name__ == '__main__':
main()
获取与保存图像#
mkdir -p tmp/neo-images
python3 SDK/python/examples/image.py http://192.168.11.1 tmp/neo-images --messages 10
直接来自 SDK/python/examples/image.py#
import argparse
import json
from pathlib import Path
from robobaton_sdk import Device
def main():
parser = argparse.ArgumentParser(description='Save public gray JPEG frames and source metadata')
parser.add_argument('origin')
parser.add_argument('directory', type=Path)
parser.add_argument('--messages', type=int, default=10)
args = parser.parse_args()
if args.messages < 1 or not args.directory.is_dir():
parser.error('Use a positive message count and an existing output directory')
stream = Device(args.origin).observe(['gray_jpeg'])
received = 0
try:
for name, fmt, sequence, sample in stream:
if name != 'gray_jpeg':
continue
path = args.directory / (str(sequence) + '.jpg')
sidecar = args.directory / (str(sequence) + '.json')
if path.exists() or sidecar.exists():
raise FileExistsError('Use a fresh output directory')
with path.open('xb') as output:
output.write(sample['data'])
metadata = {key: value for key, value in sample.items() if key != 'data'}
with sidecar.open('x', encoding='utf-8') as output:
json.dump(metadata, output, separators=(',', ':'))
print(path)
received += 1
if received >= args.messages:
return
raise ConnectionError('Image stream ended before requested frame count')
finally:
stream.close()
if __name__ == '__main__':
main()
每帧保存 JPEG 与同名 JSON,拒绝覆盖已有文件;文件名采用 RBH1 消息序号。 JSON 保留原设备 header 与配置。gray_jpeg 为 544×640 mono8、质量90、源帧率模式, 不承诺固定频率。此示例不完整解码 JPEG;位姿与图像独立连接,不自动同步配对。 设备时间为开机单调时间或 null,不是 UTC;相机光学系不同于 IMU 系。
输出与失败处理#
默认收 10 条业务消息,control 元数据不计数。null 位姿仍原样输出,不代表有效定位; 若想收齐有效位姿与图像,使用 Python 快速验证 的快速验证。 连接错误、协议错误或未收够消息就结束会退出,不自动重连;finally 释放订阅。 时间、坐标和空值约定见 统一 SDK 接入。收到数据不代表标定精度通过。