From patchwork Tue Apr 13 22:13:24 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Rob Herring \(Arm\)" X-Patchwork-Id: 420246 Delivered-To: patch@linaro.org Received: by 2002:a02:c4d2:0:0:0:0:0 with SMTP id h18csp3006535jaj; Tue, 13 Apr 2021 15:13:29 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxQuLQX1jEqM/Xj08hb2kigmyK5M8v0x/xStC2ZK+qvtl65LHeZ+pYWmHqx/x/bEcbR76l6 X-Received: by 2002:a17:902:9a84:b029:ea:e627:f7c2 with SMTP id w4-20020a1709029a84b02900eae627f7c2mr14545276plp.57.1618352009123; Tue, 13 Apr 2021 15:13:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1618352009; cv=none; d=google.com; s=arc-20160816; b=fftTWcw7zc3cCVKFGRxG8Var/w/fW0V2NmUlAGqWctNo4Jt+pvdaxWSkOUyWGo+WhQ n6EIwQsxlmZ0nPz9fYQ8SwurEXyqvkT5l2AbR7mx/8SiLGFIUosHTHHv5KlzPJGY0MvU V9DoLx9IuAfqQpOrgCPPUsQlpC30jsWDOQ8M6XAAKvipk89ug10hTJav41MZfFL+4zMn xUs/jULJ2SKfzPtMkBOhe041dMUMs3uLiMuh64mcgu/tcqHHHRp9pb6frHaPziyyzpJu ROQiEpU6GCbh+gjKJG9Ru7OP2123vpEWfwAQjMrhaSz+Aw7XF3e3wLQpyIg8PL5cQFgA o8+Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=ObKLeSKO6Zm9QWJCV869w3D4LCNzoFN7I9J2YYe/dTY=; b=l8OKOi+tY5HSjX5rfRqihQKhouMxui/vLmqcrhGzcL6Ga9mxAbwd4Yhmoixh01Q/w3 Tl0uq2DMBqko8fXHYY673mGMArc8DsVk1FSs1ck5EMIQKXjtYjXrw4kh1PGOigS6umPC 7ktFI1qXdVkUx2OcRD2okL5SpBNnV7YLNCLx9WQH9pW21S4mYAEq0axvQ34G1mSS0XJI 9s8qansLVk3q9/sJ1xfu2oUqFKc3wJ1yzLPZ6dO2xENodWtNRJSUj7Whcffi+UQMBe3P e7760OditmOzWASEdYQMGRn4MmI11DLVp5EK1XZM3KYn35JZZ5tYdnQ9lfohKcysJ8nd zomA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id z127si18322429pgz.271.2021.04.13.15.13.28; Tue, 13 Apr 2021 15:13:29 -0700 (PDT) Received-SPF: pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of devicetree-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=devicetree-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231207AbhDMWNs (ORCPT + 6 others); Tue, 13 Apr 2021 18:13:48 -0400 Received: from mail-ot1-f44.google.com ([209.85.210.44]:40893 "EHLO mail-ot1-f44.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229766AbhDMWNr (ORCPT ); Tue, 13 Apr 2021 18:13:47 -0400 Received: by mail-ot1-f44.google.com with SMTP id w31-20020a9d36220000b02901f2cbfc9743so17550525otb.7; Tue, 13 Apr 2021 15:13:26 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=ObKLeSKO6Zm9QWJCV869w3D4LCNzoFN7I9J2YYe/dTY=; b=jMLLHVsUsyybdiQVhvTIy2RiNC8ks+4wyQWMJCWsm6/krrkzs3U2kae8h/VqB6E8j5 srBEbA7Ql96IfuB+D3bT0gFnhCEP4DvfaGFsDkHswdL/wfXI+pa0sxe5FbGxg/16Q2UH YN4hjuEYLgeKC6dtrIxjIEFMeZLtQD6BsOJW048aZU2uBa9Qpr3JM2OkgykXSsy2HAff lx+a1q63/D9y3yikZizlAPDamfehJxpv9Ah7VKDUoIdAvyU4nhgYKn8/S/ScRzYZVu2D BZLcKkYLwH01ba/jcbzFnrmYJl79fIx2JgyVVhCnpj+qTfQeA5+nXrdlwoHTlEJhW70v G6xw== X-Gm-Message-State: AOAM533lUzOgAP/2vtsN++nS/MR7+oN2IDDRjdFa4N43o2svh6feBg0m OKIGoBHOZqTuzUbmS6t10mkwKEjWXw== X-Received: by 2002:a05:6830:1af4:: with SMTP id c20mr11039833otd.136.1618352006179; Tue, 13 Apr 2021 15:13:26 -0700 (PDT) Received: from xps15.herring.priv (24-155-109-49.dyn.grandenetworks.net. [24.155.109.49]) by smtp.googlemail.com with ESMTPSA id u1sm3875456otj.43.2021.04.13.15.13.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Apr 2021 15:13:25 -0700 (PDT) From: Rob Herring To: devicetree@vger.kernel.org Cc: linux-kernel@vger.kernel.org, Arnd Bergmann Subject: [PATCH] dt-bindings: Add schema for known '/aliases' property names Date: Tue, 13 Apr 2021 17:13:24 -0500 Message-Id: <20210413221324.2261097-1-robh@kernel.org> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org '/aliases' node property names haven't ever been documented. There's some names such as 'serial' which are pretty much standard. Then there are other (mostly) platform specific names which sneak in as a way to have indices for devices. Let's add a schema so that any new alias names can be reviewed. The list of property names consists of common aliases which are widely used and ones which are used by the kernel, but are marked deprecated. New users of deprecated names are allowed, but discouraged. There's still more names which are present in DT files, but not used in the kernel or u-boot (it's not trivial to check u-boot usage though). These will generate warnings. Cc: Arnd Bergmann Signed-off-by: Rob Herring --- .../devicetree/bindings/aliases.yaml | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 Documentation/devicetree/bindings/aliases.yaml -- 2.27.0 diff --git a/Documentation/devicetree/bindings/aliases.yaml b/Documentation/devicetree/bindings/aliases.yaml new file mode 100644 index 000000000000..223adbe4a2e9 --- /dev/null +++ b/Documentation/devicetree/bindings/aliases.yaml @@ -0,0 +1,101 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/aliases.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: '/aliases' node properties + +maintainers: + - Rob Herring + +description: | + This schema defines the list of known alias names. + +properties: + $nodename: + const: aliases + +patternProperties: + '^ethernet[0-9]+$': true + '^i2c[0-9]+$': true + '^mmc[0-9]+$': true + '^serial[0-9]+$': true + '^spi[0-9]+$': true + '^rtc[0-9]+$': true + '^watchdog[0-9]+$': true + '^usb[0-9]+$': true + + # Deprecated aliases in use. Don't add to this list. + '^display[0-9]+$': + deprecated: true + + '^dmc[0-9]+$': + deprecated: true + + '^fimc[0-9]+$': + deprecated: true + + '^fimc-lite[0-9]+$': + deprecated: true + + '^fiu[0-9]+$': + deprecated: true + + '^gpio[0-9]+$': + deprecated: true + + '^gsc[0-9]+$': + deprecated: true + + '^hsuart[0-9]+$': + deprecated: true + + '^ipu[0-9]+$': + deprecated: true + + '^mdio-gpio[0-9]+$': + deprecated: true + + '^mshc[0-9]+$': + deprecated: true + + '^mu[0-9]+$': + deprecated: true + + '^phy[0-9]+$': + deprecated: true + + '^pinctrl[0-9]+$': + deprecated: true + + '^rproc[0-9]+$': + deprecated: true + + '^sai[0-9]+$': + deprecated: true + + '^saif[0-9]+$': + deprecated: true + + '^ssc[0-9]+$': + deprecated: true + + '^stmpe-i2c[0-9]+$': + deprecated: true + + '^timer[0-9]+$': + deprecated: true + + '^tmuctrl[0-9]+$': + deprecated: true + + '^usbdrdphy[0-9]+$': + deprecated: true + + '^usbphy[0-9]+$': + deprecated: true + +additionalProperties: false + +...