如何使用模板为Arduino各引脚创建独立的平滑读数函数

报错根因 #

你遇到的shadows template parm报错确实是同名参数冲突导致：模板参数PIN和函数形参PIN同名，函数作用域内的形参优先级更高，编译器判定形参遮蔽了外层的模板参数，因此触发该错误。除此之外，只要函数内部定义的变量、形参和外层模板参数重名，都会触发同类报错。

另外你的原始代码还有三个隐藏问题：

• 模板非类型参数用了const uint8_t&引用类型，这类参数要求绑定的对象有静态存储期，你直接传入A0这类字面量引脚号会编译失败
• 采样数组未初始化，前10次读数会包含随机垃圾值，影响平滑效果
• 用了浮点运算做平均，在单片机环境下运行效率远低于整数运算

修正后的模板实现 #

你希望调用方式和analogRead()完全对齐，我们可以用模板+宏的方式实现，同时保证每个引脚对应独立的采样数组和计数变量：

// 模板实现，每个引脚号对应独立的静态资源
template<uint8_t PIN>
unsigned _smoothReading()
{
  static unsigned sample[10] = {0}; // 初始化为0避免初始随机值干扰
  static uint8_t currentUnit = 0;

  sample[currentUnit] = analogRead(PIN);
  currentUnit = (currentUnit + 1) % 10; // 循环计数，写法更简洁

  unsigned sum = 0;
  for (auto val : sample) {
    sum += val;
  }
  // 整数运算实现四舍五入，等效round(sum/10.0)，无浮点开销
  return (sum + 5) / 10;
}

// 宏封装，实现和analogRead一致的调用方式
#define smoothReading(pin) _smoothReading<pin>()

调用示例 #

和原生analogRead()完全一致：

// 读取A0引脚的平滑值
unsigned val = smoothReading(A0);
// 读取A1引脚的平滑值
unsigned val2 = smoothReading(A1);

两个引脚的采样数组、计数变量完全独立，不会互相干扰。

内容的提问来源于stack exchange，提问作者Carlos Alberto Flores Arellano