Hi3516A/Hi3516D SDK 安裝以及升級使用說明
阿新 • • 發佈：2018-12-02
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許可權）：
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即可。
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
解決
問題 依賴關係 軟體包配置
解決
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
[email protected]:~/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許可權）：
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即可。
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
解決
問題 依賴關係 軟體包配置
解決
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
[email protected]:~/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”。