Linux下如何通过UIO监控PL给到PS的中断

1. 概述

xilinx mpsoc 平台中，PS 和 PL 进行交互时，PS 需要获取 PL 发出的中断信号。从 mpsoc 技术参考手册 ug1085 TRM 中可知，PL 给到 PS 的中断有两组——PL_PS_Group0 和 PL_PS_Group1，中断号范围分别为 121~128 和 136 ~143（ 在 Linux 设备树中进行配置时，中断号要减去 32 ）。

下面通过一个例程说明 如何通过 UIO 监控 PL 给到 PS 的中断 。

2. demo

Linux 环境下，获取 PL 中断信号最简单的方式是通过 UIO。这里，定义一个简单的测试 demo：

Linux 下控制 AXI-GPIO 产生高低电平；
PL 将 AXI-GPIO 的高低电平转变为中断信号给到 Linux。

2.1 vivado 配置

2.1.1 vivado

在 PL 端添加 AXI-GPIO IP 核，并使能两个通道，两个通道分别连接 PL_PS_Group0 和 PL_PS_Group1。

2.1.2 PL to PS Interrupts

使能 PL 给到 PS 的两组中断。

2.1.3 AXI GPIO 配置

使能 AXI GPIO 的两个通道，每个通道使用 1 位即可。

2.2 PS Linux

PS 端 Linux 系统下，通过 控制 AXI-GPIO 输出高低电平即可使 PL 生成中断信号到 PL_PS_Group0 和 PL_PS_Group1 。

2.2.1 AXI-GPIO 控制

Linux 下，AXI-GPIO 的控制方式和普通 GPIO 没有区别，最简单的方式是通过 /sys 文件系统。

cd /sys/class/gpio
#使能引脚号为506的引脚——将引脚导出到用户空间
echo 506 > export
#设置引脚为输出模式
echo out > gpio506/direction
#控制引脚输出高电平
echo 1 > gpio506/value
#控制引脚输出低电平
echo 0 > gpio506/value
#关闭引脚
echo 506 > unexport

2.2.2 设备树

在设备树中添加 UIO 中断节点，注意中断号的数值。

system-user.dtsi:

pl-ps-group0-1 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 89 1 >;
};
pl-ps-group0-2 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 90 1 >;
};

......

pl-ps-group0-8 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 96 1 >;
};

pl-ps-group1-1 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 104 1 >;
};
pl-ps-group1-2 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 105 1 >;
};

 ......

pl-ps-group1-8 {
    compatible = "generic-uio";
    interrupt-controller;
    interrupt-parent = < &gic >;
    interrupts = < 0 111 1 >;
};

2.2.3 中断监控程序

uio-int-monitor.c:

#include < stdio.h >
#include < stdlib.h >
#include < stdint.h >
#include < sys/types.h >
#include < sys/stat.h >
#include < fcntl.h >
#include < pthread.h >
#include < unistd.h >

#define PL_PS_GROUP0_0_UIO_NAME ("/dev/uio2")
#define PL_PS_GROUP1_0_UIO_NAME ("/dev/uio10")

struct uio_int_info {
    int8_t *uio_name;
    int32_t uio_fd;
};

static void *interrupt_uio_monitor(void *para)
{
    struct uio_int_info *uio_info = (struct uio_int_info *)para;
    const uint32_t uio_int_regen_flag = 1;
    uint32_t uio_int_happen_cnt = 0;

    write(uio_info- >uio_fd, &uio_int_regen_flag, sizeof(uio_int_regen_flag));

    while(1)
    {
        read(uio_info- >uio_fd, &uio_int_happen_cnt, sizeof(uio_int_happen_cnt));
        write(uio_info- >uio_fd, &uio_int_regen_flag, sizeof(uio_int_regen_flag));

        printf("%s interrupt happen, count:%un", uio_info- >uio_name, uio_int_happen_cnt);
    }
}

int main(int argc, char *argv[])
{
    pthread_t tid;
    struct uio_int_info g0_0 =
    {
        .uio_name = "gruop0-0",
    };

    struct uio_int_info g1_0 =
    {
        .uio_name = "gruop1-0",
    };

    g0_0.uio_fd = open(PL_PS_GROUP0_0_UIO_NAME, O_RDWR);
    g1_0.uio_fd = open(PL_PS_GROUP1_0_UIO_NAME, O_RDWR);

    if((-1 == g0_0.uio_fd) || (-1 == g1_0.uio_fd))
    {
        printf("open uio device failedn");
        return -1;
    }

    pthread_create(&tid, NULL, interrupt_uio_monitor, (void *)&g0_0);
    pthread_create(&tid, NULL, interrupt_uio_monitor, (void *)&g1_0);

    getchar();

    close(g0_0.uio_fd);
    close(g1_0.uio_fd);

    return 0;
}