xref: /freebsd-src/sys/contrib/device-tree/Bindings/ata/pata-common.yaml (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145)
1c66ec88fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2c66ec88fSEmmanuel Vadot%YAML 1.2
3c66ec88fSEmmanuel Vadot---
4c66ec88fSEmmanuel Vadot$id: http://devicetree.org/schemas/ata/pata-common.yaml#
5c66ec88fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6c66ec88fSEmmanuel Vadot
7c66ec88fSEmmanuel Vadottitle: Common Properties for Parallel AT attachment (PATA) controllers
8c66ec88fSEmmanuel Vadot
9c66ec88fSEmmanuel Vadotmaintainers:
10c66ec88fSEmmanuel Vadot  - Linus Walleij <linus.walleij@linaro.org>
11c66ec88fSEmmanuel Vadot
12c66ec88fSEmmanuel Vadotdescription: |
13c66ec88fSEmmanuel Vadot  This document defines device tree properties common to most Parallel
14c66ec88fSEmmanuel Vadot  ATA (PATA, also known as IDE) AT attachment storage devices.
15*aa1a8ff2SEmmanuel Vadot  It doesn't constitute a device tree binding specification by itself but is
16c66ec88fSEmmanuel Vadot  meant to be referenced by device tree bindings.
17c66ec88fSEmmanuel Vadot
18c66ec88fSEmmanuel Vadot  The PATA (IDE) controller-specific device tree bindings are responsible for
19c66ec88fSEmmanuel Vadot  defining whether each property is required or optional.
20c66ec88fSEmmanuel Vadot
21c66ec88fSEmmanuel Vadotproperties:
22c66ec88fSEmmanuel Vadot  $nodename:
23c66ec88fSEmmanuel Vadot    pattern: "^ide(@.*)?$"
24c66ec88fSEmmanuel Vadot    description:
25c66ec88fSEmmanuel Vadot      Specifies the host controller node. PATA host controller nodes are named
26c66ec88fSEmmanuel Vadot      "ide".
27c66ec88fSEmmanuel Vadot
28c66ec88fSEmmanuel Vadot  "#address-cells":
29c66ec88fSEmmanuel Vadot    const: 1
30c66ec88fSEmmanuel Vadot
31c66ec88fSEmmanuel Vadot  "#size-cells":
32c66ec88fSEmmanuel Vadot    const: 0
33c66ec88fSEmmanuel Vadot
34c66ec88fSEmmanuel VadotpatternProperties:
35c66ec88fSEmmanuel Vadot  "^ide-port@[0-1]$":
36c66ec88fSEmmanuel Vadot    description: |
37c66ec88fSEmmanuel Vadot      DT nodes for ports connected on the PATA host. The master drive will have
38c66ec88fSEmmanuel Vadot      ID number 0 and the slave drive will have ID number 1. The PATA port
39c66ec88fSEmmanuel Vadot      nodes will be named "ide-port".
40c66ec88fSEmmanuel Vadot    type: object
41*aa1a8ff2SEmmanuel Vadot    additionalProperties: false
42c66ec88fSEmmanuel Vadot
43c66ec88fSEmmanuel Vadot    properties:
44c66ec88fSEmmanuel Vadot      reg:
45c66ec88fSEmmanuel Vadot        minimum: 0
46c66ec88fSEmmanuel Vadot        maximum: 1
47c66ec88fSEmmanuel Vadot        description:
48c66ec88fSEmmanuel Vadot          The ID number of the drive port, 0 for the master port and 1 for the
49c66ec88fSEmmanuel Vadot          slave port.
50c66ec88fSEmmanuel Vadot
516be33864SEmmanuel VadotadditionalProperties: true
526be33864SEmmanuel Vadot
53c66ec88fSEmmanuel Vadot...
54