Demonstration program with support for the WNC M14A2A Cellular LTE Data Module added. An additional demonstration program was also added that shows a few other features (for chunked responses).

Dependencies:   easy-connect mbed-http

mbed-os-example-http(s) using WNC 14A2A Data Module

This application builds on the application provided by ARM (see https://developer.mbed.org/teams/sandbox/code/mbed-http/). It demonstrates how to make HTTP and HTTPS requests and parse the response from mbed OS 5.

There are a total of five demo's, which can be selected by modifying source/select-demo.h.

1. HTTP demo (DEMO_HTTP):

2. HTTPS demo (DEMO_HTTPS):

3. HTTP demo with socket re-use (DEMO_HTTP_SOCKET_REUSE).

  • Similar to the HTTP demo but reuses the socket for all interactions

4. HTTPS demo with socket re-use (DEMO_HTTPS_SOCKET_REUSE).

  • Similar to the HTTPS demo above

5. HTTP & HTTPS demo with socket re-use and chunked call-backs (DEMO_HTTPx)

Response parsing is done through [nodejs/http-parser](https://github.com/nodejs/http-parser).

To build

1. Open ``mbed_app.json`` and change the `network-interface` option to your connectivity method ([more info](https://github.com/ARMmbed/easy-connect)). 2. Build the project in the online compiler or using mbed CLI. 3. Flash the project to your development board. 4. Attach a serial monitor to your board to see the debug messages.

Entropy (or lack thereof)

On all platforms except the FRDM-K64F and FRDM-K22F the application is compiled without TLS entropy sources. This means that your code is inherently unsafe and should not be deployed to any production systems. To enable entropy, remove the `MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES` and `MBEDTLS_TEST_NULL_ENTROPY` macros from mbed_app.json.

Tested on

  • K64F with Ethernet.
  • NUCLEO_F411RE with ESP8266.
  • AT&T Cellular IoT Starter Kit with WNC M14A2A Cellular Data Module

The WNCInterface class currently supports the following version(s):

  • MPSS: M14A2A_v11.50.164451 APSS: M14A2A_v11.53.164451

License

This library is released under the Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License and may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Committer:
root@developer-sjc-cyan-compiler.local.mbed.org
Date:
Sun Apr 23 18:40:19 2017 +0000
Revision:
19:0859fa46f32a
Parent:
4:27fd8efb5bab
Added tag att_cellular_K64_wnc_14A2A_20170423 for changeset 2a891e583ec4

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jan Jongboom 0:85fdc69bc10c 1 /*
Jan Jongboom 0:85fdc69bc10c 2 * Copyright (C) 2006-2016, ARM Limited, All Rights Reserved
Jan Jongboom 0:85fdc69bc10c 3 * SPDX-License-Identifier: Apache-2.0
Jan Jongboom 0:85fdc69bc10c 4 *
Jan Jongboom 0:85fdc69bc10c 5 * Licensed under the Apache License, Version 2.0 (the "License"); you may
Jan Jongboom 0:85fdc69bc10c 6 * not use this file except in compliance with the License.
Jan Jongboom 0:85fdc69bc10c 7 * You may obtain a copy of the License at
Jan Jongboom 0:85fdc69bc10c 8 *
Jan Jongboom 0:85fdc69bc10c 9 * http://www.apache.org/licenses/LICENSE-2.0
Jan Jongboom 0:85fdc69bc10c 10 *
Jan Jongboom 0:85fdc69bc10c 11 * Unless required by applicable law or agreed to in writing, software
Jan Jongboom 0:85fdc69bc10c 12 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
Jan Jongboom 0:85fdc69bc10c 13 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Jan Jongboom 0:85fdc69bc10c 14 * See the License for the specific language governing permissions and
Jan Jongboom 0:85fdc69bc10c 15 * limitations under the License.
Jan Jongboom 0:85fdc69bc10c 16 *
Jan Jongboom 0:85fdc69bc10c 17 * This file is part of mbed TLS (https://tls.mbed.org)
Jan Jongboom 0:85fdc69bc10c 18 */
Jan Jongboom 0:85fdc69bc10c 19
Jan Jongboom 0:85fdc69bc10c 20 #include "select-demo.h"
Jan Jongboom 0:85fdc69bc10c 21
Jan Jongboom 0:85fdc69bc10c 22 /* Enable entropy for K64F and K22F. This means entropy is disabled for all other targets. */
Jan Jongboom 0:85fdc69bc10c 23 /* Do **NOT** deploy this code in production on other targets! */
Jan Jongboom 0:85fdc69bc10c 24 /* See https://tls.mbed.org/kb/how-to/add-entropy-sources-to-entropy-pool */
Jan Jongboom 0:85fdc69bc10c 25 #if defined(TARGET_K64F) || defined(TARGET_K22F)
Jan Jongboom 0:85fdc69bc10c 26 #undef MBEDTLS_NO_DEFAULT_ENTROPY_SOURCES
Jan Jongboom 0:85fdc69bc10c 27 #undef MBEDTLS_TEST_NULL_ENTROPY
Jan Jongboom 0:85fdc69bc10c 28 #endif
Jan Jongboom 0:85fdc69bc10c 29
Jan Jongboom 2:4b4ac59ff9b0 30 #if DEMO == DEMO_HTTPS
Jan Jongboom 2:4b4ac59ff9b0 31
Jan Jongboom 0:85fdc69bc10c 32 #if !defined(MBEDTLS_ENTROPY_HARDWARE_ALT) && \
Jan Jongboom 0:85fdc69bc10c 33 !defined(MBEDTLS_ENTROPY_NV_SEED) && !defined(MBEDTLS_TEST_NULL_ENTROPY)
Jan Jongboom 0:85fdc69bc10c 34 #error "This hardware does not have an entropy source."
Jan Jongboom 0:85fdc69bc10c 35 #endif /* !MBEDTLS_ENTROPY_HARDWARE_ALT && !MBEDTLS_ENTROPY_NV_SEED &&
Jan Jongboom 0:85fdc69bc10c 36 * !MBEDTLS_TEST_NULL_ENTROPY */
Jan Jongboom 0:85fdc69bc10c 37
Jan Jongboom 0:85fdc69bc10c 38 #if !defined(MBEDTLS_SHA1_C)
Jan Jongboom 0:85fdc69bc10c 39 #define MBEDTLS_SHA1_C
Jan Jongboom 0:85fdc69bc10c 40 #endif /* !MBEDTLS_SHA1_C */
Jan Jongboom 0:85fdc69bc10c 41
Jan Jongboom 4:27fd8efb5bab 42 #if !defined(MBEDTLS_RSA_C)
Jan Jongboom 4:27fd8efb5bab 43 #define MBEDTLS_RSA_C
Jan Jongboom 4:27fd8efb5bab 44 #endif /* !MBEDTLS_RSA_C */
Jan Jongboom 4:27fd8efb5bab 45
Jan Jongboom 0:85fdc69bc10c 46 /*
Jan Jongboom 0:85fdc69bc10c 47 * This value is sufficient for handling 2048 bit RSA keys.
Jan Jongboom 0:85fdc69bc10c 48 *
Jan Jongboom 0:85fdc69bc10c 49 * Set this value higher to enable handling larger keys, but be aware that this
Jan Jongboom 0:85fdc69bc10c 50 * will increase the stack usage.
Jan Jongboom 0:85fdc69bc10c 51 */
Jan Jongboom 4:27fd8efb5bab 52 #define MBEDTLS_MPI_MAX_SIZE 1024
Jan Jongboom 0:85fdc69bc10c 53
Jan Jongboom 0:85fdc69bc10c 54 #define MBEDTLS_MPI_WINDOW_SIZE 1
Jan Jongboom 0:85fdc69bc10c 55
Jan Jongboom 0:85fdc69bc10c 56 #endif