# TIH64Vx690_SDK_Linux_Developer

**Repository Path**: tihchip/tih64vx690_sdk_linux_developer

## Basic Information

- **Project Name**: TIH64Vx690_SDK_Linux_Developer
- **Description**: TIH64Vx690 Linux SDK形态之二。支持传统的基于make的Linux软件开发及构建方式。
- **Primary Language**: C
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2023-02-01
- **Last Updated**: 2025-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TIH64Vx690 Developer Package for Yocto使用指南

本项目基于 TIH64V690 系列开发板，提供开源嵌入式 Yocto Linux 交叉编译开发环境。本文档旨在帮助新手快速搭建开发环境并构建镜像，包括内核裁剪、驱动开发、U-Boot 定制、OpenSBI 构建及新根文件系统打包等功能。


## 功能概览

- Linux   内核驱动裁剪与构建
- U-Boot  引导程序定制
- OpenSBI 构建与集成
- 应用程序交叉编译
- 根文件系统打包
- 提供GCC交叉编译工具链

## 支持的开发板类型(MACHINE变量)
通过命令行传递**MACHINE**变量可指定开发板类型：

+ **t690mp-evb1-va**
+ **t690mp-evb1-vb**
+ **t690mp-evb2-va**
+ **t690mp-som1-va**


## 环境要求

建议使用 Ubuntu 18.04 或 20.04，并安装以下依赖：

```bash
sudo apt install git git-lfs fakeroot libssl-dev bison flex mtd-utils
```

---

## 仓库获取与构建流程

### 下载源码
TIH64Vx690 Developer Package 需要基于 TIH64Vx690 Image Package 中的根文件系统进行二次打包集成。打包根文件系统过程中，会以 Image Package 的根文件系统为模板，自动合并内核相关的修改，生成新的根文件系统。因此，需要先下载准备好 TIH64Vx690 Image Package，并组织好目录结构。

- ##### 目录结构
```bash
tih64vx690_sdk_linux/
├── Developer         # TIH64Vx690 Developer Package
│   ├── build_t690
│   ├── Makefile
│   ├── pkg
│   └── sdk
│       └── toolchain # GCC交叉编译工具链
├── ......
└── Image             # TIH64Vx690 Image Package
    ├── boot.scr.uimg
    ├── fw_jump-*.bin
    ├── linux-5.10
    │   ├── fitImage-its-*
    │   ├── fitImage-*.bin
    │   ├── tih-full-cli-image-*.rootfs.ext4.xz
    │   ├── tih-full-cli-image-*.rootfs.manifest
    │   ├── tih-full-cli-image-*.rootfs.tar.xz
    ├── mmc-boot.txt
    ├── README.md
    ├── u-boot-initial-env-*
    └── u-boot-*.bin
```
> **注**: `*` 表示不同开发板型号对应的文件，如 t690mp-evb1-va、t690mp-som1-va 等

- ##### 获取TIH64Vx690 Image Package for Yocto开发包
```bash
->$ cd tih64vx690_sdk_linux
->$ git clone -b master --recursive https://gitee.com/tihchip/tih64vx690_sdk_linux_image.git
->$ cd tih64vx690_sdk_linux_image/
```

- ##### 获取TIH64Vx690 Developer Package for Yocto开发包
```bash
->$ cd tih64vx690_sdk_linux
->$ git clone -b master --recursive https://gitee.com/tihchip/tih64vx690_sdk_linux_developer.git
->$ cd tih64vx690_sdk_linux_developer/
```

### 查看构建目标

```bash
->$ cd tih64vx690_sdk_linux/Developer
->$ make help
Here is a list of make targets supported

- uboot-menuconfig : run menuconfig for uboot
- linux-menuconfig : run menuconfig for linux kernel
- opensbi : build opensbi and generate opensbi binary
- uboot : build uboot and generate uboot binary
- linux : build linux and generate uImage.gz fitImage dtb binary
- rootfs : generate rootfs directory 
- rootfs-ext4 : generate ext4 format rootfs image
- rootfs-squashfs : generate squashfs format rootfs image
- rootfs-jffs2 : generate jffs2 format rootfs image
- rootfs-cpio-gz : generate cpio.gz.uboot format rootfs image
- all : generate All images for linux boot
- cleanall : clean this full workspace
- cleantoolchain : clean sdk linux toolchain workspace
- cleanrootfs : clean rootfs directory and rootfs.ext4
- cleanlinux : clean linux workspace
- cleanuboot : clean uboot workspace
- cleanopensbi : clean opensbi workspace

If you want to run linux on TIH64V690MP7_EVB_VER.A, please run 'make MACHINE=t690mp-evb1-va all' 
If you want to run linux on TIH64V690MP7_EVB_VER.B, please run 'make MACHINE=t690mp-evb1-vb all' 
If you want to run linux on TIH64V690MP6_EVB_VER.A, please run 'make MACHINE=t690mp-evb2-va all' 
If you want to run linux on SOM-T690MP7-xGyGD, please run 'make MACHINE=t690mp-som1-va all' 
......
```

### 构建开发板镜像
以开发板t690mp-evb1-va构建为例:
```bash
->$ make MACHINE=t690mp-evb1-va all
```

构建完成后，镜像文件位于：
```bash
Developer/build_t690/images/t690mp-evb1-va/
├── 5.10
│   ├── fitImage
│   ├── rootfs.ext4
│   ├── t690mp-evb1-va.dtb
│   └── uImage.gz
├── boot.scr.uimg
├── fw_jump.bin
└── u-boot.bin
```

---

### 模块构建与配置

- OpenSBI

  ```bash
  ->$ make opensbi
  ->$ make cleanopensbi
  ```

  - U-Boot

  配置：
  ```bash
  ->$ make uboot-menuconfig
  ```

  构建：
  ```bash
  ->$ make uboot
  ->$ make cleanuboot
  ```

- Linux

  配置：
  ```bash
  ->$ make linux-menuconfig
  ```

  构建：
  ```bash
  ->$ make linux
  ->$ make cleanlinux
  ```

- 根文件系统rootfs

  构建：
  ```bash
  ->$ make rootfs
  ->$ make rootfs-ext4
  ->$ make cleanrootfs
  ```

## 下载执行
 可参考Doc 目录下的 《[TIH64Vx690 SDK Quick Start](https://gitee.com/tihchip/doc/blob/master/TIH64V690%20SDK%20Quick%20Start.pdf)》 文档, 来完成上述固件镜像的下载运行。

## 参考资料

- [TIH64V690 Linux SDK用户指南](https://gitee.com/tihchip/doc/blob/master/Software/TIH64V690%20Linux%20SDK%E7%94%A8%E6%88%B7%E6%8C%87%E5%8D%97.pdf)
- [TIH64V690 SDK Quick Start](https://gitee.com/tihchip/doc/blob/master/TIH64V690%20SDK%20Quick%20Start.pdf)