This is an example based on mbed-os cellular APIs that demonstrates a TCP or UDP echo transaction with a public echo server.

This code is forked from https://os.mbed.com/teams/mbed-os-examples/code/mbed-os-example-cellular/

This is an example showing how to use Skywire board with LE910-x module.

In this example, I had used the LE910-EUG module for 4G communication. Mbed OS code wasn't changed for LE910-x, because the Telit' HE910 is included mainline code on Mbed OS already. HE910 and LE910 are most similar. Therefore you can use LE910 via HE910 driver. Please check to configure of mbed_app.json, and initialize code for Skywire board of main.cpp.

Open mbed_app.json, you need to define a UART for the MCU to communicate with the xE910 module.

            "TELIT_HE910.tx"                 : "D1",
            "TELIT_HE910.rx"                 : "D0",
            "TELIT_HE910.provide-default"    : true

If you are using Pelion CM, make the following settings:

            "nsapi.default-cellular-apn"     : "\"stream.co.uk\"",
            "nsapi.default-cellular-username": "\"streamip\"",
            "nsapi.default-cellular-password": "\"streamip\"",

For your information, please see Pelion Connectivity Quick start guide.

320

You can find Skywire sensor shield information though NimbeLink site.

Tested with

  • DISCO_L475VG_IOT01A
  • K64F

1. Import the application into your desktop:

 mbed import https://os.mbed.com/users/Daniel_Lee/code/mbed-os-example-cellular-le910/

 cd mbed-os-example-cellular-le910

2. Compile and program:

mbed compile -t GCC_ARM -m DISCO_L475VG_IOT01A

(supported toolchains : GCC_ARM / ARM / IAR)

3. Download binary to a target board

4. Result

mbed-os-example-cellular


Built: Feb  7 2020, 07:02:27
Starting Skywire board with LE910-EUG Demo...
Waiting for Skywire to Boot...
Wait 15 seconds..
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 
Revision:
0:4611f6cf2413
Child:
1:ccaceb0dbbaf
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Jenkinsfile	Thu Mar 08 17:31:37 2018 +0000
@@ -0,0 +1,173 @@
+properties ([[$class: 'ParametersDefinitionProperty', parameterDefinitions: [
+  [$class: 'StringParameterDefinition', name: 'mbed_os_revision', defaultValue: 'mbed-os-5.4', description: 'Revision of mbed-os to build'],
+  [$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}"
+}
+
+// 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"
+  ]
+
+// List of targets with supported modem families
+def target_families = [
+  "UBLOX": ["UBLOX_C027"]
+  ]
+
+// Supported Modems
+def targets = [
+  "UBLOX_C027"
+]
+
+// Map toolchains to compilers
+def toolchains = [
+  ARM: "armcc",
+  GCC_ARM: "arm-none-eabi-gcc",
+  IAR: "iar_arm"
+  ]
+
+// supported socket tests
+def sockets = [
+  "udp",
+  "tcp"
+]
+
+def stepsForParallel = [:]
+
+// Jenkins pipeline does not support map.each, we need to use oldschool for loop
+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++) {
+      for(int l = 0; l < sockets.size(); l++) {
+        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 compilerLabel = toolchains.get(toolchain)
+        def stepName = "${target} ${toolchain}"
+        def socket = sockets.get(l)
+
+        if(allowed_target_type.contains(target)) {
+          stepsForParallel[stepName] = buildStep(target_family, target, compilerLabel, toolchain, socket)
+        }
+      }
+    }
+  }
+}
+
+
+def parallelRunSmoke = [:]
+
+// Need to compare boolean against string value
+if ( params.smoke_test == true ) {
+  // Generate smoke tests based on suite amount
+  for(int i = 0; i < raas.size(); i++) {
+  	for(int j = 0; j < sockets.size(); j++) {
+    	def suite_to_run = raas.keySet().asList().get(i)
+    	def raasPort = raas.get(suite_to_run)
+    	def socket = sockets.get(j)
+    
+    	// Parallel execution needs unique step names. Remove .json file ending.
+    	def smokeStep = "${raasPort} ${suite_to_run.substring(0, suite_to_run.indexOf('.'))}"
+    	parallelRunSmoke[smokeStep] = run_smoke(target_families, raasPort, suite_to_run, toolchains, targets, socket)
+    }
+  }
+}
+
+timestamps {
+  parallel stepsForParallel
+  parallel parallelRunSmoke
+}
+
+def buildStep(target_family, target, compilerLabel, toolchain, socket) {
+  return {
+    stage ("${target_family}_${target}_${compilerLabel}") {
+      node ("${compilerLabel}") {
+        deleteDir()
+        dir("mbed-os-example-cellular") {
+          checkout scm
+          def config_file = "mbed_app.json"
+
+          // Activate traces
+          //execute("sed -i 's/\"mbed-trace.enable\": false/\"mbed-trace.enable\": true/' ${config_file}")
+
+          //change socket typembed_app.json
+
+
+          execute("sed -i 's/\"sock-type\": .*/\"sock-type\": \"${socket}\",/' ${config_file}")
+
+          // Set mbed-os to revision received as parameter
+          execute ("mbed deploy --protocol ssh")
+          //dir ("mbed-os") {
+          //  execute ("git checkout ${env.MBED_OS_REVISION}")
+          //}
+
+          execute ("mbed compile --build out/${target}_${toolchain}/ -m ${target} -t ${toolchain} -c --app-config ${config_file}")
+        }
+        stash name: "${target}_${toolchain}_${socket}", includes: '**/mbed-os-example-cellular.bin'
+        archive '**/mbed-os-example-cellular.bin'
+        step([$class: 'WsCleanup'])
+      }
+    }
+  }
+}
+
+def run_smoke(target_families, raasPort, suite_to_run, toolchains, targets, socket) {
+  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_${raasPort}_${suiteName}") {
+      //node is actually the type of machine, i.e., mesh-test boild down to linux
+      node ("mesh-test") {
+        deleteDir()
+        dir("mbed-clitest") {
+          git "git@github.com:ARMmbed/mbed-clitest.git"
+          execute("git checkout master")
+          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 < 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)
+
+                 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}/**/*"
+        }
+      }
+    }
+  }
+}
\ No newline at end of file