【C语言】带参宏定义（一）

C语言

发布日期: 2019-03-23

文章字数: 1.2k

阅读时长: 4 分

阅读次数:

公司某项目用到DSP+FPGA架构（当然不是著名的ARM+DSP+FPGA点灯项目,哈哈），我的发展方向为DSP方向。其中DSP与FPGA通过两个带参宏进行数据交互（DSP与FPGA通过一块共享内存来实现数据交互，我这边的DSP只要往共享内存中写入数据即为往FPGA中写数据，往共享内存中读取数据就是读取FPGA发送过来的数据），如下图：

也即：

#define FPGA_WRITE(data_out, base_addr, offset)  \
((((volatile uint32*)base_addr)[(offset)]) = (data_out))
#define FPGA_READ(data_in, base_addr, offset)    \
((data_in) = (((volatile uint32*)base_addr)[(offset)]))

带参宏也称做宏函数，宏函数FPGA_WRITE(data_out, base_addr, offset)用于往FPGA发送数据。其中

参数data_out：要写入的数据。
参数base_addr：基地址。
参数offset：相对于基地址的偏移量。

该宏函数实体为：

((((volatile uint32*)base_addr)[(offset)]) = (data_out))

我们先看等号左边，从最里层的括号开始看，(volatile uint32*)base_addr的意思是把base_addr强制转换为(volatile uint32*)类型的数据，其中加volatile关键字的作用是确保本条指令不会因编译器的优化而省略。volatile在嵌入式编程中用得很多，如在Cortex-M3内核MCU的内核文件的C函数内嵌汇编中使用了大量的volatile关键字：

关于volatile关键字更多的介绍可查看往期分享：
【C语言笔记】volatile关键字

((volatile uint32*)base_addr)[(offset)]的意思是相对于base_addr偏移offset个内存单元后所占的空间，此时已经转变为了base_addr[offset]，这就可以看做数组base_addr的第offset个元素，所以可以给它赋值。等号右边的数据data_out就是给数组元素base_addr[offset]进行赋值的。数组和指针在此处其实是可以等价的，所以

((volatile uint32*)base_addr)[(offset)]

其实可以等价为：

*(((volatile uint32*)base_addr) + offset)

宏函数FPGA_READ(data_in, base_addr, offset)用于读取FPGA发送过来的数据，其实体为：

((data_in) = (((volatile uint32*)base_addr)[(offset)]))

同写函数的分析方法类似，此处从等号右边的最里层括号开始看，分析过程省略，具体的可查看写数据函数FPGA_WRITE的分析过程。此处等号右边的

(((volatile uint32*)base_addr)[(offset)]))

可以等价于：

*(((volatile uint32*)base_addr) + offset))

为什么要在宏函数实体的参数的两边加上括号呢？为什么要在宏函数实体的两边加上括号呢？

答：虽然有时候不加括号也没什么问题，但是，更严格的做法是给参数加括号、给宏函数实体加括号，这样可以避免**二义性**。关于宏函数的二义性将在下一篇笔记中分享，欢迎阅读！

以上两个带参宏的测试用例

/********************************************************************************
* 宏函数FPGA_WRITE、FPGA_READ测试用例
******************************************************************************/
#include <stdio.h>

#define uint32 unsigned int

#if 1
// 调用这两个宏可往共享内存中读写数据
#define FPGA_WRITE(data_out, base_addr, offset) 
\((((volatile uint32*)base_addr)[(offset)]) = (data_out))
#define FPGA_READ(data_in, base_addr, offset) 
\((data_in) = (((volatile uint32*)base_addr)[(offset)]))

#else
// 以上宏等效的写法
#define FPGA_WRITE(data_out, base_addr, offset) 
\(*(((volatile uint32*)base_addr) + offset) = (data_out))
#define FPGA_READ(data_in, base_addr, offset) 
\((data_in) = *(((volatile uint32*)base_addr) + offset))
#endif

int main(void)
{
  // 变量定义
  uint32 arr[6] = {0, 1, 2, 3, 4, 5};
  uint32 *ptr = arr;
  uint32 data_write = 520;
  uint32 data_read = 0;

  // 验证宏函数FPGA_WRITE
  FPGA_WRITE(data_write, ptr, 3); // 此时arr[3]的值会被data_write的值覆盖
  printf("arr[3] = %d\n", arr[3]);
  if (data_write == arr[3])
  {
    printf("宏函数FPGA_WRITE验证成功！\n\n");
  }

  // 验证宏函数FPGA_READ
  FPGA_READ(data_read, ptr, 5); // 此时data_read的值会被arr[5]的值覆盖
  printf("data_read = %d\n", data_read);
  if (data_read == arr[5])
  {
    printf("宏函数FPGA_READ验证成功！\n");
  }
  return 0;
}