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?
User | Revision | Line number | New 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 | } |