Cellular Interface-Bibliothek - Kostenlos RTOS
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 vorhanden up-to-date. Das neueste Update finden Sie auf der Seite der RTOS Free.org-Bibliothek.

Einführung

Die Cellular Interface-Bibliothek implementiert ein einfaches API, einheitliches System, das die Komplexität der für Mobilfunkmodems spezifischen AT-Befehle verbirgt und C-Programmierern eine sockelartige Schnittstelle zur Verfügung stellt.

Die meisten Mobilfunkmodems implementieren mehr oder weniger der AT-Befehle, die im 3 TS v27.007-Standard definiert sind. GPP 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 gesamte Cellular Interface-Bibliothek zur Verfügung. API

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

  • GNUDie Komplexitätswerte liegen nicht über 8

  • MISRACodierungsstandard C: 2012. 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, WLAN und Mobilfunk können im Free RTOS Network Stack jedoch nicht nebeneinander existieren. 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 Free RTOS Porting Guide.

Speichernutzung

Codegröße der Mobilfunkschnittstellenbibliothek (Beispiel generiert mit GCC für ARM Cortex-M)
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 kostenlosen RTOS Bibliotheken oder eigenständig heruntergeladen werden.

Um die Bibliothek von Github zu klonen, verwenden SieHTTPS: 

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

Verwenden vonSSH:

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 3 GPP 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 Projekt Free RTOS _Cellular_Interface_Windows_Simulator bietet ein Beispiel für die Konfiguration des Builds. Weitere Informationen finden Sie in den Cellular References. API

Weitere Informationen finden Sie auf der Seite Cellular Interface.

Integrieren Sie die Cellular Interface-Bibliothek in MCU Plattformen

Die Cellular Interface-Bibliothek MCUs verwendet eine abstrakte Schnittstelle, das Comm Interface, um mit Mobilfunkmodems zu kommunizieren. 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 implementiert werdenSPI, z. B. Die Dokumentation für das Comm Interface finden Sie in den Cellular Library API References. Die folgenden Beispielimplementierungen des Comm Interface sind verfügbar: