mbed quickstart
IoT made easy


start here

Setup

Choose your connectivity method (left) and web app backend (right)

mbed Client

Select connectivity method.
Compile in security.h file.

mbed Cloud

Register for an account.
Generate security.h and API key.

Your App

Select web app backend.
Add API key to enable access.

Run

Compile. Load. Execute.

Endpoint

mbed OS - Ethernet

Option 1: Online Compile
  1. Import project into your mbed compiler workspace.
  2. Add security.h file from connector.
  3. Compile, download and then drag and drop code to your mbed Enabled board.
  4. [Optional debug] Hook up a serial terminal to the board for debug messages. You can verify connection to mbed Connector by checking the API Console.
Option 2 : Offline Compile
  1. Clone project to your computer mbed import https://github.com/mbartling/mbed-os-example-client/#b18623e.
  2. Add security.h file from connector.
  3. Compile your code using mbed compile (for more info on mbed-cli see here).
  4. Drag and drop compiled binary (.bin file) from BUILD directory to the board.
  5. Wait for the blinking light to turn solid. This means the connection is complete.
  6. [Optional debug] Hook up a serial terminal to the board for debug messages. You can verify connection to mbed Connector by checking the API Console.

mbed OS - Wi-Fi

Option 1: Online Compile
  1. Import project into your mbed compiler workspace.
  2. Add security.h file from connector.
  3. Change the SSID / PW in mbed_app.json file.
  4. Compile, download and then drag and drop code to your mbed Enabled board.
  5. [Optional debug] Hook up a serial terminal to the board for debug messages. You can verify connection to mbed Connector by checking the API Console.
Option 2 : Offline Compile
  1. Clone project to your computer mbed import https://github.com/mbartling/mbed-os-example-client/#f2674b2.
  2. Add security.h file from connector.
  3. Change the SSID / PW in mbed_app.json file.
  4. Compile your code using mbed compile (for more info on mbed-cli see here).
  5. Drag and drop compiled binary (.bin file) from BUILD directory to the board.
  6. Wait for the blinking light to turn solid. This means the connection is complete.
  7. [Optional debug] Hook up a serial terminal to the board for debug messages. You can verify connection to mbed Connector by checking the API Console.

Troubleshooting

If your board is having trouble connecting to wifi try resetting the system, many embedded wifi peripherals may require multiple connection attempts on their first connection to a new network.

mbed OS - Cellular

TODO

FreeRTOS - Ethernet

TODO

Web App

Heroku

  1. Deploy the app to Heroku by clicking purple button. -> Deploy
  2. Add an environment varialbe called ACCESS_KEY with the value of your API key.
  3. Go to web address Heroku provides (something like yourappname.herokuapp.com).

nodeJS

  1. Grab the code git clone https://github.com/ARMmbed/mbed-connector-api-node-quickstart.
  2. Add your API key to app.js.
  3. Run the app node app.js .
  4. Open a web browser to the address printed on the terminal (usually localhost:8080).

Python

  1. Grab the code git clone https://github.com/ARMmbed/mbed-connector-api-python-quickstart.
  2. Add your API key to app.py.
  3. Install requirements by running pip install -r requirements.txt.
  4. Run the app python app.py.
  5. Open a web browser to the address printed on the terminal (usually localhost:8080).

IBM-Bluemix

TBD

Amazon

TBD

Microsoft

TBD

Explore

Awesome projects based on the quickstart program

Github Build Siren

Alarm for broken builds.

Light Switch

Control wall switch. Measure energy usage.

Minecraft

Minecraft from the real world.