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.

/media/uploads/Daniel_Lee/img_8560.jpg

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

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/.

Revision:
1:ccaceb0dbbaf
Parent:
0:4611f6cf2413
Child:
7:ad3e80a40359
--- a/Jenkinsfile	Thu Mar 08 17:31:37 2018 +0000
+++ b/Jenkinsfile	Fri Mar 09 09:30:19 2018 +0000
@@ -1,41 +1,45 @@
 properties ([[$class: 'ParametersDefinitionProperty', parameterDefinitions: [
-  [$class: 'StringParameterDefinition', name: 'mbed_os_revision', defaultValue: 'mbed-os-5.4', description: 'Revision of mbed-os to build'],
+  [$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']
   ]]])
 
-echo "Run smoke tests: ${params.smoke_test}"
-
-try {
-  echo "Verifying build with mbed-os version ${mbed_os_revision}"
-  env.MBED_OS_REVISION = "${mbed_os_revision}"
-} catch (err) {
-  def mbed_os_revision = "master"
-  echo "Verifying build with mbed-os version ${mbed_os_revision}"
-  env.MBED_OS_REVISION = "${mbed_os_revision}"
+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": "8072"
-  // Currently dragonfly is not supported by RAAS, skip it 
-  //"cellular_smoke_mts_dragonfly.json": "8072"
-  ]
+  //"cellular_smoke_mtb_mts_dragonfly.json": "8119"
+]
 
 // List of targets with supported modem families
 def target_families = [
-  "UBLOX": ["UBLOX_C027"]
-  ]
+  "UBLOX": ["UBLOX_C027"],
+  "DRAGONFLY": ["MTB_MTS_DRAGONFLY"]
+]
 
 // Supported Modems
 def targets = [
-  "UBLOX_C027"
+  "UBLOX_C027",
+  "MTB_MTS_DRAGONFLY"
 ]
 
 // Map toolchains to compilers
 def toolchains = [
   ARM: "armcc",
   GCC_ARM: "arm-none-eabi-gcc",
-  IAR: "iar_arm"
+  IAR: "iar_arm",
+  ARMC6: "arm6"
   ]
 
 // supported socket tests
@@ -67,11 +71,11 @@
   }
 }
 
-
 def parallelRunSmoke = [:]
 
 // Need to compare boolean against string value
-if ( params.smoke_test == true ) {
+if (params.smoke_test == true) {
+  echo "Running smoke tests"
   // Generate smoke tests based on suite amount
   for(int i = 0; i < raas.size(); i++) {
   	for(int j = 0; j < sockets.size(); j++) {
@@ -84,6 +88,8 @@
     	parallelRunSmoke[smokeStep] = run_smoke(target_families, raasPort, suite_to_run, toolchains, targets, socket)
     }
   }
+} else {
+  echo "Skipping smoke tests"
 }
 
 timestamps {
@@ -110,9 +116,17 @@
 
           // Set mbed-os to revision received as parameter
           execute ("mbed deploy --protocol ssh")
-          //dir ("mbed-os") {
-          //  execute ("git checkout ${env.MBED_OS_REVISION}")
-          //}
+          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}")
         }
@@ -132,11 +146,11 @@
     def suiteName = suite_to_run.substring(0, suite_to_run.indexOf('.'))
     stage ("smoke_${raasPort}_${suiteName}") {
       //node is actually the type of machine, i.e., mesh-test boild down to linux
-      node ("mesh-test") {
+      node ("linux") {
         deleteDir()
         dir("mbed-clitest") {
           git "git@github.com:ARMmbed/mbed-clitest.git"
-          execute("git checkout master")
+          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")
@@ -149,23 +163,19 @@
           for (int i = 0; i < target_families.size(); i++) {
             for(int j = 0; j < toolchains.size(); j++) {
               for(int k = 0; k < targets.size(); k++) {
-            	 def target_family = target_families.keySet().asList().get(i)
-                 def allowed_target_type = target_families.get(target_family)
-                 def target = targets.get(k)
-                 def toolchain = toolchains.keySet().asList().get(j)
+                def target_family = target_families.keySet().asList().get(i)
+                def allowed_target_type = target_families.get(target_family)
+                def target = targets.get(k)
+                def toolchain = toolchains.keySet().asList().get(j)
 
-                 if(allowed_target_type.contains(target)) {
-                    unstash "${target}_${toolchain}_${socket}"
-                  }
-              	}
+                if(allowed_target_type.contains(target)) {
+                  unstash "${target}_${toolchain}_${socket}"
+                }
+              }
             }
           }     
-          if ("${suiteName}" == "cellular_smoke_mts_dragonfly")  {
-            execute("python clitest.py --suitedir mbed-clitest-suites/suites/ --suite ${suite_to_run} --type hardware --reset hard --raas 62.44.193.186:${raasPort} --tcdir mbed-clitest-suites/cellular  --failure_return_value -vvv -w --log log_${raasPort}_${suiteName}")
-          } else {
-            execute("python clitest.py --suitedir mbed-clitest-suites/suites/ --suite ${suite_to_run} --type hardware --reset --raas 62.44.193.186:${raasPort} --tcdir mbed-clitest-suites/cellular  --failure_return_value -vvv -w --log log_${raasPort}_${suiteName}")
-          }
-         archive "log_${raasPort}_${suiteName}/**/*"
+          execute("python clitest.py --suitedir mbed-clitest-suites/suites/ --suite ${suite_to_run} --type hardware --reset --raas 62.44.193.186:${raasPort} --tcdir mbed-clitest-suites/cellular  --failure_return_value -vvv -w --log log_${raasPort}_${suiteName}")
+          archive "log_${raasPort}_${suiteName}/**/*"
         }
       }
     }