dts/bindings/timer/andestech,atcpit100.yaml

#
# Copyright (c) 2022, Andes Technology Corporation.
#
# SPDX-License-Identifier: Apache-2.0
#

description: |
    This is a representation of the Andes Technology atcpit100 PIT node

compatible: "andestech,atcpit100"

include: base.yaml

properties:
  reg:
    required: true

  interrupts:
    required: true

  clock-frequency:
    type: int
    required: true
    description: channel clock source

  prescaler:
    type: int
    default: 1
    description: |
      The prescaler value defines the counter frequency
      (clock-frequency/prescaler) in atcpit100 counter driver, the prescaler
      value could be in range [1 .. clock-frequency] and 1 means no prescaler
      for the PIT clock-frequency.

      Defaults to 1 to use the PIT clock-frequency as the counter frequency.

      Setting the prescaler value if the system overhead is close to or
      larger than a counter tick period, reducing the counter frequency to
      avoid imprecise counter value.

      For example, andes_v5_ae350 platform takes about 200 ~ 300 PIT
      clock cycles for counter interface, setting prescaler value to 600 in
      this case.