description: >
  AXS15231B display panel (QSPI interface). Combined display+touch controller chip - see
  axs,axs15231b-touch for the touch side, which sits on a separate I2C bus and is modeled as an
  independent devicetree node.

compatible: "axs,axs15231b"

bus: spi

properties:
  horizontal-resolution:
    type: int
    required: true
    description: Horizontal resolution in pixels
  vertical-resolution:
    type: int
    required: true
    description: Vertical resolution in pixels
  mirror-x:
    type: boolean
    default: false
    description: Mirror the X axis
  mirror-y:
    type: boolean
    default: false
    description: Mirror the Y axis
  invert-color:
    type: boolean
    default: false
    description: Invert the panel's color output
  bgr-order:
    type: boolean
    default: false
    description: Use BGR element order instead of RGB
  pixel-clock-hz:
    type: int
    default: 40000000
    description: QSPI pixel clock frequency in Hz
  transaction-queue-depth:
    type: int
    default: 10
    description: Size of the internal SPI transaction queue
  pin-reset:
    type: phandles
    default: GPIO_PIN_SPEC_NONE
    description: Reset GPIO pin
  reset-active-high:
    type: boolean
    default: false
    description: Whether the reset pin is active high
  pin-te:
    type: phandles
    default: GPIO_PIN_SPEC_NONE
    description: Optional Tearing-Effect GPIO pin. When set, draw_bitmap waits (best-effort, up
      to 20ms) for a V-blank pulse on this pin before starting each transfer, to reduce visible
      tearing. Omit to skip TE sync entirely.
  init-sequence:
    type: array
    element-type: uint8_t
    description: >
      Custom vendor bring-up sequence, flattened into bytes as a run of
      [cmd, data-length, delay-ms, data-length bytes of data...] entries. Omit to use the
      AXS15231B component's own built-in default sequence.
  requires-full-frame:
    type: boolean
    default: false
    description: >
      Whether this panel needs full-frame-only draws (DISPLAY_CAPABILITY_REQUIRES_FULL_FRAME) -
      a sub-region draw_bitmap() call desyncs this chip's row auto-increment counter, since its
      QSPI command set has no row-address command.
      It's not certain that this is required for all driver implementations, so it's a config option for now.
  backlight:
    type: phandle
    default: "NULL"
    description: Optional reference to this display's backlight device