跳转到内容

AGVC Python SDK 运行示例

1 简介

本文档旨在为开发者提供 AGVC Python SDK 的使用说明,包括运行环境要求、下载与安装及使用案例,适用于所有使用该 SDK 进行 AGV 开发和集成的开发者。

2 运行环境要求

Python SDK

  • 支持的操作系统:Linux 64 位、Windows 64 位
  • 支持的硬件平台:x86 平台
  • Python 版本要求:
    • Linux x86:Python 3.6 ~ Python 3.12
    • Windows x86:Python 3.6 ~ Python 3.12

3 安装与卸载

3.1 下载与安装方法

方法 1:在 PyPI 官网下载安装

  1. 打开 PyPI 网址:https://pypi.org/
  2. 搜索 “pyaubo-agvc-sdk”
  3. 下载 pyaubo-agvc-sdk:
  4. 进入包详情页,点击“Download files”,在“Built Distributions”栏选择对应版本的.whl文件下载
  5. 切换到.whl文件所在目录,通过pip安装(以Linux x86 Python 3.10为例):
    bash
    pip install pyaubo_agvc_sdk-0.1.0-cp310-cp310-manylinux2014_x86_64.whl
  6. 安装成功示例:

方法 2:通过 pip 命令直接安装

  • 安装最新版本:
    bash
    pip install pyaubo-agvc-sdk
  • 安装指定版本(以 0.2.0 为例):
    bash
    pip install pyaubo-agvc-sdk==0.2.0

方法 3:通过 PyCharm 安装

  1. 打开File -> Settings
  2. Python Interpreter页面点击+标志
  3. 搜索“pyaubo-agvc-sdk”,选择版本后点击Install Package

3.2 卸载方法

方法 1:通过 pip 命令卸载

bash
pip uninstall pyaubo-agvc-sdk

方法 2:通过 PyCharm 卸载

  1. 打开File -> Settings
  2. Python Interpreter界面选择pyaubo-sdk,点击-标志卸载,完成后点击OK

4 使用案例

4.1 SDK PC 端与机器人通信设置

SDK PC 端可通过以下两种方式与机器人通信:

1. 无线网络通信

通过无线局域网(Wi-Fi)实现通信,步骤如下:

  1. 在 PC 端连接机器人发出的 Wi-Fi 热点
  2. 测试网络连通性:
    • 方法 1:使用 ping 命令
      打开终端,输入ping 192.186.192.100,通信成功示例:
    • 方法 2:使用 telnet 命令
      打开终端,输入 telnet 192.168.192.100 30104,通信成功示例:

2. 有线网络通信

通过以太网连接实现通信,步骤如下:

  1. 用网线连接控制柜与 PC
  2. 配置网络参数(确保 PC 与机器人在同一网段):
    • IP 地址前缀需一致(例如机器人 IP 为 192.168.192.100,PC IP 前缀需为 192.168.192
    • 子网掩码均为 255.255.255.0
    • 网关需相同(通常设为 192.168.192.1
  3. 测试网络连通性:
    • 方法 1:使用 ping 命令
      打开终端,输入 ping 192.186.192.100,通信成功示例:
    • 方法 2:使用 telnet 命令
      打开终端,输入 telnet 192.168.192.100 30104,通信成功示例:

4.2 运行 Python SDK 示例

在 Linux 环境下

  1. 方式 1:使用 IDE 编译并运行 example.py
  2. 方式 2:在终端中运行:
    bash
    python 脚本路径/example.py
  3. 运行成功后,终端将打印信息,机器人向前行驶:

在 Windows 环境下

  1. 在 PyCharm 工程中新建 test.py 文件
  2. 点击运行按钮执行脚本