Eric Jung / Mbed OS mbed-os-example-cellular-BG96

BG96 Cat.M1 basic sample for WIZnet IoT Shield based on Mbed-OS Cellular APIs (SK telecom network in Korea)

Overview

This code could be access via Cat.M1(BG96 module) of SK telecom network in Korea. Need a WIZnet IoT Shield BG96 board and development board. The code forked Daniel_Lee's mbed-os-example-cellular-BG96 repository and added some features.

/media/uploads/hkjung/wiznetiotshield_bg96_nucleo-l476rg_stacking.png /media/uploads/hkjung/wiznetiotshield_bg96_nucleo-l476rg_separate.png

Tested with

  • NUCLEO_L476RG
  • DISCO_L475VG_IOT01A
  • K64F

Example functionality

This example showcases the following device functionality:

1. Import the application into your desktop:

mbed import https://os.mbed.com/users/hkjung/code/mbed-os-example-cellular-BG96/
 
cd mbed-os-example-cellular-BG96

2. Compile and program:

mbed compile -t <toolchain> -m <TARGET_BOARD>

(supported toolchains : GCC_ARM / ARM / IAR)

3. Download binary to a target board

If need more information such as how to test, please look at https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-cellular/.

README.md@28:232da3ce8a88, 2018-11-23 (annotated)

Committer:
mbed_official
Date:
Fri Nov 23 10:00:30 2018 +0000
Revision:
28:232da3ce8a88
Parent:
26:348eec457e58
Child:
29:f1f568035f90
Merge pull request #110 from AriParkkila/master



Change default network interface to  NetworkInterface

.

Commit copied from https://github.com/ARMmbed/mbed-os-example-cellular

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 0:4611f6cf2413 1 # Example cellular application for Mbed OS
mbed_official 0:4611f6cf2413 2
mbed_official 0:4611f6cf2413 3 This is an example based on `mbed-os` cellular APIs that demonstrates a TCP or UDP echo transaction with a public echo server.
mbed_official 0:4611f6cf2413 4
mbed_official 0:4611f6cf2413 5 ## Getting started
mbed_official 0:4611f6cf2413 6
mbed_official 0:4611f6cf2413 7 This particular cellular application uses a cellular network and network-socket APIs that are part of [`mbed-os`](https://github.com/ARMmbed/mbed-os).
mbed_official 0:4611f6cf2413 8
mbed_official 26:348eec457e58 9 The program uses a [cellular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/cellular/framework/API) using an external IP stack (LWIP) standard 3GPP AT 27.007 AT commands to setup the cellular modem and registers to the network.
mbed_official 0:4611f6cf2413 10
mbed_official 0:4611f6cf2413 11 After registration, the driver opens a point-to-point protocol (PPP) pipe using LWIP with the cellular modem and connects to internet. This driver currently supports UART data connection type only between your cellular modem and MCU.
mbed_official 0:4611f6cf2413 12
mbed_official 26:348eec457e58 13 For more information on Arm Mbed OS cellular APIs and porting guide, please visit the [Mbed OS cellular API](https://os.mbed.com/docs/latest/reference/cellular.html) and [contributing documentation](https://os.mbed.com/docs/latest/reference/contributing.html).
mbed_official 0:4611f6cf2413 14
mbed_official 0:4611f6cf2413 15 ### Download the application
mbed_official 0:4611f6cf2413 16
mbed_official 0:4611f6cf2413 17 ```sh
mbed_official 0:4611f6cf2413 18 $ mbed import mbed-os-example-cellular
mbed_official 0:4611f6cf2413 19 $ cd mbed-os-example-cellular
mbed_official 0:4611f6cf2413 20
mbed_official 0:4611f6cf2413 21 #OR
mbed_official 0:4611f6cf2413 22
mbed_official 0:4611f6cf2413 23 $ git clone git@github.com:ARMmbed/mbed-os-example-cellular.git
mbed_official 0:4611f6cf2413 24 $ cd mbed-os-example-cellular
mbed_official 0:4611f6cf2413 25 ```
mbed_official 0:4611f6cf2413 26
mbed_official 0:4611f6cf2413 27 ### Change the network and SIM credentials
mbed_official 0:4611f6cf2413 28
mbed_official 0:4611f6cf2413 29 See the file `mbed_app.json` in the root directory of your application. This file contains all the user specific configurations your application needs. Provide the pin code for your SIM card, as well as any APN settings if needed. For example:
mbed_official 0:4611f6cf2413 30
mbed_official 0:4611f6cf2413 31 ```json
mbed_official 0:4611f6cf2413 32 "sim-pin-code": {
mbed_official 19:2cb9398aaf16 33 "help": "SIM PIN code, set to 0 if none",
mbed_official 0:4611f6cf2413 34 "value": "\"1234\""
mbed_official 0:4611f6cf2413 35 },
mbed_official 0:4611f6cf2413 36 "apn": {
mbed_official 0:4611f6cf2413 37 "help": "The APN string to use for this SIM/network, set to 0 if none",
mbed_official 0:4611f6cf2413 38 "value": "\"internet\""
mbed_official 0:4611f6cf2413 39 },
mbed_official 0:4611f6cf2413 40 "username": {
mbed_official 0:4611f6cf2413 41 "help": "The user name string to use for this APN, set to zero if none",
mbed_official 0:4611f6cf2413 42 "value": 0
mbed_official 0:4611f6cf2413 43 },
mbed_official 0:4611f6cf2413 44 "password": {
mbed_official 0:4611f6cf2413 45 "help": "The password string to use for this APN, set to 0 if none",
mbed_official 0:4611f6cf2413 46 "value": 0
mbed_official 0:4611f6cf2413 47 }
mbed_official 6:5678c0b6f74e 48 ```
mbed_official 0:4611f6cf2413 49
mbed_official 0:4611f6cf2413 50 ### Selecting socket type (TCP or UDP)
mbed_official 0:4611f6cf2413 51
mbed_official 0:4611f6cf2413 52
mbed_official 6:5678c0b6f74e 53 You can choose which socket type the application should use; however, please note that TCP is a more reliable transmission protocol. For example:
mbed_official 0:4611f6cf2413 54
mbed_official 0:4611f6cf2413 55
mbed_official 0:4611f6cf2413 56 ```json
mbed_official 0:4611f6cf2413 57
mbed_official 0:4611f6cf2413 58 "sock-type": "TCP",
mbed_official 0:4611f6cf2413 59
mbed_official 0:4611f6cf2413 60 ```
mbed_official 0:4611f6cf2413 61
mbed_official 0:4611f6cf2413 62 ### Turning modem AT echo trace on
mbed_official 0:4611f6cf2413 63
mbed_official 11:23ea0907186e 64 If you like details and wish to know about all the AT interactions between the modem and your driver, turn on the modem AT echo trace.
mbed_official 0:4611f6cf2413 65
mbed_official 0:4611f6cf2413 66 ```json
mbed_official 11:23ea0907186e 67 "cellular.debug-at": true
mbed_official 0:4611f6cf2413 68 ```
mbed_official 0:4611f6cf2413 69
mbed_official 6:5678c0b6f74e 70 ### Turning on the tracing and trace level
mbed_official 6:5678c0b6f74e 71
mbed_official 6:5678c0b6f74e 72 If you like to add more traces or follow the current ones you can turn traces on by changing `mbed-trace.enable` in mbed_app.json
mbed_official 6:5678c0b6f74e 73
mbed_official 6:5678c0b6f74e 74 ```"target_overrides": {
mbed_official 6:5678c0b6f74e 75 "*": {
mbed_official 11:23ea0907186e 76 "mbed-trace.enable": true,
mbed_official 6:5678c0b6f74e 77 ```
mbed_official 6:5678c0b6f74e 78
mbed_official 6:5678c0b6f74e 79 After you have defined `mbed-trace.enable: true`, you can set trace levels by changing value in `trace-level`
mbed_official 6:5678c0b6f74e 80
mbed_official 6:5678c0b6f74e 81 ```"trace-level": {
mbed_official 6:5678c0b6f74e 82 "help": "Options are TRACE_LEVEL_ERROR,TRACE_LEVEL_WARN,TRACE_LEVEL_INFO,TRACE_LEVEL_DEBUG",
mbed_official 6:5678c0b6f74e 83 "macro_name": "MBED_TRACE_MAX_LEVEL",
mbed_official 6:5678c0b6f74e 84 "value": "TRACE_LEVEL_INFO"
mbed_official 6:5678c0b6f74e 85 }
mbed_official 6:5678c0b6f74e 86 ```
mbed_official 6:5678c0b6f74e 87
mbed_official 0:4611f6cf2413 88 ### Board support
mbed_official 0:4611f6cf2413 89
mbed_official 26:348eec457e58 90 The [cellular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/cellular/framework/API) in this example uses PPP with an Mbed-supported external IP stack. It supports targets when modem exists on the Mbed Enabled target as opposed to plug-in modules (shields). For more details, please see our [Mbed OS cellular documentation](https://os.mbed.com/docs/latest/reference/cellular-api.html).
mbed_official 0:4611f6cf2413 91
mbed_official 16:bf6ed28b4d08 92 Currently supported boards with onboard modem chips are:
mbed_official 16:bf6ed28b4d08 93
mbed_official 26:348eec457e58 94 [u-blox C027](https://os.mbed.com/platforms/u-blox-C027/)
mbed_official 16:bf6ed28b4d08 95 [MultiTech MTS Dragonfly](https://os.mbed.com/platforms/MTS-Dragonfly/)
mbed_official 16:bf6ed28b4d08 96
mbed_official 0:4611f6cf2413 97
mbed_official 0:4611f6cf2413 98 ## Compiling the application
mbed_official 0:4611f6cf2413 99
mbed_official 28:232da3ce8a88 100 The master branch is for daily development and it uses the latest mbed-os/master.
mbed_official 28:232da3ce8a88 101
mbed_official 28:232da3ce8a88 102 To use the latest stable version update to a Mbed OS release tag, for example:
mbed_official 28:232da3ce8a88 103
mbed_official 28:232da3ce8a88 104 ```
mbed_official 28:232da3ce8a88 105 mbed releases
mbed_official 28:232da3ce8a88 106 * mbed-os-5.10.4
mbed_official 28:232da3ce8a88 107 ...
mbed_official 28:232da3ce8a88 108 mbed update mbed-os-5.10.4
mbed_official 28:232da3ce8a88 109 ```
mbed_official 28:232da3ce8a88 110
mbed_official 28:232da3ce8a88 111 You may need to use `--clean` option to discard your local changes (use with caution).
mbed_official 28:232da3ce8a88 112
mbed_official 0:4611f6cf2413 113 Use Mbed CLI commands to generate a binary for the application. For example, in the case of GCC, use the following command:
mbed_official 0:4611f6cf2413 114
mbed_official 0:4611f6cf2413 115 ```sh
mbed_official 0:4611f6cf2413 116 $ mbed compile -m YOUR_TARGET_WITH_MODEM -t GCC_ARM
mbed_official 0:4611f6cf2413 117 ```
mbed_official 0:4611f6cf2413 118
mbed_official 0:4611f6cf2413 119 ## Running the application
mbed_official 0:4611f6cf2413 120
mbed_official 0:4611f6cf2413 121 Drag and drop the application binary from `BUILD/YOUR_TARGET_WITH_MODEM/GCC_ARM/mbed-os-example-cellular.bin` to your Mbed Enabled target hardware, which appears as a USB device on your host machine.
mbed_official 0:4611f6cf2413 122
mbed_official 0:4611f6cf2413 123 Attach a serial console emulator of your choice (for example, PuTTY, Minicom or screen) to your USB device. Set the baudrate to 115200 bit/s, and reset your board by pressing the reset button.
mbed_official 0:4611f6cf2413 124
mbed_official 0:4611f6cf2413 125 You should see an output similar to this:
mbed_official 0:4611f6cf2413 126
mbed_official 0:4611f6cf2413 127 ```
mbed_official 2:0f644d6045cf 128 mbed-os-example-cellular
mbed_official 6:5678c0b6f74e 129 Establishing connection ......
mbed_official 2:0f644d6045cf 130
mbed_official 0:4611f6cf2413 131 Connection Established.
mbed_official 2:0f644d6045cf 132 TCP: connected with echo.mbedcloudtesting.com server
mbed_official 2:0f644d6045cf 133 TCP: Sent 4 Bytes to echo.mbedcloudtesting.com
mbed_official 0:4611f6cf2413 134 Received from echo server 4 Bytes
mbed_official 2:0f644d6045cf 135
mbed_official 2:0f644d6045cf 136
mbed_official 0:4611f6cf2413 137 Success. Exiting
mbed_official 0:4611f6cf2413 138 ```
mbed_official 0:4611f6cf2413 139
mbed_official 0:4611f6cf2413 140 ## Troubleshooting
mbed_official 0:4611f6cf2413 141
mbed_official 11:23ea0907186e 142 * Make sure the fields `sim-pin-code`, `apn`, `username` and `password` from the `mbed_app.json` file are filled in correctly. The correct values should appear in the user manual of the board if using eSIM or in the details of the SIM card if using normal SIM.
mbed_official 11:23ea0907186e 143 * Enable trace flag to have access to debug information `"mbed-trace.enable": true`.
mbed_official 11:23ea0907186e 144 * Try both `TCP` and `UDP` socket types.
mbed_official 11:23ea0907186e 145 * Try both `"lwip.ppp-enabled": true` and `"lwip.ppp-enabled": false`.
mbed_official 11:23ea0907186e 146 * The modem may support only a fixed baud-rate, such as `"platform.default-serial-baud-rate": 9600`.
mbed_official 11:23ea0907186e 147 * The modem and network may only support IPv6 in which case `"lwip.ipv6-enabled": true` shall be defined.
mbed_official 11:23ea0907186e 148 * The SIM and modem must have compatible cellular technology (3G, 4G, NB-IoT, ...) supported and cellular network available.
mbed_official 11:23ea0907186e 149
mbed_official 11:23ea0907186e 150 If you have problems to get started with debugging, you can review the [documentation](https://os.mbed.com/docs/latest/tutorials/debugging.html) for suggestions on what could be wrong and how to fix it.