hi3531 sdk 安装以及升级使用说明
第一章 hi3531_sdk_vx.x.x.x版本升级操作说明
如果您是首次安装本sdk,请直接参看第2章。
第二章 首次安装sdk
1、hi3531 sdk包位置
在"hi3531_v100r001***/01.software/board"目录下,您可以看到一个 hi3531_sdk_vx.x.x.x.tgz 的文件,
该文件就是hi3531的软件开发包。
2、解压缩sdk包
在linux服务器上(或者一台装有linux的pc上,主流的linux发行版本均可以),使用命令:tar -zxf hi3531_sdk_vx.x.x.x.tgz ,
解压缩该文件,可以得到一个hi3531_sdk_vx.x.x.x目录。
3、展开sdk包内容
返回hi3531_sdk_vx.x.x.x目录,运行./sdk.unpack(请用root或sudo权限执行)将会展开sdk包打包压缩存放的内容,请按照提示完成操作。
如果您需要通过windows操作系统中转拷贝sdk包,请先运行./sdk.cleanup,收起sdk包的内容,拷贝到新的目录后再展开。
4、在linux服务器上安装交叉编译器
1)安装uclibc交叉编译器(注意,需要有sudo权限或者root权限):
进入hi3531_sdk_vx.x.x.x/osdrv/toolchain/arm-hisiv100-linux目录,运行chmod +x cross.install,然后运行./cross.install即可。
2) 安装glibc交叉编译器(注意,需要有sudo权限或者root权限):
进入hi3531_sdk_vx.x.x.x/osdrv/toolchain/arm-hisiv200-linux目录,运行chmod +x cross.install,然后运行./cross.install即可。
3) 执行source /etc/profile, 安装交叉编译器的脚本配置的环境变量就可以生效了,或者请重新登陆也可。
5、编译osdrv
参见osdrv目录下readme
6、sdk目录介绍
hi3531_sdk_vx.x.x.x 目录结构如下:
|-- sdk.cleanup # sdk清理脚本
|-- sdk.unpack # sdk展开脚本
|-- osdrv # 存放操作系统及相关驱动的目录
| |-- busybox # busybox源代码
| |-- drv # drv源代码
| |-- kernel # linux内核源代码
| |-- pub # 编译好的镜像、工具、drv驱动等
| |-- rootfs_scripts # rootfs源代码
| |-- toolchain # 交叉编译器
| |-- tools # linux工具源代码
| |-- uboot # uboot源代码
| `-- makefile # osdrv makefile
|-- package # 存放sdk各种压缩包的目录
| |-- osdrv.tgz # linux内核/uboot/rootfs/tools源码压缩包
| |-- mpp.tgz # 媒体处理平台软件压缩包
| `-- image # 可供flash烧写的映像文件,如内核、根文件系统
|-- scripts # 存放shell脚本的目录
|-- mpp # 存放媒体处理平台的目录
|-- component # 组件源代码
|-- extdrv # 板级外围驱动源代码
|-- include # 对外头文件
|-- ko # 内核模块
|-- lib # release版本库以及音频库
|-- tools # 媒体处理相关工具
`-- sample # 样例源代码
第三章、安装、升级hi3531demo板开发开发环境
# 如果您使用的hi3531的demo板,可以按照以下步骤烧写u-boot,内核以及文件系统,以下步骤均使用网络来更新。
# 通常,您拿到的单板中已经有u-boot,如果没有的话,就需要使用仿真器进行烧写。
# 更详细的操作步骤及说明,请参见01.software\board\documents目录下的《linux开发环境用户指南》。
# 以下操作假设您的单板上已经有u-boot,使用网口烧写uboot、kernel及rootfs到flash中。
# demo单板默认为从spi flahs启动。
1、配置tftp服务器
# 可以使用任意的tftp服务器,将package/image_uclibc(或image_glibc)下的相关文件拷贝到tftp服务器目录下。
2、参数配置
# 单板上电后,敲任意键进入u-boot。设置serverip(即tftp服务器的ip)、ipaddr(单板ip)和ethaddr(单板的mac地址)。
setenv serverip xx.xx.xx.xx
setenv ipaddr xx.xx.xx.xx
setenv ethaddr xx:xx:xx:xx:xx:xx
setenv netmask xx.xx.xx.xx
setenv gatewayip xx.xx.xx.xx
ping serverip,确保网络畅通。
3、烧写映像文件到spi flash
以16m spi flash为例。
1)地址空间说明
| 1m | 4m | 11m |
|---------------|---------------|---------------|
| boot | kernel | rootfs |
以下的操作均基于图示的地址空间分配,您也可以根据实际情况进行调整。
2)烧写u-boot
sf probe 0
mw.b 82000000 ff 100000
tftp 0x82000000 u-boot-hi3531_930mhz.bin
sf erase 0 100000
sf write 82000000 0 100000
reset
3)烧写内核
mw.b 82000000 ff 400000
tftp 82000000 uimage
sf erase 100000 400000
sf write 82000000 100000 400000
4)烧写文件系统
mw.b 82000000 ff b00000
tftp 0x82000000 rootfs_256k.jffs2
sf erase 500000 b00000
sf write 82000000 500000 b00000
5)设置启动参数
setenv bootargs 'mem=64m console=ttyama0,115200 root=/dev/mtdblock2 rootfstype=jffs2 mtdparts=hi_sfc:1m(boot),4m(kernel),11m(rootfs)'
setenv bootcmd 'sf probe 0;sf read 0x82000000 0x100000 0x400000;bootm 0x82000000'
sa
4、烧写映像文件到nand flash
以64m nand flash为例。
| 1m | 15m | 32m | 16m |
|---------------|---------------|---------------|------------------------|
| boot | kernel | rootfs | other |
tftp 82000000 u-boot-hi3531_930mhz.bin
nand erase 0 100000
nand write 82000000 0 100000
reset
mw.b 82000000 ff f00000
nand erase 100000 f00000
nand write 82000000 100000 f00000
mw.b 82000000 ff 2000000
tftp 82000000 rootfs_2k_1bit.yaffs2
nand erase 1000000 2000000
nand write.yaffs 82000000 1000000 9435c0 #注意:9435c0为rootfs文件实际大小(16进制)
setenv bootargs 'mem=64m console=ttyama0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hinand:1m(boot),15m(kernel),32m(rootfs),16m(test)'
setenv bootcmd 'nand read 0x82000000 0x100000 0x500000;bootm 0x82000000'
5、启动新系统
reset # 重启进入新系统。
第四章、开发前环境准备
1、管脚复用
与媒体业务相关的管脚复用都在mpp/ko_hi3531目录下的sh脚本中配置,如果与实际情况不符请直接修改,此脚本被load3531_asic调用,在加载mpp内核模块之前被执行;
mpp之外的其他管脚复用统一在uboot中配置,详细说明请参见《u-boot移植应用开发指南》。
第五章、使用sdk和demo板进行开发
1、开启linux下的网络
# 设置网络
ifconfig eth0 hw ether xx:xx:xx:xx:xx:xx;
ifconfig eth0 xx.xx.xx.xx netmask xx.xx.xx.xx;
route add default gw xx.xx.xx.xx
# 然后ping一下其他机器,如无意外,网络将能正常工作。
2、使用nfs文件系统进行开发
# 在开发阶段,推荐使用nfs作为开发环境,可以省去重新制作和烧写根文件系统的工作。
# 挂载nfs文件系统的操作命令:
mount -t nfs -o nolock -o tcp xx.xx.xx.xx:/your-nfs-path /mnt
# 然后就可以在/mnt目录下访问服务器上的文件,并进行开发工作。
3、开启telnet服务
# 网络正常后,运行命令 telnetd& 就可以启动单板telnet服务,然后才能使用telnet登录到单板。
4、运行mpp业务
# 在单板linux系统下,进入mpp/ko_hi3531目录,加载ko
cd mpp/ko_hi3531
./load3531_asic -i
# 进入各sample目录下执行相应样例程序(sample需要先在服务器上成功编译过)
cd mpp/sample/vio
./sample_vio 0
第六章 地址空间分配与使用
1、ddr内存管理说明
1)所有ddr内存中,一部分由操作系统管理,称为os内存;另一部分由mmz模块管理,供媒体业务单独使用,称为mmz内存。
2)os内存起始地址为0x80000000,内存大小可通过bootargs进行配置,例如第三章中的setenv bootargs 'mem=64m ... ',表示分配给操作系统内存为64m,您可以根据实际情况进行调整。
3)mmz内存由mmz内核模块管理(mpp/ko_hi35xx目录下的mmz.ko),加载mmz模块时,通过模块参数指定其起始地址及大小,例如:
insmod mmz.ko mmz=anonymous,0,0x84000000,447m:ddr1,0,0xc0000000,511m anony=1 || report_error
表示mmz两块区域,区域一的名称为anonymous,起始地址为0x84000000,大小为447m;区域二的名称为ddr1,起始地址为0xc0000000,大小为511m。
您可以通过修改mpp/ko_hi35xx目录下load3531脚本中的mmz模块参数,来修改其起始地址和总大小。
4)请注意mmz内存地址范围不能与os内存重叠。
2、demo板ddr内存管理示意
1) 以容量为512mbytes的ddr0,为512mbytes的ddr1内存为例,以下为根据本文档和sdk默认配置得到的内存管理示意图:
ddr0: ddr1:
-----|-------| 0x80000000 # memory managed by os. -----|-------| 0xc0000000 # memory managed by mmz.
64m | os | | |
| | | |
-----|-------| 0x84000000 # memory managed by mmz. | |
447m | mmz | 511m | mmz |
-----|-------| 0x9ff00000 # not used. -----|-------| 0xdff00000 # not used.
1m | | 1m | |
-----|-------| 0xa0000000 # end of ddr. -----|-------| 0xe0000000 # end of ddr.
注意:
(1)用户在配置启动参数时需要设置os的管理内存为64m,“setenv bootargs 'mem=64m ...”。
(2)系统启动后,配置load3531的脚本中mmz的管理内存为447m(ddr0)和511m(ddr1),“insmod mmz.ko mmz=anonymous,0,0x84000000,447m:ddr1,0,0xc0000000,511m anony=1 || report_error”。
2) 以容量为256mbytes的ddr内存为例,可以采用如下配置来节省内存使用。
ddr0: ddr1:
-----|-------| 0x80000000 # memory managed by os. -----|-------| 0xc0000000 # memory managed by mmz.
48m | os | | |
-----|-------| 0x83000000 # memory managed by mmz. | |
208m | mmz | 256m | mmz |
| | | |
-----|-------| # end of ddr. -----|-------| # end of ddr.
(1)用户在配置启动参数时需要设置os的管理内存为48m,“setenv bootargs 'mem=48m ...”。
(2)系统启动后,配置load3531的脚本中mmz的管理内存为208m(ddr0)和256m(ddr1),“insmod mmz.ko mmz=anonymous,0,0x83000000,208m:ddr1,0,0xc0000000,256m anony=1 || report_error”。