Daniel Lee / Mbed OS mbed-os-example-cellular-BG96

Test code that Cat.M1 of BG96 for SK Telecom in Korea

This example showing how to use Cat.M1(BG96 module) of SK telecom network in Korea. You need a WIZnet BG96 board or can connect directly to M2Mnet BG96 module and development board.

  • If you are using Mbed OS 5.11.5 version, please see here!
  • Pelion ready example code is here!

board board

Or

/media/uploads/Daniel_Lee/small_pic.jpg

/media/uploads/Daniel_Lee/screen_shot_2019-11-14_at_1.38.16_pm.png

  • BG96 RESET = D7
  • BG96 PWRKEY = D9
  • BG96 RX = D0(or D2)
  • BG96 TX = D1(or D8)
  • BG96 VCC = VCC(5V)
  • BG96 GND = GND

Tested with

  • NUCLEO_F429ZI
  • DISCO_L475VG_IOT01A
  • K66F
  • K64F

Below boards are Need to connect board's D2 and D8 to BG96's TX and RX on mbed_app.json

  • NUCLEO_L152RE
  • NUCLEO_F401RE 

 "QUECTEL_BG96.tx": "D8",
 "QUECTEL_BG96.rx": "D2",

1. Import the application into your desktop:

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

 cd mbed-os-example-cellular-BG96

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: Jul 24 2019, 14:55:22


[MAIN], plmn: NULL
Establishing connection
M2Mnet(BG96) Power ON
[00005501ms][INFO][CELL]: New CellularContext  (20004120)
[00005501ms][INFO][CELL]: CellularContext plmn NULL
[00005502ms][INFO][CELL]: CellularContext connect
[00006503ms][INFO][CELL]: Start connecting (timeout 1000 ms)
[00006512ms][INFO][CELL]: RSSI unknown
[00006520ms][INFO][CELL]: Modem ready
[00006524ms][INFO][CELL]: RSSI unknown
[00006524ms][INFO][CELL]: Setup SIM (timeout 1000 ms)
[00006529ms][INFO][CELL]: SIM is ready
[00006558ms][INFO][CELL]: RSSI unknown
[00006566ms][INFO][CELL]: Network registration (timeout 1000 ms)
[00006570ms][INFO][CELL]: Continue after 1 seconds
[00006964ms][ERR ][CELL]: AT overflow
[00007576ms][INFO][CELL]: RSSI unknown
[00007582ms][INFO][CELL]: Registering network => Attaching network
[00007586ms][INFO][CELL]: RSSI unknown
[00007586ms][INFO][CELL]: Attaching network (timeout 1000 ms)
[00007660ms][INFO][CELL]: Found PDP context 7
[00007663ms][INFO][CELL]: Activate PDP context 7
[00009733ms][INFO][CELL]: Found PDP context 7

Connection Established.
[00009742ms][INFO][CELL]: Socket 0 open
[00009752ms][INFO][CELL]: Socket 1 open
[00009786ms][INFO][CELL]: Socket 1 sent 43 bytes to 8.8.8.8 port 53
[00009967ms][INFO][CELL]: Socket 1 recv 71 bytes from 64:ff9b::808:808 port 53
[00009972ms][INFO][CELL]: Socket 1 closed
TCP: connected with echo.mbedcloudtesting.com server
[00010384ms][INFO][CELL]: Socket 0 sent 4 bytes to 2a05:d018:21f:3800:3164:2a5c7
TCP: Sent 4 Bytes to echo.mbedcloudtesting.com
[00011257ms][INFO][CELL]: Socket 0 recv 4 bytes
[00021263ms][INFO][CELL]: Socket 0 closed
Received from echo server 4 Bytes
[00021263ms][INFO][CELL]: CellularContext disconnect()
[00021264ms][INFO][CELL]: cb: CellularContext disconnected


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

Files at this revision

API Documentation at this revision

Revision 27:97054be1a741, committed 2018-11-22

Comitter:
mbed_official
Date:
Thu Nov 22 10:30:32 2018 +0000
Parent:
26:348eec457e58
Child:
28:232da3ce8a88
Commit message:
Changed to use NSAPI default values for pin, apn, plmn and credentials.

.
Commit copied from https://github.com/ARMmbed/mbed-os-example-cellular

Changed in this revision

main.cpp Show annotated file Show diff for this revision Revisions of this file
mbed_app.json Show annotated file Show diff for this revision Revisions of this file 
--- a/main.cpp	Tue Nov 20 09:45:32 2018 +0000
+++ b/main.cpp	Thu Nov 22 10:30:32 2018 +0000
@@ -22,21 +22,6 @@
 #define UDP 0
 #define TCP 1
 
-// SIM pin code goes here
-#ifndef MBED_CONF_APP_SIM_PIN_CODE
-# define MBED_CONF_APP_SIM_PIN_CODE    "1234"
-#endif
-
-#ifndef MBED_CONF_APP_APN
-# define MBED_CONF_APP_APN         "internet"
-#endif
-#ifndef MBED_CONF_APP_USERNAME
-# define MBED_CONF_APP_USERNAME    NULL
-#endif
-#ifndef MBED_CONF_APP_PASSWORD
-# define MBED_CONF_APP_PASSWORD    NULL
-#endif
-
 // Number of retries /
 #define RETRY_COUNT 3
 
@@ -228,15 +213,11 @@
 #else
     dot_thread.start(dot_event);
 #endif // #if MBED_CONF_MBED_TRACE_ENABLE
+
+    // sim pin, apn, credentials and possible plmn are taken atuomtically from json when using get_default_instance()
     iface = CellularBase::get_default_instance();
     MBED_ASSERT(iface);
 
-    /* Set Pin code for SIM card */
-    iface->set_sim_pin(MBED_CONF_APP_SIM_PIN_CODE);
-
-    /* Set network credentials here, e.g., APN */
-    iface->set_credentials(MBED_CONF_APP_APN, MBED_CONF_APP_USERNAME, MBED_CONF_APP_PASSWORD);
-
     nsapi_error_t retcode = NSAPI_ERROR_NO_CONNECTION;
 
     /* Attempt to connect to a cellular network */

--- a/mbed_app.json	Tue Nov 20 09:45:32 2018 +0000
+++ b/mbed_app.json	Thu Nov 22 10:30:32 2018 +0000
@@ -1,22 +1,6 @@
 {
     "config": {
         "sock-type": "TCP",
-        "sim-pin-code": {
-            "help": "SIM PIN code, set to 0 if none",
-            "value": "\"1234\""
-        },
-        "apn": {
-            "help": "The APN string to use for this SIM/network, set to 0 if none",
-            "value": "\"internet\""
-        },
-        "username": {
-            "help": "The user name string to use for this APN, set to zero if none",
-            "value": 0
-        },
-        "password": {
-            "help": "The password string to use for this APN, set to 0 if none",
-            "value": 0
-        },
         "echo-server-hostname": {
             "help": "Echo server host name.",
             "value": "\"echo.mbedcloudtesting.com\""
@@ -42,7 +26,12 @@
             "platform.stdio-baud-rate": 115200,
             "platform.default-serial-baud-rate": 115200,
             "platform.stdio-buffered-serial": true,
-            "cellular.debug-at": false
+            "cellular.debug-at": false,
+            "nsapi.default-cellular-plmn": 0,
+            "nsapi.default-cellular-sim-pin": "\"1234\"",
+            "nsapi.default-cellular-apn": 0,
+            "nsapi.default-cellular-username": 0,
+            "nsapi.default-cellular-password": 0
         }
     }
 }