【linux项目】lichee nano linux烧写

目录

• 前言
• 参考：
• 安装交叉编译链
• 搭建 SPI FLASH 烧录环境
• 让芯片进入烧写模式
• sunxi 烧写命令
• u-boot 裁剪
  • 拉取 u-boot 源码
  • 配置 u-boot
  • 检查 flash 驱动
  • 编译、烧写 u-boot
• linux 裁剪
  • 获取 linux 源码
  • 配置 linux
  • 配置设备树
  • 编译、烧写 linux
• roofs 裁剪
  • 获取 buildroot 源码
  • 配置 buildroot
  • 编译、烧写 buildroot
• SPI FLASH 编译烧写
  • 根据自己的配置进行分区
  • 单个烧写
  • 打包成一个文件
• 小知识

---

前言

lichee_nano 主控芯片为全志 FC1001S。

本笔记暂时以 lichee nano 为例子，以后可能会直接适配各类 FC1001S 的板子。

注意：使用 lichee nano 板子和 lichee 提供的镜像时，需要注意这个板子的 flash 芯片型号，必要时需要修改驱动。

李柱明博客：https://www.cnblogs.com/lizhuming/p/15487208.html

参考：

• 荔枝派 nano 全流程指南
  • lichee 提供了很多脚本，可以拿出来参考。
• 荔枝派环境搭建

安装交叉编译链

arm-linux-gnueabi：

• 可以自己安装需要的版本。
• 也可以参考下面例子：
  • 该工具链存放位置自定义。
  • 其中环境变量生命周期参考：环境变量生命周期

# 此处为获取7.2.1版本，您可获取其他版本或者通过链接直接下载
wget http://releases.linaro.org/components/toolchain/binaries/7.2-2017.11/arm-linux-gnueabi/gcc-linaro-7.2.1-2017.11-x86_64_arm-linux-gnueabi.tar.xz

tar -vxJf gcc-linaro-7.2.1-2017.11-x86_64_arm-linux-gnueabi.tar.xz
sudo cp -r ./gcc-linaro-7.2.1-2017.11-x86_64_arm-linux-gnueabi /opt/

sudo vim /etc/bash.bashrc

# 在文件末尾 添加以下内容
PATH="$PATH:/opt/gcc-linaro-7.2.1-2017.11-x86_64_arm-linux-gnueabi/bin"
# 添加完毕

# 使路径生效
source /etc/bash.bashrc

安装好交叉编译链后可用命令 arm-linux-gnueabi-gcc -v 测试是否安装成功。注意自己的安装用户。

搭建 SPI FLASH 烧录环境

安装好编译根据链后还需要安装烧录固件工具。这里使用 sunxi-tools：

# 0. 如果无安装git 首先安装git
sudo apt-get install git

# 1. 拉取 sunxi-tools 这个库
git clone -b f1c100s-spiflash https://github.com/Icenowy/sunxi-tools.git

# 2.进行安装
cd sunxi-tools
make && sudo make install

# 3. 错误处理
# 3.1 如果出现 fatal error: libusb.h: No such file or directory 错误
sudo apt-get install libusb-1.0-0-dev
# 3.2 fel.c:32:18: fatal error: zlib.h: 没有那个文件或目录
sudo apt-get install  zlib-devel

# 4. 不出意外 现在已经安装成功, 可以使用这个软件进行烧写。常用的命令有如下几个
# 4.1 查看芯片是否开启了下载模式, 如果出现芯片信息既可以烧录
sudo sunxi-fel ver

# 4.2 烧录到 flash
sudo xunxi-fel -p spiflash-write [烧录的地址] [烧录的文件]

# 4.3 烧录到 内存中
sudo xunxi-fel -p write [烧录的内存地址] [烧录的文件]

让芯片进入烧写模式

为了让芯片能接收烧写固件，可让芯片进入 fel 模式。

• 原理：当 flash 中无 引导数据或者无法找到 flash 芯片时， 便自动进入 fel 模式。
• 有一下两种方法：
  1. 短接 flash 的 1、4 两脚，重新上电，让芯片找不到 flash，上电后松开短接，即可重新进入 fel 模式。
  2. 使用 U-boot 删除 flash 中的引导数据：

# 在 u-boot 中使用如下指令进行删除数据
# 1. 切换到 flash, 其中 0 为选择的flash，50000000 为速度。官方文档这里有错误。注意!
sf probe 0 50000000

# 2. 擦除flash, 为什么擦除这段地址，请查看spiflash编译章节
sf erase 0 0x10000

# 3. 重启
reset

# 4. 使用 sunxi-fel ver 即可找到芯片
sudo sunxi-fel ver
AWUSBFEX soc=00001663(F1C100s) 00000001 ver=0001 44 08 scratchpad=00007e00 00000000 00000000

sunxi 烧写命令

1. 确认是否进入 fel 模式命令：sudo sunxi-fel ver
2. 烧录命令：sudo sunxi-fel -p spiflash-write [烧录的地址] [烧录的文件]

u-boot 裁剪

拉取 u-boot 源码

# 1.  使用git 拉取 u-boot, 这里可以使用加速
git clone https://github.com/Lichee-Pi/u-boot.git

# 2. 查看分支，并切换到对应分支
git branch -a
git checkout nano-v2018.01

# 3. 进行配置
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- licheepi_nano_spiflash_defconfig

配置 u-boot

按需裁剪，一下为参考：

• 了解下下面的 bootcmd 参数。就是驱动内核前执行的命令。一般主要做数据拷贝&执行启动，如把设备树、kernel 拷贝到内存控制器 RAM 中。

# 1. 进行可视化配置, 进入配置页面
make ARCH=arm menuconfig

# 1.1 如何出现错误，安装如下的包
sudo apt-get install libncurses5-dev libncursesw5-dev

# 2. 如果使用LCD，修改LCD选项
ARM architecture
	Enable graphical uboot console on HDMI, LCD or VGA -> Y
	LCD panel timing details -> x:800,y:480,depth:18,pclk_khz:33000,le:87,ri:40,up:31,lo:13,hs:1,vs:1,sync:3,vmode:0
	# 如果为 480*272 屏幕
	x:480,y:272,depth:18,pclk_khz:10000,le:42,ri:8,up:11,lo:4,hs:1,vs:1,sync:3,vmode:0

	LCD panel backlight pwm pin -> PE6 # 具体看原理图

# 3. 修改 boot arguments ,传输到linux的参数
Enable boot arguments -> y
	Boot arguments ->  console=ttyS0,115200 panic=5 rootwait root=/dev/mtdblock3 rw rootfstype=jffs2

# 4. 修改bootcmd，启动linux命令。可以具体了解一下 bootcmd 代码的含义，其中拷贝数据启动linux
Enable a default value for bootcmd -y
	bootcmd -> sf probe 0 50000000; sf read 0x80c00000 0x100000 0x4000; sf read 0x80008000 0x110000 0x400000; bootz 0x80008000 - 0x80C00000

# 5. 保存退出

检查 flash 驱动

• 添加自己的 FLASH 芯片驱动。

# 1. 在代码编辑器中 打开 ./drivers/mtd/spi/spi_flash_ids.c

# 2. 在 170 行左右添加如下代码
{"xt25f128b",	   INFO(0x0b4018, 0x0,	64 * 1024,   256, RD_FULL | WR_QPP | SECT_4K) },

# 3. 保存退出

编译、烧写 u-boot

编译：

# 编译代码
make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- -j11

# 如果最后出现下面语句，编译成功
 BINMAN  u-boot-sunxi-with-spl.bin

# 错误处理,scripts/Makefile.build:425: recipe for target 'scripts/dtc/pylibfdt' failed
sudo  apt-get install swig python-dev python3-dev

编译成功的文件在 u-boot 目录下的，u-boot-sunxi-with-spl.bin 。 把他们烧写到内存或者 flash：

# 烧写到flash中
sudo sunxi-fel -p spiflash-write 0 u-boot-sunxi-with-spl.bin

# 烧写到 sram 中，在测试的时候使用(掉电不保护)
sudo sunxi-fel uboot u-boot-sunxi-with-spl.bin

验证：

# 测试 flash 是否成功，如果出现下面代码既成功
sf probe 0 50000000
SF: Detected xt25f128b with page size 256 Bytes, erase size 4 KiB, total 16 MiB

# 测试 读取
boot

linux 裁剪

获取 linux 源码

目前获取 uboot 和 linux 源码都是获取 lichee 或者全志官方推荐的。

# 1. 因为 linux太大了，建议只拉取单个分支. 可以使用加速
git clone --depth=1 -b f1c100s-480272lcd-test https://github.com/Icenowy/linux.git

# 2. 下载 .config 文件，放到源码的目录下，如果文件名称有变化。改为 .config

替换 .config 文件：.config

git 拉取有时速度很慢，建议做如下配置：

sudo vim /etc/hosts
# 添加下面两行
192.30.253.112  github.com
151.101.73.194 github.global.ssl.fastly.net
# 添加完成
# 可自行通过dns检测网站检测github.global.ssl.fastly.net，更换为更快的ip地址

配置 linux

# 1. 图形化配置
make ARCH=arm menuconfig

# 2. 配置 spiflash
Device Drivers
	SPI support
		Allwinner A10 SoCs SPI controller ->n # 不选择
		Allwinner A31 SPI Controller -> y

# 3. 配置 MTD
Device Drivers
	Memory Technology Device (MTD) support
		Command line partitioning table parsing -> y
		Caching block device access to MTD devices  -> y

# 4.添加 File systems
File systems
	Miscellaneous filesystems
		Journalling Flash File System v2 (JFFS2) support -> y
		# 下面全选

# 5. 保存退出

# 注意， 要把配置的选项选择为 * 而不是 M

配置设备树

• 添加 flash 驱动，需要查看板子使用的 flash 芯片：

  # 1. 打开 ./drivers/mtd/spi-nor/spi-nor.c 1186行. 添加如下代码. 对flash支持
  { "xt25f128b", INFO(0x0b4018, 0, 64 * 1024, 256, 0) },
  

• 配置设备树，若无显示器，则显示部分不用配置：

  # 1. 打开 /arch/arm/boot/dts/suniv-f1c100s-licheepi-nano.dts 文件
  # 2. 修改 显示驱动
  
  	panel: panel {
  		# 修改为 800*480 的屏幕
  		compatible = "lg,lb070wv8", "simple-panel";
  		#address-cells = <1>;
  		#size-cells = <0>;
  		enable-gpios = <&pio 4 6 GPIO_ACTIVE_HIGH>;
  
  		port@0 {
  			reg = <0>;
  			#address-cells = <1>;
  			#size-cells = <0>;
  
  			panel_input: endpoint@0 {
  				reg = <0>;
  				remote-endpoint = <&tcon0_out_lcd>;
  			};
  		};
  	};
  
  # 3. 添加对spiflash支持
  &spi0 {
      pinctrl-names = "default";
      pinctrl-0 = <&spi0_pins_a>;
      status = "okay";
      spi-max-frequency = <50000000>;
      flash: xt25f128b@0 {
          #address-cells = <1>;
          #size-cells = <1>;
          compatible = "winbond,xt25f128b", "jedec,spi-nor";
          reg = <0>;
          spi-max-frequency = <50000000>;
          partitions {
              compatible = "fixed-partitions";
              #address-cells = <1>;
              #size-cells = <1>;
  
              partition@0 {
                  label = "u-boot";
                  reg = <0x000000 0x100000>;
                  read-only;
              };
  
              partition@100000 {
                  label = "dtb";
                  reg = <0x100000 0x10000>;
                  read-only;
              };
  
              partition@110000 {
                  label = "kernel";
                  reg = <0x110000 0x400000>;
                  read-only;
              };
  
              partition@510000 {
                  label = "rootfs";
                  reg = <0x510000 0xAF0000>;
              };
          };
      };
  };
  
  

编译、烧写 linux

编译 linux：

• 镜像文件生成在 arch/arm/boot/zImage
• 设备树文件在 arch/arm/boot/dts/suniv-f1c100s-licheepi-nano.dtb
• 编译步骤：

  # 1. 编译
  make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- -j11
  
  # 错误处理 fatal error: openssl/bio.h:
  sudo apt-get install libssl-dev
  
  

单独编译设备树：

make ARCH=arm CROSS_COMPILE=arm-linux-gnueabi- dtbs -j11

烧写：

1. 进入 fel 模式。
2. 烧写固件：sudo sunxi-fel -p spiflash-write [烧录的地址] [烧录的文件]

roofs 裁剪

整理的 rootfs 使用 buildroot 。

获取 buildroot 源码

步骤：

1. 在 https://buildroot.org/download.html 可以下载到最新的代码包。
2. 解压这个代码包 tar -xzvf buildroot-2021.08.tar.gz1。

配置 buildroot

# 1. 打开图形化界面
make menuconfig

# 2. 选择处理器
Target options
	Target Architecture (ARM (little endian))
	Target Variant arm926t

# 3. 启动软链接等
System configuration
	Use syslinks to /usr ....  # 启动 链接
    Enable root login   		# root 登录
    Run a getty after boot 		# 输入密码
    remount root filesystem     # 重新挂载根文件系统到可读写

编译、烧写 buildroot

编译：

# 编译比较慢，可以配老婆/女朋友聊聊天。 如果编译不成功 make clean 重来
make

编译完成的根目录在 output/images/rootfs.tar . 复制出来解压：

# 复制出来
cp output/images/rootfs.tar ../
# 创建跟目录文件夹
mkdir rootfs
# 解压到这个文件夹
tar -xvf rootfs.tar -C rootfs/

# 安装 jffs2
sudo apt-get install mtd-utils

# 制作镜像， 得到 jffs2.img 可以烧录到开发板
mkfs.jffs2 -s 0x100 -e 0x10000 --pad=0xAF0000 -d rootfs/ -o jffs2.img

烧写：

1. 进入 fel 模式。
2. 烧写固件：sudo sunxi-fel -p spiflash-write [烧录的地址] [烧录的文件]

SPI FLASH 编译烧写

根据自己的配置进行分区

如：

分区序号	分区大小	分区作用	地址空间及分区名
mtd0	1MB (0x100000)	spl+uboot	0x0000000-0x0100000 : “uboot”
mtd1	64KB (0x10000)	dtb 文件	0x0100000-0x0110000 : “dtb”
mtd2	4MB (0x400000)	linux 内核	0x0110000-0x0510000 : “kernel”
mtd3	剩余 (0xAF0000)	根文件系统	0x0510000-0x1000000 : “rootfs”

单个烧写

• 把 u-boot 烧写到第一分区

  sudo sunxi-fel -p spiflash-write 0 u-boot-sunxi-with-spl.bin
  

• 把 dtb 文件烧写到第二分区

  sudo sunxi-fel -p spiflash-write 0x0100000 suniv-f1c100s-licheepi-nano.dtb
  

• 把 zImage 镜像文件烧写到第三分区

  sudo sunxi-fel -p spiflash-write 0x0110000 zImage
  

• 我们把 根文件系统 烧写到第四分区

  sudo sunxi-fel -p spiflash-write 0x0510000 jffs2.img
  

打包成一个文件

上面是一个一个固件烧写，我们可以通过脚本把其打包成一个固件进行烧写：

创建一个专门放固件的目录，如 my_bin。在该目录下按下面格式创建文件夹并存放对应固件：

1.  ls
   
    buildroot  linux  u-boot
   

2. 把下面脚本文件放到 my_bin 目录下，执行，output 为最后输出的文件。

   #! /bin/bash
   
   rm -rf ./output
   mkdir ./output
   rm -rf ./rootfs
   mkdir ./rootfs
   
   dd if=/dev/zero of=flashimg.bin bs=1M count=16 &&\
   dd if=./u-boot/u-boot-sunxi-with-spl.bin of=flashimg.bin bs=1K conv=notrunc &&\
   dd if=./linux/suniv-f1c100s-licheepi-nano.dtb of=flashimg.bin bs=1K seek=1024  conv=notrunc &&\
   dd if=./linux/zImage of=flashimg.bin bs=1K seek=1088  conv=notrunc &&\
   
   tar -xf ./buildroot/rootfs.tar -C ./rootfs &&\
   
   mkfs.jffs2 -s 0x100 -e 0x10000 --pad=0xAF0000 -d rootfs/ -o jffs2.img &&\
   
   dd if=jffs2.img of=flashimg.bin bs=1K seek=5184  conv=notrunc
   mv flashimg.bin ./output
   rm -rf jffs2.img
   

3. 执行命令烧录到开发板：

   sudo sunxi-fel -p spiflash-write 0 flashimg.bin
   

小知识

uboot sf 命令用法

uboot 中如果支持 spi/qspi flash, 那么可以使用 sf 的 erase, read, write 命令操作 spi flash。

• sf read 用来读取 flash 数据到内存。
• sf write 写内存数据到 flash。
• sf erase 擦除指定位置,指定长度的 flash 内容, 在进行写 flash 的时候一定要先进行擦除，否则会失败，因为 flash 只能从 1 变为 0。

具体参考：

sf - SPI flash sub-system

Usage:
sf probe [[bus:]cs] [hz] [mode] - init flash device on given SPI bus and chip select

sf read addr offset len - read `len' bytes starting at
                                  `offset' to memory at `addr'

sf write addr offset len        - write `len' bytes from memory
                                  at `addr' to flash at `offset'

sf erase offset [+]len          - erase `len' bytes from `offset'
                                  `+len' round up `len' to block size

sf update addr offset len       - erase and write `len' bytes from memory
                                  at `addr' to flash at `offset'

使用注意：

1. 在使用 sf 的其他命令之前必须先使用 sf probe 操作进行连接 flash。
   1. 如：sf probe 0 50000000，初始化总线 0 上的 FLASH，且速度为 50000000 Hz。

uboot bootz 参数

对于 ARM 来讲，可以透过 bootz <kernel_addr> <initrd_address> <dtb_address> 的命令来启动内核。

• 第一个参数为内核映像的地址。
• 第二个参数为 initrd 的地址，若不存在 initrd，可以用 - 代替。
• dtb_address 作为 bootz 或者 bootm 的最后一次参数。