Driver improvements (#226)

- Created driver subprojects: `FT5x06`, `FT6x36`, `CST816S`. - Refactored existing projects to use new drivers. - Improve `PwmBacklight` driver: expose frequency, channel id and timer id - Update `build-and-release-all.sh` for recent board addition
2025-02-20 22:41:56 +01:00
parent 6e8fbae62b
commit 933bc5fb97
49 changed files with 429 additions and 413 deletions
@@ -0,0 +1,184 @@
+#include <cstdio>
+#include <cstdlib>
+
+#include "driver/gpio.h"
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "freertos/semphr.h"
+#include "esp_log.h"
+#include "driver/i2c.h"
+#include "sdkconfig.h"
+#include <esp_timer.h>
+
+#ifndef ft6x36_h
+#define ft6x36_h
+// I2C Constants
+#define I2C_MASTER_TX_BUF_DISABLE 0                           /*!< I2C master doesn't need buffer */
+#define I2C_MASTER_RX_BUF_DISABLE 0                           /*!< I2C master doesn't need buffer */
+
+#define ACK_CHECK_EN 0x1                        /*!< I2C master will check ack from slave*/
+#define ACK_CHECK_DIS 0x0                       /*!< I2C master will not check ack from slave */
+#define ACK_VAL 0x0                             /*!< I2C ack value */
+#define NACK_VAL 0x1                            /*!< I2C nack value */
+
+//SemaphoreHandle_t print_mux = NULL;
+
+#define FT6X36_ADDR						0x38
+
+#define FT6X36_REG_DEVICE_MODE			0x00
+#define FT6X36_REG_GESTURE_ID			0x01
+#define FT6X36_REG_NUM_TOUCHES			0x02
+#define FT6X36_REG_P1_XH				0x03
+#define FT6X36_REG_P1_XL				0x04
+#define FT6X36_REG_P1_YH				0x05
+#define FT6X36_REG_P1_YL				0x06
+#define FT6X36_REG_P1_WEIGHT			0x07
+#define FT6X36_REG_P1_MISC				0x08
+#define FT6X36_REG_P2_XH				0x09
+#define FT6X36_REG_P2_XL				0x0A
+#define FT6X36_REG_P2_YH				0x0B
+#define FT6X36_REG_P2_YL				0x0C
+#define FT6X36_REG_P2_WEIGHT			0x0D
+#define FT6X36_REG_P2_MISC				0x0E
+#define FT6X36_REG_THRESHHOLD			0x80
+#define FT6X36_REG_FILTER_COEF			0x85
+#define FT6X36_REG_CTRL					0x86
+#define FT6X36_REG_TIME_ENTER_MONITOR	0x87
+#define FT6X36_REG_TOUCHRATE_ACTIVE		0x88
+#define FT6X36_REG_TOUCHRATE_MONITOR	0x89 // value in ms
+#define FT6X36_REG_RADIAN_VALUE			0x91
+#define FT6X36_REG_OFFSET_LEFT_RIGHT	0x92
+#define FT6X36_REG_OFFSET_UP_DOWN		0x93
+#define FT6X36_REG_DISTANCE_LEFT_RIGHT	0x94
+#define FT6X36_REG_DISTANCE_UP_DOWN		0x95
+#define FT6X36_REG_DISTANCE_ZOOM		0x96
+#define FT6X36_REG_LIB_VERSION_H		0xA1
+#define FT6X36_REG_LIB_VERSION_L		0xA2
+#define FT6X36_REG_CHIPID				0xA3
+#define FT6X36_REG_INTERRUPT_MODE		0xA4
+#define FT6X36_REG_POWER_MODE			0xA5
+#define FT6X36_REG_FIRMWARE_VERSION		0xA6
+#define FT6X36_REG_PANEL_ID				0xA8
+#define FT6X36_REG_STATE				0xBC
+
+#define FT6X36_PMODE_ACTIVE				0x00
+#define FT6X36_PMODE_MONITOR			0x01
+#define FT6X36_PMODE_STANDBY			0x02
+#define FT6X36_PMODE_HIBERNATE			0x03
+
+/* Possible values returned by FT6X36_GEST_ID_REG */
+#define FT6X36_GEST_ID_NO_GESTURE       0x00
+#define FT6X36_GEST_ID_MOVE_UP          0x10
+#define FT6X36_GEST_ID_MOVE_RIGHT       0x14
+#define FT6X36_GEST_ID_MOVE_DOWN        0x18
+#define FT6X36_GEST_ID_MOVE_LEFT        0x1C
+#define FT6X36_GEST_ID_ZOOM_IN          0x48
+#define FT6X36_GEST_ID_ZOOM_OUT         0x49
+
+#define FT6X36_VENDID					0x11
+#define FT6206_CHIPID					0x06
+#define FT6236_CHIPID					0x36
+#define FT6336_CHIPID					0x64
+
+#define FT6X36_DEFAULT_THRESHOLD		22
+
+// From: https://github.com/lvgl/lv_port_esp32/blob/master/components/lvgl_esp32_drivers/lvgl_touch/ft6x36.h
+#define FT6X36_MSB_MASK                 0x0F
+#define FT6X36_LSB_MASK                 0xFF
+
+enum class TRawEvent
+{
+	PressDown,
+	LiftUp,
+	Contact,
+	NoEvent
+};
+
+enum class TEvent
+{
+	None,
+	TouchStart,
+	TouchMove,
+	TouchEnd,
+	Tap,
+	DragStart,
+	DragMove,
+	DragEnd
+};
+
+struct TPoint
+{
+	uint16_t x;
+	uint16_t y;
+	/**
+	 * This is being used in the original library but I'm not using it in this implementation
+	 */
+	bool aboutEqual(const TPoint point)
+	{
+		return abs(x - point.x) <= 5 && abs(y - point.y) <= 5;
+	}
+};
+
+
+
+class FT6X36
+{
+	static void IRAM_ATTR isr(void* arg);
+public:
+    // TwoWire * wire will be replaced by ESP-IDF https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/i2c.html
+    FT6X36(i2c_port_t = I2C_NUM_0, gpio_num_t interruptPin = GPIO_NUM_NC);
+	~FT6X36();
+	bool begin(uint8_t threshold = FT6X36_DEFAULT_THRESHOLD, uint16_t width = 0, uint16_t height = 0);
+	void registerTouchHandler(void(*fn)(TPoint point, TEvent e));
+	uint8_t touched();
+	void loop();
+	void processTouch();
+	void debugInfo();
+	void poll(TPoint * point, TEvent * event);
+	// Helper functions to make the touch display aware
+	void setRotation(uint8_t rotation);
+	void setTouchWidth(uint16_t width);
+	void setTouchHeight(uint16_t height);
+	// Pending implementation. How much x->touch y↓touch is placed (In case is smaller than display)
+	void setXoffset(uint16_t x_offset);
+	void setYoffset(uint16_t y_offset);
+	// Smart template from EPD to swap x,y:
+    template <typename T> static inline void
+    swap(T& a, T& b)
+    {
+      T t = a;
+      a = b;
+      b = t;
+    }
+	void(*_touchHandler)(TPoint point, TEvent e) = nullptr;
+
+    bool readData(void);
+private:
+	void writeRegister8(uint8_t reg, uint8_t val);
+	uint8_t readRegister8(uint8_t reg, uint8_t *data_buf);
+	void fireEvent(TPoint point, TEvent e);
+	uint8_t read8(uint8_t regName);
+	static FT6X36 * _instance;
+
+    i2c_port_t _port;
+	int8_t _intPin;
+	
+	// Make touch rotation aware:
+	uint8_t _rotation = 0;
+	uint16_t _touch_width = 0;
+	uint16_t _touch_height = 0;
+
+	uint8_t _touches;
+	uint16_t _touchX[2], _touchY[2], _touchEvent[2];
+	TPoint _points[10];
+	uint8_t _pointIdx = 0;
+	unsigned long _touchStartTime = 0;
+	unsigned long _touchEndTime = 0;
+    uint8_t lastEvent = 3; // No event
+	uint16_t lastX = 0;
+	uint16_t lastY = 0;
+	bool _dragMode = false;
+	const uint8_t maxDeviation = 5;
+};
+
+#endif