NiosII 常用函数详解.pdf

### Nios II 常用函数详解 #### IO操作函数 **函数原型：** ```c IORD(BASE, REGNUM) ``` **输入参数：** - `BASE`：寄存器的基地址 - `REGNUM`：寄存器的偏移量 **函数说明：** 此函数用于从寄存器读取数据。它会根据提供的`BASE`和`REGNUM`计算出寄存器的实际地址，并读取该地址上的数据。 **返回值：** 无返回值。通常情况下，读取的数据会被保存到一个变量中以便后续处理。 --- **函数原型：** ```c IOWR(BASE, REGNUM, DATA) ``` **输入参数：** - `BASE`：寄存器的基地址 - `REGNUM`：寄存器的偏移量 - `DATA`：要写入的数据 **函数说明：** 此函数用于向寄存器写入数据。根据提供的`BASE`和`REGNUM`，计算出实际的寄存器地址，并将`DATA`写入该地址对应的寄存器中。 **返回值：** 无返回值。 --- **函数原型：** ```c IORD_32DIRECT(BASE, OFFSET) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 **函数说明：** 此函数用于直接从特定的地址读取32位的数据。它使用`BASE`和`OFFSET`计算出实际地址，并读取该地址上的32位数据。 **返回值：** 无返回值。读取的数据应被保存至一个指定的变量中进行后续处理。 --- **函数原型：** ```c IORD_16DIRECT(BASE, OFFSET) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 **函数说明：** 此函数用于直接从特定地址读取16位的数据。使用`BASE`和`OFFSET`计算出实际地址，并读取该地址上的16位数据。 **返回值：** 无返回值。读取的数据应被保存至一个指定的变量中进行后续处理。 --- **函数原型：** ```c IORD_8DIRECT(BASE, OFFSET) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 **函数说明：** 此函数用于直接从特定地址读取8位的数据。使用`BASE`和`OFFSET`计算出实际地址，并读取该地址上的8位数据。 **返回值：** 无返回值。读取的数据应被保存至一个指定的变量中进行后续处理。 --- **函数原型：** ```c IOWR_32DIRECT(BASE, OFFSET, DATA) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 - `DATA`：要写入的数据 **函数说明：** 此函数用于直接向特定地址写入32位的数据。使用`BASE`和`OFFSET`计算出实际地址，并将`DATA`写入该地址对应的内存中。 **返回值：** 无返回值。 --- **函数原型：** ```c IOWR_16DIRECT(BASE, OFFSET, DATA) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 - `DATA`：要写入的数据 **函数说明：** 此函数用于直接向特定地址写入16位的数据。使用`BASE`和`OFFSET`计算出实际地址，并将`DATA`写入该地址对应的内存中。 **返回值：** 无返回值。 --- **函数原型：** ```c IOWR_8DIRECT(BASE, OFFSET, DATA) ``` **输入参数：** - `BASE`：寄存器的基地址 - `OFFSET`：寄存器的偏移量 - `DATA`：要写入的数据 **函数说明：** 此函数用于直接向特定地址写入8位的数据。使用`BASE`和`OFFSET`计算出实际地址，并将`DATA`写入该地址对应的内存中。 **返回值：** 无返回值。 #### DMA操作 **函数原型：** ```c int alt_dma_rxchan_close(alt_dma_rxchan rxchan) ``` **输入参数：** - `rxchan`：接收信道 **函数说明：** 此函数用于关闭DMA接收信道。当应用程序完成了对DMA接收信道`rxchan`的操作时，调用此函数通知系统。 **返回值：** - 成功返回0 - 失败返回-1 --- **函数原型：** ```c int alt_dma_rxchan_depth(alt_dma_rxchan dma) ``` **输入参数：** - `dma`：DMA接收信道 **函数说明：** 此函数返回特定DMA接收信道的最大深度（即可以接受的最大数据量）。 **返回值：** 返回DMA接收信道的最大深度。 --- **函数原型：** ```c int alt_dma_rxchan_ioctl(alt_dma_rxchan dma, int req, void *arg) ``` **输入参数：** - `dma`：DMA接收信道 - `req`：请求类型 - `arg`：请求参数 **函数说明：** 此函数用于通过DMA接收信道执行特定的I/O操作。通过`req`参数指定不同的操作，并可以通过`arg`参数传递额外的信息。 **返回值：** - 成功返回请求的具体值 - 失败返回负数 **请求类型：** | 请求类型 | 描述 | |----------------|--------------------------------------------------------------| | ALT_DMA_SET_MODE_8 | 指定数据传输以8位为单位，`arg`值被忽略 | | ALT_DMA_SET_MODE_16 | 指定数据传输以16位为单位，`arg`值被忽略 | | ALT_DMA_SET_MODE_32 | 指定数据传输以32位为单位，`arg`值被忽略 | | ALT_DMA_SET_MODE_64 | 指定数据传输以64位为单位，`arg`值被忽略 | | ALT_DMA_SET_MODE_128 | 指定数据传输以128位为单位，`arg`值被忽略 | | ALT_DMA_TX_ONLY_ON(1) | 设置软件控制下仅发送模式，`arg`值被忽略 | | ALT_DMA_TX_ONLY_OFF(1) | 设置软件控制下的自定义模式，允许发送和接收，`arg`值被忽略 | | ALT_DMA_RX_ONLY_ON(1) | 设置软件控制下仅接收模式，`arg`值被忽略 | | ALT_DMA_RX_ONLY_OFF(1) | 设置软件控制下的自定义模式，允许发送和接收，`arg`值被忽略 | --- **函数原型：** ```c alt_dma_rxchan alt_dma_rxchan_open(const char *name) ``` **输入参数：** - `name`：DMA接收信道名称 **函数说明：** 此函数用于打开一个DMA接收信道，并返回一个`alt_dma_rxchan`描述符。 **返回值：** - 成功返回非0值 - 失败返回0 --- **函数原型：** ```c int alt_dma_rxchan_prepare(alt_dma_rxchan dma, void *data, alt_u32 length, alt_rxchan_done *done) ``` **输入参数：** - `dma`：DMA接收信道 - `data`：指向数据缓冲区的指针 - `length`：数据长度 - `done`：完成回调函数 **函数说明：** 此函数用于准备DMA接收操作。它设置DMA接收信道以接收指定长度的数据，并可以设置一个回调函数来处理接收到的数据。 **返回值：** - 成功返回0 - 失败返回负数 以上这些函数是Nios II开发中非常重要的组成部分，它们提供了对硬件的直接访问能力，使开发者能够更高效地与底层硬件交互，实现高性能的应用程序。