View a markdown version of this page

Libreria di interfacce cellulari - FreeRTOS
IntroduzioneDipendenze e requisitiPortabilitàUso della memoriaNozioni di baseIntegra la libreria Cellular Interface con le piattaforme MCU

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Libreria di interfacce cellulari

Nota

Il contenuto di questa pagina potrebbe non essere aggiornato. Consulta la pagina della FreeRTOS.org libreria per l'ultimo aggiornamento.

Introduzione

La libreria Cellular Interface implementa una semplice API unificata che nasconde la complessità dei comandi AT specifici dei modem cellulari ed espone un'interfaccia simile a un socket ai programmatori C.

La maggior parte dei modem cellulari implementa più o meno i comandi AT definiti dallo standard 3GPP TS v27.007. Questo progetto fornisce un'implementazione di tali comandi AT standard in un componente comune riutilizzabile. Le tre librerie Cellular Interface di questo progetto sfruttano tutte quel codice comune. La libreria per ogni modem implementa solo i comandi AT specifici del fornitore, quindi espone l'API completa della libreria Cellular Interface.

Il componente comune che implementa lo standard 3GPP TS v27.007 è stato scritto in conformità con i seguenti criteri di qualità del codice:

  • I punteggi di GNU Complexity non sono superiori a 8

  • Standard di C:2012 codifica MISRA. Qualsiasi deviazione dallo standard è documentata nei commenti del codice sorgente contrassegnati con «coverity».

Dipendenze e requisiti

Non esiste una dipendenza diretta per la libreria Cellular Interface. Tuttavia, Ethernet Wi-Fi e cellulare non possono coesistere nello stack di rete FreerTOS. Gli sviluppatori devono scegliere una delle interfacce di rete da integrare con la libreria Secure Sockets.

Portabilità

Per informazioni sul porting della libreria Cellular Interface sulla tua piattaforma, consulta Porting the Cellular Interface library nella FreerTOS Porting Guide.

Uso della memoria

Dimensione del codice della libreria di interfaccia cellulare (esempio generato con GCC per ARM Cortex-M)
File Con ottimizzazione -O1 Con ottimizzazione -Os
cellular_3gpp_api.c 6,3K 5,7K
cellular_3gpp_urc_handler.c 0,9 K 0,8 K
cellular_at_core.c 1,4K 1,2 K
cellular_common_apic. 0,5 K 0,5K
cellular_common.c 1,6K 1,4K
cellular_pkthandler.c 1,4K 1,2 K
cellular_ptio.c 1,8 K 1,6 K
Stime totali 13,9 K 12,4K

Nozioni di base

Scarica il codice sorgente

Il codice sorgente può essere scaricato come parte delle librerie FreerTOS o da solo.

Per clonare la libreria da Github usando HTTPS: 

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

Usare SSH:

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

Struttura della cartella

Alla radice di questo repository vedrai queste cartelle:

  • source: codice comune riutilizzabile che implementa i comandi AT standard definiti da 3GPP TS v27.007

  • doc: documentazione

  • test: test unitario e cbmc

  • tools: strumenti per l'analisi statica di Coverity e CMock

Configura e crea la libreria

La libreria Cellular Interface deve essere creata come parte di un'applicazione. A tale scopo, è necessario fornire determinate configurazioni. Il Cellular_Interface_Windows_Simulator progetto FreeRTOS_ fornisce un esempio di come configurare la build. Ulteriori informazioni sono disponibili nei riferimenti alle API cellulari.

Per ulteriori informazioni, consulta la pagina Cellular Interface.

Integra la libreria Cellular Interface con le piattaforme MCU

La libreria Cellular Interface funziona su MCU che utilizzano un'interfaccia astratta, la Comm Interface, per comunicare con i modem cellulari. Un'interfaccia Comm deve essere implementata anche sulla piattaforma MCU. Le implementazioni più comuni dell'interfaccia Comm comunicano tramite hardware UART, ma possono essere implementate anche su altre interfacce fisiche, come SPI. La documentazione per l'interfaccia Comm è disponibile nei riferimenti alle API di Cellular Library. Sono disponibili i seguenti esempi di implementazioni dell'interfaccia Comm: