History

Robert Walton 7842320ab7 CMake: Add option to enable greentea tests Add an option to enable the greentea tests independently from the unit tests. We can't just use the typical BUILD_TESTING option to enable greentea tests. BUILD_TESTING enables unit tests and fetches googletest, which are compiled for the host. Greentea tests are cross compiled and require a toolchain file. For this reason we add a new option just to enable greentea tests, preventing build failures triggered by the unit tests and googletest.		2021-08-10 16:35:11 +01:00
..
include/cellular/framework	AT command fix - hex string shouldn't be quoted on bc95	2021-07-14 21:43:53 +01:00
source/framework	AT command fix - hex string shouldn't be quoted on bc95	2021-07-14 21:43:53 +01:00
tests/UNITTESTS	Unit tests: Remove redundant CMake target mbed-headers-base	2021-08-02 17:42:43 +01:00
.gitignore	Move cellular framework into connectivity	2020-07-22 11:05:49 +01:00
CMakeLists.txt	CMake: Add option to enable greentea tests	2021-08-10 16:35:11 +01:00
README.md	Remove Cellular dependency in netsocket	2020-12-03 18:16:33 +01:00
mbed_lib.json	Cellular: Add AT handler buffer size to configuration	2021-06-15 15:03:57 +02:00

README.md

Mbed cellular connectivity

This is the Github repo for Mbed cellular connectivity:

framework/
    API         Application Programming Interface for cellular connectivity
    AT          AT implementation based on 3GPP TS 27.007 specification
    common      Common and utility sources
    device      Implementation of cellular device and state machine
    targets     Vendor specific cellular module adaptations

Note: Application developers should use only the API folder.

Known limitations

Please note that this is a first release of Cellular framework and is subject to further development in future.

Supported modules

You can find currently supported cellular modules in the framework/targets/ folder, where we also add support for new cellular modules.

Cellular configuration

You can change cellular defaults in the mbed_lib.json configuration file.

Debug traces

You can define the debug tracing level in the mbed_app.json configuration file:

"target_overrides": {
    "*": {
        "mbed-trace.enable": true,
        "platform.stdio-convert-newlines": true,
        "platform.stdio-baud-rate": 115200,
        "platform.default-serial-baud-rate": 115200
    }
},
"config": {
    "trace-level": {
        "help": "Options are TRACE_LEVEL_ERROR,TRACE_LEVEL_WARN,TRACE_LEVEL_INFO,TRACE_LEVEL_DEBUG",
        "macro_name": "MBED_TRACE_MAX_LEVEL",
        "value": "TRACE_LEVEL_INFO"
    }
}

Greentea tests

Cellular connectivity can be tested with generic Mbed OS netsocket and network interface tests found in Mbed OS root TESTS directory. For more information, see TESTS/netsocket/README.md and TESTS/network/interface/README.md.

Unit tests

Cellular unit tests are in Mbed OS root UNITTESTS/connectivity/cellular.

Dependency with netsocket

If you create a .mbedignore file with

connectivity/cellular*
connectivity/drivers/cellular*

MBED_CONF_CELLULAR_PRESENT will not be set