TM16xx Arduino Library

The TM16xxButtons class extends basic button polling by providing callback-based event handling (similar to the OneButton library). It allows you to respond to specific user interactions like clicks, double-clicks, long presses, and releases.

Workflow:

1. Instantiate: Create a chip-specific object (e.g., TM1638) and pass it to TM16xxButtons.
2. Define Callbacks: Create functions that accept a byte nButton (where 0 is the first button).
3. Attach Callbacks: In setup(), use attachClick(), attachDoubleClick(), attachLongPress(), or attachRelease() to link your functions.
4. Process Events: In loop(), you must call buttons.tick() to detect state changes and trigger callbacks.

Simultaneous Presses: For chips that support it, use isPressed() to implement features like shift keys.

#include <TM1638.h>
#include <TM16xxButtons.h>

TM1638 module(8, 9, 7); // DIO=8, CLK=9, STB=7
TM16xxButtons buttons(&module);

void fnClick(byte nButton) {
  Serial.print(F("Button "));
  Serial.print(nButton);
  Serial.println(F(" click."));
}

void setup() {
  buttons.attachClick(fnClick);
}

void loop() {
  buttons.tick(); // Required to detect events
}

The base class (e.g., TM1637, TM1638) provides a uniform API for driving LED/LCD displays and reading button states.

Initialization

Include the header for your specific chip and instantiate the object with the appropriate pins (e.g., DIO, CLK, STB).

Setup

In setup(), call .begin(on, intensity) where on is a boolean and intensity is an integer from 0 to 7.

Displaying Data

Use methods like .setDisplayToString() for text or .setDisplayToDecNumber() for numeric values.

Reading Buttons

Use .getButtons() to retrieve a bitmask of the current button states. Note that button states may be reset when displaying new data. For advanced click detection (double clicks, long presses), use the TM16xxButtons class.

#include <TM1638.h>

TM1638 module(8, 9, 7);   // DIO=8, CLK=9, STB=7

void setup() {
  module.begin(true, 2);   // on=true, intensity-2 (range 0-7)
  module.setDisplayToString("HALO");
}

void loop() {
  int nTime = ((millis() / 1000) / 60) * 100 + (millis() / 1000) % 60;
  module.setDisplayToDecNumber(nTime, _BV(4)); // display with dot on digit 4

  uint32_t dwButtons = module.getButtons();
  Serial.println(dwButtons, HEX);
}

The TM16xxMatrixGFX class provides an interface compatible with the Adafruit GFX library to drive TM16xx-based LED matrix modules.

Prerequisites:

• Install the Adafruit_GFX library.
• Include the following headers:
  • Adafruit_GFX.h
  • TM1640.h (or your specific chip header)
  • TM16xxMatrixGFX.h

Basic Usage:

1. Instantiate the chip-specific class (e.g., TM1640).
2. Instantiate TM16xxMatrixGFX passing the chip object and matrix dimensions.
3. Use matrix.write() to commit changes from the memory bitmap to the physical display.

Combining Multiple Modules: You can combine multiple identical modules into a single large matrix by sharing the data line and passing an array of module pointers to the TM16xxMatrixGFX constructor.

#include <Adafruit_GFX.h>
#include <TM1640.h>
#include <TM16xxMatrixGFX.h>

TM1640 module(13, 14); // DIN=13, CLK=14
#define MATRIX_NUMCOLUMNS 8
#define MATRIX_NUMROWS 8
TM16xxMatrixGFX matrix(&module, MATRIX_NUMCOLUMNS, MATRIX_NUMROWS);

void setup() {
  matrix.setIntensity(1);         // Brightness 0-7
  matrix.fillScreen(LOW);        // Clear
  matrix.drawPixel(1, 4, HIGH);  // Set pixel
  matrix.write();                 // Send to display
  matrix.drawChar(0, 0, 'A', HIGH, LOW, 1);
}