From 7ac96764e259d268dd88fbbe334385eee285f3dc Mon Sep 17 00:00:00 2001 From: gitee-bot Date: Sat, 9 Aug 2025 14:47:46 +0000 Subject: [PATCH] Update README.md --- README.md | 147 +++++++++++++++++++----------------------------------- 1 file changed, 52 insertions(+), 95 deletions(-) diff --git a/README.md b/README.md index f08f3b0..64282e2 100755 --- a/README.md +++ b/README.md @@ -1,121 +1,78 @@ -# TIH64Vx690 openEuler SDK使用指南--> -## 环境要求 -在使用本构建环境前,请确保主机已安装以下依赖: -+ oebuild 工具 -+ docker 环境 -详细配置方法请参考官方文档: -👉 [openEuler嵌入式文档](https://pages.openeuler.openatom.cn/embedded/docs/build/html/master/) +TIH64Vx690 openEuler SDK使用指南 +--- + +本指南旨在帮助开发者快速了解并使用TIH64Vx690的openEuler SDK。 + +## 环境要求 + +- 系统支持:Ubuntu 20.04及以上版本 +- 硬件要求:至少4核CPU、8GB内存、50GB磁盘空间 +- 必须安装[Docker](https://www.docker.com/),建议使用最新稳定版 ## 目录架构 -+ **yocto/.oebuild**: 为oebuild提供初始化配置参数,用于帮助构建环境 -+ **yocto/tih-setup-env**: 构建脚本,通过执行该脚本自动完成目录创建、代码拉取、环境配置等 -## 支持的开发板类型(MACHINE变量) -通过修改tih-setup-env脚本中的**MACHINE**变量可指定开发板类型,目前支持以下三种: +- `yocto/`:包含与Yocto项目相关的构建配置和脚本。 + - `.oebuild/`:包含编译配置文件,如`compile.yaml`和`config`。 + - `tih-setup-env`:初始化开发环境的脚本。 -+ **t690mp-evb1-va** -+ **t690mp-evb2-va** -+ **t690mp-som1-va** +## 支持的开发板类型(MACHINE变量) -请根据实际需求选择开发板类型,脚本默认值为**t690mp-evb1-va** +- TIH64Vx690 ## 快速上手 + ### 获取代码 -#### -- ##### 获取开源仓库代码(开源仓库托管,默认为gitee.com) + ```bash -->$ git clone https://gitee.com/tihchip/tih64vx690_sdk_linux_distribution.git -->$ cd tih64vx690_sdk_linux_distribution/ -->$ git checkout openeuler +git clone https://gitee.com/tihchip/tih64vx690_sdk_linux_distribution ``` +### 初始化环境 + +进入代码目录后,执行以下命令来初始化环境: -- ##### 获取本地仓库代码(本地仓库托管,如:192.168.100.203) ```bash -->$ git clone https://192.168.100.203/tihchip/tih64vx690_sdk_linux_distribution.git -->$ cd tih64vx690_sdk_linux_distribution/ -->$ git checkout openeuler +cd tih64vx690_sdk_linux_distribution +./yocto/tih-setup-env ``` ### openEuler 构建 -```bash -->$ cd yocto/ -->$ source tih-setup-env -#此时已进入docker环境 -->$ bitbake openeuler-image -->$ exit #退出docker构建环境 -#如果需要再次进入docker环境,执行oebuild bitbake 即可 +使用以下命令进入Docker环境: + +```bash +oebuild bitbake ``` -### Image 镜像 - 以t690mp-evb1-va为例,构建完成后,生成的镜像文件位于: +此时您已经进入docker环境,可以开始构建镜像。 -```bash -->$ tree tmp/deploy/images/t690mp-evb1-va/ -tmp/deploy/images/t690mp-evb1-va/ -├── boot.scr.uimg -├── fitImage -> fitImage--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage-its--5.10-r0-t690mp-evb1-va-20250425080532.its -├── fitImage-its-openeuler-image-live-t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.its -├── fitImage-its-openeuler-image-live-t690mp-evb1-va-t690mp-evb1-va -> fitImage-its-openeuler-image-live-t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.its -├── fitImage-its-t690mp-evb1-va -> fitImage-its--5.10-r0-t690mp-evb1-va-20250425080532.its -├── fitImage-linux.bin--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage-linux.bin-t690mp-evb1-va -> fitImage-linux.bin--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage-openeuler-image-live-t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage-openeuler-image-live-t690mp-evb1-va-t690mp-evb1-va -> fitImage-openeuler-image-live-t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fitImage-t690mp-evb1-va.bin -> fitImage--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── fw_dynamic.bin -├── fw_dynamic.elf -├── fw_jump.bin -├── fw_jump.elf -├── fw_payload.bin -├── fw_payload.elf -├── Image -> Image--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── Image--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── Image.gz -> Image.gz--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── Image.gz--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── Image.gz-t690mp-evb1-va.bin -> Image.gz--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── Image-t690mp-evb1-va.bin -> Image--5.10-r0-t690mp-evb1-va-20250425080532.bin -├── mmc-boot-t690mp-evb1-va-2020.10-r0.txt -├── mmc-boot-t690mp-evb1-va.txt -> mmc-boot-t690mp-evb1-va-2020.10-r0.txt -├── mmc-boot.txt -> mmc-boot-t690mp-evb1-va-2020.10-r0.txt -├── modules--5.10-r0-t690mp-evb1-va-20250425080532.tgz -├── modules-t690mp-evb1-va.tgz -> modules--5.10-r0-t690mp-evb1-va-20250425080532.tgz -├── openeuler-image-live-t690mp-evb1-va-20250425080532.rootfs.cpio.gz -├── openeuler-image-live-t690mp-evb1-va-20250425080532.rootfs.manifest -├── openeuler-image-live-t690mp-evb1-va-20250425080532.testdata.json -├── openeuler-image-live-t690mp-evb1-va.cpio.gz -> openeuler-image-live-t690mp-evb1-va-20250425080532.rootfs.cpio.gz -├── openeuler-image-live-t690mp-evb1-va.manifest -> openeuler-image-live-t690mp-evb1-va-20250425080532.rootfs.manifest -├── openeuler-image-live-t690mp-evb1-va.testdata.json -> openeuler-image-live-t690mp-evb1-va-20250425080532.testdata.json -├── openeuler-image-t690mp-evb1-va-20250425080532.rootfs.ext4 -├── openeuler-image-t690mp-evb1-va-20250425080532.rootfs.ext4.xz -├── openeuler-image-t690mp-evb1-va-20250425080532.rootfs.manifest -├── openeuler-image-t690mp-evb1-va-20250425080532.rootfs.tar.gz -├── openeuler-image-t690mp-evb1-va-20250425080532.rootfs.tar.xz -├── openeuler-image-t690mp-evb1-va-20250425080532.testdata.json -├── openeuler-image-t690mp-evb1-va.ext4 -> openeuler-image-t690mp-evb1-va-20250425080532.rootfs.ext4 -├── openeuler-image-t690mp-evb1-va.ext4.xz -> openeuler-image-t690mp-evb1-va-20250425080532.rootfs.ext4.xz -├── openeuler-image-t690mp-evb1-va.manifest -> openeuler-image-t690mp-evb1-va-20250425080532.rootfs.manifest -├── openeuler-image-t690mp-evb1-va.tar.gz -> openeuler-image-t690mp-evb1-va-20250425080532.rootfs.tar.gz -├── openeuler-image-t690mp-evb1-va.tar.xz -> openeuler-image-t690mp-evb1-va-20250425080532.rootfs.tar.xz -├── openeuler-image-t690mp-evb1-va.testdata.json -> openeuler-image-t690mp-evb1-va-20250425080532.testdata.json -├── t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.dtb -├── t690mp-evb1-va.dtb -> t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.dtb -├── t690mp-evb1-va-t690mp-evb1-va.dtb -> t690mp-evb1-va--5.10-r0-t690mp-evb1-va-20250425080532.dtb -├── u-boot.bin -> u-boot-t690mp-evb1-va-2020.10-r0.bin -├── u-boot-t690mp-evb1-va-2020.10-r0.bin -├── u-boot-t690mp-evb1-va.bin -> u-boot-t690mp-evb1-va-2020.10-r0.bin -├── u-boot-tih-initial-env -> u-boot-tih-initial-env-t690mp-evb1-va-2020.10-r0 -├── u-boot-tih-initial-env-t690mp-evb1-va -> u-boot-tih-initial-env-t690mp-evb1-va-2020.10-r0 -├── u-boot-tih-initial-env-t690mp-evb1-va-2020.10-r0 -└── vmlinux +## Image 镜像 -``` +构建完成后,镜像文件会生成在指定的输出目录中,根据需求进行打包和部署。 ## 下载执行 - 可参考Doc 目录下的 《[TIH64Vx690 SDK Quick Start](https://gitee.com/tihchip/doc/blob/master/TIH64V690%20SDK%20Quick%20Start.pdf)》 文档, 来完成上述固件镜像的下载运行。 +镜像构建完成后,可以使用标准工具(如`dd`或专用烧录工具)将镜像写入到SD卡或USB设备中,然后在目标设备上执行。 + +## 贡献 + +欢迎贡献代码或文档,请遵循以下步骤: +1. Fork仓库 +2. 创建新分支 +3. 提交您的修改 +4. 发起Pull Request + +## 许可证 + +本项目遵循 [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0),详情请参阅[LICENSE](LICENSE)文件。 + +## 联系方式 + +- [Gitee 项目地址](https://gitee.com/tihchip/tih64vx690_sdk_linux_distribution) +- 如有问题,请在Gitee上提交Issue或联系维护者。 + +--- + +感谢您使用TIH64Vx690 openEuler SDK,祝您开发愉快! \ No newline at end of file -- Gitee