蜂窝接口库 - FreeRTOS
介绍依赖项和要求移植内存使用情况开始使用将蜂窝接口库与 MCU 平台集成
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

蜂窝接口库

注意

此页面上的内容可能不是 up-to-date。有关最新更新，请参阅 Freertos.org 图书馆页面。

介绍

蜂窝接口库实现了一个简单的统一 API，它隐藏了蜂窝调制解调器专用 AT 命令的复杂性，并向 C 程序员公开了类似套接字的接口。

大多数蜂窝调制解调器或多或少地实现 3GPP TS v27.007 标准定义的 AT 命令。该项目在可重复使用的通用组件中提供了此类标准 AT 命令的实现。该项目中的三个蜂窝接口库都利用了这些通用代码。每个调制解调器的库仅实现供应商特定的 AT 命令，然后公开完整的蜂窝接口库 API。

实现 3GPP TS v27.007 标准的通用组件是根据以下代码质量标准编写的：

  • GNU 复杂性分数未超过 8

  • MISRA C: 2012 编码标准。任何与标准的偏差都记录在标有 “coverity” 的源代码注释中。

依赖项和要求

蜂窝接口库没有直接依赖关系。但是，以太网、Wi-Fi 和蜂窝网络不能在 FreeRTOS 网络堆栈中共存。开发人员必须选择其中一个网络接口才能与 S ecure Sockets 库集成。

移植

有关将蜂窝接口库移植到您的平台的信息，请参阅 FreeRTOS 移植指南中的移植蜂窝接口库。

内存使用情况

蜂窝接口库的代码大小（使用 GCC 为 ARM Cortex-M 生成的示例）
文件 使用-O1 进行优化 使用-Os 优化
cellular_3gpp_api.c 6.3K 5.7K
cellular_3gpp_urc_handler.c 0.9K 0.8K
cellular_at_core.c 1.4K 1.2K
cellular_common_api.c 0.5K 0.5K
cellular_common.c 1.6K 1.4K
cellular_pkthandler.c 1.4K 1.2K
cellular_pktio.c 1.8K 1.6K
估计数总额 13.9K 12.4K

开始使用

下载源代码

源代码可以作为 FreeRTOS 库的一部分下载，也可以单独下载。

要使用 HTTPS 从 Github 克隆该库：

git clone https://github.com/FreeRTOS/FreeRTOS-Cellular-Interface.git

使用 SSH：

git clone git@github.com:FreeRTOS/FreeRTOS-Cellular-Interface.git

文件夹结构

在此存储库的根目录下，您将看到以下文件夹：

  • source: 可重复使用的通用代码，用于实现 3GPP TS v27.007 定义的标准 AT 命令

  • doc: 文档

  • test: 单元测试和 cbmc

  • tools: Coverity 静态分析和 cMOCK 的工具

配置和构建库

Cellufiert Refersifiert 库应作为应用程序的一个段调用。为此，您必须提供某些配置。Freertos_cellular_Interface_Windows_Simulator 项目提供了如何配置构建的示例。更多信息可以在蜂窝API参考中找到。

有关更多信息，请参阅蜂窝接口页面。

将蜂窝接口库与 MCU 平台集成

蜂窝接口库使用抽象接口 Co mm Interface 在 MCU 上运行，与蜂窝调制解调器通信。通信接口也必须在 MCU 平台上实现。Comm Interface 的最常见实现通过 UART 硬件进行通信，但也可以通过其他物理接口（例如 SPI）实现。通信接口的文档可以在蜂窝库 API 参考中找到。以下是通信接口的示例实现：