海思SDK编译实践 -- hi3716cv200es1

---------------------------------------------------------------------------------------------------------------------------------------------------

（2013.08.04 tonyfield 本文在海思SDK 源码包的 install_notes(chs).txt  基础上按自己实际编译遇到问题增补，增补部分做了颜色标记）

环境：E1230 v2 / Ubuntu12.04 _amd64

----------------------------------------------------------------------------------------------------------------------------------------------------

                             发布包使用说明      

在使用SDK之前，请务必仔细阅读此文档。
=========================================
编译SDK
=========================================
1. linux服务器需求
   ---Linux发行版  推荐ubuntu 10及以上版本
   ---glibc        推荐2.11.1版本
   ---GNU Make     推荐3.8.1及以上版本
   ---shell:       必须为bash
      修改linux服务器默认sh为bash的方法
      rm -f /bin/sh
      ln -s /bin/bash  /bin/sh

   ---正确配置并启动ssh samba nfs服务

$ sudo apt-get install openssh-server                 ------- 安装 ssh

$ sudo service ssh start                                         ------- 启动 ssh

$ sudo apt-get install samba                                ------- 安装 samba

$ sudo service samba start                                   ------- 启动 samba

$ sudo apt-get install nfs-kernel-server              ------- 安装 nfs

$ sudo service portmap start                                 ------- 由于NFS要依靠portmap服务才能通讯的，如果客户机要连到这台NFS Server上的话，最好在客户机上也安装一下服务，同时启动一下protmap

然后检查以上三个服务是否已经启动

$ service --status-all

2. 准备
2.1 安装交叉编译工具链  

  sudo  ./server_install

   【注意事项】
    ---使用root权限或者sudo权限执行
    ---执行完成后，强烈建议重启linux服务器或者重新登录服务器
    ---安装交叉编译工具链会覆盖之前安装过的同名编译器
    ---交叉编译工具链安装后对所有使用该服务器的用户有效
    
2.3 安装编译过程中使用到的其他工具
    make tools_install

    该操作会生成编译过程中使用到的其他工具

》》如果报告编译错误，报告最前面的错误是 “cannot find -lz”，表示你需要安装 zlibc，-ld 的意思就是 load zlib，用下面命令完成

$ sudo apt-get install zlib1g-dev                      （安装zlibc 对着个问题没有用）

》》如果报以下错误：

make[4]: Entering directory   ......./HiSTBV100-SRC/tools/linux/utils/mkbootargs'
gcc -lz -o mkbootargs mkbootargs.c
/tmp/ccptjGr6.o: In function `main':
mkbootargs.c:(.text+0xdc1): undefined reference to `crc32'

这是由于命令 “gcc -lz -o mkbootargs mkbootargs.c” 从右向左执行，所以还没链接到zlib时就编译 .c文件，文件内找不到crc32的定义
修改../HiSTBV100-SRC/tools/linux/utils/mkbootargs/makefile，将

$(CC) -lz -o $(TARGET) mkbootargs.c

改为

$(CC) -o $(TARGET) mkbootargs.c -lz

就好了

》》如果报以下错误：

undefined reference to `stdscr'

可以通过安装ncurses库解决

sudo apt-get install libncurses5-dev

至此，交叉编译生成工具链

重启动系统后进行下面步骤  （之后尚无增补内容）

3. 配置
3.1 选择配置文件
    configs目录下提供了针对demo板的默认配置文件
    cp  configs/xxxx.cfg  ./cfg.mak
   
3.2 查看和修改SDK配置
    make menuconfig
    如果修改了配置选项，在退出menuconfig菜单时会提示"Do you wish to save your new SDK configuration?"
    选择Yes所有修改会保存在./cfg.mak文件中;选择No放弃修改。

4. 编译
    支持一键式编译和分步编译
4.1 一键式编译
    make build

4.2 分步骤编译
    make prepare           准备编译文件 编译其他目标前必须运行该命令
    make hiboot_install    编译boot   生成fastboot-burn.bin
    make linux_install     编译linux  生成hi_kernel.bin
    make rootfs_install    编译rootfs 生成基本的rootfs目录 包括基本目录结构、busybox、C库、utils、基本启动脚本等
    make common_install    编译common 生成common的库和驱动
    make msp_install       编译msp    生成msp各个模块的库和驱动
    make component_install 编译component  生成component的库和驱动
    make rootbox_install   编译rootbox 生成用于制作根文件系统镜像的文件夹rootbox
    make fs                编译fs      生成用于烧写flash的根文件系统镜像 rootbox_xxx.jffs2/rootbox_xxx.yaffs/rootbox_xxx.cramfs
    make sample            编译sample  生成各个sample的可执行程序 位于sample的各个子目录下
    
   【注意事项】    
    ---用户可以根据自己的需要修改rootbox.mk，决定rootbox中放置的内容
    ---make msp_install M=xxx 可以单独编译某个模块  如make msp_install M=demux
    ---make component_install M=xxx 可以单独编译某个组件
    ---分步骤编译时，编译所有目标前必须先make prepare 准备好编译内容
    ---分步骤编译时，编译common msp component之前必须先make linux_install
    ---更详细的编译命令 请参考make help
    
4.3 单独编译内核
     如果用户需要修改内核默认配置，可以使用以下方法单独编译内核镜像
  1> 解压缩SDK中的内核:
     cd source/kenel/
     tar -xf linux-2.6.35.tar.bz2
 
  2> 选择配置文件:
     假设使用的配置文件名称为hixxxx_yyy_defconfig
     cp ./linux-2.6.35.config/hixxxx/hixxxx_yyy_defconfig ./linux-2.6.35/arch/arm/configs
     cd ./linux-2.6.35
     make ARCH=arm CROSS_COMPILE=arm-hisiv200-linux- hixxxx_yyy_defconfig
               
  3> 打开内核配置菜单:
     cp arch/arm/configs/hixxxx_yyy_defconfig .config
     make ARCH=arm CROSS_COMPILE=arm-hisiv200-linux- menuconfig
     
  4> 编译内核:
     make ARCH=arm CROSS_COMPILE=arm-hisiv200-linux- uImage -j 128
     注意: 不要用 zImage, 否则内核无法启动。
     
  5. 编译后的镜像文件为: arch/arm/boot/uImage

=========================================
烧写镜像
=========================================
   单板上没有烧写boot或者boot已经损坏时，必须使用HiTool工具烧写；boot可用时，可以选择使用HiTool工具烧写或者使用命令行烧写。
   
1. HiTool工具烧写
   HiTool工具安装文件位置  tools/windows/HiTool
   使用方法参考《HiTool工具快速入门视频.exe》

2. Boot命令行烧写
   单板启动时，按着键盘CTRL+C可以进入到boot的命令行模式
   fastboot#
   输入help 可以查看boot命令行下支持的所有命令
   输入help xxx 可以查看xxx命令的详细帮助信息
   boot命令行下支持通过tab键补全命令
    
2.1 配置网络参数
    setenv serverip xxx.xxx.xxx.xxx
    setenv ipaddr xxx.xxx.xxx.xxx
    setenv gatewayip xxx.xxx.xxx.xxx
    setenv ethaddr 00:xx:xx:xx:xx:xx
    setenv netmask 255.255.xxx.0
    配置完成后用ping xxx.xxx.xxx.xxx 测试单板与ftp服务器之间的连通性。

2.2.分区地址
    假设flash上分区分配如下：
    分区名称        偏移         大小
    boot:           0x00000000   0x0080000   
    bootargs:       0x00080000   0x0100000   
    kernel:         0x00100000   0x0400000   
    rootfs:            0x00500000   0x6000000   
    
   【注意事项】
    ---偏移是相对flash的首地址的偏移
    ---flash可以为spi/nand/emmc，用户需要根据单板配置合理安排分区

2.3.烧写命令
    假设内存起始地址为0x0,为boot预留0x1000000,0x1000000以后的空间可以用于镜像下载
    nand flash:
    命令：
        获取帮助：help nand
        擦除：nand erase startpos length
        读取：nand read ddroffset start length
        写入：nand write ddroffset start length

    下载boot：
        mw.b 1000000 ff 80000                       //将0x1000000写为0xff，写0x80000
        tftp 1000000 fastboot-burn.bin              //将fastboot-burn.bin下载到0x1000000
        nand erase 0 100000                         //擦写flash上0x0起始的0x100000空间
        nand write 1000000 0 80000                  //把0x1000000起始长度为0x80000的内容(fastboot-burn.bin)写入nand flash 0x0起始的位置
        慎重一点，最好先确认下载到内存成功，然后再擦除flash

    下载linux：
        mw.b 1000000 ff 400000                         
        tftp 1000000 hi_kernel.bin                     
        nand erase 100000 400000                        
        nand write 1000000 100000 400000               

    下载文件系统(使用yaffs)：
        mw.b 1000000 ff 6000000                      
        tftp 1000000 rootfs.yaffs                  
        nand erase 500000 6000000                      
        nand write.yaffs 1000000 500000 $(filesize)      //把0x1000000起始长度为$(filesize)的内容(rootfs.yaffs)写入nand flash 0x500000位置，
                                                          boot会自动识别$(filesize)为rootfs.yaffs的大小。
   【注意事项】
    ---nand flash上使用yaffs/cramfs/squashfs文件系统                                                           

    spi flash:
    命令：
        获取帮助：help sf
        探测：sf probe 0
        擦除：sf erase startpos length
        读取：sf read ddroffset start length
        写入：sf write ddroffset start length

    下载uboot：
        sf probe 0                         //探测一下是否存在spi flash
        mw.b 1000000 ff 80000             //将0x1000000写为0xff，写0x80000
        tftp 1000000 fastboot-burn.bin    //将fastboot-burn.bin下载到0x1000000
        sf erase 0 80000                  //擦写flash上0x0起始的0x80000空间
        sf write 1000000 0 80000          //把0x1000000起始长度为0x80000的内容(fastboot-burn.bin)写入nand flash 0x0起始的位置
        慎重一点，最好先确认下载到内存成功，然后再擦除flash

    下载linux：
        sf probe 0
        mw.b 1000000 ff 400000              
        tftp 1000000 hi_kernel.bin          
        sf erase 100000 400000               
        sf write 1000000 100000 400000      

    下载文件系统：
        sf probe 0                          
        mw.b 1000000 ff b00000             
        tftp 1000000 rootfs.jffs2          
        sf erase 500000 b00000              
        sf write 1000000 500000 b00000     
    
   【注意事项】
    ---spi flash上使用jffs2/cramfs/squashfs文件系统

    hi3716cv200es tst单板的烧写：
    下载uboot：
        sf probe 0
        mw.b 1000000 ff c0000
        tftp 1000000 fastboot-burn.bin
        sf erase 0 c0000
        sf write 1000000 0 c0000

    下载linux：
        mw.b 1000000 ff 600000
        tftp 1000000 hi_kernel.bin
        nand erase 0 600000
        nand write 1000000 0 600000

    下载文件系统：
        mw.b 1000000 ff 3C00000
        tftp 1000000 rootfs_4k24b.yaffs
        nand erase 600000 3C00000
        nand write.yaffs 1000000 600000 $(filesize)

    eMMC flash:
    命令：
        获取帮助：help mmc
        读取：mmc read 0 ddroffset startblock blockcount  
        写入：mmc write 0 ddroffset startblock blockcount
   【注意事项】
    ---eMMC flash读写操作的单位是块，块大小为512Bytes
    ---eMMC flash上使用ext3文件系统
    ---eMMC flash上烧写镜像使用命令行操作过于复杂，推荐使用HiTool工具烧写
 
=========================================
设置系统启动参数
=========================================
   必须正确设置bootargs参数或者烧写bootargs镜像才能保证系统正常启动

1. bootargs变量介绍
   以下面bootargs为例说明各个变量的含义
   'mem=1G console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hi_sfc:1M(boot);hinand:6M(kernel),96M(rootfs),1M(baseparam),1M(logo),-(others) mmz=ddr,0,0,300M'
   各变量含义如下
   mem
      整个DDR被划分为两部分：系统内存和mmz。mem表示整个DDR大小，mmz表示mmz区域大小。
      用户需要根据单板配置及内存占用情况合理配置mem和mmz大小。
   mmz:
      格式ddr,0,0,size size表示整个DDR中预留给MMZ使用的空间大小。例如mmz=ddr,0,0,300M表示在整个mem中预留300M供MMZ使用，其余分配给系统内存使用
   console：
      控制台参数。console=ttyAMA0,115200表示使用串口0作为控制台设备 波特率为115200
   root：
      表示根文件系统所在的设备分区 例如/dev/mtdblock2表示/dev/mtdblock2为根文件系统 对应mtdparts中的rootfs分区
     【注意事项】
      mtdparts中的分区从0开始编号。如果单板上有spiflash，即使spi flash上没有划分分区，spi flash也会对应/dev/mtdblock0
   rootfstype：
      根文件系统类型 此处为yaffs
   mtdparts：
      flash上的分区划分 格式 mtdparts=flashtype:size(name),size(name),...,-(others);flashtype:size(name),size(name),...,-(others);...
   
      
2. 启动参数的设置
   假设bootargs的内容为'mem=1G console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hi_sfc:1M(boot);hinand:6M(kernel),96M(rootfs),1M(baseparam),1M(logo),-(others) mmz=ddr,0,0,300M'
   设置启动参数的命令如下
   setenv bootargs 'mem=1G console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hi_sfc:1M(boot);hinand:6M(kernel),96M(rootfs),1M(baseparam),1M(logo),-(others) mmz=ddr,0,0,300M'
   setenv bootcmd 'nand read 1000000 0 600000;bootm 1000000'  //bootcmd命令加载内核到0x1000000,然后跳转到0x1000000执行
   saveenv
   
   启动参数例子：
   ---hi3716cv200es tst单板：spi flash 4M nand Flash 4G ddr 2G
      boot在spi flash, kernel和文件系统在nand flash:
      setenv bootcmd 'nand read 1000000 0 600000;bootm 1000000'
      setenv bootargs 'mem=1G console=ttyAMA0,115200 root=/dev/mtdblock2 rootfstype=yaffs2 mtdparts=hi_sfc:1M(boot);hinand:6M(kernel),96M(rootfs),1M(baseparam),1M(logo),-(others) mmz=ddr,0,0,300M'

   ---hi3716cv200es tst单板：eMMC 4G ddr 2G
      set bootcmd 'mmc read 0 0x1000000 0x800 0x3000;bootm 0x1000000'
      setenv bootargs 'mem=1G console=ttyAMA0,115200 root=/dev/mmcblk0p5 rootfstype=ext3 rootwait mmz=ddr,0,0,300M mtdparts=hi_emmc:1M(boot),6M(kernel),1M(baseparam),1M(logo) emmcparts=96M(rootfs),-(others)'

3. 重启系统    
    在boot命令行下执行reset或按单板复位键，系统复位重启引导进入HiLinux，显示如下字样表示启动成功
    Welcome to HiLinux.
    #
=========================================
挂载NFS调试程序
=========================================
   启动HiLinux后 使用下面命令配置网络并挂载NFS进行程序调试
1. 配置单板网络
   ifconfig eth0 hw ether 00:xx:xx:xx:xx:xx;               设置eth0的MAC地址 网络中MAC地址要唯一
   ifconfig eth0 xxx.xxx.xxx.xxx netmask 255.255.xxx.0;    设置eth0的ip地址和子网掩码
   route add default gw xxx.xxx.xxx.x;                     设置网络默认路由 跨网络访问时必须设置

2. 挂载NFS    
   假设SDK代码根目录在交叉编译服务器上的路径为/xxx/sdk_root，下面命令可以将sdk_root通过NFS挂载在单板根文件系统的/mnt目录下
   mount -t nfs -o nolock -o tcp xxx.xxx.xxx.xxx:/xxx/sdk_root /mnt     
   请确保单板与服务器之间网络连通，并且服务器上的NFS服务已经正确配置

3. 增加动态库文件搜索路径 /mnt/pub/libs/share   
   export LD_LIBRARY_PATH="/mnt/pub/libs/share:$LD_LIBRARY_PATH"  

4. 替换模块ko
   cd /mnt/pub/kmod/
   rmmod xxx.ko
   insmod xxx.ko

5. 运行sample
   cd /mnt/sample/xxx
   ./sample_xxx
   
=========================================
挂载U盘
=========================================   
   启动HiLinux后,假设将U盘对应的设备文件/dev/sda挂载在/usb目录下
1. 加载ko
   insmod ehci-hcd.ko
   insmod ohci-hcd.ko
   如果要支持NTFS还要加载ufsd.ko   
   insmod ufsd.ko
2. 挂载U盘
   使用FAT32
   mount -t vfat /dev/sda /usb
   使用NTFS
   mount -t ufsd /dev/sda /usb   

=========================================
开机画面和瞬播
=========================================
请参考《开机画面 开发指南》

=========================================
HiLoader
=========================================
请参考《HiLoader 开发指南》

<<<  hi3716cdmo2b_hi3716cv200es1_android_cfg.mak : 缺头文件
???????《 -------  hi_wlan_sta.h: No such file or directory 》

<<< hi3716cv200estst2avera_android_cfg.mak  缺 reg 文件

make[1]: *** No rule to make target ....j/HiSTBLinuxV100R002C00SPC011/source/boot/sysreg/his40tst2a_hi3716cv200es0_ddr3_2gbyte_8bitx4_4layers_ECO2.reg',

<<<< his40tst2a_hi3716cv200es0_eco2_cfg.mak :   缺 reg 文件

make[1]: *** No rule to make target ...../HiSTBLinuxV100R002C00SPC011/source/boot/sysreg/his40tst2a_hi3716cv200es0_ddr3_2gbyte_8bitx4_4layers_ECO2.reg',