Atmel AVR262 Installation and operating instructions

Atmel AVR262: Atmel QTouch with USB HID

Features

• Single-chip solution

- Atmel®QTouch®and USB HID on the Atmel AVR®AT90USB646

• Using QTouch Library

- Eight QTouch keys

- Customized firmware using the Atmel QTouch Library

• Easy portability for different AVR USB devices

• Supports IAR™ and GCC

1 Introduction

This application note illustrates how to use the QTouch Library on the

AT90USB646 microcontroller to provide a single-chip solution for QTouch sensing

through a USB interface. Touch sensor status is acquired and reported over the

USB HID class to a host PC.

Figure 1-1. Block diagram.

8-bit Atmel

Microcontrollers

Application Note

Rev. 8375A-AVR-03/11

2 Atmel AVR262

8375A-AVR-03/11

2 Hardware requirements

•Atmel STK®600, Atmel STK525, or custom board

•Atmel QTouch sensor board

•USB host

Atmel AVR262

8375A-AVR-03/11

3 Application overview

This demo application acquires the QTouch key sensed, generates the report, and

sends it to a PC (host) on request. The application is built over the generic USB HID

application, which allows a simple data exchange between the PC (host) and the

device. The PC requests new, available QTouch data from the device on a regular

polling interval. The device will send data if available. Otherwise, a NAK (no

acknowledge) is sent to inform the PC that no data is available. The data package

sent from the device to the PC is referred to as Report IN.

Figure 3-1 gives the generic overview of the application.

Figure 3-1. Application overview.

The reports sent to the host contain a set of bytes that can be used by the user

application. Because this application is using just eight QTouch keys, one byte is

sufficient to transfer the touch status, though this can be modified depending on the

requirement.

In this application, port A and port C are used for touch sensing. When the SNS and

SNSK pins are connected to the same port, the even pin numbers will be used as

SNS pins and the odd pin numbers will be used as SNSK pins.

•PA0, PA2, PA4, PA6 ÆSNS0, SNS1, SNS2, SNS3

•PA1, PA3, PA5, PA7 ÆSNSK0, SNSK1, SNSK2, SNSK3

The least-significant bit (LSB) of the report byte has the value of the sensor

connected to PA0 and PA1. Similarly the next higher bit of the report byte has the

value of the sensor connected to PA2 and PA3. The positions of the sensors in the

report byte are shown in Figure 3-2.

4 Atmel AVR262

8375A-AVR-03/11

Figure 3-2. Touch data in report byte.

When a touch is sensed on a sensor connected to PA0/PA1, the value of the report

byte is 0x01, and when it is sensed at PC4/PC5 the value is 0x40. The report byte

values for the remaining sensors are treated similarly.

Atmel AVR262

8375A-AVR-03/11

4 Touch library integration

To build the application, the appropriate touch header files, assembler files and library

files (which are device and compiler specific) need to be integrated with other source

files. To select the correct device and application-specific library files, refer to the

Library_Selection_Guide.xls file in the Atmel QTouch library root folder. The library

selection guide is also available on the Atmel website.

Select the technology as “QTouch,” the MCU family as “USB AVR,” the MCU type as

“8-bit,” the MCU as “Atmel AT90USB646,” the tool chain as “GCC/IAR,” the ports

available for QTouch as “A, B, C, D, E, F,” and the maximum number of channels as

“8.” By selecting these parameters, the appropriate library files to be included can be

seen.

•libv3g1-8qt-k-0rs.r90 – IAR library file for the respective device

•libavr5g1-8qt-k-0rs.a – GCC library file for the respective device

•qt_asm_tiny_mega.S – assembler file

•touch_qt_config.h

•touch_api.h

6 Atmel AVR262

8375A-AVR-03/11

5 Compiler and assembler options

Building the application in IAR and GCC requires certain options to be set. As both

the compilers are unique in their own way, minor differences are required for each.

This section explains the necessary option settings required for each compiler.

In GCC, open Project Options, and then click on Custom Options. Add these custom

compilation options one by one (refer to Figure 5-1).

-D_QTOUCH_

-DQT_NUM_CHANNELS=8

-DSNS1=A

-DSNSK1=A

-DSNS2=C

-DSNSK2=C

-DQT_DELAY_CYCLES=5

-D_SNS1_SNSK1_SAME_PORT_

-D_SNS2_SNSK2_SAME_PORT_

-DQTOUCH_STUDIO_MASKS

Figure 5-1. GCC compiler options.

For IAR, the options have to be set in the compiler as well as the assembler. In IAR

Project Options, select the C/C++ Compiler category, and on the Preprocessor tab,

the following options should be provided, as shown in Figure 5-2.The same options

should be added in the Assembler category on the Preprocessor tab, as shown in

Figure 5-3.

Atmel AVR262

8375A-AVR-03/11

Figure 5-2. IAR compiler options.

Figure 5-3. IAR assembler options.

8 Atmel AVR262

8375A-AVR-03/11

6 Firmware

This application employs an HID application manager, which includes touch_task.c

and hid_task.c. Figure 6-1 shows the architecture of the firmware with the help of a

block diagram.

Figure 6-1. Firmware architecture.

The touch sensing and report generation are handled in hid_task.c and touch_task.c

and their respective header files.

The various related functions can be grouped into three main categories. The

necessary functions are explained under each relevant category.

•Functions related to initialization

•Touch library APIs

•HID report generation

Atmel AVR262

8375A-AVR-03/11

6.1 Functions related to initialization

6.1.1 config_keys

The config_keys function is responsible for configuring the sensors as keys to the

respective channels.

6.1.2 CHANNEL_t

The CHANNEL_t function specifies the channel number to be configured for a key.

6.1.3 AKS_GROUP

The AKS_GROUP function specifies the adjacent key suppression (AKS®) group

associated with the sensor being configured as “key.”

6.1.4 10u

The 10u function specifies the detect threshold for the sensor.

6.1.5 HYST_6_25

The HYST_6_25 function specifies the detection hysteresis for the sensor.

qt_enable_key( CHANNEL_0, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_1, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_2, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_3, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_4, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_5, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_6, AKS_GROUP_1, 10u, HYST_6_25 );

qt_enable_key( CHANNEL_7, AKS_GROUP_1, 10u, HYST_6_25 );

Refer to the Atmel QTouch user guide for more information on this function.

6.1.6 qt_init_sensing

The qt_init_sensing function is used to initialize the touch sensing for all enabled

channels. All required sensors should be configured before calling this function.

#define qt_init_sensing( ) qt_init_sensing_with_burst(

BURST_FUNC_NAME ,CALCULATE_MASKS)

6.1.7 qt_set_parameters

The qt_set_parameters function is used to initialize the global configuration settings in

the variable qt_config_data of the QTouch acquisition method libraries. In other

words, this will fill the default threshold values in the configuration data structure.

10 Atmel AVR262

8375A-AVR-03/11

6.1.8 touch_init_HID

The touch_init_HID function is responsible for calling the initialization routines related

to touch sensing.

/* Configure the Sensors as keys */

config_keys();

/* initialise touch sensing */

qt_init_sensing();

/* Set the parameters like recalibration threshold,

Max_On_Duration etc in this function by the user */

qt_set_parameters( );

/* configure timer ISR to fire regularly */

init_timer_isr();

6.2 Touch library APIs

6.2.1 touch_measure

The touch_measure function is responsible for measuring the touch sensing.

/*status flags to indicate the re-burst for library*/

uint16_t status_flag = 0u;

uint16_t burst_flag = 0u;

if( time_to_measure_touch )

{

/* clear flag: it's time to measure touch */

time_to_measure_touch = 0u;

{

/* one time measure touch sensors */

status_flag = qt_measure_sensors( current_time_ms_touch );

burst_flag = status_flag & QTLIB_BURST_AGAIN;

}while ( burst_flag) ;

}

Table of contents

Other Atmel Microcontroller manuals

Atmel

Atmel AVR2054 User manual

Atmel

Atmel ATmega328PB Xplained Mini Installation and operating instructions

Atmel

Atmel AT91SAM9 Installation and operating instructions

Atmel

Atmel AVR STK100 User manual

Atmel

Atmel AT88CK109STK3 Installation manual

Atmel

Atmel AVR32918 User manual

Atmel

Atmel MC320 User manual

Atmel

Atmel ATF15 DK3-U Series User manual

Atmel

Atmel develer DevelBoard Blue Quick user guide

Atmel

Atmel SMART ATSAMC21MOTOR User manual

Atmel

Atmel ATtiny25 User manual

Atmel

Atmel Atmel-ICE User manual

Atmel

Atmel SAM4L Xplained Pro User manual

Atmel

Atmel UC3-L0 Xplained Installation and operating instructions

Atmel

Atmel AVR2131 User manual

Atmel

Atmel SAM G55 Xplained Pro User manual

Atmel

Atmel XMEGA A3 series User manual

Atmel

Atmel AT90S2313 User manual

Atmel

Atmel ATmega324PB User manual

Atmel

Atmel AVR2060 User manual

Atmel

Atmel AVR ATtiny10 Series User manual

Atmel

Atmel STK520 User manual

Atmel

Atmel 80C51 Installation and operating instructions

Atmel

Atmel AVR2052 User manual

Popular Microcontroller manuals by other brands

AMS

AMS AS7261 Demo Kit user guide

Novatek

Novatek NT6861 manual

Espressif Systems

Espressif Systems ESP8266 SDK AT Instruction Set

Nuvoton

Nuvoton ISD61S00 ChipCorder Design guide

STMicrolectronics

STMicrolectronics ST7 Assembler Linker user manual

Texas Instruments

Texas Instruments Chipcon CC2420DK user manual

Lantronix

Lantronix Intrinsyc Open-Q 865XR SOM user guide

NEC

NEC 78GK0S/K 1+ Series Application note

Mikroe

Mikroe SEMITECH N-PLC Click Application note

Intel

Intel Agilex user guide

Cypress

Cypress CY4607 HX2VL quick start guide

DIGITAL-LOGIC

DIGITAL-LOGIC MICROSPACE manual

Texas Instruments

Texas Instruments TMS320F2837 D Series Workshop Guide and Lab Manual

CYPRES

CYPRES CY14NVSRAMKIT-001 user guide

Texas Instruments

Texas Instruments INA-DUAL-2AMP-EVM user guide

Espressif Systems

Espressif Systems ESP8266EX Programming guide

Abov

Abov AC33M8128L user manual

Laird

Laird BL654PA user guide