xref: /freebsd/sys/contrib/device-tree/Bindings/pwm/snps,dw-apb-timers-pwm2.yaml (revision 1719886f6d08408b834d270c59ffcfd821c8f63a)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (C) 2022 SiFive, Inc.
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/pwm/snps,dw-apb-timers-pwm2.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Synopsys DW-APB timers PWM controller
9
10maintainers:
11  - Ben Dooks <ben.dooks@sifive.com>
12
13description:
14  This describes the DesignWare APB timers module when used in the PWM
15  mode. The IP core can be generated with various options which can
16  control the functionality, the number of PWMs available and other
17  internal controls the designer requires.
18
19  The IP block has a version register so this can be used for detection
20  instead of having to encode the IP version number in the device tree
21  comaptible.
22
23allOf:
24  - $ref: pwm.yaml#
25
26properties:
27  compatible:
28    const: snps,dw-apb-timers-pwm2
29
30  reg:
31    maxItems: 1
32
33  "#pwm-cells":
34    const: 3
35
36  clocks:
37    items:
38      - description: Interface bus clock
39      - description: PWM reference clock
40
41  clock-names:
42    items:
43      - const: bus
44      - const: timer
45
46  snps,pwm-number:
47    $ref: /schemas/types.yaml#/definitions/uint32
48    description: The number of PWM channels configured for this instance
49    enum: [1, 2, 3, 4, 5, 6, 7, 8]
50
51required:
52  - compatible
53  - reg
54  - "#pwm-cells"
55  - clocks
56  - clock-names
57
58additionalProperties: false
59
60examples:
61  - |
62    pwm: pwm@180000 {
63      compatible = "snps,dw-apb-timers-pwm2";
64      reg = <0x180000 0x200>;
65      #pwm-cells = <3>;
66      clocks = <&bus>, <&timer>;
67      clock-names = "bus", "timer";
68    };
69