# Copyright (c) 2020 Hubert Miś <hubert.mis@gmail.com>
# SPDX-License-Identifier: Apache-2.0

description: FTDI FT800 graphic controller

compatible: "ftdi,ft800"

include: spi-device.yaml

properties:
  irq-gpios:
    type: phandle-array
    description: Optional IRQ line of FT800 controller

  pclk:
    type: int
    required: true
    description: |
      The value to divide the main clock by for PCLK. If the
      typical main clock was 48MHz and this value is 5, the PCLK
      will be 9.6 MHz. Must be positive value to enable the screen

  pclk_pol:
    type: int
    required: true
    description: |
      Polarity of PCLK. If it is set to zero, PCLK polarity is on
      the rising edge. If it is set to one, PCLK polarity is on
      the falling edge.

  cspread:
    type: int
    required: true
    description: |
      Controls the transition of RGB signals with PCLK active clock
      edge. When set to 0, R[7:2],G[7:2] and B[7:2] signals change
      following the active edge of PCLK. When set to 1, R[7:2]
      changes a PCLK clock early and B[7:2] a PCLK clock later,
      which helps reduce the system noise.

  swizzle:
    type: int
    required: true
    description: |
      Controls the arrangement of output RGB pins, which may help
      support different LCD panel. Please check FT800 Programmers
      Guide for details.

  vsize:
    type: int
    required: true
    description: Number of visible lines of pixels in one frame

  voffset:
    type: int
    required: true
    description: Number of invisible lines at the beginning of a new frame

  vcycle:
    type: int
    required: true
    description: |
      Number of all lines in a frame. It includes all visible and
      invisible lines at the beginning and at the end of a frame.

  vsync0:
    type: int
    required: true
    description: |
      Number of lines for the high state of signal VSYNC at
      the start of new frame.

  vsync1:
    type: int
    required: true
    description: |
      Number of lines for signal VSYNC toggle takes at the start
      of new frame.

  hsize:
    type: int
    required: true
    description: Number of PCLK cycles per visible part of horizontal line

  hoffset:
    type: int
    required: true
    description: |
      Number of PCLK cycles before pixels are scanned out for
      given line

  hcycle:
    type: int
    required: true
    description: Number of total PCLK cycles per horizontal line scan.

  hsync0:
    type: int
    required: true
    description: Number of PCLK cycles of HSYNC high state during start of
      line

  hsync1:
    type: int
    required: true
    description: Number of PCLK cycles for HSYNC toggle during start of line.