John Magyar / QT2100

Library for initializing, configuring, and acquiring data from the Atmel QT2100 device. The QT2100 is a capacitive touch controller with 10 configurable QTouch® channels, supporting up to seven buttons, and either one slider or one wheel.

QT2100.cpp@0:2d6c5d39b4de, 2015-01-13 (annotated)

Committer:
armed
Date:
Tue Jan 13 00:11:41 2015 +0000
Revision:
0:2d6c5d39b4de
Initial commit.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
armed 0:2d6c5d39b4de 1
armed 0:2d6c5d39b4de 2 /*
armed 0:2d6c5d39b4de 3 Copyright (c) 2015 John Magyar
armed 0:2d6c5d39b4de 4
armed 0:2d6c5d39b4de 5 Permission is hereby granted, free of charge, to any person obtaining a copy
armed 0:2d6c5d39b4de 6 of this software and associated documentation files (the "Software"), to deal
armed 0:2d6c5d39b4de 7 in the Software without restriction, including without limitation the rights
armed 0:2d6c5d39b4de 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
armed 0:2d6c5d39b4de 9 copies of the Software, and to permit persons to whom the Software is
armed 0:2d6c5d39b4de 10 furnished to do so, subject to the following conditions:
armed 0:2d6c5d39b4de 11
armed 0:2d6c5d39b4de 12 The above copyright notice and this permission notice shall be included in
armed 0:2d6c5d39b4de 13 all copies or substantial portions of the Software.
armed 0:2d6c5d39b4de 14
armed 0:2d6c5d39b4de 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
armed 0:2d6c5d39b4de 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
armed 0:2d6c5d39b4de 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
armed 0:2d6c5d39b4de 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
armed 0:2d6c5d39b4de 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
armed 0:2d6c5d39b4de 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
armed 0:2d6c5d39b4de 21 THE SOFTWARE.
armed 0:2d6c5d39b4de 22 */
armed 0:2d6c5d39b4de 23
armed 0:2d6c5d39b4de 24 #include "QT2100.h"
armed 0:2d6c5d39b4de 25 #include "mbed.h"
armed 0:2d6c5d39b4de 26
armed 0:2d6c5d39b4de 27 /*
armed 0:2d6c5d39b4de 28
armed 0:2d6c5d39b4de 29 Mbed library for the Atmel QT2100 Capacative Touch sensor device.
armed 0:2d6c5d39b4de 30
armed 0:2d6c5d39b4de 31 The QT2100 is a capacitive touch controller device with 10 configurable QTouch channels,
armed 0:2d6c5d39b4de 32 supporting up to seven touch buttons, and either a single slider (or wheel).
armed 0:2d6c5d39b4de 33
armed 0:2d6c5d39b4de 34 Datasheet: http://www.atmel.com/images/at42qt2100_e_level0%2013ww04.pdf
armed 0:2d6c5d39b4de 35
armed 0:2d6c5d39b4de 36 */
armed 0:2d6c5d39b4de 37
armed 0:2d6c5d39b4de 38 QT2100::QT2100(PinName mosi,
armed 0:2d6c5d39b4de 39 PinName miso,
armed 0:2d6c5d39b4de 40 PinName sck,
armed 0:2d6c5d39b4de 41 PinName cs,
armed 0:2d6c5d39b4de 42 PinName tx,
armed 0:2d6c5d39b4de 43 PinName rx):
armed 0:2d6c5d39b4de 44 _spi(mosi, miso, sck),
armed 0:2d6c5d39b4de 45 _cs(cs),
armed 0:2d6c5d39b4de 46 _pc(tx, rx)
armed 0:2d6c5d39b4de 47 {
armed 0:2d6c5d39b4de 48 }
armed 0:2d6c5d39b4de 49
armed 0:2d6c5d39b4de 50 QT2100::~QT2100()
armed 0:2d6c5d39b4de 51 {
armed 0:2d6c5d39b4de 52 }
armed 0:2d6c5d39b4de 53
armed 0:2d6c5d39b4de 54 int qt2100[3];
armed 0:2d6c5d39b4de 55
armed 0:2d6c5d39b4de 56 void QT2100::init() // SPI interface initialization
armed 0:2d6c5d39b4de 57 {
armed 0:2d6c5d39b4de 58 _cs = 1;
armed 0:2d6c5d39b4de 59 _spi.format(8,3);
armed 0:2d6c5d39b4de 60 _spi.frequency(750000);
armed 0:2d6c5d39b4de 61 wait_ms(600);
armed 0:2d6c5d39b4de 62 }
armed 0:2d6c5d39b4de 63
armed 0:2d6c5d39b4de 64 void QT2100::xfer3bytes(int byte0, int byte1, int byte2) // 3-byte SPI transfer
armed 0:2d6c5d39b4de 65 {
armed 0:2d6c5d39b4de 66 int xfer[3] = {byte0, byte1, byte2};
armed 0:2d6c5d39b4de 67
armed 0:2d6c5d39b4de 68 for (int i=0; i<3; i++) {
armed 0:2d6c5d39b4de 69 _cs = 0;
armed 0:2d6c5d39b4de 70 qt2100[i] = _spi.write(xfer[i]);
armed 0:2d6c5d39b4de 71 _cs = 1;
armed 0:2d6c5d39b4de 72 wait_us(100);
armed 0:2d6c5d39b4de 73 }
armed 0:2d6c5d39b4de 74 }
armed 0:2d6c5d39b4de 75
armed 0:2d6c5d39b4de 76 void QT2100::terminalDisplay() // print register values for debugging
armed 0:2d6c5d39b4de 77 {
armed 0:2d6c5d39b4de 78 _pc.printf("\n");
armed 0:2d6c5d39b4de 79 for (int i=0; i<3; i++) {
armed 0:2d6c5d39b4de 80 _pc.printf("QT2100 Byte %d: 0x%x\n",i, qt2100[i]);
armed 0:2d6c5d39b4de 81 }
armed 0:2d6c5d39b4de 82 }
armed 0:2d6c5d39b4de 83
armed 0:2d6c5d39b4de 84 void QT2100::devId() // query Device ID and Firmware version
armed 0:2d6c5d39b4de 85 {
armed 0:2d6c5d39b4de 86 xfer3bytes(0x40, 0x00, 0x00); // flush registers
armed 0:2d6c5d39b4de 87 xfer3bytes(0x40, 0x00, 0x00); // get id and version
armed 0:2d6c5d39b4de 88 terminalDisplay();
armed 0:2d6c5d39b4de 89 }
armed 0:2d6c5d39b4de 90
armed 0:2d6c5d39b4de 91 void QT2100::verifyChannels() // query sensors B1 through B7 and A1 through A3
armed 0:2d6c5d39b4de 92 {
armed 0:2d6c5d39b4de 93 xfer3bytes(0x20, 0x00, 0x00); // flush registers
armed 0:2d6c5d39b4de 94 for (int i=0; i<10; i++) {
armed 0:2d6c5d39b4de 95 xfer3bytes(0x20, i, 0x00); // get each channel's status
armed 0:2d6c5d39b4de 96 terminalDisplay();
armed 0:2d6c5d39b4de 97 }
armed 0:2d6c5d39b4de 98 }
armed 0:2d6c5d39b4de 99
armed 0:2d6c5d39b4de 100 int8_t QT2100::keys() // get data from each key channel
armed 0:2d6c5d39b4de 101 {
armed 0:2d6c5d39b4de 102 int8_t activeKey;
armed 0:2d6c5d39b4de 103
armed 0:2d6c5d39b4de 104 xfer3bytes(0x08, 0x78, 0x41);
armed 0:2d6c5d39b4de 105
armed 0:2d6c5d39b4de 106 switch(qt2100[1]) {
armed 0:2d6c5d39b4de 107 case (0x01):
armed 0:2d6c5d39b4de 108 activeKey = 0x01;
armed 0:2d6c5d39b4de 109 break;
armed 0:2d6c5d39b4de 110 case (0x02):
armed 0:2d6c5d39b4de 111 activeKey = 0x02;
armed 0:2d6c5d39b4de 112 break;
armed 0:2d6c5d39b4de 113 case (0x04):
armed 0:2d6c5d39b4de 114 activeKey = 0x04;
armed 0:2d6c5d39b4de 115 break;
armed 0:2d6c5d39b4de 116 case (0x08):
armed 0:2d6c5d39b4de 117 activeKey = 0x08;
armed 0:2d6c5d39b4de 118 break;
armed 0:2d6c5d39b4de 119 case (0x10):
armed 0:2d6c5d39b4de 120 activeKey = 0x10;
armed 0:2d6c5d39b4de 121 break;
armed 0:2d6c5d39b4de 122 case (0x20):
armed 0:2d6c5d39b4de 123 activeKey = 0x20;
armed 0:2d6c5d39b4de 124 break;
armed 0:2d6c5d39b4de 125 case (0x40):
armed 0:2d6c5d39b4de 126 activeKey = 0x40;
armed 0:2d6c5d39b4de 127 break;
armed 0:2d6c5d39b4de 128 case (0x80):
armed 0:2d6c5d39b4de 129 activeKey = 0x80;
armed 0:2d6c5d39b4de 130 break;
armed 0:2d6c5d39b4de 131 default:
armed 0:2d6c5d39b4de 132 activeKey = 0x00;
armed 0:2d6c5d39b4de 133 }
armed 0:2d6c5d39b4de 134 return activeKey;
armed 0:2d6c5d39b4de 135 }
armed 0:2d6c5d39b4de 136
armed 0:2d6c5d39b4de 137 int8_t QT2100::slider() // get data from the slider channels
armed 0:2d6c5d39b4de 138 {
armed 0:2d6c5d39b4de 139 int8_t sliderPosition;
armed 0:2d6c5d39b4de 140
armed 0:2d6c5d39b4de 141 xfer3bytes(0x08, 0x78, 0x40); // 3 bits resolution, 8 positions (expandable to 8 bits, 256 positions)
armed 0:2d6c5d39b4de 142
armed 0:2d6c5d39b4de 143 switch(qt2100[2]) {
armed 0:2d6c5d39b4de 144 case (0x0):
armed 0:2d6c5d39b4de 145 sliderPosition = 0x01;
armed 0:2d6c5d39b4de 146 break;
armed 0:2d6c5d39b4de 147 case (0x01):
armed 0:2d6c5d39b4de 148 sliderPosition = 0x03;
armed 0:2d6c5d39b4de 149 break;
armed 0:2d6c5d39b4de 150 case (0x02):
armed 0:2d6c5d39b4de 151 sliderPosition = 0x07;
armed 0:2d6c5d39b4de 152 break;
armed 0:2d6c5d39b4de 153 case (0x03):
armed 0:2d6c5d39b4de 154 sliderPosition = 0x0f;
armed 0:2d6c5d39b4de 155 break;
armed 0:2d6c5d39b4de 156 case (0x04):
armed 0:2d6c5d39b4de 157 sliderPosition = 0x1f;
armed 0:2d6c5d39b4de 158 break;
armed 0:2d6c5d39b4de 159 case (0x05):
armed 0:2d6c5d39b4de 160 sliderPosition = 0x3f;
armed 0:2d6c5d39b4de 161 break;
armed 0:2d6c5d39b4de 162 case (0x06):
armed 0:2d6c5d39b4de 163 sliderPosition = 0x7f;
armed 0:2d6c5d39b4de 164 break;
armed 0:2d6c5d39b4de 165 case (0x07):
armed 0:2d6c5d39b4de 166 sliderPosition = 0xff;
armed 0:2d6c5d39b4de 167 break;
armed 0:2d6c5d39b4de 168 default:
armed 0:2d6c5d39b4de 169 sliderPosition = 0x00;
armed 0:2d6c5d39b4de 170 }
armed 0:2d6c5d39b4de 171 return sliderPosition;
armed 0:2d6c5d39b4de 172 }
armed 0:2d6c5d39b4de 173
armed 0:2d6c5d39b4de 174 int8_t QT2100::wheel() // get data from the wheel channels
armed 0:2d6c5d39b4de 175 {
armed 0:2d6c5d39b4de 176 int8_t wheelPosition;
armed 0:2d6c5d39b4de 177
armed 0:2d6c5d39b4de 178 xfer3bytes(0x00, 0x78, 0x40); // 3 bits resolution, 8 positions (expandable to 8 bits, 256 positions)
armed 0:2d6c5d39b4de 179
armed 0:2d6c5d39b4de 180 switch(qt2100[2]) {
armed 0:2d6c5d39b4de 181 case (0x0):
armed 0:2d6c5d39b4de 182 wheelPosition = 0x01;
armed 0:2d6c5d39b4de 183 break;
armed 0:2d6c5d39b4de 184 case (0x01):
armed 0:2d6c5d39b4de 185 wheelPosition = 0x03;
armed 0:2d6c5d39b4de 186 break;
armed 0:2d6c5d39b4de 187 case (0x02):
armed 0:2d6c5d39b4de 188 wheelPosition = 0x07;
armed 0:2d6c5d39b4de 189 break;
armed 0:2d6c5d39b4de 190 case (0x03):
armed 0:2d6c5d39b4de 191 wheelPosition = 0x0f;
armed 0:2d6c5d39b4de 192 break;
armed 0:2d6c5d39b4de 193 case (0x04):
armed 0:2d6c5d39b4de 194 wheelPosition = 0x1f;
armed 0:2d6c5d39b4de 195 break;
armed 0:2d6c5d39b4de 196 case (0x05):
armed 0:2d6c5d39b4de 197 wheelPosition = 0x3f;
armed 0:2d6c5d39b4de 198 break;
armed 0:2d6c5d39b4de 199 case (0x06):
armed 0:2d6c5d39b4de 200 wheelPosition = 0x7f;
armed 0:2d6c5d39b4de 201 break;
armed 0:2d6c5d39b4de 202 case (0x07):
armed 0:2d6c5d39b4de 203 wheelPosition = 0xff;
armed 0:2d6c5d39b4de 204 break;
armed 0:2d6c5d39b4de 205 default:
armed 0:2d6c5d39b4de 206 wheelPosition = 0x00;
armed 0:2d6c5d39b4de 207 }
armed 0:2d6c5d39b4de 208 return wheelPosition;
armed 0:2d6c5d39b4de 209 }