Bluejay 项目教程

Bluejay 项目教程

bluejay :bird: Digital ESC firmware for controlling brushless motors in multirotors 项目地址: https://gitcode.com/gh_mirrors/blu/bluejay

1. 项目的目录结构及介绍

Bluejay 项目的目录结构如下：

bluejay/
├── src/
│   ├── main.c
│   ├── config.h
│   └── utils.c
├── tools/
│   ├── build.sh
│   └── flash.sh
├── CHANGELOG.md
├── COPYING
├── Makefile
├── README.md
└── bluejay.svg

目录结构介绍

• src/: 包含项目的源代码文件。

  • main.c: 主程序文件，负责初始化和启动项目。
  • config.h: 配置文件，定义了项目的各种参数和设置。
  • utils.c: 工具函数文件，包含一些通用的辅助函数。

• tools/: 包含项目的构建和烧录工具。

  • build.sh: 构建脚本，用于编译项目。
  • flash.sh: 烧录脚本，用于将编译后的固件烧录到目标设备。

• CHANGELOG.md: 记录项目的版本更新和变更历史。

• COPYING: 项目的许可证文件，遵循 GPL-3.0 许可证。

• Makefile: 项目的 Makefile 文件，用于自动化构建过程。

• README.md: 项目的说明文件，包含项目的概述、安装和使用说明。

• bluejay.svg: 项目的图标文件。

2. 项目的启动文件介绍

main.c

main.c 是 Bluejay 项目的主程序文件，负责初始化和启动项目。以下是 main.c 的主要功能：

#include "config.h"
#include "utils.h"

int main() {
    // 初始化硬件和软件环境
    init_hardware();
    init_software();

    // 加载配置文件
    load_config();

    // 启动主循环
    while (1) {
        main_loop();
    }

    return 0;
}

功能介绍

• init_hardware(): 初始化硬件环境，包括设置 GPIO、定时器等。
• init_software(): 初始化软件环境，包括加载驱动程序、初始化内存等。
• load_config(): 从 config.h 文件中加载配置参数。
• main_loop(): 主循环函数，负责处理各种任务和事件。

3. 项目的配置文件介绍

config.h

config.h 是 Bluejay 项目的配置文件，定义了项目的各种参数和设置。以下是 config.h 的主要内容：

#ifndef CONFIG_H
#define CONFIG_H

// 定义硬件平台
#define PLATFORM_EFM8BB21

// 定义通信协议
#define COMM_PROTOCOL_DSHOT300

// 定义 PWM 频率
#define PWM_FREQUENCY_48KHZ

// 定义启动功率
#define STARTUP_POWER_LEVEL 50

// 定义 RPM 保护
#define RPM_PROTECTION_ENABLED

#endif // CONFIG_H

配置参数介绍

• PLATFORM_EFM8BB21: 定义硬件平台，支持 SiLabs EFM8 BB21。
• COMM_PROTOCOL_DSHOT300: 定义通信协议，支持 DShot 300。
• PWM_FREQUENCY_48KHZ: 定义 PWM 频率，支持 48 kHz。
• STARTUP_POWER_LEVEL: 定义启动功率，设置为 50。
• RPM_PROTECTION_ENABLED: 启用 RPM 保护功能。

通过修改 config.h 文件中的参数，可以灵活配置 Bluejay 项目的行为和功能。

bluejay :bird: Digital ESC firmware for controlling brushless motors in multirotors 项目地址: https://gitcode.com/gh_mirrors/blu/bluejay