一键烧录及脚本使用说明

2022-10-10

编辑本页

材料准备：

内存卡+读卡器+荔枝派Nano+支持完整指令集的x86设备一台（电脑）

镜像下载地址：

https://pan.baidu.com/s/1smzuGS9

一键烧录镜像命名规则

xx_xxx_xxxx.*

xx:适用此镜像的pi的名称

xxx:这个镜像是下载到什么介质上

xxxx:这个镜像适用于什么分辨率的LCD上

*:bin一般是下载到flash上的，dd代表这个镜像使用dd打包。

一键烧录镜像(Linux环境---TF卡启动)

镜像包中的image文件夹下的dd文件，已包含了相应的Bootloader、Kernel、文件系统等等，只需简单两步即可完成烧录；

插上tf卡后，命令行执行 sudo fdisk -l 查看tf卡盘号；
执行 sudo dd if=/path/to/your-dd-image of=/your/tf-card && sync 即可完成烧录

我们所提供的dd一键镜像包为兼容低存储的tf卡，仅为根文件系统留下有限的空间，若您需要存储某些大文件，请参阅后文脚本使用

一键烧录镜像(Linux环境---16M spi-flash 启动)

在flash内容为空的情况下（fel模式下的一种情况）进行烧录时，通过micro-usb数据线将Nano与电脑连接，执行

sudo sunxi-fel -p spiflash-write 0 Your-Flash-BIN

若flash中已有系统，可通过：

短接flash的 1、4 两脚，然后重新上电，上电后松开短接，即可重新进入fel模式，进行再次下载
在启动到内核前，回车进入uboot，执行 sf probe 0;sf erase 0 0x100000;reset即可重新进入fel模式

一键烧录镜像(win环境---TF卡启动)

使用软件 win32disk 进行一键烧录，可到此处下载;

脚本的使用

镜像包内build文件夹下脚本，可通过使用配置脚本设置环境变量，帮助您进行固件烧写img构建

变量配置一次摸清

此处请注意两个脚本文件： configs 文件夹下的脚本文件（固件配置）和本目录下的 env.sh（公共环境配置）

首先来看 env.sh:

根据提示，前5个变量需要我们进行修改，分别是：

_TOP_DIR --- 镜像包所在的一级目录
_KERNEL_MAINDIR --- 主线Linux源码所在目录
_UBOOT_DEVDIR --- Uboot源码所在目录
_BR_DEVDIR --- Buildroot所在目录
_CP_CMD --- 复制命令(默认为docker拉取)

再来看configs文件夹下的脚本文件： env-xxxxx.sh

默认加载 env.sh 中的行动
_SCREEN_PRAM --- 选择屏幕大小版本（通过注释切换）（目前仅提供了480x272与800x480两种）
_CASE_NAME --- 各类文件的前缀名
_BOOT_DEV --- 默认启动设备
_KERNEL_TYPE --- 内核类型（主线或bsp）
_KERNEL_VER --- 内核版本号（menuconfig可见）
_DT_NAME --- 设备树名称
_ROOTFS_TYPE --- 自我定义
_IMG_SIZE --- 生成的镜像大小（越大，根文件系统剩余空间越多）
_UBOOT_SIZE --- 导入的Uboot大小
_CFG_SIZEKB --- config文件大小（其值大小、是否为0与内核版本有关）
_P1_SIZE --- 给第一分区划分的大小（以 M 为单位）

note:

您若仅需烧写，修改好公共环境变量，固件配置可保持不变；
您若需要编写自己的配置文件，请通过修改上述变量进行适配；

正确使用姿势

执行以下命令

cd configs
source env-xxxxx.sh   # 生效环境变量
cd ..                       # 返回上级目录

使用 write_all.sh /dev/sdX (sdX修改为tf设备号)，一键对tf卡进行全套写入。
若使用的是从 spi-flash 启动，则 write_spiflash.sh 即可将镜像写入16M flash
生成镜像时使用 pack_tf_img.sh 生成tf镜像文件,pack_flash_img.sh 生成spi-flash镜像文件。

分区操作脚本

write_all.sh --- 为tf卡创建全套内容
write_flash.sh --- 为spi-flash写入全套内容
write_dd.sh --- 以dd镜像的方式写入全套内容（规定了分区信息）（生成方式见下一节）
write_boot.sh --- 向tf卡dd进Uboot
write_mkfs.sh --- 单纯的为两个分区进行硬盘格式化
write_p1.sh --- 单纯的向第一分区写入设备树内核等
write_p2.sh --- 单纯的向第二分区写入rootfs
clear_partion.sh --- 擦除分区表
write_partion.sh --- 写入分区表
write_swap.sh --- 增加swap

镜像生成脚本

镜像生成最简单的方法是借助tf卡，手动或使用脚本向tf写入完结构，再dd出来，但手动生成较为琐碎且不灵活，所以我们在这里提供了脚本文件： pack_tf_img.sh 和 pack_flash_img.sh，能够判断镜像大小是否符合启动要求，且借助loop模拟创建设备，快速高效。

使用方法： sh pack_tf_img.sh 或 sh pack_flash_img.sh 即可生成的镜像在 ./image 目录下；

docker环境下拉取资源到本地

当您在docker环境下已经成功构建相应的系统各组件，以下脚本可以帮助到您：

pull_uboot.sh —— 从docker环境中拉取UBOOT到原生环境
pull_kernel.sh —— 从docker环境中拉取(主线)Kernel与构建好的驱动模块到原生环境
pull_br.sh —— 从docker环境中拉取rootfs与配置文件到原生环境

交流与答疑
对于本节内容，如有疑问，欢迎到社区提问或分享经验。

总述

docker快速搭建环境

wiki