From patchwork Tue Jun 18 15:11:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiaxun Yang X-Patchwork-Id: 1949276 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=flygoat.com header.i=@flygoat.com header.a=rsa-sha256 header.s=fm3 header.b=ipYjZ3gf; dkim=pass (2048-bit key; unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.a=rsa-sha256 header.s=fm2 header.b=TxgO+B4b; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=2604:1380:40f1:3f00::1; helo=sy.mirrors.kernel.org; envelope-from=devicetree+bounces-77118-incoming-dt=patchwork.ozlabs.org@vger.kernel.org; receiver=patchwork.ozlabs.org) Received: from sy.mirrors.kernel.org (sy.mirrors.kernel.org [IPv6:2604:1380:40f1:3f00::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4W3WLz2XClz20Wb for ; Wed, 19 Jun 2024 01:46:19 +1000 (AEST) Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sy.mirrors.kernel.org (Postfix) with ESMTPS id 4A340B2F6D4 for ; Tue, 18 Jun 2024 15:13:59 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 0EF0C46544; Tue, 18 Jun 2024 15:11:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=flygoat.com header.i=@flygoat.com header.b="ipYjZ3gf"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="TxgO+B4b" X-Original-To: devicetree@vger.kernel.org Received: from wfhigh8-smtp.messagingengine.com (wfhigh8-smtp.messagingengine.com [64.147.123.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5F1D08120A; Tue, 18 Jun 2024 15:11:31 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=64.147.123.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718723492; cv=none; b=VgdC0J+e3jRzJ5Byza7eLPhSNO+YP0PAMQzrz47P1njd+AI5rmi6n1Vebs1usa4XdcSRLYzwn74Q3shplXWpTWOX3pD7ONcLB6kVo+tHtwVlmqEYY+rePpzxnKq8tiCLd+ESA/jfxUSGV9lMvxppOyOiZ2GgHKZn0EwF1Nfv7B8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718723492; c=relaxed/simple; bh=EGs/L0ersYDi7FFZb1HRGrUxBi/oc2LRg13X2yBKvAE=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=aED9p0GOH7tJYcTXsJRHe0CoUCwhr5EayDMlzNcT9TLCTqjekzCb02T18aip/iBEdbfggzrJJuEJBDkrYrbQJuYQen8seonSH977CFKzDZ27Wl7mZQj9uKVdX1fcUWN1B2piqCN1kRO7uRoFRVwxrhfEmpmK50j/xbvOiJ3ckNQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=flygoat.com; spf=pass smtp.mailfrom=flygoat.com; dkim=pass (2048-bit key) header.d=flygoat.com header.i=@flygoat.com header.b=ipYjZ3gf; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=TxgO+B4b; arc=none smtp.client-ip=64.147.123.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=flygoat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flygoat.com Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailfhigh.west.internal (Postfix) with ESMTP id 4447018000A2; Tue, 18 Jun 2024 11:11:30 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute4.internal (MEProxy); Tue, 18 Jun 2024 11:11:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=flygoat.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1718723489; x=1718809889; bh=6JCCT9vFQjkyT9Y0QaS6AanK/xt+H5liO9Oo/z9aq+Y=; b= ipYjZ3gfroSmfr1uWG5fGE5UWl5BIoi+qLNgzto4fI2PUP9OrOrR8i9JcYcGskkS nd410fWhXh2BMpmtbaZ1TfOLI7x3WlTGcXNKUOb0VjHN4m62ZauEoidDrYDH57u/ CVq0ry7Xf4SLfHEOqVmI0P5Cw/Jc6b7JjO2ILzPUhmjLc1eg7htW1yxd9aFECxp0 0HcZKOlQx12FERW/mSL3nedZjD4dsaEBnZMu4zwGNWkqmZFQ2f0HO933CgTjePc/ alulh/wo4XiVx4WpOSveKakFUT6Imbfs84veqqVg85Dc2xx8FMstCk1Hra1qur4n 88UAY84R96jaN75MUjS2PQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1718723489; x= 1718809889; bh=6JCCT9vFQjkyT9Y0QaS6AanK/xt+H5liO9Oo/z9aq+Y=; b=T xgO+B4bJzS+Ig53VI2nZVLfpYBwkETaxxVZW4NHuajpqA4d7dCC4KgBvUikO1gp3 Ccl03DSxliaL6GkekaQ4IBpHwVZePP/yQk2YIoZAXgGCUkYvNeIZyhxfeoFyAJqN 7j5pPPFYDKa3VavsOol2sn8gZvLgq4TIaJN6i6SexuswWE3Ghw7zQpNXK20I3+v9 v3+ZI93tWzfj8aRwsMkH2X8H0Va2UZ1xsi1QLIMmfdIBRzM5uwPprVOVzRU4dgvX lkDT2+sC8Hg0liLa13xRODDcByb1BJxTdFselTXvfy4057l4pw6N3Hor4hKKzw/M lke6A6lAu9iSUsJOhNTVw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrfedvkedgheeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephfffufggtgfgkfhfjgfvvefosehtjeertdertdejnecuhfhrohhmpeflihgr gihunhcujggrnhhguceojhhirgiguhhnrdihrghnghesfhhlhihgohgrthdrtghomheqne cuggftrfgrthhtvghrnheptdffudefteeijeeljedtvdekteduvedtkeetheefkeetkedu tdetkefhfeeuffdvnecuffhomhgrihhnpeguvghvihgtvghtrhgvvgdrohhrghenucevlh hushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpehjihgrgihunhdr higrnhhgsehflhihghhorghtrdgtohhm X-ME-Proxy: Feedback-ID: ifd894703:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 18 Jun 2024 11:11:27 -0400 (EDT) From: Jiaxun Yang Date: Tue, 18 Jun 2024 16:11:07 +0100 Subject: [PATCH v3 7/8] dt-bindings: mfd: Add img,boston-platform-regs Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240618-boston-syscon-v3-7-c47c06647a26@flygoat.com> References: <20240618-boston-syscon-v3-0-c47c06647a26@flygoat.com> In-Reply-To: <20240618-boston-syscon-v3-0-c47c06647a26@flygoat.com> To: Lee Jones , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Paul Burton , Thomas Bogendoerfer Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mips@vger.kernel.org, Jiaxun Yang X-Mailer: b4 0.14.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=3776; i=jiaxun.yang@flygoat.com; h=from:subject:message-id; bh=EGs/L0ersYDi7FFZb1HRGrUxBi/oc2LRg13X2yBKvAE=; b=owGbwMvMwCXmXMhTe71c8zDjabUkhrTCxb2J96ZYuYhxiB+aYt64znyplliYfnPI1ziFQwfEb y3eZ7+ro5SFQYyLQVZMkSVEQKlvQ+PFBdcfZP2BmcPKBDKEgYtTACbSdJnhf6F5ryWrnujfLsYp P6bKiZaGH3il+i30/gSHFw+aj2uVLGX4X5kjny45I/bB1rfWuQ80DR5sSrpTo3PnMH+2UpNFluc rXgA= X-Developer-Key: i=jiaxun.yang@flygoat.com; a=openpgp; fpr=980379BEFEBFBF477EA04EF9C111949073FC0F67 This compatible has been used in arch/mips/boot/dts/img/boston.dts for a while but never documented properly. Write a new binding for this device. This also covers old img,boston-clock binding so remove that binding. Signed-off-by: Jiaxun Yang --- v3: Rename clock and reboot node --- .../devicetree/bindings/clock/img,boston-clock.txt | 31 --------- .../bindings/mfd/img,boston-platform-regs.yaml | 74 ++++++++++++++++++++++ 2 files changed, 74 insertions(+), 31 deletions(-) diff --git a/Documentation/devicetree/bindings/clock/img,boston-clock.txt b/Documentation/devicetree/bindings/clock/img,boston-clock.txt deleted file mode 100644 index 7bc5e9ffb624..000000000000 --- a/Documentation/devicetree/bindings/clock/img,boston-clock.txt +++ /dev/null @@ -1,31 +0,0 @@ -Binding for Imagination Technologies MIPS Boston clock sources. - -This binding uses the common clock binding[1]. - -[1] Documentation/devicetree/bindings/clock/clock-bindings.txt - -The device node must be a child node of the syscon node corresponding to the -Boston system's platform registers. - -Required properties: -- compatible : Should be "img,boston-clock". -- #clock-cells : Should be set to 1. - Values available for clock consumers can be found in the header file: - - -Example: - - system-controller@17ffd000 { - compatible = "img,boston-platform-regs", "syscon"; - reg = <0x17ffd000 0x1000>; - - clk_boston: clock { - compatible = "img,boston-clock"; - #clock-cells = <1>; - }; - }; - - uart0: uart@17ffe000 { - /* ... */ - clocks = <&clk_boston BOSTON_CLK_SYS>; - }; diff --git a/Documentation/devicetree/bindings/mfd/img,boston-platform-regs.yaml b/Documentation/devicetree/bindings/mfd/img,boston-platform-regs.yaml new file mode 100644 index 000000000000..79cae87c6758 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/img,boston-platform-regs.yaml @@ -0,0 +1,74 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mfd/img,boston-platform-regs.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Imagination Technologies Boston Platform Registers + +maintainers: + - Jiaxun Yang + +properties: + compatible: + items: + - const: img,boston-platform-regs + - const: syscon + - const: simple-mfd + + reg: + maxItems: 1 + + clock-controller: + type: object + + description: Boston Clock Controller Device Node + The clock consumer should specify the desired clock by having the clock + ID in its "clocks" phandle cell. + See include/dt-bindings/clock/boston-clock.h for the full list of boston + clock IDs. + + properties: + "#clock-cells": + const: 1 + + compatible: + const: img,boston-clock + + required: + - "#clock-cells" + - compatible + + additionalProperties: false + + reboot: + $ref: /schemas/power/reset/syscon-reboot.yaml# + +required: + - compatible + - reg + - clock-controller + - reboot + +additionalProperties: false + +examples: + - | + #include + + plat_regs: system-controller@17ffd000 { + compatible = "img,boston-platform-regs", "syscon", "simple-mfd"; + reg = <0x17ffd000 0x1000>; + + clk_boston: clock-controller { + compatible = "img,boston-clock"; + #clock-cells = <1>; + }; + + reboot: reboot { + compatible = "syscon-reboot"; + regmap = <&plat_regs>; + offset = <0x10>; + mask = <0x10>; + }; + }; From patchwork Tue Jun 18 15:11:08 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jiaxun Yang X-Patchwork-Id: 1949238 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=flygoat.com header.i=@flygoat.com header.a=rsa-sha256 header.s=fm3 header.b=s+cMBBVN; dkim=pass (2048-bit key; unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.a=rsa-sha256 header.s=fm2 header.b=PEOVA0l6; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org (client-ip=2604:1380:45e3:2400::1; helo=sv.mirrors.kernel.org; envelope-from=devicetree+bounces-77119-incoming-dt=patchwork.ozlabs.org@vger.kernel.org; receiver=patchwork.ozlabs.org) Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org [IPv6:2604:1380:45e3:2400::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1)) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4W3Vdy4TBRz20Wb for ; Wed, 19 Jun 2024 01:14:14 +1000 (AEST) Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 5F7B7280C71 for ; Tue, 18 Jun 2024 15:14:13 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 630D53D0D5; Tue, 18 Jun 2024 15:11:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=flygoat.com header.i=@flygoat.com header.b="s+cMBBVN"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="PEOVA0l6" X-Original-To: devicetree@vger.kernel.org Received: from wfhigh8-smtp.messagingengine.com (wfhigh8-smtp.messagingengine.com [64.147.123.159]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 83802137757; Tue, 18 Jun 2024 15:11:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=64.147.123.159 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718723496; cv=none; b=lXz36h5kG7hbn+GmkOBG40WBS24XE+9eHkKh0B2XEciA+9esv1XtkFZq4wnJB1KChONRaCbNAXFHyxbgI6s3KY2YRayWtArZs4yZutJzyXHTWy624BOrwsXI7Ro2qJt3q0erh5JwrLqirkb/xklWYkiwYwkGkvHx7gT1VpD6PW0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718723496; c=relaxed/simple; bh=HbywrLNjiENzD/e6xffmJVBjKdIskJSRjWMdv+Fu+oY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=a1jVM3KutzDEIkbYjRAgkGd6QndaKfNoH8Il7QwWvFRbadXydkuexJ/hFxyg+ll4mFE2BELziWUFShvmsHWouILadfVwIVW1hHI/wWFJhcmO7JjtvQ0bywnLGpQIyhCWB2N27S2F5QE2KZoAVsiDAh31RxL2UzAmPBlOk8pT3tg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=flygoat.com; spf=pass smtp.mailfrom=flygoat.com; dkim=pass (2048-bit key) header.d=flygoat.com header.i=@flygoat.com header.b=s+cMBBVN; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=PEOVA0l6; arc=none smtp.client-ip=64.147.123.159 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=flygoat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=flygoat.com Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailfhigh.west.internal (Postfix) with ESMTP id 3939D18000A2; Tue, 18 Jun 2024 11:11:33 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Tue, 18 Jun 2024 11:11:33 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=flygoat.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1718723492; x=1718809892; bh=XU+S+B83Z/eXy8X+kkx10rXFqy+1VjvkkGoZYG1E8vY=; b= s+cMBBVNQblKBx7ubPA5osIQYblEm3ySGgTqCwhiIAVPteswzLfs+jU0wr1t59L4 24xT5Gp6AzxNEgXMb6xH8QdS6Wf/2EPIG6j9IP4Y/m+YRDMI7F4SJhjV0l6rlcSV ACgiLYujT2drp5IFti4A8PVufSPgmNfnigLjY6BwgqTCh7oaiNlRfc/BjehtFsJ4 eH78ED/nnOrAtulYIh785V1WhqSJI1a1rzuLpDtPh4Dai5sEDf7zAU59scklvuuU RHyZDTvSQCXWYzMf191BtGsaWo5pKGdtXi1FsNq5W6PAQHow4sJuT8yTemCx/VGG 3jy62vY5AE5o3eUgjp5Agw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm2; t=1718723492; x= 1718809892; bh=XU+S+B83Z/eXy8X+kkx10rXFqy+1VjvkkGoZYG1E8vY=; b=P EOVA0l6pHxEFKP7ddV02Af75DIrzhMjD8hMOXJu/POJLCCz6VnjOKh7+WHVQ+YlT DwSG10IRnkqU5rGaz2ouyMwCfii6BL/le91M4Cl9b/Rr7Jq41nquHGsjIH5ib7v+ 6stYfC/UxjjBbTe2B1czz4vIRu/UeNXYhU3+rhq8Pt/jsQS5eMoDK6z1aWz1Fkku qemSXQSXRdRtWrFtbQBZoycUfbcfGiifFvJk3sAxf99IKJD5ZTk73NH0rGfMUFDv lqrC+XfDZS4X/nCHwHPDiFdEvO0cmu5qj6si4lcXpzmX1J2a8yg9a4fvLSwvDNt3 C6nKVIn3QmhFpLF95+l2w== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrfedvkedgheeiucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephfffufggtgfgkfhfjgfvvefosehtjeertdertdejnecuhfhrohhmpeflihgr gihunhcujggrnhhguceojhhirgiguhhnrdihrghnghesfhhlhihgohgrthdrtghomheqne cuggftrfgrthhtvghrnhepkeevkeefjeekudejvdeuffeufeeigfegfeekleevffekgeef geegtedtjeefffdunecuffhomhgrihhnpeguvghvihgtvghtrhgvvgdrohhrghdptghrvg grthhorhguvghvrdhiohdpphhrphhlfhhouhhnuggrthhiohhnrdhorhhgnecuvehluhhs thgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepjhhirgiguhhnrdihrg hnghesfhhlhihgohgrthdrtghomh X-ME-Proxy: Feedback-ID: ifd894703:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Tue, 18 Jun 2024 11:11:31 -0400 (EDT) From: Jiaxun Yang Date: Tue, 18 Jun 2024 16:11:08 +0100 Subject: [PATCH v3 8/8] dt-bindings: mips: img: Add devices binding Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240618-boston-syscon-v3-8-c47c06647a26@flygoat.com> References: <20240618-boston-syscon-v3-0-c47c06647a26@flygoat.com> In-Reply-To: <20240618-boston-syscon-v3-0-c47c06647a26@flygoat.com> To: Lee Jones , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Paul Burton , Thomas Bogendoerfer Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mips@vger.kernel.org, Jiaxun Yang X-Mailer: b4 0.14.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=6540; i=jiaxun.yang@flygoat.com; h=from:subject:message-id; bh=HbywrLNjiENzD/e6xffmJVBjKdIskJSRjWMdv+Fu+oY=; b=owGbwMvMwCXmXMhTe71c8zDjabUkhrTCxb0iWgWrvsRcL3Zyqtg4b+O32BWyfGV/91bprgxrv LlL89y2jlIWBjEuBlkxRZYQAaW+DY0XF1x/kPUHZg4rE8gQBi5OAZjIyduMDI8dGpx1M4MjnS7W Gu+WbnZ7dm2vRDZLQOCUeccb9pa2tzH8z2L+Znbr/v1NlRwHn17yXBplwPJhsvcP9wvHGIsPzdF YxwMA X-Developer-Key: i=jiaxun.yang@flygoat.com; a=openpgp; fpr=980379BEFEBFBF477EA04EF9C111949073FC0F67 Add devices binding for various Imagination Technologies MIPS based Platforms. Remove old documents. Signed-off-by: Jiaxun Yang Reviewed-by: Krzysztof Kozlowski --- v3: Remove old bindings, they are not relavant any more. Booting protocol stuff is covered by spec. --- .../devicetree/bindings/mips/img/devices.yaml | 33 +++++++++ .../bindings/mips/img/pistachio-marduk.txt | 10 --- .../devicetree/bindings/mips/img/pistachio.txt | 42 ----------- .../devicetree/bindings/mips/img/xilfpga.txt | 83 ---------------------- 4 files changed, 33 insertions(+), 135 deletions(-) diff --git a/Documentation/devicetree/bindings/mips/img/devices.yaml b/Documentation/devicetree/bindings/mips/img/devices.yaml new file mode 100644 index 000000000000..460ca96577ad --- /dev/null +++ b/Documentation/devicetree/bindings/mips/img/devices.yaml @@ -0,0 +1,33 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/mips/img/devices.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Imagination Technologies MIPS based Platforms + +maintainers: + - Jiaxun Yang + +properties: + $nodename: + const: '/' + compatible: + oneOf: + + - description: IMG Boston + const: img,boston + + - description: IMG Marduk (Creator Ci40) + items: + - const: img,pistachio-marduk + - const: img,pistachio + + - description: Imagination University Program MIPSfpga + items: + - const: img,xilfpga + - const: digilent,nexys4ddr + +additionalProperties: true + +... diff --git a/Documentation/devicetree/bindings/mips/img/pistachio-marduk.txt b/Documentation/devicetree/bindings/mips/img/pistachio-marduk.txt deleted file mode 100644 index 2d5126d529a2..000000000000 --- a/Documentation/devicetree/bindings/mips/img/pistachio-marduk.txt +++ /dev/null @@ -1,10 +0,0 @@ -Imagination Technologies' Pistachio SoC based Marduk Board -========================================================== - -Compatible string must be "img,pistachio-marduk", "img,pistachio" - -Hardware and other related documentation is available at -https://docs.creatordev.io/ci40/ - -It is also known as Creator Ci40. Marduk is legacy name and will -be there for decades. diff --git a/Documentation/devicetree/bindings/mips/img/pistachio.txt b/Documentation/devicetree/bindings/mips/img/pistachio.txt deleted file mode 100644 index a736d889c2b8..000000000000 --- a/Documentation/devicetree/bindings/mips/img/pistachio.txt +++ /dev/null @@ -1,42 +0,0 @@ -Imagination Pistachio SoC -========================= - -Required properties: --------------------- - - compatible: Must include "img,pistachio". - -CPU nodes: ----------- -A "cpus" node is required. Required properties: - - #address-cells: Must be 1. - - #size-cells: Must be 0. -A CPU sub-node is also required for at least CPU 0. Since the topology may -be probed via CPS, it is not necessary to specify secondary CPUs. Required -propertis: - - device_type: Must be "cpu". - - compatible: Must be "mti,interaptiv". - - reg: CPU number. - - clocks: Must include the CPU clock. See ../../clock/clock-bindings.txt for - details on clock bindings. -Example: - cpus { - #address-cells = <1>; - #size-cells = <0>; - - cpu0: cpu@0 { - device_type = "cpu"; - compatible = "mti,interaptiv"; - reg = <0>; - clocks = <&clk_core CLK_MIPS>; - }; - }; - - -Boot protocol: --------------- -In accordance with the MIPS UHI specification[1], the bootloader must pass the -following arguments to the kernel: - - $a0: -2. - - $a1: KSEG0 address of the flattened device-tree blob. - -[1] http://prplfoundation.org/wiki/MIPS_documentation diff --git a/Documentation/devicetree/bindings/mips/img/xilfpga.txt b/Documentation/devicetree/bindings/mips/img/xilfpga.txt deleted file mode 100644 index 57e7ee942166..000000000000 --- a/Documentation/devicetree/bindings/mips/img/xilfpga.txt +++ /dev/null @@ -1,83 +0,0 @@ -Imagination University Program MIPSfpga -======================================= - -Under the Imagination University Program, a microAptiv UP core has been -released for academic usage. - -As we are dealing with a MIPS core instantiated on an FPGA, specifications -are fluid and can be varied in RTL. - -This binding document is provided as baseline guidance for the example -project provided by IMG. - -The example project runs on the Nexys4DDR board by Digilent powered by -the ARTIX-7 FPGA by Xilinx. - -Relevant details about the example project and the Nexys4DDR board: - -- microAptiv UP core m14Kc -- 50MHz clock speed -- 128Mbyte DDR RAM at 0x0000_0000 -- 8Kbyte RAM at 0x1000_0000 -- axi_intc at 0x1020_0000 -- axi_uart16550 at 0x1040_0000 -- axi_gpio at 0x1060_0000 -- axi_i2c at 0x10A0_0000 -- custom_gpio at 0x10C0_0000 -- axi_ethernetlite at 0x10E0_0000 -- 8Kbyte BootRAM at 0x1FC0_0000 - -Required properties: --------------------- - - compatible: Must include "digilent,nexys4ddr","img,xilfpga". - -CPU nodes: ----------- -A "cpus" node is required. Required properties: - - #address-cells: Must be 1. - - #size-cells: Must be 0. -A CPU sub-node is also required for at least CPU 0. Required properties: - - device_type: Must be "cpu". - - compatible: Must be "mips,m14Kc". - - reg: Must be <0>. - - clocks: phandle to ext clock for fixed-clock received by MIPS core. - -Example: - - compatible = "img,xilfpga","digilent,nexys4ddr"; - cpus { - #address-cells = <1>; - #size-cells = <0>; - - cpu0: cpu@0 { - device_type = "cpu"; - compatible = "mips,m14Kc"; - reg = <0>; - clocks = <&ext>; - }; - }; - - ext: ext { - compatible = "fixed-clock"; - #clock-cells = <0>; - clock-frequency = <50000000>; - }; - -Boot protocol: --------------- - -The BootRAM is a writeable "RAM" in FPGA at 0x1FC0_0000. -This is for easy reprogrammibility via JTAG. - -The BootRAM initializes the cache and the axi_uart peripheral. - -DDR initialization is already handled by a HW IP block. - -When the example project bitstream is loaded, the cpu_reset button -needs to be pressed. - -The bootram initializes the cache and axi_uart. -Then outputs MIPSFPGA\n\r on the serial port on the Nexys4DDR board. - -At this point, the board is ready to load the Linux kernel -vmlinux file via JTAG.