セルラーインターフェイスライブラリ - 無料RTOS

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

セルラーインターフェイスライブラリ

注記

このページのコンテンツは ではない場合があります up-to-date。最新の更新については、Free RTOS.org ライブラリページを参照してください。

序章

セルラーインターフェイスライブラリは、セルラーモデム固有の AT コマンドの複雑さを隠し、ソケットのようなインターフェイスを C プログラマーに公開APIするシンプルな統合を実装します。

ほとんどのセルラーモデムは、3GPP つの TS v27.007 標準で定義されている AT コマンドを多かれ少なかれ実装します。このプロジェクトでは、再利用可能な共通コンポーネントに、このような標準 AT コマンドが実装されています。プロジェクトの 3 つのセルラーインターフェイスライブラリはすべて、その共通コードを利用しています。各モデムのライブラリは、ベンダー固有の AT コマンドのみを実装し、完全なセルラーインターフェイスライブラリ を公開しますAPI。

3GPP つの TS v27.007 標準を実装する一般的なコンポーネントは、次のコード品質基準に従って記述されています。

  • GNU 複雑さスコアが 8 を超えない

  • MISRA C:2012 コーディング標準。標準からの逸脱は、「coverity」でマークされたソースコードのコメントに記載されます。

依存関係と要件

セルラーインターフェイスライブラリに直接的な依存関係はありません。ただし、イーサネット、Wi-Fi、セルラーは無料RTOSネットワークスタックに共存できません。開発者は、ネットワークインターフェイスのいずれかを選択して、セキュアソケットライブラリと統合する必要があります。

移植

モバイルインターフェイスライブラリをプラットフォームに移植する方法については、「 無料移植ガイド」の「モバイルインターフェイスライブラリの移植」を参照してください。 RTOS

メモリ使用量

セルラーインターフェイスライブラリのコードサイズ (GCC例: for ARM Cortex-M で生成)
File -O1 最適化を使用 -Os 最適化を使用
cellular_3gpp_api.c 6.3 K 5.7 K
cellular_3gpp_urc_handler.c 0.9 K 0.8 K
cellular_at_core.c 1.4 K 1.2 K
cellular_common_api.c 0.5 K 0.5 K
cellular_common.c 1.6 K 1.4 K
cellular_pkthandler.c 1.4 K 1.2 K
cellular_pktio.c 1.8 K 1.6 K
合計 (概算) 13.9 K 12.4 K

使用開始方法

ソースコードのダウンロード

ソースコードは、無料RTOSライブラリの一部としてダウンロードすることも、単独でダウンロードすることもできます。

を使用して Github からライブラリをクローンするにはHTTPS:

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

ライブラリの設定とビルド

セルラーインターフェイスライブラリは、アプリケーションの一部として構築する必要があります。これを行うには、特定の設定を指定する必要があります。 無料 RTOS_Cellular_Interface_Windows_Simulator プロジェクトでは、ビルドの設定方法の例を示します。詳細については、セルラーAPIリファレンス を参照してください。

詳細については、セルラーインターフェイスページをを参照してください。

セルラーインターフェイスライブラリをMCUプラットフォームと統合する

セルラーインターフェイスライブラリは、抽象化されたインターフェイスである Comm Interface MCUsを使用して で実行され、セルラーモデムと通信します。Comm Interface はMCUプラットフォームにも実装する必要があります。Comm Interface の最も一般的な実装はUARTハードウェアを介して通信しますが、 などの他の物理インターフェイスSPIでも実装できます。通信インターフェイスのドキュメントは、セルラーライブラリAPIリファレンス にあります。通信インターフェイスの実装例を以下に示します。