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 |
--- /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;
+}
--- /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
Atmel AT42QT2100 Capacitive Touch Controller