Bibliothèque d'interface utilisateur cellulaire - FreeRTOS
IntroductionDépendances et exigencesPortageUtilisation de la mémoireDémarrerIntégrez la bibliothèque d'interfaces cellulaires aux plateformes de microcontrôleurs

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Bibliothèque d'interface utilisateur cellulaire

Note

Le contenu de cette page ne l'est peut-être pas up-to-date. Reportez-vous à la page de la bibliothèque FreeRTOS.org pour la dernière mise à jour.

Introduction

La bibliothèque d'interface cellulaire implémente une API unifiée simple qui masque la complexité des commandes AT spécifiques au modem cellulaire et expose une interface de type socket aux programmeurs C.

La plupart des modems cellulaires implémentent plus ou moins les commandes AT définies par la norme 3GPP TS v27.007. Ce projet fournit une implémentation de ces commandes AT standard dans un composant commun réutilisable. Les trois bibliothèques d'interfaces cellulaires de ce projet tirent toutes parti de ce code commun. La bibliothèque de chaque modem implémente uniquement les commandes AT spécifiques au fournisseur, puis expose l'API complète de la bibliothèque d'interface cellulaire.

Le composant commun qui implémente la norme 3GPP TS v27.007 a été écrit conformément aux critères de qualité du code suivants :

  • Les scores de complexité de GNU ne sont pas supérieurs à 8

  • Norme de codage MISRA C:2012. Tout écart par rapport à la norme est documenté dans les commentaires du code source marqués par la mention « couverture ».

Dépendances et exigences

Il n'existe aucune dépendance directe pour la bibliothèque d'interface cellulaire. Cependant, Ethernet, Wi-Fi et cellulaire ne peuvent pas coexister dans la pile réseau FreeRTOS. Les développeurs doivent choisir l'une des interfaces réseau à intégrer à la bibliothèque Secure Sockets.

Portage

Pour plus d'informations sur le portage de la bibliothèque d'interface cellulaire vers votre plate-forme, consultez la section Portage de la bibliothèque d'interface cellulaire dans le guide de portage FreeRTOS.

Utilisation de la mémoire

Taille de code de la bibliothèque d'interface cellulaire (exemple généré avec GCC pour ARM Cortex-M)
Fichier Avec l'optimisation -O1 Avec -Os Optimization
cellular_3gpp_api.c 6,3 KM 5,7 KM
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 KM 0,5 KM
cellular_common.c 1,6 KM 1,4 K
cellular_pkthandler.c 1,4 K 1,2 K
cellular_pktio.c 1,8 KM 1,6 KM
Estimations totales 13,9 K 12,4 K

Démarrer

Téléchargez code source

Le code source peut être téléchargé dans le cadre des bibliothèques FreeRTOS ou seul.

Pour cloner la bibliothèque depuis Github à l'aide du protocole HTTPS : 

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

Utilisation du protocole SSH :

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

Structure des dossiers

À la racine de ce référentiel, vous verrez les dossiers suivants :

  • source: code commun réutilisable qui implémente les commandes AT standard définies par 3GPP TS v27.007

  • doc: documentation

  • test: test unitaire et cbmc

  • tools: outils pour l'analyse statique Coverity et CMOCK

Configuration et création de la bibliothèque

La bibliothèque de l'interface utilisateur cellulaire doit être intégrée à une application. Pour ce faire, vous devez fournir certaines configurations. Le projet FreeRTOS_Cellular_Interface_Windows_Simulator fournit un exemple de configuration de la génération. Vous pouvez consulter les références utilisateur pour obtenir des informations supplémentaires.

Reportez-vous à la page Interface cellulaire pour plus d'informations.

Intégrez la bibliothèque d'interfaces cellulaires aux plateformes de microcontrôleurs

La bibliothèque d'interface cellulaire fonctionne sur des microcontrôleurs utilisant une interface abstraite, l'interface Comm, pour communiquer avec les modems cellulaires. Une interface de communication doit également être implémentée sur la plate-forme MCU. Les implémentations les plus courantes de l'interface Comm communiquent via du matériel UART, mais peuvent également être mises en œuvre via d'autres interfaces physiques, telles que SPI. La documentation relative à l'interface de communication se trouve dans les références de l'API Cellular Library. Les exemples d'implémentation suivants de l'interface Comm sont disponibles :