Human interface on SAML21-XPlain:
Introduction
This example shows how to implement a USB Device CDC on Atmel MCU with USB module. The application note AVR4907 http://ww1.microchip.com/downloads/en/appnotes/doc8447.pdf provides more information about this implementation.
Description of the Communication Device Class (CDC)
The Communication Device Class (CDC) is a general-purpose way to enable all types of communications on the Universal Serial Bus (USB). This class makes it possible to connect communication devices such as digital telephones or analog modems, as well as networking devices like ADSL or Cable modems. While a CDC device enables the implementation of quite complex devices, it can also be used as a very simple method for communication on the USB. For example, a CDC device can appear as a virtual COM port, which greatly simplifies application development on the host side.
Startup
The example is a bridge between a USART from the main MCU and the USB CDC interface.
In this example, we will use a PC as a USB host: it connects to the USB and to the USART board connector.
- Connect the USART peripheral to the USART interface of the board.
- Connect the application to a USB host (e.g. a PC) with a mini-B (embedded side) to A (PC host side) cable. The application will behave as a virtual COM (see Windows Device Manager).
- Open a HyperTerminal on both COM ports (RS232 and Virtual COM)
- Select the same configuration for both COM ports up to 115200 baud.
- Type a character in one HyperTerminal and it will echo in the other.
- Note
- On the first connection of the board on the PC, the operating system will detect a new peripheral:
- This will open a new hardware installation window.
- Choose "No, not this time" to connect to Windows Update for this installation
- click "Next"
- When requested by Windows for a driver INF file, select the atmel_devices_cdc.inf file in the directory indicated in the Atmel Studio "Solution Explorer" window.
- click "Next"
- SAML21 USART used USART connected through EDBG CDC USART Port
- Led 0 blinks when USB is connected and active
- Push SW0 button will generate a wakeup to USB Host in remote wakeup mode.
About example
The example uses the following module groups:
- Basic modules: Startup, board, clock, interrupt, power management
- USB Device stack and CDC modules:
services/usb/
services/usb/udc/
services/usb/class/cdc/
- Specific implementation:
- main.c,
initializes clock
initializes interrupt
manages UI
- uart_xmega.c,
implementation of RS232 bridge for XMEGA parts
- uart_uc3.c,
implementation of RS232 bridge for UC3 parts
- uart_sam.c,
implementation of RS232 bridge for SAM parts
- specific implementation for each target "./examples/product_board/":
- conf_foo.h configuration of each module
- ui.c implement of user's interface (leds,buttons...)