1. 开发者上手指南

1.1. depthai项目链接

1.2. 支持的平台

我们为以下平台保留最新的，预编译的库。请注意，新的变化是，对于Jetson / Xavier系列，Ubuntu现在也可以保持不变：

平台

指示

Windows 10

Platform dependencies

macOS

Platform dependencies

Ubuntu

Platform dependencies

Raspberry Pi OS

Platform dependencies

Jetson/Xavier

Platform dependencies

1.3. 启用 USB 设备（仅在 Linux 上）

由于OAK是USB设备，因此为了在使用 udev 工具的系统上与之通信， 您需要添加udev规则以使设备可访问。

以下命令将向您的系统添加新的udev规则

Warning

提示：

第一次使用一定要配置此规则！

第一次使用一定要配置此规则！

第一次使用一定要配置此规则！

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

1.4. 安装依赖

1.4.1. Windows10

请参考 此处 ,下载OAK开发环境安装程序。

1.4.2. Windows 7

尽管我们不正式支持Windows 7, 但是我们的社区成员 已经成功 使用 Zadig 手动安装WinUSB . 连接DepthAI设备后，寻找具有 USB ID:03E7 2485 的设备并选择WinUSB（v6.1.7600.16385）安装WinUSB驱动程序，然后安装WCID驱动程序。

1.4.3. macOS

  • 拉取项目

git clone https://gitee.com/oakchina/depthai.git

  • 安装依赖

cd depthai
python3 install_requirements.py

如果安装依赖遇到网络问题可以查看此处换成 国内镜像源

  • 运行Demo

python3 depthai-demo.py

1.4.4. Ubuntu

  • 拉取项目

git clone https://gitee.com/oakchina/depthai.git

  • 安装依赖

cd depthai
python3 install_requirements.py

如果安装依赖遇到网络问题可以查看此处换成 国内镜像源

  • 运行Demo

python3 depthai-demo.py

注意! 如果从 PyPi 安装后 opencv 失败并显示非法指令，请添加：

echo "export OPENBLAS_CORETYPE=ARMV8" >> ~/.bashrc
source ~/.bashrc

1.4.5. Jetson平台

Warning

在Jetson上千万别直接去运行depthai包里自带的安装依赖脚本。

它会安装OpenCV，就会把原先的OpenCV覆盖了，普通的OpenCV是无法在Jetson上运行的。

可以按照下面的方法创建一个虚拟环境。

要在 Jetson Nano 或 Jetson Xavier 上安装 DepthAI ，请在完成全新安装和设置后执行以下步骤。在第一次登录时，不要立即运行更新。

第一步是可选的：更新升级软件包并删除您可能不会使用的应用程序或软件。

sudo apt update && sudo apt upgrade
sudo reboot now

更改SWAP的大小。这些说明来自Nvidia的 Jetson上的AI入门

# 禁用 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

如果您对最终命令有疑问，可以尝试以下操作：

sudo vi /etc/fstab

# 在文件底部添加这一行
/mnt/4GB.swap swap swap defaults 0 0

# 重启
sudo reboot now

下一步是安装 pip 和 python3 :

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

通过运行 source ~/.bashrc 命令保存并重新加载脚本。然后创建一个虚拟环境(在本例中称为 depthAI )。

mkvirtualenv depthAI -p python3

注意! 在安装 depthai 之前，请确保您处于虚拟环境中。

#下载并安装依赖包
sudo wget -qO- http://docs.luxonis.com/_static/install_dependencies.sh | bash

#克隆 github 仓库
git clone https://github.com/luxonis/depthai-python.git
cd depthai-python

最后一步是 .bashrc 使用以下行进行编辑：

echo "export OPENBLAS_CORETYPE=ARMV8" >> ~/.bashrc

进入 depthai 示例文件夹, 运行 python install_requirements.py , 然后运行 python rgb_preview.py.

iacisme 通过 Discord 提供的解决方案.

1.4.6. Raspberry Pi OS

请参考 此处 ,下载OAK树莓派系统镜像。

1.5. 镜像加速

1.5.1. pypi 镜像使用帮助

临时使用

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple some-package

注意，simple 不能少, 是 https 而不是 http

设为默认

  • 使用命令行

升级 pip 到最新的版本 (>=10.0.0) 后进行配置：

pip install pip -U
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

如果您的pip默认源的网络连接较差，临时使用镜像站来升级pip：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple pip -U

  • 文本编辑

Pip 的配置文件为用户根目录下的：~/.pip/pip.conf（Windows 路径为：C:\Users\<UserName>\pip\pip.ini）, 您可以配置如下内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
timeout = 120

有疑问?

我们很乐意为您提供代码或其他问题的帮助。

Slack
OAK 官方网站

OAK中国官方网站

forum
OAK 论坛

像聊天一样，只是不同步。

forum
Email Support

给我们的支持团队发送消息。

我们的联系方式

售后技术支持
oak_china_wechat

企业微信：OAK中国

售前技术和项目咨询
WeChat

微信号：13951940532

加好友请备注"OAK咨询"

欢迎到淘宝选购
 taobao
OAK中国官方淘宝店

还可以通过我们发布的视频和文章了解OAK

csdn
知乎-OAK中国
csdn
CSDN-OAK中国
csdn
bilibili-OAK中国