// SPDX-License-Identifier: Apache-2.0 #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #define TAG "XPT2046" #define GET_CONFIG(device) (static_cast((device)->config)) // Rough LiPo discharge curve floor, used together with the configured reference voltage // (the 100% point) to estimate a charge percentage from the sensed v-bat voltage. #define POWER_SUPPLY_MIN_MV 3200 struct Xpt2046Internal { esp_lcd_panel_io_handle_t io_handle; esp_lcd_touch_handle_t touch_handle; Device* power_supply_device; }; // region Power supply static bool ps_supports_property(Device*, PowerSupplyProperty property) { return property == POWER_SUPPLY_PROP_VOLTAGE || property == POWER_SUPPLY_PROP_CAPACITY; } static int estimate_capacity_from_mv(int battery_mv, uint32_t reference_mv) { if (battery_mv <= POWER_SUPPLY_MIN_MV) return 0; if ((uint32_t)battery_mv >= reference_mv) return 100; return (battery_mv - POWER_SUPPLY_MIN_MV) * 100 / ((int)reference_mv - POWER_SUPPLY_MIN_MV); } // The v-bat reading is noisy (shared ADC, no dedicated sample/hold), so it's smoothed by // averaging over several samples rather than trusting a single conversion. #define POWER_SUPPLY_SAMPLE_COUNT 20 static error_t read_battery_mv(esp_lcd_touch_handle_t touch_handle, int* out_mv) { float volts_sum = 0.0f; for (int i = 0; i < POWER_SUPPLY_SAMPLE_COUNT; i++) { float volts; if (esp_lcd_touch_xpt2046_read_battery_level(touch_handle, &volts) != ESP_OK) { return ERROR_RESOURCE; } volts_sum += volts; } *out_mv = (int)((volts_sum / POWER_SUPPLY_SAMPLE_COUNT) * 1000.0f); return ERROR_NONE; } static error_t ps_get_property(Device* device, PowerSupplyProperty property, PowerSupplyPropertyValue* out_value) { if (property != POWER_SUPPLY_PROP_VOLTAGE && property != POWER_SUPPLY_PROP_CAPACITY) { return ERROR_NOT_SUPPORTED; } auto* parent = device_get_parent(device); const auto* parent_config = GET_CONFIG(parent); auto* parent_internal = static_cast(device_get_driver_data(parent)); int battery_mv; error_t error = read_battery_mv(parent_internal->touch_handle, &battery_mv); if (error != ERROR_NONE) { return error; } out_value->int_value = (property == POWER_SUPPLY_PROP_VOLTAGE) ? battery_mv : estimate_capacity_from_mv(battery_mv, parent_config->power_supply_reference_voltage_mv); return ERROR_NONE; } static bool ps_supports_charge_control(Device*) { return false; } static bool ps_is_allowed_to_charge(Device*) { return false; } static error_t ps_set_allowed_to_charge(Device*, bool) { return ERROR_NOT_SUPPORTED; } static bool ps_supports_quick_charge(Device*) { return false; } static bool ps_is_quick_charge_enabled(Device*) { return false; } static error_t ps_set_quick_charge_enabled(Device*, bool) { return ERROR_NOT_SUPPORTED; } static bool ps_supports_power_off(Device*) { return false; } static error_t ps_power_off(Device*) { return ERROR_NOT_SUPPORTED; } static constexpr PowerSupplyApi XPT2046_POWER_SUPPLY_API = { .supports_property = ps_supports_property, .get_property = ps_get_property, .supports_charge_control = ps_supports_charge_control, .is_allowed_to_charge = ps_is_allowed_to_charge, .set_allowed_to_charge = ps_set_allowed_to_charge, .supports_quick_charge = ps_supports_quick_charge, .is_quick_charge_enabled = ps_is_quick_charge_enabled, .set_quick_charge_enabled = ps_set_quick_charge_enabled, .supports_power_off = ps_supports_power_off, .power_off = ps_power_off, }; // Registered (driver_construct_add() in module.cpp) so driver_bind() has a valid ->internal, // but never matched against a devicetree node: xpt2046 wires it up directly by pointer. Driver xpt2046_power_supply_driver = { .name = "xpt2046-power-supply", .compatible = (const char*[]) { "xpt2046-power-supply", nullptr }, .start_device = nullptr, .stop_device = nullptr, .api = &XPT2046_POWER_SUPPLY_API, .device_type = &POWER_SUPPLY_TYPE, .owner = &xpt2046_module, .internal = nullptr }; static error_t create_power_supply_child(Device* parent, Device*& out_child) { auto* child = new(std::nothrow) Device { .address = 0, .name = "xpt2046-power-supply", .config = nullptr, .parent = nullptr, .internal = nullptr }; if (child == nullptr) { return ERROR_OUT_OF_MEMORY; } error_t error = device_construct(child); if (error != ERROR_NONE) { delete child; return error; } device_set_parent(child, parent); device_set_driver(child, &xpt2046_power_supply_driver); error = device_add(child); if (error != ERROR_NONE) { device_destruct(child); delete child; return error; } error = device_start(child); if (error != ERROR_NONE) { device_remove(child); device_destruct(child); delete child; return error; } out_child = child; return ERROR_NONE; } static void destroy_power_supply_child(Device* child) { check(device_stop(child) == ERROR_NONE); check(device_remove(child) == ERROR_NONE); check(device_destruct(child) == ERROR_NONE); delete child; } // endregion // region Driver lifecycle static error_t start(Device* device) { auto* parent = device_get_parent(device); check(device_get_type(parent) == &SPI_CONTROLLER_TYPE); const auto* spi_config = static_cast(parent->config); const auto* config = GET_CONFIG(device); struct GpioPinSpec cs_pin; if (esp32_spi_get_cs_pin(device, &cs_pin) != ERROR_NONE) { LOG_E(TAG, "Failed to resolve CS pin"); return ERROR_RESOURCE; } auto* internal = static_cast(malloc(sizeof(Xpt2046Internal))); if (internal == nullptr) { return ERROR_OUT_OF_MEMORY; } const esp_lcd_panel_io_spi_config_t io_config = ESP_LCD_TOUCH_IO_SPI_XPT2046_CONFIG(cs_pin.pin); esp_err_t ret = esp_lcd_new_panel_io_spi((esp_lcd_spi_bus_handle_t)spi_config->host, &io_config, &internal->io_handle); if (ret != ESP_OK) { LOG_E(TAG, "Failed to create panel IO: %s", esp_err_to_name(ret)); free(internal); return ERROR_RESOURCE; } const esp_lcd_touch_config_t touch_config = { .x_max = config->x_max, .y_max = config->y_max, .rst_gpio_num = GPIO_NUM_NC, .int_gpio_num = GPIO_NUM_NC, .levels = { .reset = 0, .interrupt = 0, }, .flags = { .swap_xy = config->swap_xy ? 1u : 0u, .mirror_x = config->mirror_x ? 1u : 0u, .mirror_y = config->mirror_y ? 1u : 0u, }, .process_coordinates = nullptr, .interrupt_callback = nullptr, .user_data = nullptr, .driver_data = nullptr, }; ret = esp_lcd_touch_new_spi_xpt2046(internal->io_handle, &touch_config, &internal->touch_handle); if (ret != ESP_OK) { LOG_E(TAG, "Failed to create touch handle: %s", esp_err_to_name(ret)); esp_lcd_panel_io_del(internal->io_handle); free(internal); return ERROR_RESOURCE; } internal->power_supply_device = nullptr; device_set_driver_data(device, internal); if (config->power_supply) { error_t error = create_power_supply_child(device, internal->power_supply_device); if (error != ERROR_NONE) { LOG_E(TAG, "Failed to create power-supply device"); esp_lcd_touch_del(internal->touch_handle); esp_lcd_panel_io_del(internal->io_handle); free(internal); return error; } } return ERROR_NONE; } static error_t stop(Device* device) { auto* internal = static_cast(device_get_driver_data(device)); if (internal->power_supply_device != nullptr) { destroy_power_supply_child(internal->power_supply_device); internal->power_supply_device = nullptr; } // esp_lcd_touch_del() only releases the touch-side resources; the panel IO handle is owned // separately and needs its own deletion. if (internal->touch_handle != nullptr) { if (esp_lcd_touch_del(internal->touch_handle) != ESP_OK) { LOG_E(TAG, "Failed to delete touch handle"); return ERROR_RESOURCE; } internal->touch_handle = nullptr; } if (internal->io_handle != nullptr) { if (esp_lcd_panel_io_del(internal->io_handle) != ESP_OK) { LOG_E(TAG, "Failed to delete panel IO handle"); return ERROR_RESOURCE; } internal->io_handle = nullptr; } free(internal); device_set_driver_data(device, nullptr); return ERROR_NONE; } // endregion // region PointerApi static error_t xpt2046_enter_sleep(Device* device) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_enter_sleep(internal->touch_handle) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_exit_sleep(Device* device) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_exit_sleep(internal->touch_handle) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_read_data(Device* device, TickType_t timeout) { (void)timeout; // esp_lcd_touch_read_data() has no timeout parameter auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_read_data(internal->touch_handle) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static bool xpt2046_get_touched_points(Device* device, uint16_t* x, uint16_t* y, uint16_t* strength, uint8_t* point_count, uint8_t max_point_count) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_get_coordinates(internal->touch_handle, x, y, strength, point_count, max_point_count); } static error_t xpt2046_set_swap_xy(Device* device, bool swap) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_set_swap_xy(internal->touch_handle, swap) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_get_swap_xy(Device* device, bool* swap) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_get_swap_xy(internal->touch_handle, swap) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_set_mirror_x(Device* device, bool mirror) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_set_mirror_x(internal->touch_handle, mirror) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_get_mirror_x(Device* device, bool* mirror) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_get_mirror_x(internal->touch_handle, mirror) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_set_mirror_y(Device* device, bool mirror) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_set_mirror_y(internal->touch_handle, mirror) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } static error_t xpt2046_get_mirror_y(Device* device, bool* mirror) { auto* internal = static_cast(device_get_driver_data(device)); return esp_lcd_touch_get_mirror_y(internal->touch_handle, mirror) == ESP_OK ? ERROR_NONE : ERROR_RESOURCE; } // endregion static const PointerApi xpt2046_pointer_api = { .enter_sleep = xpt2046_enter_sleep, .exit_sleep = xpt2046_exit_sleep, .read_data = xpt2046_read_data, .get_touched_points = xpt2046_get_touched_points, .set_swap_xy = xpt2046_set_swap_xy, .get_swap_xy = xpt2046_get_swap_xy, .set_mirror_x = xpt2046_set_mirror_x, .get_mirror_x = xpt2046_get_mirror_x, .set_mirror_y = xpt2046_set_mirror_y, .get_mirror_y = xpt2046_get_mirror_y, }; Driver xpt2046_driver = { .name = "xpt2046", .compatible = (const char*[]) { "xptek,xpt2046", nullptr }, .start_device = start, .stop_device = stop, .api = &xpt2046_pointer_api, .device_type = &POINTER_TYPE, .owner = &xpt2046_module, .internal = nullptr };