README for ID² Client SDK

IoT设备身份认证ID²（Internet Device ID），是一种物联网设备的可信身份标识，具备不可篡改、不可伪造、全球唯一的安全属性，是实现万物互联、服务流转的关键基础设施。

ID² Client SDK是用于设备端开发和调试，帮助开发者快速接入ID²开放平台。此SDK, 支持四种载体Demo, SE（Secure Element）, PUF（Physical Unclonable Function）和MDU（安全模组）：

• Demo载体：用于ID²设备端功能的演示，正式产品，需切换到安全载体（Soft-KM, SE, TEE）。
  
• SE载体：外挂安全芯片，ID²预烧录在SE芯片上。
  
• PUF载体：外挂安全芯片，ID²在PUF芯片内生成，ID和公钥注册到认证中心。
  
• MDU载体：安全模组，ID²密钥和SDK在模组中，主控通过A&T指令调用ID²的功能。

|—— app：加解密硬件适配（HAL）接口和ID²接口的测试程序。
|—— doc：相关文档，如ID²指令规范。
|—— include：头文件目录。
|—— makefile：总的编译脚本。
|—— make.rules：编译配置，可配置编译工具链和编译参数。
|—— make.settings：ID²配置，如调试信息、空发功能和载体选择。
|—— modules：ID²和ID²依赖的模块。
|—— sample：示例代码。

快速开始

描述在Ubuntu上编译和运行ID²Client SDK;其他编译环境，请参考makefile进行编译适配。

编译环境：

使用Ubuntu 14.04以上版本。

编译配置：

• make.rules：

    CROSS_COMPILE： 编译使用的工具链。
    CFLAGS：编译工具链的编译参数。
  

• make.settings：

    CONFIG_LS_ID2_DEBUG：ID²调试信息的开关。
    CONFIG_LS_ID2_OTP：ID²密钥在使用时动态下发功能的开关。
    CONFIG_LS_ID2_ROT_TYPE：ID²的安全载体的类型，SE|Demo|MDU|PUF。
    CONFIG_LS_ID2_KEY_TYPE：ID²的密钥类型，3DES|AES|RSA|ECC|SM1|SM2|SM4。
    CONFIG_LS_ID2_ECDP_TYPE：ID²的椭圆曲线参数，K-163|K-233|K-283|K-192|K-224|K-256。
  

    - K-163：sect163k1 <br />
    - K-233：sect233k1 <br />
    - K-283：sect283k1 <br />
    - K-192：secp192k1 <br />
    - K-224：secp224k1 <br />
    - K-256：secp256k1 <br />

编译SDK：

 在SDK目录，运行如下命令：

 $makeclean<br\mathrm{/}>make\; clean$ make

编译成功，生成的静态库和应用程序统一放在SDK的out目录。

运行程序：

在SDK目录，运行如下命令：

 ./out/bin/id2_app

测试成功（仅设备端接口测试，非真实交互验证），日志显示如下：

 
id2_client_get_id 649: ID2: 000FFFFFDB1D8DC78DDCB800
id2_client_generate_authcode 170:
============ ID2 Validation Json Message ============:
{
       “reportVersion”:        “1.0.0”,
       “sdkVersion”:   “2.0.0”,
       “date”: “Aug 23 2019 18:17:13”,
       “testContent”:  [{
               …….
               }]
}
id2_client_generate_authcode 186: =====>ID2 Client Generate AuthCode End.

其他：

更多文档，如设备端适配和自主验证，请查阅官网文档： https://help.aliyun.com/document_detail/101295.html