示例树莓派

VisionSeed快速入门版权所有侵权必究版本历史日期版本发布说明201906241.
0初始版本目录1概述12快速入门.
12.
1硬件连接.
12.
2使用VLC预览VisionSeed视频流.
22.
3使用客户端工具配置VisionSeed42.
4编译运行示例程序52.
5基于VisionSeed进行开发.
72.
6SDK支持的功能.
911.
概述VisionSeed,是一个融AI算法+运算能力+摄像头为一体的硬件模组,致力于向硬件开发者提供世界领先的AI能力,开发者通过VisionSeed可轻松使用优图人脸检测、识别、配准、姿态、属性等算法能力,创造性完成创新产品的研发.
VisionSeed通过USB或UART接口,以结构化形式输出AI分析结果,用单片机就能玩转AI,开发AI应用触手可及.
VisionSeed具备1TFLOPS(每秒一万亿次)推理运算能力,功耗小于10瓦,提供可靠的FPC软排线接口,可置入各种嵌入式设备中.
我们为您提供了完整的SDK、Demo工程、文档资源,以便使用VisionSeed进行产品开发.
本文档旨在帮助您快速的了解VisionSeed.
2.
快速入门本章将从以下几个方面帮助用户理解VisionSeed,包括硬件连接,视频预览,编译运行SDK示例程序以及基于VisionSeed进行开发.
1.
1硬件连接如图2.
1所示为VisionSeed开发者套装的硬件部分,包括蓝色框中的VisionSeed(含摄像头模组)和USB数据线.
2图2.
1VisionSeed开发者套装按照图2.
2所示使用USB数据线将VisionSeed连接到电脑的USB接口,在连接电脑USB端口后VisionSeed会虚拟出一个视频设备和一个串口设备,以下章节将会介绍如何从视频接口获取视频数据以及如何使用配置工具通过虚拟出来的串口设备对VisionSeed进行配置.
图2.
2连接VisionSeed到电脑USB接口1.
2使用VLC预览VisionSeed视频流在连接好VisionSeed之后,可以先预览视频输出,直观感受VisionSeed内置的人脸检测算法.
首先在PC上安装VLCmediaplayer软件,然后运行VLCmediaplayer,如图2.
3选择打开捕获设备,然后如图2.
4选择TencentYoutTu(R)VisionSeed,最后点击播放即可预览视频.
(如果PC上运行的是Linux操3作系统,那么这里打开的设备是/dev/video0,如果是PC本身带有摄像头设备,VisionSeed设备号会累加,如/dev/video1.
对于运行Windows的PC,VisionSeed只支持win10系统.
)图2.
3运行VLCmediaplayer打开捕获设备图2.
4选择TencentYoutTu(R)VisionSeed4图2.
5预览示意图1.
3使用客户端工具配置VisionSeed如图2.
6所示为VisionSeed客户端工具(从开发者中心-工具页面下载),在VisionSeed连接电脑之后打开该软件,点击工具左下方的连接开关连接VisionSeed,在主界面可以对摄像头曝光,增益等进行控制,可从视频预览看到调整结果.
(注意客户端工具的配置不会被保存下来,重新上电VisionSeed会重置参数)5图2.
6VisionSeed客户端工具1.
4编译运行示例程序下面以Ubuntu16.
04为例说明如何编译运行示例程序1.
从开发者中心-工具-VisionSeedSDK获取yt-visionseed-sdk-linux,解压之后目录结构如下:图2.
7SDK目录结构2.
复制scripts/99-tencent-yt.
rules文件到/etc/udev/rules.
d/6sudocp.
/scripts/99-tencent-yt.
rules/etc/udev/rules.
d/如果VisionSeed已经连接PC,则需要拔插一下USB数据线,重新连接VisionSeed.
3.
进入sdk目录,编译sdkcdyt-visionseed-sdk/makecd.
.
4.
进入示例目录,编译示例程序cdexample/make5.
运行示例程序.
/build/main注意:请先将VisionSeed通过USB数据线连接到电脑,需5秒启动时间.
示例程序输出检测到的部分人脸信息,包括人脸位置信息,人脸姿态角以及根据90点配准信息计算的人眼开闭状态.
图2.
8SDK示例程序输出7如果出现"Erroropening/dev/ttyACM0"错误,请先按照步骤2拷贝文件到/etc/udev/rules.
d/,然后拔插VisionSeed,重新运行示例程序.
如果已经按照步骤2正确操作,则需要保证打开了正确的设备名称.
使用以下命令查看设备名称,查看输出结果.
ls/dev/ttyACM*如果输出结果不为/dev/ttyACM0,则修改example/main.
cpp文件中的以下部分为正确的设备名称,然后重新编译运行程序.
SDKWrapperwrapper("/dev/ttyACM0");更多关于示例程序的分析和SDK内容可以查看《VisionSeedSDK文档》.
1.
5基于VisionSeed进行开发1.
5.
1输入输出接口如图2.
9所示,VisionSeed共有两类接口,USB接口和UART接口.
其中USB接口实现为两个免驱设备:视频流+虚拟串口(在Linux下分别为/dev/video0和/dev/ttyACM0),需要视频流的应用可以选择该接口.
不需要视频信息的应用可以选择UART接口.
8图2.
9输入输出接口1.
5.
2连接自选主控主控通过USB或UART接口从VisionSeed获取AI信息,处理用户业务逻辑.
主控的可选方案包括:(1)普通电脑(2)具备USB接口的SoC:如树莓派(3)具备UART接口的单片机:如STM32F103C8T6(要求RAM大于20KBytes)(4)其他类似主控9图2.
10自选主控连接VisionSeed示例1.
5.
3编写程序获取VisionSeed输出的结构化数据SDK中的示例程序演示了如何使用装有Ubuntu操作系统的PC从VisionSeed获取AI数据.
使用其他平台作为主控的情况类似.
请参考《VisionSeedSDK文档》.
1.
6SDK支持的功能目前VisionSeedSDK支持以下功能:(1)获取设备信息,包括固件版本,CPUID,摄像头模组ID(2)设置摄像头AE(AutoExposure),AG(AutoGain)10(3)设置IR补光灯的亮度(4)获取人脸识别信息,包括检测到的人脸数量每个人脸的位置信息90个面部配准点人脸的空间姿态信息(roll,pitch,yaw)SDKAPI的使用见《VisionSeedSDK文档》.