Table of Contents
mbed OS 2 and mbed OS 5
This is the handbook for mbed OS 2. If you’re working with mbed OS 5, please see the new handbook and API References. For the latest information about USB, please see Getting the most out of the USB connection.
The Universal Serial Bus (USB) is the most widely used bus in today's computer. USB has particularly been designed to standardize connections between the computer and peripherals. For instance, keyboards, mice, USB audio devices, printers, scanners, disk drives or cameras can use the same bus to exchange data with a computer.
A USB device stack has been developed in order to provide all the great capabilities of USB to mbed.
Boards supporting USB Device¶
Mbed as a USB device¶
The USBMouse class allows to emulate a mouse with your mbed. You can either chose a relative or absolute mouse. This class allows you to:
- move the cursor on the screen
For more information, please visit: USBMouse
The USBKeyboard class allows to use mbed as a keyboard. You can:
- send basic keys
- send "modified keys" such as: CTRL + 'c'
- send media keys (Mute, Volume Up, Volume Down, next track, ...)
For more information, please visit: USBKeyboard
Mouse and Keyboard¶
If you want to have all capabilities from a mouse and a keyboard at the same time, you can use the USBMouseKeyboard class.
For more information, please visit: USBMouseKeyboard
Human Interface Device (HID)¶
The USBHID class is a great opportunity to send and receive raw data to a custom program. This allows you to design your own USB device without any specific drivers on the host side as all operating systems have a built-in HID driver.
For more information, please visit: USBHID
The USBSerial class uses the USB interface to emulate a serial port. The mbed is recognized by the computer as a serial port. This is a great solution to communicate easily between the microcontroller and a computer.
For more information, please visit: USBSerial
Using this library, you can do things like send MIDI messages to a computer (such as to record in a sequencer, or trigger a software synthesiser) and receive messages from a computer (such as actuate things based on MIDI events).
For more information, please visit: USBMIDI
The USBAudio class enables the mbed to be recognized as an audio device. With this interface, you can receive audio packet from the computer (play a music,...) and receive them over USB. For instance you connect a speaker or an I2S/I2C chip to the mbed and play the stream received from the computer.
The USBMSD interface is used to emulate a mass storage device over USB. You can use this class to store or load data to and from a storage chip (SDcard, flash,...). This class implements the MSD protocol and calls pure virtual functions such as disk_initialize, disk_write or disk_read to interact with a storage chip.
For more information, please visit: USBMSD
USB HID Bindings¶
USBHID bindings - Design your own USB device on top of USBHID class by developing programs in different languages and running on different platforms
If you want information concerning the stack architecture, visit the USBDevice stack architecture.