文件分类
根据文件的内容，可将文件分为驱动文件和用户程序文件两大类：
- 驱动文件：包括设备相关头文件、HAL驱动和LL驱动文件。
- 用户程序文件：指用户在创建工程时需要引用或实现的文件。
驱动文件
设备头文件
| 名称 | 描述 |
|---|---|
| gr55xx.h |
GR55xx系列芯片公共头文件，包括各子系列芯片的头文件，部分公共宏定义及枚举声明，例如：flag_status_t，SET_BIT(REG, BIT)，以及gr55xx_hal.h。 |
| gr551xx.h |
GR551x系列处理器的头文件，包含该处理器所有的外设控制寄存器结构体的声明和外设声明的结构体定义以及宏定义。 |
HAL驱动文件
GR551x的HAL层驱动文件的包含关系如图 2所示：
HAL驱动文件描述如表 2：
| 名称 | 描述 |
|---|---|
| gr55xx_hal_conf.h |
HAL驱动的配置文件，包含所有外设驱动的HAL头文件，开发者可通过修改该文件指定需要编译的外设模块以及其它的配置参数。 |
| gr55xx_hal_ppp.h |
各个模块HAL驱动的头文件，包含驱动API函数的声明、结构体类型声明、枚举声明、宏定义等，例如：gr55xx_hal_uart.h。 |
| gr55xx_hal_ppp.c |
各个模块HAL驱动的源文件，包含驱动API函数的实现，例如：gr55xx_hal_uart.c。 |
| gr55xx_hal_ppp_ex.h |
部分模块驱动程序的扩展功能的头文件，包含只有部分芯片支持的扩展功能的API函数声明，例如：gr55xx_hal_gpio_ex.h中包含了引脚复用的相关定义。 |
| gr55xx_hal_ppp_ex.c |
部分模块驱动程序的扩展功能的源文件，目前暂未实现。 |
| gr55xx_hal.h |
HAL驱动的公共头文件，包含了hal_init接口以及Tick相关函数，开发者在应用中包含该文件后，即可以使用GR551x的HAL驱动，该文件在用户应用与HAL驱动之间起桥接作用。 |
| gr55xx_hal.c |
HAL驱动的公共源文件，包括hal_init接口、Tick相关接口实现（weak类型，可根据需要进行重定义）。 |
| gr55xx_hal_msp_template.c |
hal_ppp_msp_init()和hal_ppp_msp_deinit()接口实现的模板，可对所有外设的Msp接口进行统一配置，其中hal_ppp_msp_init()在hal_ppp_init()中进行调用，主要进行相应模块GPIO复用、时钟、DMA、中断的配置。 |
| gr55xx_hal_def.h |
HAL驱动类型定义文件，包含公共宏的定义，结构体、枚举的声明，以及部分编译器相关的定义，如hal_status_t等。 包含所有外设驱动使用的通用数据类型及常量。 |
ppp：表示外设名称，如gpio、qspi、uart等。
LL驱动文件
LL驱动文件描述如表 3：
| 名称 | 描述 |
|---|---|
| gr55xx_ll_ppp.h |
各个模块LL驱动的头文件，包含LL驱动的宏定义、结构体声明、以及LL驱动寄存器访问的内联接口实现，例如：gr55xx_ll_gpio.h。 |
| gr55xx_ll_ppp.c |
各个模块LL驱动的源文件，包含LL驱动的init及deinit接口，例如：gr55xx_ll_gpio.c。 |
用户程序文件
用户程序文件描述如表 4：
| 名称 | 描述 |
|---|---|
| system_gr55xx.c |
包含SystemInit实现，在系统复位后进行系统初始化，目前也在该文件进行系统时钟配置。 |
| startup_gr55xx.s |
GR551x系列芯片的启动文件。 |
| gr55xx_hal_msp.c |
可选文件，用于统一放置各外设驱动模块的msp_init()及msp_deinit()接口，使用外设较少时也可放于main.c文件。 |
| gr55xx_it.c/.h |
可选文件，用于统一放置各个外设的中断处理函数，使用外设较少时也可直接放于main.c文件。 |
| main.c/.h |
主函数及头文件。 |
