一个用于驱动漫游机器人的Python驱动程序
roverpro的Python项目详细描述
RoverPro Python套件
这是Rover Robotics“Rover Pro”机器人的官方Python驱动程序。以此为起点,快速启动并运行。在
此软件包包括:
- 一个Python库,用于通过USB与Rover进行编程接口
- 用于升级和配置月球车固件的命令行应用程序“
pitstop
” - 确认固件和硬件按预期运行的测试套件。在
设置
要从PyPi安装官方版本:
python3 -m pip install -U pip setuptools python3 -m pip install -U roverpro --no-cache-dir
在Linux上,您可能没有访问USB设备的权限。如果是这种情况,请运行以下操作,然后重新启动计算机:
^{pr2}$pitstop
Pitstop是一个帮助程序,用于引导您的月球车并设置选项。安装roverpro包后,可以使用pitstop
或python3 -m roverpro.pitstop
调用它。在
> pitstop --help usage: pitstop [-h] [-p port] action ... Rover Pro companion utility to upgrade firmware, configure settings, and test hardware health. positional arguments: action flash write the given firmware hex file onto the rover checkversion Check the version of firmware installed test Run tests on the rover config Update rover persistent settings optional arguments: -h, --help show this help message and exit -p port, --port port Which device to use. If omitted, we will search for a possible rover device
测试
要运行测试,首先通过断开电缆连接探测器,然后运行pitstop test
。
默认情况下,涉及运行电机的测试将被跳过,因为你可能不想让一个漫游者从你的计算机上扯下电缆。如果您已经确定运行电机不会损坏任何东西,可以选择使用标志--motorok
进行这些测试。在
> pitstop test --motorok Scanning for possible rover devices Using device /dev/ttyUSB0 ========================== test session starts ============================ platform linux -- Python 3.8.2, pytest-5.4.3, py-1.9.0, pluggy-0.13.1 rootdir: /home/dan/Documents/roverpro-python/roverpro plugins: trio-0.6.0 collected 73 items tests/test_bootloader.py .s [ 2%] tests/test_find_device.py ..... [ 9%] tests/test_roverpro_protocol.py .... [ 15%] tests/test_rover.py ..................x.x.........x................Xxxx.......... [ 98%] tests/burnin/test_burnin.py s [100%] ===== 64 passed, 2 skipped, 6 xfailed, 1 xpassed in 83.94s (0:01:23) =====
开发设置
手动先决条件:
- Python3(建议安装Python3.6、Python3.7和Python3.8,如果您计划对所有人使用tox):
- 在Ubuntu上:
sudo apt install python3 python3-venv python3-pip
- 在另一个操作系统上:https://www.python.org/downloads/
- 在Ubuntu上:
- Poetry:
curl -sSL https://raw.githubusercontent.com/sdispater/poetry/master/get-poetry.py | (python3 || python)
然后获取并初始化项目:
git clone https://github.com/RoverRobotics/roverpro-python.git
cd roverpro-python
poetry install
poetry run githooks setup
要运行单个命令:poetry run pitstop --help
有用的命令
注意,您没有调用poetry shell
,必须在下面的前面加上poetry run
注意事项
- 在调试模式下以PyCharm运行时,您将收到一个警告,如“RuntimeWarning:您似乎已经有了一个自定义的系统异常挂钩已安装处理程序…https://github.com/python-trio/trio/issues/1553
- 注意这是一个pyproject(PEP-517)项目,因此它不能用于
pip install --editable ...
进行开发。请使用poetry install
,如上所述。在
- 项目
标签: