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
- Need to check CodeZoo's s hardware a guide.
- Need a CodeZoo's NBIoT board and development board.
- Board picture & Jumper configure
- And also can use with mbed application shield, as shown below.

Tested with
- DISCO_L475VG_IOT01A - If you are in Korea, can buy here !
- NUCLEO_F429ZI - If you are in Korea, can buy here !
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
Diff: SERCOMM/TPB23/SERCOMM_TPB23.cpp
- Revision:
- 45:63eba30af193
- Child:
- 46:387c2d922a4a
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/SERCOMM/TPB23/SERCOMM_TPB23.cpp Wed Aug 07 06:31:31 2019 +0000
@@ -0,0 +1,108 @@
+/*
+ * 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
+ 1, // AT_CGDATA
+ 0, // AT_CGAUTH
+ 1, // AT_CNMI
+ 1, // AT_CSMP
+ 1, // AT_CMGF
+ 1, // AT_CSDH
+ 1, // PROPERTY_IPV4_STACK
+ 0, // PROPERTY_IPV6_STACK
+ 0, // PROPERTY_IPV4V6_STACK
+ 0, // PROPERTY_NON_IP_PDP_TYPE
+ 1, // 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
Daniel Lee