sunrise camera 使用说明
功能概述
sunrise camera 是官方开发的应用程序,方便用户对 Camera、 VIO、 Codec、 BPU 等模块的快速评测。用户通过 PC 上的 Web 浏览器,可以方便的对程序进行参数配置,并实时预览视频流、算法渲染结果等信息。程序主要功能如下:
- 支持智能摄像头功能模式,最大支持接入 2 路 Camera Sensor
- 支持智能多路解码分析盒功能模式
- 编解码能力:最大支持 12 路 1080p@30 视频码流的编码或解码
- 盒子模式是先解码视频文件再编码后传输的,所以盒子模式最大支持 6 路 1080p@30
- 支持通过 PC 浏览器对程序进行参数配置,例如 Camera sensor、编码码率、算法模型、视频源等参数
- 支持通过 PC 浏览器、 VLC 拉流、 HDMI 输出等多种方式预览图像效果
- 算法多种模型切换,例如 mobilenet_v2 、 yolov5s、 fcos 等
硬件环境准备
- 运行 sunrise camera 前,需要准备如下配件:
- 开发板配套摄像头,如 SC230AI、 SC132GS、 F37 等
- 网线一条,保证 PC 和开发板能够 ping 通
- Micro USB 线一条 ( 无网口时 ),开发板可通过 USB 虚拟网口跟 PC 通讯
整体连接方式见下图:
网络连接要求
为保证 4K
编码推流时的稳定性,建议开发板与 PC 机使用千兆网口直连。
编译与运行
编译
进入目录:/app/multimedia_samples/sunrise_camera
执行命令: make
生成的目标文件:sunrise_camera
root@ubuntu:/app/multimedia_samples/sunrise_camera# ls sunrise_camera/bin/
log sunrise_camera www
运行
sunrise camera 有如下两种运行方式:
- 手动启动:适用于调试阶段
- 上电自启动:适用于程序调试稳定后,部署到正式场景运行
手动启动:
编译 sunrise camera 后执行 sh ./start_app.sh
启动。
上电自启动:
- 部署自启动文件(只需要第一次执行)
cp sunrise_camera.service /etc/systemd/system/sunrise_camera.service
- 使能开机自启动
# 重新加载 systemd 配置
sudo systemctl daemon-reload
# 后台启动
sudo systemctl start sunrise_camera
# 查看状态: 证明sunrise_camera 后台启动成功了
sudo systemctl status sunrise_camera
#设置为开机自启动
sudo systemctl enable sunrise_camera
#重启
sync
reboot
- 其他命令
# 禁止开机自启动
sudo systemctl disable sunrise_camera
# 停止后台运行的 sunrise_camera
sudo systemctl stop sunrise_camera
# 后台启动后,查看日志的命令
journalctl -u sunrise_camera.service -f --output=cat
Web 客户端使用说明
主界面
sunrise camera 正常启动后,通过 chrome 浏览器在地址栏输入 IP 地址(开发板默认 IP 为 192.168.1.10 )可以登录用户控制主界面, 例如: http://192.168.1.10
登录成功后的界面显示如下:
界面菜单详细说明如下:
功能编号 | 说明 |
---|---|
1 | 配置应用方案,点击后打开应用方案选择和参数配置页面 |
2 | 显示当前运行的场景信息 |
3 | 显示当前应用方案的主要信息,例如使用的 sensor 型号,编解码参数,算法模型 |
4 | 应用方案框图,了解当前应用方案的数据流,点击后放大查看大图 |
5 | 视频显示主画面,根据应用方案运行的视频通路数自动调整显示画面数量 |
6 | 预览视频的实时帧率 |
7 | 算法运算的实时帧率 |
参数配置方式
- sunrise camera 支持两种应用方案:
智能摄像机
和智能分析盒
( 默认应用方案为单路视频分析盒
) - sunrise camera 支持通过 Web 端在线修改应用方案、选择 camera sensor 型号、设置解码、编码参数及选择算法模型等
智能摄像机配置方式
具体修改步骤如下:
- 启动 sunrise_camera 程序,打开 chrome 浏览器输入设备的 IP 地址,例如: http://192.168.1.10
- 点击
配置应用方案
按钮,上图1
标号 - 可以查看到当前的设备信息,包括芯片类型,软件版本, rtsp 码流链接(该链接支持在 vlc 软件上拉 rtsp 视频码流,可以支持录像、截图等操作),上图
2
标号 - 选中应用方案,上图
3
标号,每种应用方案的参数设置和注意事项,请点击问号
按钮了解。 - 点击
提交
按钮,立刻实现应用方案的切换。(注:仅点击提交不会修改开发板的配置文件,可以用来临时修改参数进行调试) - 点击
保存当前配置
按钮会把设置好的配置写入开发板上的配置文件,下次重新启动 sunrise_camera 时会按照当前配置启动。 - 点击