本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
移植 TCP/IP 堆栈
本节提供移植和测试板载 TCP/IP 堆栈的说明。如果您的平台将 TCP/IP 和 TLS 功能分载到单独的网络处理器或模块,您可以跳过此移植部分并访问移植网络传输接口。
FreeRTOS+TCP
移植 FreeRTOS+TCP
FreeRTOS+TCP 是 FreeRTOS 内核的原生 TCP/IP 堆栈。有关更多信息,请参阅 FreeRTOS.org
先决条件
要移植 FreeRTOS+TCP 库,您需要以下信息:
-
包括供应商提供的以太网或 Wi-Fi 驱动程序在内的 IDE 项目。
有关设置测试项目的信息,请参阅为移植设置工作区和项目。
FreeRTOS 内核的经验证配置。
有关为您的平台配置 FreeRTOS 内核的信息,请参阅配置 FreeRTOS 内核移植。
移植
在开始移植 FreeRTOS+TCP 库之前,请检查 GitHub
如果移植不存在,请执行以下操作:
-
按照 FreeRTOS.org 上将 FreeRTOS+TCP 移植到不同微控制器
的说明,将 FreeRTOS+TCP 移植到您的设备。 -
如有必要,请按照 FreeRTOS.org 上将 FreeRTOS+TCP 移植到新的嵌入式 C 编译器
的说明,将 FreeRTOS+TCP 移植到新的编译器。 -
在名为
NetworkInterface.c
的文件中实施使用供应商提供的以太网或 Wi-Fi 驱动程序的新移植。访问 GitHub存储库以获取模板。
在创建移植后,或者如果移植已存在,请创建 FreeRTOSIPConfig.h
并编辑配置选项,以使它们适合您的平台。有关配置选项的更多信息,请参阅 FreeRTOS.org 上的 FreeRTOS+TCP 配置
测试
无论您使用的是 freerTOS+TCP 库还是第三方库,请按照以下步骤进行测试:
在传输接口测试中提供
connect/disconnect/send/receive
API 的实现。在纯文本 TCP 连接模式下设置 Echo 服务器,然后运行传输接口测试。
注意
要使设备正式获得 FreeRTOS 的资格,如果您的架构需要移植 TCP/IP 软件堆栈,则需要在 AWS IoT Device Tester 的纯文本 TCP 连接模式下根据传输接口测试验证设备移植的源代码。按照《FreeRTOS 用户指南》中使用适用于 FreeRTOS 的 AWS IoT Device Tester中的说明为移植验证设置 AWS IoT Device Tester。要测试特定库的移植,必须在 Device Tester configs
文件夹下面的 device.json
文件中启用正确的测试组。