feat: JD9165 mipi-dsi display support, for AliExpress P4 Boards

[davetheghost]

Related area

BSP package, P4 evaluation board, etc

Hardware specification

Support for JC1060P470C_I_W

Is your feature request related to a problem?

Not related to a problem, just simply a few GPIO pins reassigned and different driver invoked when using a P4 board that uses the JD9165 display

Describe the solution you'd like

Not sure where I would approach this besides some sort of CONFIG_ that is easily accessible to the user, to enable the JD9165 component driver, and have it properly initialized with the correct settings in order to have at least the demos work.

I was able to get LVGL 9.x.x Demo to work with a little fooling with the driver, and other edits -- though there should be more support for the board given the amount of these things being sold

Describe alternatives you've considered

perhaps having this board/display combination in it's own directory --

personally, I'm trying to move away from the arduino framework, and use IDF exclusively. Admittedly, using the Arduino IDE and the JD9165 driver is easy enough, though with VS code, things can get a bit deep.

Additional context

No response

I have checked existing list of Feature requests and the Contribution Guide

• I confirm I have checked existing list of Feature requests and Contribution Guide.

[github-actions]

Hi @davetheghost! Please be aware that (1) the following suggestions are generated by a bot and haven't been fact-checked by Espressif Systems, (2) burning eFuses and enabling security features are irreversible operations and can damage your ESP32 device. We hope that this message will help you until an Espressif Engineer looks at your issue.

---

Thanks for the request—good news: JD9165 MIPI-DSI is already supported on ESP32-P4 via the esp_lcd JD9165 component, and there’s an Arduino example as well. For ESP-IDF-only workflows, you can add a selectable config in the BSP to switch between ILI9881C/EK79007 and JD9165 and initialize it with the proper DSI/DPI settings.

Suggested approach:

• Use ESP-IDF v5.3+ and ESP32-P4 (MIPI-DSI is only supported there) (ESP32-P4 DSI API; JD9165 component notes).
• Add a Kconfig switch in the ESP32-P4 Function EV Board BSP:
  • Board Support Package(ESP32-P4) → Display → Select LCD type → add JD9165 entry (similar to existing ILI9881C/EK79007/HDMI) (BSP doc).
• In the BSP display init, when JD9165 is selected:
  • Power MIPI D-PHY LDO at 2.5 V (LDO channel 3).
  • Create DSI bus with 2 lanes.
  • Create DBI IO over DSI.
  • Install JD9165 panel with the 1024×600 60 Hz DPI preset (or your panel’s timing if it differs).
  • Bits per pixel: typically RGB888; set rgb order per panel.
    Example (directly from the JD9165 component docs; adapt reset GPIO and pixel format as needed):

  // Power MIPI-DSI PHY
  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));
  
  // DSI bus (2 lanes)
  esp_lcd_dsi_bus_handle_t mipi_dsi_bus = NULL;
  esp_lcd_dsi_bus_config_t bus_config = JD9165_PANEL_BUS_DSI_2CH_CONFIG();
  ESP_ERROR_CHECK(esp_lcd_new_dsi_bus(&bus_config, &mipi_dsi_bus));
  
  // DBI over DSI
  esp_lcd_panel_io_handle_t mipi_dbi_io = NULL;
  esp_lcd_dbi_io_config_t dbi_config = JD9165_PANEL_IO_DBI_CONFIG();
  ESP_ERROR_CHECK(esp_lcd_new_panel_io_dbi(mipi_dsi_bus, &dbi_config, &mipi_dbi_io));
  
  // Panel
  esp_lcd_panel_handle_t panel_handle = NULL;
  const esp_lcd_dpi_panel_config_t dpi_config = JD9165_1024_600_PANEL_60HZ_DPI_CONFIG(EXAMPLE_MIPI_DPI_PX_FORMAT);
  jd9165_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 or -1
      .rgb_ele_order = LCD_RGB_ELEMENT_ORDER_RGB,
      .bits_per_pixel = EXAMPLE_LCD_BIT_PER_PIXEL,
      .vendor_config = &vendor_config,
  };
  ESP_ERROR_CHECK(esp_lcd_new_panel_jd9165(mipi_dbi_io, &panel_config, &panel_handle));
  ESP_ERROR_CHECK(esp_lcd_panel_init(panel_handle));

  (From the JD9165 component docs; requires IDF ≥ 5.3) (ESP LCD JD9165; esp-iot-solution JD9165 README).

Notes and compatibility:

• ESP32-P4 MIPI-DSI supports up to 2 lanes at 1.5 Gbps per lane and RGB565/666/888; some DSI panels default to 4 lanes and must be set to 2 lanes via init commands—check your panel’s JD9165 datasheet and adjust if needed (ESP-FAQ MIPI-DSI notes; ESP32-P4 datasheet).
• If you prefer Arduino for quick validation, the MIPI-DSI example lists JD9165 as supported for ESP32-P4; it shows the required setup flow and can validate hardware before porting into BSP (Arduino MIPI-DSI example; Supported LCD controllers list).

Action items we can take in BSP:

• Add menuconfig option “LCD 1024x600 – JD9165” alongside existing entries and gate-add dependency on espressif/esp_lcd_jd9165 (IDF ≥ 5.3).
• Provide a board variant for JD9165 that:
  • Maps the correct GPIOs (reset/backlight/PWM, etc.) for “AliExpress P4 Boards” if the pinout is known; otherwise document the pins to edit. The knowledge sources don’t include the JC1060P470C_I_W pin map; if you can share it, we can upstream defaults.
  • Uses the 1024×600 60 Hz preset and RGB888 by default.

If this direction works, please share:

• Exact GPIO mapping for reset, backlight, and any power enables on your board.
• Whether your JD9165 panel needs custom init commands or 2-lane reconfiguration.

We’ll prepare a PR to esp-bsp adding the JD9165 selectable option for the ESP32-P4 Function EV Board, aligned with the official JD9165 driver flow above (ESP32-P4 BSP; IDF DSI API; JD9165 component).

[espzav]

Hello @davetheghost, I am so sorry, but the ESP-BSP repository supports only Espressif's and M5Stack's boards. For other boards, you can copy related BSP and modify it for your board. We are planning some better processes for other (custom) boards in future.