# 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
      required: false
      default: 1
      description: |
        The integral part of the divider for pwm slice 0.
        This number should be in the range 1 - 255. Defaults
        to 1, the same as the RESET value.

    divider-frac-0:
      type: int
      required: false
      default: 0
      description: |
        The fractional part of the divider for pwm slice 0.
        This number should be in the range 0 - 15. Defaults
        to 0, the same as the RESET value.

    divider-int-1:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-2:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-3:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-4:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-5:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-6:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

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

    divider-int-7:
      type: int
      required: false
      default: 1
      description: See divider-int-0 for help

    divider-frac-7:
      type: int
      required: false
      default: 0
      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