mirror of
https://github.com/ByteWelder/Tactility.git
synced 2026-08-18 07:55:06 +00:00
50c0a14a93
- Added kernel base drivers for: display, pointer (touch, mouse, etc.), keyboard, adc, power supply and backlight - Implement new kernel driver modules: `st7789-module` and `gt911-module` - Implement ESP32 ADC "oneshot" kernel driver - Implement ESP32 backlight kernel driver with ledc API - Implemented `battery-sense` driver that allows for voltage measurement and creates a power supply child device - Updated github actions - Updated flash scripts - Fix for esp32 legacy driver conflict with ADC - Created separate `lilygo-tdeck` and `lilygo-tdeck-plus` devices - Created `lilygo-module` with LilyGO kernel drivers - Fix for intermittent errors in build related to code generation of `devicetree.c` - `lvgl-module` can now map kernel drivers onto LVGL devices - Created `KernelDisplayApp` as a mirror of `HalDisplayApp` (formerly `DisplayApp`) - Removed `struct` and `enum` prefix in a lot of kernel driver cpp source files - `lilygo-tdeck` and `lilygo-tdeck-plus` are now fully relying on kernel drivers and don't use any of the old HAL
97 lines
3.0 KiB
C
97 lines
3.0 KiB
C
// SPDX-License-Identifier: Apache-2.0
|
|
#pragma once
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <tactility/device.h>
|
|
#include <tactility/error.h>
|
|
|
|
/**
|
|
* @brief Inclusive range of brightness levels accepted by a backlight driver.
|
|
*/
|
|
struct BrightnessLevelRange {
|
|
uint8_t min;
|
|
uint8_t max;
|
|
};
|
|
|
|
/**
|
|
* @brief API for backlight drivers.
|
|
*
|
|
* @note The minimum brightness level (see get_min_brightness()) turns the backlight fully off.
|
|
* There is no separate on/off control: to turn the backlight off, call set_brightness() with
|
|
* the minimum value; to turn it back on, set any value above the minimum.
|
|
*/
|
|
struct BacklightApi {
|
|
/**
|
|
* @brief Sets the backlight brightness.
|
|
* @param[in] device the backlight device
|
|
* @param[in] brightness the brightness level, expected to be within [get_min_brightness(), get_max_brightness()]
|
|
* @retval ERROR_NONE when the operation was successful
|
|
*/
|
|
error_t (*set_brightness)(struct Device* device, uint8_t brightness);
|
|
|
|
/**
|
|
* @brief Sets the backlight brightness to its devicetree-configured default level.
|
|
* @param[in] device the backlight device
|
|
* @retval ERROR_NONE when the operation was successful
|
|
*/
|
|
error_t (*set_brightness_default)(struct Device* device);
|
|
|
|
/**
|
|
* @brief Gets the current backlight brightness.
|
|
* @param[in] device the backlight device
|
|
* @param[out] out_brightness the current brightness level
|
|
* @retval ERROR_NONE when the operation was successful
|
|
*/
|
|
error_t (*get_brightness)(struct Device* device, uint8_t* out_brightness);
|
|
|
|
/**
|
|
* @brief Gets the minimum brightness level. Setting the brightness to this value turns the backlight off.
|
|
* @param[in] device the backlight device
|
|
* @return the minimum brightness level
|
|
*/
|
|
uint8_t (*get_min_brightness)(struct Device* device);
|
|
|
|
/**
|
|
* @brief Gets the maximum (full-strength) brightness level.
|
|
* @param[in] device the backlight device
|
|
* @return the maximum brightness level
|
|
*/
|
|
uint8_t (*get_max_brightness)(struct Device* device);
|
|
};
|
|
|
|
/**
|
|
* @brief Sets the backlight brightness using the specified backlight device.
|
|
*/
|
|
error_t backlight_set_brightness(struct Device* device, uint8_t brightness);
|
|
|
|
/**
|
|
* @brief Sets the backlight brightness to its devicetree-configured default level using the specified backlight device.
|
|
*/
|
|
error_t backlight_set_brightness_default(struct Device* device);
|
|
|
|
/**
|
|
* @brief Gets the current backlight brightness using the specified backlight device.
|
|
*/
|
|
error_t backlight_get_brightness(struct Device* device, uint8_t* out_brightness);
|
|
|
|
/**
|
|
* @brief Gets the minimum brightness level using the specified backlight device. This level turns the backlight off.
|
|
*/
|
|
uint8_t backlight_get_min_brightness(struct Device* device);
|
|
|
|
/**
|
|
* @brief Gets the maximum brightness level using the specified backlight device.
|
|
*/
|
|
uint8_t backlight_get_max_brightness(struct Device* device);
|
|
|
|
extern const struct DeviceType BACKLIGHT_TYPE;
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|