Przeglądaj źródła

Linux_SDK_V0.9.5

thead_admin 1 rok temu
commit
5a0c6d55b0

+ 66 - 0
README.md

@@ -0,0 +1,66 @@
+# 概述
+本文介绍了如何使用 Linux Yocto 构建环境下载和编译 TH1520 Linux SDK。Linux SDK 包含了源码和二进制文件,支持用户开发 Linux 应用程序,并可以构建运行在 evt 开发板上的完整镜像。
+
+- SDK 代码仓库:[https://gitee.com/thead-yocto](https://gitee.com/thead-yocto)
+- SDK 代码仓库 tag:**Linux_SDK_V0.9.5**
+# 搭建编译环境
+Linux SDK 使用 Yocto 构建镜像。Yocto 编译环境使用 Ubuntu 18.04,推荐使用Linux + docker 的方式部署,也可以直接在 Ubuntu 系统搭建编译环境。
+具体搭建环境方法,请访问 [https://gitee.com/thead-yocto/documents](https://gitee.com/thead-yocto/documents) 仓库,查看文档《Yocto 用户手册》。
+# 下载
+下载 Yocto 构建包(不含 SDK 源码):
+```
+git clone https://gitee.com/thead-yocto/xuantie-yocto.git -b Linux_SDK_V0.9.5
+```
+
+下载开源软件包(仅在第一次获取 SDK 时下载):
+构建时会从网络下载开源软件包,下载的时间依不同的网络和网速而不同切差异很大;有些开源软件位于 GitHub 仓库,受限于国内网络环境会下载失败。为了加速这一过程,可以到 gitee 下载离线开源软件包:
+```
+git clone https://gitee.com/thead-yocto/yocto-downloads.git
+```
+
+加载目标设备的配置文件,加载环境变量:
+```
+cd xuantie-yocto
+source openembedded-core/oe-init-build-env build/light-fm
+```
+
+将前面下载的开源软件包通过共享 downloads 目录的方式软链接到 SDK 目录(假设 yocto-downloads 被下载到根目录下):
+```
+ln -s /yocto-downloads ../downloads
+```
+
+# 构建固件
+ 
+构建命令如下:
+```bash
+MACHINE=light-a-public-release bitbake light-fm-image-linux
+```
+
+关于 SDK 构建的更多详细信息,请参考:《Linux SDK 用户手册》
+# 手动清除 data 分区
+当前版本引入了 root 分区和 data 分区的 overlay 机制 -- 如果 root 分区和 data 分区有重名文件,系统会优先选择 data 分区文件。
+为了避免 data 分区影响,fastboot 烧录后,在 u-boot 模式下,请使用以下命令手动清除 data 分区:
+```c
+part start mmc 0 data start_blk
+part size mmc 0 data size_blk
+mmc erase ${start_blk} ${size_blk}
+```
+# deb 包安装
+默认工具类应用不会编译进镜像,以 deb 包的形式提供。deb 包会生成在编译后的镜像目录:build/light-fm/tmp-glibc/deploy/deb。
+
+安装 deb 包时,需要先将 deb 包拷贝(通过 adb 或者网络方式)到板子上,然后使用如下命令:
+```c
+dpkg -i "package_name"
+```
+如果该包依赖其他包,请根据提示依次安装。
+
+# 其他
+**light_deploy_images 仓库:**
+
+- 包含已经构建好的 Linux Image,以及其他相关工具,可以打开仓库后直接下载使用
+- 仓库地址:[https://gitee.com/thead-yocto/light_deploy_images](https://gitee.com/thead-yocto/light_deploy_images)
+
+**documents 仓库:**
+
+- 包含所有发布文档
+- 仓库地址:[https://gitee.com/thead-yocto/documents](https://gitee.com/thead-yocto/documents)

+ 92 - 0
README_en.md

@@ -0,0 +1,92 @@
+# 1 Overview
+
+This article describes how to download and compile the TH1520 Linux SDK using the Linux Yocto build environment. The Linux SDK contains source code and binary files, which support users to develop Linux applications and build a complete image running on the evt development board.
+
+- SDK code repository: https://gitee.com/thead-yocto
+- SDK code repository tag: ***\*Linux_SDK_V0.9.5\****
+
+# 2 Build the Compilation Environment
+
+The Linux SDK uses Yocto to build images. The Yocto compilation environment uses Ubuntu 18.04. It is recommended to use Linux + docker for deployment. You can also build a compilation environment directly on the Ubuntu system. For the specific method of setting up the environment, please visit the repository at https://gitee.com/thead-yocto/documents and view the document "Yocto User Guide".
+
+# 3 Download
+
+1. Download the Yocto buildpack (without SDK source code):
+
+   ```
+   git clone https://gitee.com/thead-yocto/xuantie-yocto.git -b Linux_SDK_V0.9.5
+   ```
+
+
+
+2. Download open source software packages (only download when you get the SDK for the first time): 
+
+   Open source software packages are downloaded from the network when building. The download time varies greatly depending on different networks and network speeds. Some open source software is located in GitHub repositories, and download may fail due to the domestic network environment. To speed up the process, you can go to gitee to download offline open source packages:
+
+   ```
+   git clone https://gitee.com/thead-yocto/yocto-downloads.git
+   ```
+
+   
+
+3. Load the configuration file of the target device and load the environment variables:
+
+   ```
+   cd xuantie-yocto
+   
+   source openembedded-core/oe-init-build-env build/light-fm
+   ```
+
+   
+
+4. Soft link the open source packages downloaded earlier to the SDK directory by sharing the downloads directory (assuming yocto-downloads is downloaded to the root directory):
+
+   ```
+   ln -s /yocto-downloads ../downloads
+   ```
+
+# 4 Build the Firmware
+
+The build command is as follows:
+
+```
+MACHINE=light-a-public-release bitbake light-fm-image-linux
+```
+
+For more details on SDK build, please refer to "Linux SDK User Guide".
+
+# 5 Manually Clear the Data Partition
+
+The current version introduces the overlay mechanism of the root partition and the data partition -- if the root partition and the data partition have files with the same name, the system preferentially selects the file in data partition. In order to avoid the influence of the data partition, please use the following command to manually clear the data partition in u-boot mode after fastboot is burned:
+
+```
+part start mmc 0 data start_blk
+part size mmc 0 data size_blk
+mmc erase ${start_blk} ${size_blk}
+```
+
+# 6 deb Package Installation
+
+The default utility application is not compiled into the image and is provided as a deb package. The deb package will be generated in the compiled image directory: build/light-fm/tmp-glibc/deploy/deb.
+
+When installing the deb package, you need to first copy the deb package (through adb or network) to the board, and then use the following command:
+
+```
+dpkg -i "package_name"
+```
+
+If the package depends on other packages, please install them in sequence according to the prompts.
+
+# 7 Other
+
+***light_deploy_images repository:***
+
+- Contains the built Linux Image and other related tools, which can be downloaded and used directly after opening the repository
+- Repository address: https://gitee.com/thead-yocto/light_deploy_images
+
+***Documents repository:***
+
+- Contains all published documentation
+- Repository address: https://gitee.com/thead-yocto/documents
+
+ 

BIN
en/user_guide/T-Head Yeying1520 EVB Image Burning User Guide.pdf


BIN
en/user_guide/T-Head Yeying1520 Yocto User Guide.pdf


BIN
zh/release_notes/Linux_SDK_V0.9.5_Release_Notes.pdf


BIN
zh/user_guide/T-Head 曳影1520验证板镜像烧写用户指南.pdf


BIN
zh/user_guide/T-Head曳影1520Yocto用户指南.pdf