# STC8系列固件函数库

**Repository Path**: egosum/STC8x-FWLIB

## Basic Information

- **Project Name**: STC8系列固件函数库
- **Description**: STC8系列MCU固件函数库，是我们针对其丰富的内部资源基于keil编写的软件包。函数库提供了大量标准的API函数，供使用者访问底层硬件细节。函数库的大小支持裁剪，同时在代码密度和执行效率上做了很好的平衡。
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: laster
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 55
- **Created**: 2021-02-04
- **Last Updated**: 2021-02-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 开发文档简介



STC8系列MCU固件函数库（以下简称固件库），是我们针对其丰富的芯片资源，基于keil C51编写的软件包。函数库除了提供了大量标准的API函数，供使用者访问底层硬件细节。还定义了一套裸机编程的框架，帮助开发者快速高效上手；同时函数库的大小支持裁剪，并且在代码密度和执行效率上进行了很好的平衡。

为考虑函数库的兼容性，在编写规则及注释上面选择了全英文的方式，若开发者不习惯全英文，可以通过库函数提供的开发者文档了解API函数的具体使用方法，我们在文档里提供了详细丰富的中文注解和说明。

函数库遵循 Apache 许可证 2.0 版本，可免费在商业产品中使用，不需要公布应用程序源码，没有潜在商业风险。



配套核心板购买连接（待上架）

[下载连接(最新版)](https://gitee.com/zeweni/STC8x-FWLIB)

[开发指南视频链接](https://www.bilibili.com/video/BV1EU4y1s736?from=search&seid=5098754810768350553)



作者微信：**ze_wenu**

B站账号：**泽文i**



当前版本为：1.0.0

版本更新时间：2021.01.24



# 固件库介绍



**首先说明：** 本库基于Keil C51-v960a版本开发，有一定的向下兼容性，但对KEIL4不兼容。为了保证正常使用函数库，请使用相同或更高版本的Keil进行开发。



函数库经过几个版本的迭代，已经建立起一个较为完备的体系。函数库分为三部分：外设库、设备驱动库、组件库。其中外设库（主要指片内外设）是核心部分。每一个组成库都有一个头文件来链接库下面所有的模块，最后三个库通过一个总的头文件来链接所有的文件，以此来外向用户开放使用。



目前外设库是功能和稳定性最为完整的一个部分，作为库的核心部分，可以提供稳定的开发。同时，我们提供了组件库和驱动库，这两个会在后续慢慢完善，增加许多实用好用的模块。



函数库的结构组成，是一个比较好的裸机框架，非常适合8位单片机开发，用户可以根据自己的需求，进行增添和裁剪。



##### 库文件结构如下

````C
libraries
    |----core
    |----peripheral
    |		|----STC8A
    |		|----STC8F
    |		|----STC8G
    |       |----STC8H
    |       |----...
    |----component
    |       |----TMT
    |       |----...
    |----drive
    |       |----keyScan
    |       |----OLED
    |       |----...
````



整个固件库，充分利用了keil的一些特性，比如使用LX51扩展链接器/定位器，优化了BL51的功能，可以生成更小的目标文件等。