This is a web quickstart application for the mbed-connector-api-python package. The goal of this application is to get the user up and running, using the mbed-connector-python package and talking to devices through mbed Device Connector in under 5 min, 5 steps or less. The quickstart webapp is meant to be paired with the quickstart embedded app. The quickstart web app will allow the user to visualize quickstart embedded devices and interact with them.

Setup¶

• Install the mdc-api package from pip. You may need to use sudo on your system.
  • pip install -U mbed-connector-api
• Get an API key for you application.
• Clone the repository and install the required packages
  • git clone https://github.com/ARMmbed/mbed-connector-api-python-quickstart
  • pip install -r requirements.txt

Run¶

• Put your API keys into the app.py file, replace the following text python token = "Change Me" # replace with your API token or set an environment variable called ACCESS_KEY with the value of your API key.
• Run the app.py file: python ./app.py.
• Open a web page to the web.py server. Usually localhost:8080 will work.
• Interact with the web page, blink the LED's, subscribe to the resources, click the button on the board and see the numbers tick up on the web app.
• Modify : go checkout the API for the mbed-connector-api-python library and make your own applications!

Troubleshooting¶

Here are some common problems and their solutions.

Cannot establish a secure connection

This is most likely caused by not having the requests[security] package installed. If you are using Ubuntu 14.4 LTS you may need to update pip first pip install -U pip and then install the requests security package pip install -U requests[security].

WebSocket transport not available

Dont worry about that warning message, it is not applicable to this demo, but likewise the warning message cannot be disabled.

ERROR 500 on trying to run the app.py file

Make sure you added your Access Key to the app. You can do this by either changing the value of the token variable in the app.py file or by setting the ACCESS_KEY environment variable to your access key.