HummingBird SDK 开发指南
1. 项目目录结构及介绍
HummingBird SDK
的目录结构设计如下:
-
include - 包含所有必要的头文件,如API接口、硬件抽象层以及平台相关定义。
-
src - 存放源代码文件,通常包括示例程序、库函数等。
-
SoC - 设备SoC相关的代码,分为不同的子目录对应不同的SoC系列。
-
<soc_name>/Common/Include - SOC公共头文件。
-
<soc_name>/Board/<board_name>/Include - 特定板级支持的头文件。
-
<soc_name>/Board/<board_name>/Src - 板级驱动源码。
-
-
middleware - 中间件或第三方库,例如RTOS、网络栈等。
-
tools - 编译工具链和其他辅助工具。
-
build - 构建系统产生的中间文件和编译结果。
-
doc - 文档资料,包括手册和API参考。
-
examples - 示例应用程序,用于快速上手和测试功能。
-
scripts - 自动化脚本,用于构建、部署和调试流程。
2. 项目的启动文件介绍
启动文件通常是特定于硬件和操作系统环境的,它们负责初始化硬件资源,设置堆栈指针,调用C语言入口点,并可能包含其他设备初始化过程。在HummingBird SDK
中,启动文件通常位于SoC/<soc_name>/Board/<board_name>/Src
目录下,例如start.s
或__init__.c
。这些文件是低级别的入口,通常由汇编语言编写,以确保有效的控制权转移给C运行时环境和用户应用程序。
3. 项目的配置文件介绍
配置文件在HummingBird SDK
中的作用主要是定制构建选项和硬件特性。常见的配置文件包括Makefile,它定义了编译规则、目标、依赖项和变量,以及编译时需要选择的选项。此外,某些特定的库或组件可能会有自己的配置文件,例如RTOS的选择和配置。
-
Makefile - 定义整个项目的构建流程,包括编译器路径、优化级别、目标平台等参数。通过修改此文件可以调整编译设置。
-
config.h 或
platform_config.h
- 可能存在这样一个头文件,用于存储平台相关的配置宏,如外设使能状态、中断优先级等。用户可以根据需求修改这些宏来改变SDK的行为。
为了正确配置项目,你需要理解Makefile的工作原理,并根据自己的硬件和应用需求更新相应的配置文件。在构建或运行示例之前,请确保已正确设置了所有必要的选项。
请注意,实际的文件名称和位置可能因版本和具体实现而异,应参考HBird SDK
的官方文档或源码树进行详细操作。