单片机项目如何添加版本信息？

关注+星标公众号，不错过精彩内容

作者 | strongerHuang

微信公众号 | strongerHuang

最近有粉丝在问：单片机项目如何添加软件的版本信息？

软件的版本信息我们都知道，比如：V1.0.0

针对单片机项目，我们需要管理软件版本，包括源代码，以及单片机固件（hex、bin等）。

源代码软件版本

你们平时怎么管理软件的源代码版本？

压缩打包？不会是这样吧?

压缩打包这种方法不是不行，后续查阅变更有点麻烦。

对于有一定管理能力的公司，最好还是上软件版本工具，比如：SVN、Git等。

早期我们用SVN比较多，后面用Git，这两个常用的工具不难，网上教程很多。

固件版本

单片机固件，通常指的是hex、bin这种可执行文件。

1、固件名称版本

固件（hex、bin）的名称，可以通过自动配置自动编译生成。

这里可以参看我之前分享的文章：Keil定制Hex文件名实现的方法

2、固件中添加版本信息

我们要在单片机产品中读取软件版本的信息，就需要在固件中加入版本信息。（量产发货的设备比较多，全国各地、不同版本的情况下，很有必要加入版本信息。不然，某台设备出现bug，都不知道是哪个版本的软件）

下面就分享一个最常用，也是最基础的小技巧：在Keil MDK环境下，通过软件代码，直接映射到并存储到Flash指定地址。

包含：软件版本、编译日期、编译时间，代码如下：

#define VERINFO_ADDR_BASE   (0x0800FF00) //存放FLASH的地址
constchar Software_Ver[] __attribute__((at(VERINFO_ADDR_BASE + 0x00)))  = "Software: 1.0.0";constchar Compiler_Date[] __attribute__((at(VERINFO_ADDR_BASE + 0x40))) = "Date: "__DATE__;constchar Compiler_Time[] __attribute__((at(VERINFO_ADDR_BASE + 0x60))) = "Time: "__TIME__;

这个代码大家能看懂么？ 其实就是把这串信息（编译时自动生成日期和时间）写入Flash。
写成功之后，我们读取对应地址，即可看见该版本信息，比如：

原理很简单，也有类似其他写入Flash地址的方法（这里暂不讲述）。

这里面包含几个重要知识点，下面给大家描述一下。

a.__attribute__ 语法

attribute，翻译为“属性”，在C语言中，是一个关键字，语法格式为：

__attribute__ ((attribute-list))

__attribute__ 可以设置函数属性（Function Attribute ）、变量属性（Variable Attribute ）和类型属性（Type Attribute ）。

这部分内容，大家可以不用深入理解，知道这么用即可。要深入理解，网上也有很多学习资源。

b.C语言标准定义

在代码中：

constchar Compiler_Date[] __attribute__((at(VERINFO_ADDR_BASE + 0x40))) = "Date: "__DATE__;constchar Compiler_Time[] __attribute__((at(VERINFO_ADDR_BASE + 0x60))) = "Time: "__TIME__;

你会看到__DATE__ 和 __TIME__表示的日期和时间。

其实，这两个是C语言特殊的标准定义。

__DATE__：编译时刻的日期字符串 如“Apr 13 2021”__TIME__：编译时刻的时间字符串  如”20:00:00“

除了这两个，其实还有很多类似的标准定义，比如：

__FILE__ ：正在编译文件的文件名__LINE__ ：正在编译文件的行号__STDC__：判断该文件是不是标准C程序

这部分内容，可以参看我的文章：C语言几种特殊标准定义和用法

c.总是编译版本文件

在Keil MDK中，默认情况下，源文件不修改，只编译一次。

因此，为了编译版本、日期和时间正确，需要进行设置：总是编译。

如下设置：