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
Jenkinsfile
- Committer:
- Daniel_Lee
- Date:
- 2020-02-10
- Revision:
- 47:006469f922f6
- Parent:
- 30:b528cee9bf09
- Child:
- 39:e57f130d65bd
File content as of revision 47:006469f922f6:
properties ([[$class: 'ParametersDefinitionProperty', parameterDefinitions: [
[$class: 'StringParameterDefinition', name: 'mbed_os_revision', defaultValue: '', description: 'Revision of mbed-os to build. To access mbed-os PR use format "pull/PR number/head"'],
[$class: 'BooleanParameterDefinition', name: 'smoke_test', defaultValue: true, description: 'Runs HW smoke tests on Cellular devices']
]]])
if (env.MBED_OS_REVISION == null) {
echo 'First run in this branch, using default parameter values'
env.MBED_OS_REVISION = ''
}
if (env.MBED_OS_REVISION == '') {
echo 'Using mbed OS revision from mbed-os.lib'
} else {
echo "Using given mbed OS revision: ${env.MBED_OS_REVISION}"
if (env.MBED_OS_REVISION.matches('pull/\\d+/head')) {
echo "Revision is a Pull Request"
}
}
// Map RaaS instances to corresponding test suites
def raas = [
"cellular_smoke_ublox_c027.json": "ruka"
//"cellular_smoke_mtb_mts_dragonfly.json": "8119"
]
// Supported Modems
def targets = [
"UBLOX_C027",
"MTB_MTS_DRAGONFLY",
"UBLOX_C030_U201"
//"MTB_ADV_WISE_1570",
//"K64F"
]
// Map toolchains to compilers
def toolchains = [
ARM: "armcc",
GCC_ARM: "arm-none-eabi-gcc",
IAR: "iar_arm",
ARMC6: "arm6"
]
def stepsForParallel = [:]
// Jenkins pipeline does not support map.each, we need to use oldschool for loop
for (int i = 0; i < targets.size(); i++) {
for(int j = 0; j < toolchains.size(); j++) {
def target = targets.get(i)
def toolchain = toolchains.keySet().asList().get(j)
def compilerLabel = toolchains.get(toolchain)
def stepName = "${target} ${toolchain}"
stepsForParallel[stepName] = buildStep(target, compilerLabel, toolchain)
}
}
def parallelRunSmoke = [:]
// Need to compare boolean against string value
if (params.smoke_test == true) {
echo "Running smoke tests"
// Generate smoke tests based on suite amount
for(int i = 0; i < raas.size(); i++) {
def suite_to_run = raas.keySet().asList().get(i)
def raasName = raas.get(suite_to_run)
// Parallel execution needs unique step names. Remove .json file ending.
def smokeStep = "${raasName} ${suite_to_run.substring(0, suite_to_run.indexOf('.'))}"
parallelRunSmoke[smokeStep] = run_smoke(raasName, suite_to_run, toolchains, targets)
}
} else {
echo "Skipping smoke tests"
}
timestamps {
parallel stepsForParallel
parallel parallelRunSmoke
}
def buildStep(target, compilerLabel, toolchain) {
return {
stage ("${target}_${compilerLabel}") {
node ("${compilerLabel}") {
deleteDir()
dir("mbed-os-example-cellular") {
checkout scm
def config_file = "mbed_app.json"
// Configurations for different targets
if ("${target}" == "UBLOX_C030_U201") {
execute("sed -i 's/internet/JTM2M/' ${config_file}")
}
if ("${target}" == "UBLOX_C027") {
execute("sed -i 's/TCP/UDP/' ${config_file}")
}
if ("${target}" == "MTB_ADV_WISE_1570") {
execute("sed -i 's/TCP/UDP/' ${config_file}")
execute("sed -i 's/\"lwip.ppp-enabled\": true,/\"lwip.ppp-enabled\": false,/' ${config_file}")
execute("sed -i 's/\"platform.default-serial-baud-rate\": 115200,/\"platform.default-serial-baud-rate\": 9600,/' ${config_file}")
}
if ("${target}" == "K64F") {
execute("sed -i 's/TCP/UDP/' ${config_file}")
execute("sed -i 's/\"lwip.ppp-enabled\": true,/\"lwip.ppp-enabled\": false,/' ${config_file}")
execute("sed -i 's/\"target_overrides\": {/\"macros\": [\"CELLULAR_DEVICE=QUECTEL_BG96\", \"MDMRXD=PTC16\", \"MDMTXD=PTC17\"], \"target_overrides\": {/' ${config_file}")
}
// Set mbed-os to revision received as parameter
execute ("mbed deploy --protocol ssh")
if (env.MBED_OS_REVISION != '') {
dir("mbed-os") {
if (env.MBED_OS_REVISION.matches('pull/\\d+/head')) {
// Use mbed-os PR and switch to branch created
execute("git fetch origin ${env.MBED_OS_REVISION}:_PR_")
execute("git checkout _PR_")
} else {
execute ("git checkout ${env.MBED_OS_REVISION}")
}
}
}
execute ("mbed compile --build out/${target}_${toolchain}/ -m ${target} -t ${toolchain} -c --app-config ${config_file}")
}
if ("${target}" == "MTB_ADV_WISE_1570") {
stash name: "${target}_${toolchain}", includes: '**/mbed-os-example-cellular.hex'
archive '**/mbed-os-example-cellular.hex'
}
else {
stash name: "${target}_${toolchain}", includes: '**/mbed-os-example-cellular.bin'
archive '**/mbed-os-example-cellular.bin'
}
step([$class: 'WsCleanup'])
}
}
}
}
def run_smoke(raasName, suite_to_run, toolchains, targets) {
return {
env.RAAS_USERNAME = "user"
env.RAAS_PASSWORD = "user"
// Remove .json from suite name
def suiteName = suite_to_run.substring(0, suite_to_run.indexOf('.'))
stage ("smoke_${raasName}_${suiteName}") {
//node is actually the type of machine, i.e., mesh-test boild down to linux
node ("linux") {
deleteDir()
dir("mbed-clitest") {
git "git@github.com:ARMmbed/mbed-clitest.git"
execute("git checkout ${env.LATEST_CLITEST_STABLE_REL}")
dir("mbed-clitest-suites") {
git "git@github.com:ARMmbed/mbed-clitest-suites.git"
execute("git submodule update --init --recursive")
execute("git all checkout master")
dir("cellular") {
execute("git checkout master")
}
}
for (int i = 0; i < targets.size(); i++) {
for(int j = 0; j < toolchains.size(); j++) {
def target = targets.get(i)
def toolchain = toolchains.keySet().asList().get(j)
unstash "${target}_${toolchain}"
}
}
execute("python clitest.py --suitedir mbed-clitest-suites/suites/ --suite ${suite_to_run} --type hardware --reset \
--raas ${raasName}.mbedcloudtesting.com:80 --tcdir mbed-clitest-suites/cellular --raas_queue --raas_queue_timeout 3600 \
--raas_share_allocs --failure_return_value -vvv -w --log log_${raasName}_${suiteName}")
archive "log_${raasName}_${suiteName}/**/*"
}
}
}
}
}
Daniel Lee