c语言 include “sys.h“介绍

#include "sys.h" 是在嵌入式系统开发中常见的一条预处理指令。这个头文件一般是由开发者或开发团队根据项目需求自定义的，用于包含系统相关的定义和声明。其具体内容和作用会因项目而异，但通常包括以下方面：

1. 系统级配置

• 系统时钟设置：定义系统时钟频率及其配置函数。
• 外设初始化：包含外设的初始化函数声明，如 GPIO、USART、SPI 等。

2. 宏定义

• 通用宏：如常用的位操作宏、类型定义、系统状态宏等。
• 项目特定宏：根据项目需求定义的一些特定功能宏。

3. 函数声明

• 初始化函数：如系统初始化、时钟配置、外设初始化等函数声明。
• 中断服务函数：中断处理函数的声明及其注册。

4. 常量定义

• 系统常量：如系统时钟频率、外设基地址、引脚定义等。
• 项目常量：与具体应用相关的常量。

实例

典型的 sys.h 文件如下：

#ifndef __SYS_H
#define __SYS_H

#include "stm32f10x.h"  // 包含 STM32F10x 的硬件定义

// 系统时钟配置
#define SYSCLK 72000000  // 系统时钟频率 72 MHz

// 通用宏定义
#define BITBAND(addr, bitnum) ((addr & 0xF0000000) + 0x2000000 + ((addr & 0xFFFFF) << 5) + (bitnum << 2))
#define MEM_ADDR(addr) *((volatile unsigned long *)(addr))
#define BIT_ADDR(addr, bitnum) MEM_ADDR(BITBAND(addr, bitnum))

// GPIO 基地址定义
#define GPIOA_ODR_Addr (GPIOA_BASE + 12)  // 0x4001080C
#define GPIOB_ODR_Addr (GPIOB_BASE + 12)  // 0x40010C0C
#define GPIOC_ODR_Addr (GPIOC_BASE + 12)  // 0x4001100C

// GPIO 位带操作示例
#define PAout(n) BIT_ADDR(GPIOA_ODR_Addr, n)  // 输出
#define PAin(n)  BIT_ADDR(GPIOA_IDR_Addr, n)  // 输入

// 函数声明
void SystemInit(void);
void GPIO_Config(void);
void USART_Config(void);

#endif

解释

1. 预处理指令和宏定义：

   • #ifndef, #define, #endif：防止重复包含。
   • 包含了 stm32f10x.h 以访问 STM32F10x 的寄存器和外设定义。
   • 定义了系统时钟频率 SYSCLK。
   • 提供了一些常用的位带操作宏，如 BITBAND、MEM_ADDR 和 BIT_ADDR。

2. GPIO 基地址：

   • 定义了 GPIOA、GPIOB 和 GPIOC 的输出数据寄存器 (ODR) 地址。

3. GPIO 位带操作：

   • 通过 PAout(n) 和 PAin(n) 宏，可以方便地进行 GPIO 位操作。

4. 函数声明：

   • 声明了系统初始化、GPIO 配置和 USART 配置等函数。

总结

sys.h 文件是一个项目特定的头文件，包含了系统级的配置和常用的宏定义、函数声明等，使代码更具组织性和可维护性，提供了一个集中的地方来管理与系统相关的设置和功能。具体内容会根据项目的需求有所不同，但通常包含系统初始化、外设配置、宏定义等。