Wiki

Below is the source of this page. To edit this source as well as other pages on the wiki, you must login.
====== AD714X Input CapTouch® Programmable Controller Linux Driver ======

===== Supported Devices =====

  * [[adi>AD7142]]
  * [[adi>AD7143]]
  * [[adi>AD7147]]
  * [[adi>AD7147A]]
  * [[adi>AD7148]]

===== Evaluation Boards =====

  * [[adi>EVAL-AD7147EBZ]]
  * [[adi>EVAL-AD7147-1EBZ]]
===== Description =====

==== Capacitance Touch Sensors ====

Capacitance sensors detect a change in capacitance when something or someone approaches or touches the sensor. The technique has been used in industrial applications for many years to measure liquid levels, humidity, and material composition. A newer application, coming into widespread use, is in human-to-machine interfaces. Mechanical buttons, switches, and jog wheels have long been used as the interface between the user and the machine. Because of their many drawbacks, however, interface designers have been increasingly looking for more reliable solutions. Capacitive sensors can be used in the same manner as buttons, but they also can function with greater versatility, for example, when implementing a 128-position scroll bar.

For more info on how these types of sensors work, take a peek at the [[adi>library/analogDialogue/archives/40-10/cap_sensors.html|ADI web site]].


==== Overview ====

Implementing a capacitive touch sensor solution using the AD714x requires three components: 
  * the AD714x capacitive-to-digital converter IC, 
  * sensors on a PCB or Flex Circuit, 
  * software to communicate with the AD714x.

{{http://www.analog.com/analog_root/static/images/overview/CapSystemAppDiagramAD7142_43.gif}}

The sensor traces can be any number of different shapes and sizes. Buttons, wheels, scroll-bar, joypad, and touchpad shapes can be laid out as traces on the sensor PCB.

{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07A.jpg}}
{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07B.jpg}}
{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07C.jpg}}
{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07D.jpg}}
{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07E.jpg}}
{{http://www.analog.com/library/analogDialogue/archives/40-10/AD40-10_07F.jpg}}

Many options for implementing the user interface are available to the designer, ranging from simply replacing mechanical buttons with capacitive button sensors to eliminating buttons by using a joypad with eight output positions, or a scroll wheel that gives 128 output positions.

The number of sensors that can be implemented using a single device depends on the type of sensors required. The AD7142 has 14 capacitance input pins and 12 conversion channels, the AD7143 and AD7148 have 8 capacitance input pins and 8 conversion channels, and the AD7147 and AD7147A have 13 capacitance input pins and 12 conversion channels.


===== Configuration =====


===== Software configurable features =====


====== Source Code ======

===== Status =====

^ Source ^ Mainlined? ^
| [[git.linux.org>drivers/input/misc/ad714x.c|git]] | [[git.linux.org>drivers/input/misc/ad714x.c|Yes]] |

===== Files =====

^ Function ^ File ^
| driver  | [[git.linux.org>drivers/input/misc/ad714x.c]] |
| i2c bus support  | [[git.linux.org>drivers/input/misc/ad714x-i2c.c]] |
| spi bus support  | [[git.linux.org>drivers/input/misc/ad714x-spi.c]] |
| include | [[git.linux.org>include/linux/input/ad714x.h]] |

In Linux, there are three driver modules for the AD714x:
linux-2.6.x/drivers/input/misc/ad714x.c
linux-2.6.x/drivers/input/misc/ad714x-spi.c
linux-2.6.x/drivers/input/misc/ad714x-i2c.c.

ad714x.c fulfills the common arithmetic and state machines for sliders, keypads, touchpads and so on. ad714x-spi.c and ad714x-i2c.c, which call common probe/remove entries in ad714x.c, merge the bottom ad714x driver into Linux SPI/I2C device driver framework. The code included works with the AD7142 and AD7147 demo board.
Note that this code is covered under the GPL - if you want non-GPL source, have a look at ADI's Web site. 
====== Example platform device initialization ======

{{page>software/linux/docs/platform_and_bus_model#Platform Data&noheader&firstseconly&noeditbtn}}

platform data, defines how the PCB info is implemented.

{{page>software/linux/docs/platform_and_bus_model#Declaring I2C devices&firstseconly&noeditbtn}}

For AD7142 demo board, the platform information is:
<source trunk/arch/blackfin/mach-bf537/boards/stamp.c:ad7142_i2c_button_plat{} c linux-kernel>
<source trunk/arch/blackfin/mach-bf537/boards/stamp.c:ad7142_i2c_platform_data{} c linux-kernel>

{{page>software/linux/docs/platform_and_bus_model#Declaring SPI slave devices&firstseconly}}

For AD7147 demo board, the platform information is:
<source trunk/arch/blackfin/mach-bf537/boards/stamp.c:ad7147_spi_slider_plat{} c linux-kernel>
<source trunk/arch/blackfin/mach-bf537/boards/stamp.c:ad7147_spi_button_plat{} c linux-kernel>
<source trunk/arch/blackfin/mach-bf537/boards/stamp.c:ad7147_spi_platform_data{} c linux-kernel>


====== Adding Linux driver support ======

To select it from menuconfig:

<code>
Device Drivers  --->
  Input device support  --->
   [*]   Miscellaneous devices  --->
    <*>   Analog Devices AD714x Capacitance Touch Sensor
       <*>     support I2C bus connection
       <*>     support SPI bus connection
</code>

====== Hardware configuration ======

{{:software:driver:linux:ad7142_schematic.jpg?800|}}

We connected the AD7142 demo board to the TWI/I2C connector and AD7147 demo board to the SPI connector on the BF537 STAMP board.

{{:software:driver:linux:ad7142_stamp537.jpg|}}

For BF537 STAMP board, please set SW5-3 off as the interrupt input.

And For AD7147 eval-board, please set S4-2 on and other positions off.

====== Driver testing ======

Some testing output from the event_test application:

<code>
root:~> modprobe ad7142.ko 
input: ad7142 joystick as /class/input/input0
ad7142_js_attach: at 0x58
root:~> event_test /dev/input/event0 
Input driver version is 1.0.0
Input device ID: bus 0x18 vendor 0x1 product 0x1 version 0x100
Input device name: "ad7142 joystick"
Supported events:
  Event type 0 (Reset)
    Event code 0 (Reset)
    Event code 1 (Key)
  Event type 1 (Key)
    Event code 103 (Up)
    Event code 105 (Left)
    Event code 106 (Right)
    Event code 108 (Down)
    Event code 294 (BaseBtn)
    Event code 295 (BaseBtn2)
    Event code 296 (BaseBtn3)
    Event code 297 (BaseBtn4)
Testing ... (interrupt to exit)
Event: time 398.520833, type 0 (Reset), code 0 (Reset), value 0
Event: time 400.734865, type 1 (Key), code 108 (Down), value 1
Event: time 400.734874, type 0 (Reset), code 0 (Reset), value 0
Event: time 400.853353, type 1 (Key), code 108 (Down), value 0
Event: time 400.853360, type 0 (Reset), code 0 (Reset), value 0
Event: time 400.930182, type 1 (Key), code 103 (Up), value 1
Event: time 400.931390, type 0 (Reset), code 0 (Reset), value 0
Event: time 401.046258, type 1 (Key), code 103 (Up), value 0
Event: time 401.047461, type 0 (Reset), code 0 (Reset), value 0
Event: time 402.361193, type 1 (Key), code 294 (BaseBtn), value 1
Event: time 402.362403, type 0 (Reset), code 0 (Reset), value 0
Event: time 402.555558, type 1 (Key), code 294 (BaseBtn), value 0
Event: time 402.556760, type 0 (Reset), code 0 (Reset), value 0
Event: time 402.942508, type 1 (Key), code 295 (BaseBtn2), value 1
Event: time 402.942516, type 0 (Reset), code 0 (Reset), value 0
</code>


====== More Information ======

{{page>resources/tools-software/linux-drivers/snippets#input_pointers&noheader&firstseconly&noeditbtn}}
Analog Devices Wiki

Page Tools
