139 lines
5.0 KiB
C++
139 lines
5.0 KiB
C++
// An adaption of the "UncannyEyes" sketch (see eye_functions tab)
|
|
// for the TFT_eSPI library. As written the sketch is for driving
|
|
// one (240x320 minimum) TFT display, showing 2 eyes. See example
|
|
// Animated_Eyes_2 for a dual 128x128 TFT display configured sketch.
|
|
|
|
// The size of the displayed eye is determined by the screen size and
|
|
// resolution. The eye image is 128 pixels wide. In humans the palpebral
|
|
// fissure (open eye) width is about 30mm so a low resolution, large
|
|
// pixel size display works best to show a scale eye image. Note that
|
|
// display manufacturers usually quote the diagonal measurement, so a
|
|
// 128 x 128 1.7" display or 128 x 160 2" display is about right.
|
|
|
|
// Configuration settings for the eye, eye style, display count,
|
|
// chip selects and x offsets can be defined in the sketch "config.h" tab.
|
|
|
|
// Performance (frames per second = fps) can be improved by using
|
|
// DMA (for SPI displays only) on ESP32 and STM32 processors. Use
|
|
// as high a SPI clock rate as is supported by the display. 27MHz
|
|
// minimum, some displays can be operated at higher clock rates in
|
|
// the range 40-80MHz.
|
|
|
|
// Single defaultEye performance for different processors
|
|
// No DMA With DMA
|
|
// ESP8266 (160MHz CPU) 40MHz SPI 36 fps
|
|
// ESP32 27MHz SPI 53 fps 85 fps
|
|
// ESP32 40MHz SPI 67 fps 102 fps
|
|
// ESP32 80MHz SPI 82 fps 116 fps // Note: Few displays work reliably at 80MHz
|
|
// STM32F401 55MHz SPI 44 fps 90 fps
|
|
// STM32F446 55MHz SPI 83 fps 155 fps
|
|
// STM32F767 55MHz SPI 136 fps 197 fps
|
|
|
|
// DMA can be used with RP2040, STM32 and ESP32 processors when the interface
|
|
// is SPI, uncomment the next line:
|
|
//#define USE_DMA
|
|
|
|
// Load TFT driver library
|
|
#include <SPI.h>
|
|
#include <TFT_eSPI.h>
|
|
TFT_eSPI tft; // A single instance is used for 1 or 2 displays
|
|
|
|
// A pixel buffer is used during eye rendering
|
|
#define BUFFER_SIZE 1024 // 128 to 1024 seems optimum
|
|
|
|
#ifdef USE_DMA
|
|
#define BUFFERS 2 // 2 toggle buffers with DMA
|
|
#else
|
|
#define BUFFERS 1 // 1 buffer for no DMA
|
|
#endif
|
|
|
|
uint16_t pbuffer[BUFFERS][BUFFER_SIZE]; // Pixel rendering buffer
|
|
bool dmaBuf = 0; // DMA buffer selection
|
|
|
|
// This struct is populated in config.h
|
|
typedef struct { // Struct is defined before including config.h --
|
|
int8_t select; // pin numbers for each eye's screen select line
|
|
int8_t wink; // and wink button (or -1 if none) specified there,
|
|
uint8_t rotation; // also display rotation and the x offset
|
|
int16_t xposition; // position of eye on the screen
|
|
} eyeInfo_t;
|
|
|
|
#include "config.h" // ****** CONFIGURATION IS DONE IN HERE ******
|
|
|
|
extern void user_setup(void); // Functions in the user*.cpp files
|
|
extern void user_loop(void);
|
|
|
|
#define SCREEN_X_START 0
|
|
#define SCREEN_X_END SCREEN_WIDTH // Badly named, actually the "eye" width!
|
|
#define SCREEN_Y_START 0
|
|
#define SCREEN_Y_END SCREEN_HEIGHT // Actually "eye" height
|
|
|
|
// A simple state machine is used to control eye blinks/winks:
|
|
#define NOBLINK 0 // Not currently engaged in a blink
|
|
#define ENBLINK 1 // Eyelid is currently closing
|
|
#define DEBLINK 2 // Eyelid is currently opening
|
|
typedef struct {
|
|
uint8_t state; // NOBLINK/ENBLINK/DEBLINK
|
|
uint32_t duration; // Duration of blink state (micros)
|
|
uint32_t startTime; // Time (micros) of last state change
|
|
} eyeBlink;
|
|
|
|
struct { // One-per-eye structure
|
|
int16_t tft_cs; // Chip select pin for each display
|
|
eyeBlink blink; // Current blink/wink state
|
|
int16_t xposition; // x position of eye image
|
|
} eye[NUM_EYES];
|
|
|
|
uint32_t startTime; // For FPS indicator
|
|
|
|
// INITIALIZATION -- runs once at startup ----------------------------------
|
|
void setup(void) {
|
|
Serial.begin(115200);
|
|
//while (!Serial);
|
|
Serial.println("Starting");
|
|
|
|
#if defined(DISPLAY_BACKLIGHT) && (DISPLAY_BACKLIGHT >= 0)
|
|
// Enable backlight pin, initially off
|
|
Serial.println("Backlight turned off");
|
|
pinMode(DISPLAY_BACKLIGHT, OUTPUT);
|
|
digitalWrite(DISPLAY_BACKLIGHT, LOW);
|
|
#endif
|
|
|
|
// User call for additional features
|
|
user_setup();
|
|
|
|
// Initialise the eye(s), this will set all chip selects low for the tft.init()
|
|
initEyes();
|
|
|
|
// Initialise TFT
|
|
Serial.println("Initialising displays");
|
|
tft.init();
|
|
|
|
#ifdef USE_DMA
|
|
tft.initDMA();
|
|
#endif
|
|
|
|
// Raise chip select(s) so that displays can be individually configured
|
|
digitalWrite(eye[0].tft_cs, HIGH);
|
|
if (NUM_EYES > 1) digitalWrite(eye[1].tft_cs, HIGH);
|
|
|
|
for (uint8_t e = 0; e < NUM_EYES; e++) {
|
|
digitalWrite(eye[e].tft_cs, LOW);
|
|
tft.setRotation(eyeInfo[e].rotation);
|
|
tft.fillScreen(TFT_BLACK);
|
|
digitalWrite(eye[e].tft_cs, HIGH);
|
|
}
|
|
|
|
#if defined(DISPLAY_BACKLIGHT) && (DISPLAY_BACKLIGHT >= 0)
|
|
Serial.println("Backlight now on!");
|
|
analogWrite(DISPLAY_BACKLIGHT, BACKLIGHT_MAX);
|
|
#endif
|
|
|
|
startTime = millis(); // For frame-rate calculation
|
|
}
|
|
|
|
// MAIN LOOP -- runs continuously after setup() ----------------------------
|
|
void loop() {
|
|
updateEye();
|
|
}
|