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.
Revision 0:2d6c5d39b4de, committed 2015-01-13
- Comitter:
- armed
- Date:
- Tue Jan 13 00:11:41 2015 +0000
- Commit message:
- Initial commit.
Changed in this revision
QT2100.cpp | Show annotated file Show diff for this revision Revisions of this file |
QT2100.h | Show annotated file Show diff for this revision Revisions of this file |
diff -r 000000000000 -r 2d6c5d39b4de QT2100.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/QT2100.cpp Tue Jan 13 00:11:41 2015 +0000 @@ -0,0 +1,209 @@ + +/* +Copyright (c) 2015 John Magyar + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +*/ + +#include "QT2100.h" +#include "mbed.h" + +/* + +Mbed library for the Atmel QT2100 Capacative Touch sensor device. + +The QT2100 is a capacitive touch controller device with 10 configurable QTouch channels, +supporting up to seven touch buttons, and either a single slider (or wheel). + +Datasheet: http://www.atmel.com/images/at42qt2100_e_level0%2013ww04.pdf + +*/ + +QT2100::QT2100(PinName mosi, + PinName miso, + PinName sck, + PinName cs, + PinName tx, + PinName rx): + _spi(mosi, miso, sck), + _cs(cs), + _pc(tx, rx) +{ +} + +QT2100::~QT2100() +{ +} + +int qt2100[3]; + +void QT2100::init() // SPI interface initialization +{ + _cs = 1; + _spi.format(8,3); + _spi.frequency(750000); + wait_ms(600); +} + +void QT2100::xfer3bytes(int byte0, int byte1, int byte2) // 3-byte SPI transfer +{ + int xfer[3] = {byte0, byte1, byte2}; + + for (int i=0; i<3; i++) { + _cs = 0; + qt2100[i] = _spi.write(xfer[i]); + _cs = 1; + wait_us(100); + } +} + +void QT2100::terminalDisplay() // print register values for debugging +{ + _pc.printf("\n"); + for (int i=0; i<3; i++) { + _pc.printf("QT2100 Byte %d: 0x%x\n",i, qt2100[i]); + } +} + +void QT2100::devId() // query Device ID and Firmware version +{ + xfer3bytes(0x40, 0x00, 0x00); // flush registers + xfer3bytes(0x40, 0x00, 0x00); // get id and version + terminalDisplay(); +} + +void QT2100::verifyChannels() // query sensors B1 through B7 and A1 through A3 +{ + xfer3bytes(0x20, 0x00, 0x00); // flush registers + for (int i=0; i<10; i++) { + xfer3bytes(0x20, i, 0x00); // get each channel's status + terminalDisplay(); + } +} + +int8_t QT2100::keys() // get data from each key channel +{ + int8_t activeKey; + + xfer3bytes(0x08, 0x78, 0x41); + + switch(qt2100[1]) { + case (0x01): + activeKey = 0x01; + break; + case (0x02): + activeKey = 0x02; + break; + case (0x04): + activeKey = 0x04; + break; + case (0x08): + activeKey = 0x08; + break; + case (0x10): + activeKey = 0x10; + break; + case (0x20): + activeKey = 0x20; + break; + case (0x40): + activeKey = 0x40; + break; + case (0x80): + activeKey = 0x80; + break; + default: + activeKey = 0x00; + } + return activeKey; +} + +int8_t QT2100::slider() // get data from the slider channels +{ + int8_t sliderPosition; + + xfer3bytes(0x08, 0x78, 0x40); // 3 bits resolution, 8 positions (expandable to 8 bits, 256 positions) + + switch(qt2100[2]) { + case (0x0): + sliderPosition = 0x01; + break; + case (0x01): + sliderPosition = 0x03; + break; + case (0x02): + sliderPosition = 0x07; + break; + case (0x03): + sliderPosition = 0x0f; + break; + case (0x04): + sliderPosition = 0x1f; + break; + case (0x05): + sliderPosition = 0x3f; + break; + case (0x06): + sliderPosition = 0x7f; + break; + case (0x07): + sliderPosition = 0xff; + break; + default: + sliderPosition = 0x00; + } + return sliderPosition; +} + +int8_t QT2100::wheel() // get data from the wheel channels +{ + int8_t wheelPosition; + + xfer3bytes(0x00, 0x78, 0x40); // 3 bits resolution, 8 positions (expandable to 8 bits, 256 positions) + + switch(qt2100[2]) { + case (0x0): + wheelPosition = 0x01; + break; + case (0x01): + wheelPosition = 0x03; + break; + case (0x02): + wheelPosition = 0x07; + break; + case (0x03): + wheelPosition = 0x0f; + break; + case (0x04): + wheelPosition = 0x1f; + break; + case (0x05): + wheelPosition = 0x3f; + break; + case (0x06): + wheelPosition = 0x7f; + break; + case (0x07): + wheelPosition = 0xff; + break; + default: + wheelPosition = 0x00; + } + return wheelPosition; +}
diff -r 000000000000 -r 2d6c5d39b4de QT2100.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/QT2100.h Tue Jan 13 00:11:41 2015 +0000 @@ -0,0 +1,67 @@ + +/* +Copyright (c) 2015 John Magyar + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE. +*/ + +#ifndef QT2100_H +#define QT2100_H + +#include "mbed.h" + +/* + +Header file for the Atmel QT2100 Capacative Touch sensor device Mbed library. + +The QT2100 is a capacitive touch controller device with 10 configurable QTouch channels, +supporting up to seven touch buttons, and either a single slider (or wheel). + +Datasheet: http://www.atmel.com/images/at42qt2100_e_level0%2013ww04.pdf + +*/ + +class QT2100 +{ +public: + QT2100(PinName mosi, + PinName miso, + PinName sck, + PinName cs, + PinName tx, + PinName rx); + ~QT2100(); + +public: + void init(); + void terminalDisplay(); + void xfer3bytes(int byte0, int byte1, int byte2); + void verifyChannels(); + void devId(); + int8_t keys(); + int8_t slider(); + int8_t wheel(); + +private: + SPI _spi; + DigitalOut _cs; + Serial _pc; +}; + +#endif // QT2100_H