View a markdown version of this page

Cellular Interface-Bibliothek - FreeRTOS
EinführungAbhängigkeiten und AnforderungenPortierungSpeichernutzungErste SchritteIntegrieren Sie die Cellular Interface-Bibliothek in MCU-Plattformen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Cellular Interface-Bibliothek

Anmerkung

Der Inhalt dieser Seite ist möglicherweise nicht aktuell. Das neueste Update finden Sie auf der FreeRTOS.org Bibliotheksseite.

Einführung

Die Cellular Interface-Bibliothek implementiert eine einfache, einheitliche API, die die Komplexität der für Mobilfunkmodems spezifischen AT-Befehle verbirgt und C-Programmierern eine socket-ähnliche Schnittstelle zur Verfügung stellt.

Die meisten Mobilfunkmodems implementieren mehr oder weniger der AT-Befehle, die im 3GPP TS v27.007-Standard definiert sind. Dieses Projekt bietet eine Implementierung solcher Standard-AT-Befehle in einer wiederverwendbaren gemeinsamen Komponente. Die drei Cellular Interface-Bibliotheken in diesem Projekt nutzen alle diesen gemeinsamen Code. Die Bibliothek für jedes Modem implementiert nur die herstellerspezifischen AT-Befehle und stellt dann die vollständige API der Cellular Interface-Bibliothek zur Verfügung.

Die gemeinsame Komponente, die den 3GPP TS v27.007-Standard implementiert, wurde in Übereinstimmung mit den folgenden Codequalitätskriterien geschrieben:

  • Die GNU-Komplexitätswerte liegen nicht über 8

  • C:2012 MISRA-Codierungsstandard. Alle Abweichungen vom Standard werden in Quellcode-Kommentaren dokumentiert, die mit „Coverity“ gekennzeichnet sind.

Abhängigkeiten und Anforderungen

Es besteht keine direkte Abhängigkeit von der Cellular Interface-Bibliothek. Ethernet Wi-Fi und Mobilfunk können jedoch im FreeRTOS-Netzwerkstapel nicht koexistieren. Entwickler müssen eine der Netzwerkschnittstellen auswählen, um sie in die Secure Sockets-Bibliothek zu integrieren.

Portierung

Informationen zur Portierung der Cellular Interface-Bibliothek auf Ihre Plattform finden Sie unter Portierung der Cellular Interface-Bibliothek im FreeRTOS Porting Guide.

Speichernutzung

Codegröße der Mobilfunkschnittstellenbibliothek (mit GCC für ARM Cortex-M generiertes Beispiel)
Datei Mit -O1-Optimierung Mit -Os-Optimierung
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
Schätzungen insgesamt 13,9 K 12,4 K

Erste Schritte

Laden Sie den Quellcode herunter

Der Quellcode kann als Teil der FreeRTOS-Bibliotheken oder eigenständig heruntergeladen werden.

Um die Bibliothek mit HTTPS von Github zu klonen: 

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

SSH verwenden:

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

Orderstruktur

Im Stammverzeichnis dieses Repositorys werden Sie diese Ordner sehen:

  • source: wiederverwendbarer allgemeiner Code, der die in 3GPP TS v27.007 definierten AT-Standardbefehle implementiert

  • doc: Dokumentation

  • test: Unit-Test und CBMC

  • tools: Tools für die statische Analyse von Coverity und CMock

Konfigurieren und erstellen Sie die Bibliothek

Die Cellular Interface-Bibliothek sollte als Teil einer Anwendung erstellt werden. Um dies zu tun, müssen Sie bestimmte Konfigurationen angeben. Das Cellular_Interface_Windows_SimulatorFreeRTOS_-Projekt bietet ein Beispiel für die Konfiguration des Builds. Weitere Informationen finden Sie in den Cellular API-Referenzen.

Weitere Informationen finden Sie auf der Seite Cellular Interface.

Integrieren Sie die Cellular Interface-Bibliothek in MCU-Plattformen

Die Cellular Interface-Bibliothek läuft auf MCUs und verwendet eine abstrahierte Schnittstelle, das Comm Interface, für die Kommunikation mit Mobilfunkmodems. Eine Kommunikationsschnittstelle muss ebenfalls auf der MCU-Plattform implementiert werden. Die gängigsten Implementierungen der Kommunikationsschnittstelle kommunizieren über UART-Hardware, können aber auch über andere physische Schnittstellen wie SPI implementiert werden. Die Dokumentation für das Comm Interface finden Sie in den API-Referenzen der Cellular Library. Die folgenden Beispielimplementierungen des Comm Interface sind verfügbar: