Android NDK CPU Features detection library: （cpufeatures）

Android NDK CPU Features detection library:

-----------------------------------------------------------

NDK 提供了一个很小的库叫着“cpufeatures”，可用于运行时检测目标设备的CPU类型和它支持的可选功能。

用法：

--------

这个库是作为一个import module来使用的。为了使用它，你必须：

 * 在静态库依赖的列表中列出‘cpufeatures’，如：

LOCAL_STATIC_LIBRARIES := cpufeatures

 * 在Android.mk的尾部，导入‘android/cpufeatures’模块，如：

$(call import-module, android/cpufeatures)

 * 在源代码中，导入头文件<cpu-features.h>。

下面有一个例子：

<project-path>/jni/Android.mk:    

              LOCAL_PATH :=$(call my-dir)  

              include$(CLEAR_VARS)    

              LOCAL_MODULE :=<your-module-name>    

              LOCAL_SRC_FILES:= <your-source-files>    

              LOCAL_STATIC_LIBRARIES:= cpufeatures    

              include$(BUILD_SHARED_LIBRARY)  

              $(callimport-module,android/cpufeatures)

功能:

-------------

现在提供了两个函数：

AndroidCpuFamily   android_getCpuFamily();

返回目标设备CPU类型的枚举值。目前，支持的类型只有ANDROID_CPU_FAMILY_ARM。

   uint64_t   android_getCpuFeatures();

返回目标设备CPU支持的可选功能的集合。返回的结果是bit-flags的集合，每一位对应一个CPU特定类型的可选功能。

目前，对于ARM CPU家族，只有下面的这些flags被定义：

ANDROID_CPU_ARM_FEATURE_ARMv7

表明设备的CPU支持ARMv7-A指令（通过“armeabi-v7a”abi设置，请查看CPU-ARCH-ABIS相关内容），这对应于Thumb-2和VFPv3-D16指令。

     ANDROID_CPU_ARM_FEATURE_VFPv3

表明目标设备CPU支持VFPv3的硬件FPU指令集扩展。由于‘armeabi-v7a’的定义，如果ANDROID_CPU_ARM_FEATURE_ARMv7返回，它将永远保持这样。

注意，这对应最低配置的VFPv3-D16，只提供16个硬件FP寄存器。

      ANDROID_CPU_ARM_FEATURE_NEON

表明设备的CPU支持ARM高级SIMD（又称NEON）矢量指令集扩展。注意ARM授权实现了VFPv3-D32的CPUs，VFPv3-D32提供了32个硬件浮点寄存器（共享NEON单元）。

下面这些flags是针对x86 CPU家族的：

ANDROID_CPU_X86_FEATURE_SSSE3

表明目标设备支持SSSE3指令集扩展。注意这个和需要x86NDK ABI的SSE3不同。

      ANDROID_CPU_X86_FEATURE_POPCNT

            表明目标设备支持POPCNT指令。

      ANDROID_CPU_X86_FEATURE_MOVBE

表明目标设备支持MOVBE指令。像Atom，这个特定于一些Intel IA-32 CPUs。

下面这个函数被定义为，返回目标设备CPU内核的最大个数：

int  android_getCpuCount(void);

重要提示：

----------------

在以后的版本中，cpufeatures库会支持更多的CPU种类和可选功能，它已经正式被设计成为所有官方Android平台版本的一部分了。

修改历史：

----------------

请查看$NDK/sources/android/cpufeatures/cpu-features.c里面的注释，了解这个库完整的修改历史记录。