tencent cloud

本文档介绍如何将设备端 C-SDK 移植到目标硬件平台。C-SDK 采用模块化设计，分离核心协议服务与硬件抽象层，在进行跨平台移植时，一般只需对硬件抽象层进行修改适配即可。

C-SDK 架构

架构图

架构说明

SDK 分四层设计，从上至下分别为平台服务层、核心协议层、网络层、硬件抽象层。

• 服务层
  在网络协议层之上，实现了包括设备接入鉴权，设备影子，网关，动态注册，日志上报和 OTA 等功能。
• 协议层
  设备端和 IoT 平台交互的网络协议包括 MQTT/COAP/HTTP。
• 网络层
  实现基于 TLS/SSL（TLS/DTLS）方式，POSIX_socket（TCP/UDP）方式和 AT_socket 方式的网络协议栈，不同服务可根据需要使用不同的协议栈接口函数。
• 硬件抽象层
  实现对不同硬件平台的底层操作的抽象封装，需要针对具体的软硬件平台开展移植，分为必须实现和可选实现两部分 HAL 层接口。

硬件抽象层移植

HAL 层主要有几大块的移植，分别是 OS 相关的、网络及 TLS 相关的、时间及打印相关的、设备信息相关的。
SDK 在 platform/os 目录示例了 Linux、Windows、FreeRTOS 及 nonOS 四个场景的硬件抽象层实现，可以参考最相近的目录展开目标平台的移植。

OS 相关接口

网络及 TLS 相关的 HAL 接口

网络相关接口提供二选一的适配移植。对于具备网络通讯能力并且本身集成 TCP/IP 网络协议栈的设备，需要实现 POSIX_socket 的网络 HAL 接口，使用 TLS/SSL 加密通讯的还需要实现 TLS 相关的 HAL 接口。而对于 MCU+ 通用 TCP_AT 模组 的设备，则可以选择 SDK 提供的 AT_Socket 框架，并实现相关的 AT 模组接口。

基于 POSIX_socket 的 HAL 接口

其中 TCP/UDP 相关接口基于 POSIX socket 函数实现。TLS 相关接口依赖于 mbedtls 库，移植之前必须确保系统上有可用的 mbedtls 库。如果采用其他 TLS/SSL 库，可参考 platform/tls/mbedtls 相关实现进行移植适配。
UDP/DTLS 相关的函数仅在使能 COAP 通讯的时候才需要移植。

基于 AT_socket 的 HAL 接口
通过使能编译宏 AT_TCP_ENABLED 选择 AT_socket，则 SDK 会调用 network_at_tcp.c 的 at_socket 接口， at_socket 层不需要移植，需要实现 AT 串口驱动及 AT 模组驱动，AT 模组驱动只需要实现 AT 框架中 at_device 的驱动结构体 at_device_op_t 的驱动接口即可，可以参照 at_device 目录下的已支持的模组。AT 串口驱动需要实现串口的中断接收，然后在中断服务程序中调用回调函数 at_client_uart_rx_isr_cb 即可，可以参考 HAL_AT_UART_freertos.c 实现目标平台的移植。

时间及打印相关的 HAL 接口

设备信息相关的 HAL 接口

接入 IoT 平台需要在平台创建产品和设备信息，同时需要将产品及设备信息保存在设备侧的非易失存储介质。可以参考 platform/os/linux/HAL_Device_linux.c 示例实现。