Justin Mitchell
e103cdfd11
Introduces uiScale() method to apply per-board UI scaling based on device type (1.0 for button devices, >1 for touch devices to make UI elements finger-sized). Adds scaledMetrics member to store scaled theme metrics that are returned by getMetrics().
134 lines
4.7 KiB
C++
134 lines
4.7 KiB
C++
#pragma once
|
|
|
|
#include <Arduino.h>
|
|
#include <InputManager.h>
|
|
|
|
// Display SPI pins (custom pins for XteinkX4, not hardware SPI defaults)
|
|
#define EPD_SCLK 8 // SPI Clock
|
|
#define EPD_MOSI 10 // SPI MOSI (Master Out Slave In)
|
|
#define EPD_CS 21 // Chip Select
|
|
#define EPD_DC 4 // Data/Command
|
|
#define EPD_RST 5 // Reset
|
|
#define EPD_BUSY 6 // Busy
|
|
|
|
#define SPI_MISO 7 // SPI MISO, shared between SD card and display (Master In Slave Out)
|
|
|
|
#define BAT_GPIO0 0 // Battery voltage
|
|
|
|
#define UART0_RXD 20 // Used for USB connection detection
|
|
|
|
// Xteink X3 Hardware
|
|
#define X3_I2C_SDA 20
|
|
#define X3_I2C_SCL 0
|
|
#define X3_I2C_FREQ 400000
|
|
|
|
// TI BQ27220 Fuel gauge I2C
|
|
#define I2C_ADDR_BQ27220 0x55 // Fuel gauge I2C address
|
|
#define BQ27220_SOC_REG 0x2C // StateOfCharge() command code (%)
|
|
#define BQ27220_CUR_REG 0x0C // Current() command code (signed mA)
|
|
#define BQ27220_VOLT_REG 0x08 // Voltage() command code (mV)
|
|
|
|
// Analog DS3231 RTC I2C
|
|
#define I2C_ADDR_DS3231 0x68 // RTC I2C address
|
|
#define DS3231_SEC_REG 0x00 // Seconds command code (BCD)
|
|
|
|
// QST QMI8658 IMU I2C
|
|
#define I2C_ADDR_QMI8658 0x6B // IMU I2C address
|
|
#define I2C_ADDR_QMI8658_ALT 0x6A // IMU I2C fallback address
|
|
#define QMI8658_WHO_AM_I_REG 0x00 // WHO_AM_I command code
|
|
#define QMI8658_WHO_AM_I_VALUE 0x05 // WHO_AM_I expected value
|
|
|
|
class HalGPIO {
|
|
#if CROSSPOINT_EMULATED == 0
|
|
InputManager inputMgr;
|
|
#endif
|
|
|
|
bool lastUsbConnected = false;
|
|
bool usbStateChanged = false;
|
|
|
|
public:
|
|
enum class DeviceType : uint8_t { X4, X3 };
|
|
|
|
private:
|
|
DeviceType _deviceType = DeviceType::X4;
|
|
|
|
public:
|
|
HalGPIO() = default;
|
|
|
|
// Inline device type helpers for cleaner downstream checks
|
|
inline bool deviceIsX3() const { return _deviceType == DeviceType::X3; }
|
|
inline bool deviceIsX4() const { return _deviceType == DeviceType::X4; }
|
|
|
|
// True on the Xteink X3/X4 boards. Unlike deviceIsX3/X4 (which both stay "X4"
|
|
// on non-C3 boards), this keys off BoardConfig::ACTIVE.board, so it reliably
|
|
// gates Xteink-only features (sunlight fix) and non-Xteink-only ones (touch).
|
|
bool isXteinkDevice() const;
|
|
|
|
// Start button GPIO and setup SPI for screen and SD card
|
|
void begin();
|
|
|
|
// Button input methods
|
|
void update();
|
|
bool isPressed(uint8_t buttonIndex) const;
|
|
bool wasPressed(uint8_t buttonIndex) const;
|
|
bool wasAnyPressed() const;
|
|
bool wasReleased(uint8_t buttonIndex) const;
|
|
bool wasAnyReleased() const;
|
|
unsigned long getHeldTime() const;
|
|
unsigned long getPowerButtonHeldTime() const;
|
|
|
|
// Touch: one-shot tap with the release position normalized 0..1 in the panel's
|
|
// native orientation. Returns false on non-touch devices. (Reusable gesture
|
|
// primitive; see MappedInputManager for the top-left = Back mapping.)
|
|
bool wasTouchTap(float& nx, float& ny) const;
|
|
|
|
// Press-edge of a touch: true on touch-down with the down position normalized
|
|
// 0..1 (panel native). For showing the pressed/selected element before release.
|
|
bool wasTouchDown(float& nx, float& ny) const;
|
|
|
|
// Duration (ms) of the last touch contact, latched on release. Valid on the
|
|
// release frame (alongside wasTouchTap). For tap-vs-long-press decisions.
|
|
unsigned long lastTouchHeldMs() const;
|
|
|
|
// Swipe (flick) gesture on the release frame: writes the start/end positions
|
|
// normalized 0..1 in the panel's native frame (map via GfxRenderer::tapToLogical).
|
|
// A swipe also raises wasTouchTap(), so check this first. False on non-touch.
|
|
bool wasSwipe(float& nxStart, float& nyStart, float& nxEnd, float& nyEnd) const;
|
|
|
|
// True if a touch controller is present/active (runtime gate; false on the C3).
|
|
bool hasTouch() const;
|
|
|
|
// True if a touch press or release happened this frame (the touch analogue of
|
|
// wasAnyPressed/Released), for resetting idle/sleep timers and CPU frequency.
|
|
bool wasTouchActivity() const;
|
|
|
|
// Setup wake up GPIO and enter deep sleep
|
|
void startDeepSleep();
|
|
|
|
// Verify power button was held long enough after wakeup.
|
|
// If verification fails, enters deep sleep and does not return.
|
|
// Should only be called when wakeup reason is PowerButton.
|
|
void verifyPowerButtonWakeup(uint16_t requiredDurationMs, bool shortPressAllowed);
|
|
|
|
// Check if USB is connected
|
|
bool isUsbConnected() const;
|
|
|
|
// Returns true once per edge (plug or unplug) since the last update()
|
|
bool wasUsbStateChanged() const;
|
|
|
|
enum class WakeupReason { PowerButton, AfterFlash, AfterUSBPower, Other };
|
|
|
|
WakeupReason getWakeupReason() const;
|
|
|
|
// Button indices
|
|
static constexpr uint8_t BTN_BACK = 0;
|
|
static constexpr uint8_t BTN_CONFIRM = 1;
|
|
static constexpr uint8_t BTN_LEFT = 2;
|
|
static constexpr uint8_t BTN_RIGHT = 3;
|
|
static constexpr uint8_t BTN_UP = 4;
|
|
static constexpr uint8_t BTN_DOWN = 5;
|
|
static constexpr uint8_t BTN_POWER = 6;
|
|
};
|
|
|
|
extern HalGPIO gpio;
|