Hi3519V101/Hi3516AV200 （之）SDK 安裝以及升級使用說明
Hi3519V101/Hi3516AV200 （之）SDK 安裝以及升級使用說明
說明：本文以Hi3519V101描述為例，如未有特殊說明，Hi3516AV200與Hi3519V101完全一致。
第一章 Hi3519V101_SDK_Vx.x.x.x版本升級操作說明
如果您已安裝過SDK，請直接參看第三章。
第二章 首次安裝SDK
1、Hi3519V101 SDK包位置
在"Hi3519***/01.software/board"目錄下，您可以看到一個 Hi3519V101_SDK_Vx.x.x.x.tgz 的檔案，
該檔案就是Hi3519V101 的軟體開發包。
2、解壓縮SDK包
在linux伺服器上（或者一臺裝有linux的PC上，主流的linux發行版本均可以），使用命令：tar -zxf Hi3519V101_SDK_Vx.x.x.x.tgz ，
解壓縮該檔案，可以得到一個Hi3519V101_SDK_Vx.x.x.x目錄。
3、展開SDK包內容
返回Hi3519V101_SDK_Vx.x.x.x目錄，執行./sdk.unpack(請用root或sudo許可權執行)將會展開SDK包打包壓縮存放的內容，請按照提示完成操作。
如果您需要通過WINDOWS作業系統中轉拷貝SDK包，請先執行./sdk.cleanup，收起SDK包的內容，拷貝到新的目錄後再展開。
4、在linux伺服器上安裝交叉編譯器
1）安裝uclibc交叉編譯器（注意，需要有sudo許可權或者root許可權）：
進入Hi3519V101_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv500-linux目錄，執行chmod +x arm-hisiv500-linux.install，然後執行./arm-hisiv500-linux.install即可。
2) 安裝glibc交叉編譯器（注意，需要有sudo許可權或者root許可權）：
進入Hi3519V101_SDK_Vx.x.x.x/osdrv/opensource/toolchain/arm-hisiv600-linux目錄，執行chmod +x arm-hisiv600-linux.install，然後執行./arm-hisiv600-linux.install即可。
3) 執行source /etc/profile， 安裝交叉編譯器的指令碼配置的環境變數就可以生效了，或者請重新登陸也可。
5、編譯osdrv
參見osdrv目錄下readme
6、SDK目錄介紹
Hi3519V101_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
|-- osal # 存放作業系統適配層的標頭檔案和原始檔的目錄
| |-- include # 存放作業系統適配層的標頭檔案的目錄
| |-- source # 存放作業系統適配層的原始檔的目錄
|-- package # 存放SDK各種壓縮包的目錄
| |-- osdrv.tgz # linux核心/uboot/rootfs/tools原始碼壓縮包
| |-- osal.tgz # 作業系統適配層原始碼壓縮包
| |-- mpp_*.tgz # 媒體處理平臺軟體壓縮包
| |-- drv.tgz # drv壓縮包
| |-- image_* # 可供FLASH燒寫的映像檔案(如核心、根檔案系統)和rootfs的壓縮包
|-- scripts # 存放shell指令碼的目錄
|-- drv # drv目錄
| |-- extdrv # 板級外圍驅動原始碼
| |-- interdrv # mipi,rtc,cipher等驅動原始碼
|-- mpp_single # 存放單核媒體處理平臺的目錄
| |-- component # 元件原始碼
| |-- init # 核心模組的初始化原始碼
| |-- obj # 核心模組的obj檔案
| |-- include # 對外標頭檔案
| |-- ko # 核心模組
| |-- lib # release版本庫以及音訊庫
| |-- Makefile.param # mpp一些全域性編譯選項
| |-- Makefile # mpp的Makefile
| |-- linux.param # mpp一些跟作業系統相關的全域性編譯選項
| |-- tools # 媒體處理相關工具
| |-- sample # 樣例原始碼
|-- mpp_big-little # 存放big-little雙核媒體處理平臺的目錄
第三章、安裝、升級Hi3519V101/Hi3516AV200 DEMO板開發環境
# 如果您使用Hi3519V101/Hi3516AV200 的DEMO板，可以按照以下操作燒寫uboot、核心以及檔案系統，以下操作均使用網路來更新。
1、如果您拿到的單板沒有uboot，就需要使用Hi3519***/01.software/pc/HiTool進行燒寫。更詳細的燒寫操作步驟及說明，請參見01.software\pc\HiTool目錄下的《HiBurn 工具使用指南》。
2、如果您拿到的單板中已經有uboot，可以按照以下步驟使用網口燒寫uboot、kernel及rootfs到Flash中。DEMO板預設為從SPI Flash啟動。
1、配置tftp伺服器
# 可以使用任意的tftp伺服器，並將package/image_uclibc_xxx(或image_glibc_xxx)下的相關檔案拷貝到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
mw.b 82000000 ff 100000
tftp 0x82000000 u-boot-hi3519.bin
sf probe 0
sf erase 0 100000
sf write 82000000 0 100000
reset
請注意，reset之後需要重新設定網路引數。
3）燒寫核心
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3519
sf probe 0
sf erase 100000 300000
sf write 82000000 100000 300000
4)燒寫檔案系統
mw.b 82000000 ff C00000
tftp 0x82000000 rootfs_hi3519_64k.jffs2
sf probe 0
sf erase 400000 C00000
sf write 82000000 400000 C00000
5）設定啟動引數（注意linux-3.18.y kernel預設檔案系統只讀，需要在bootargs中加入rw選項，檔案系統才可讀寫）
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=jffs2 rw 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-hi3519.bin
nand erase 0 100000
nand write 82000000 0 100000
reset
請注意，reset之後需要重新設定網路引數。
3）燒寫核心
mw.b 82000000 ff 300000
tftp 82000000 uImage_hi3519
nand erase 100000 300000
nand write 82000000 100000 300000
4)燒寫檔案系統
mw.b 82000000 ff 2000000
tftp 82000000 rootfs_hi3519_2k_4bit.yaffs2
nand erase 400000 2000000
nand write.yaffs 82000000 400000 96d200 #注意：96d200為rootfs檔案實際大小（16進位制）
5）設定啟動引數（注意linux-3.18.y kernel預設檔案系統只讀，需要在bootargs中加入rw選項，檔案系統才可讀寫）
setenv bootargs 'mem=64M console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 rw mtdparts=hinand:1M(boot),3M(kernel),32M(rootfs),28M(test)'
setenv bootcmd 'nand read 0x82000000 0x100000 0x300000;bootm 0x82000000'
sa
5、啟動新系統
reset # 重啟進入新系統。
第四章、開發前環境準備
1、管腳複用
無。
第五章、使用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目錄，載入驅動
cd mpp_xxx/ko
# default online
./load3519v101 -a -sensor0 imx274 -osmem 64
Hi3519V101在online模式下只支援一個sensor。
# vi_vpss offline
./load3519v101 -a -sensor0 ov4689 -sensor1 ov4689 -osmem 64 -offline -workmode double_pipe
Hi3519V101在offline模式支援兩個sensor輸入。分別由-sensor0和-sensor1指定所使用的sensor型號。如果只使用一個sensor，可以只指定-sensor0或-sensor1其中一個，另外一個不需要指定。
-workmode選項表示兩個VI裝置的工作模式，可以選擇stitching、double_pipe或single_pipe，double_pipe表示兩個VI裝置處於double_pipe拍照模式，stitching表示兩個VI裝置處於雙路拼接模式，
single_pipe表示兩個VI裝置單獨工作。預設為single_pipe模式。
# 進入各sample目錄下執行相應樣例程式(sample需要先在伺服器上成功編譯過)
cd mpp_xxx/sample/vio
./sample_vio 0 1
第六章 地址空間分配與使用
1、DDR記憶體管理說明
1）所有DDR記憶體中，一部分由作業系統管理，稱為OS記憶體；另一部分由osal模組管理，供媒體業務單獨使用，稱為MMZ記憶體。
2）OS記憶體起始地址為0x80000000，記憶體大小可通過bootargs進行配置，例如第三章中的setenv bootargs 'mem=64M ... ',表示分配給作業系統記憶體為64M，您可以根據實際情況進行調整。
3）MMZ記憶體由osal核心模組管理（mpp/ko目錄下的hi_osal.ko），載入osal模組時，通過模組引數指定其起始地址及大小，load指令碼中根據total和osmem大小來進行計算，例如：
./load3519v101 -a -sensor0 imx226 -osmem 64
您也可以通過修改mpp_xxx/ko目錄下load3519v101指令碼中的osal模組引數，來修改其起始地址和總大小。
4）請注意MMZ記憶體地址範圍不能與OS記憶體重疊。
2、DEMO板DDR記憶體管理示意
以容量為128MBytes的DDR記憶體為例，以下為根據本文件和SDK預設配置得到的記憶體管理示意圖：
DDR:
-----|-------| 0x80000000 # Memory managed by OS.
64M | OS |
| |
-----|-------| 0x84000000 # Memory managed by MMZ block anonymous.
64M | MMZ |
| |
-----|-------| 0x88000000 # Memory managed by MMZ block.
注意：
（1）使用者在配置啟動引數時需要設定OS的管理記憶體為64M，“setenv bootargs 'mem=64M ...”。
（2）系統啟動後，載入時指定osmem為64(-osmem 64)，預設記憶體總大小512M，則MMZ管理的記憶體為448M;
（3）如果有特殊應用，可以自行修改load3519v101指令碼，進行mmz區域劃分，如“insmod hi_osal.ko mmz=anonymous,0,0x82000000,30M:jpeg,0,0x83E00000,2M： anony=1”。