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:
12:4c226ca06191
Added tag att_cellular_K64_wnc_14A2A_20170423 for changeset 2a891e583ec4

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jan Jongboom 12:4c226ca06191 1 #include "select-demo.h"
Jan Jongboom 12:4c226ca06191 2
Jan Jongboom 12:4c226ca06191 3 /**
Jan Jongboom 12:4c226ca06191 4 * This demo shows how to re-use sockets, so the TLS handshake only has to happen once
Jan Jongboom 12:4c226ca06191 5 */
Jan Jongboom 12:4c226ca06191 6
Jan Jongboom 12:4c226ca06191 7 #if DEMO == DEMO_HTTPS_SOCKET_REUSE
Jan Jongboom 12:4c226ca06191 8
Jan Jongboom 12:4c226ca06191 9 #include "mbed.h"
Jan Jongboom 12:4c226ca06191 10 #include "easy-connect.h"
Jan Jongboom 12:4c226ca06191 11 #include "https_request.h"
Jan Jongboom 12:4c226ca06191 12
Jan Jongboom 12:4c226ca06191 13 Serial pc(USBTX, USBRX);
Jan Jongboom 12:4c226ca06191 14
Jan Jongboom 12:4c226ca06191 15 /* List of trusted root CA certificates
Jan Jongboom 12:4c226ca06191 16 * currently one: Let's Encrypt, the CA for httpbin.org
Jan Jongboom 12:4c226ca06191 17 *
Jan Jongboom 12:4c226ca06191 18 * To add more root certificates, just concatenate them.
Jan Jongboom 12:4c226ca06191 19 */
Jan Jongboom 12:4c226ca06191 20 const char SSL_CA_PEM[] = "-----BEGIN CERTIFICATE-----\n"
Jan Jongboom 12:4c226ca06191 21 "MIIEkjCCA3qgAwIBAgIQCgFBQgAAAVOFc2oLheynCDANBgkqhkiG9w0BAQsFADA/\n"
Jan Jongboom 12:4c226ca06191 22 "MSQwIgYDVQQKExtEaWdpdGFsIFNpZ25hdHVyZSBUcnVzdCBDby4xFzAVBgNVBAMT\n"
Jan Jongboom 12:4c226ca06191 23 "DkRTVCBSb290IENBIFgzMB4XDTE2MDMxNzE2NDA0NloXDTIxMDMxNzE2NDA0Nlow\n"
Jan Jongboom 12:4c226ca06191 24 "SjELMAkGA1UEBhMCVVMxFjAUBgNVBAoTDUxldCdzIEVuY3J5cHQxIzAhBgNVBAMT\n"
Jan Jongboom 12:4c226ca06191 25 "GkxldCdzIEVuY3J5cHQgQXV0aG9yaXR5IFgzMIIBIjANBgkqhkiG9w0BAQEFAAOC\n"
Jan Jongboom 12:4c226ca06191 26 "AQ8AMIIBCgKCAQEAnNMM8FrlLke3cl03g7NoYzDq1zUmGSXhvb418XCSL7e4S0EF\n"
Jan Jongboom 12:4c226ca06191 27 "q6meNQhY7LEqxGiHC6PjdeTm86dicbp5gWAf15Gan/PQeGdxyGkOlZHP/uaZ6WA8\n"
Jan Jongboom 12:4c226ca06191 28 "SMx+yk13EiSdRxta67nsHjcAHJyse6cF6s5K671B5TaYucv9bTyWaN8jKkKQDIZ0\n"
Jan Jongboom 12:4c226ca06191 29 "Z8h/pZq4UmEUEz9l6YKHy9v6Dlb2honzhT+Xhq+w3Brvaw2VFn3EK6BlspkENnWA\n"
Jan Jongboom 12:4c226ca06191 30 "a6xK8xuQSXgvopZPKiAlKQTGdMDQMc2PMTiVFrqoM7hD8bEfwzB/onkxEz0tNvjj\n"
Jan Jongboom 12:4c226ca06191 31 "/PIzark5McWvxI0NHWQWM6r6hCm21AvA2H3DkwIDAQABo4IBfTCCAXkwEgYDVR0T\n"
Jan Jongboom 12:4c226ca06191 32 "AQH/BAgwBgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwfwYIKwYBBQUHAQEEczBxMDIG\n"
Jan Jongboom 12:4c226ca06191 33 "CCsGAQUFBzABhiZodHRwOi8vaXNyZy50cnVzdGlkLm9jc3AuaWRlbnRydXN0LmNv\n"
Jan Jongboom 12:4c226ca06191 34 "bTA7BggrBgEFBQcwAoYvaHR0cDovL2FwcHMuaWRlbnRydXN0LmNvbS9yb290cy9k\n"
Jan Jongboom 12:4c226ca06191 35 "c3Ryb290Y2F4My5wN2MwHwYDVR0jBBgwFoAUxKexpHsscfrb4UuQdf/EFWCFiRAw\n"
Jan Jongboom 12:4c226ca06191 36 "VAYDVR0gBE0wSzAIBgZngQwBAgEwPwYLKwYBBAGC3xMBAQEwMDAuBggrBgEFBQcC\n"
Jan Jongboom 12:4c226ca06191 37 "ARYiaHR0cDovL2Nwcy5yb290LXgxLmxldHNlbmNyeXB0Lm9yZzA8BgNVHR8ENTAz\n"
Jan Jongboom 12:4c226ca06191 38 "MDGgL6AthitodHRwOi8vY3JsLmlkZW50cnVzdC5jb20vRFNUUk9PVENBWDNDUkwu\n"
Jan Jongboom 12:4c226ca06191 39 "Y3JsMB0GA1UdDgQWBBSoSmpjBH3duubRObemRWXv86jsoTANBgkqhkiG9w0BAQsF\n"
Jan Jongboom 12:4c226ca06191 40 "AAOCAQEA3TPXEfNjWDjdGBX7CVW+dla5cEilaUcne8IkCJLxWh9KEik3JHRRHGJo\n"
Jan Jongboom 12:4c226ca06191 41 "uM2VcGfl96S8TihRzZvoroed6ti6WqEBmtzw3Wodatg+VyOeph4EYpr/1wXKtx8/\n"
Jan Jongboom 12:4c226ca06191 42 "wApIvJSwtmVi4MFU5aMqrSDE6ea73Mj2tcMyo5jMd6jmeWUHK8so/joWUoHOUgwu\n"
Jan Jongboom 12:4c226ca06191 43 "X4Po1QYz+3dszkDqMp4fklxBwXRsW10KXzPMTZ+sOPAveyxindmjkW8lGy+QsRlG\n"
Jan Jongboom 12:4c226ca06191 44 "PfZ+G6Z6h7mjem0Y+iWlkYcV4PIWL1iwBi8saCbGS5jN2p8M+X+Q7UNKEkROb3N6\n"
Jan Jongboom 12:4c226ca06191 45 "KOqkqm57TH2H3eDJAkSnh6/DNFu0Qg==\n"
Jan Jongboom 12:4c226ca06191 46 "-----END CERTIFICATE-----\n";
Jan Jongboom 12:4c226ca06191 47
Jan Jongboom 12:4c226ca06191 48 void dump_response(HttpResponse* res) {
Jan Jongboom 12:4c226ca06191 49 mbedtls_printf("Status: %d - %s\n", res->get_status_code(), res->get_status_message().c_str());
Jan Jongboom 12:4c226ca06191 50
Jan Jongboom 12:4c226ca06191 51 mbedtls_printf("Headers:\n");
Jan Jongboom 12:4c226ca06191 52 for (size_t ix = 0; ix < res->get_headers_length(); ix++) {
Jan Jongboom 12:4c226ca06191 53 mbedtls_printf("\t%s: %s\n", res->get_headers_fields()[ix]->c_str(), res->get_headers_values()[ix]->c_str());
Jan Jongboom 12:4c226ca06191 54 }
Jan Jongboom 12:4c226ca06191 55 mbedtls_printf("\nBody (%d bytes):\n\n%s\n", res->get_body_length(), res->get_body_as_string().c_str());
Jan Jongboom 12:4c226ca06191 56 }
Jan Jongboom 12:4c226ca06191 57
Jan Jongboom 12:4c226ca06191 58 int main() {
Jan Jongboom 12:4c226ca06191 59 pc.baud(115200);
Jan Jongboom 12:4c226ca06191 60
Jan Jongboom 12:4c226ca06191 61 NetworkInterface* network = easy_connect(true);
Jan Jongboom 12:4c226ca06191 62 if (!network) {
Jan Jongboom 12:4c226ca06191 63 return 1;
Jan Jongboom 12:4c226ca06191 64 }
Jan Jongboom 12:4c226ca06191 65
Jan Jongboom 12:4c226ca06191 66 // Create a TLS socket (which holds a TCPSocket)
Jan Jongboom 12:4c226ca06191 67 printf("\n----- Setting up TLS connection -----\n");
Jan Jongboom 12:4c226ca06191 68
Jan Jongboom 12:4c226ca06191 69 TLSSocket* socket = new TLSSocket(network, "httpbin.org", 443, SSL_CA_PEM);
Jan Jongboom 12:4c226ca06191 70 socket->set_debug(true);
Jan Jongboom 12:4c226ca06191 71 if (socket->connect() != 0) {
Jan Jongboom 12:4c226ca06191 72 printf("TLS Connect failed %d\n", socket->error());
Jan Jongboom 12:4c226ca06191 73 return 1;
Jan Jongboom 12:4c226ca06191 74 }
Jan Jongboom 12:4c226ca06191 75
Jan Jongboom 12:4c226ca06191 76 // GET request to httpbin.org
Jan Jongboom 12:4c226ca06191 77 {
Jan Jongboom 12:4c226ca06191 78 HttpsRequest* get_req = new HttpsRequest(socket, HTTP_GET, "https://httpbin.org/status/418");
Jan Jongboom 12:4c226ca06191 79 get_req->set_debug(true);
Jan Jongboom 12:4c226ca06191 80
Jan Jongboom 12:4c226ca06191 81 HttpResponse* get_res = get_req->send();
Jan Jongboom 12:4c226ca06191 82 if (!get_res) {
Jan Jongboom 12:4c226ca06191 83 printf("HttpRequest failed (error code %d)\n", get_req->get_error());
Jan Jongboom 12:4c226ca06191 84 return 1;
Jan Jongboom 12:4c226ca06191 85 }
Jan Jongboom 12:4c226ca06191 86 printf("\n----- HTTPS GET response -----\n");
Jan Jongboom 12:4c226ca06191 87 dump_response(get_res);
Jan Jongboom 12:4c226ca06191 88
Jan Jongboom 12:4c226ca06191 89 delete get_req;
Jan Jongboom 12:4c226ca06191 90 }
Jan Jongboom 12:4c226ca06191 91
Jan Jongboom 12:4c226ca06191 92 // POST request to httpbin.org
Jan Jongboom 12:4c226ca06191 93 {
Jan Jongboom 12:4c226ca06191 94 HttpsRequest* post_req = new HttpsRequest(socket, HTTP_POST, "https://httpbin.org/post");
Jan Jongboom 12:4c226ca06191 95 post_req->set_debug(true);
Jan Jongboom 12:4c226ca06191 96 post_req->set_header("Content-Type", "application/json");
Jan Jongboom 12:4c226ca06191 97
Jan Jongboom 12:4c226ca06191 98 const char body[] = "{\"hello\":\"world\"}";
Jan Jongboom 12:4c226ca06191 99
Jan Jongboom 12:4c226ca06191 100 HttpResponse* post_res = post_req->send(body, strlen(body));
Jan Jongboom 12:4c226ca06191 101 if (!post_res) {
Jan Jongboom 12:4c226ca06191 102 printf("HttpRequest failed (error code %d)\n", post_req->get_error());
Jan Jongboom 12:4c226ca06191 103 return 1;
Jan Jongboom 12:4c226ca06191 104 }
Jan Jongboom 12:4c226ca06191 105
Jan Jongboom 12:4c226ca06191 106 printf("\n----- HTTPS POST response -----\n");
Jan Jongboom 12:4c226ca06191 107 dump_response(post_res);
Jan Jongboom 12:4c226ca06191 108
Jan Jongboom 12:4c226ca06191 109 delete post_req;
Jan Jongboom 12:4c226ca06191 110 }
Jan Jongboom 12:4c226ca06191 111
Jan Jongboom 12:4c226ca06191 112 delete socket;
Jan Jongboom 12:4c226ca06191 113
Jan Jongboom 12:4c226ca06191 114 Thread::wait(osWaitForever);
Jan Jongboom 12:4c226ca06191 115 }
Jan Jongboom 12:4c226ca06191 116
Jan Jongboom 12:4c226ca06191 117 #endif