From patchwork Mon May 23 16:30:24 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Carlo Caione X-Patchwork-Id: 9132149 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 2377F607D3 for ; Mon, 23 May 2016 16:33:47 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id EEB7928238 for ; Mon, 23 May 2016 16:33:46 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id E19622823D; Mon, 23 May 2016 16:33:46 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.1 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_MED, T_DKIM_INVALID autolearn=unavailable version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id A522628238 for ; Mon, 23 May 2016 16:33:46 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1b4smQ-00044E-TT; Mon, 23 May 2016 16:32:34 +0000 Received: from mail-wm0-x244.google.com ([2a00:1450:400c:c09::244]) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1b4sm0-0003dd-Gx; Mon, 23 May 2016 16:32:11 +0000 Received: by mail-wm0-x244.google.com with SMTP id f75so10411261wmf.2; Mon, 23 May 2016 09:31:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=I4GkktnYyVxD7iqGOkGHVsFpNqvNPLi84s62ez8gIY0=; b=lRBzDOX7BHvS1oD7IEsQVxJpmtzo0ZIe9lcmzXD/CEidv2jkw+Yz/x//EeROJ+DThc l7Fd0jmSnCuH0kQXt68ZSsZlrnk43Jzke9lwyXuKH39hzjbIGuvujwSupqk2TE8b5E1g qXRt/Mm+zSLhXtlWsSy91aNm9ZwFsZzrIsvXLemOo2BH+V87eeEG95ejGirycMs7U7z8 gW6Nr+b0HawlVOfbPaRHvDATU2XR6cac2W73mzqR09TEAk1+VCswD4lOedAJ499rK9dY +W5k+j5tLMSyU/lGFBqzhObujlQ7B2ArMdbm69U+N/gXtvJFyP+sw0bQaCQa/h8qjWjY sTjw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=I4GkktnYyVxD7iqGOkGHVsFpNqvNPLi84s62ez8gIY0=; b=Z78rBblpJmVPVDRM+3bddUVIt/rH82NjDnaGfklwykhPikOt251TR506YX8jOM2ncV by0ks85OJV8nZCTWbfM/VFSz8bVaysc1mAy8bE7YZ29PzM1eeN+fmTd7hpS0mDbet3YA FNKNH6QUrgSkYN7posJYdIBXE6BgLvAnrxPf4DqklMhoJeN3nxIz97gWzwb6+HWnV2H+ 8O3bSUcolvWZPqPH1ubDDrDprgVqKnBo9ymrsqo/pvUXRo+pPolXh7IhUZJvaHUxrOWc Ilegxwk2spqyENYsFfxCNManLhtrjqAe7OeI3ThlKMi31tESVp4ICufyngIo/T1tdJxe M7rA== X-Gm-Message-State: AOPr4FXND/5PuMmlpm1s99mOlceD2FQoVDwQBmX/jI9qpWtCfT4qSNVUpr7rnKkpPbxkzA== X-Received: by 10.194.205.105 with SMTP id lf9mr17359480wjc.25.1464021109471; Mon, 23 May 2016 09:31:49 -0700 (PDT) Received: from localhost.localdomain (2-238-57-164.ip242.fastwebnet.it. [2.238.57.164]) by smtp.gmail.com with ESMTPSA id o129sm14483647wmb.17.2016.05.23.09.31.47 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Mon, 23 May 2016 09:31:48 -0700 (PDT) From: Carlo Caione To: linux-arm-kernel@lists.infradead.org, linux-amlogic@lists.infradead.org, linux@endlessm.com, devicetree@vger.kernel.org, khilman@baylibre.com, afaerber@suse.de, arnd@arndb.de, jens.wiklander@linaro.org, mark.rutland@arm.com, robh+dt@kernel.org, matthias.bgg@gmail.com Subject: [PATCH v3 4/4] documentation: Add secure monitor binding documentation Date: Mon, 23 May 2016 18:30:24 +0200 Message-Id: <1464021024-29380-5-git-send-email-carlo@caione.org> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1464021024-29380-1-git-send-email-carlo@caione.org> References: <1464021024-29380-1-git-send-email-carlo@caione.org> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160523_093208_848594_8C2FE8F2 X-CRM114-Status: GOOD ( 13.57 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Carlo Caione MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP From: Carlo Caione Add the binding documentation for the Amlogic secure monitor driver. Signed-off-by: Carlo Caione --- .../bindings/firmware/meson/meson_sm.txt | 51 ++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Documentation/devicetree/bindings/firmware/meson/meson_sm.txt diff --git a/Documentation/devicetree/bindings/firmware/meson/meson_sm.txt b/Documentation/devicetree/bindings/firmware/meson/meson_sm.txt new file mode 100644 index 0000000..2b71716 --- /dev/null +++ b/Documentation/devicetree/bindings/firmware/meson/meson_sm.txt @@ -0,0 +1,51 @@ +* Amlogic Secure Monitor + +In the Amlogic SoCs the Secure Monitor code is used to provide access to the +NVMEM, enable JTAG, set USB boot, etc... + +Required properties for the secure monitor node: +- compatible: Should be "amlogic,meson-sm" +- amlogic,sm-cmd-input-base: SMC32 function identifier to read the physical + address of the input buffer +- amlogic,sm-cmd-output-base: SMC32 function identifier to read the physical + address of the output buffer + +Example: + + #include + + ... + + firmware { + compatible = "simple-bus"; + + sm: secure-monitor { + compatible = "amlogic,meson-sm"; + amlogic,sm-cmd-input-base = ; + amlogic,sm-cmd-output-base = ; + }; + }; + +Node of a device using the secure monitor must have a custom property to +specify the SMC32 function the driver is going to use. The values of all the +SMC function identifiers are listed in a SoC-specific header file: + +"include/dt-bindings/firmware/meson-gxbb-sm.h" - for the Meson GXBB secure monitor. + +Example of the node using the secure monitor: + + #include + + ... + + efuse: efuse { + compatible = "amlogic,meson-gxbb-efuse"; + secure-monitor = <&sm>; + amlogic,sm-cmd-read-efuse = ; + amlogic,sm-cmd-max-efuse = ; + #address-cells = <1>; + #size-cells = <1>; + + ... + }; +