Implementation of the HX8399 LCD controller with esp_lcd component.
LCD controller | Communication interface | Component name | Link to datasheet |
---|---|---|---|
HX8399 | MIPI-DSI | esp_lcd_hx8399 |
Note: MIPI-DSI interface only supports ESP-IDF v5.3 and above versions.
For more information on LCD, please refer to the LCD documentation.
Packages from this repository are uploaded to Espressif's component service.
You can add them to your project via idf.py add-dependancy
, e.g.
Plaintext
idf.py add-dependency "espressif/esp_lcd_hx8399"
Alternatively, you can create idf_component.yml
. More is in Espressif's documentation.
C
/**
* Uncomment these line if use custom initialization commands.
* The array should be declared as static const and positioned outside the function.
*/
// static const hx8399_lcd_init_cmd_t lcd_init_cmds[] = {
// {cmd, { data }, data_size, delay_ms}
// {0x11, (uint8_t []){0x00}, 120, 0},
// {0x29, (uint8_t []){0x00}, 20, 0},
// ...
// };
ESP_LOGI(TAG, "MIPI DSI PHY Powered on");
esp_ldo_channel_handle_t ldo_mipi_phy = NULL;
esp_ldo_channel_config_t ldo_mipi_phy_config = {
.chan_id = 3,
.voltage_mv = 2500,
};
ESP_ERROR_CHECK(esp_ldo_acquire_channel(&ldo_mipi_phy_config, &ldo_mipi_phy));
ESP_LOGI(TAG, "Initialize MIPI DSI bus");
esp_lcd_dsi_bus_handle_t mipi_dsi_bus = NULL;
esp_lcd_dsi_bus_config_t bus_config = HX8399_PANEL_BUS_DSI_2CH_CONFIG();
ESP_ERROR_CHECK(esp_lcd_new_dsi_bus(&bus_config, &mipi_dsi_bus));
ESP_LOGI(TAG, "Install panel IO");
esp_lcd_panel_io_handle_t mipi_dbi_io = NULL;
esp_lcd_dbi_io_config_t dbi_config = HX8399_PANEL_IO_DBI_CONFIG();
ESP_ERROR_CHECK(esp_lcd_new_panel_io_dbi(mipi_dsi_bus, &dbi_config, &mipi_dbi_io));
ESP_LOGI(TAG, "Install HX8399 panel driver");
esp_lcd_panel_handle_t panel_handle = NULL;
const esp_lcd_dpi_panel_config_t dpi_config = HX8399_1024_600_PANEL_30HZ_DPI_CONFIG(EXAMPLE_MIPI_DPI_PX_FORMAT);
hx8399_vendor_config_t vendor_config = {
.flags = {
.use_mipi_interface = 1,
},
.mipi_config = {
.dsi_bus = mipi_dsi_bus,
.dpi_config = &dpi_config,
},
};
const esp_lcd_panel_dev_config_t panel_config = {
.reset_gpio_num = EXAMPLE_LCD_IO_RST, // Set to -1 if not use
.rgb_ele_order = LCD_RGB_ELEMENT_ORDER_RGB, // Implemented by LCD command `36h`
.bits_per_pixel = EXAMPLE_LCD_BIT_PER_PIXEL, // Implemented by LCD command `3Ah` (16/18/24)
.vendor_config = &vendor_config,
};
ESP_ERROR_CHECK(esp_lcd_new_panel_hx8399(mipi_dbi_io, &panel_config, &panel_handle));
ESP_ERROR_CHECK(esp_lcd_panel_init(panel_handle));
6a112f4ddfeaf30ec360567ea9260a39e195c385
idf.py add-dependency "espressif/esp_lcd_hx8399^1.0.2"