Tools and accounts
Accounts
- An Mbed OS account
- A Device Management account. If you don't have access to Device Management, request access through the portal.
Hardware
- A supported device, with compatible networking options. See the requirements for production devices or the development devices.
- For Mbed OS development boards, we recommend that you use the latest released DAPLink (minimum required version v0250).
Tools
The tools you need for Device Management Client development:
Tool | Comments |
---|---|
For Mbed OS - follow the respective Mbed OS tool chain recommendations. For other Operating Systems - either the compiler provided in the SDK or GCC. |
Client code itself is generic C/C++ and as such has no special compiler requirements. |
CMake 3.5 or later | |
Serial terminal, such as: * Picocom * Minicom * PuTTY * TeraTerm |
In Linux, you can install Picocom and Minicom using the package manager, for example sudo apt-get install picocom . |
Mbed CLI, follow Mbed OS recommendation. | The Mbed OS development command line tool. |
Mercurial | Installed with the Mbed CLI Windows installer In Linux sudo apt-get install hg . |
git v2.7 or higher | Installed with the Mbed CLI Windows installer. In Linux sudo apt-get install git . If you are starting with git , please configure it. |
Windows serial driver - A serial driver for Windows versions earlier than 10. | Installed with the Mbed CLI Windows installer. |
Python 3.5.1 or higher, and the Python modules requests and click |
Installed with the Mbed CLI Windows installer. In Linux, sudo apt-get install python , For Python modules: get pip and then sudo -H pip install requests click (in Windows just pip install requests click ).We recommend using Python 3. Python 2.7.11 or later also works, but Python 2 will be deprecated 1st January 2020. |
Python virtual environment | Strongly recommended. Python 3 is not compatible with Mbed OS versions older than 5.9 and Mbed CLI toolchain versions earlier than 1.7.2. |
For the Linux target builds, you must also define the environment variable which specifies where the cross-compiler toolchain is installed.
For example:
export GCC_DIR="/opt/bin/<your gcc arm compiler path>/bin"
Notes for Mbed CLI
The development tool for Device Management applications is Mbed CLI, and you need to install it to run tutorials, or to do your own development.
If you are using Windows, you can install Mbed CLI along with all of its dependencies with Mbed OS Windows installer. See Mbed CLI documentation for most recent download links.
If you are not using Windows, or if you prefer a manual Windows installation, see the installation instructions, or follow the process shown in our Windows video tutorial.
Notes for toolchains
GNU Arm GCC
You can download it at GNU Arm Embedded Toolchain. If you used the Windows Mbed CLI installer, you should already have GNU up and running.
For compiling with GCC, use the Arm GCC standalone compiler: arm-none-eabi-gcc
.
Installing the GNU Arm GCC compiler
On Windows
- Download the compiler installer (.exe) version 6.x. Any of the three Windows files is acceptable.
- Install the compiler following the instructions on the installer wizard.
On Mac OS X and Linux
-
Download the OSX or Linux version 6.x of the tarball.
-
Decompress the tarball to your any location, for example
/usr/local
. If you don't havesudo
permissions, you can decompress to your user folder. For example:tar -xvjf /tmp/gcc-arm-none-eabi-6-xxx.tar.bz2 -C ~/
-
Add the GCC toolchain bin folder to your PATH. For example, you can add the following line to the file
~/.bash_profile
(create the file if doesn't exist):export PATH="$PATH:~/<gcc-arm-none-eabi-6-xxx>/bin"
Note: Alternatively, you can run this command to set up the path in the current shell.
Recommended: a virtual environment
You can use a virtual environment to install tools and run tutorials. This keeps the tools dependencies isolated from the rest of your environment, so you can have more than one version installed at a time.
Installation considerations
When using a virtual environment:
- Install
pip
components only in your virtual environments. - Isolate Python 2 and Python 3 components in separate environments to avoid conflicts.
- Do not install components globally.
Tip: These examples are for an sh
shell, such as the shell found in Linux, Mac OS X, or the Windows Subsystem for Linux.
-
Install the virtual environment:
pip2 install virtualenv
-
Change the location of the virtual environment:
mkdir -p ~/virtualenvs virtualenv ~/virtualenvs/manifest-tool
-
Activate the virtual environment:
source ~/virtualenvs/manifest-tool/bin/activate