# HiEuler_PI_Firmware_Building **Repository Path**: hieulerpi/HiEuler_PI_Firmware_Building ## Basic Information - **Project Name**: HiEuler_PI_Firmware_Building - **Description**: 海鸥派固件构建仓库。独立打包脚本解耦SDK编译链路，无需重复编译，直接提取uboot、kernel及文件系统即可快速生成固件，提升开发效率。 - **Primary Language**: Shell - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 1 - **Created**: 2025-10-27 - **Last Updated**: 2026-07-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HiEuler_PI_Firmware_Building #### 背景： ​ 为了方便开发，单独构建了打包脚本，抽离了SDK的编译过程，提取SDK编译生成的uboot、kernel以及文件系统，搭配打包脚本，提高开发效率。 #### 版本规格 | 项目 | 内容 | | :--- | :--- | | 适配 SDK 版本 | SS928V100_SDK_V2.0.2.2 | | 支持系统 | Linux / Ubuntu | | 系统内核 | Linux 4.19 | | 说明 | `Linux6.6` 仅保留测试参考，不属于本固件打包工程的完整支持项 | #### Ubuntu 文件系统说明 由于 Gitee 仓库不适合直接托管大文件，`Ubuntu` 文件系统需要单独下载。请前往 [网盘资料](https://gitee.com/hieulerpi/Docs/blob/master/%E7%99%BE%E5%BA%A6%E7%BD%91%E7%9B%98%E8%B5%84%E6%96%99%E8%AF%B4%E6%98%8E/README.md)，在以下路径获取固件打包工程相关文件： ```text 06. 开发板源码编译\06.固件打包工程 ``` 下载完成后，请将压缩包放置到以下目录： ```text HiEuler_PI_Firmware_Building/rootfs/Ubuntu/ ``` 例如下载 `Ubuntu20.04_rootfs.tar.gz`，放置后的完整路径应为： ```text HiEuler_PI_Firmware_Building/rootfs/Ubuntu/Ubuntu20.04_rootfs.tar.gz ``` #### 1. 登录账户和密码 适用于所有系统： | **帐户** | **密码** | |---------|---------| | root | ebaina | > **默认 IP 地址**：`192.168.1.168` #### 2. 使用说明 直接执行 `Generate_Image.sh` 即可查看脚本支持的功能。常用参数如下： | 参数 | 说明 | | :--- | :--- | | `-g` | 生成固件 | | `-r` | 删除中间文件和已生成镜像 | | `-c` | 删除中间文件 | | `-os ` | 指定系统类型，例如 `Linux`、`Ubuntu20.04`、`Ubuntu22.04` | | `-h` | 查看帮助信息 | 默认不带 `-os` 参数时生成 Linux 系统固件。 > 当前工程正式支持 Linux、Ubuntu20.04、Ubuntu22.04；`Linux6.6` 仅保留测试参考，不属于本固件打包工程的完整支持项。 ![打包脚本执行信息](./README.assets/打包脚本执行信息.png) 以打包 Linux6.6 测试参考固件为例： ![Linux6.6固件打包](./README.assets/Linux6.6固件打包示例.png) #### 3. 文件目录规划： ​ 目前4GB/8GB的区别仅uboot烧录文件以及env文件有区别，内核和文件系统直接通用。 ``` ├── bin ->用于存放PC端脚本运行所需要的程序 ├── boardtools ->板端所需要的命令工具 │   └── Linux ->根据系统区分命令工具 ├── Generate_Image.sh ->打包脚本 ├── kernel ->内核文件 │   └── Linux ->根据系统区分内核文件，内核文件同时兼容4GB/8GB │   └── uImage_ss928v100 ->内核文件 ├── opt ->用户程序 │   └── Linux ->根据系统区分用户程序 ├── out ->打包脚本输出的固件文件路径 ├── overlay ->覆盖文件系统的修改文件 │   └── Linux ->根据系统区分修改文件 ├── README.assets ->README文档关联图片目录 ├── README.md ->README文档 ├── rootfs ->文件系统源文件 │   └── Linux ->根据系统区分源文件 │   └── rootfs_glibc_arm64.tgz └── uboot ->uboot文件/uboot_env生成文件/logo文件/烧录分区表文件 ├── Linux │   ├── boot_image_4GB.bin │   ├── boot_image_8GB.bin │   ├── burn_table_4GB.xml │   ├── burn_table_8GB.xml │   ├── uboot_env_4GB.txt │   └── uboot_env_8GB.txt └── logo ->logo文件 └── logo.bin ``` #### 4. 系统功能支持情况： | **功能类别** | **功能项** | **Linux** | **Ubuntu** | |------------------|--------------------|:---------:|:----------:| | **系统工具** | 开机 logo | ✔️ | ✔️ | | | bsp 命令 | ✔️ | ✔️ | | | fw_printenv | ✔️ | ✔️ | | | haveged | ✔️ | ✔️ | | | mcu_tool | ✔️ | ✔️ | | | mkfs.ext2 | ✔️ | ✔️ | | | mkfs.ext3 | ✔️ | ✔️ | | | mkfs.ext4 | ✔️ | ✔️ | | | resize2fs | ✔️ | ✔️ | | **网络工具** | ssh | ✔️ | ✔️ | | | telnet | ✔️ | ✔️ | | | tftp | ✔️ | ✔️ | | | iperf3 | ✔️ | ✔️ | | | ip | ✔️ | ✔️ | | | udhcpc | ✔️ | ✔️ | | | udhcpd | ✔️ | ✔️ | | | ethtool | ✔️ | ✔️ | | **CAN工具** | cansend | ✔️ | ✔️ | | | candump | ✔️ | ✔️ | | **WIFI工具** | wpa_supplicant | ✔️ | ✔️ | | | hostapd | ✔️ | ✔️ | | **蓝牙工具** | dbus-daemon | ✔️ | ✔️ | | | bluetoothd | ✔️ | ✔️ | | | bluetoothctl | ✔️ | ✔️ | | **星闪工具** | sparklinkd | ✔️ | ✔️ | | | sparklinkctrl | ✔️ | ✔️ | #### 5. 外设支持情况： ![欧拉派接口图](./README.assets/欧拉派接口图.png) | **序号** | **功能项** | **Linux** | **Ubuntu** | |:--------:|---------------------------|:---------:|:----------:| | 1 | U盘 | ✔️ | ✔️ | | | UVC 摄像头 | ✔️ | ✔️ | | | USB 5G 模块 (MT5710-CN) | ✔️ | ✔️ | | 3 | 双路千兆 RJ45 | ✔️ | ✔️ | | 6 | OLED | ✔️ | ✔️ | | | PWM | ✔️ | ✔️ | | | ADC | ✔️ | ✔️ | | | MIPI 显示屏 | ✔️ | ✔️ | | 7 | MIPI 摄像头 | ✔️ | ✔️ | | 9 | CAN 总线 | ✔️ | ✔️ | | 10 | RS485 | ✔️ | ✔️ | | 12 | Wi-Fi 无线网络 | ✔️ | ✔️ | | | 蓝牙 | ✔️ | ✔️ | | | 星闪 | ✔️ | ✔️ | | 13 | 音频输入输出 | ✔️ | ✔️ | | 16 | HDMI 输出 | ✔️ | ✔️ | | 17 | PCIe 固态硬盘 | ✔️ | ✔️ | | | PCIe 5G 模块 (RM500U-CN) | ✔️ | ✔️ | | 19 | TF 卡 | ✔️ | ✔️ | | 其它 | RTC 实时时钟 | ✔️ | ✔️ | #### 6. 不同型号DDR说明 ##### 1). 实物差异图 **CXDB5CCAM-MK** (2-rank) 与 **CXDB5CBAM-MA-B** (1-rank) 差异 ![DDR差异](./README.assets/DDR差异.jpg) ##### 2). 固件差异 | 类型 | DDR 型号 | Rank | 内存 | U-Boot 文件 | 环境变量文件 | 烧录表 | | -- | -------------- | ------ | --- | ------------------------- | ------------------------ | ------------------------- | | ① | CXDB5CCAM-MK | 2 Rank | 4GB | `boot_image_4G.bin` | `uboot_env_4G.bin` | `burn_table_4G.xml` | | ② | CXDB5CCAM-MK | 2 Rank | 4GB x 2| `boot_image_8G.bin` | `uboot_env_8G.bin` | `burn_table_8G.xml` | | ③ | CXDB5CBAM-MA-B | 1 Rank | 4GB | `boot_image_4G_1rank.bin` | `uboot_env_4G_1rank.bin` | `burn_table_4G_1rank.xml` | | ④ | CXDB5CBAM-MA-B | 1 Rank | 4GB x 2 | `boot_image_8G_1rank.bin` | `uboot_env_8G_1rank.bin` | `burn_table_8G_1rank.xml` | #### 7. FAQ ##### 1). 如何新增系统/文件系统/应用程序 ​ boardtools：开源工具编译后的程序/命令或者SDK编译生成的工具，放到此目录。 ​ kernel：内核文件，需重命名为uImage_ss928v100。 ​ opt：主要为用户程序或者相关依赖文件，最终会拷贝到文件系统的/opt目录打包。 ​ overlay：主要用于覆盖文件系统的文件，一般为文件系统中修改过的同名文件，或者新增工具/命令依赖的配置文件。 ​ rootfs：对应系统的文件系统压缩包文件。 ​ uboot：uboot文件、uboot_env文件、烧录分区表文件。 ##### 2). 如何修改OS/MMZ内存 ​ 固件中目前已经支持从cmdline中解析内存信息用于分配OS和MMZ内存，在此基础上引入fw_printenv/fw_setenv命令，使得可以在系统中直接修改内存分配，注意修改内存分配时以M为单位，同时os_mem_size必须小于total_mem_size。 ​ fw_printenv可以在系统中查看uboot的环境变量。 ![查看内存分配](./README.assets/fw_printenv查看内存分配.png) ​ fw_setenv可以在系统中设置uboot的环境变量。以设置OS内存为例，执行fw_setenv设置os_mem_size大小，修改后重启板子即可按新的OS内存进行分配。 ![设置系统内存](./README.assets/fw_setenv设置系统内存.png) ##### 3). 如何解决MIPI屏幕首次无法出图 问题描述: HDMI开机画面下，MIPI 屏幕出图程序首次运行MIPI屏无法出图 解决方法: ①.关闭开机logo。 执行fw_setenv设置logo_show为no，修改后重启板子即可生效，开机logo将不再显示。 ![关闭开机logo](./README.assets/fw_setenv关闭开机logo.png) ②.开启MIPI屏配置前，先开启HDMI的VO配置再关闭。 ![mipi屏幕首次运行出图配置](./README.assets/mipi屏幕首次运行出图配置.png) ##### 4). 如何设置板卡IP ①. 关闭 `search_tool`，手动设置静态 IP Linux和Ubuntu均需要关闭`S89nettools`脚本权限。 ![关闭S89nettoos权限](./README.assets/关闭S89nettoos权限.png) Linux修改`S80network`脚本。 ![Linux静态ip设置](./README.assets/Linux静态ip设置.png) Ubuntu新增`/etc/systemd/network/20-static-eth0.network`。 ![Ubuntu静态ip设置](./README.assets/Ubuntu静态ip设置.png) ②. 使用 `search_tool`，指定并修改静态 IP Linux和Ubuntu均需要打开`S89nettools`脚本权限, Ubuntu还需要删除`/etc/systemd/network/20-static-eth0.network`；修改`search_tool`的配置文件(`/opt/cfg/dev_info.config`)。 ![配置文件设置静态ip](./README.assets/配置文件设置静态ip.png) ③. 使用 `search_tool`，启用动态 IP（DHCP 分配） Linux和Ubuntu均需要打开`S89nettools`脚本权限, Ubuntu还需要删除`/etc/systemd/network/20-static-eth0.network`；修改`search_tool`的配置文件(`/opt/cfg/dev_info.config`)。 ![配置文件启用动态ip](./README.assets/配置文件启用动态ip.png) 启用dhcp后重启查看配置文件。 ![dhcp重启后配置](./README.assets/dhcp重启后配置.png)