/** * @file lv_led.c * */ /********************* * INCLUDES *********************/ #include "lv_led.h" #if LV_USE_LED != 0 #include "../lv_core/lv_debug.h" #include "../lv_themes/lv_theme.h" #include "../lv_draw/lv_draw.h" /********************* * DEFINES *********************/ #define LV_OBJX_NAME "lv_led" #define LV_LED_WIDTH_DEF (LV_DPI / 3) #define LV_LED_HEIGHT_DEF (LV_DPI / 3) #define LV_LED_BRIGHT_OFF 60 #define LV_LED_BRIGHT_ON 255 /********************** * TYPEDEFS **********************/ /********************** * STATIC PROTOTYPES **********************/ static lv_design_res_t lv_led_design(lv_obj_t * led, const lv_area_t * clip_area, lv_design_mode_t mode); static lv_res_t lv_led_signal(lv_obj_t * led, lv_signal_t sign, void * param); /********************** * STATIC VARIABLES **********************/ static lv_design_cb_t ancestor_design; static lv_signal_cb_t ancestor_signal; /********************** * MACROS **********************/ /********************** * GLOBAL FUNCTIONS **********************/ /** * Create a led objects * @param par pointer to an object, it will be the parent of the new led * @param copy pointer to a led object, if not NULL then the new object will be copied from it * @return pointer to the created led */ lv_obj_t * lv_led_create(lv_obj_t * par, const lv_obj_t * copy) { LV_LOG_TRACE("led create started"); /*Create the ancestor basic object*/ lv_obj_t * new_led = lv_obj_create(par, copy); LV_ASSERT_MEM(new_led); if(new_led == NULL) return NULL; if(ancestor_signal == NULL) ancestor_signal = lv_obj_get_signal_cb(new_led); if(ancestor_design == NULL) ancestor_design = lv_obj_get_design_cb(new_led); /*Allocate the object type specific extended data*/ lv_led_ext_t * ext = lv_obj_allocate_ext_attr(new_led, sizeof(lv_led_ext_t)); LV_ASSERT_MEM(ext); if(ext == NULL) { lv_obj_del(new_led); return NULL; } ext->bright = LV_LED_BRIGHT_ON; lv_obj_set_signal_cb(new_led, lv_led_signal); lv_obj_set_design_cb(new_led, lv_led_design); /*Init the new led object*/ if(copy == NULL) { lv_obj_set_size(new_led, LV_LED_WIDTH_DEF, LV_LED_HEIGHT_DEF); lv_style_list_init(&new_led->style_list); lv_obj_add_style(new_led, LV_LED_PART_MAIN, lv_theme_get_style(LV_THEME_LED)); } /*Copy an existing object*/ else { lv_led_ext_t * copy_ext = lv_obj_get_ext_attr(copy); ext->bright = copy_ext->bright; /*Refresh the style with new signal function*/ lv_obj_refresh_style(new_led); } LV_LOG_INFO("led created"); return new_led; } /*===================== * Setter functions *====================*/ /** * Set the brightness of a LED object * @param led pointer to a LED object * @param bright 0 (max. dark) ... 255 (max. light) */ void lv_led_set_bright(lv_obj_t * led, uint8_t bright) { LV_ASSERT_OBJ(led, LV_OBJX_NAME); /*Set the brightness*/ lv_led_ext_t * ext = lv_obj_get_ext_attr(led); if(ext->bright == bright) return; ext->bright = bright; /*Invalidate the object there fore it will be redrawn*/ lv_obj_invalidate(led); } /** * Light on a LED * @param led pointer to a LED object */ void lv_led_on(lv_obj_t * led) { LV_ASSERT_OBJ(led, LV_OBJX_NAME); lv_led_set_bright(led, LV_LED_BRIGHT_ON); } /** * Light off a LED * @param led pointer to a LED object */ void lv_led_off(lv_obj_t * led) { LV_ASSERT_OBJ(led, LV_OBJX_NAME); lv_led_set_bright(led, LV_LED_BRIGHT_OFF); } /** * Toggle the state of a LED * @param led pointer to a LED object */ void lv_led_toggle(lv_obj_t * led) { LV_ASSERT_OBJ(led, LV_OBJX_NAME); uint8_t bright = lv_led_get_bright(led); if(bright > (LV_LED_BRIGHT_OFF + LV_LED_BRIGHT_ON) >> 1) lv_led_off(led); else lv_led_on(led); } /*===================== * Getter functions *====================*/ /** * Get the brightness of a LEd object * @param led pointer to LED object * @return bright 0 (max. dark) ... 255 (max. light) */ uint8_t lv_led_get_bright(const lv_obj_t * led) { LV_ASSERT_OBJ(led, LV_OBJX_NAME); lv_led_ext_t * ext = lv_obj_get_ext_attr(led); return ext->bright; } /********************** * STATIC FUNCTIONS **********************/ /** * Handle the drawing related tasks of the leds * @param led pointer to an object * @param clip_area the object will be drawn only in this area * @param mode LV_DESIGN_COVER_CHK: only check if the object fully covers the 'mask_p' area * (return 'true' if yes) * LV_DESIGN_DRAW: draw the object (always return 'true') * LV_DESIGN_DRAW_POST: drawing after every children are drawn * @param return an element of `lv_design_res_t` */ static lv_design_res_t lv_led_design(lv_obj_t * led, const lv_area_t * clip_area, lv_design_mode_t mode) { if(mode == LV_DESIGN_COVER_CHK) { /*Return false if the object is not covers the clip_area area*/ return ancestor_design(led, clip_area, mode); } else if(mode == LV_DESIGN_DRAW_MAIN) { /*Make darker colors in a temporary style according to the brightness*/ lv_led_ext_t * ext = lv_obj_get_ext_attr(led); lv_draw_rect_dsc_t rect_dsc; lv_draw_rect_dsc_init(&rect_dsc); lv_obj_init_draw_rect_dsc(led, LV_LED_PART_MAIN, &rect_dsc); /*Mix. the color with black proportionally with brightness*/ rect_dsc.bg_color = lv_color_mix(rect_dsc.bg_color, LV_COLOR_BLACK, ext->bright); rect_dsc.bg_grad_color = lv_color_mix(rect_dsc.bg_grad_color, LV_COLOR_BLACK, ext->bright); rect_dsc.border_color = lv_color_mix(rect_dsc.border_color, LV_COLOR_BLACK, ext->bright); /*Set the current shadow width according to brightness proportionally between LV_LED_BRIGHT_OFF * and LV_LED_BRIGHT_ON*/ rect_dsc.shadow_width = ((ext->bright - LV_LED_BRIGHT_OFF) * rect_dsc.shadow_width) / (LV_LED_BRIGHT_ON - LV_LED_BRIGHT_OFF); lv_draw_rect(&led->coords, clip_area, &rect_dsc); } return LV_DESIGN_RES_OK; } /** * Signal function of the led * @param led pointer to a led object * @param sign a signal type from lv_signal_t enum * @param param pointer to a signal specific variable * @return LV_RES_OK: the object is not deleted in the function; LV_RES_INV: the object is deleted */ static lv_res_t lv_led_signal(lv_obj_t * led, lv_signal_t sign, void * param) { lv_res_t res; /* Include the ancient signal function */ res = ancestor_signal(led, sign, param); if(res != LV_RES_OK) return res; if(sign == LV_SIGNAL_GET_TYPE) { lv_obj_type_t * buf = param; uint8_t i; for(i = 0; i < LV_MAX_ANCESTOR_NUM - 1; i++) { /*Find the last set data*/ if(buf->type[i] == NULL) break; } buf->type[i] = "lv_led"; } return res; } #endif