角蜂鸟使用入门

角蜂鸟已支持加载多个模型，请更新使用最新的SDK，并使用最新的固件来升级您的设备。

获取开发工具包

您可以访问我们的 Github 页面，找到您需要的开发工具包。

具体的获取和安装说明可参考各个开发工具包的 GitHub 页面。

树莓派用户可以烧写我们配置好环境的镜像

> 百度云地址链接 密码:k1x6
> Dropbox地址链接

以 SungemSDK-Python 为例：
SungemSDK 以子模块的形式添加到 SungemSDK-Python 中，因此可通过如下命令获取：

# '--recursive' 选项将自动初始化并更新每一个子模块
git clone --recursive https://github.com/HornedSungem/SungemSDK-Python.git 

# --------------- 或者 ---------------

git clone https://github.com/HornedSungem/SungemSDK-Python.git
cd SungemSDK-Python
git submodule update --init --recursive # 初始化并更新子模块

获取到的 SungemSDK-Python 的目录结构如下所示：

SungemSDK-Python
├── SungemSDK   # 子模块 (git submodule)
├── examples    # 示例应用
├── hsapi       # API Package 'haspi'
└── installer   # 安装脚本

以 Ubuntu 为例，

cd installer/Linux/Ubuntu
./install.sh tuna # tuna参数: pip安装使用清华镜像源

开始使用

以 SungemSDK-Python 为例：
在运行示例程序之前，需要从 SungemSDK-GraphModels 下载需要的资源，并拷贝至本项目对应的文件夹下。

SungemSDK-GraphModels/graphs -> examples/graphs
SungemSDK-GraphModels/misc   -> examples/misc
  • graphs: 储存内置CNN模型文件，修改/移动文件会导致部分API失效。
  • misc: 储存图像、标签数据或其他杂物。

之后就可以运行示例程序了。

cd examples/apps/Hello2018
python3 Hello2018.py

# Hello
# 2
# 0
# 1
# 8

角蜂鸟的工作模式可分为如下两种：

1. 使用角蜂鸟自带的摄像头作为神经网路输入:
┌       ┐       ┌        ┐
  角蜂鸟   -----   主控设备 
└       ┘       └        ┘

2. 加载图片或摄像头图像到角蜂鸟设备作为神经网路输入:
┌       ┐       ┌        ┐      ┌      ┐
  角蜂鸟   -----   主控设备  -----  摄像头
└       ┘       └        ┘      └      ┘

固件升级

您可以在我们的 Github Releases 页面找到固件升级文件。

固件升级程序目前位于 SungemSDK-Python 中，执行前请先确保已安装并配置好运行环境。

cd SungemSDK-Python/hsapi/upgrade
python3 upgrade.py -f filePath # filePath为固件升级文件的路径