This manual is divided into the following sections:

An introduction to the Control Panel Application

Overview

The Control Panel application is a demonstration application running on top of the freeRTOS.org operating system. Its purpose is to scan onboard sensors and actuators data and events (data acquisition through ADC channels) and make these available to a PC application (known as "AVR32 UC3B Control Panel PC Demo") through a simple USB cable.

The FreeRTOS.org kernel

The Control Panel implementation uses the AVR®32 UC3 FreeRTOS.org kernel port. FreeRTOS.org is a portable, open source, mini Real Time Kernel - a free to download and royalty free RTOS that can be used in commercial applications.

Note: The AVR®32 UC3 FreeRTOS.org kernel port and basic demonstrations is currently available in the AT32UC3-SoftwareFramework-x.x.x.zip package under the SERVICES/FREERTOS folder.

The ATMEL AVR32 USB stack

The Control Panel implementation uses the USB stack (see directory DRIVERS/USBB) and the Full Custom USB class all available in the AT32UC3-SoftwareFramework-x.x.x.zip package.

The Full Custom class is a kind of HID-like class, with the exception that the Full Custom is not supported by operating system, and thus needs a driver to run. More over, HID class works using INTERRUPT endpoints, while the Full Custom class can use either BULK, INTERRUPT, CONTROL or ISOCHRONOUS endpoints.

In this example, the PC application makes use the LIBUSB driver (http://libusb-win32.sourceforge.net/) to communicate with the embedded application. This library simplifies the work of the PC-developper since all the USB layer is managed thanks to the lib. As a consequence, the Full Custom class of the demo is easily managed by the PC application.

Control Panel Environment

Evk1101

This demo was designed to run on the EVK1101 evaluation kit. The content of the EVK1101 board is:

a USB mini A/B connector (thus allowing the board to behave as a USB device or as a USB reduced-host),
1 USART,
8MB Dataflash,
4 monocolor LEDs, [ACTUATOR]
1 temperature sensor, [SENSOR]
2 pushbuttons, [SENSOR]
1 joystick, [SENSOR]
1 light sensor, [SENSOR]
1 accelerometer [SENSOR]

Note: For some elements of the board, we added a functionality tag expressed between[] (e.g. the joystick has the SENSOR functionality).

Power supply.

The EVK1101 board is designed to be powered by a 9V DC power supply. The EVK1101 can be configured to use one of the following two power sources:

9V DC power adapter connected to the power supply jack: to use this configuration, set the PWR switch(the switch should be near the power supply jack) to the EXT position.
5V DC power via the USB miniAB connector: to use this configuration, set the PWR switch(the switch should be near the power supply jack) to the USB position.

PC demo Installation.

First, the PC application shall be installed prior to connecting the EVK1101. This application can be found in the APPLICATIONS/EVK1101-DEMO/PC_APPLI directory. The application needs a Java Runtime Environment (JRE 5.0 or higher).

If you already have installed a JRE, then launch the "AVR32 UC3B Control Panel PC Demo Installer.exe" application and follow the instruction.
If you do not have a JRE, install it from https://cds.sun.com/is-bin/INTERSHOP.enfinity/WFS/CDS-CDS_Developer-Site/en_US/-/USD/ViewProductDetail-Start?ProductRef=jre-6u17-oth-JPR@CDS-CDS_Developer

Both applications are available in the AVR32 Technical Library CD bundled with the EVK1101 and on atmel.com/avr32. When the installation is done, the EVK1101 can be connected to the PC.

Driver installation

For the first plug of the EVK1101 on the PC, the operating system will detect a new peripheral.

New hardware detected.

This will open a new hardware installation window. Choose not to connect to Windows Update for this installation and click `Next':

New hardware detected.

On the next screen, select "Install from a list or specific location (Advanced)" and click `Next'. Then request to search in the usb folder of the "AVR32 UC3B Control Panel PC Demo" installation directory as shown below and click `Next':

Installation.

Windows will then process the installation of the driver. Once completed, click `Finish'.

Installation done.

Power up the board

step 1: Connect the USB cable to the PC and to the EVK1101.

Step 1.
step 2: Set the boards' power switch to VBUS (i.e. power from USB rather than from jack).

Step 2.

The 4 LEDS shall shortly blink: the Control Panel is up & running.

Using the AVR32 UC3B Control Panel PC Demo Application

Launch the AVR32 Control Panel PC Demo application (a shortcut has been added on the desktop after the installation). For the initial start of the application, you must select the target. Choose "EVK1101" in the list. Click "OK": the application will connect to the EVK1101.

Choose the target for the first start of the appli.

It will connect to the EVK1101 through the USB and show the status of the states of the various sensors and actuators.

Sensors Tab

The AVR32 UC3B Control Panel PC Demo shows the states of all the sensors of the EVK1100:

1 temperature sensor (0 to 100%)
1 light sensor (0 to 100%)
2 pushbuttons
1 joystick
1 accelerometer (reports X and Y angles)

AVR32 UC3B Control Panel Firmware

Actuators Tab

The actuator tab shows the state of the LEDS. User have the possibility to control each of them (note that their intensity is adapted in respect of the light sensor when tou go back to the 'sensor tab').

Main Files

main.c : demo main file
device_ctrl_panel_task.c : high level USB device control panel task
device_ctrl_panel_task.h : high level USB device control panel task header
device_mass_storage_task.c : high level USB device mass storage task (note that this feature is disabled in the current release of the demo)
device_mass_storage_task.h : high level USB device mass storage task header
usb_descriptors.c : contains the USB parameters that uniquely identify the USB application through descriptor tables
usb_descriptors.h : contains the USB definitions that uniquely identify the USB application through descriptor tables
usb_specific_request.c : Processing of USB device specific enumeration requests.
usb_specific_request.h : Processing of USB device specific enumeration requests.
FreeRTOSConfig.h : Configuration file of the FreeRTOS kernel
s_accelerometer.c : control panel module managing accelerometer
s_joystick.c : control panel module managing joystick
s_light.c : control panel module managing light sensor
s_pushb.c : control panel module managing push button
s_temperature.c : control panel module managing temperature sensor
cpled.c : control panel module managing leds

Known issues

When the PC appli is running, if a UC3B device reset occurs, then the PC application "-> select target -> EVK1101" is not working anymore.

Contact Information

For further information, visit Atmel AVR32.

Microchip® Advanced Software Framework