This is an example based on mbed-os cellular APIs that demonstrates a TCP or UDP echo transaction with a public echo server. Included TPB23 NB-IoT module which is can use LGU+ in Korea.

This example is showing how to use the NB-IoT(SECOM TPB23 module) of LGU plus network in Korea. The NB-IoT module' seller provided a document on how to start based on Mbed OS 5.11. (Created by CodeZoo) This guide has been supported to the latest os version which included 5.12 ~ 5.15.

  • if you need specific version of Mbed OS, please revision of TPB23_Driver and check it out.
  • Pelion ready example code is here!

Requirement

462 320 320

320

Tested with

1. Import the application into your desktop

mbed import http://os.mbed.com/users/Daniel_Lee/code/mbed-os-example-cellular-TPB23/

cd mbed-os-example-cellular-TPB23

2. Compile and program

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

(supported toolchains : GCC_ARM / ARM / IAR)

3. Download binary to a target board

4. Result

mbed-os-example-cellular


Built: Aug  7 2019, 06:10:47


[MAIN], plmn: NULL
Establishing connection
[00000001ms][INFO][CELL]: New CellularContext  (20000a08)
[00000002ms][INFO][CELL]: CellularContext plmn NULL
[00000003ms][INFO][CELL]: CellularContext connect
[00000036ms][INFO][CELL]: RSSI -69 dBm
[00000036ms][INFO][CELL]: Start connecting (timeout 1 s)
[00000087ms][INFO][CELL]: RSSI -69 dBm
[00000116ms][INFO][CELL]: Modem ready
[00000146ms][INFO][CELL]: RSSI -69 dBm
[00000146ms][INFO][CELL]: Setup SIM (timeout 1 s)
[00001233ms][INFO][CELL]: Looked up APN internet
[00001362ms][ERR ][CELL]: AT error code 50
[00001362ms][WARN][CELL]: Packet domain event reporting set failed!
[00001393ms][INFO][CELL]: RSSI -65 dBm
[00001393ms][INFO][CELL]: Network registration (timeout 180 s)
[00001443ms][INFO][CELL]: Registering network => Attaching network
[00001473ms][INFO][CELL]: RSSI -65 dBm
[00001473ms][INFO][CELL]: Attaching network (timeout 60 s)
[00001601ms][INFO][CELL]: Found PDP context 1
[00001649ms][INFO][CELL]: Activate PDP context 1


Connection Established.
[00001671ms][INFO][CELL]: Socket 0 open
[00001707ms][INFO][CELL]: Socket 1 open
[00001748ms][INFO][CELL]: Socket create id: 1
[00001883ms][INFO][CELL]: Socket 1 sent 43 bytes to 8.8.8.8 port 53
[00004311ms][INFO][CELL]: Socket 1 recv 59 bytes from 8.8.8.8 port 53
[00004331ms][INFO][CELL]: Close socket: 1 error: 0
[00004331ms][INFO][CELL]: Socket 1 closed
[00004373ms][INFO][CELL]: Socket create id: 1
TCP: connected with echo.mbedcloudtesting.com server
[00004448ms][INFO][CELL]: Socket 0 sent 4 bytes to 52.215.34.155 port 7
TCP: Sent 4 Bytes to echo.mbedcloudtesting.com
[00007560ms][INFO][CELL]: Socket 0 recv 4 bytes
[00007580ms][INFO][CELL]: Close socket: 1 error: 0
[00007580ms][INFO][CELL]: Socket 0 closed
Received from echo server 4 Bytes
[00007581ms][INFO][CELL]: CellularContext disconnect()
[00007630ms][INFO][CELL]: cb: CellularContext disconnected


Success. Exiting
Revision:
47:006469f922f6
Parent:
46:387c2d922a4a
--- a/SERCOMM/TPB23/SERCOMM_TPB23.cpp	Thu Aug 08 08:36:54 2019 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,108 +0,0 @@
-/*
- * Copyright (c) 2017, Arm Limited and affiliates.
- * SPDX-License-Identifier: Apache-2.0
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-#include "SERCOMM_TPB23_CellularNetwork.h"
-#include "SERCOMM_TPB23_CellularContext.h"
-#include "SERCOMM_TPB23_CellularInformation.h"
-#include "SERCOMM_TPB23.h"
-#include "CellularLog.h"
-
-#define CONNECT_DELIM         "\r\n"
-#define CONNECT_BUFFER_SIZE   (1280 + 80 + 80) // AT response + sscanf format
-#define CONNECT_TIMEOUT       8000
-
-using namespace events;
-using namespace mbed;
-
-static const intptr_t cellular_properties[AT_CellularBase::PROPERTY_MAX] = {
-    AT_CellularNetwork::RegistrationModeLAC,        // C_EREG
-    AT_CellularNetwork::RegistrationModeDisable,    // C_GREG
-    AT_CellularNetwork::RegistrationModeDisable,    // C_REG
-    1,  // AT_CGSN_WITH_TYPE
-    0,  // AT_CGDATA
-    0,  // AT_CGAUTH
-    0,  // AT_CNMI
-    0,  // AT_CSMP
-    1,  // AT_CMGF
-    0,  // AT_CSDH
-    1,  // PROPERTY_IPV4_STACK
-    0,  // PROPERTY_IPV6_STACK
-    0,  // PROPERTY_IPV4V6_STACK
-    0,  // PROPERTY_NON_IP_PDP_TYPE
-    0,  // PROPERTY_AT_CGEREP
-};
-
-SERCOMM_TPB23::SERCOMM_TPB23(FileHandle *fh) : AT_CellularDevice(fh)
-{
-    AT_CellularBase::set_cellular_properties(cellular_properties);
-}
-
-nsapi_error_t SERCOMM_TPB23::get_sim_state(SimState &state)
-{
-    _at->lock();
-    _at->flush();
-    _at->cmd_start("AT+NCCID?");
-    _at->cmd_stop();
-    _at->resp_start("+NCCID:");
-    if (_at->info_resp()) {
-        state = SimStateReady;
-    } else {
-        tr_warn("SIM not readable.");
-        state = SimStateUnknown; // SIM may not be ready yet
-    }
-    _at->resp_stop();
-    return _at->unlock_return_error();
-}
-
-AT_CellularNetwork *SERCOMM_TPB23::open_network_impl(ATHandler &at)
-{
-    return new SERCOMM_TPB23_CellularNetwork(at);
-}
-
-AT_CellularContext *SERCOMM_TPB23::create_context_impl(ATHandler &at, const char *apn, bool cp_req, bool nonip_req)
-{
-    return new SERCOMM_TPB23_CellularContext(at, this, apn, cp_req, nonip_req);
-}
-
-AT_CellularInformation *SERCOMM_TPB23::open_information_impl(ATHandler &at)
-{
-    return new SERCOMM_TPB23_CellularInformation(at);
-}
-
-nsapi_error_t SERCOMM_TPB23::init()
-{
-    _at->lock();
-    _at->flush();
-    _at->cmd_start("AT");
-    _at->cmd_stop_read_resp();
-
-    _at->cmd_start("AT+CMEE="); // verbose responses
-    _at->write_int(1);
-    _at->cmd_stop_read_resp();
-
-    return _at->unlock_return_error();
-}
-
-#if MBED_CONF_SERCOMM_TPB23_PROVIDE_DEFAULT
-#include "UARTSerial.h"
-CellularDevice *CellularDevice::get_default_instance()
-{
-    static UARTSerial serial(MBED_CONF_SERCOMM_TPB23_TX, MBED_CONF_SERCOMM_TPB23_RX, MBED_CONF_SERCOMM_TPB23_BAUDRATE);
-    static SERCOMM_TPB23 device(&serial);
-    return &device;
-}
-#endif