I have implemented new features for ILI9486 SPI Touch screen

[MikeyMoMo]

I purchased an ILI9486 SPI board (not parallel) and was at a loss to use it for a few days. Then, I found bits and pieces and put this together.

I have defined a Setups folder entry for SPI version of ILI9468.
I included a new #define for having the ILI9486 driver code do the (possibly) needed display invert so it does not have to coded in every program using this same display.
I added code to the ILI9486 driver code to implement the display invert from the #define.

But, most of all, I have implemented Single touch, Double touch, Triple touch, Long touch and 8-way swipe as a subroutine in my programs. I don't really know how or want to try converting that to library format and keep naming and structure compatibility with the excellent code that is already there. I hope someone will feel that these new features are worth the time and convert my code and add it to the library. I don't want to get in trouble for messing things up and hate to lose the updates on a library refresh.

Here is the 1,2,3 click, long clock and swipe routine, the ILI9486 Setups file and the minor bit of code that can go into the ILI9468 Init.h file. It is too complex for me to put into a pull since it is not all in the right format and I don't really know how to get it into the right format. If nobody wants to tackle this, then I will have the code and can send to others if they want it.

There is one define that the user can set to select between immediate return when a long touch is detected or to wait until the press event is over before returning to the calling program. Sometimes an immediate return can cause problems by some other action happening. Usually, it seems to be the right way to go.

I hope to implement some additional graphics with buttons and touch, later. First will be a checkbox then others, as needed for my project or by request.

#define SDOUBLECLICK_MS   400   // ms.  Double or Triple click max time.
#define SLONG_TOUCH_TIME  300   // ms.  Long Touch Time must be less than Double Click time.

#define SWIPE_MIN_X        10  // Pixels
#define SWIPE_MIN_Y        10  // Pixels
// Swipe Directions
//     17 / 10 \ 11
//     16 |  T | 12
//     15 \ 14 / 13
// Where T can be 0, 1, 2 or 3.

#define NO_TOUCH            0
#define SHORT_TOUCH         1
#define DOUBLE_TOUCH        2
#define TRIPLE_TOUCH        3
#define LONG_TOUCH          4
// This should continue with 5 and the two arrays, below, combined.
#define SWIPE_OFFSET       10  // Subtract this much to pick from the char array.
#define SWIPE_UP           10
#define SWIPE_UP_RIGHT     11
#define SWIPE_RIGHT        12
#define SWIPE_DOWN_RIGHT   13
#define SWIPE_DOWN         14
#define SWIPE_DOWN_LEFT    15
#define SWIPE_LEFT         16
#define SWIPE_UP_LEFT      17

// (Optional, mostly for testing)
String touchKind[5] = {"None", "Short", "Double", "Triple", "Long"};
char swipeDir[8][11]  = {"Up", "Up-Right", "Right", "Right-Down", "Down",
                         "Down-Left", "Left", "Up-Left"

/***************************************************************************/
int myGetTouch (int *iX, int *iY, int *eX, int *eY, int *dX, int *dY)
/***************************************************************************/
{
  /* Notes:
      - If there are multiple clicks (2 or 3) only the position of the last one will be reported.)
      - If there is a single click that is not a swipe and a later swipe (within SDOUBLECLICK_MS)
         only the swipe event will be reported.
  */
  uint16_t x, y;
  int touchCt = NO_TOUCH;  // Assume nothing to report yet.
  unsigned long touchStart = 0;
  unsigned long eventStart = 0;
  int eventTime;
  bool long_touch_by_time = false;
  //  Serial.println("Entering myGetTouch.");
  do {
    //    Serial.printf("%lu : Top of loop - eS %lu, tS %lu\n", millis(), eventStart, touchStart);
    if (tft.getTouch(&x, &y)) {  // Someone touched the screen?
      if (eventStart == 0) eventStart = millis();
      //      Serial.printf("%lu : Setting eventStart - eventStart %lu, touchStart %lu\n",
      //                    millis(), eventStart, touchStart);
      if (touchStart == 0) {
        touchStart = millis();  // Start the current touch timer
        //        Serial.printf("%lu ; Setting touchStart - eventStart %lu, touchStart %lu\n",
        //                      millis(), eventStart, touchStart);
        initialX = x; initialY = y;
        //        Serial.printf("%lu : Touched - eS %lu, tS %lu\n", millis(), eventStart, touchStart);
      }
      eventTime = millis() - touchStart;
      if (eventTime >= SLONG_TOUCH_TIME) {
        //        Serial.println("Touch timer found a long touch.");
        *iX = initialX; *iY = initialY; *eX = 0; *eX = 0; *dX = 0; *dY = 0;
        //        Serial.printf("%lu : long touch = true - eventStart %lu, touchStart %lu\n",
        //                      millis(), eventStart, touchStart);
        long_touch_by_time = true;
        //        Serial.printf("%lu : long touch = true - eventStart %lu, touchStart %lu\n",
        //                      millis(), eventStart, touchStart);
        while (tft.getTouch(&x, &y)) { // Wait for unpress
          endingX = x; endingY = y;
        }
        distanceX = initialX - endingX; distanceY = initialY - y;
        //        Serial.printf("dX %i, dY %i\n", abs(distanceX), abs(distanceY));
        if ((abs(distanceX) < SWIPE_MIN_X) && (abs(distanceY) < SWIPE_MIN_Y))
          return LONG_TOUCH;
        else
          eventStart = millis();  // Extend the timer so we get to the "else" code.
      }
    } else {  // The touch is ended.  If the time is less than SLONG_TOUCH_TIME, increment click count
      // First, determine if there was movement above the minimum for a swipe.
      // Note that swipe must be first, then long click, then single click(s) checked for, in order.
      //      Serial.printf("%lu : Touch ended - eS %lu, tS %lu\n", millis(), eventStart, touchStart);
      if (eventStart > 0 && touchStart > 0) {  // If we were in an event, show finish.
        endingX = x; endingY = y;
        distanceX = endingX - initialX;
        distanceY = endingY - initialY;
        eventTime = millis() - touchStart;
        //        Serial.printf("%lu - Event time %i, distX %i, distY %i\n",
        //                      millis(), eventTime, distanceX, distanceY);
        if ((abs(distanceX) > SWIPE_MIN_X) || (abs(distanceY) > SWIPE_MIN_Y))
        {
          //          Serial.println("Sub found a swipe.");
          *iX = initialX; *iY = initialY; *eX = endingX; *eX = endingY;
          *dX = distanceX; *dY = distanceY;
          if (abs(distanceX) < SWIPE_MIN_X && distanceY < -SWIPE_MIN_Y) return SWIPE_UP;
          else if (distanceX > SWIPE_MIN_X && distanceY < -SWIPE_MIN_Y) return SWIPE_UP_RIGHT;
          else if (distanceX > SWIPE_MIN_X && abs(distanceY) < SWIPE_MIN_Y) return SWIPE_RIGHT;
          else if (distanceX > SWIPE_MIN_X && distanceY > SWIPE_MIN_Y) return SWIPE_DOWN_RIGHT;
          else if (abs(distanceX) < SWIPE_MIN_X && distanceY > SWIPE_MIN_Y) return SWIPE_DOWN;
          else if (distanceX < -SWIPE_MIN_X && distanceY > SWIPE_MIN_Y) return SWIPE_DOWN_LEFT;
          else if (distanceX < -SWIPE_MIN_X && abs(distanceY) < SWIPE_MIN_Y) return SWIPE_LEFT;
          else if (distanceX < -SWIPE_MIN_X && distanceY < SWIPE_MIN_Y) return SWIPE_UP_LEFT;
        }
_        else if (eventTime < SLONG_TOUCH_TIME) {
          Serial.println("Sub found a single click");
          touchCt++; *iX = initialX; *iY = initialY; *eX = 0; *eX = 0; *dX = 0; *dY = 0;
          if (touchCt == TRIPLE_TOUCH) return TRIPLE_TOUCH;  // End this now.
          touchStart = 0;
        }
      }
    }
  } while (millis() < (eventStart + SDOUBLECLICK_MS));
  //  Serial.printf("End %lu\n", millis());
  return touchCt;
}

This code goes in at the very bottom of ILI9486_Init.h

 #if defined ILI9486_SETINVOFF  
	  writecommand(TFT_INVOFF);
      delay(150);
    #endif

And here is the Setups file to configure an SPI ILI9486

// See SetupX_Template.h for all options available

#define ILI9486_DRIVER
#define ILI9486_SETINVOFF  // This display needs to have Inverse set to false.

// For ESP32/ESP8266 SPI Display - Pins chosen for most compatibility with
//  the standard defaults coming into use. First 2 are software defaults.
//#define TFT_MOSI  23  // Master Out, Slave In (Data from controller to display)
//#define TFT_SCLK  18  // SPI Clock
#define TFT_DC    33  // Data/Command switch
#define TFT_CS     5  // Display  Chip Select
#define TFT_RST   22  // Reset
#define TFT_BL     4  // BL PWM control
#define TFT_BACKLIGHT_ON true  // Turn on the display after initialization.

// For ESP32/ESP8266 SD Card

// For ESP32/ESP8266 Touch
#define TOUCH_CS  21  // Chip select pin (T_CS) of touch screen
//#define T_D0      19  // Data Out, aka MISO same as used by SD card
//#define T_DIN     23  // Data In, aka MOSI same as for display input (Shared)
//#define T_CS      21  // Chip Select, aka TOUCH_CS
//#define T_CLK     13  // ala SCK (Shared)


//#define LOAD_GLCD   // Font 1. Original Adafruit 8 pixel font needs ~1820 bytes in FLASH
//#define LOAD_FONT2  // Font 2. Small 16 pixel high font, needs ~3534 bytes in FLASH, 96 characters
//#define LOAD_FONT4  // Font 4. Medium 26 pixel high font, needs ~5848 bytes in FLASH, 96 characters
//#define LOAD_FONT6  // Font 6. Large 48 pixel font, needs ~2666 bytes in FLASH, only characters 1234567890:-.apm
//#define LOAD_FONT7  // Font 7. 7 segment 48 pixel font, needs ~2438 bytes in FLASH, only characters 1234567890:.
//#define LOAD_FONT8  // Font 8. Large 75 pixel font needs ~3256 bytes in FLASH, only characters 1234567890:-.
//#define LOAD_GFXFF  // FreeFonts. Include access to the 48 Adafruit_GFX free fonts FF1 to FF48 and custom fonts

#define SMOOTH_FONT

//#define SPI_FREQUENCY  20000000    // 214ms for screen 1 time line update.
#define SPI_FREQUENCY  40000000    // 168ms for screen 1 time line update.
#define SPI_TOUCH_FREQUENCY  2500000


// #define SUPPORT_TRANSACTIONS

Mike Morrow

[daxliniere]

wow, this is awesome. Great work, Mike!

[zuhairmst]

Great work. Really appreciated.

[MikeyMoMo]

The touch routine has not changed in a while. It works for all I need, so need to change. Is that what you are looking for or something else? Mike

…

On Thu, Aug 31, 2023, 10:34 AM summerfind ***@***.***> wrote: sounds great. do you have one for Arduino IDE? — Reply to this email directly, view it on GitHub <#1438 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ADYPSIIKFLLMMIMCMIRH4JTXX7Z27ANCNFSM545G3CFQ> . You are receiving this because you authored the thread.Message ID: ***@***.***>