You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+16-18Lines changed: 16 additions & 18 deletions
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,16 @@
1
1
# Example cellular application for mbed OS
2
2
3
-
This is a simple example based upon mbed-os celular APIs that demonstrates a simple TCP or UDP echo transaction with a public echo server.
3
+
This is an example based on `mbed-os` cellular APIs that demonstrates a TCP or UDP echo transaction with a public echo server.
4
4
5
5
## Getting started
6
6
7
-
This particular Cellular application uses a Cellular network and network-socket APIs that are provided as a part of [mbed-os](github.com/armmbed/mbed-os).
7
+
This particular cellular application uses a cellular network and network-socket APIs that are part of [`mbed-os`](github.com/armmbed/mbed-os).
8
8
9
-
The program uses a [generic celular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/netsocket/cellular/generic_modem_driver) utilizing an external IP stack (LWIP) standard 3GPP AT 27.007 AT commands to setup the cellular modem and registers to the network.
10
-
After registration, the driver opens up a PPP (point-to-point protocol) 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.
9
+
The program uses a [generic cellular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/netsocket/cellular/generic_modem_driver) using an external IP stack (LWIP) standard 3GPP AT 27.007 AT commands to setup the cellular modem and registers to the network.
11
10
12
-
For more information on ARM mbed-os cellular APIs and porting guide, please visit [mbed-os Cellular Docs](https://docs.mbed.com/docs/mbed-os-api-reference/en/latest/APIs/communication/cellular/).
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.
12
+
13
+
For more information on ARM mbed OS cellular APIs and porting guide, please visit the [mbed OS cellular documentation](https://docs.mbed.com/docs/mbed-os-api-reference/en/latest/APIs/communication/cellular/).
13
14
14
15
### Download the application
15
16
@@ -25,8 +26,7 @@ $ cd mbed-os-example-cellular
25
26
26
27
### Change the network and SIM credentials
27
28
28
-
See the file `mbed_app.json` in te root directory of your application. This file contains all the user specific configurations needed by your application.
29
-
Provide the pin code for your SIM crad as well as any APN settings if needed, e.g.,
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:
30
30
31
31
```json
32
32
"sim-pin-code": {
@@ -49,18 +49,17 @@ Provide the pin code for your SIM crad as well as any APN settings if needed, e.
49
49
50
50
### Selecting socket type (TCP or UDP)
51
51
52
-
You can choose which socket type the application should use, e.g.,
52
+
You can choose which socket type the application should use. For example:
53
53
54
54
```json
55
55
56
56
"sock-type": "TCP",
57
57
58
58
```
59
59
60
-
### Turning Modem AT echo trace on
60
+
### Turning modem AT echo trace on
61
61
62
-
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.
63
-
Set `modem_trace` field value to be true.
62
+
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. Set the `modem_trace` field value to be true.
64
63
65
64
```json
66
65
"modem_trace": {
@@ -71,23 +70,23 @@ Set `modem_trace` field value to be true.
71
70
72
71
### Board support
73
72
74
-
The [generic celular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/netsocket/cellular/generic_modem_driver)used by this application is written using only a standard AT command set and the uses PPP with a full fledge mbed-supported external IP stack. These abilities make the driver essentially generic, i.e., non-vendor specific. However, this particular driver is written for onboard-modem types, i.e., the modem exists on the mbed-enabled target as oppose to plugin-modules (shields). For more details, please check documentation [mbed-os Cellular Docs](https://docs.mbed.com/docs/mbed-os-api-reference/en/latest/APIs/communication/cellular/).
73
+
The [generic cellular modem driver](https://github.com/ARMmbed/mbed-os/tree/master/features/netsocket/cellular/generic_modem_driver) this application uses was written using only a standard AT command set. It uses PPP with an mbed-supported external IP stack. These abilities make the driver essentially generic, or nonvendor specific. However, this particular driver is for onboard-modem types. In other words, the 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://docs.mbed.com/docs/mbed-os-api-reference/en/latest/APIs/communication/cellular/).
75
74
76
-
Examples of mbed-enabled boards with onboard modem chips can be,[u-blox C027](https://developer.mbed.org/platforms/u-blox-C027/) and [MultiTech MTS Dragonfly](https://developer.mbed.org/platforms/MTS-Dragonfly/).
75
+
Examples of mbed Enabled boards with onboard modem chips include[u-blox C027](https://developer.mbed.org/platforms/u-blox-C027/) and [MultiTech MTS Dragonfly](https://developer.mbed.org/platforms/MTS-Dragonfly/).
77
76
78
77
## Compiling the application
79
78
80
-
Use mbed-cli commands to generate a binary for the application, e.g., in case of GCC use the following command:
79
+
Use mbed CLI commands to generate a binary for the application. For example, in the case of GCC, use the following command:
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.
87
+
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.
89
88
90
-
Attatch a serial console emulator of your choice (e.g., putty, minicom, screen etc) to your USB device, set the baudrate to be 115200 and reset your board by pressing reset button.
89
+
Attach a serial console emulator of your choice (for example, PuTTY, Minicom or screen) to your USB device. Set the baudrate to 115200, and reset your board by pressing the reset button.
91
90
92
91
You should see an output similar to this:
93
92
@@ -102,5 +101,4 @@ Received from echo server 4 Bytes
0 commit comments