1# CPU特性
2
3
4CPU特性是CPU提供的一些硬件扩展。开发者可以通过调用指令，设置特殊寄存器来使用这些CPU特性，例如ARMv7a架构上的VFP-v32d32、NEON、IDIV、AES等CPU特性。很多CPU特性是可选的，不同厂商的CPU通常有不同的特性。
5
6
7在OpenHarmony原生库开发中，如何使用CPU特性？如何在代码中处理CPU特性相关的代码？本章节将提供一些方法，以便帮助开发者开发出既能保持兼容性，又能利用CPU特有能力的应用。
8
9
10OpenHarmony系统当前没有提供获取CPU特性的接口，开发者可以导入现有开源社区的库函数，具体可以参考如下的例子；也可直接读取/proc/cpuinfo，或者调用libc getauxval(AT_HWCAP)接口来获取设备的CPU特性。
11
12
13## 使用建议
14
151. 在OpenHarmony系统C++工程中引入开源库，下载[cpu_features库](https://github.com/google/cpu_features)，解压到工程的cpp目录下。如下以IDE C++模版示例应用举例：
16   - 解压后目录结构如下
17      ```
18      MyApplication
19        |-- entry
20         |-- src
21              |-- main
22                   |-- cpp
23                       |--cpu_features
24                       |--CMakeLists.txt
25                       |--hello.cpp
26      ```
27   - 在CMakeLists.txt添加导入目录
28      ```makefile
29      add_subdirectory(cpu_features) # 添加子目录到工程
30      target_link_libraries(entry PUBLIC CpuFeature::cpu_features) # 添加需要链接依赖的库文件
31      ```
32
332. 在代码中加入判断CPU特性支持能力语句，如下以支持ARM与AARCH64两种架构举例：
34   ```c++
35   ...
36   // 包含CPU架构目标检测头文件
37   #include "cpu_features_macros.h"
38   // 在ARM架构上，这个宏在上面头文件中根据目标自动定义
39   #if defined (CPU_FEATURES_ARCH_ARM)
40   #include "cpuinfo_arm.h" // 包含ARM架构的cpuinfo头文件
41   #elif defined (CPU_FEATURES_ARCH_AARCH64)
42   #include "cpuinfo_aarch64.h" // 包含ARM64架构的cpuinfo头文件
43   #endif
44   // C++代码, 需要添加`using namespace cpu_features;`
45   // 根据不同架构，获取相应的CPU特性信息；
46   #if defined (CPU_FEATURES_ARCH_ARM)
47   static const ArmFeatures features = GetArmInfo().features;
48   #elif defined (CPU_FEATURES_ARCH_AARCH64)
49   static const Aarch64Features features = GetAarch64Info().features;
50   #endif
51   void Compute(void) {
52     // 根据features的字段进行支持CPU features的特性判断
53     if (features.aes) {
54       // ...
55     } else {
56       // ...
57     }
58   }
59   ```
60
61   > **说明：**
62   >
63   > cpu_features库实际上是通过/proc/cpuinfo，与getauxval接口从内核中读取对应的CPU特性信息，有可能由于应用沙盒的原因导致无法读取对应的信息，注意错误处理。
64