Mohamad Nazrin Napiah / Mbed OS http-example

Important changes to repositories hosted on mbed.com

Mbed hosted mercurial repositories are deprecated and are due to be permanently deleted in July 2026.

To keep a copy of this software download the repository Zip archive or clone locally using Mercurial.

It is also possible to export all your personal repositories from the account settings page.

Fork of http-example by sandbox

README.md@30:318e8c07b0f9, 2018-06-28 (annotated)

Committer:
MohamadNazrin
Date:
Thu Jun 28 08:03:16 2018 +0000
Revision:
30:318e8c07b0f9
Parent:
26:22f87edb433c 
mbed http

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Jan Jongboom 0:85fdc69bc10c 1 # mbed-os-example-http(s)
Jan Jongboom 0:85fdc69bc10c 2
Jan Jongboom 0:85fdc69bc10c 3 This application demonstrates how to make HTTP and HTTPS requests and parse the response from mbed OS 5.
Jan Jongboom 0:85fdc69bc10c 4
Jan Jongboom 26:22f87edb433c 5 It consists of six demo's, which you can select in ``source/select-demo.h``.
Jan Jongboom 0:85fdc69bc10c 6
Jan Jongboom 11:72c089200302 7 * HTTP demo:
Jan Jongboom 4:27fd8efb5bab 8 * Does a GET request to http://httpbin.org/status/418.
Jan Jongboom 4:27fd8efb5bab 9 * Does a POST request to http://httpbin.org/post.
Jan Jongboom 11:72c089200302 10 * HTTPS demo:
Jan Jongboom 4:27fd8efb5bab 11 * Does a GET request to https://developer.mbed.org/media/uploads/mbed_official/hello.txt.
Jan Jongboom 4:27fd8efb5bab 12 * Does a POST request to https://httpbin.org/post.
Jan Jongboom 11:72c089200302 13 * HTTP demo with socket re-use.
Jan Jongboom 11:72c089200302 14 * HTTPS demo with socket re-use.
Jan Jongboom 25:a8be9f3a530c 15 * HTTP demo over IPv6.
Jan Jongboom 25:a8be9f3a530c 16 * HTTPS demo with chunked requests.
Jan Jongboom 0:85fdc69bc10c 17
Jan Jongboom 0:85fdc69bc10c 18 Response parsing is done through [nodejs/http-parser](https://github.com/nodejs/http-parser).
Jan Jongboom 0:85fdc69bc10c 19
Jan Jongboom 17:97b1dd566b07 20 **Note:** HTTPS requests do not work on targets with less than 128K of RAM due to the size of the TLS handshake. For more background see [mbed-http](https://developer.mbed.org/teams/sandbox/code/mbed-http).
Jan Jongboom 17:97b1dd566b07 21
Jan Jongboom 0:85fdc69bc10c 22 ## To build
Jan Jongboom 0:85fdc69bc10c 23
Jan Jongboom 0:85fdc69bc10c 24 1. Open ``mbed_app.json`` and change the `network-interface` option to your connectivity method ([more info](https://github.com/ARMmbed/easy-connect)).
Jan Jongboom 0:85fdc69bc10c 25 2. Build the project in the online compiler or using mbed CLI.
Jan Jongboom 0:85fdc69bc10c 26 3. Flash the project to your development board.
Jan Jongboom 0:85fdc69bc10c 27 4. Attach a serial monitor to your board to see the debug messages.
Jan Jongboom 0:85fdc69bc10c 28
Jan Jongboom 0:85fdc69bc10c 29 ## Entropy (or lack thereof)
Jan Jongboom 0:85fdc69bc10c 30
Jan Jongboom 17:97b1dd566b07 31 On all platforms **except** the FRDM-K64F, FRDM-K22F and EVK-ODIN-W2, 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.
Jan Jongboom 0:85fdc69bc10c 32
Jan Jongboom 19:fbf5b033149a 33 ## Flash size
Jan Jongboom 19:fbf5b033149a 34
Jan Jongboom 19:fbf5b033149a 35 Default flash size for HTTPS is very large, as the application is loading the default mbed TLS configuration. To use a more optimized version, include `mbedtls_config.h` in your mbed_app.json, by adding:
Jan Jongboom 19:fbf5b033149a 36
Jan Jongboom 19:fbf5b033149a 37 ```
Jan Jongboom 23:6a9d776c9794 38 "MBEDTLS_CONFIG_FILE=\"mbedtls_config.h\""
Jan Jongboom 19:fbf5b033149a 39 ```
Jan Jongboom 19:fbf5b033149a 40
Jan Jongboom 19:fbf5b033149a 41 to the `macros` array.
Jan Jongboom 19:fbf5b033149a 42
Jan Jongboom 0:85fdc69bc10c 43 ## Tested on
Jan Jongboom 0:85fdc69bc10c 44
Jan Jongboom 0:85fdc69bc10c 45 * K64F with Ethernet.
Jan Jongboom 0:85fdc69bc10c 46 * NUCLEO_F411RE with ESP8266.
Jan Jongboom 17:97b1dd566b07 47 * ODIN-W2 with WiFi.
Jan Jongboom 25:a8be9f3a530c 48 * K64F with Atmel 6LoWPAN shield.