mirror of https://github.com/ARMmbed/mbed-os.git
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
# Mbed cellular connectivity
|
|
|
|
This is the Github repo for Mbed cellular connectivity:
|
|
|
|
easy_cellular/
|
|
EasyCellularConnection Simplified cellular usage based on `CellularBase.h`
|
|
CellularConnectionUtil A utility class for cellular connection
|
|
|
|
framework/
|
|
API Application Programming Interface for cellular connectivity
|
|
AT AT implementation based on 3GPP TS 27.007 specification
|
|
common Common and utility sources
|
|
mux MUX implementation based on 3GPP TS 27.010 specification
|
|
targets Vendor specific cellular module adaptations
|
|
|
|
## Known limitations
|
|
|
|
**Please note that as a first release framework, this content is subject to change and may break code that uses it.**
|
|
|
|
Only UDP is supported when using AT commands to control sockets in an IP stack built into the cellular modem. If TCP is required, use the PPP/LWIP stack.
|
|
|
|
## 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_app.json` configuration file:
|
|
|
|
"config": {
|
|
"cellular_plmn": {
|
|
"help": "PLMN selection, 0=auto",
|
|
"value": 0
|
|
},
|
|
"apn": {
|
|
"help": "Access point name, e.g. internet",
|
|
"value": "\"internet\""
|
|
},
|
|
"cellular_sim_pin": {
|
|
"help": "PIN code",
|
|
"value": "\"1234\""
|
|
}
|
|
}
|
|
|
|
## Debug traces
|
|
|
|
You can define the debug tracing level in the `mbed_app.json` configuration file:
|
|
|
|
"target_overrides": {
|
|
"*": {
|
|
"target.features_add": ["COMMON_PAL"],
|
|
"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"
|
|
}
|
|
}
|
|
|
|
## Unit tests
|
|
|
|
The `UNITTESTS` folder contains unit tests for cellular specific classes. Unit tests are based on the stubbing method.
|
|
|
|
You can run those tests locally by running `./run_tests` script under the `UNITTESTS/` folder.
|
|
|
|
You need the following applications: `cpputest`, `gcov` and `lcov` (genhtml) for running the tests.
|
|
|
|
After you have run the `run_tests` script, you can find test results under `UNITTESTS/results` folder and line and function coverages under the `UNITTESTS/coverages` folder.
|