Initial project import with ESP32 animated eyes

Add initial project files for ESP32 animated eyes, including main application sources, assets, CMake configuration, and supporting ESP-IDF components for LCD and touch functionality. Includes documentation, test apps, and configuration files.
This commit is contained in:
2026-01-18 21:32:07 +05:30
parent 03c8d43b7a
commit b71a39aae9
117 changed files with 14318 additions and 0 deletions

202
main/animated_eyes.h Normal file
View File

@@ -0,0 +1,202 @@
/**
* @file animated_eyes.h
* @brief Animated expressive eyes for LVGL displays
*
* Ported from esp32-eyes (https://github.com/playfultechnology/esp32-eyes)
* Original Copyright (c) 2020 Luis Llamas, 2023 Alastair Aitchison
* LVGL port for ESP-IDF
*
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU Affero General Public License.
*/
#ifndef ANIMATED_EYES_H
#define ANIMATED_EYES_H
#include "lvgl.h"
#include <stdbool.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Available emotions for the animated face
*/
typedef enum {
EMOTION_NORMAL = 0,
EMOTION_ANGRY,
EMOTION_GLEE,
EMOTION_HAPPY,
EMOTION_SAD,
EMOTION_WORRIED,
EMOTION_FOCUSED,
EMOTION_ANNOYED,
EMOTION_SURPRISED,
EMOTION_SKEPTIC,
EMOTION_FRUSTRATED,
EMOTION_UNIMPRESSED,
EMOTION_SLEEPY,
EMOTION_SUSPICIOUS,
EMOTION_SQUINT,
EMOTION_FURIOUS,
EMOTION_SCARED,
EMOTION_AWE,
EMOTION_COUNT
} animated_eyes_emotion_t;
/**
* @brief Configuration for animated eyes
*/
typedef struct {
uint16_t screen_width; /**< Screen width in pixels */
uint16_t screen_height; /**< Screen height in pixels */
uint16_t eye_size; /**< Base eye size (will be scaled) */
uint16_t eye_spacing; /**< Distance between eyes */
lv_color_t eye_color; /**< Color of the eyes */
lv_color_t bg_color; /**< Background color */
bool random_behavior; /**< Enable random emotion changes */
bool random_look; /**< Enable random look-around */
bool random_blink; /**< Enable random blinking */
uint32_t behavior_interval; /**< Interval for behavior changes (ms) */
uint32_t look_interval; /**< Interval for look changes (ms) */
uint32_t blink_interval; /**< Interval for blinking (ms) */
} animated_eyes_config_t;
/**
* @brief Handle for animated eyes instance
*/
typedef struct animated_eyes_t* animated_eyes_handle_t;
/**
* @brief Default configuration macro
*/
#define ANIMATED_EYES_DEFAULT_CONFIG() { \
.screen_width = 368, \
.screen_height = 448, \
.eye_size = 120, \
.eye_spacing = 20, \
.eye_color = lv_color_white(), \
.bg_color = lv_color_black(), \
.random_behavior = true, \
.random_look = true, \
.random_blink = true, \
.behavior_interval = 5000, \
.look_interval = 4000, \
.blink_interval = 3500 \
}
/**
* @brief Create animated eyes on a parent LVGL object
*
* @param parent Parent LVGL object to attach eyes to
* @param config Configuration for the eyes
* @return Handle to the animated eyes instance, or NULL on failure
*/
animated_eyes_handle_t animated_eyes_create(lv_obj_t *parent, const animated_eyes_config_t *config);
/**
* @brief Delete animated eyes and free resources
*
* @param handle Handle to the animated eyes instance
*/
void animated_eyes_delete(animated_eyes_handle_t handle);
/**
* @brief Update the animated eyes (call this regularly, e.g., every frame)
*
* @param handle Handle to the animated eyes instance
*/
void animated_eyes_update(animated_eyes_handle_t handle);
/**
* @brief Trigger a blink animation
*
* @param handle Handle to the animated eyes instance
*/
void animated_eyes_blink(animated_eyes_handle_t handle);
/**
* @brief Set the current emotion
*
* @param handle Handle to the animated eyes instance
* @param emotion The emotion to set
*/
void animated_eyes_set_emotion(animated_eyes_handle_t handle, animated_eyes_emotion_t emotion);
/**
* @brief Get the current emotion
*
* @param handle Handle to the animated eyes instance
* @return Current emotion
*/
animated_eyes_emotion_t animated_eyes_get_emotion(animated_eyes_handle_t handle);
/**
* @brief Set the emotion probability weight
*
* @param handle Handle to the animated eyes instance
* @param emotion The emotion to set weight for
* @param weight Weight value (0.0 to disable, higher = more likely)
*/
void animated_eyes_set_emotion_weight(animated_eyes_handle_t handle, animated_eyes_emotion_t emotion, float weight);
/**
* @brief Make the eyes look in a specific direction
*
* @param handle Handle to the animated eyes instance
* @param x Horizontal direction (-1.0 = left, 0.0 = center, 1.0 = right)
* @param y Vertical direction (-1.0 = down, 0.0 = center, 1.0 = up)
*/
void animated_eyes_look_at(animated_eyes_handle_t handle, float x, float y);
/**
* @brief Make the eyes look at a screen position
*
* @param handle Handle to the animated eyes instance
* @param screen_x X coordinate on screen
* @param screen_y Y coordinate on screen
*/
void animated_eyes_look_at_point(animated_eyes_handle_t handle, int16_t screen_x, int16_t screen_y);
/**
* @brief Convenience methods for common look directions
*/
void animated_eyes_look_left(animated_eyes_handle_t handle);
void animated_eyes_look_right(animated_eyes_handle_t handle);
void animated_eyes_look_up(animated_eyes_handle_t handle);
void animated_eyes_look_down(animated_eyes_handle_t handle);
void animated_eyes_look_center(animated_eyes_handle_t handle);
/**
* @brief Enable or disable random behaviors
*
* @param handle Handle to the animated eyes instance
* @param behavior Enable random emotion changes
* @param look Enable random looking around
* @param blink Enable random blinking
*/
void animated_eyes_set_random(animated_eyes_handle_t handle, bool behavior, bool look, bool blink);
/**
* @brief Set the eye color
*
* @param handle Handle to the animated eyes instance
* @param color New eye color
*/
void animated_eyes_set_color(animated_eyes_handle_t handle, lv_color_t color);
/**
* @brief Set the background color
*
* @param handle Handle to the animated eyes instance
* @param color New background color
*/
void animated_eyes_set_bg_color(animated_eyes_handle_t handle, lv_color_t color);
#ifdef __cplusplus
}
#endif
#endif /* ANIMATED_EYES_H */