重点掌握
Lin_App.c
应用层代码,需要自己编写:
// ✅ 必须自己写的部分: void app_lin_init(void) { // 1. 初始化协议栈 LIN_Init(&lin_config); // 2. 注册回调函数(您的业务逻辑) Lin_RegisterFrameCallback(FRAME_ID_STATUS, on_status_frame); Lin_RegisterSignalCallback(SIGNAL_SPEED, on_speed_changed); // 3. 启动LIN通信 Lin_Start(); } // ✅ 回调函数实现(核心业务) void on_status_frame(uint8_t* data) { // 这里写您的处理逻辑 float speed = g_lin_signal_VehicleSpeed; // 直接使用全局变量 if(speed > 120.0) { trigger_overspeed_warning(); } update_dashboard(speed, g_lin_signal_EngineRPM); } // ✅ 信号变化处理 void on_speed_changed(float new_speed) { // 这里写响应逻辑 adjust_other_systems_based_on_speed(new_speed); } // ✅ 主循环中的处理 void app_lin_task(void) { // 1. 更新发送信号 g_lin_signal_DoorStatus = read_door_sensor(); g_lin_signal_LightStatus = read_light_switch(); // 2. 检查错误 if(Lin_GetErrorCount() > 0) { handle_lin_errors(); } // 3. 您的其他业务逻辑 process_user_input(); update_display(); }Lin_cfg.h和Lin_cfg.c
配置文件,需要根据项目来配置:
// 系统配置 #define LIN_NODE_ID 0x02 // 您的节点ID #define LIN_IS_MASTER 0 // 0=从节点,1=主节点 #define LIN_BAUDRATE 19200 // 波特率 // 功能选择 #define LIN_USE_DIAGNOSTIC 1 // 是否使用诊断 #define LIN_USE_SLEEP_MODE 1 // 是否支持休眠 #define LIN_USE_SCHEDULER 1 // 是否使用调度 // 资源分配 #define LIN_MAX_SIGNALS 32 // 信号数量 #define LIN_MAX_FRAMES 16 // 帧数量 #define LIN_RX_BUFFER_SIZE 64 // 接收缓冲区 #define LIN_TX_BUFFER_SIZE 64 // 发送缓冲区 // 硬件配置(根据实际硬件) #define LIN_UART_PORT USART2 // 使用的UART #define LIN_TIMER_PORT TIM3 // 使用的定时器 #define LIN_WAKEUP_PIN GPIO_PIN_8 // 中断优先级 #define LIN_UART_IRQ_PRIORITY 5 #define LIN_TIMER_IRQ_PRIORITY 6 // 超时配置 #define LIN_FRAME_TIMEOUT_MS 50 // 帧超时时间
Lin_server.h和Lin_types.h(看懂API)
里面有很多函数体定义,结构体和枚举:
// 重点看懂这些: // 1. 初始化函数 Lin_StatusType Lin_Init(const Lin_ConfigType* config); // 2. 调度控制函数 Lin_StatusType Lin_StartScheduler(void); Lin_StatusType Lin_StopScheduler(void); // 3. 帧发送/接收函数 Lin_StatusType Lin_SendFrame(uint8_t frame_id); Lin_StatusType Lin_RequestFrame(uint8_t frame_id); // 4. 信号访问函数 Lin_StatusType Lin_WriteSignal(uint16_t signal_id, float value); Lin_StatusType Lin_ReadSignal(uint16_t signal_id, float* value); // 5. 回调函数类型定义 typedef void (*Lin_FrameCallback)(uint8_t frame_id, uint8_t* data); typedef void (*Lin_SignalCallback)(uint16_t signal_id, float value); // 6. 错误码定义 typedef enum { LIN_OK, LIN_ERROR_PARAM, LIN_ERROR_TIMEOUT, LIN_ERROR_CHECKSUM, // ... } Lin_StatusType; // 7. 状态定义 typedef enum { LIN_STATE_UNINIT, LIN_STATE_INIT, LIN_STATE_OPERATIONAL, LIN_STATE_SLEEP, // ... } Lin_StateType;Lin_Matrix.h(看懂信号接口)
// 重点看懂: // 1. 所有可用的信号变量 extern volatile float g_lin_signal_VehicleSpeed; extern volatile float g_lin_signal_EngineRPM; extern volatile uint8_t g_lin_signal_DoorStatus; // ... // 2. 信号ID宏定义(方便使用) #define SIGNAL_ID_VEHICLE_SPEED 0x01 #define SIGNAL_ID_ENGINE_RPM 0x02 #define SIGNAL_ID_DOOR_STATUS 0x03 // ... // 3. 帧ID宏定义 #define FRAME_ID_ECU_STATUS 0x20 #define FRAME_ID_DOOR_STATUS 0x21 #define FRAME_ID_SEAT_CONTROL 0x22 // ... // 4. 初始化函数 void LIN_Matrix_Init(void); // 5. 回调注册函数 void LIN_Matrix_RegisterCallback(uint16_t signal_id, CallbackFunc func);
关于Lin_Matrix和Lin_Server
Lin_Matrix和Lin_Server文件通常是不需要自己手动修改的,都是由工具例如Vector/Linworks的图形操作界面生成代码。
Lin_Matrix中文名为Lin矩阵,也叫做配置表,实际上就是里面配置了一些帧和信号的初始化。
存储区域:为所有LIN信号分配全局变量
配置表:定义信号、帧、调度的关系
初始化函数:设置初始值,注册到LIN Server
访问接口:为应用程序提供直接访问信号的途径
Lin_Server中文名为Lin服务器,他负责用Lin_Matrix里面定义好的配置来进行调度和管理,以及对错误进行处理。
调度管理
帧发送/接收
信号打包/解包
状态管理
错误处理
Lin服务层级
应用层(Application) ↓ LIN服务层(LIN Server)←→ LIN矩阵(LIN Matrix) ↓ LIN接口层(LIN Interface) ↓ LIN驱动层(LIN Driver) ↓ 硬件层(UART + Timer)
lin_stack/ ├── lin_cfg.h # 配置头文件 ├── lin_matrix.c # 信号映射配置(通常自动生成) ├── lin_matrix.h # 矩阵头文件 ├── lin_server.c # 服务器引擎实现 ├── lin_server.h # 服务器API头文件 ├── lin_driver.c # 硬件驱动 ├── lin_driver.h # 驱动头文件 ├── lin_if.c # 接口层 ├── lin_if.h # 接口头文件 └── lin_types.h # 公共类型定义
lin_stack/ ├── lin_cfg.h # ✅ 必须自己写/配置 ├── lin_matrix.c # ⚠️ 工具生成,不能改 ├── lin_matrix.h # ⚠️ 工具生成,不能改 ├── lin_server.c # ❌ 现成协议栈提供 ├── lin_server.h # ❌ 现成协议栈提供 ├── lin_driver.c # ✅ 可能自己写/移植 ├── lin_driver.h # ✅ 可能自己写/移植 ├── lin_if.c # ⚠️ 可能自己写/可能提供 └── lin_types.h # ❌ 现成协议栈提供
项目结构
使用商业协议栈
your_project/
├── 3rd_party/ # 第三方代码
│ └── vector_lin_stack/ # 购买的协议栈
│ ├── inc/ # 头文件
│ │ ├── lin.h # 主头文件
│ │ ├── lin_cfg.h # 配置模板
│ │ ├── lin_types.h # 类型定义
│ │ └── ... # 其他
│ └── src/ # 源代码
│ ├── lin.c # 协议栈实现
│ ├── lin_driver_stm32.c # STM32驱动
│ └── ...
├── generated/ # 工具生成
│ ├── lin_matrix.c
│ └── lin_matrix.h
└── src/ # 您的代码
├── main.c
├── app_lin.c # 应用层LIN处理
└── lin_custom_cfg.h # 您的配置覆盖
使用芯片厂商协议栈
your_project/
├── SDK/ # MCU SDK
│ └── middleware/
│ └── lin/
│ ├── lin_driver.c # 厂商提供的驱动
│ ├── lin_driver.h
│ ├── lin_common.c # 公共函数
│ └── ...
├── generated/ # 工具生成
│ └── lin_matrix.c
└── src/
├── main.c
└── lin_app.c # 您写的应用代码