BBSHD/BBS02 开源固件项目教程

1. 项目目录结构及介绍

bbs-fw/
├── doc/
│   ├── drawings/
│   └── README.md
├── src/
│   ├── main.c
│   ├── config.h
│   └── ...
├── .editorconfig
├── LICENSE
└── README.md

目录结构说明

• doc/: 包含项目的文档和绘图文件。

  • drawings/: 存放项目的绘图文件，如电路图等。
  • README.md: 项目的说明文档。

• src/: 项目的源代码目录。

  • main.c: 项目的启动文件。
  • config.h: 项目的配置文件。
  • ...: 其他源代码文件。

• .editorconfig: 编辑器配置文件，用于统一代码风格。

• LICENSE: 项目的开源许可证文件。

• README.md: 项目的说明文档。

2. 项目的启动文件介绍

src/main.c

main.c 是项目的启动文件，负责初始化系统、加载配置、启动主循环等核心功能。以下是 main.c 的主要功能模块：

#include "config.h"

int main(void) {
    // 系统初始化
    system_init();

    // 加载配置
    load_config();

    // 主循环
    while (1) {
        // 处理主循环任务
        main_loop();
    }

    return 0;
}

主要功能模块

• 系统初始化 (system_init): 初始化硬件设备、外设和系统资源。
• 加载配置 (load_config): 从配置文件中加载系统配置参数。
• 主循环 (main_loop): 处理系统的核心任务，如电机控制、传感器数据采集等。

3. 项目的配置文件介绍

src/config.h

config.h 是项目的配置文件，包含了系统运行所需的各种配置参数。以下是 config.h 的主要配置项：

#ifndef CONFIG_H
#define CONFIG_H

// 系统配置
#define SYSTEM_CLOCK_FREQ 20000000  // 系统时钟频率
#define MAX_VOLTAGE 63             // 最大电压限制
#define MAX_CURRENT 33             // 最大电流限制

// 电机配置
#define MOTOR_TYPE BBSHD            // 电机类型
#define MOTOR_REVISION 1.5          // 电机版本

// 传感器配置
#define USE_SPEED_SENSOR 1          // 是否使用速度传感器
#define USE_TEMP_SENSOR 1           // 是否使用温度传感器

// 其他配置
#define DEBUG_MODE 0                // 调试模式

#endif // CONFIG_H

主要配置项

• 系统配置:

  • SYSTEM_CLOCK_FREQ: 系统时钟频率，单位为 Hz。
  • MAX_VOLTAGE: 最大电压限制，单位为 V。
  • MAX_CURRENT: 最大电流限制，单位为 A。

• 电机配置:

  • MOTOR_TYPE: 电机类型，如 BBSHD 或 BBS02。
  • MOTOR_REVISION: 电机版本号。

• 传感器配置:

  • USE_SPEED_SENSOR: 是否使用速度传感器，1 表示使用，0 表示不使用。
  • USE_TEMP_SENSOR: 是否使用温度传感器，1 表示使用，0 表示不使用。

• 其他配置:

  • DEBUG_MODE: 调试模式，1 表示开启调试模式，0 表示关闭。

通过修改 config.h 中的配置项，可以灵活调整系统的运行参数，以适应不同的硬件环境和应用场景。