FreeRTOS: FreeRTOS Cellular Library v1.0.0
FreeRTOS Cellular Library
Overview

FreeRTOS Cellular library

FreeRTOS Cellular Library use communication interface to communicate with cellular modules to provide cellular network connectivity.

FreeRTOS Cellular Library

  • Repository structure
    This library contains the following three components in three folders.
    FreeRTOS Cellular Library folders High Level Description
    include FreeRTOS Cellular Library APIs definitions help to abstract the control of cellular module.
    common FreeRTOS Cellular Library APIs implemenation with 3GPP TS v27.007 AT commands.
    modules FreeRTOS Cellular Library APIs implemenation with cellular module specific AT commands.
  • Supported cellular modules
    Three cellular modules are supported in this library.
    Cellular module
    quectel BG96
    Sierra HL7802
    Ublox SARA R4 series
    New cellular module can reference these module porting to be integrated into FreeRTOS Cellular Library.
    Please reference cellular common library document for detail information about porting new cellular module.
  • Currently Supported Features in FreeRTOS Cellular Library
    • User of FreeRTOS Cellular Library is able to use Cat-M1 cellular technology to connect to network.
    • User of FreeRTOS Cellular Library is able to perform control plane operations like (initialize modem, register on a network etc.) in a vendor agnostic way.
    • User of FreeRTOS Cellular Library is able to send and receive data using TCP/IP in a vendor agnostic way given that TCP/IP stack is running on the cellular modem.
    • User of FreeRTOS Cellular Library is able to put the modem in different low power modes (PSM and eDRX) in a vendor agnostic way.
    • User of FreeRTOS Cellular Library is able to receive asynchronous notifications about various events like "disconnected", "signal strength changed" etc. to enable them to take appropriate action as desired.
    • User of FreeRTOS Cellular Library is able to use the existing application protocol clients (MQTT, HTTP) over cellular seamlessly. i.e. any existing user application using MQTT which works over WiFi/Ethernet shall work over Cellular given the underlying cellular technology permits that.

Memory Requirements

Memory requirements of the Cellular library.

Code Size of cellularLibrary (example generated with GCC for ARM Cortex-M)
File
With -O1 Optimization
With -Os Optimization
cellular_3gpp_api.c
6.3K
5.8K
cellular_3gpp_urc_handler.c
0.9K
0.8K
cellular_at_core.c
1.4K
1.2K
cellular_common_api.c
0.5K
0.5K
cellular_common.c
1.6K
1.5K
cellular_pkthandler.c
1.4K
1.3K
cellular_pktio.c
1.8K
1.6K
Total estimates
13.9K
12.7K