mirror of
https://github.com/espressif/esp-idf.git
synced 2026-10-02 03:00:34 +03:00
parlio: add simple rgb led matrix example
This commit is contained in:
morris
@@ -0,0 +1,2 @@
|
||||
idf_component_register(SRCS "rgb_led_matrix_example_main.c" "lvgl_demo_ui.c"
|
||||
INCLUDE_DIRS ".")
|
||||
@@ -0,0 +1,3 @@
|
||||
dependencies:
|
||||
idf: ">=5.1"
|
||||
lvgl/lvgl: "~8.3.0"
|
||||
@@ -0,0 +1,25 @@
|
||||
/*
|
||||
* SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
|
||||
*
|
||||
* SPDX-License-Identifier: CC0-1.0
|
||||
*/
|
||||
|
||||
#include "lvgl.h"
|
||||
|
||||
void example_lvgl_demo_ui(lv_disp_t *disp)
|
||||
{
|
||||
lv_obj_t *scr = lv_disp_get_scr_act(disp);
|
||||
lv_obj_t *up_label = lv_label_create(scr);
|
||||
lv_label_set_recolor(up_label, true);
|
||||
lv_label_set_text(up_label, "#FF0000 Hello# #0000FF World#");
|
||||
lv_label_set_long_mode(up_label, LV_LABEL_LONG_SCROLL_CIRCULAR); /* Circular scroll */
|
||||
/* Size of the screen */
|
||||
lv_obj_set_width(up_label, disp->driver->hor_res);
|
||||
lv_obj_align_to(up_label, scr, LV_ALIGN_TOP_MID, 0, 0);
|
||||
|
||||
lv_obj_t *low_label = lv_label_create(scr);
|
||||
lv_label_set_text(low_label, LV_SYMBOL_WIFI LV_SYMBOL_GPS LV_SYMBOL_BATTERY_2 LV_SYMBOL_AUDIO);
|
||||
/* Size of the screen */
|
||||
lv_obj_set_width(low_label, disp->driver->hor_res);
|
||||
lv_obj_align_to(low_label, scr, LV_ALIGN_BOTTOM_MID, 0, 0);
|
||||
}
|
||||
@@ -0,0 +1,218 @@
|
||||
/*
|
||||
* SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
|
||||
*
|
||||
* SPDX-License-Identifier: Unlicense OR CC0-1.0
|
||||
*/
|
||||
#include "freertos/FreeRTOS.h"
|
||||
#include "freertos/task.h"
|
||||
#include "esp_attr.h"
|
||||
#include "esp_log.h"
|
||||
#include "driver/parlio_tx.h"
|
||||
#include "driver/dedic_gpio.h"
|
||||
#include "driver/gptimer.h"
|
||||
#include "lvgl.h"
|
||||
|
||||
static const char *TAG = "example";
|
||||
|
||||
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||||
//////////////////// Please update the following configuration according to your LED Matrix spec ///////////////////////
|
||||
////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
|
||||
// color data, clock signal and control signals are powered by parlio_tx unit
|
||||
#define EXAMPLE_HUB75_DATA_WIDTH 8 // 8-bit data width, used for transferring color data (RGB222) and control signals (OE and latch)
|
||||
#define EXAMPLE_HUB75_R1_IDX 7 // R1 bit position
|
||||
#define EXAMPLE_HUB75_R2_IDX 6 // R2 bit position
|
||||
#define EXAMPLE_HUB75_LATCH_IDX 5 // LATCH bit position
|
||||
#define EXAMPLE_HUB75_G1_IDX 4 // G1 bit position
|
||||
#define EXAMPLE_HUB75_G2_IDX 3 // G2 bit position
|
||||
#define EXAMPLE_HUB75_OE_IDX 2 // OE bit position
|
||||
#define EXAMPLE_HUB75_B1_IDX 1 // B1 bit position
|
||||
#define EXAMPLE_HUB75_B2_IDX 0 // B2 bit position
|
||||
// GPIO assignment
|
||||
#define EXAMPLE_PIN_NUM_R1 7
|
||||
#define EXAMPLE_PIN_NUM_G1 4
|
||||
#define EXAMPLE_PIN_NUM_B1 1
|
||||
#define EXAMPLE_PIN_NUM_R2 6
|
||||
#define EXAMPLE_PIN_NUM_G2 3
|
||||
#define EXAMPLE_PIN_NUM_B2 0
|
||||
#define EXAMPLE_PIN_NUM_LATCH 5
|
||||
#define EXAMPLE_PIN_NUM_OE 2
|
||||
#define EXAMPLE_PIN_NUM_PCLK 10
|
||||
// address signals are powered by fast GPIO module
|
||||
#define EXAMPLE_PIN_NUM_A 20
|
||||
#define EXAMPLE_PIN_NUM_B 21
|
||||
#define EXAMPLE_PIN_NUM_C 22
|
||||
#define EXAMPLE_PIN_NUM_D 23
|
||||
// The pixel clock frequency
|
||||
#define EXAMPLE_LED_MATRIX_PIXEL_CLOCK_HZ (10 * 1000 * 1000) // 10MHz
|
||||
// The pixel number in horizontal and vertical
|
||||
#define EXAMPLE_LED_MATRIX_H_RES 64
|
||||
#define EXAMPLE_LED_MATRIX_V_RES 32
|
||||
|
||||
// We use the gptimer interrupt to generate the LVGL tick interface
|
||||
#define EXAMPLE_GPTIMER_RESOLUTION_HZ (1 * 1000 * 1000) // 1MHz
|
||||
#define EXAMPLE_LVGL_TICK_PERIOD_MS 5 // 5ms
|
||||
|
||||
// 0x92: we pick the first bit of each RGB element in the order of 3-3-2, that's 0b10010010
|
||||
// p1: pixel on the upper half screen
|
||||
// p2: pixel on the lower half screen
|
||||
// OE=1: disable the output
|
||||
#define MERGE_TWO_LVGL_PIXELS(p1, p2) \
|
||||
do \
|
||||
{ \
|
||||
p1->full &= 0x92; \
|
||||
p1->full |= (p2->full & 0x92) >> 1; \
|
||||
p1->full |= 1 << EXAMPLE_HUB75_OE_IDX; \
|
||||
} while (0)
|
||||
|
||||
extern void example_lvgl_demo_ui(lv_disp_t *disp);
|
||||
|
||||
// LED Matrix frame buffer, we use a dedicated task to flush this frame buffer
|
||||
static lv_color_t s_frame_buffer[EXAMPLE_LED_MATRIX_H_RES * EXAMPLE_LED_MATRIX_V_RES / 2];
|
||||
|
||||
static void example_lvgl_flush_cb(lv_disp_drv_t *drv, const lv_area_t *area, lv_color_t *color_map)
|
||||
{
|
||||
lv_color_t *upper_half = color_map;
|
||||
lv_color_t *lower_half = color_map + EXAMPLE_LED_MATRIX_V_RES * EXAMPLE_LED_MATRIX_H_RES / 2;
|
||||
for (int line = 0; line < EXAMPLE_LED_MATRIX_V_RES / 2; line++) {
|
||||
for (int col = 0; col < EXAMPLE_LED_MATRIX_H_RES - 1; col++) {
|
||||
MERGE_TWO_LVGL_PIXELS(upper_half, lower_half);
|
||||
upper_half++;
|
||||
lower_half++;
|
||||
}
|
||||
MERGE_TWO_LVGL_PIXELS(upper_half, lower_half);
|
||||
// need special handling for the last pixel in each line
|
||||
// latch up at the end of each line
|
||||
upper_half->full |= (1 << EXAMPLE_HUB75_LATCH_IDX);
|
||||
upper_half++;
|
||||
lower_half++;
|
||||
}
|
||||
memcpy(s_frame_buffer, color_map, sizeof(s_frame_buffer));
|
||||
lv_disp_flush_ready(drv);
|
||||
}
|
||||
|
||||
static IRAM_ATTR bool parlio_tx_line_done_cb(parlio_tx_unit_handle_t tx_unit, const parlio_tx_done_event_data_t *edata, void *user_ctx)
|
||||
{
|
||||
static uint32_t line_number = 0;
|
||||
dedic_gpio_bundle_handle_t gpio_bundle = (dedic_gpio_bundle_handle_t)user_ctx;
|
||||
dedic_gpio_bundle_write(gpio_bundle, 0x0F, line_number++);
|
||||
return false;
|
||||
}
|
||||
|
||||
static IRAM_ATTR bool gptimer_alarm_cb_lvgl_tick(gptimer_handle_t timer, const gptimer_alarm_event_data_t *edata, void *user_ctx)
|
||||
{
|
||||
/* Tell LVGL how many milliseconds has elapsed */
|
||||
lv_tick_inc(EXAMPLE_LVGL_TICK_PERIOD_MS);
|
||||
return false;
|
||||
}
|
||||
|
||||
void app_main(void)
|
||||
{
|
||||
static lv_disp_draw_buf_t disp_buf;
|
||||
static lv_disp_drv_t disp_drv;
|
||||
|
||||
ESP_LOGI(TAG, "Install fast GPIO bundle for line address control");
|
||||
dedic_gpio_bundle_config_t dedic_gpio_conf = {
|
||||
.flags.out_en = true,
|
||||
.gpio_array = (int[])
|
||||
{
|
||||
EXAMPLE_PIN_NUM_A, EXAMPLE_PIN_NUM_B, EXAMPLE_PIN_NUM_C, EXAMPLE_PIN_NUM_D
|
||||
},
|
||||
.array_size = 4,
|
||||
};
|
||||
dedic_gpio_bundle_handle_t led_line_control_gpio_bundle;
|
||||
ESP_ERROR_CHECK(dedic_gpio_new_bundle(&dedic_gpio_conf, &led_line_control_gpio_bundle));
|
||||
// initial line address to 0
|
||||
dedic_gpio_bundle_write(led_line_control_gpio_bundle, 0x0F, 0x00);
|
||||
|
||||
ESP_LOGI(TAG, "Install parallel IO TX unit");
|
||||
parlio_tx_unit_handle_t tx_unit = NULL;
|
||||
parlio_tx_unit_config_t config = {
|
||||
.clk_src = PARLIO_CLK_SRC_DEFAULT,
|
||||
.data_width = EXAMPLE_HUB75_DATA_WIDTH,
|
||||
.clk_in_gpio_num = -1, // use internal clock source
|
||||
.valid_gpio_num = -1, // don't generate valid signal
|
||||
.clk_out_gpio_num = EXAMPLE_PIN_NUM_PCLK,
|
||||
.data_gpio_nums = {
|
||||
[EXAMPLE_HUB75_R1_IDX] = EXAMPLE_PIN_NUM_R1,
|
||||
[EXAMPLE_HUB75_R2_IDX] = EXAMPLE_PIN_NUM_R2,
|
||||
[EXAMPLE_HUB75_G1_IDX] = EXAMPLE_PIN_NUM_G1,
|
||||
[EXAMPLE_HUB75_G2_IDX] = EXAMPLE_PIN_NUM_G2,
|
||||
[EXAMPLE_HUB75_B1_IDX] = EXAMPLE_PIN_NUM_B1,
|
||||
[EXAMPLE_HUB75_B2_IDX] = EXAMPLE_PIN_NUM_B2,
|
||||
[EXAMPLE_HUB75_OE_IDX] = EXAMPLE_PIN_NUM_OE,
|
||||
[EXAMPLE_HUB75_LATCH_IDX] = EXAMPLE_PIN_NUM_LATCH,
|
||||
},
|
||||
.output_clk_freq_hz = EXAMPLE_LED_MATRIX_PIXEL_CLOCK_HZ,
|
||||
.trans_queue_depth = 32,
|
||||
.max_transfer_size = EXAMPLE_LED_MATRIX_H_RES * sizeof(lv_color_t) * 2, // 2 lines as the maximum transfer size
|
||||
.sample_edge = PARLIO_SAMPLE_EDGE_POS,
|
||||
};
|
||||
ESP_ERROR_CHECK(parlio_new_tx_unit(&config, &tx_unit));
|
||||
ESP_ERROR_CHECK(parlio_tx_unit_enable(tx_unit));
|
||||
|
||||
// we use the transaction done callback to update the line address
|
||||
parlio_tx_event_callbacks_t parlio_cbs = {
|
||||
.on_trans_done = parlio_tx_line_done_cb,
|
||||
};
|
||||
ESP_ERROR_CHECK(parlio_tx_unit_register_event_callbacks(tx_unit, &parlio_cbs, led_line_control_gpio_bundle));
|
||||
|
||||
ESP_LOGI(TAG, "Initialize LVGL library");
|
||||
lv_init();
|
||||
// allocate two full-screen draw buffers
|
||||
lv_color_t *buf1 = malloc(EXAMPLE_LED_MATRIX_H_RES * EXAMPLE_LED_MATRIX_V_RES * sizeof(lv_color_t));
|
||||
assert(buf1);
|
||||
lv_color_t *buf2 = malloc(EXAMPLE_LED_MATRIX_H_RES * EXAMPLE_LED_MATRIX_V_RES * sizeof(lv_color_t));
|
||||
assert(buf2);
|
||||
// initialize LVGL draw buffers
|
||||
lv_disp_draw_buf_init(&disp_buf, buf1, buf2, EXAMPLE_LED_MATRIX_H_RES * EXAMPLE_LED_MATRIX_V_RES);
|
||||
|
||||
ESP_LOGI(TAG, "Register display driver to LVGL");
|
||||
lv_disp_drv_init(&disp_drv);
|
||||
disp_drv.hor_res = EXAMPLE_LED_MATRIX_H_RES;
|
||||
disp_drv.ver_res = EXAMPLE_LED_MATRIX_V_RES;
|
||||
disp_drv.flush_cb = example_lvgl_flush_cb;
|
||||
disp_drv.draw_buf = &disp_buf;
|
||||
disp_drv.user_data = NULL;
|
||||
disp_drv.full_refresh = true; // the full_refresh mode can maintain the synchronization between two adjacent frame buffers
|
||||
lv_disp_t *disp = lv_disp_drv_register(&disp_drv);
|
||||
|
||||
ESP_LOGI(TAG, "Install LVGL tick timer");
|
||||
// increase the LVGL tick in the GPTimer alarm callback
|
||||
gptimer_handle_t lvgl_tick_timer = NULL;
|
||||
gptimer_config_t timer_config = {
|
||||
.clk_src = GPTIMER_CLK_SRC_DEFAULT,
|
||||
.direction = GPTIMER_COUNT_UP,
|
||||
.resolution_hz = EXAMPLE_GPTIMER_RESOLUTION_HZ,
|
||||
};
|
||||
ESP_ERROR_CHECK(gptimer_new_timer(&timer_config, &lvgl_tick_timer));
|
||||
gptimer_alarm_config_t alarm_config = {
|
||||
.alarm_count = EXAMPLE_LVGL_TICK_PERIOD_MS * EXAMPLE_GPTIMER_RESOLUTION_HZ / 1000,
|
||||
.reload_count = 0,
|
||||
.flags.auto_reload_on_alarm = true,
|
||||
};
|
||||
ESP_ERROR_CHECK(gptimer_set_alarm_action(lvgl_tick_timer, &alarm_config));
|
||||
gptimer_event_callbacks_t gptimer_cbs = {
|
||||
.on_alarm = gptimer_alarm_cb_lvgl_tick,
|
||||
};
|
||||
ESP_ERROR_CHECK(gptimer_register_event_callbacks(lvgl_tick_timer, &gptimer_cbs, NULL));
|
||||
ESP_ERROR_CHECK(gptimer_enable(lvgl_tick_timer));
|
||||
|
||||
ESP_LOGI(TAG, "Display LVGL UI");
|
||||
example_lvgl_demo_ui(disp);
|
||||
|
||||
ESP_ERROR_CHECK(gptimer_start(lvgl_tick_timer));
|
||||
|
||||
// the frame buffer is flushed to the screen in a while loop without yield, which may cause task watchdog timeout
|
||||
uint8_t *payload = (uint8_t *)s_frame_buffer;
|
||||
parlio_transmit_config_t transmit_config = {
|
||||
.idle_value = 0x00, // the idle value will force the OE line to low, thus enable the output
|
||||
};
|
||||
while (1) {
|
||||
for (int i = 0; i < EXAMPLE_LED_MATRIX_V_RES / 2; i++) {
|
||||
ESP_ERROR_CHECK(parlio_tx_unit_transmit(tx_unit, payload + EXAMPLE_LED_MATRIX_H_RES * i,
|
||||
EXAMPLE_LED_MATRIX_H_RES * sizeof(lv_color_t) * 8, &transmit_config));
|
||||
}
|
||||
ESP_ERROR_CHECK(parlio_tx_unit_wait_all_done(tx_unit, -1));
|
||||
lv_timer_handler();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user