From patchwork Tue Feb 25 08:46:45 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mateusz Holenko X-Patchwork-Id: 214248 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU, HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY, SPF_HELO_NONE, SPF_PASS, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E3C83C35DFB for ; Tue, 25 Feb 2020 08:46:53 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id BB6DB21556 for ; Tue, 25 Feb 2020 08:46:53 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=antmicro.com header.i=@antmicro.com header.b="kpRNGoAR" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729877AbgBYIqx (ORCPT ); Tue, 25 Feb 2020 03:46:53 -0500 Received: from mail-lf1-f68.google.com ([209.85.167.68]:42029 "EHLO mail-lf1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729875AbgBYIqx (ORCPT ); Tue, 25 Feb 2020 03:46:53 -0500 Received: by mail-lf1-f68.google.com with SMTP id 83so9096851lfh.9 for ; Tue, 25 Feb 2020 00:46:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=antmicro.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=9Q26y6k84gThGD9CxGLIQPfQ8ikXiupLsGZ4lp4CB8w=; b=kpRNGoARmWU8XjGCP2z9Fam8yf6dnxqylyxgXgR+Nvn0OW9mFVKL30hlcW4N+wVax5 LIbcqc+Gu8RthM4IkBiUZ35D3fylMlgXFFcvE7/jfD1P+ErCL2v6Ldwqj3nfUDy0Owg0 56GPonBX61WmQMxQnag2YyqwQ2+TBeZ2hNDZg= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=9Q26y6k84gThGD9CxGLIQPfQ8ikXiupLsGZ4lp4CB8w=; b=KmLnyzjp/OPlUVWungOgt62voO8Tve89JhTnON/kaWFv8tNIuLfzVVaf+2iSLpUO0V V+zF066RqTyANAm/qbRZoQpU6V73ZaaPGePshephg6+AnoT+3jd5gmPfioluaiYNvfeA jXZxhcVSj+ZZc9S1kfEObzXl3TkaWUEsbILnNE1K/rcWD1C5GprJDsLCac91t95bHsGX mJge2q+vp/e9as3I8UUGjTC4HyZdMuWaEbIO5yFqZx8oZ9bUD677CbCEJXghNqq4HHGw nuPIX1JZLQox4rgy2+x7QUo9BoJBjf+nzLhIcyfW/8KFQ2xGyo0UAy6IaQsif4y5MX3R NPuA== X-Gm-Message-State: APjAAAUJYf1dG3s4Lm/Vcsw51UaFrKxRQ2ekBky1F4LJNWs1i5IHAmqX H+BUhLsT1CAJC0l1xqJZNUEQ3g== X-Google-Smtp-Source: APXvYqzvYs+hLaAs0izcAja0Yg3oxr7AuA/zxEsLqTC9Lha97ddDLSPwJXo8+dQtSGCs/HcWBKD0VQ== X-Received: by 2002:ac2:4a62:: with SMTP id q2mr11390516lfp.82.1582620410425; Tue, 25 Feb 2020 00:46:50 -0800 (PST) Received: from localhost.localdomain (d79-196.icpnet.pl. [77.65.79.196]) by smtp.gmail.com with ESMTPSA id e25sm7260951ljp.97.2020.02.25.00.46.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Feb 2020 00:46:49 -0800 (PST) Date: Tue, 25 Feb 2020 09:46:45 +0100 From: Mateusz Holenko To: Rob Herring , Mark Rutland , Greg Kroah-Hartman , Jiri Slaby , devicetree@vger.kernel.org, linux-serial@vger.kernel.org Cc: Stafford Horne , Karol Gugala , Mateusz Holenko , Mauro Carvalho Chehab , "David S. Miller" , "Paul E. McKenney" , Filip Kokosinski , Pawel Czarnecki , Joel Stanley , Jonathan Cameron , Maxime Ripard , Shawn Guo , Heiko Stuebner , Sam Ravnborg , Icenowy Zheng , Laurent Pinchart , linux-kernel@vger.kernel.org Subject: [PATCH v3 2/5] dt-bindings: soc: document LiteX SoC Controller bindings Message-ID: <20200225094437.4170502-2-mholenko@antmicro.com> References: <20200225094437.4170502-0-mholenko@antmicro.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200225094437.4170502-0-mholenko@antmicro.com> Sender: linux-serial-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-serial@vger.kernel.org From: Pawel Czarnecki Add documentation for LiteX SoC Controller bindings. Signed-off-by: Pawel Czarnecki Signed-off-by: Mateusz Holenko --- Notes: This commit has been introduced in v3 of the patchset. .../soc/litex/litex,soc_controller.yaml | 46 +++++++++++++++++++ MAINTAINERS | 6 +++ 2 files changed, 52 insertions(+) create mode 100644 Documentation/devicetree/bindings/soc/litex/litex,soc_controller.yaml diff --git a/Documentation/devicetree/bindings/soc/litex/litex,soc_controller.yaml b/Documentation/devicetree/bindings/soc/litex/litex,soc_controller.yaml new file mode 100644 index 000000000000..039894265319 --- /dev/null +++ b/Documentation/devicetree/bindings/soc/litex/litex,soc_controller.yaml @@ -0,0 +1,46 @@ +PDX-License-Identifier: GPL-2.0 +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/soc/litex/litex,soc_controller.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: LiteX SoC Controller driver + +description: | + This is the SoC Controller driver for the LiteX SoC Builder. + It's purpose is to verify LiteX CSR (Control&Status Register) access + operations and provide function for other drivers to read/write CSRs + and to check if those accessors are ready to use. + +maintainers: + - Karol Gugala + - Mateusz Holenko + +properties: + compatible: + const: litex,soc_controller + + reg: + description: Base address and length of the register space + + status: + description: | + disables or enables node + + const: "okay" + +required: + - compatible + - reg + - status + +examples: + - | + + soc_ctrl0: soc_controller@f0000000 { + compatible = "litex,soc_controller"; + reg = <0x0 0xf0000000 0x0 0xC>; + status = "okay"; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index 4beb8dc4c7eb..ec925c081dd2 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -9725,6 +9725,12 @@ L: kunit-dev@googlegroups.com S: Maintained F: lib/list-test.c +LITEX PLATFORM +M: Karol Gugala +M: Mateusz Holenko +S: Maintained +F: Documentation/devicetree/bindings/*/litex,*.yaml + LIVE PATCHING M: Josh Poimboeuf M: Jiri Kosina From patchwork Tue Feb 25 08:47:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mateusz Holenko X-Patchwork-Id: 214247 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU, HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH, MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3A416C35DF9 for ; Tue, 25 Feb 2020 08:47:15 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 109FD21556 for ; Tue, 25 Feb 2020 08:47:15 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=antmicro.com header.i=@antmicro.com header.b="eA5d0csJ" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729600AbgBYIrO (ORCPT ); Tue, 25 Feb 2020 03:47:14 -0500 Received: from mail-lf1-f68.google.com ([209.85.167.68]:45488 "EHLO mail-lf1-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729268AbgBYIrO (ORCPT ); Tue, 25 Feb 2020 03:47:14 -0500 Received: by mail-lf1-f68.google.com with SMTP id z5so9083592lfd.12 for ; Tue, 25 Feb 2020 00:47:13 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=antmicro.com; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=ocmI9tdr8pveZCkd1YiAB9vTArYU0/qTMSHDA5ZniK4=; b=eA5d0csJ2TjAuJNQoQ9ZTtrBjIws3eb4TVYG5/Ueek/ID8vfM9de9ehmET1DlwMPxM yZN+nh1g3JiN5RON4NifGemVoVZ5KevdSeeAgLtiAgYQzTEm2RAOmp7F7XY4NDDOKm8o xNsHsTWouHHpD5IcrF3domf9eh8YTEcO0FesI= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=ocmI9tdr8pveZCkd1YiAB9vTArYU0/qTMSHDA5ZniK4=; b=VU3AIHrcOArPYfCRgBcB2s4CIsfsWsEHH77gM1i4NcWbT3ndha2/BYoVM8detl297K C/mHqPPqEcgcHvfpWtYcfJ59MGXMqMXHONJcjBRpEElZNkvyMhFCLQ1jZnxIYS6IBiHw kSbmSeipvH6Pvfz85D/YKO8k1uZWLw3xCvBXhgsKsSZlES6uoFsQK6upgk7xz4ANNvhU I0i/B50rNgBoXv8AyND3yi11kJy+NevxvDPxrpk8tDNEiHccWkROMW26RZvlRB/afw2A baZwDemj6A4R3AyeLEb3E1pT7CGMYSRzM5otz4WwGF87OpUEARMu/ObF7Rigg5T2X5XH xKEA== X-Gm-Message-State: APjAAAXLYxx8hgKiiN2LxwSZTHMUZYmpidQW5MmwzyAKKViBmZJzr7VZ WIuRiQNVUESWxaP4mDyJ7IHZ7Q== X-Google-Smtp-Source: APXvYqysKwDew1juuRaq2uQ+jD4QRHbUPE8nYx+dcMDVRKmUUNgliX66MLFu2k8V+k7C0vM5FEmRDQ== X-Received: by 2002:a05:6512:3082:: with SMTP id z2mr3376019lfd.72.1582620432492; Tue, 25 Feb 2020 00:47:12 -0800 (PST) Received: from localhost.localdomain (d79-196.icpnet.pl. [77.65.79.196]) by smtp.gmail.com with ESMTPSA id v15sm6954620lfa.68.2020.02.25.00.47.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 25 Feb 2020 00:47:11 -0800 (PST) Date: Tue, 25 Feb 2020 09:47:07 +0100 From: Mateusz Holenko To: Rob Herring , Mark Rutland , Greg Kroah-Hartman , Jiri Slaby , devicetree@vger.kernel.org, linux-serial@vger.kernel.org Cc: Stafford Horne , Karol Gugala , Mateusz Holenko , Mauro Carvalho Chehab , "David S. Miller" , "Paul E. McKenney" , Filip Kokosinski , Pawel Czarnecki , Joel Stanley , Jonathan Cameron , Maxime Ripard , Shawn Guo , Heiko Stuebner , Sam Ravnborg , Icenowy Zheng , Laurent Pinchart , linux-kernel@vger.kernel.org Subject: [PATCH v3 4/5] dt-bindings: serial: document LiteUART bindings Message-ID: <20200225094437.4170502-4-mholenko@antmicro.com> References: <20200225094437.4170502-0-mholenko@antmicro.com> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20200225094437.4170502-0-mholenko@antmicro.com> Sender: linux-serial-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-serial@vger.kernel.org From: Filip Kokosinski Add documentation for LiteUART devicetree bindings. Signed-off-by: Filip Kokosinski Signed-off-by: Mateusz Holenko Reviewed-by: Rob Herring --- Notes: Changes in v3: - added Reviewed-by tag - patch number changed from 3 to 4 - removed changes in MAINTAINERS file (moved to patch #2) Changes in v2: - binding description rewritten to a yaml schema file - added interrupt line - fixed unit address - patch number changed from 2 to 3 .../bindings/serial/litex,liteuart.yaml | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 Documentation/devicetree/bindings/serial/litex,liteuart.yaml diff --git a/Documentation/devicetree/bindings/serial/litex,liteuart.yaml b/Documentation/devicetree/bindings/serial/litex,liteuart.yaml new file mode 100644 index 000000000000..87bf846b170a --- /dev/null +++ b/Documentation/devicetree/bindings/serial/litex,liteuart.yaml @@ -0,0 +1,38 @@ +# SPDX-License-Identifier: GPL-2.0 + +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/serial/litex,liteuart.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: LiteUART serial controller + +maintainers: + - Karol Gugala + - Mateusz Holenko + +description: | + LiteUART serial controller is a part of LiteX FPGA SoC builder. It supports + multiple CPU architectures, currently including e.g. OpenRISC and RISC-V. + +properties: + compatible: + const: litex,liteuart + + reg: + maxItems: 1 + + interrupts: + maxItems: 1 + +required: + - compatible + - reg + +examples: + - | + uart0: serial@e0001800 { + compatible = "litex,liteuart"; + reg = <0xe0001800 0x100>; + interrupts = <2>; + };