This is an example based on mbed-os cellular APIs that demonstrates a TCP or UDP echo transaction with a public echo server. Especially, BG96 operation check based Mbed OS 5.11, tested via SK Telecom in Korea
This code could be access via Cat.M1(BG96 module) of SK telecom network in Korea. Need a WIZnet BG96 board and development board. Before using this code, must be checking your modem is authorized or not from SK telecom. This code is based on Mbed OS 5.11.5.
Tested with
- DISCOVERY_L485VG_IOT01A
- K66F
- K64F
1. Import the application into your desktop
mbed import https://os.mbed.com/users/Daniel_Lee/code/mbed-os-example-cellular-BG96_os511/ cd mbed-os-example-cellular-BG96_os511
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: Jun 4 2019, 13:45:53 [MAIN], plmn: (null) Modem power on Establishing connection .. Connection Established. TCP: connected with echo.mbedcloudtesting.com server TCP: Sent 4 Bytes to echo.mbedcloudtesting.com ...Received from echo server 4 Bytes ... Success. Exiting
5. Patched code
- Based on Mbed OS 5.11.5
- [Patch 1/2] https://github.com/DanielDmlee/mbed-os/commit/6c43e630bd81a47f6e949a36231812c878e237cf
- [Patch 2/2] https://github.com/DanielDmlee/mbed-os/commit/62d6a51c629f1b5d12695ce003227a5ac1324cd9
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/.
Jenkinsfile
- Committer:
- Daniel_Lee
- Date:
- 2019-06-04
- Revision:
- 46:81a8fcab4a6a
- Parent:
- 30:b528cee9bf09
- Child:
- 39:e57f130d65bd
File content as of revision 46:81a8fcab4a6a:
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}/**/*" } } } } }