Hi3516A/Hi3516D SDK 安装以及升级使用说明
注意：本文以Hi3516A描述为例，未有特殊说明，Hi3516D与Hi3516A一致。
第一章 Hi3516A_SDK_Vx.x.x.x版本升级操作说明
如果您是首次安装本SDK，请直接参看第2章。
第二章 首次安装SDK
1、Hi3516A SDK包位置
在"Hi3516A_V100R001***/01.software/board"目录下，您可以看到一个 Hi3516A_SDK_Vx.x.x.x.tgz 的文件，
该文件就是Hi3516A的软件开发包。
2、解压缩SDK包
在linux服务器上（或者一台装有linux的PC上，主流的linux发行版本均可以），使用命令：tar -zxf Hi3516A_SDK_Vx.x.x.x.tgz ，
解压缩该文件，可以得到一个Hi3516A_SDK_Vx.x.x.x目录。
3、展开SDK包内容
返回Hi3516A_SDK_Vx.x.x.x目录，运行./sdk.unpack(请用root或sudo权限执行)将会展开SDK包打包压缩存放的内容，请按照提示完成操作。
（下一步，将sdk.unpack文件用文本打开，将#!/bin/sh，修改为#!/bin/bash；此处主要是因为Ubuntu下默认为Shell，而海思的需要bash的）
如果您需要通过WINDOWS操作系统中转拷贝SDK包，请先运行./sdk.cleanup，收起SDK包的内容，拷贝到新的目录后再展开。
4、在linux服务器上安装交叉编译器
1）安装uclibc交叉编译器（注意，需要有sudo权限或者root权限）：
（下一步，完成后，文件夹mpp,osdrv会生成一些文件。然后，进入Hi3516_SDK_V1.0.4.0/tools/toolchain下，解压arm编译器arm-hisiv300-linux.tar.bz2，具体命令式：
tar jxvf arm-hisiv300-linux.tar.bz2,生成arm-hisiv300-linux文件，该文件夹有相关的编译器文件；）
进入Hi3516A_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv300-linux目录，运行chmod +x cross.install，然后运行./cross.install即可。
（参考文档/etc/profile修改路径）
2) 安装glibc交叉编译器（注意，需要有sudo权限或者root权限）：
进入Hi3516A_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv400-linux目录，运行chmod +x cross.install，然后运行./cross.install即可。
3) 执行source /etc/profile， 安装交叉编译器的脚本配置的环境变量就可以生效了，或者请重新登陆也可。
5、编译osdrv
参见osdrv目录下readme（首先要安装 VM-tools，能够sudo apt-get update ，无误后继续下面的安装方可
问题
make all
~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/opensource/kernel/linux-3.18.y ~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv
"mkimage" command not found - U-Boot images will not be built
解决
wigewige@ubuntu:~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv$ sudo apt-get install u-boot-tools
问题 依赖关系 软件包配置
解决
1.先卸载了 open-vm-tools
sudo apt-get remove open-vm-tools
2.安装 open-vm-tools
sudo apt-get install open-vm-tools
问题
CC compr_zlib.o
compr_zlib.c:39:18: fatal error: zlib.h: No such file or directory
#include <zlib.h>
^
compilation terminated.
make[2]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/mtd-utils-1.5.0/compr_zlib.o] Error 1
make[2]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/mtd-utils-1.5.0'
make[1]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/sbin/mkfs.jffs2] Error 2
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool'
make: *** [hipctools] Error 2
解决
sudo apt-get install zlib1g-dev
问题
configure: error: ncurses or ncursesw selected, but library not found (--without-ncurses to disable)
make[1]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/cramfs_tool/tmp/sbin/mkfs.cramfs] Error 1
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/cramfs_tool'
make: *** [hipctools] Error 2
解决
sudo apt-get install libncurses5-dev libncursesw5-dev
问题
checking for C++ compiler default output file name...
configure: error: C++ compiler cannot create executables
See `config.log' for more details.
make[2]: Entering directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7'
make[2]: *** No targets specified and no makefile found. Stop.
make[2]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7'
~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool
cp: cannot stat ‘/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7/src/lzma/lzma’: No such file or directory
make[1]: *** [all] Error 1
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool'
make: *** [hipctools] Error 2
wigewige@ubuntu:~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv$
解决
sudo apt-get install g++）
问题 /bin/sh: pushd: not found
由于使用了/bin/sh 导致找不到pushd命令
切换回/bin/bash即可，但是我在shell中声明#!/bin/bash还是继续报错
看到一句解释如下：
This has to do with /bin/sh being linked to /bin/dash instead of /bin/bash in ubuntu’s latest releases. To fix it once and for all do the following:
使用下面的方法：
# mv /bin/sh /bin/sh-mod
# ln -s /bin/bash /bin/sh
问题：权限不够 注意文件夹是否有上锁标志 有其解锁方法为 sudo chmod -R 777 路径(文件夹或文件)
问题 ： 没有规则目标可以创建 确认是否在编译目录下编译）
6、SDK目录介绍
Hi3516A_SDK_Vx.x.x.x 目录结构如下：
|-- sdk.cleanup # SDK清理脚本
|-- sdk.unpack # SDK展开脚本
|-- osdrv # 存放操作系统及相关驱动的目录
| |-- opensource # opensource源代码
| | |-- busybox # busybox源代码
| | |-- kernel # linux内核源代码
| | |-- toolchain # 交叉编译器
| | |-- uboot # uboot源代码
| |-- pub # 编译好的镜像、工具、drv驱动等
| |-- tools # linux工具源代码
| |-- readme_cn.txt # osdrv使用说明（中文版）
| |-- readme_en.txt # osdrv使用说明（英文版）
| |-- ...... #
| `-- Makefile # osdrv Makefile
|-- package # 存放SDK各种压缩包的目录
| |-- osdrv.tgz # linux内核/uboot/rootfs/tools源码压缩包
| |-- mpp.tgz # 媒体处理平台软件压缩包
| |-- drv.tgz # drv压缩包
| |-- rootfs_*.tgz # rootfs压缩包
| |-- image * # 可供FLASH烧写的映像文件，如内核、根文件系统
|-- scripts # 存放shell脚本的目录
|-- drv # drv目录
|-- mpp # 存放媒体处理平台的目录
|-- component # 组件源代码
|-- extdrv # 板级外围驱动源代码
|-- include # 对外头文件
|-- ko # 内核模块
|-- lib # release版本库以及音频库
|-- Makefile.param # mpp一些全局编译选项
|-- tools # 媒体处理相关工具
`-- sample # 样例源代码
第三章、安装、升级Hi3516ADEMO板开发环境
# 如果您使用的Hi3516A的DEMO板，可以按照以下步骤烧写u-boot，内核以及文件系统，以下步骤均使用网络来更新。
# 通常，您拿到的单板中已经有u-boot，如果没有的话，就需要使用仿真器进行烧写。
# 更详细的操作步骤及说明，请参见01.software\board\documents目录下的《Linux开发环境用户指南》。
# 以下操作假设您的单板上已经有u-boot,使用网口烧写uboot、kernel及rootfs到Flash中。
# Demo单板默认为从SPI Flash启动。
1、配置tftp服务器
# 可以使用任意的tftp服务器，将package/image_uclibc(或image_glibc)下的相关文件拷贝到tftp服务器目录下。
【安装TFTP服务：
apt-get install tftp-hpa tftpd-hpa xinetd
---------------------------------------------------------------------
2.修改配置文件
在/etc/default下修改tftp服务的配置文件tftpd-hpa:
sudo gedit /etc/default/tftp-hpa
#/etc/default/tftpd-hpa
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="-l -c -s"
说明：修改项，其中TFTP_DIRECTORY处可以改为你的tftp-server的根目录，参数-c指定了可以创建文件。
sudo mkdir /tftpboot --创建/tftpboot目录
sudo chmod 777 /tftpboot -R --设置权限为777
---------------------------------------------------------------------
3.手动启动/停止服务
大家可以通过手动去启动/停止TFTP服务器，修改配置文件后必须重新启动服务。
a) 停止包括tftp在内的网络服务，查看状态显示为“not running”.
$ sudo service tftpd-hpa stop
tftpd-hpa stop/waiting
$ sudo service tftpd-hpa start
tftpd-hpa start/running, process 9948
b) 启动包括tftp在内的网络服务，查看状态显示为“running”
$ sudo service tftpd-hpa start
*Starting internet superserver xinetd [OK]
$ sudo service tftpd-hpa status
tftpd-hpa start/running, process 9875
c) 重新启动包括tftp在内的网络服务
$ sudo service tftpd-hpa restart
tftpd-hpa start/running, process 9953
4、重新启动tftp服务
sudo /etc/init.d/xinetd restart --重启tftp服务器
5、测试
sudo netstat -a | grep tftp --查看是否启动成功，可以看到udp 0 0 *: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 | 3M | 12M |
|---------------|---------------|---------------|
| boot | kernel | rootfs |
以下的操作均基于图示的地址空间分配，您也可以根据实际情况进行调整。
2）烧写u-boot
sf probe 0
mw.b 82000000 ff 100000
tftp 0x82000000 u-boot-hi3516a.bin
sf probe 0
sf erase 0 100000
sf write 82000000 0 100000
reset
3）烧写内核
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3516a
sf probe 0
sf erase 100000 300000
sf write 82000000 100000 300000
4)烧写文件系统
mw.b 82000000 ff C00000
tftp 0x82000000 rootfs_hi3516a_64k.jffs2
sf probe 0
sf erase 400000 C00000
sf write 82000000 400000 C00000
5）设置启动参数
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=jffs2 mtdparts=hi_sfc:1M(boot),3M(kernel),12M(rootfs)'
setenv bootcmd 'sf probe 0;sf read 0x82000000 0x100000 0x300000;bootm 0x82000000'
sa
4、烧写映像文件到NAND Flash
以64M NAND Flash为例。
1）地址空间说明
| 1M | 3M | 32M | 28M |
|---------------|---------------|---------------|------------------------|
| boot | kernel | rootfs | other |
以下的操作均基于图示的地址空间分配，您也可以根据实际情况进行调整。
2）烧写u-boot
mw.b 82000000 ff 100000
tftp 82000000 u-boot-hi3516a.bin
nand erase 0 100000
nand write 82000000 0 100000
reset
3）烧写内核
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3516a
nand erase 100000 300000
nand write 82000000 100000 300000
4)烧写文件系统
mw.b 82000000 ff 2000000
tftp 82000000 rootfs_Hi3516a_2k_4bit.yaffs2
nand erase 400000 2000000
nand write.yaffs 82000000 400000 96d200 #注意：96d200为rootfs文件实际大小（16进制）
5）设置启动参数
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hinand:1M(boot),3M(kernel),32M(rootfs),28M(test)'
setenv bootcmd 'nand read 0x82000000 0x100000 0x300000;bootm 0x82000000'
sa
5、启动新系统
reset # 重启进入新系统。
第四章、开发前环境准备
1、管脚复用
与媒体业务相关的管脚复用都在mpp/ko目录下的sh脚本中配置，如果与实际情况不符请直接修改，此脚本被load3516a调用，在加载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 -o rsize=32768,wsize=32768 xx.xx.xx.xx:/your-nfs-path /mnt
# 然后就可以在/mnt目录下访问服务器上的文件，并进行开发工作。
3、开启telnet服务
# 网络正常后，运行命令 telnetd& 就可以启动单板telnet服务，然后才能使用telnet登录到单板。
4、运行MPP业务
# 在单板linux系统下，进入mpp/ko目录，加载KO
cd mpp/ko
# default online
./load3516a -a -sensor mn34220 -osmem 64
# vi_vpss offline
./load3516a -a -sensor mn34220 -osmem 64 -offline
# 进入各sample目录下执行相应样例程序(sample需要先在服务器上成功编译过)
cd mpp/sample/vio
./sample_vio 0 1
第六章 地址空间分配与使用
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模块时，通过模块参数指定其起始地址及大小，load脚本中根据osmem大小来进行计算，例如：
./load3516a -a -sensor mn34220 -osmem 64
您也可以通过修改mpp/ko目录下load3516a脚本中的mmz模块参数，来修改其起始地址和总大小。
4）请注意MMZ内存地址范围不能与OS内存重叠。
2、DEMO板DDR内存管理示意
以容量为512MBytes的DDR内存为例，以下为根据本文档和SDK默认配置得到的内存管理示意图：
DDR:
-----|-------| 0x80000000 # Memory managed by OS.
64M | OS |
| |
-----|-------| 0x84000000 # Memory managed by MMZ block anonymous.
448M | MMZ |
| |
-----|-------| 0xA0000000 # Memory managed by MMZ block jpeg.
注意：
（1）用户在配置启动参数时需要设置OS的管理内存为64M，“setenv bootargs 'mem=64M ...”。
（2）系统启动后，配置load3516a脚本中指定总内存为512(mem_total=512)，加载时指定osmem为64(-osmem 64)，则MMZ管理的内存为448M。
（3）如果有特殊应用，可以自行修改load3516a脚本，进行mmz区域划分，如“insmod mmz.ko mmz=anonymous,0,0x84000000,442M:jpeg,0,0x9fa00000,5M anony=1”。
注意：本文以Hi3516A描述为例，未有特殊说明，Hi3516D与Hi3516A一致。
第一章 Hi3516A_SDK_Vx.x.x.x版本升级操作说明
如果您是首次安装本SDK，请直接参看第2章。
第二章 首次安装SDK
1、Hi3516A SDK包位置
在"Hi3516A_V100R001***/01.software/board"目录下，您可以看到一个 Hi3516A_SDK_Vx.x.x.x.tgz 的文件，
该文件就是Hi3516A的软件开发包。
2、解压缩SDK包
在linux服务器上（或者一台装有linux的PC上，主流的linux发行版本均可以），使用命令：tar -zxf Hi3516A_SDK_Vx.x.x.x.tgz ，
解压缩该文件，可以得到一个Hi3516A_SDK_Vx.x.x.x目录。
3、展开SDK包内容
返回Hi3516A_SDK_Vx.x.x.x目录，运行./sdk.unpack(请用root或sudo权限执行)将会展开SDK包打包压缩存放的内容，请按照提示完成操作。
（下一步，将sdk.unpack文件用文本打开，将#!/bin/sh，修改为#!/bin/bash；此处主要是因为Ubuntu下默认为Shell，而海思的需要bash的）
如果您需要通过WINDOWS操作系统中转拷贝SDK包，请先运行./sdk.cleanup，收起SDK包的内容，拷贝到新的目录后再展开。
4、在linux服务器上安装交叉编译器
1）安装uclibc交叉编译器（注意，需要有sudo权限或者root权限）：
（下一步，完成后，文件夹mpp,osdrv会生成一些文件。然后，进入Hi3516_SDK_V1.0.4.0/tools/toolchain下，解压arm编译器arm-hisiv300-linux.tar.bz2，具体命令式：
tar jxvf arm-hisiv300-linux.tar.bz2,生成arm-hisiv300-linux文件，该文件夹有相关的编译器文件；）
进入Hi3516A_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv300-linux目录，运行chmod +x cross.install，然后运行./cross.install即可。
（参考文档/etc/profile修改路径）
2) 安装glibc交叉编译器（注意，需要有sudo权限或者root权限）：
进入Hi3516A_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv400-linux目录，运行chmod +x cross.install，然后运行./cross.install即可。
3) 执行source /etc/profile， 安装交叉编译器的脚本配置的环境变量就可以生效了，或者请重新登陆也可。
5、编译osdrv
参见osdrv目录下readme（首先要安装 VM-tools，能够sudo apt-get update ，无误后继续下面的安装方可
问题
make all
~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/opensource/kernel/linux-3.18.y ~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv
"mkimage" command not found - U-Boot images will not be built
解决
wigewige@ubuntu:~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv$ sudo apt-get install u-boot-tools
问题 依赖关系 软件包配置
解决
1.先卸载了 open-vm-tools
sudo apt-get remove open-vm-tools
2.安装 open-vm-tools
sudo apt-get install open-vm-tools
问题
CC compr_zlib.o
compr_zlib.c:39:18: fatal error: zlib.h: No such file or directory
#include <zlib.h>
^
compilation terminated.
make[2]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/mtd-utils-1.5.0/compr_zlib.o] Error 1
make[2]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/mtd-utils-1.5.0'
make[1]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool/tmp/sbin/mkfs.jffs2] Error 2
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/jffs2_tool'
make: *** [hipctools] Error 2
解决
sudo apt-get install zlib1g-dev
问题
configure: error: ncurses or ncursesw selected, but library not found (--without-ncurses to disable)
make[1]: *** [/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/cramfs_tool/tmp/sbin/mkfs.cramfs] Error 1
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/cramfs_tool'
make: *** [hipctools] Error 2
解决
sudo apt-get install libncurses5-dev libncursesw5-dev
问题
checking for C++ compiler default output file name...
configure: error: C++ compiler cannot create executables
See `config.log' for more details.
make[2]: Entering directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7'
make[2]: *** No targets specified and no makefile found. Stop.
make[2]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7'
~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool
cp: cannot stat ‘/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool/lzma-4.32.7/src/lzma/lzma’: No such file or directory
make[1]: *** [all] Error 1
make[1]: Leaving directory `/home/wigewige/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv/tools/pc/lzma_tool'
make: *** [hipctools] Error 2
wigewige@ubuntu:~/share/develop/kandao/hisi/Hi3519V101_SDK_V1.0.1.0/osdrv$
解决
sudo apt-get install g++）
问题 /bin/sh: pushd: not found
由于使用了/bin/sh 导致找不到pushd命令
切换回/bin/bash即可，但是我在shell中声明#!/bin/bash还是继续报错
看到一句解释如下：
This has to do with /bin/sh being linked to /bin/dash instead of /bin/bash in ubuntu’s latest releases. To fix it once and for all do the following:
使用下面的方法：
# mv /bin/sh /bin/sh-mod
# ln -s /bin/bash /bin/sh
问题：权限不够 注意文件夹是否有上锁标志 有其解锁方法为 sudo chmod -R 777 路径(文件夹或文件)
问题 ： 没有规则目标可以创建 确认是否在编译目录下编译）
6、SDK目录介绍
Hi3516A_SDK_Vx.x.x.x 目录结构如下：
|-- sdk.cleanup # SDK清理脚本
|-- sdk.unpack # SDK展开脚本
|-- osdrv # 存放操作系统及相关驱动的目录
| |-- opensource # opensource源代码
| | |-- busybox # busybox源代码
| | |-- kernel # linux内核源代码
| | |-- toolchain # 交叉编译器
| | |-- uboot # uboot源代码
| |-- pub # 编译好的镜像、工具、drv驱动等
| |-- tools # linux工具源代码
| |-- readme_cn.txt # osdrv使用说明（中文版）
| |-- readme_en.txt # osdrv使用说明（英文版）
| |-- ...... #
| `-- Makefile # osdrv Makefile
|-- package # 存放SDK各种压缩包的目录
| |-- osdrv.tgz # linux内核/uboot/rootfs/tools源码压缩包
| |-- mpp.tgz # 媒体处理平台软件压缩包
| |-- drv.tgz # drv压缩包
| |-- rootfs_*.tgz # rootfs压缩包
| |-- image * # 可供FLASH烧写的映像文件，如内核、根文件系统
|-- scripts # 存放shell脚本的目录
|-- drv # drv目录
|-- mpp # 存放媒体处理平台的目录
|-- component # 组件源代码
|-- extdrv # 板级外围驱动源代码
|-- include # 对外头文件
|-- ko # 内核模块
|-- lib # release版本库以及音频库
|-- Makefile.param # mpp一些全局编译选项
|-- tools # 媒体处理相关工具
`-- sample # 样例源代码
第三章、安装、升级Hi3516ADEMO板开发环境
# 如果您使用的Hi3516A的DEMO板，可以按照以下步骤烧写u-boot，内核以及文件系统，以下步骤均使用网络来更新。
# 通常，您拿到的单板中已经有u-boot，如果没有的话，就需要使用仿真器进行烧写。
# 更详细的操作步骤及说明，请参见01.software\board\documents目录下的《Linux开发环境用户指南》。
# 以下操作假设您的单板上已经有u-boot,使用网口烧写uboot、kernel及rootfs到Flash中。
# Demo单板默认为从SPI Flash启动。
1、配置tftp服务器
# 可以使用任意的tftp服务器，将package/image_uclibc(或image_glibc)下的相关文件拷贝到tftp服务器目录下。
【安装TFTP服务：
apt-get install tftp-hpa tftpd-hpa xinetd
---------------------------------------------------------------------
2.修改配置文件
在/etc/default下修改tftp服务的配置文件tftpd-hpa:
sudo gedit /etc/default/tftp-hpa
#/etc/default/tftpd-hpa
TFTP_USERNAME="tftp"
TFTP_DIRECTORY="/tftpboot"
TFTP_ADDRESS="0.0.0.0:69"
TFTP_OPTIONS="-l -c -s"
说明：修改项，其中TFTP_DIRECTORY处可以改为你的tftp-server的根目录，参数-c指定了可以创建文件。
sudo mkdir /tftpboot --创建/tftpboot目录
sudo chmod 777 /tftpboot -R --设置权限为777
---------------------------------------------------------------------
3.手动启动/停止服务
大家可以通过手动去启动/停止TFTP服务器，修改配置文件后必须重新启动服务。
a) 停止包括tftp在内的网络服务，查看状态显示为“not running”.
$ sudo service tftpd-hpa stop
tftpd-hpa stop/waiting
$ sudo service tftpd-hpa start
tftpd-hpa start/running, process 9948
b) 启动包括tftp在内的网络服务，查看状态显示为“running”
$ sudo service tftpd-hpa start
*Starting internet superserver xinetd [OK]
$ sudo service tftpd-hpa status
tftpd-hpa start/running, process 9875
c) 重新启动包括tftp在内的网络服务
$ sudo service tftpd-hpa restart
tftpd-hpa start/running, process 9953
4、重新启动tftp服务
sudo /etc/init.d/xinetd restart --重启tftp服务器
5、测试
sudo netstat -a | grep tftp --查看是否启动成功，可以看到udp 0 0 *: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 | 3M | 12M |
|---------------|---------------|---------------|
| boot | kernel | rootfs |
以下的操作均基于图示的地址空间分配，您也可以根据实际情况进行调整。
2）烧写u-boot
sf probe 0
mw.b 82000000 ff 100000
tftp 0x82000000 u-boot-hi3516a.bin
sf probe 0
sf erase 0 100000
sf write 82000000 0 100000
reset
3）烧写内核
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3516a
sf probe 0
sf erase 100000 300000
sf write 82000000 100000 300000
4)烧写文件系统
mw.b 82000000 ff C00000
tftp 0x82000000 rootfs_hi3516a_64k.jffs2
sf probe 0
sf erase 400000 C00000
sf write 82000000 400000 C00000
5）设置启动参数
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=jffs2 mtdparts=hi_sfc:1M(boot),3M(kernel),12M(rootfs)'
setenv bootcmd 'sf probe 0;sf read 0x82000000 0x100000 0x300000;bootm 0x82000000'
sa
4、烧写映像文件到NAND Flash
以64M NAND Flash为例。
1）地址空间说明
| 1M | 3M | 32M | 28M |
|---------------|---------------|---------------|------------------------|
| boot | kernel | rootfs | other |
以下的操作均基于图示的地址空间分配，您也可以根据实际情况进行调整。
2）烧写u-boot
mw.b 82000000 ff 100000
tftp 82000000 u-boot-hi3516a.bin
nand erase 0 100000
nand write 82000000 0 100000
reset
3）烧写内核
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3516a
nand erase 100000 300000
nand write 82000000 100000 300000
4)烧写文件系统
mw.b 82000000 ff 2000000
tftp 82000000 rootfs_Hi3516a_2k_4bit.yaffs2
nand erase 400000 2000000
nand write.yaffs 82000000 400000 96d200 #注意：96d200为rootfs文件实际大小（16进制）
5）设置启动参数
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hinand:1M(boot),3M(kernel),32M(rootfs),28M(test)'
setenv bootcmd 'nand read 0x82000000 0x100000 0x300000;bootm 0x82000000'
sa
5、启动新系统
reset # 重启进入新系统。
第四章、开发前环境准备
1、管脚复用
与媒体业务相关的管脚复用都在mpp/ko目录下的sh脚本中配置，如果与实际情况不符请直接修改，此脚本被load3516a调用，在加载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 -o rsize=32768,wsize=32768 xx.xx.xx.xx:/your-nfs-path /mnt
# 然后就可以在/mnt目录下访问服务器上的文件，并进行开发工作。
3、开启telnet服务
# 网络正常后，运行命令 telnetd& 就可以启动单板telnet服务，然后才能使用telnet登录到单板。
4、运行MPP业务
# 在单板linux系统下，进入mpp/ko目录，加载KO
cd mpp/ko
# default online
./load3516a -a -sensor mn34220 -osmem 64
# vi_vpss offline
./load3516a -a -sensor mn34220 -osmem 64 -offline
# 进入各sample目录下执行相应样例程序(sample需要先在服务器上成功编译过)
cd mpp/sample/vio
./sample_vio 0 1
第六章 地址空间分配与使用
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模块时，通过模块参数指定其起始地址及大小，load脚本中根据osmem大小来进行计算，例如：
./load3516a -a -sensor mn34220 -osmem 64
您也可以通过修改mpp/ko目录下load3516a脚本中的mmz模块参数，来修改其起始地址和总大小。
4）请注意MMZ内存地址范围不能与OS内存重叠。
2、DEMO板DDR内存管理示意
以容量为512MBytes的DDR内存为例，以下为根据本文档和SDK默认配置得到的内存管理示意图：
DDR:
-----|-------| 0x80000000 # Memory managed by OS.
64M | OS |
| |
-----|-------| 0x84000000 # Memory managed by MMZ block anonymous.
448M | MMZ |
| |
-----|-------| 0xA0000000 # Memory managed by MMZ block jpeg.
注意：
（1）用户在配置启动参数时需要设置OS的管理内存为64M，“setenv bootargs 'mem=64M ...”。
（2）系统启动后，配置load3516a脚本中指定总内存为512(mem_total=512)，加载时指定osmem为64(-osmem 64)，则MMZ管理的内存为448M。
（3）如果有特殊应用，可以自行修改load3516a脚本，进行mmz区域划分，如“insmod mmz.ko mmz=anonymous,0,0x84000000,442M:jpeg,0,0x9fa00000,5M anony=1”。