Avnet / Mbed OS http-example-wnc

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.

source/main-http.cpp@7:5d32909f77de, 2017-02-24 (annotated)

Committer:
Jan Jongboom
Date:
Fri Feb 24 11:21:24 2017 +0100
Revision:
7:5d32909f77de
Parent:
5:42f713b19337
Child:
14:3c173847e681
Add chunked encoding, make HttpResponse own response headers

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jan Jongboom 0:85fdc69bc10c 1 #include "select-demo.h"
Jan Jongboom 0:85fdc69bc10c 2
Jan Jongboom 0:85fdc69bc10c 3 #if DEMO == DEMO_HTTP
Jan Jongboom 0:85fdc69bc10c 4
Jan Jongboom 0:85fdc69bc10c 5 #include "mbed.h"
Jan Jongboom 0:85fdc69bc10c 6 #include "easy-connect.h"
Jan Jongboom 0:85fdc69bc10c 7 #include "http_request.h"
Jan Jongboom 0:85fdc69bc10c 8
Jan Jongboom 0:85fdc69bc10c 9 Serial pc(USBTX, USBRX);
Jan Jongboom 0:85fdc69bc10c 10
Jan Jongboom 0:85fdc69bc10c 11 void dump_response(HttpResponse* res) {
Jan Jongboom 0:85fdc69bc10c 12 printf("Status: %d - %s\n", res->get_status_code(), res->get_status_message().c_str());
Jan Jongboom 0:85fdc69bc10c 13
Jan Jongboom 0:85fdc69bc10c 14 printf("Headers:\n");
Jan Jongboom 0:85fdc69bc10c 15 for (size_t ix = 0; ix < res->get_headers_length(); ix++) {
Jan Jongboom 7:5d32909f77de 16 printf("\t%s: %s\n", res->get_headers_fields()[ix]->c_str(), res->get_headers_values()[ix]->c_str());
Jan Jongboom 0:85fdc69bc10c 17 }
Jan Jongboom 5:42f713b19337 18 printf("\nBody (%d bytes):\n\n%s\n", res->get_body_length(), res->get_body_as_string().c_str());
Jan Jongboom 0:85fdc69bc10c 19 }
Jan Jongboom 0:85fdc69bc10c 20
Jan Jongboom 0:85fdc69bc10c 21 int main() {
Jan Jongboom 0:85fdc69bc10c 22 pc.baud(115200);
Jan Jongboom 0:85fdc69bc10c 23 // Connect to the network (see mbed_app.json for the connectivity method used)
Jan Jongboom 0:85fdc69bc10c 24 NetworkInterface *network = easy_connect(true);
Jan Jongboom 0:85fdc69bc10c 25 if (!network) {
Jan Jongboom 0:85fdc69bc10c 26 printf("Cannot connect to the network, see serial output");
Jan Jongboom 0:85fdc69bc10c 27 return 1;
Jan Jongboom 0:85fdc69bc10c 28 }
Jan Jongboom 0:85fdc69bc10c 29
Jan Jongboom 0:85fdc69bc10c 30 // Do a GET request to httpbin.org
Jan Jongboom 5:42f713b19337 31 {
Jan Jongboom 5:42f713b19337 32 HttpRequest* get_req = new HttpRequest(network, HTTP_GET, "http://httpbin.org/status/418");
Jan Jongboom 0:85fdc69bc10c 33
Jan Jongboom 5:42f713b19337 34 // By default the body is automatically parsed and stored in a string, this is memory heavy.
Jan Jongboom 5:42f713b19337 35 // To receive chunked response, pass in a callback as third parameter to 'send'.
Jan Jongboom 5:42f713b19337 36 HttpResponse* get_res = get_req->send();
Jan Jongboom 5:42f713b19337 37 if (!get_res) {
Jan Jongboom 5:42f713b19337 38 printf("HttpRequest failed (error code %d)\n", get_req->get_error());
Jan Jongboom 5:42f713b19337 39 return 1;
Jan Jongboom 5:42f713b19337 40 }
Jan Jongboom 5:42f713b19337 41
Jan Jongboom 5:42f713b19337 42 printf("\n----- HTTP GET response -----\n");
Jan Jongboom 5:42f713b19337 43 dump_response(get_res);
Jan Jongboom 5:42f713b19337 44
Jan Jongboom 5:42f713b19337 45 delete get_req;
Jan Jongboom 0:85fdc69bc10c 46 }
Jan Jongboom 0:85fdc69bc10c 47
Jan Jongboom 0:85fdc69bc10c 48 // POST request to httpbin.org
Jan Jongboom 5:42f713b19337 49 {
Jan Jongboom 5:42f713b19337 50 HttpRequest* post_req = new HttpRequest(network, HTTP_POST, "http://httpbin.org/post");
Jan Jongboom 5:42f713b19337 51 post_req->set_header("Content-Type", "application/json");
Jan Jongboom 0:85fdc69bc10c 52
Jan Jongboom 5:42f713b19337 53 const char body[] = "{\"hello\":\"world\"}";
Jan Jongboom 0:85fdc69bc10c 54
Jan Jongboom 5:42f713b19337 55 HttpResponse* post_res = post_req->send(body, strlen(body));
Jan Jongboom 5:42f713b19337 56 if (!post_res) {
Jan Jongboom 5:42f713b19337 57 printf("HttpRequest failed (error code %d)\n", post_req->get_error());
Jan Jongboom 5:42f713b19337 58 return 1;
Jan Jongboom 5:42f713b19337 59 }
Jan Jongboom 5:42f713b19337 60
Jan Jongboom 5:42f713b19337 61 printf("\n----- HTTP POST response -----\n");
Jan Jongboom 5:42f713b19337 62 dump_response(post_res);
Jan Jongboom 5:42f713b19337 63
Jan Jongboom 5:42f713b19337 64 delete post_req;
Jan Jongboom 0:85fdc69bc10c 65 }
Jan Jongboom 0:85fdc69bc10c 66
Jan Jongboom 0:85fdc69bc10c 67 Thread::wait(osWaitForever);
Jan Jongboom 0:85fdc69bc10c 68 }
Jan Jongboom 0:85fdc69bc10c 69
Jan Jongboom 0:85fdc69bc10c 70 #endif