IVP03A盒子用户手册封面信息 - 电子书在线预览、各类电子书在线制作-云展网平台

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIER广州英码信息科技有限公司

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

版本日期变更说明

V1.0 2021.06.15 初始化版本

V1.1 2021.09.09 更新使用说明

V1.2 2022.01.11 更新接口使用说明

V1.3 2022.08.18 更新版本信息

V1.4 2022.09.27 更新使用说明

V1.5 2023.02.06 更新使用说明

V1.6 2023.06.12 更新文件使用路径

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

☆ 本产品不能安装在易燃气体泄漏的地方。

☆ 本产品不能安装盐雾大的环境中。

☆ 本产品不能进水。

☆ 请不要在潮湿的环境下使用本产品。

☆ 请确保本产品所接入电源输入在额定输入范围内。☆ 对于各类接口输入线，请仔细核对连接端口，防止连接错误对产品造成损坏。☆ 请确认所有接线连接正确后才再打开电源。

☆ 请勿自行改装、维修本产品。

☆ 如果本机在使用中出现死机现象，可以断电重新开机。☆ 应配套购买使用获得 CCC 认证并满足标准要求的电源适配器。☆ 在居住环境中，运行此设备可能会造成无线电干扰。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

版本历史：......................................................................................................................................................................1注意事项：.....................................................................................................................................错误！未定义书签。第 1 章配件清单 .........................................................................................................................................................4第 2 章开发环境和手册说明.......................................................................................................................................52.1 软件开发环境...................................................................................................................................................... 52.2 硬件开发环境...................................................................................................................................................... 52.3 开发使用手册说明.............................................................................................................................................. 5第 3 章配套系统服务和接口测试说明........................................................................................................................ 63.1 千兆网口使用说明.............................................................................................................................................. 63.2 USB 和 mSATA 使用说明..................................................................................................................................63.3 继电器使用说明.................................................................................................................................................. 73.4 TF 使用说明........................................................................................................................................................ 73.5 M.2 接口使用说明..............................................................................................................................................83.6 HDMI 使用说明...................................................................................................................................................83.7 RTC 使用说明......................................................................................................................................................83.8 RS-232、RS-485 使用说明................................................................................................................................. 83.9 nfs 文件系统挂载使用说明............................................................................................................................... 93.10 tftp 服务使用说明............................................................................................................................................93.11 ssh 远程使用说明.............................................................................................................................................93.12 docker 使用说明...............................................................................................................................................9第 4 章开发环境搭建 ................................................................................................................................................104.1 调试工具使用.................................................................................................................................................... 104.2 ubuntu 开发环境.............................................................................................................................................. 114.3 安装 Linux 开发工具....................................................................................................................................... 114.4 BSP SDK 使用.....................................................................................................................................................12第 5 章镜像烧写...........................................................................................................................................................145.1 TF 卡方式烧写.................................................................................................................................................. 145.2 tftp 网络刷机.................................................................................................................................................... 16第 6 章 BMNNSDK2 介绍...............................................................................................................................................19第 7 章联系获取更多帮助........................................................................................................................................ 20

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

IVP03A 盒子默认标配如下：

配件名称数量说明IVP03A 盒子 1 个

12V/4A 电源适配器 1 个

Type-C 数据线 1 个串口调试线凤凰端子插件 2 个

其它配件需自行准备，推荐如下：

品牌型号说明其它品牌 TF 卡

其它品牌网线 1 条其它品牌 SSD 配合mSATA 接口使用

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

网盘中提供的开发包默认在 ubuntu 18.04 64 位编译，在32 位Linux 服务器、较老版本的Linux 服务器、偏冷门的 Linux 服务器上可能存在未知的兼容性问题。1) 主机系统及编译器版本：

ubuntu 18.04 、gcc-linaro-6.3.1-aarch64-linux-gnu

2) IVP03A 网盘资料(开发工具、软/硬件资料、扩展资料等全部资料)

2.2 硬件开发环境

1) IVP03A 盒子一套

2) 推荐主机系统配置：四核以上处理器、8GB 以上内存、500GB 以上存储空间或更好配置2.3 开发使用手册说明

1) 盒子的调试工具使用。

2) IVP03A 的系统软件层，熟悉配套的 SDK 软件包以及编译调试步骤，镜像的烧写步骤。3) 对于算法、视频编解码的开发，BM1684 平台提供一套专用的SDK 环境-bmnnsdk2，为了减少环境的差异，提供配套使用的 docker 开发环境，docker 镜像会与bmnnsdk2软件包一起在网盘资料提供。

4) 简单介绍系统服务以及接口的使用方法。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

IVP03A 盒子两个千兆网口通过网线连接交换机。

IVP03A 盒子 DEBUG 口通过 Type-C 数据线连接电脑。

IVP03A 盒子电源端口接 DC 12V/4A 电源适配器。

IVP03A 盒子 TF 卡槽配合 TF 卡使用。

IVP03A 盒子 mSATA 卡槽仅配合 mSATA 卡使用。

IVP03A 盒子 USB3.0 接口配合 U 盘使用。

IVP03A 盒子 M.2 卡槽配合无线通信模组使用(选配 4/5G 模组)（暂代）。HDMI 接口配合 HDMI 显示器使用。

LED、继电器、RS-232、RS-485 接口测试说明。

3.1 千兆网口使用说明

1) 核心板有两个网卡，dhcp 模式 dhcp4：yes，静态模式 dhcp4：no 以及配置IPaddresses2) 可以在/etc/netplan 目录下 01-netcfg.yaml 配置文件3.2 USB 和 mSATA 使用说明

接入 U 盘/mSATA 卡，然后上电，使用 fdisk -l 系统会有如下打印：注意：新使用的U 盘、TF、mSATA 卡等存储设备需要先使用fdisk 新增分区并进行mkfs.ext4、mkfs.vfat 等工具进行格式化，才能进行挂载使用。

挂载方式：mount /dev/sda1 /mnt

写数据测试：dd if=/dev/zero of=/mnt/test2 bs=4096 count=1048574

读数据测试：dd if=/mnt/test2 of=/dev/null bs=4096 count=1048574

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

3.3 继电器使用说明

IVP03A 盒子有 1 个继电器，对应的测试方法如下。

测试命令：如下截图。

测试现象：继电器会有滴答滴答的声音。

3.4 TF 使用说明

IVP03A 盒子有 1 个 TF 卡接口接口，直接接上 TF 卡，需要重新上电使用。注意：新使用的U 盘、TF 卡等存储设备需要先使用fdisk 新增分区，才能进行挂载使用，fdisk 的使用方法请自行在网上寻找。

挂载 TF 卡：mount /dev/mmcblk1p1 /mnt

读测试：dd if=/mnt/test2 of=/dev/null bs=4096 count=1048574

写测试：dd if=/dev/zero of=/mnt/test2 bs=4096 count=1048574

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

IVP03A 盒子有 1 个 USB 信号转 M.2 接口，需要配合 4/5G 模组进行测试验证3.6 HDMI 使用说明

1) 获取 root 权限：sudo -i

2) 挂载 FL2000 HDMI 驱动，insmod /platform/evm1684/hdmi/fl2000.ko

3) 运行 HDMI 接口测试程序, cd /platform/evm1684/hdmi;./fltest_arm 1 192010803.7 RTC 使用说明

1) 设置系统时间，date -s \"2021-03-22 17:11:00\"

2) 时间保存，写入 RTC 硬件，hwclock -w

3) 重启设备，查看时间是否正常，date

3.8 RS-232、RS-485 使用说明

将 IVP03A 盒子上 RS-232、RS-485,对应系统的设备节点分别为/dev/ttyS1、/dev/ttyS2

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

出厂系统内部集成 nfs 服务，/mnt 文件夹可作为挂载点。获取 root 权限：sudo -i

执行命令：mount -t nfs -o nolock -o tcp -o rsize=32768,wsize=32768 IP:/host/mntIP：服务器的 IP 地址

Host：服务器上 nfs 的挂载点

3.10 tftp 服务使用说明

执行命令：tftp -g -r dst 文件 ip

例如：tftp -g -r check.txt 172.16.100.190

3.11 ssh 远程使用说明

使用软件工具登录设置的 IP 地址：192.168.1.150，对应 eth0 网卡。账号：root

密码：ematech

3.12 docker 使用说明

IVP03A盒子系统已经预装了 docker 服务，您可以用 docker info 命令查看状态。注意docker 的根目录被配置到了/data/docker 目录下，与默认设置不同,docker 命令的使用请自行在网上查找。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

4.1 调试工具使用

硬件先使用 Type-C 数据线接上盒子的 DEBUG 口连接到电脑 PC。例：SecureCRT 使用方法步骤如下图所示：( 波特率: 115200 )

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

1）可沿用自用的 ubuntu 开发环境，也可以重新搭建网盘资料提供的ubuntu 软件包。4.3 安装 Linux 开发工具

1）安装前，请确保 ubuntu 系统能正常连接网络。

2）执行以下命令配置并安装所需开发工具，推荐使用 ubuntu 18.04 64 位的linux系统。sudo apt install autoconf libtool g++ gcc-arm-none-eabi cmake libgoogle-glog-devprotobuf-compiler libprotobuf-dev libboost-all-dev libncurses5-dev libssl-devdevice-tree-compiler android-tools-fsutils kpartx u-boot-tools cryptsetup-binbisonlinux-tools-common

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

1）把BSP SDK 软件包拷贝到 ubuntu 服务器的自定义目录,并使用tar 命令解压2）目录文件结构

3）解压后进入SDK目录，执行以下命令即可编译出SD卡用的刷机包。source build/evnsetup.sh → 声明系统环境变量

build_all → SDK整编

编译结果在install/soc_bm1684_asic目录下

sdcard → SD卡刷机包

tftp → tftp刷机包

emmcboot.itb → kernel和ramdisk、dtb打包在一起

spi_flash.bin → bootloader

debian_rootfs → kernel编译过程中会把ko等文件更新进去，SD卡刷机包会使用；system.tgz → 如果有这个文件，则SD刷机包会把它作为/system目录下的内容4）如果只是想更新内核的话，可以用如下命令：

build_kernel

build_emmcboot

即可得到新的emmcboot.itb。不建议您直接到linux-linaro-stable目录下手敲make，内核的编译结果在如下路径：

linux-linaro-stable/linux/bm1684_asic

编译出的ko可以在如下路径找到：

install/soc_bm1684_asic/debian_rootfs/lib/modules/4.9.38-bm1684-v10.6.0/kernel

linux-linaro-stable/linux/bm1684_asic/modules/lib/modules/4.9.38-bm1684-v10.6.0/kernel两个路径下的内容是一样的。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

kernel的配置文件在：

linux-linaro-stable/arch/arm64/configs/bitmain_bm1684_asic_defconfig

请将您要修改的kernel config放在这里，您需要手工添加所有依赖项。IVP03A使用的设备树文件在：

linux-linaro-stable/arch/arm64/boot/dts/bitmain/bm1684_asic_modm.dts

请将您的板级改动放在这里。

修改之后请执行：

build_kernel

build_emmcboot

得到新的emmcboot.itb文件即包含了全部kernel和dts的修改。6）修改 Debian 系统配置

Debian 9系统的生成过程是这样：

1.install/soc_bm1684_soc/debian_rootfs是初始的底包2.kernel编译的过程中会把ko等文件更新进去

3.SD卡刷机包生成过程中会从这个目录读取文件作为eMMC上第四分区的内容所以您可以在步骤2加入您自己的改动，比如放入一些工具软件，修改以太网配置文件等等，然后重新生成SD卡刷机包。

如果您有一个或多个deb想要预装到Debian，那么有两种做法：a.如果deb包比较简单，您可以直接将它解压缩后把里面的文件逐个copy到debian_rootfs下的对应目录。

b.将deb包直接放到install/soc_bm1684_asic/debian_rootfs/root/post_install/debs目录，则IVP03A在SD卡刷机后第一次开机时会把这些deb包都安装上。7）在IVP03A上编译内核模块

可以选择直接在IVP03A板卡上直接编译kernel module，可以省去上述搭建交叉编译环境的麻烦。步骤如下：

1.uname -r得到kernel版本号，与/home/linaro/linux-dev和/lib/modules里面的文件名比较，确保一致

2.sudo dpkg -i /home/linaro/linux-dev/*.deb

3.因为kernel的make bindeb-pkg的一个交叉编译缺陷，需要再额外做如下处理a. sudo mkdir -p /usr/src/linux-headers-$(uname -r)/tools/include/toolsb. sudo cp /home/linaro/linux-dev/*.h /usr/src/linux-headers-$(uname-r)/tools/include/tools

c. cd /usr/src/linux-headers-$(uname -r)

d. sudo apt update

e. sudo apt-get install -y build-essential bc bison flex libssl-devf. sudo make scripts

4.回到您的driver目录，make ko吧。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

5.1 TF 卡方式烧写

1）需要准备一张 16GB 以上的TF卡，并将卡格式为 fat32 格式，（如果SD 卡上有多个分区，只能使用第一个分区）。

Ubuntu 系统（版本 18.04、20.04）通过命令行的方式

df -h --找到U盘的序列号，“/dev/sdb”

sudo umount /dev/sdb0 --解除U盘挂载

sudo mkfs.vfat -F 32 /dev/sdb0 --格式化U盘为fat32格式如果出现attribute“partition”not found，不要在意，格式化完毕以后将TF卡拔出。win10 需要磁盘管理删除卷再添加新卷，用 Diskgenius 工具格式化为fat32。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

下载压缩包，并找到固件升级包 ( 例如： bm1684_ubuntu20_4g_1129.tar.gz),并将其解压后的所有文件拷贝到 TF卡的根目录下。

3）插入 TF 卡，重新上电，待烧写完成，会看到拔掉TF卡并重启的提示，我们拔出TF，重新上电即可进入新的系统。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

登录密码:ematech

5.2 tftp 网络刷机

首先需要搭建基础的网络环境：将 IVP03A 和一台 PC 机放在同一个路由器下（直连也可以）。此处假设路由器 IP 是 192.168.0.1，PC 机 IP 是192.168.0.2。在PC机上安装 tftp server：如果是 Ubuntu系统，apt-get install tftpd-hpa tftp-hpa，然后查看/etc/default/tftpd-hpa 文件中的 TFTP_DIRECTORY 路径为何，将刷机包拷贝进去（您也可以修改这个路径配置，sudo service tftpd-hpa restart 后即可生效）；如果是Windows系统，推荐您使用 tftpd64.exe，图形界面，无需安装，同样需要将根目录指向刷机包所在位置。tftp server 搭建好后，您可以用另一台 PC 先测试一下，避免网络、防火墙等配置问题。推荐尽可能使用Ubuntu系统，Windows下的tftpd64对环境比较挑剔，在传输大文件时有时会不稳定，造成升级失败。

然后我们启动 IVP03A：

1）接上串口终端,在看到 u-boot提示 Hit any key to stop autoboot 时按下回车2）进入 u-boot 的命令行模式，看到提示符 bm1684#

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

©EMA TECH CO, LTD. 2017. ALL RIGHTS RESERVED E-MAIL : support@ema-tech.com17/213）输入：set ipaddr 192.168.0.200; set gatewayip 192.168.0.1; set serverip192.168.0.2; tftp 0x310000000 boot.scr; source 0x310000000。此处，ipaddr 是设置 IVP03A 的 IP，注意不要冲突；serverip 是tftp server 所在PC机的 IP；gatewayip 是路由器的 IP，如果 IVP03A 和 PC 机是直连的，则也写成PC机的IP即可。

4）正常的话您可以看到 tftp 开始下载和刷机了

5）结束后，和 TF 卡刷机一样会提示您 reset IVP03A，此时重启IVP03A，输入登录账号:root

登录密码:ematech

即可进入新的系统。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

©EMA TECH CO, LTD. 2017. ALL RIGHTS RESERVED E-MAIL : support@ema-tech.com19/21第 6 章 BMNNSDK2 介绍BMNNSDK2（Bitmain Neural Network SDK）是比特大陆基于自主研发的AI 芯片所定制的深度学习 SDK，涵盖了神经网络推理阶段所需的模型优化、高效运行时支持等能力，为深度学习应用开发和部署提供易用、高效的全栈式解决方案。

BMNNSDK2 分为两部分：

1）在核心板的/system 已经安装 bmnnsdk2 runtime，bmnnsdk2 runtime 包括TPU驱动、库文件、工具等，并添加库文件路径。

2） PC 机上的 SDK，如 bmnnsdk2-bm1684_v2.7.0.tar.gz 以及开发环境的docker镜像。进入 docker 开发环境：sudo ./docker_run_bmnnsdk.sh

3）对于 PC 机上的 SDK 使用，具体算法以及视频编解码内容，可以细看网盘资料中提供的开发文档。

4）对于算法模型移植的案例，可以细看网盘资料中提供的开发资料中的demo 案例。

WWW.EMA-TECH.COM智能硬件产品供应商INTELLIGENT HARDWARE PRODUCT SUPPLIERTELEPHONE : 020-87643879-827

技术邮箱：support@ema-tech.com

英码总机：020-8764-3879

英码官网：www.ema-tech.com

线上商城：https://emagz.taobao.com

广州英码信息科技商铺广州英码信息科技官网

快速跳转到指定页