蜂窝接口
本页内容:
简介
蜂窝接口库可实现简单而统一的
API,以隐藏蜂窝
调制解调器专用 AT 命令的复杂性,并向 C 程序员公开类似套接字的接口。
大多数蜂窝调制解调器均可或多或少地实现
由 3GPP TS v27.007 标准定义的 AT 命令。本项目提供
此类标准 AT 命令的实现
(在可重复使用的通用组件中)。
本项目的三个蜂窝接口库都利用了该通用代码。各调制解调器的库仅实现
供应商特定的 AT 命令,随后公开完整的蜂窝接口 API。
实现 3GPP TS v27.007 标准的通用组件已按照以下代码质量标准进行编写:
- GNU 复杂性得分不超过 8
- MISRA C: 2012 编码标准。 任何偏离标准的情况都被记录在用 "coverity" 标记的源代码注释中。
入门指南
下载源代码
源代码可以从 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 命令
- docs:文档
- test:单元测试和 cbmc
- tools:用于 Coverity 静态分析和 CMock 的工具
配置和构建库
蜂窝接口库应作为应用程序的一部分进行构建。为此必须提供某些配置。关于如何配置构建,
FreeRTOS 蜂窝演示项目提供了
示例。更多信息,请参阅蜂窝接口 API 引用。
更多信息,请参阅蜂窝接口演示(双向验证)。
将蜂窝接口库与 MCU 平台集成
蜂窝接口库在使用抽象接口(即通信接口)与蜂窝调制解调器通信的 MCU 上运行。 通信接口也必须在 MCU 平台上实现。 通信接口的最常见的实现方式是使用 UART 硬件,但也可以通过其他物理接口(如 SPI)来实现。 通信接口的文档可在蜂窝 API 引用中找到。以下为通信接口的实现示例:
Copyright (C) Amazon Web Services, Inc. or its affiliates. All rights reserved.