Peng Jing Xuan
/
mbed-os-example-wifi-DISCO_IOTBOARD_MQTT_copy
0527
Diff: README.md
- Revision:
- 0:857719181846
- Child:
- 6:9944c5308062
diff -r 000000000000 -r 857719181846 README.md --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.md Wed Oct 26 12:00:05 2016 +0100 @@ -0,0 +1,53 @@ +# mbed-os-example-wifi # + +WiFi example for mbed OS + +## Getting started with the WiFi API ## + +This is a quick example of a simple WiFi application using the WiFi and network-socket APIs that is provided as a part of [mbed-os](github.com/armmbed/mbed-os). + +The program brings up the WiFi and the underlying network interface, and uses it to scans available networks, connects to a network, prints interface and connection details and performs simple HTTP operation. + +### Supported hardware ### + +* [UBLOX Odin board](https://developer.mbed.org/platforms/ublox-EVK-ODIN-W2/) (`UBLOX_EVK_ODIN_W2` target when using mbed CLI) +* Other mbed target with ESP2866 module (Board it's connected to shouldn't have other network interface eg. Ethernet) + +ESP2866 is a fallback option and will be used if the build is for unsupported platform. + +## Getting started + +1. Import the example + + ``` + mbed import mbed-os-example-wifi + cd mbed-os-example-wifi + ``` +2. Configure the WiFi credentials + + Edit ```mbed_app.json``` to include correct SSID and Password: + + ``` + "config": { + "wifi-ssid": { + "help": "WiFi SSID", + "value": "\"SSID\"" + }, + "wifi-password": { + "help": "WiFi Password", + "value": "\"Password\"" + } + }, + ``` + +3. Compile and generate binary + + For example, for `GCC`: + + ``` + mbed compile -t GCC_ARM -m UBLOX_EVK_ODIN_W2 + ``` + +## Documentation ## + +More information on the network-socket API can be found in the [mbed handbook](https://docs.mbed.com/docs/mbed-os-api-reference/en/5.2/APIs/communication/network_sockets/).