# 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**: 1
- **Created**: 2023-02-01
- **Last Updated**: 2026-04-02

## 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
=============================================
        Developer SDK Build Help
=============================================

Configuration Targets:
  uboot-menuconfig    - Configure U-Boot interactively
  linux-menuconfig    - Configure Linux kernel interactively

Component Build Targets:
  opensbi            - Build OpenSBI firmware
  uboot              - Build U-Boot bootloader
  linux              - Build Linux kernel and device tree
  modules            - Build Linux kernel modules
  rootfs             - Prepare root filesystem directory

Filesystem Image Targets:
  rootfs-ext4        - Create ext4 rootfs image (recommended for eMMC/SD)
  rootfs-squashfs    - Create squashfs rootfs image (compressed read-only)
  rootfs-jffs2       - Create jffs2 rootfs image (for NOR flash)
  rootfs-cpio-gz     - Create compressed cpio rootfs image (for initramfs)

Complete Build Target:
  all                - Full build (opensbi + uboot + linux + rootfs)

Clean Targets:
  cleanall           - Remove entire build directory
  cleantoolchain     - Clean SDK toolchain files
  cleanrootfs        - Remove rootfs directory and images
  cleanlinux         - Clean Linux kernel build
  cleanuboot         - Clean U-Boot build
  cleanopensbi       - Clean OpenSBI build
  cleanmodules       - Clean Linux modules build

Build Options:
  v=1                - Enable verbose build output (show commands)

Supported Machine Targets:
  t690mp-evb1-va     - TIH64V690MP7_EVB_VER.A (Default)
  t690mp-evb1-vb     - TIH64V690MP7_EVB_VER.B
  t690mp-evb2-va     - TIH64V690MP6_EVB_VER.A
  t690mp-som1-va     - SOM-T690MP7-xGyGD

Examples:
  Standard build:       make MACHINE=t690mp-evb1-va all
  Verbose build:        make v=1 MACHINE=t690mp-evb1-va all
  Clean and rebuild:    make cleanall all
......
```

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

构建完成后，镜像文件位于：
```bash
Developer/build_t690/images/t690mp-evb1-va/
├── linux-5.10
│   ├── fitImage
│   ├── modules
│   ├── tih-full-cli-image-t690mp-evb1-va.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 modules
  ->$ 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)