From patchwork Fri Mar 3 09:24:33 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jerome Forissier X-Patchwork-Id: 9602401 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 9B9666016C for ; Fri, 3 Mar 2017 09:26:00 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 8C18F2793A for ; Fri, 3 Mar 2017 09:26:00 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 7F6BF285D5; Fri, 3 Mar 2017 09:26:00 +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=-1.9 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 100832793A for ; Fri, 3 Mar 2017 09:26:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:Message-Id:Date: Subject:To:From:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To: References:List-Owner; bh=qQQ3y5PBB1pXdT0BEteMwuaSoPIFJaezaRPO6HwzArE=; b=d+K LuVwGQuKBsy72dU/7dXkT6bEHuipnSt/hYwBBa/P5BO+BIMxTjkygeUxBaWCFFutYctW59XuJZL4p jQBV8ppLCFI+mah5jOFMjlXt/uolrbTAZHP6Sri8t5KbkKR8v9w7I4F+BR7XiN2ll/cBBpgZDkym3 w8ftlyPyyqBjV//Lt61CrvGtIvNuYEqSiZCCGXrXbs9gJa/uJ4ixCgD+Onezhaaq1MXe/j/eu07sh 6H2LFDzGxW+Ig0tQ/28+pztpCZGw+uvNlGVHIkjsit44G0uV5LRiqjuFnYXc7440XhdNF+Ohz+pmh lB3FdR5smAAeZndUR96sFR4W2RbGTSg==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1cjjTH-0001Vu-98; Fri, 03 Mar 2017 09:25:55 +0000 Received: from mail-wm0-x22a.google.com ([2a00:1450:400c:c09::22a]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1cjjSs-0001TU-Iq for linux-arm-kernel@lists.infradead.org; Fri, 03 Mar 2017 09:25:32 +0000 Received: by mail-wm0-x22a.google.com with SMTP id v186so10559957wmd.0 for ; Fri, 03 Mar 2017 01:25:10 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id; bh=aMJKey/wqfT82n/e+MZyWf+d8Taypu4xYwiUZU4JtXI=; b=R02vwMoCekaQVFYaIIij3VQmuVGR72EedNbgoCoXBi7FL+4kV95e9UZcczZAz0Xfk1 CCYwkBas6eKfw5DoEQ4KrZsyC4IMks7Lmq3JlN6J7aFNd1Ny9gzywVIer901BD4CcFmS VoK5PgoPBCJ+VepVbyasXNzXJ6lajQdf++Hek= 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; bh=aMJKey/wqfT82n/e+MZyWf+d8Taypu4xYwiUZU4JtXI=; b=WiPPbrqed//DnjIsiStXF3e2uOo+U4Pi+yTA9EZtSJEshObfgNKV/ROUHraJrVUpRM YBtg3isJ7UxGZtxcPvLaKAoWQS2SHUn4lCb5sHRXdKqrDdmh3u7P85Ipnbw9k9IxlHzr BltBlVznI/nAbn8WZGaD2A9WxexVcD86CFZEQyqWwyzSJVv6s/mFTqQ/K39sf0UzvqHN t/YKKpma4dEN8eAkWnlrSPmjDoIv99F4+r8lFaBeb8JqnPAuyDQqcXdCOetcwqj6s38j Z09HzNexmhENPfCKfHp+taenHacybmMrLsLWIakg7c7+mxeGvdI84Li+XQClhJuAIAql FIUg== X-Gm-Message-State: AMke39krOS2qpQUHdfzucGwbkAUf0NQIwjStPj0cbNDm48aElRnhk5Iu3sdgL4MDF7M7YUFy X-Received: by 10.28.65.196 with SMTP id o187mr2077617wma.9.1488533108874; Fri, 03 Mar 2017 01:25:08 -0800 (PST) Received: from jfw540.home (ANice-653-1-542-88.w86-205.abo.wanadoo.fr. [86.205.250.88]) by smtp.gmail.com with ESMTPSA id v1sm14457825wra.65.2017.03.03.01.25.07 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 03 Mar 2017 01:25:08 -0800 (PST) From: Jerome Forissier To: devicetree@vger.kernel.org Subject: [PATCH] Documentation: dt: Add binding for /secure-chosen/stdout-path Date: Fri, 3 Mar 2017 10:24:33 +0100 Message-Id: X-Mailer: git-send-email 2.7.4 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20170303_012530_919891_668886E0 X-CRM114-Status: GOOD ( 14.52 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: mark.rutland@arm.com, peter.maydell@linaro.org, Jerome Forissier , robh+dt@kernel.org, linux-arm-kernel@lists.infradead.org, robin.murphy@arm.com, jens.wiklander@linaro.org, christoffer.dall@linaro.org 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 Some platforms may use a single device tree to describe two address spaces, as described in d9f43babb998 ("Documentation: dt: Add bindings for Secure-only devices"). For these platforms it makes sense to define a secure counterpart of /chosen, namely: /secure-chosen. This new node is meant to be used by the secure firmware to pass data to the secure OS. Only the stdout-path property is supported for now. Signed-off-by: Jerome Forissier --- Documentation/devicetree/bindings/arm/secure.txt | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) v2 - Clarify the expected behavior when /secure-chosen/stdout-path is not present (either the property or the node itself), as proposed by Peter and Robin. Note that I have made the fallback to /chosen optional. diff --git a/Documentation/devicetree/bindings/arm/secure.txt b/Documentation/devicetree/bindings/arm/secure.txt index e31303f..c4a818e 100644 --- a/Documentation/devicetree/bindings/arm/secure.txt +++ b/Documentation/devicetree/bindings/arm/secure.txt @@ -32,7 +32,8 @@ describe the view of Secure world using the standard bindings. These secure- bindings only need to be used where both the Secure and Normal world views need to be described in a single device tree. -Valid Secure world properties: +Valid Secure world properties +----------------------------- - secure-status : specifies whether the device is present and usable in the secure world. The combination of this with "status" allows @@ -51,3 +52,19 @@ Valid Secure world properties: status = "disabled"; secure-status = "okay"; /* S-only */ status = "disabled"; /* disabled in both */ status = "disabled"; secure-status = "disabled"; /* disabled in both */ + +The secure-chosen node +---------------------- + +Similar to the /chosen node which serves as a place for passing data +between firmware and the operating system, the /secure-chosen node may +be used to pass data to the Secure OS. Only the properties defined +below may appear in the /secure-chosen node. + +- stdout-path : specifies the device to be used by the Secure OS for + its console output. The syntax is the same as for /chosen/stdout-path. + If the /secure-chosen node exists but the stdout-path property is not + present, the Secure OS should not perform any console output. If + /secure-chosen does not exist, the Secure OS may use the value of + /chosen/stdout-path instead (that is, use the same device as the + Normal world OS).