飞腾 FT2000/4 核心板天脉 3 开发指南：从环境搭建到实时应用实践

本文详细介绍基于国产飞腾 FT2000/4 处理器的核心板开发流程，涵盖硬件资源解析、开发环境搭建、天脉 3 实时操作系统编译部署、外设驱动开发以及实时性能调优等内容。结合实际项目开发经验，整理了开发过程中的关键步骤和常见问题解决方案，为从事国产化嵌入式开发的工程师提供参考。

目录

1. 引言

2. 硬件平台概述

3. 开发环境搭建

4. 天脉 3 系统编译与烧写

5. 外设驱动开发实践

6. 实时性能调优与测试

7. 典型应用场景与选型建议

8. 常见问题排查

9. 总结

---

一、引言

在信创和军工国产化的大背景下，飞腾系列处理器在嵌入式领域的应用越来越广泛。FT2000/4 作为飞腾面向嵌入式场景推出的四核处理器，在航空、航天、军工等领域有较多应用。

本文基于实际项目开发经验，以威嵌神州 FT2000/4 核心板为例，系统梳理从环境搭建到应用开发的完整流程，重点讲解天脉 3 实时操作系统下的开发要点和性能优化方法，希望能帮助同行快速上手国产化平台开发。

二、硬件平台概述

2.1 核心板规格参数

FT2000/4 核心板采用超微型设计，板面积仅 65mm×110mm，主要规格如下：

项目	规格参数
处理器	飞腾 FT2000/4，2.2GHz / 1.0GHz
内存	8GB DDR4
存储	128MB Nor FLASH，可选 256KB NVram
操作系统	支持天脉 3、VxWorks、麒麟
供电电压	5V 或 12V
板尺寸	65mm × 110mm
连接器	高密度高速连接器，强抗震设计

2.2 开发板接口资源

开发板采用 “子卡 + 载板” 架构，载板提供丰富的外设接口：

接口类型	数量	说明
PCIe	4 路	x16×1、x8×2、x1×1
千兆以太网	2 路	含一路调试网口
RS422	2 路	工业串口
RS232	2 路	含一路调试串口
CAN	2 路	工业现场总线
GPIO	8 路	通用输入输出
散热	1 路	板载散热风扇接口
供电	2 路	一路 ATX 电源输入
载板尺寸	244mm × 170mm	标准工业尺寸

2.3 架构特点与质量等级

子卡 + 载板架构优势：

• 开发阶段使用通用载板，接口齐全，便于调试验证

• 产品阶段可定制专用载板，灵活适配不同设备需求

• 核心板通用化设计，降低多项目重复开发成本

质量等级配置：

• 普通工业级：适用于常规工业环境

• 宽温级（-40℃~85℃）：适用于户外、车载等环境

• 宽温级（-55℃~85℃）：适用于机载、舰载等严苛环境

• 全国产化配置：可提供国产化证明文件

这种分级配置的好处是开发阶段可以用工业级版本降低成本，定型后根据实际环境要求切换到对应等级，实现平滑过渡。

三、开发环境搭建

3.1 硬件连接步骤

1. 核心板安装：将 FT2000/4 核心板对准载板连接器，均匀用力按下，确保连接牢固

2. 串口连接：使用 RS232 调试口连接电脑，波特率设置 115200，8N1

3. 网线连接：将调试网口接入局域网，用于文件传输和网络调试

4. 电源连接：接入 12V ATX 电源，注意正负极

5. 散热风扇：连接板载风扇接口，确保散热正常

注意：上电前请仔细检查核心板是否插到位，避免因接触不良导致损坏。

3.2 交叉编译工具链配置

天脉 3 系统使用专用的 ARM64 交叉编译工具链，配置方法如下：

# 1. 解压工具链到指定目录
sudo mkdir -p /opt/tianmai3
sudo tar -xjf aarch64-tianmai3-linux-gnu-toolchain.tar.bz2 -C /opt/tianmai3/

# 2. 配置环境变量（建议写入~/.bashrc）
export TM3_TOOLCHAIN=/opt/tianmai3/toolchain
export PATH=$TM3_TOOLCHAIN/bin:$PATH
export CROSS_COMPILE=aarch64-tianmai3-linux-gnu-
export ARCH=arm64

# 3. 验证工具链是否正常
aarch64-tianmai3-linux-gnu-gcc -v

正常情况下会输出 gcc 版本信息，说明工具链配置成功。

3.3 调试工具准备

推荐配置以下调试工具：

工具类型	推荐软件	用途
串口终端	MobaXterm / SecureCRT / minicom	串口调试、日志查看
文件传输	tftp / scp / nfs	镜像烧写、文件传输
代码编辑	VS Code / Source Insight	内核和驱动代码编辑
性能分析	perf / ftrace / cyclictest	系统性能分析
硬件调试	JTAG 仿真器（可选）	内核级调试、故障定位

四、天脉 3 系统编译与烧写

4.1 内核源码编译

# 进入内核源码目录
cd linux-4.19-tianmai3

# 加载FT2000/4核心板默认配置
make ft2000_4_core_defconfig

# （可选）手动调整内核配置
make menuconfig

# 编译内核镜像（-j后数字根据CPU核心数调整）
make Image dtbs -j8

# 编译内核模块
make modules -j8

# 安装模块到指定目录
make modules_install INSTALL_MOD_PATH=./modules_output

编译完成后，生成的文件位置：

• 内核镜像：arch/arm64/boot/Image

• 设备树：arch/arm64/boot/dts/phytium/ft2000-4-core-board.dtb

4.2 设备树配置要点

根据实际硬件需求修改设备树，以下是几个常用外设的配置示例：

以太网配置：

&gmac0 {
    status = "okay";
    phy-mode = "rgmii";
    phy-handle = <&phy0>;
};

&gmac1 {
    status = "okay";
    phy-mode = "rgmii";
    phy-handle = <&phy1>;
};

CAN 总线配置：

&can0 {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&can0_pins>;
    clock-frequency = <100000000>;
};

&can1 {
    status = "okay";
    pinctrl-names = "default";
    pinctrl-0 = <&can1_pins>;
};

GPIO 扩展：

&gpio {
    status = "okay";
    gpio-line-names = "gpio0", "gpio1", "gpio2", "gpio3",
                      "gpio4", "gpio5", "gpio6", "gpio7";
};

4.3 TFTP 网络烧写流程

推荐使用 TFTP 方式烧写系统，步骤如下：

# 1. 启动开发板，按任意键进入U-Boot命令行

# 2. 配置网络参数（根据实际网络修改）
setenv ipaddr 192.168.1.100
setenv serverip 192.168.1.50
setenv gatewayip 192.168.1.1
setenv netmask 255.255.255.0
saveenv

# 3. 下载内核镜像到内存
tftp 0x90100000 Image

# 4. 下载设备树
tftp 0x90000000 ft2000-4-core-board.dtb

# 5. 启动内核
booti 0x90100000 - 0x90000000

验证系统启动正常后，再将镜像写入 Flash 固化。

五、外设驱动开发实践

5.1 PCIe 设备驱动开发

FT2000/4 处理器集成了 PCIe 控制器，支持 x16、x8、x1 等多种配置。开发 PCIe 设备驱动的基本框架：

#include <linux/pci.h>
#include <linux/module.h>

#define PCI_VENDOR_ID_CUSTOM    0xXXXX
#define PCI_DEVICE_ID_CUSTOM    0xXXXX

static const struct pci_device_id ft2000_pcie_ids[] = {
    { PCI_DEVICE(PCI_VENDOR_ID_CUSTOM, PCI_DEVICE_ID_CUSTOM) },
    { 0, }
};
MODULE_DEVICE_TABLE(pci, ft2000_pcie_ids);

static int ft2000_pcie_probe(struct pci_dev *pdev,
                             const struct pci_device_id *id)
{
    int ret;
    void __iomem *io_base;

    /* 使能PCIe设备 */
    ret = pci_enable_device(pdev);
    if (ret) {
        dev_err(&pdev->dev, "Failed to enable PCIe device\n");
        return ret;
    }

    /* 设置DMA掩码 */
    ret = pci_set_dma_mask(pdev, DMA_BIT_MASK(64));
    if (ret) {
        ret = pci_set_dma_mask(pdev, DMA_BIT_MASK(32));
        if (ret) {
            dev_err(&pdev->dev, "No suitable DMA mask available\n");
            goto err_disable;
        }
    }

    /* 申请BAR空间 */
    ret = pci_request_regions(pdev, "ft2000_pcie");
    if (ret) {
        dev_err(&pdev->dev, "Failed to request PCI regions\n");
        goto err_disable;
    }

    /* 映射BAR0寄存器空间 */
    io_base = pci_iomap(pdev, 0, pci_resource_len(pdev, 0));
    if (!io_base) {
        ret = -ENOMEM;
        goto err_release;
    }

    pci_set_drvdata(pdev, io_base);
    dev_info(&pdev->dev, "PCIe device probed successfully\n");
    return 0;

err_release:
    pci_release_regions(pdev);
err_disable:
    pci_disable_device(pdev);
    return ret;
}

static void ft2000_pcie_remove(struct pci_dev *pdev)
{
    void __iomem *io_base = pci_get_drvdata(pdev);

    pci_iounmap(pdev, io_base);
    pci_release_regions(pdev);
    pci_disable_device(pdev);
}

static struct pci_driver ft2000_pcie_driver = {
    .name     = "ft2000_pcie_drv",
    .id_table = ft2000_pcie_ids,
    .probe    = ft2000_pcie_probe,
    .remove   = ft2000_pcie_remove,
};

module_pci_driver(ft2000_pcie_driver);

MODULE_LICENSE("GPL");
MODULE_DESCRIPTION("FT2000/4 PCIe device driver");

5.2 CAN 总线应用开发

开发板集成 2 路 CAN 控制器，使用 SocketCAN 接口进行应用开发：

# 加载CAN驱动模块
modprobe can
modprobe can-dev
modprobe m_can

# 设置CAN0波特率为500Kbps
ip link set can0 type can bitrate 500000 sjw 3 tseg1 12 tseg2 3

# 启动CAN接口
ip link set can0 up

# 查看CAN接口状态
ip -details link show can0

CAN 应用示例代码：

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <net/if.h>
#include <sys/ioctl.h>
#include <sys/socket.h>
#include <linux/can.h>
#include <linux/can/raw.h>

int main(int argc, char *argv[])
{
    int s;
    struct sockaddr_can addr;
    struct ifreq ifr;
    struct can_frame frame;

    /* 创建CAN套接字 */
    s = socket(PF_CAN, SOCK_RAW, CAN_RAW);
    if (s < 0) {
        perror("socket");
        return -1;
    }

    /* 指定CAN接口 */
    strcpy(ifr.ifr_name, "can0");
    ioctl(s, SIOCGIFINDEX, &ifr);

    /* 绑定套接字 */
    addr.can_family = AF_CAN;
    addr.can_ifindex = ifr.ifr_ifindex;
    bind(s, (struct sockaddr *)&addr, sizeof(addr));

    /* 发送CAN帧 */
    frame.can_id = 0x123;
    frame.can_dlc = 8;
    frame.data[0] = 0x11;
    frame.data[1] = 0x22;
    frame.data[2] = 0x33;
    frame.data[3] = 0x44;
    frame.data[4] = 0x55;
    frame.data[5] = 0x66;
    frame.data[6] = 0x77;
    frame.data[7] = 0x88;

    write(s, &frame, sizeof(frame));

    close(s);
    return 0;
}

5.3 GPIO 用户空间操作

# 导出GPIO（以GPIO0为例）
echo 0 > /sys/class/gpio/export

# 设置方向为输出
echo out > /sys/class/gpio/gpio0/direction

# 输出高电平
echo 1 > /sys/class/gpio/gpio0/value

# 输出低电平
echo 0 > /sys/class/gpio/gpio0/value

# 设置为输入
echo in > /sys/class/gpio/gpio0/direction

# 读取输入值
cat /sys/class/gpio/gpio0/value

六、实时性能调优与测试

6.1 内核实时性配置

天脉 3 系统基于 RT-Linux 内核，建议开启以下配置优化实时性：

# 内核配置选项
CONFIG_PREEMPT_RT=y              # 完全抢占实时内核
CONFIG_HIGH_RES_TIMERS=y         # 高精度定时器
CONFIG_NO_HZ_FULL=y              # 全动态时钟
CONFIG_CPU_ISOLATION=y           # CPU隔离支持
CONFIG_RT_GROUP_SCHED=y          # 实时组调度

# 关闭影响实时性的调试功能
# CONFIG_DEBUG_PREEMPT is not set
# CONFIG_DEBUG_OBJECTS is not set
# CONFIG_FTRACE is not set

6.2 系统实时性优化

1. CPU 核心隔离

在 U-Boot 启动参数中添加 isolcpus 参数，隔离指定 CPU 核心专供实时任务使用：

# 隔离CPU2和CPU3核心
setenv bootargs 'console=ttyS0,115200 isolcpus=2,3 root=/dev/mmcblk0p1 rw'

2. 中断亲和性配置

# 将以太网中断绑定到非实时CPU核心
echo 1 > /proc/irq/35/smp_affinity

# 将CAN中断绑定到指定核心
echo 2 > /proc/irq/40/smp_affinity

3. 内存锁定优化

/* 应用程序中锁定内存，避免换页 */
#include <sys/mman.h>

int init_rt_memory(void)
{
    /* 锁定所有内存页面 */
    if (mlockall(MCL_CURRENT | MCL_FUTURE) < 0) {
        perror("mlockall");
        return -1;
    }
    return 0;
}

6.3 实时性能测试

使用 cyclictest 工具测试系统实时性能：

# 安装测试工具
apt install rt-tests

# 基本延迟测试（运行1小时）
cyclictest -m -n -p90 -i1000 -l3600000 -h100 -q > result.txt

# 带CPU负载的压力测试
stress --cpu 4 --io 2 --vm 2 --vm-bytes 128M &
cyclictest -t4 -p90 -i1000 -l100000

典型测试结果参考：

测试场景	平均延迟	最大延迟
系统空闲	6~10μs	20~30μs
CPU 满负载	10~15μs	50~70μs
综合负载	12~20μs	70~90μs

注：实际数值与硬件配置、内核版本和系统负载有关，以上数据仅供参考。

七、典型应用场景与选型建议

7.1 适用应用场景

根据 FT2000/4 的性能特点，适合以下应用场景：

• 航空机载设备：飞控计算机、任务处理机、数据采集单元

• 航天嵌入式系统：星载计算机、载荷数据处理、地面测试设备

• 舰载电子设备：显控终端、通信处理、信号预处理

• 工业控制领域：运动控制器、工业网关、实时数据采集

• 轨道交通：车载控制单元、信号处理、通信网关

7.2 型号选型指南

应用场景	推荐型号	配置说明
开发评估	WQKFB-FT20004-B0ITM	开发板套装，工业级，天脉 3 系统
常规工业产品	WQZK-FT20004-B0ITM	工业级核心板，天脉 3 系统
宽温工业环境	WQZK-FT20004-B0J2TM	-55℃~85℃宽温，天脉 3 系统
麒麟系统应用	WQZK-FT20004-BZK0J1QL	-40℃~70℃，麒麟 V10 系统
高国产化要求	WQZK-FT20004-BZK0J2TM	全国产化，-55℃~85℃，天脉 3

7.3 定制化服务

对于有特殊需求的项目，可提供以下定制服务：

• 载板定制：根据接口需求设计专用载板

• 功能扩展：增加 AD/DA、视频、专用总线等功能

• 固件定制：裁剪系统、定制驱动、优化启动

• 结构定制：特殊尺寸、安装方式、防护等级

八、常见问题排查

8.1 启动相关问题

Q：串口无输出怎么办？

• 检查串口线是否连接正确，波特率是否为 115200

• 确认核心板是否插到位，电源是否正常

• 检查调试串口是否选择正确（默认是 RS232 调试口）

Q：内核启动卡住怎么办？

• 检查设备树配置是否正确

• 确认内存配置与硬件一致

• 打开 earlyprintk 查看早期启动日志

8.2 网络相关问题

Q：网口不通怎么办？

• 检查网线和交换机是否正常

• 使用ifconfig -a查看网口是否识别

• 检查 PHY 芯片驱动是否加载

• 确认设备树中 phy-mode 配置是否正确

8.3 实时性问题

Q：实时延迟偏大怎么办？

• 检查是否开启了 PREEMPT_RT 配置

• 隔离实时任务专用 CPU 核心

• 关闭不必要的后台服务和调试功能

• 将非实时中断绑定到非实时核心

• 检查是否有驱动频繁关中断

8.4 PCIe 相关问题

Q：PCIe 设备识别不到怎么办？

• 检查 PCIe 设备供电是否正常

• 使用lspci查看总线枚举情况

• 确认设备树中 PCIe 配置是否正确

• 检查金手指接触是否良好

九、总结

飞腾 FT2000/4 核心板作为国产化嵌入式平台，在性能、接口丰富度和实时性方面都有不错的表现。配合天脉 3 实时操作系统，能够满足航空、航天、军工等领域的多数应用需求。

“子卡 + 载板” 的灵活架构，加上不同质量等级的配置选择，能够很好地覆盖从开发验证到产品定型的完整流程，帮助团队加速产品落地。

当然，国产平台的生态建设还在持续完善中，开发过程中可能会遇到一些问题。但随着产业的发展和社区的壮大，这些问题正在逐步得到解决。对于有国产化需求的项目，FT2000/4 平台是一个值得考虑的选择。

---

参考资料：

• 飞腾 FT2000/4 处理器数据手册

• 天脉 3 实时操作系统开发指南

• 威嵌神州 FT2000/4 核心板硬件手册

• Linux 内核驱动开发文档

相关推荐：

• 飞腾平台 PCIe 驱动开发详解

• 天脉 3 实时系统调优最佳实践

• 国产化嵌入式项目开发经验谈