环境搭建

1. 编译环境搭建¶

通常我们会以交叉编译的方式进行开发和调试，即“宿主机+目标机”的形式。而宿主机和目标机的连接我们一般采用串口连接或网络连接，如下图所示：

注：

1. 我们提供的debug tool作用除了可以debug外，还可以通过PC工具读寄存器和烧写空flash。

2. 如果是仅调试可以使用串口设备正确对接调试线序即可(con3)，线序请和原理图对齐。

3. 如果需要读Register或者烧录裸Flash的时候，需要Debug Tool。

4. tool根据需求量自行购买。点击购买。

2. 安装Linux Build Code服务器¶

推荐使用Ubuntu 16.04，该版本已进行验证，如果使用其他版本遇到环境问题将不予支持。

2.1. 安装ubuntu 16.04 server¶

1. 下载1604的server版；

2. 安装VMware Worksation；

3. 选择1604的iso，装载然后安装即可；

4. 简易安装直接点击完成，系统会自动进行安装；

5. 安装VMtools，用于拷贝将windows目录，共享到ubuntu，点击获取参考信息。

ubuntu至此安装成功，接下来安装开发需要的环境。

2.2. 添加新用户¶

1. 新装ubuntu，首先要设置root密码，进入系统设置root密码：# sudo passwd，连续输入密码即可，提示成功即可；

2. 添加用户，进入系统后重新创建用户，# sudo adduser xxx --force来创建用户，此时会提示输入account的一些信息，一直回车即可；

3. 此时账户已经建立，那么需要安装相关的工具以及编译环境，执行# sudo apt-get install libncurses5-dev libncursesw5-dev，这时候会提示当前用户无法执行sudoers，需要做如下修改：

   sudo chmod u+w /etc/sudoers
   
   vi /etc/sudoers；
   

   参考: root ALL=(ALL:ALL) ALL，

   添加一行: xxx ALL=(ALL:ALL) ALL

   sudo chmod u-w /etc/sudoers
   

再执行sudo操作即可安装了，建议在安装完后执行#sudo apt-get update来更新源。

2.3. 安装samba，用于共享linux文件到windows¶

# sudo apt-get install samba samba-common

# sudo smbpasswd -a xxx （添加samba账户，用于windows访问linuxsamba目录）

修改/etc/samba/smb.conf

[xxx]

path=/home/xxx

public=yes

writable=yes

valid users=xxx

available=yes

browseable=yes

guest ok = yes

这样samba已经配置好了，重启samba 服务即可，测试从windows访问samba：\\192.168.1.11 (your ubuntu ip)

2.4. 安装ssh，用于登陆调试¶

sudo apt-get install openssh-server；

安装结束即可使用。

2.5. 针对SDK编译需要安装一些tool，否则会编译失败¶

# sudo apt-get install libc6-dev-i386

# sudo apt-get install lib32z1 lib32ncurses5

# sudo apt-get install libuuid1:i386

# sudo apt-get install cmake

# sudo apt-get install libncurses5-dev libncursesw5-dev

# sudo apt install bc

# sudo apt-get install xz-utils

# sudo apt-get install automake

# sudo apt-get install libtool

# sudo apt-get install libevdev-dev

# sudo apt-get install pkg-config

如上这些需要安装的tool && lib是必须的，因为编译过程中会用到相关内容。这边就不一一说明是哪个错误，可以尝试先不安装编译来查看相关错误，为了省事，在编译之前一次性安装即可。

2.6. 如果默认sh不是bash，需要将sh改成bash¶

sudo rm /bin/sh

sudo ln –s /bin/bash /bin/sh

2.7. 安装toolchain¶

• 拷贝“gcc-sigmastar-9.1.0-2020.07-x86_64_arm-linux-gnueabihf.tar.xz”到/tools/toolchain/,目录自行定义。

• 解压toolchain

• 将toolchain设置到环境变量中去，省得每次需要手动export；

• 在/etc/profile添加：

  export PATH=/tools/toolchain/gcc-sigmastar-9.1.0-2020.07-x86_64_arm-linux-gnueabihf/bin/:$PATH
  

• uclibc 将arm-sigmastar-linux-uclibcgnueabihf-9.1.0.tar.gz解压后如上同样的方法配置即可。

• 配置完成后，可以按照如下方式确认gcc版本是否已经切换到9.1.0版本。

  

• 至此编译环境就已经全部搭建完成了，下面进行sdk的编译工作。

3. SDK开发包编译步骤¶

3.1. 代码获取¶

可从FTP获取对应的SDK开发包。

3.2. 编译boot¶

• spi-nor

  glibc:

  #declare -x ARCH="arm"或者采用export ARCH=arm  
  #declare -x CROSS_COMPILE="arm-linux-gnueabihf-"或者采用export CROSS_COMPILE=arm-linux-gnueabihf- 
  #make pioneer3_dualenv_defconfig（从V011版本开始默认打开ENV双备份和USB升级，是公版release的默认配置）或 make pioneer3_defconfig;
  #make clean;make
  

  编译完成后生成的image在:

  pioneer3_defconfig: boot/u-boot.xz.img.bin,把它替换到project/board/p3/boot/nor/uboot/u-boot.xz.img.bin，重新编译project即可；

  pioneer3_dualenv_defconfig: boot/u-boot.xz.img.bin,把它替换到project/board/p3/boot/nor/uboot/u-boot_dualenv.xz.img.bin，重新编译project即可；

• spi-nand

  glibc:

  #declare -x ARCH="arm"或者采用export ARCH=arm  
  #declare -x CROSS_COMPILE="arm-linux-gnueabihf-"或者采用export CROSS_COMPILE=arm-linux-gnueabihf- 
  #make pioneer3_dualenv_spinand_defconfig（从V011版本开始默认打开ENV双备份和USB升级，是公版release的默认配置）或 make pioneer3_spinand_defconfig;
  #make clean;make
  

  编译完成后生成的image在:

  pioneer3_spinand_defconfig: boot/u-boot_spinand.xz.img.bin,把它替换到project/board/p3/boot/spinand/uboot/u-boot_spinand.xz.img.bin，重新编译project即可；

  pioneer3_dualenv_spinand_defconfig: boot/u-boot_spinand.xz.img.bin,把它替换到project/board/p3/boot/spinand/uboot/u-boot_dualenv_spinand.xz.img.bin，重新编译project即可；

  Flash Type	Other	Defconfig
  SPI-NOR	基本	pioneer3_defconfig
  SPI-NAND	基本	pioneer3_spinand_defconfig
  SPI-NOR	在默认基础上添加ENV双备份机制	pioneer3_dualenv_defconfig
  SPI-NAND	在默认基础上添加ENV双备份机制	pioneer3_dualenv_spinand_defconfig

3.3. 编译kernel¶

编译alkaid会默认编译kernel, 和Takoyaki不同。因此建议修改相关kernel之后，直接在project下编译，会默认编译kernel的内容，并且不需要手动release到project下的路径。

#declare -x ARCH="arm"或者采用export ARCH=arm  
#declare -x CROSS_COMPILE="arm-linux-gnueabihf-"或者采用export CROSS_COMPILE=arm-linux-gnueabihf-

#make clean;make -j8

• 如果kernel 有新增kernel modules需要将相应的module添加到kernel_mod_list/kernel_mod_list_late（kernel_mod_list_late里的ko会在mi module之后装载）

• 修改路径：project/kbuild/customize/$(KERNEL_VERSION)/$(CHIP)/$(PRODUCT)/kernel_mod_list

3.4. 编译SDK¶

默认编译sdk时，会先build kernel，第一次编译通过make clean;make image -j8命令全部编译，后续如果不需要build kernel可以用make image-fast代替make image。

#declare -x ARCH="arm"或者采用export ARCH=arm

#declare -x CROSS_COMPILE="arm-linux-gnueabihf-"或者采用export CROSS_COMPILE=arm-linux-gnueabihf-

make clean; make image -j8

编译完成后生成的image在project/image/output/images

V011版本以上defconfig默认都切换到env双备份机制，包括两部分：1.uboot默认也要使用双备份config生成的bin。2.分区文件用的是双备份的配置

非双env备份版本和双env备份版本之间不能直接通过tftp升级，要从isp tool烧写boot开始，然后再通过tftp升级

4. demo板连接图¶

图4-1 SSD221 SSD210 SSC9211 demo板连接图

图4-2 SSD212 demo板连接图

图4-3 SSD222 demo板连接图

5. 烧录Image到板子¶

5.1. 烧录空flash(或uboot已跑不起来的板子)¶

空板烧录需要用isp tool连接烧录(此方法只供开发阶段使用，正式生产使用烧录器烧录母片的方式)，具体方法如下：

使用isptool连接前请务必先断开串口，不然isptool会连接失败！断开串口步骤如下：

• 在uboot console下面，直接输入debug，然后关闭串口终端；

• 在kernel 下面，直接输入11111，串口显示disable uart时，关闭串口终端即可。

  

关闭uart后，就可以按如下方法使用isptool烧录了：

5.1.1. 烧录SPI NOR Flash¶

新的flash架构，nor flash只需要烧写boot.bin，nand flash只需要烧写cis.bin和boot.bin，具体方法如下：

1. 打开isptool，选择spinor，然后点击connect，工具显示connected表示已连接成功。

   

2. 按如下红框的步骤，选择需要烧录boot.bin以及对应的flash地址(如下)，然后点击run即可，烧录完成后工具显示pass表示已烧录成功。

   Binary file	offset	Binary放置目录
   boot.bin	0x00000	${ALKAID}\project\image\output\images\boot.bin

   

5.1.2. 烧录SPI NAND Flash¶

新的flash架构，nor flash只需要烧写boot.bin，nand flash只需要烧写cis.bin和boot.bin，具体方法如下：

1. 打开isptool，选择spinor，然后点击connect，工具显示connected表示已连接成功。

   

2. 按如下红框的步骤，选择需要烧录cis.bin以及对应的flash地址(如下)，然后点击run即可，烧录完成后工具显示pass表示已烧录成功。

   Binary file	offset	Binary放置目录
   cis.bin	0x00000	${ALKAID}\project\image\output\images\cis.bin
   cis.bin	0x20000	${ALKAID}\project\image\output\images\cis.bin
   boot.bin	0x140000	${ALKAID}\project\image\output\images\boot.bin

   

3. 同样的步骤烧录第二次cis.bin（注意和第一次的地址不一样,并且Erase Device不勾选）和boot.bin（注意Erase Device不勾选） ,注意flash地址需要填对应分区的地址：

   

   

烧录完uboot后，可以关闭isptool然后重新连上串口，板子断电重启后就可以进入到uboot终端用tftp升级主程序了：

5.2. tftp网络烧录image¶

使用tftp网络烧录image的前提是板子里面已经带有uboot程序才行，如果没有uboot程序需要参考isptool烧录的方法先烧录uboot，然后再按如下方法tftp烧录：

1. 打开tftp工具指向image path：SDK\project\image\output\images\，并选择正确的网卡。

   

2. 板子连接网络，并确保板子跟PC处于同一个网段(PC需要关闭防火墙)

3. 板子开机，长按回车，进入uboot终端：

   

4. 首次烧录需要设置IP地址：

   #setenv gatewayip 192.168.1.1
   #setenv ipaddr 192.168.1.127       //设定FTP Client (EVB板子)使用的IP
   #setenv netmask 255.255.255.0
   #setenv serverip 192.168.1.100     //设定FTP server (PC) 的IP
   #saveenv
   

   注：

   1. 为了保证烧录顺利，请保证PC和开发板处于同一网段。

   2. 请采用静态方式固定分配ip。防止烧录时ip地址跳变。

   3. 您也可以使用独立网卡使PC端直连开发板，固定该网卡的内网ip地址，并按上述方法设定开发板。

   4. 在uboot终端使用如下命令进行烧录

      #estart
      
      #estar (OR: estar auto_update.txt，也可以指定auto_update.txt某一行烧录其中某一个分区)