Eric Jung / Mbed OS mbed-os-example-cellular-BG96

BG96 Cat.M1 basic sample for WIZnet IoT Shield based on Mbed-OS Cellular APIs (SK telecom network in Korea)

Overview

This code could be access via Cat.M1(BG96 module) of SK telecom network in Korea. Need a WIZnet IoT Shield BG96 board and development board. The code forked Daniel_Lee's mbed-os-example-cellular-BG96 repository and added some features.

/media/uploads/hkjung/wiznetiotshield_bg96_nucleo-l476rg_stacking.png /media/uploads/hkjung/wiznetiotshield_bg96_nucleo-l476rg_separate.png

Tested with

  • NUCLEO_L476RG
  • DISCO_L475VG_IOT01A
  • K64F

Example functionality

This example showcases the following device functionality:

1. Import the application into your desktop:

mbed import https://os.mbed.com/users/hkjung/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

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

LICENSE@38:8e4d8ba30f9f, 2019-04-29 (annotated)

Committer:
hkjung
Date:
Mon Apr 29 00:37:57 2019 +0000
Revision:
38:8e4d8ba30f9f
Parent:
0:4611f6cf2413 
Added hardware reset function for WIZnet IoT Shield BG96

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 0:4611f6cf2413 1 Apache License
mbed_official 0:4611f6cf2413 2 Version 2.0, January 2004
mbed_official 0:4611f6cf2413 3 http://www.apache.org/licenses/
mbed_official 0:4611f6cf2413 4
mbed_official 0:4611f6cf2413 5 TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
mbed_official 0:4611f6cf2413 6
mbed_official 0:4611f6cf2413 7 1. Definitions.
mbed_official 0:4611f6cf2413 8
mbed_official 0:4611f6cf2413 9 "License" shall mean the terms and conditions for use, reproduction,
mbed_official 0:4611f6cf2413 10 and distribution as defined by Sections 1 through 9 of this document.
mbed_official 0:4611f6cf2413 11
mbed_official 0:4611f6cf2413 12 "Licensor" shall mean the copyright owner or entity authorized by
mbed_official 0:4611f6cf2413 13 the copyright owner that is granting the License.
mbed_official 0:4611f6cf2413 14
mbed_official 0:4611f6cf2413 15 "Legal Entity" shall mean the union of the acting entity and all
mbed_official 0:4611f6cf2413 16 other entities that control, are controlled by, or are under common
mbed_official 0:4611f6cf2413 17 control with that entity. For the purposes of this definition,
mbed_official 0:4611f6cf2413 18 "control" means (i) the power, direct or indirect, to cause the
mbed_official 0:4611f6cf2413 19 direction or management of such entity, whether by contract or
mbed_official 0:4611f6cf2413 20 otherwise, or (ii) ownership of fifty percent (50%) or more of the
mbed_official 0:4611f6cf2413 21 outstanding shares, or (iii) beneficial ownership of such entity.
mbed_official 0:4611f6cf2413 22
mbed_official 0:4611f6cf2413 23 "You" (or "Your") shall mean an individual or Legal Entity
mbed_official 0:4611f6cf2413 24 exercising permissions granted by this License.
mbed_official 0:4611f6cf2413 25
mbed_official 0:4611f6cf2413 26 "Source" form shall mean the preferred form for making modifications,
mbed_official 0:4611f6cf2413 27 including but not limited to software source code, documentation
mbed_official 0:4611f6cf2413 28 source, and configuration files.
mbed_official 0:4611f6cf2413 29
mbed_official 0:4611f6cf2413 30 "Object" form shall mean any form resulting from mechanical
mbed_official 0:4611f6cf2413 31 transformation or translation of a Source form, including but
mbed_official 0:4611f6cf2413 32 not limited to compiled object code, generated documentation,
mbed_official 0:4611f6cf2413 33 and conversions to other media types.
mbed_official 0:4611f6cf2413 34
mbed_official 0:4611f6cf2413 35 "Work" shall mean the work of authorship, whether in Source or
mbed_official 0:4611f6cf2413 36 Object form, made available under the License, as indicated by a
mbed_official 0:4611f6cf2413 37 copyright notice that is included in or attached to the work
mbed_official 0:4611f6cf2413 38 (an example is provided in the Appendix below).
mbed_official 0:4611f6cf2413 39
mbed_official 0:4611f6cf2413 40 "Derivative Works" shall mean any work, whether in Source or Object
mbed_official 0:4611f6cf2413 41 form, that is based on (or derived from) the Work and for which the
mbed_official 0:4611f6cf2413 42 editorial revisions, annotations, elaborations, or other modifications
mbed_official 0:4611f6cf2413 43 represent, as a whole, an original work of authorship. For the purposes
mbed_official 0:4611f6cf2413 44 of this License, Derivative Works shall not include works that remain
mbed_official 0:4611f6cf2413 45 separable from, or merely link (or bind by name) to the interfaces of,
mbed_official 0:4611f6cf2413 46 the Work and Derivative Works thereof.
mbed_official 0:4611f6cf2413 47
mbed_official 0:4611f6cf2413 48 "Contribution" shall mean any work of authorship, including
mbed_official 0:4611f6cf2413 49 the original version of the Work and any modifications or additions
mbed_official 0:4611f6cf2413 50 to that Work or Derivative Works thereof, that is intentionally
mbed_official 0:4611f6cf2413 51 submitted to Licensor for inclusion in the Work by the copyright owner
mbed_official 0:4611f6cf2413 52 or by an individual or Legal Entity authorized to submit on behalf of
mbed_official 0:4611f6cf2413 53 the copyright owner. For the purposes of this definition, "submitted"
mbed_official 0:4611f6cf2413 54 means any form of electronic, verbal, or written communication sent
mbed_official 0:4611f6cf2413 55 to the Licensor or its representatives, including but not limited to
mbed_official 0:4611f6cf2413 56 communication on electronic mailing lists, source code control systems,
mbed_official 0:4611f6cf2413 57 and issue tracking systems that are managed by, or on behalf of, the
mbed_official 0:4611f6cf2413 58 Licensor for the purpose of discussing and improving the Work, but
mbed_official 0:4611f6cf2413 59 excluding communication that is conspicuously marked or otherwise
mbed_official 0:4611f6cf2413 60 designated in writing by the copyright owner as "Not a Contribution."
mbed_official 0:4611f6cf2413 61
mbed_official 0:4611f6cf2413 62 "Contributor" shall mean Licensor and any individual or Legal Entity
mbed_official 0:4611f6cf2413 63 on behalf of whom a Contribution has been received by Licensor and
mbed_official 0:4611f6cf2413 64 subsequently incorporated within the Work.
mbed_official 0:4611f6cf2413 65
mbed_official 0:4611f6cf2413 66 2. Grant of Copyright License. Subject to the terms and conditions of
mbed_official 0:4611f6cf2413 67 this License, each Contributor hereby grants to You a perpetual,
mbed_official 0:4611f6cf2413 68 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
mbed_official 0:4611f6cf2413 69 copyright license to reproduce, prepare Derivative Works of,
mbed_official 0:4611f6cf2413 70 publicly display, publicly perform, sublicense, and distribute the
mbed_official 0:4611f6cf2413 71 Work and such Derivative Works in Source or Object form.
mbed_official 0:4611f6cf2413 72
mbed_official 0:4611f6cf2413 73 3. Grant of Patent License. Subject to the terms and conditions of
mbed_official 0:4611f6cf2413 74 this License, each Contributor hereby grants to You a perpetual,
mbed_official 0:4611f6cf2413 75 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
mbed_official 0:4611f6cf2413 76 (except as stated in this section) patent license to make, have made,
mbed_official 0:4611f6cf2413 77 use, offer to sell, sell, import, and otherwise transfer the Work,
mbed_official 0:4611f6cf2413 78 where such license applies only to those patent claims licensable
mbed_official 0:4611f6cf2413 79 by such Contributor that are necessarily infringed by their
mbed_official 0:4611f6cf2413 80 Contribution(s) alone or by combination of their Contribution(s)
mbed_official 0:4611f6cf2413 81 with the Work to which such Contribution(s) was submitted. If You
mbed_official 0:4611f6cf2413 82 institute patent litigation against any entity (including a
mbed_official 0:4611f6cf2413 83 cross-claim or counterclaim in a lawsuit) alleging that the Work
mbed_official 0:4611f6cf2413 84 or a Contribution incorporated within the Work constitutes direct
mbed_official 0:4611f6cf2413 85 or contributory patent infringement, then any patent licenses
mbed_official 0:4611f6cf2413 86 granted to You under this License for that Work shall terminate
mbed_official 0:4611f6cf2413 87 as of the date such litigation is filed.
mbed_official 0:4611f6cf2413 88
mbed_official 0:4611f6cf2413 89 4. Redistribution. You may reproduce and distribute copies of the
mbed_official 0:4611f6cf2413 90 Work or Derivative Works thereof in any medium, with or without
mbed_official 0:4611f6cf2413 91 modifications, and in Source or Object form, provided that You
mbed_official 0:4611f6cf2413 92 meet the following conditions:
mbed_official 0:4611f6cf2413 93
mbed_official 0:4611f6cf2413 94 (a) You must give any other recipients of the Work or
mbed_official 0:4611f6cf2413 95 Derivative Works a copy of this License; and
mbed_official 0:4611f6cf2413 96
mbed_official 0:4611f6cf2413 97 (b) You must cause any modified files to carry prominent notices
mbed_official 0:4611f6cf2413 98 stating that You changed the files; and
mbed_official 0:4611f6cf2413 99
mbed_official 0:4611f6cf2413 100 (c) You must retain, in the Source form of any Derivative Works
mbed_official 0:4611f6cf2413 101 that You distribute, all copyright, patent, trademark, and
mbed_official 0:4611f6cf2413 102 attribution notices from the Source form of the Work,
mbed_official 0:4611f6cf2413 103 excluding those notices that do not pertain to any part of
mbed_official 0:4611f6cf2413 104 the Derivative Works; and
mbed_official 0:4611f6cf2413 105
mbed_official 0:4611f6cf2413 106 (d) If the Work includes a "NOTICE" text file as part of its
mbed_official 0:4611f6cf2413 107 distribution, then any Derivative Works that You distribute must
mbed_official 0:4611f6cf2413 108 include a readable copy of the attribution notices contained
mbed_official 0:4611f6cf2413 109 within such NOTICE file, excluding those notices that do not
mbed_official 0:4611f6cf2413 110 pertain to any part of the Derivative Works, in at least one
mbed_official 0:4611f6cf2413 111 of the following places: within a NOTICE text file distributed
mbed_official 0:4611f6cf2413 112 as part of the Derivative Works; within the Source form or
mbed_official 0:4611f6cf2413 113 documentation, if provided along with the Derivative Works; or,
mbed_official 0:4611f6cf2413 114 within a display generated by the Derivative Works, if and
mbed_official 0:4611f6cf2413 115 wherever such third-party notices normally appear. The contents
mbed_official 0:4611f6cf2413 116 of the NOTICE file are for informational purposes only and
mbed_official 0:4611f6cf2413 117 do not modify the License. You may add Your own attribution
mbed_official 0:4611f6cf2413 118 notices within Derivative Works that You distribute, alongside
mbed_official 0:4611f6cf2413 119 or as an addendum to the NOTICE text from the Work, provided
mbed_official 0:4611f6cf2413 120 that such additional attribution notices cannot be construed
mbed_official 0:4611f6cf2413 121 as modifying the License.
mbed_official 0:4611f6cf2413 122
mbed_official 0:4611f6cf2413 123 You may add Your own copyright statement to Your modifications and
mbed_official 0:4611f6cf2413 124 may provide additional or different license terms and conditions
mbed_official 0:4611f6cf2413 125 for use, reproduction, or distribution of Your modifications, or
mbed_official 0:4611f6cf2413 126 for any such Derivative Works as a whole, provided Your use,
mbed_official 0:4611f6cf2413 127 reproduction, and distribution of the Work otherwise complies with
mbed_official 0:4611f6cf2413 128 the conditions stated in this License.
mbed_official 0:4611f6cf2413 129
mbed_official 0:4611f6cf2413 130 5. Submission of Contributions. Unless You explicitly state otherwise,
mbed_official 0:4611f6cf2413 131 any Contribution intentionally submitted for inclusion in the Work
mbed_official 0:4611f6cf2413 132 by You to the Licensor shall be under the terms and conditions of
mbed_official 0:4611f6cf2413 133 this License, without any additional terms or conditions.
mbed_official 0:4611f6cf2413 134 Notwithstanding the above, nothing herein shall supersede or modify
mbed_official 0:4611f6cf2413 135 the terms of any separate license agreement you may have executed
mbed_official 0:4611f6cf2413 136 with Licensor regarding such Contributions.
mbed_official 0:4611f6cf2413 137
mbed_official 0:4611f6cf2413 138 6. Trademarks. This License does not grant permission to use the trade
mbed_official 0:4611f6cf2413 139 names, trademarks, service marks, or product names of the Licensor,
mbed_official 0:4611f6cf2413 140 except as required for reasonable and customary use in describing the
mbed_official 0:4611f6cf2413 141 origin of the Work and reproducing the content of the NOTICE file.
mbed_official 0:4611f6cf2413 142
mbed_official 0:4611f6cf2413 143 7. Disclaimer of Warranty. Unless required by applicable law or
mbed_official 0:4611f6cf2413 144 agreed to in writing, Licensor provides the Work (and each
mbed_official 0:4611f6cf2413 145 Contributor provides its Contributions) on an "AS IS" BASIS,
mbed_official 0:4611f6cf2413 146 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
mbed_official 0:4611f6cf2413 147 implied, including, without limitation, any warranties or conditions
mbed_official 0:4611f6cf2413 148 of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
mbed_official 0:4611f6cf2413 149 PARTICULAR PURPOSE. You are solely responsible for determining the
mbed_official 0:4611f6cf2413 150 appropriateness of using or redistributing the Work and assume any
mbed_official 0:4611f6cf2413 151 risks associated with Your exercise of permissions under this License.
mbed_official 0:4611f6cf2413 152
mbed_official 0:4611f6cf2413 153 8. Limitation of Liability. In no event and under no legal theory,
mbed_official 0:4611f6cf2413 154 whether in tort (including negligence), contract, or otherwise,
mbed_official 0:4611f6cf2413 155 unless required by applicable law (such as deliberate and grossly
mbed_official 0:4611f6cf2413 156 negligent acts) or agreed to in writing, shall any Contributor be
mbed_official 0:4611f6cf2413 157 liable to You for damages, including any direct, indirect, special,
mbed_official 0:4611f6cf2413 158 incidental, or consequential damages of any character arising as a
mbed_official 0:4611f6cf2413 159 result of this License or out of the use or inability to use the
mbed_official 0:4611f6cf2413 160 Work (including but not limited to damages for loss of goodwill,
mbed_official 0:4611f6cf2413 161 work stoppage, computer failure or malfunction, or any and all
mbed_official 0:4611f6cf2413 162 other commercial damages or losses), even if such Contributor
mbed_official 0:4611f6cf2413 163 has been advised of the possibility of such damages.
mbed_official 0:4611f6cf2413 164
mbed_official 0:4611f6cf2413 165 9. Accepting Warranty or Additional Liability. While redistributing
mbed_official 0:4611f6cf2413 166 the Work or Derivative Works thereof, You may choose to offer,
mbed_official 0:4611f6cf2413 167 and charge a fee for, acceptance of support, warranty, indemnity,
mbed_official 0:4611f6cf2413 168 or other liability obligations and/or rights consistent with this
mbed_official 0:4611f6cf2413 169 License. However, in accepting such obligations, You may act only
mbed_official 0:4611f6cf2413 170 on Your own behalf and on Your sole responsibility, not on behalf
mbed_official 0:4611f6cf2413 171 of any other Contributor, and only if You agree to indemnify,
mbed_official 0:4611f6cf2413 172 defend, and hold each Contributor harmless for any liability
mbed_official 0:4611f6cf2413 173 incurred by, or claims asserted against, such Contributor by reason
mbed_official 0:4611f6cf2413 174 of your accepting any such warranty or additional liability.
mbed_official 0:4611f6cf2413 175
mbed_official 0:4611f6cf2413 176 END OF TERMS AND CONDITIONS
mbed_official 0:4611f6cf2413 177
mbed_official 0:4611f6cf2413 178 APPENDIX: How to apply the Apache License to your work.
mbed_official 0:4611f6cf2413 179
mbed_official 0:4611f6cf2413 180 To apply the Apache License to your work, attach the following
mbed_official 0:4611f6cf2413 181 boilerplate notice, with the fields enclosed by brackets "{}"
mbed_official 0:4611f6cf2413 182 replaced with your own identifying information. (Don't include
mbed_official 0:4611f6cf2413 183 the brackets!) The text should be enclosed in the appropriate
mbed_official 0:4611f6cf2413 184 comment syntax for the file format. We also recommend that a
mbed_official 0:4611f6cf2413 185 file or class name and description of purpose be included on the
mbed_official 0:4611f6cf2413 186 same "printed page" as the copyright notice for easier
mbed_official 0:4611f6cf2413 187 identification within third-party archives.
mbed_official 0:4611f6cf2413 188
mbed_official 0:4611f6cf2413 189 Copyright {yyyy} {name of copyright owner}
mbed_official 0:4611f6cf2413 190
mbed_official 0:4611f6cf2413 191 Licensed under the Apache License, Version 2.0 (the "License");
mbed_official 0:4611f6cf2413 192 you may not use this file except in compliance with the License.
mbed_official 0:4611f6cf2413 193 You may obtain a copy of the License at
mbed_official 0:4611f6cf2413 194
mbed_official 0:4611f6cf2413 195 http://www.apache.org/licenses/LICENSE-2.0
mbed_official 0:4611f6cf2413 196
mbed_official 0:4611f6cf2413 197 Unless required by applicable law or agreed to in writing, software
mbed_official 0:4611f6cf2413 198 distributed under the License is distributed on an "AS IS" BASIS,
mbed_official 0:4611f6cf2413 199 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
mbed_official 0:4611f6cf2413 200 See the License for the specific language governing permissions and
mbed_official 0:4611f6cf2413 201 limitations under the License.
mbed_official 0:4611f6cf2413 202