FwLib_STC8轻量级固件库安装与配置完全指南

项目基础介绍

FwLib_STC8 是一个专为 STC8G/STC8H 系列微控制器设计的轻量化固件库。该库旨在提供简洁易用的接口来访问芯片资源，同时优化了在资源受限的8位微控制器上的性能。它支持SDCC（Small Device C Compiler）和Keil C51编译器，并且遵循Apache 2.0开源许可协议，适用于商业及个人项目。

主要编程语言:

• C
• 部分配置文件使用Makefile

关键技术和框架

技术要点

• 兼容性: 支持SDCC与Keil C51两种编译环境。
• 资源优化: 适合8位MCU的内存和闪存限制。
• 易用性: 提供快速入门的示例代码和Makefile配置。
• 跨编译器宏定义: 包含用于兼容不同编译器的宏定义，确保代码的通用性。

框架特点

• 模块化结构: 分为include, src, 和 demo目录，便于理解和扩展。
• 预处理配置: 通过预处理器宏来适配不同的MCU型号和配置。

安装和配置步骤

准备工作

1. 安装Git: 确保你的计算机上已安装Git，用于克隆项目源码。
2. 开发环境: 根据你的选择准备SDCC或Keil C51开发工具链。
   • 对于SDCC, 安装最新版本并确保路径配置正确。
   • 对于Keil C51, 需要有效的许可证或评估版。

克隆项目

1. 打开终端或命令提示符。
2. 使用以下命令克隆仓库到本地：

   git clone https://github.com/IOsetting/FwLib_STC8.git
   

   或者对于国内用户，可选择Gitee镜像：

   git clone https://gitee.com/iosetting/fw-lib_-stc8.git
   

配置与编译（以SDCC为例）

修改Makefile

1. 进入项目根目录下的FwLib_STC8。

2. 找到Makefile，根据你的目标MCU型号修改相应的配置项。例如，对于STC8H1K08，需调整如下：

   MCU      = STC8H1K08
   MCU_IRAM = 256
   MCU_XRAM = 1024
   MCU_CODE_SIZE = 8192
   TOOCHAIN_PREFIX = /path/to/sdcc/bin/
   

   其中TOOCHAIN_PREFIX应指向你的SDCC编译器路径。

3. 添加必要的编译标志，如果适用，进行频率和其他配置。

编译与运行

1. 清除旧构建:

   make clean
   

2. 开始编译：

   make
   

   成功后，你会得到编译好的.hex文件，可以进一步烧录至微控制器。

Keil C51用户配置

1. 同样克隆项目到本地。
2. 将整个FwLib_STC8复制到你的Keil项目目录下。
3. 在Keil项目中添加FwLib_STC8目录下的所有文件到项目中。
4. 在Project -> Options for Target 中设置预处理器符号，如：
   • 在C51标签页下的Define框内添加：__CX51__, __CONF_MCU_MODEL=MCU_MODEL_STC8H3K32S2, __CONF_FOSC=36864000UL等。
5. 确保Keil C51编译器设置正确，然后编译项目。

注意事项

• 对于VS Code用户，可能需要配置额外的环境或插件来解决语法高亮问题，并在platformio.ini或Makefile中定义特定的编译标志。
• 确保检查官方文档和Readme文件中的最新更新和特别说明。

通过以上步骤，不论是SDCC还是Keil C51的开发者，都可以顺利地配置并使用FwLib_STC8库来进行STC8系列微控制器的开发。