How to Debug LVDS Display on RK3568

RK3568 is often used with LVDS TFT panels in industrial HMI products. LVDS is stable, but bring-up can still fail if the channel mode, data mapping, timing, backlight, or Device Tree configuration does not match the panel.

Confirm the Panel Type

Before editing Device Tree, read the panel datasheet and confirm:

Do not reuse timing from a similar panel unless the datasheet confirms the same values.

Check Single or Dual LVDS

Single-channel LVDS is common for 800x480 and 1024x600 panels. Dual-channel LVDS is common for higher bandwidth panels. If the RK3568 output mode does not match the panel, the image may be absent, split, shifted, or unstable.

Check VESA vs JEIDA Mapping

Wrong LVDS mapping usually causes abnormal colors, inverted color depth, or washed-out images. If the display lights up but colors are wrong, compare the panel datasheet with the RK3568 LVDS output format.

Verify Backlight Separately

A working LVDS signal cannot be seen without backlight. Test the backlight enable GPIO and PWM output before assuming the LVDS output is broken.

For backlight debugging, see LCD Backlight Turns On but No Image and PWM Backlight Configuration in Linux Device Tree.

Device Tree Areas to Review

Typical RK3568 LVDS debugging areas include panel timing, output interface, route selection, pinctrl, regulators, backlight node, and display subsystem status.

For a full RK3568 LVDS example, see RK3568 LVDS Display Configuration Guide.

Symptom-Based Debugging

Different LVDS symptoms usually point to different parts of the configuration.

If the display is completely dark, start with panel power and backlight. LVDS data may be present, but the user will not see an image if the LED driver is disabled. Check the backlight voltage, enable GPIO, PWM signal, and default brightness level.

If the backlight turns on but the image is blank, check whether the RK3568 display route is enabled. The LVDS output, panel node, VOP route, and backlight reference must all match. A disabled route can produce a lit panel with no valid image data.

If the image appears but colors are wrong, check VESA versus JEIDA mapping and 6-bit versus 8-bit color. This is one of the most common LVDS bring-up mistakes. The panel may be electrically working, but the bit order does not match the panel input format.

If the image is split, duplicated, or only half visible, check single-channel versus dual-channel LVDS. A dual-channel panel receiving single-channel data may show only partial or scrambled output.

If the image flickers or shifts, check pixel clock, porch values, sync width, and signal integrity. Timing values copied from a different resolution are a frequent cause.

RK3568 Display Route Checklist

On RK3568 systems, the final board design matters as much as the SoC capability. Confirm that the specific SBC actually routes LVDS to the LCD connector. Some boards expose HDMI or MIPI DSI but do not expose LVDS, even though the SoC family supports it.

Use this checklist:

  1. Confirm LVDS pins are routed on the board.
  2. Confirm the LCD connector pinout matches the panel cable.
  3. Confirm panel power rails are present.
  4. Confirm backlight power is separate from panel logic power.
  5. Confirm the correct VOP output is routed to LVDS.
  6. Confirm the LVDS bridge or internal LVDS block is enabled.
  7. Confirm the panel timing is in the active panel node.
  8. Confirm the kernel log shows the panel driver probing.

Example Timing Review

When reviewing timing, calculate the total line and frame size. For a 1024x600 panel, the visible area is only part of the full timing. The panel still needs front porch, sync width, and back porch. If the pixel clock is too low or too high for the total timing, the panel may refuse to lock.

Do not only compare resolution. Two 1024x600 LVDS panels may use different clocks and porch values. If the display vendor provides typical, minimum, and maximum timing, start with the typical value.

Hardware Checks

LVDS is differential, but it is not immune to board problems. Check pair routing, connector orientation, cable length, grounding, and whether the panel requires twisted-pair cable or a specific harness. On prototypes, reseating the cable and checking pin 1 orientation is still worth doing.

For production, validate display behavior during cold boot, warm reboot, suspend/resume, brightness changes, and long-time aging. LVDS problems that only appear after temperature changes are usually hardware margin, power, or cable issues rather than simple Device Tree syntax.