# Copyright (c) 2022, Joep Buruma
# SPDX-License-Identifier: Apache-2.0

description: Raspberry Pi Pico PWM

compatible: "raspberrypi,pico-pwm"

include: [pwm-controller.yaml, pinctrl-device.yaml, reset-device.yaml, base.yaml]

properties:
  reg:
    required: true

  interrupts:
    required: true

  divider-int-0:
    type: int
    description: |
      The integral part of the divider for pwm slice 0.
      If a value between 1 and 255 is set, it will be set to the register
      as the integer part of the divider.
      If the value is set to 0 or this property is not defined when setting
      the number of cycles to PWM, a division ratio appropriate to that value is set.

  divider-frac-0:
    type: int
    description: |
      The fractional part of the divider for pwm slice 0.
      This number should be in the range 0 - 15.
      When the "divider-int-0" is set to 0 or is not defined, this property will be
      ignored.

  divider-int-1:
    type: int
    description: See divider-int-0 for help

  divider-frac-1:
    type: int
    description: See divider-frac-0 for help

  divider-int-2:
    type: int
    description: See divider-int-0 for help

  divider-frac-2:
    type: int
    description: See divider-frac-0 for help

  divider-int-3:
    type: int
    description: See divider-int-0 for help

  divider-frac-3:
    type: int
    description: See divider-frac-0 for help

  divider-int-4:
    type: int
    description: See divider-int-0 for help

  divider-frac-4:
    type: int
    description: See divider-frac-0 for help

  divider-int-5:
    type: int
    description: See divider-int-0 for help

  divider-frac-5:
    type: int
    description: See divider-frac-0 for help

  divider-int-6:
    type: int
    description: See divider-int-0 for help

  divider-frac-6:
    type: int
    description: See divider-frac-0 for help

  divider-int-7:
    type: int
    description: See divider-int-0 for help

  divider-frac-7:
    type: int
    description: See divider-frac-0 for help

  "#pwm-cells":
    const: 3

pwm-cells:
  # The rpi pico pwm peripheral is divided in 8 slices with an individual
  # clock setting and two output channels. The pwm channels are mapped the
  # following way PWM_CH0_A is addressed as <&pwm 0 PWM_FLAGS>, PWM_CH0B
  # is <&pwm 1 PMW_FLAGS>, PWM_CH1_A si <&pwm 2 PWM_FLAGS> and so on.
  - channel
  - period
  - flags