STC8H開發(一): 在Keil5中配置和使用FwLib_STC8封裝庫(圖文詳解)

本文轉載自查看原文 2022-01-05 14:00 5977 Embed/Mobile/ Linux/ MCS-51/ STC8G/ FwLib_STC8/ STC8H

介紹

FwLib_STC8 是一個針對STC8G, STC8H系列MCU的C語言封裝庫, 適用於基於這些MCU的快速原型驗證.

項目地址: Gitee FwLib_STC8
鏡像地址: GitHub FwLib_STC8

為避免之前STC12封裝庫存在的問題, 這個封裝庫在以下方面進行了改進

兼容SDCC和Keil C51
FwLib_STC12封裝庫只支持SDCC編譯, 並且寄存器命名與官方不同, 使得基於FwLib_STC12的項目代碼與其他Keil開發的項目代碼無法兼容. 在FwLib_STC8的開發上, 采用了與官方庫文件一致的命名, 並且增加了對Keil C51和SDCC的適配. 基於FwLib_STC8的項目, 可以在Linux下使用SDCC編譯, 也可以在Windows下使用Keil C51環境進行編譯.
減小代碼尺寸
FwLib_STC12封裝庫較多使用函數的方式對寄存器進行封裝, 而函數與函數間的層級調用都會增加棧開支, 這樣一方面8位MCU本來就不多的內存更加捉襟見肘, 另一方面增加了生成的固件尺寸. 在FwLib_STC8封裝庫中, 大量使用宏語句對寄存器操作進行封裝, 並且控制方法間的層級調用深度, 有效節省了固件體積和堆棧占用.

以下介紹在Windows下Keil55開發環境的搭建

配置Keil5開發環境運行演示用例

前提

已經安裝完成Keil5, 並配置好STC的插件, 如果未完成, 請自行搜索網上的教程和說明
(可選)本機安裝了Git並且可以在命令行下使用git命令

1. 創建項目目錄

在文件瀏覽器中, 創建項目目錄, 建議目錄路徑中不要有中文和空格, 例如本例使用路徑

2. 創建Keil5項目

打開Keil5, 點擊 Project -> New uVision Project, 在彈出的對話框中, 選擇剛才創建的目錄, 填入項目名稱, 點擊保存

3. 選擇MCU型號

剛才的保存點擊后, 會彈出MCU選擇對話框, 在里面選擇STC MCU Database,

在下面的列表中選擇自己型號的那款, 點擊OK保存. 如果沒有完全匹配的型號, 則選擇同樣系列中, 內存數量一致的型號, 例如我使用的是STC8H3K32S2, 在列表中沒有此項, 就選用同樣是STC8H系列3K內存的STC8H3K64S4

會彈出一個對話框問是否復制STARTUP.A51, 點Yes

4. Keil5 項目結構

Keil5項目就已經創建完成, 這時候其實就已經可以添加官方的頭文件, 直接用寄存器進行開發了

項目的目錄結構為

stc8h_demo/
|
│  STARTUP.A51
│  stc8h_demo.uvproj
├─Listings
└─Objects

5. 下載FwLib_STC8

可以通過git clone導出項目代碼, 或者直接下載zip包解壓

方式一: 通過git導出
在命令行下執行

# github
git clone https://github.com/IOsetting/FwLib_STC8.git FwLib_STC8
# 或者giteee
git clone https://gitee.com/iosetting/fw-lib_-stc8.git FwLib_STC8

方式二: 下載zip包后解壓
訪問這篇文章頂部的項目鏈接, 在頁面上, 點擊"克隆/下載" 下載ZIP, 並解壓成目錄

6. 將FwLib_STC8放入項目目錄

將上一步得到的目錄, 復制到Keil5項目的目錄下, 復制完成后的項目目錄結構如下

stc8h_demo/
|
│  STARTUP.A51
│  stc8h_test003.uvproj
├─FwLib_STC8
│  ├─demo
│  ├─include
│  └─src
├─Listings
└─Objects

在文件系統中的目錄列表

7. 在Keil5中添加封裝庫庫

通過菜單點開Project -> Manage -> Project Items, 或者直接從圖標欄點擊對應的圖標,

打開文件管理對話框, 在Groups中增加一項, 名稱"FwLib_STC8", 這個可以根據需要自己改成別的名稱也可以, 點中這個新增加的Group, 在右側那列點擊下面的Add Files, 會彈出一個文件選擇對話框

在文件選擇對話框中瀏覽到FwLib_STC8\src, 全選全部c文件(可以使用Ctrl+A), 點Add, 然后點Close,

可以看到文件都已經添加進來了

8. 在Keil5中添加演示用例

保持上一步的窗口不動, 點擊選中Source Group 1, 在右側那列點擊下面的Add Files, 會彈出一個文件選擇對話框

瀏覽到 FwLib_STC8\demo\uart, 選中uart1_timer1_tx.c, 這是一個用定時器1做波特率時鍾源的串口1測試樣例

添加之后, 可以看到增加了對應的文件, 點擊OK保存

可以看到, 剛才添加的文件都已經出現在項目樹結構中

9. 在Keil5中對項目進行配置

直接對剛才的項目結構進行編譯是不行的, 還需要配置一下環境變量, 通過菜單點開Project -> Options for Target ... , 或者直接從圖標欄點擊項目選項圖標

打開選項對話框

如上圖, 選中C51標簽頁, 在"2"標識的輸入框中, 輸入

__CX51__, __CONF_MCU_MODEL=MCU_MODEL_STC8H3K32S2,__CONF_FOSC=36864000UL

對上面各項的說明

__CX51__ 是將當前編譯環境配置為C51
__CONF_MCU_MODEL, 這里設置對應的MCU型號, 當前使用的型號為MCU_MODEL_STC8H3K32S2, 如果你的芯片不是這個, 需要修改成對應的型號, 具體的型號可以在FwLib_STC8/include/fw_conf.h中查找. 注: STC8G只列了大型號, 只需要填大型號即可.
__CONF_FOSC 是這個程序運行時將使用的振盪頻率, 取決於你用STC-ISP燒錄時會用什么頻率, 在這里填入對應的數字, 最后的UL代表這個數字是無符號長整數

然后點擊"3", 在彈出的對話框中, 選中FwLib_STC8/include 目錄, 這里是配置封裝庫的頭文件路徑.