模板: OAK-D Get Start
来自Waveshare Wiki
硬件连接
OAK-D
- 将电源接入到OAK-D的电源接口
- 用Type-C线 接OAK-D到电脑或者其他主机的USB3.0 接口
OAK-D-Lite
- 用Type-C先接OAK-D-Lite到电脑或者其他主机的USB3.0接口
OAK-D-PoE/OAK-D-S2-PoE
使用PoE相机,需要使用符合802.3af POE 供电标准的交换机或者路由器。
- 拆开塑料防水外壳,将配套的网线接入到交换机中, OAK-D-PoE需要联网才能正常使用。
- 注意摄像头需要接入到跟主机电脑同一个局域网下的网络,否则程序无法识别到设备。
OAK-D-Pro
- 将Y型转接器接入到OAK-D-Pro
- 用两条Type-C线连接Y型连接器,另一侧,一条UB线调到其他主机的USB3,0接口,另一条连接到5V/2A电源
OAK-D-S2
- 用Type-C先接OAK-D-S2到电脑或者其他主机的USB3.0接口
使用说明
例程下载
为了方便用户上手使用,官方准备了linux, windows平台以及树莓派的depthapi示例和python开发环境。
平台 | 链接 |
---|---|
Windows | https://sourceforge.net/projects/depthai/ |
Raspberry Pi | https://sourceforge.net/projects/oak-rpi-image/ |
Windows
- 从百度网盘下载安装程序。
- 双击打开的exe文件
- 按照提示安装OAKEnvironment软件。
- 建议将安装目录更改到其他的位置
- 勾选添加环境变量
- 点击安装等待安装完成。
- 安装完成之后会在桌面添加一个快捷方式,双击可以直接运行depthai-demo.py程序
Linux
如果你使用的是ubuntu系统,可以直接看下方的ubuntu步骤
- 安装depthai
git clone https://gitee.com/oakchina/depthai.git
- 安装depthai-python
git clone https://gitee.com/oakchina/depthai-python.git
- 安装depthai-experiments
git clone https://gitee.com/oakchina/depthai-experiments.git
- 如果你是第一次使用OAK设备,需要先配置规则
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="03e7", MODE="0666"' | sudo tee /etc/udev/rules.d/80-movidius.rules sudo udevadm control --reload-rules && sudo udevadm trigger
- 安装依赖库
python3 -m pip install -r depthai/requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
- 测试程序
python3 depthai/depthai_demo.py
树莓派
- 在开头我们提供了一个已经配置好环境的树莓派镜像,用户可以直接下烧录即可
- 下载树莓派官方烧录工具
- 打开软件,选择下载的oak镜像(注意解压出.img文件), 然后烧写进SD卡即可
- 启动树莓派,使用以下指令运行例程
cd depthai python3 depthai_demo.py
Ubuntu
- 安装depthai
git clone https://gitee.com/oakchina/depthai.git
- 安装依赖库
cd depthai python3 install_requirements.py
- 运行程序
python3 depthai-demo.py
注:如果安装后opencv报错并显示非法指令,请运行一下指令添加环境,再重新测试
echo "export OPENBLAS_CORETYPE=ARMV8" >> ~/.bashrc source ~/.bashrc
Jetson平台
注意:在jetson平台不要直接运行depthai包中的依赖脚本,避免OpenCV覆盖导致其他程序无法正常使用
- 请根据Jetson平台先烧写系统,并完整正常配置
- (可选)如果后续配置有问题,你可以更新软件包,第一次配置请先不要做次更新
sudo apt update && sudo apt upgrade sudo reboot
- s设置SWAP
# 禁用 ZRAM: sudo systemctl disable nvzramconfig # 创建 4GB swap文件 sudo fallocate -l 4G /mnt/4GB.swap sudo chmod 600 /mnt/4GB.swap sudo mkswap /mnt/4GB.swap
- 安装pip3
sudo -H apt install -y python3-pip
- 安装和配置虚拟环境:
sudo -H pip3 install virtualenv virtualenvwrapper
- 添加设置到bash脚本
sudo vi ~/.bashrc # 将以下内容添加到打开的文档中 export WORKON_HOME=$HOME/.virtualenvs export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3 source /usr/local/bin/virtualenvwrapper.sh
- 重新加载脚本,并穿件虚拟环境depthAI
source ~/.bashrc mkvirtualenv depthAI -p python3
- 安装depthai,注意安装需要在虚拟环境中进行,请先进入虚拟环境
#download and install the dependencies script sudo wget -qO- http://docs.luxonis.com/_static/install_dependencies.sh | bash #clone depthai respository git clone https://github.com/luxonis/depthai-python.git cd depthai-python
- 添加环境配置
echo "export OPENBLAS_CORETYPE=ARMV8" >> ~/.bashrc
- 进入example文件夹,然后运行脚本安装依赖库
cd examples/ sudo python install_requirements.py
- 运行测试脚本
sudo python rgb_preview.py