Debian Trixie Image for PineNote项目的使用说明

1. 项目目录结构及介绍

Debian Trixie Image for PineNote项目是一个为PineNote电子纸平板电脑构建Debian操作系统的映像的项目。该项目包含了构建映像所需的全部脚本和配置文件。以下是项目的目录结构及其简要介绍：

PNDeb/pinenote-debian-image/
├── .github/              # GitHub工作流配置目录
│   └── workflows/        # 工作流脚本
├── overlays/             #内核覆盖文件
├── partition_tables/     #硬盘分区表配置
├── scripts/              #项目构建和安装脚本
├── uboot_env/            #u-boot环境变量配置
├── videos/               #展示项目功能的视频文件
├── .gitignore            #Git忽略文件
├── 01_rootminfs.yaml      #构建root文件系统的recipe文件
├── 02_waveforms.yaml      #构建waveform数据的recipe文件
├── 03_basic_system.yaml   #构建基本系统的recipe文件
├── 04_fix_root_partition.yaml #修复root分区的recipe文件
├── 05_baseprograms.yaml   #安装基础程序的recipe文件
├── 06_finalsetup.yaml     #完成系统设置的recipe文件
├── 07_gnome.yaml          #安装GNOME桌面环境的recipe文件
├── 08_custom_debs.yaml    #安装自定义deb包的recipe文件
├── 11_adduser.yaml        #添加用户的recipe文件
├── 12_create_disc_image.yaml #创建磁盘映像的recipe文件
├── 13_extract_partition_image.yaml #提取分区映像的recipe文件
├── LICENSE               #项目许可证文件
├── README.md             #项目自述文件
├── adjust-root-in-image.sh #调整映像中root分区路径的脚本
├── build.sh              #构建映像的主脚本
├── build_locally.sh      #本地构建映像的脚本
├── check_debian_packages_bookworm.sh #检查Debian包的脚本
├── flashing_rkdeveloptools.md #使用rkdeveloptools刷机的文档
├── gen_packed_image.sh   #生成压缩映像的脚本
├── prep_00_get_kernel_files.sh #获取内核文件的准备脚本
├── prep_03_custom_debs.sh #准备自定义deb包的脚本
├── prep_05_get_external_files.sh #获取外部文件的准备脚本
└── sync_to_pinenote.sh   #同步文件到PineNote的脚本

2. 项目的启动文件介绍

项目的启动文件是build.sh脚本。这个脚本负责调用debos工具来构建Debian映像。debos是一个用于构建Linux发行版映像的工具，它通过读取一系列的recipe文件来确定映像的内容和行为。

# build.sh 脚本的主要功能
# 1. 设置环境变量
# 2. 调用debos构建映像
# 3. 打包生成的映像文件

在执行build.sh之前，通常需要运行一些预处理脚本，如prep_00_get_kernel_files.sh来获取所需的内核文件，prep_03_custom_debs.sh来准备自定义的deb包，以及prep_05_get_external_files.sh来获取项目需要的外部文件。

3. 项目的配置文件介绍

项目的配置文件主要是*.yaml文件，这些文件是debos的recipe文件，定义了构建映像的步骤。以下是一些重要的配置文件及其用途：

• 01_rootminfs.yaml：定义了构建基础root文件系统所需的步骤。
• 02_waveforms.yaml：定义了提取和安装waveform数据的步骤，这对驱动电子纸显示至关重要。
• 03_basic_system.yaml：定义了安装基本系统组件的步骤。
• 07_gnome.yaml：定义了安装GNOME桌面环境的步骤。

此外，项目还包含了一些用于配置u-boot环境变量的文件，如uboot_env/目录下的文件，它们用于设置和控制u-boot的行为，包括引导菜单和启动参数。