蓝色机器人ping1d回声探测仪的python模块
bluerobotics-ping的Python项目详细描述
BlueRobotics Ping
Ping声纳的Python库。Ping是一款简单、价格实惠、体积小巧的超声波高度计,适用于任何水上项目。
这个库公开了设备的所有功能,例如获取配置文件、控制参数、切换模式,或者只是简单地读取距离测量。
资源
安装
PIP
$ pip install --user bluerobotics-ping
来源
$ git clone https://github.com/bluerobotics/ping-python.git
$ cd ping-python
$ python setup.py install --user
库已准备好使用:import brping
。如果要使用此包提供的命令行examples或tools,请按照python的installing to user site说明(例如export PATH=PATH:~/.local/bin
)中的说明进行操作。
快速启动
bluerobotics-ping
包安装一个simplePingExample.py
脚本开始。将设备的文件描述符(例如/dev/ttyUSB0
,COM1
)放在--device选项之后。
$ simplePingExample.py --device <your-device>
用法
Ping1D类提供了配置ping设备和检索数据的简单接口。
ping1d对象必须用串行设备路径和波特率初始化。
frombrpingimportPing1DmyPing=Ping1D("/dev/ttyUSB0",115200)
调用initialize()与设备建立通信。
ifmyPing.initialize()isFalse:print("Failed to initialize Ping!")exit(1)
使用^{
data=myPing.get_distance()ifdata:print("Distance: %s\tConfidence: %s%%"%(data["distance"],data["confidence"]))else:print("Failed to get distance data")
使用^{
# set the speed of sound to use for distance calculations to# 1450000 mm/s (1450 m/s)myPing.set_speed_of_sound(1450000)
有关完整的api文档,请参阅doxygen文档。