1. 功能库不是“拿来就用”的黑匣子:它是在嵌入式系统里把重复逻辑封进可验证、可替换、可复用的最小执行单元
你写过第5次ADC采样滤波代码吗?改过第3版串口接收缓冲区的溢出判断吗?在Keil里复制粘贴过Delay_ms()函数,却在调试时发现它在不同晶振下跑得快慢不一?这些不是“小问题”,而是功能库缺失时最典型的血泪现场——每个模块都像手搓的独苗,改一处崩三处,加个新传感器就得重写半套通信逻辑。功能库(Function Library)不是一堆.h/.c文件的打包,它是把稳定、边界清晰、输入输出可穷举、行为可回归验证的原子能力,封装成带明确契约的接口单元。它解决的不是“能不能跑”,而是“换芯片要不要重写”“加新设备要不要动老逻辑”“客户说要支持Modbus RTU,三天内能不能切过去”这类工程交付问题。适合正在从单片机Demo迈向产品化开发的工程师:当你开始为同一类外设(比如AD0832、SerialPort、KCF跟踪器)写第二遍以上实现,或者被“这个功能上次在STM32上跑得好,换到51上就卡死”反复折磨时,功能库就是你唯一能抓住的确定性锚点。它不承诺性能最优,但承诺行为一致;不替代算法设计,但隔离硬件差异。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 功能库的三层骨架:接口层、实现层、适配层,缺一层就不是真库
功能库不是把.c文件扔进文件夹就完事。它必须有清晰的分层契约,否则很快就会退化成“又一个需要人肉维护的代码堆”。我见过太多项目,库名写着“ADC_Lib”,里面却混着LCD初始化、串口发送、甚至延时函数——这种“伪库”比不用还危险,因为它给了你一种虚假的秩序感。真正的功能库骨架只有三层,每层职责铁律不可逾越。
2.1 接口层(.h):只声明,不定义;只承诺,不实现
这是功能库的“宪法”,所有使用者只和它打交道。它必须满足三个硬约束:
- 无硬件依赖:不能出现
#include "reg52.h"或#define P1_0 P1^0这类芯片特有定义; - 无实现细节:函数体必须是
extern声明,连static inline都不允许(那是实现层的事); - 契约明确:每个函数必须用注释写清输入范围、输出含义、调用前提、线程安全要求。
以AD0832驱动为例,接口层ad0832.h长这样:
c复制#ifndef AD0832_H
#define AD0832_H
// 【契约】调用前必须完成GPIO初始化:CS、CLK、D0、DI引脚已配置为推挽输出/输入
// 【契约】输入channel取值范围:0~1(0=CH0, 1=CH1),越界返回0xFF
// 【契约】此函数为阻塞式,最大耗时约40μs(12MHz晶振下)
unsigned char AD0832_Read(unsigned char channel);
// 【契约】返回值:0x00~0xFF对应0~255级量化值;0xFF表示通信失败(CS未拉低/时序错误)
// 【契约】不修改任何全局变量,线程安全
unsigned char AD0832_Read_Safe(unsigned char channel);
#endif
注意:这里没有
#include <reg52.h>,没有sbit CS = P1^0;,没有_nop_()。它只说“你要传什么、你会得到什么、你得保证什么”。使用者看到这个头文件,就能100%确定:只要我按契约传参,不管底层是51、STM32还是GD32,函数行为一致。
2.2 实现层(.c):只做一件事,且做完就走
实现层是功能库的“肌肉”,但它必须极度克制。它的唯一使命是:用最直白的代码,100%兑现接口层的每一个契约。绝不处理异常(如自动重试)、绝不做业务逻辑(如把ADC值转成温度)、绝不耦合其他外设(如读完ADC立刻发串口)。以AD0832_Read为例,ad0832.c的核心逻辑必须像手术刀一样精准:
c复制#include "ad0832.h"
// 【关键】此处才引入硬件定义,且必须通过宏开关隔离
#ifdef MCU_51
#include "reg52.h"
#define CS_PIN P1_0
#define CLK_PIN P1_1
#define DO_PIN P1_2
#define DI_PIN P1_3
#elif defined(MCU_STM32)
#include "stm32f10x.h"
// STM32专用GPIO操作宏
#define CS_SET() GPIO_ResetBits(GPIOA, GPIO_Pin_4)
#define CS_CLR() GPIO_SetBits(GPIOA, GPIO_Pin_4)
// ... 其他引脚定义
#endif
// 【严格兑现契约】仅执行AD0832标准时序,不加任何额外逻辑
unsigned char AD0832_Read(unsigned char channel) {
unsigned char i;
unsigned char dat = 0;
// 1. 拉低CS启动通信
CS_CLR();
// 2. 发送启动位+通道选择(0x10 for CH0, 0x11 for CH1)
if(channel == 0) {
// CH0: 0 0 0 1 0 0 0 0
for(i=0; i<8; i++) {
CLK_PIN = 0;
DI_PIN = (0x10 & (0x80>>i)) ? 1 : 0;
CLK_PIN = 1;
}
} else {
// CH1: 0 0 0 1 0 0 0 1
for(i=0; i<8; i++) {
CLK_PIN = 0;
DI_PIN = (0x11 & (0x80>>i)) ? 1 : 0;
CLK_PIN = 1;
}
}
// 3. 读取8位数据(高位在前)
for(i=0; i<8; i++) {
CLK_PIN = 0;
CLK_PIN = 1;
dat <<= 1;
dat |= DO_PIN;
}
// 4. 拉高CS结束通信
CS_SET();
return dat;
}
参数说明:
MCU_51/MCU_STM32宏由编译器命令行传入(如-DMCU_51),确保同一份.c文件可跨平台编译;- 所有硬件操作(
P1_0,GPIO_ResetBits)被严格限制在#ifdef块内,接口层完全无感; - 函数体内没有
if(adc_value > 200) send_to_uart();这类业务逻辑,纯粹执行时序。
2.3 适配层(board_config.h):把硬件差异“焊死”在编译期
这是功能库可移植性的命门。很多团队失败就败在这里:把P1_0直接写死在.c里,换板子就得改源码。正确做法是建立一个板级配置头文件,由项目顶层决定硬件映射,功能库只认这个“翻译官”。board_config.h示例:
c复制#ifndef BOARD_CONFIG_H
#define BOARD_CONFIG_H
// 【强制】所有外设引脚在此统一定义,功能库.c文件通过它间接访问
// 51开发板V1.0:AD0832接P1口
#define AD0832_CS_PORT P1
#define AD0832_CS_PIN 0
#define AD0832_CLK_PORT P1
#define AD0832_CLK_PIN 1
#define AD0832_DO_PORT P1
#define AD0832_DO_PIN 2
#define AD0832_DI_PORT P1
#define AD0832_DI_PIN 3
// 【可选】为不同板子提供开关
// #define AD0832_USE_SOFTWARE_SPI // 启用软件SPI(当硬件SPI冲突时)
#endif
然后在ad0832.c中,把原来的P1_0全部替换成:
c复制// 在ad0832.c顶部包含
#include "board_config.h"
// 定义引脚操作宏(51专用)
#define AD0832_CS_SET() (AD0832_CS_PORT &= ~(1<<AD0832_CS_PIN))
#define AD0832_CS_CLR() (AD0832_CS_PORT |= (1<<AD0832_CS_PIN))
// ... 其他引脚宏同理
为什么这层不可少?
- 当你把板子从51换成STM32时,只需重写
board_config.h,ad0832.c一行不动; - 当客户要求同一块板子支持两种AD芯片(AD0832和ADS1115)时,你只需在
board_config.h里切换宏定义,功能库自动适配; - 它让硬件变更变成“改配置”,而不是“改逻辑”,这是功能库从Demo走向量产的分水岭。
3. 功能库的避坑指南:90%的翻车源于没守住这五条铁律
功能库最大的陷阱,不是写不出来,而是写出来后“看起来能用,一上产线就崩”。我在三个工业项目里踩过这些坑,每次修复都花掉至少两天——不是代码难,是思维惯性太强。以下五条是血换来的红线,每一条都对应真实故障现象。
3.1 现象:在Keil里编译通过,烧录到51单片机后ADC读数全为0xFF
原因:接口层头文件中漏写了#ifndef AD0832_H / #define AD0832_H / #endif卫士,导致多个.c文件包含该头文件时,函数被重复声明,Keil编译器静默忽略,但链接时符号混乱。更隐蔽的是,某些版本Keil会把重复声明当作inline处理,实际生成的代码跳转错乱。
解决:所有功能库头文件必须强制使用卫士宏,且宏名与文件名严格一致(AD0832_H而非ADC_H)。在Keil中开启Warning Level 3,确保编译日志里没有'redefinition'警告。
3.2 现象:串口功能库在PC端调试正常,接入PLC后数据帧头总是错乱
原因:功能库的串口接收函数(如SerialPort_Read())内部使用了全局缓冲区rx_buf[256],但未加临界区保护。当主循环调用SerialPort_Read()的同时,串口中断服务程序(ISR)也在往同一缓冲区写数据,造成缓冲区指针rx_head被ISR和主循环同时修改,数据覆盖。
解决:功能库的任何共享资源(缓冲区、计数器、状态机)必须提供原子操作接口。正确做法是:
- 在接口层声明
void SerialPort_EnterCritical(void)和void SerialPort_ExitCritical(void); - 在实现层用
EA=0/EA=1(51)或__disable_irq()/__enable_irq()(ARM)实现; - 所有访问共享资源的函数内部,必须成对调用这两个临界区函数。绝不在库内硬编码
EA=0。
3.3 现象:KCF视觉跟踪功能库在Jetson上运行流畅,移植到STM32H7后内存溢出崩溃
原因:功能库的KCF模板更新函数KCF_UpdateTemplate()内部动态申请了malloc(1024*1024)内存,但STM32H7的RAM只有512KB,且功能库未提供内存池配置接口。更致命的是,库的Makefile里写了-O3优化,导致malloc被编译器内联,错误无法在编译期捕获。
解决:功能库禁止使用malloc/free,必须提供静态内存配置。在接口层增加:
c复制// 【契约】调用者必须在main()开头调用此函数,传入预分配的内存块
// 【契约】buffer_size至少为KCF_REQUIRED_MEM_SIZE(见文档)
void KCF_InitMemory(void* buffer, unsigned int buffer_size);
并在实现层用static void* kcf_mem_pool指向该缓冲区,所有内存申请从此池分配。这样,内存不足问题会在KCF_InitMemory()调用时立即暴露,而非运行时崩溃。
3.4 现象:AD0832功能库在常温下工作正常,环境温度低于5℃时读数漂移高达±15%
原因:功能库的AD0832_Read()函数假设时序延迟由_nop_()精确控制,但_nop_()的执行周期受温度影响(半导体载流子迁移率变化),5℃时实际延迟比25℃长约8%,导致AD0832的采样窗口偏移,读取到错误位。
解决:功能库的时序敏感操作必须提供可配置延迟接口。在接口层增加:
c复制// 【契约】设置AD0832通信时钟周期(单位:微秒),默认值为2.0μs
// 【契约】调用此函数后,所有后续AD0832操作按新时序执行
void AD0832_SetClockUs(float us_per_cycle);
实现层不再用_nop_()硬延迟,而是根据us_per_cycle查表或计算精确延时循环。这样,温度补偿逻辑可由上层应用(如读取温度传感器后动态调用AD0832_SetClockUs())完成,功能库保持纯净。
3.5 现象:功能库编译后HEX文件体积暴涨300KB,远超51单片机64KB Flash限制
原因:功能库的printf格式化函数(用于调试日志)被意外链接进来。虽然接口层没声明printf,但某个.c文件里写了printf("ADC=%d\n", val);,而Keil的printf库(printf167.a)体积巨大,且默认启用。
解决:功能库必须禁用所有标准I/O函数。在Keil中:
- 项目选项 → C/C++ →
Use MicroLIB勾选(启用精简版C库); - 在
ad0832.c顶部添加#pragma push+#pragma use_no_heap; - 所有调试信息改用
LCD_Write_String()或UART_SendHex()等轻量接口,这些函数由板级驱动提供,不引入libc。
提示:在Keil的
Output窗口查看Linker Listing,确认printf、sprintf等符号未出现在Symbols列表中。
4. 从零构建你的第一个功能库:以SerialPort通信为例,5步落地可验证
现在,我们把前面所有原则,浓缩成一个可立即动手的实战案例:为C#串口调试助手构建一个SerialPortLib功能库。这不是教你怎么写UI,而是教你如何把“串口收发”这个能力,封装成可复用、可测试、可替换的独立单元。整个过程5步,每步都有可验证的产出。
4.1 第一步:定义接口契约(serialportlib.h)
新建serialportlib.h,只写接口,不碰实现。重点是把“串口”这个模糊概念,拆解成原子操作:
c复制#ifndef SERIALPORTLIB_H
#define SERIALPORTLIB_H
// 【契约】初始化串口:设置波特率、数据位、停止位、校验位
// 【契约】返回值:0=成功,非0=失败(1=端口不存在,2=权限拒绝,3=参数非法)
int SerialPort_Init(const char* port_name, int baud_rate,
int data_bits, int stop_bits, char parity);
// 【契约】发送字节数组:阻塞式,直到全部发送完毕或超时
// 【契约】timeout_ms=0表示无限等待;返回值=实际发送字节数(可能<length)
int SerialPort_Write(const unsigned char* data, int length, int timeout_ms);
// 【契约】接收字节数组:非阻塞式,最多读取length字节,返回实际读取数
// 【契约】若无数据,立即返回0;不抛异常,不触发UI刷新
int SerialPort_Read(unsigned char* buffer, int length);
// 【契约】关闭串口,释放资源;调用后所有其他函数返回失败
void SerialPort_Close(void);
// 【契约】获取当前串口状态(是否打开、接收缓冲区字节数、发送缓冲区字节数)
typedef struct {
int is_open;
int rx_bytes;
int tx_bytes;
} SerialPort_Status;
SerialPort_Status SerialPort_GetStatus(void);
#endif
验证点:把这个头文件给另一个开发者,他不看任何实现,仅凭注释就能写出调用代码,并预测每个函数的行为边界。如果他问“parity参数传'N'还是0?”,说明契约不清晰,必须补全。
4.2 第二步:编写最小实现(serialportlib.c)
创建serialportlib.c,只实现SerialPort_Init和SerialPort_Write两个核心函数(先做最小可行)。关键:所有Windows API调用必须包裹在#ifdef _WIN32中,为未来Linux移植留门:
c复制#include "serialportlib.h"
#include <windows.h>
// 【全局状态】功能库的私有数据,对外不可见
static HANDLE hCom = INVALID_HANDLE_VALUE;
static DCB dcb;
static COMMTIMEOUTS timeouts;
int SerialPort_Init(const char* port_name, int baud_rate,
int data_bits, int stop_bits, char parity) {
// 1. 打开串口(Windows API)
char port_path[32];
sprintf_s(port_path, sizeof(port_path), "\\\\.\\%s", port_name);
hCom = CreateFileA(port_path,
GENERIC_READ | GENERIC_WRITE,
0, NULL, OPEN_EXISTING, 0, NULL);
if(hCom == INVALID_HANDLE_VALUE) return 1;
// 2. 配置串口参数(DCB结构体)
memset(&dcb, 0, sizeof(dcb));
dcb.DCBlength = sizeof(dcb);
if(!GetCommState(hCom, &dcb)) { CloseHandle(hCom); return 2; }
dcb.BaudRate = baud_rate;
dcb.ByteSize = data_bits;
dcb.StopBits = (stop_bits == 1) ? ONESTOPBIT : TWOSTOPBITS;
dcb.Parity = (parity == 'N') ? NOPARITY :
(parity == 'O') ? ODDPARITY :
(parity == 'E') ? EVENPARITY : NOPARITY;
if(!SetCommState(hCom, &dcb)) { CloseHandle(hCom); return 3; }
// 3. 设置超时(关键!避免ReadFile无限阻塞)
timeouts.ReadIntervalTimeout = MAXDWORD;
timeouts.ReadTotalTimeoutConstant = 0; // 非阻塞读
timeouts.ReadTotalTimeoutMultiplier = 0;
timeouts.WriteTotalTimeoutConstant = 1000; // 写超时1秒
timeouts.WriteTotalTimeoutMultiplier = 0;
SetCommTimeouts(hCom, &timeouts);
return 0; // 成功
}
int SerialPort_Write(const unsigned char* data, int length, int timeout_ms) {
if(hCom == INVALID_HANDLE_VALUE) return -1;
DWORD bytes_written;
// Windows WriteFile是阻塞式,但timeout_ms通过COMMTIMEOUTS控制
BOOL result = WriteFile(hCom, data, length, &bytes_written, NULL);
if(!result) return -1;
return (int)bytes_written;
}
参数说明:
sprintf_s(port_path, ...)确保Windows下端口名格式正确(\\\\.\\COM3);COMMTIMEOUTS的ReadTotalTimeoutConstant=0是实现“非阻塞读”的核心,否则SerialPort_Read()无法做到即时返回;- 所有API错误都转换为接口层定义的错误码(1/2/3),上层无需知道
CreateFileA失败原因。
4.3 第三步:编写适配层(platform_win32.h)
创建platform_win32.h,把Windows平台特有定义集中管理:
c复制#ifndef PLATFORM_WIN32_H
#define PLATFORM_WIN32_H
// 【强制】所有平台相关头文件在此引入
#include <windows.h>
#include <stdio.h>
#include <string.h>
// 【强制】所有平台相关类型在此定义
typedef HANDLE Platform_PortHandle;
typedef DWORD Platform_TickCount;
// 【强制】所有平台相关函数在此声明(供功能库内部调用)
Platform_TickCount Platform_GetTickCount(void);
#endif
然后在serialportlib.c顶部,把#include <windows.h>换成#include "platform_win32.h"。这样,当移植到Linux时,只需提供platform_linux.h,替换HANDLE为int,CreateFileA为open(),功能库主体代码零修改。
4.4 第四步:编写测试桩(test_serialport.c)
功能库必须自带测试用例,证明它真的能工作。创建test_serialport.c,不依赖任何UI框架:
c复制#include "serialportlib.h"
#include <stdio.h>
int main() {
// 测试1:初始化COM3,9600波特率
int ret = SerialPort_Init("COM3", 9600, 8, 1, 'N');
if(ret != 0) {
printf("Init failed: %d\n", ret);
return -1;
}
printf("SerialPort_Init OK\n");
// 测试2:发送字符串"AT\r\n"
unsigned char cmd[] = {0x41, 0x54, 0x0D, 0x0A}; // "AT\r\n"
int sent = SerialPort_Write(cmd, 4, 1000);
if(sent != 4) {
printf("Write failed: sent %d\n", sent);
return -1;
}
printf("Write OK: %d bytes\n", sent);
// 测试3:读取应答(模拟设备回传"OK\r\n")
unsigned char resp[16];
int recv = SerialPort_Read(resp, 16);
printf("Read %d bytes: ", recv);
for(int i=0; i<recv; i++) printf("%02X ", resp[i]);
printf("\n");
SerialPort_Close();
return 0;
}
验证点:在Visual Studio中新建空项目,添加serialportlib.c、test_serialport.c、serialportlib.h,编译运行。如果输出Init OK、Write OK,且Read能捕获到你手动短接COM3的TX/RX引脚时的回环数据,说明功能库核心通路已打通。这是你第一个可交付的“功能库制品”。
4.5 第五步:集成到C# UI项目(.NET Framework)
现在,把C功能库注入C#界面。关键:用P/Invoke调用,而非重写C#版串口逻辑。在C#项目中:
csharp复制using System;
using System.Runtime.InteropServices;
public class SerialPortLibWrapper
{
// 【声明】映射C函数,注意CallingConvention.Cdecl
[DllImport("serialportlib.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int SerialPort_Init(string port_name, int baud_rate,
int data_bits, int stop_bits, char parity);
[DllImport("serialportlib.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int SerialPort_Write(byte[] data, int length, int timeout_ms);
[DllImport("serialportlib.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern int SerialPort_Read(byte[] buffer, int length);
[DllImport("serialportlib.dll", CallingConvention = CallingConvention.Cdecl)]
public static extern void SerialPort_Close();
// 【封装】C#友好的方法
public bool Open(string port, int baud) {
return SerialPort_Init(port, baud, 8, 1, 'N') == 0;
}
public int Write(byte[] data) {
return SerialPort_Write(data, data.Length, 1000);
}
public byte[] Read(int count) {
byte[] buf = new byte[count];
int len = SerialPort_Read(buf);
Array.Resize(ref buf, len);
return buf;
}
}
// 在UI按钮事件中调用
private void btnOpen_Click(object sender, EventArgs e) {
if (wrapper.Open("COM3", 9600)) {
MessageBox.Show("串口打开成功!");
}
}
验证点:编译serialportlib.c为serialportlib.dll(在Keil中不行,需用MinGW或Visual Studio C++),放入C#项目bin/Debug目录。点击UI按钮,能成功打开串口并发送数据——这意味着你的功能库已穿透C/C#边界,成为真正的跨语言能力单元。
5. 功能库的终极验证:用“三把尺子”量出它是不是真可用
写完功能库不等于结束,它必须经受住三把尺子的硬核丈量。这三把尺子不是理论标准,而是我在产线救火时总结出的“生死线”。每把尺子都对应一个具体动作,做不完,库就不能上车。
5.1 尺子一:编译器兼容性测试——Keil、IAR、GCC,一个都不能少
功能库的头文件和实现,必须能在三大主流嵌入式编译器下无警告编译。这不是“能跑就行”,而是检验你是否真正遵守了接口层/实现层分离原则。操作步骤:
-
Keil μVision 5:新建51工程,添加
ad0832.h/ad0832.c,配置-DMCU_51,编译。检查Build Output窗口:- 必须无
'redefinition'警告(卫士宏生效); - 必须无
'implicit declaration'警告(所有函数声明完整); Linker阶段Code Size增长合理(<2KB,证明没引入libc)。
- 必须无
-
IAR Embedded Workbench:新建STM32工程,添加相同文件,配置
-DMCU_STM32,编译。关键看:Error[Pe020](未定义标识符)是否为0(证明#ifdef MCU_STM32分支正确);Warning[Pa082](浮点常量隐式转换)是否为0(证明没用float做时序,符合嵌入式要求)。
-
GCC for ARM(如
arm-none-eabi-gcc):在Linux下交叉编译,命令:bash复制
arm-none-eabi-gcc -mcpu=cortex-m3 -mthumb -DMCU_STM32 \ -Wall -Werror -c ad0832.c -o ad0832.o-Werror确保所有警告变错误。如果GCC报'unknown type name',说明board_config.h里漏了#include <stdint.h>——这就是GCC比Keil更严格的“照妖镜”。
提示:把这三个编译命令写成
build.sh脚本,每次提交代码前自动运行。我所在团队把它集成到Git Hook里,git commit时自动触发,杜绝“在我机器上能跑”的悲剧。
5.2 尺子二:内存足迹审计——用Map文件揪出每一字节的去向
功能库的内存占用必须透明。很多库号称“轻量”,结果一链接就吃掉10KB RAM。审计方法:看编译器生成的.map文件。以Keil为例:
-
编译后,在
Objects/xxx.map中搜索ad0832.o,找到类似段:code复制ad0832.o(.text) 0x00000120 0x1a4 ./Objects/ad0832.o ad0832.o(.data) 0x000002c4 0x0 ./Objects/ad0832.o ad0832.o(.bss) 0x000002c4 0x0 ./Objects/ad0832.o这表示
ad0832.o的代码段(.text)占356字节,数据段(.data)和BSS段(.bss)为0——完美,证明没有全局变量。 -
如果
.bss显示0x10(16字节),说明你写了unsigned char rx_buf[16];这样的全局缓冲区。立即整改:改为函数内static局部变量,或由调用者传入缓冲区指针(如AD0832_Read(unsigned char* buf, int len))。 -
对比
-O0(无优化)和-O2(优化)下的.text大小。如果-O2反而更大,说明编译器把函数内联膨胀了——这时要加__attribute__((noinline))强制不内联,保证体积可控。
5.3 尺子三:回归测试矩阵——用Excel表格管住每一次修改
功能库一旦发布,任何修改都必须通过历史用例验证。我用一个极简Excel表格管理(无需Jenkins):
| 用例ID | 输入参数 | 预期输出 | Keil结果 | IAR结果 | GCC结果 | 修改日期 | 修改人 |
|---|---|---|---|---|---|---|---|
| ADC-001 | channel=0 | 0x8A | ✅ | ✅ | ✅ | 2023-10-01 | A同学 |
| ADC-002 | channel=1 | 0x4F | ✅ | ✅ | ✅ | 2023-10-01 | A同学 |
| ADC-003 | channel=2 | 0xFF | ✅ | ✅ | ✅ | 2023-10-01 | A同学 |
操作流程:
- 每次修改功能库(哪怕只改一个
if条件),必须新增一行用例,填写修改日期和修改人; - 在三个编译器下运行对应测试,打✅或❌;
- ❌必须当场修复,不能“先提交再修”;
- 表格随功能库源码一起存入Git,
README.md里放表格截图。
这个表格的价值在于:当客户说“你们上个月的库在XX设备上好用,这个月的怎么不行?”时,你打开表格,一眼锁定ADC-003在2023-10-15那行是❌,立刻知道问题出在哪次提交。没有这个表格,排查时间从1小时变成3天。
从那以后我每次新建功能库,第一件事就是建好这三把尺子:编译器脚本、Map分析命令、回归测试表。它们不产生代码,但决定了代码能不能活过下一个迭代。希望帮到你。
