首发：裸机思维
作者： GorgonMeducer 傻孩子
【说在前面的话】
认真说起来，从事嵌入式系统开发职业的“玩家”们基本都听说过CMSIS吧？虽然不清楚它在系统中具体“有什么卵用”，但或多或少都接受过“CMSIS的毒打”——不知不觉间，达成了对应的“成就”——假如“地球Online的嵌入式职业”真的有成就系统的话。
今天我们就来细数与CMSIS相关的几个成就，及其达成攻略。
【入门成就：未闻花名】
达成条件：
从事嵌入式工作至少2年以上，之前从未听说过，也没有真正注意到自己所使用的工程或者环境中用到了CMSIS；突然有一天，第一次听说CMSIS时获得该成就。
获得难度：⭐️
稀有度： ⭐️
点评：
该成就看似触发条件比较苛刻——需要工作至少2年以上没有注意到过CMSIS的存在——但实际上，这几乎是大部分新手玩家的标配成就。反倒是少数“内测高玩”（指在学校期间就已经是嵌入式大牛的人），因为过早接触CMSIS而受到时间门槛的限制无法获得该成就。
【新手成就：几……室同堂？】
达成条件：
玩家第一次尝试使用MDK的RTE（Runtime Environment）配置方式往工程中加入CMSIS的支持时，没有注意到工程里已经有了老版本的CMSIS，两个版本由于编译时产生冲突，导致玩家抓耳挠腮——“明明正确配置了CMSIS，路径也正确，为什么说我编译错误呢？果然是RTE太高档了，我用不来”——时，获得该成就。
获得难度：⭐️
稀有度： ⭐️
点评：
该成就一般在获得了【未闻花名】成就不久后就会获得，然而经过笔者多方求证发现：【未闻花名】并非【几……室同堂？】的前置成就。证据就是，有不少“内测高玩”在没有【未闻花名】成就的前提下早早的就达成了该成就。
由于通过RTE方式使用CMSIS是Arm官方之前一直推荐的正统方式，而该成就通常是在玩家第一次采用该方法时触发，因此一般认为是一个“新手成就”，获取难度较低。
如果你还没有获得该成就，可以尝试购买国内的某些知名开发套件，比如“某原子”、“某野火”的开发板，在使用其配套例程时有大概率触发该成就。
在触发该成就后，要想工程正确编译并不困难。通常只要把工程配置界面下、配置头文件搜索路径的 Include Paths 做必要的清理——删除老版本CMSIS的头文件路径即可，比如下图的例子中："..\CORE" 就是一个老版本CMSIS常见的栖息之地。
【稀有成就：未曾设想的道路】
达成条件：
玩家因为某种原因，第一次在MDK以外的环境，或是不借助MDK的RTE帮助的情况下，尝试将CMSIS加入到自己的工程中，以源代码形式进行编译引发“海量”编译错误时获得该成就。
获得难度：⭐️⭐️⭐️
稀有度： ⭐️⭐️⭐️⭐️
点评：
对大部分玩家来说，毫无疑问，该成就是一个“稀有”成就——因为无论是借助MDK的RTE辅助，还是使用方案供应商“保姆式”SDK进行开发，基本上不太会需要自己往工程里添加CMSIS，就算有，使用源代码进行编译的情况也是少之又少。通常只有团队里的骨灰级玩家才会“被迫”获得该成就。
前面提到的“海量”编译错误，实际上由于CMSIS中诸如CMSIS-DSP这样的库，为了提升代码性能，采用了“在.c中包含其它.c”的做法而触发的，比如 _CMSIS-DSP _中很多目录就如 _InterpolationFunctions_ 这样存在多个.c，
而他们实际上都被 _InterpolationFunctions__.c _文件统一包含：
如果一股脑的把该目录下的所有.c都加入到 MDK 工程中编译，就会在链接阶段报告大量的重复定义类错误。
由于在“.c”中包含其它".c"来提升编译后代码的工作效率对大部分人来说是一个“未曾设想过的道路”，该成就也因此得名——对此“骚操作”有所疑问的小伙伴，可以通过我的文章《真刀真枪模块化（3.5）——骚操作？不！这才是正统》来一探究竟。
【稀有成就：吃螃蟹爱好者】
达成条件：
第一次通过MDK的Pack Installer将从Github上获取最新的、尚未正式发布的CMSIS版本导入到MDK开发环境，并通过RTE部署到当前工程中时获得该成就。
获得难度：⭐️
稀有度： ⭐️⭐️⭐️⭐️⭐️
点评：
虽然MDK的用户很多，会用RTE的用户已然很少，其中懂得利用Pack Installer更新软件包的用户就更少，而知道Pack Installer可以导入Git库并以此来使用Github上最新的CMSIS的用户几乎就是凤毛麟角了。虽然操作起来难度很小，但该成就的稀有度却是满星的。
具体获取方式：
如果你的MDK版本较老，同时因为某些原因又不想更新MDK版本，可以通过Pack Installer导入仓库的办法获取最新的CMSIS。具体步骤如下：
1、通过git工具将最新版本的CMSIS从https://github.com/ARM-softwa...\_5 的_develop_ 分支下载到本地。比如，我使用的工具就是Github Desktop：
2、打开Pack Installer，并通过菜单File->Manage Local Repository 打开仓库管理窗口：
3、单击Add，并把刚刚从Github上获取的CMSIS加入仓库中：
4、成功后，我们会看到最新的CMSIS已经被加入到Pack列表中了：
此时，单击OK。经过一番等待，我们发现最新的CMSIS 5.8.0（还没有正式发布哦）已经被加入到我们的MDK环境中了：
（图片来自网络，侵删）
【阴间成就：内卷的开端……】
达成条件：
第一次注意到CMSIS提供的“固有函数（Intrinsics）” \_\_disable\_irq()在不同编译器下有不同的函数原型时，获得该成就。
获得难度：⭐️⭐️⭐️⭐️
稀有度： ⭐️⭐️⭐️⭐️⭐️
点评：
CMSIS号称支持多个不同的编译器：Arm Compiler 5（armcc）、Arm Compiler 6（armclang）、LLVM、GCC和IAR。一般用户需要通过包含头文件_cmsis\_compiler.h_ 来获得统一的“固有函数”和软件基础设施。
#include "cmsis_compiler.h"实际上，头文件_cmsis\_compiler.h_ 的作用就是：自动检测当前用户所使用的编译器，并以此为依据包含对应的头文件。例如，如果当前用户使用的是_armclang_，则_cmsis\_compiler.h_会实际包含_ cmsis\_armclang.h_；同理，如果编译环境是_GCC_，对应的头文件就为 _cmsis\_gcc.h_。
/* * Arm Compiler 4/5 */
#if defined ( __CC_ARM )
#include "cmsis_armcc.h"
/* * Arm Compiler 6.6 LTM (armclang) */
#elif defined (__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) && (__ARMCC_VERSION < 6100100)
#include "cmsis_armclang_ltm.h"
/* * Arm Compiler above 6.10.1 (armclang) */
#elif defined (__ARMCC_VERSION) && (__ARMCC_VERSION >= 6100100)
#include "cmsis_armclang.h"
/* * GNU Compiler */
#elif defined ( __GNUC__ )
#include "cmsis_gcc.h"
/* * IAR Compiler */
#elif defined ( __ICCARM__ )
#include <cmsis_iccarm.h>
...仔细对比会发现，一般来说，固有函数 _\_\_disable\_irq()_是没有返回值的（或者说返回值是void），比如：
/**
\brief Disable IRQ Interrupts
\details Disables IRQ interrupts by setting special-purpose register PRIMASK.
Can only be executed in Privileged modes.
*/
/* intrinsic void __disable_irq(); */然而，我们在arm\_compact.h（包含cmsis\_armclang.h时获得）中发现了完全不同的函数原型：
static __inline__ unsigned int __attribute__((__always_inline__, __nodebug__))
__disable_irq(void) {
...
}它居然是有返回值的，而且返回的是关闭全局中断前一刻PRIMASK的值——这完全是抢了固有函数_\_\_get\_PRIMASK()_ 的工作啊！更可怕的是，CMSIS这么多对不同编译器提供支持的头文件中，只有armclang在“加班”，甚至让习惯了使用armclang的傻孩子我产生了_\_\_disable\_irq()_就应该返回PRIMASK值的错觉——像极了公司团队“从一人开始内卷到全团队加班称为常态”的社畜生活，真实细思恐极啊。
好消息是，这一问题在CMSIS 5.8.0中（是的，还没发布）得到了修正：从此以后，所有_\_\_disable\_irq()_ 明确不会有返回值，而且同类的固有函数_\_\_disable\_fiq() _也不再允许内卷。
考虑到会跨平台开发项目的玩家屈指可数，该成就基本上属于非常“阴间”了——稀有度五星；考虑到敢怀疑CMSIS“不合理”的玩家并不多见，而且吃的太饱有耐心会去比较不同版本下固有函数定义是否存在不同的人更是少之又少，因此，我给该成就的获得难度判定为4星。
【写在后面的话】
最近因为在开源社区交流 arm-2d 的时候，深感CMSIS在使用上的坑实在是太多了，几乎每一个都值得为之设立一个成就——特此吐槽，望诸君点赞、收藏、转发三连！阅读过万，还有下篇。
专栏推荐文章
如果你喜欢我的思维，欢迎订阅裸机思维
版权归裸机思维（傻孩子图书工作室旗下公众号）所有，
所有内容原创，严禁任何形式的转载。
