STM32驱动代码规范化编写指南（嵌入式C语言方向）

点击下面图片带您领略全新的嵌入式学习路线 🔥爆款热榜 88万+阅读 1.6万+收藏

一、命名规范体系

1.1 变量/函数命名

// 好的示例
uint32_t sensor_raw_value;      // 小写下划线，名词结构
void adc_calibration(void);     // 动词+名词结构
GPIO_TypeDef* led_gpio_port;    // 类型标识明确

// 需避免的反例
int a;                          // 无意义命名
void func1();                   // 信息缺失

1.2 宏定义规范

#define ADC_SAMPLE_TIMES    (100)       // 全大写+下划线
#define BYTE_TO_BITS(x)     ((x)*8)     // 带参数的宏用括号包裹
#define IS_VALID_CHANNEL(c) ((c)>0 && (c)<16)

1.3 类型定义

typedef enum {
   
    LED_STATE_OFF = 0,
    LED_STATE_ON,
    LED_STATE_BLINK
} led_state_t;                  // _t类型后缀

typedef struct {
   
    GPIO_TypeDef* port;
    uint16_t pin;
    uint8_t active_level;
} gpio_config_t;