# lib-tnfdt

**Repository Path**: tenonos/lib-tnfdt

## Basic Information

- **Project Name**: lib-tnfdt
- **Description**: 本仓库存放TenonOS社区维护的设备树文件和相关工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-11-05
- **Last Updated**: 2025-02-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tnfdt

## 提供能力：

- 维护支持板卡通用的设备树信息

- 支持对维护的通用信息，根据不同需求进行增量修改（overlay）


## 目录结构

```
tnfdt
├── board                    //按照架构维护board层级设备树信息
├── dts                      //按照架构维护soc层级设备树信息
│   └── arm64 
│       ├── qemu
│       └── rockchip
├── include                  //存放设备通用的信息宏定义
│   └── dt_bindings
│       └── intc
├── script
|   └── generat_dts.sh      //生成完整设备树工具
├── Config.uk               //kconfig配置对应的板卡
├── Makefile.uk
└── README.md
```

## 使用方式：

### 1.配置板卡信息

#### a.配置已支持板卡

```
make menuconfig
Location:                                                                                                                                                                                                                              ->LibraryConfiguration 
        -> tnfdt: Supports dynamic and static use of device tree
                -> LIBTNFDT_BOARDS   //选择所需的板卡
```

#### b.配置外部扩展板卡

  1)使用设备树文件为dts格式，配置设备树文件路径即可

```
export TNFDT_EXTEND_BOARD_DTS_FILE=/path/to/dts.dts
```
  2)使用设备树文件为dtsi格式，除配置设备树文件路径外，还需按照其包函的逻辑关系，配置依赖的其他文件目录
        /* 注：支持使用“ ：”分隔指定多个路径 export TNFDT_EXTEND_BOARD_DTS_SOURCE=/path/to/source1:/path/to/source2*/

```
export TNFDT_EXTEND_BOARD_DTS_FILE=/path/to/dts.dtsi
export TNFDT_EXTEND_BOARD_DTS_SOURCE=/path/to/source
```

### 2.配置增量修改内容

- 可以通过kconfig和配置环境变量的两种方法配置overlay的信息（如果两种方式同时配置时kconfig配置的overlay生效）

- 配置app路径下存放的app.overlay配置的修改信息自动加入到汇总的overlay的信息中（无需手动配置）

#### KCONFIG

```
make menuconfig

Location:                                                                                                                                                                                                                                                     -> Library Configuration                                                                                                                                                                                                                                        -> tnfdt: Supports dynamic and static use of device tree information                                                                                                                                                                     
        -> Path to DTS Overlay File //配置增量修改（overlay）文件路径
        -> Path to Extra DTS Overlay File //配置扩展增量修改（overlay）文件路径

/* 注：Extra DTS Overlay增量修改的优先级高于 DTS Overlay File，如果两者同时配置重叠增量修改的部分以Extra DTS Overlay File文件中维护的信息为准 */
```

#### 配置环境变量

```
TNFDT_DTS_OVERLAY_FILE  //配置增量修改（overlay）文件路径
TNFDT_EXTRA_DTS_OVERLAY_FILE  //配置扩展增量修改（overlay）文件路径
```