# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/pwm/raspberrypi,rp1-pwm.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: Raspberry Pi RP1 PWM controller

maintainers:
  - Naushir Patuck <naush@raspberrypi.com>
  - Andrea della Porta <andrea.porta@suse.com>
  - Stanimir Varbanov <svarbanov@suse.de>

allOf:
  - $ref: pwm.yaml#

description: |
  The PWM peripheral is a flexible waveform generator with a
  variety of operational modes. It has the following features:
   - four independent output channels
   - 32-bit counter widths
   - Seven output generation modes
   - Optional per-channel output inversion
   - Optional duty-cycle data FIFO with DMA support
   - Optional sigma-delta noise shaping engine
  Serves as a fan speed provider to other nodes for a PWM-connected
  fan.

properties:
  compatible:
    const: raspberrypi,rp1-pwm

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  "#pwm-cells":
    const: 3

  dmas:
    maxItems: 1
    description: |
      Phandle to the DMA controller and the channel specifier for
      the duty-cycle FIFO.

  dma-names:
    items:
      - const: tx

required:
  - compatible
  - reg
  - clocks

unevaluatedProperties: false

examples:
  - |
    pwm@98000 {
      compatible = "raspberrypi,rp1-pwm";
      reg = <0x98000 0x100>;
      clocks = <&rp1_clocks 17>;
      #pwm-cells = <3>;
    };