Biblioteca Cellular Interface - FreeRTOS
IntroduçãoDependências e requisitosPortabilidadeUso de memóriaComeçarIntegre a biblioteca Cellular Interface com plataformas MCU

Biblioteca Cellular Interface

nota

O conteúdo desta página pode não estar atualizado. Consulte a página da biblioteca do FreeRTOS.org para obter a atualização mais recente.

Introdução

A biblioteca Cellular Interface implementa uma API unificada simples que oculta a complexidade dos comandos AT específicos do modem de rede celular e expõe uma interface semelhante a um soquete para programadores C.

A maioria dos modems de rede celular implementa mais ou menos dos comandos AT definidos pelo padrão 3GPP TS v27.007. Este projeto fornece uma implementação desses comandos AT padrão em um componente comum reutilizável. Todas as três bibliotecas Cellular Interface deste projeto aproveitam esse código comum. A biblioteca de cada modem implementa apenas os comandos AT específicos do fornecedor e, em seguida, expõe a API completa da biblioteca Cellular Interface.

O componente comum que implementa o padrão 3GPP TS v27.007 foi escrito em conformidade com os seguintes critérios de qualidade de código:

  • As pontuações de complexidade do GNU não são superiores a 8

  • Padrão de codificação MISRA C:2012. Todo desvio do padrão é documentado nos comentários do código-fonte marcados por "coverity".

Dependências e requisitos

Não há dependência direta da biblioteca Cellular Interface. No entanto, Ethernet, Wi-Fi e rede celular não podem coexistir na pilha de rede do FreeRTOS. Os desenvolvedores devem escolher uma das interfaces de rede para integrar com a biblioteca Secure Sockets.

Portabilidade

Para obter mais informações sobre a portabilidade da biblioteca Cellular Interface para sua plataforma, consulte Portabilidade da biblioteca Cellular Interface no Guia de portabilidade do FreeRTOS.

Uso de memória

Tamanho de código da biblioteca Cellular Interface (exemplo gerado com GCC para ARM Cortex-M)
Arquivo Com otimização -O1 Com otimização -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
Estimativas totais 13,9 K 12,4 K

Começar

Fazer download do código-fonte

O código-fonte pode ser baixado como parte das bibliotecas do FreeRTOS ou individualmente.

Para clonar a biblioteca do Github usando HTTPS: 

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

Usando SSH:

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

Estrutura de pastas

Na raiz desse repositório, você verá estas pastas:

  • source: código comum reutilizável que implementa os comandos AT padrão definidos pelo 3GPP TS v27.007

  • doc: documentação

  • test: teste unitário e cbmc

  • tools: ferramentas para análise estática da Coverity e CMock

Configurar e compilar a biblioteca

A biblioteca Cellular Interface deve ser compilada como parte de uma aplicação. Para fazer isso, você deve fornecer determinadas configurações. O projeto FreeRTOS_Cellular_Interface_Windows_Simulator fornece um exemplo de como configurar a compilação. Mais informações podem ser encontradas nas Referências de API de rede celular.

Consulte a página Cellular Interface para obter mais informações.

Integre a biblioteca Cellular Interface com plataformas MCU

A biblioteca Cellular Interface é executada em MCUs usando uma interface abstrata, a Interface de comunicação, para se comunicar com modems de rede celular. Uma interface de comunicação também deve ser implementada na plataforma MCU. As implementações mais comuns da interface de comunicação se comunicam por meio de hardware UART, mas também podem ser implementadas em outras interfaces físicas, como SPI. A documentação da Interface de comunicação pode ser encontrada nas Referências de API da biblioteca de rede celular. Os seguintes exemplos de implementações da Interface de comunicação estão disponíveis: