Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

Documentation: dt: Add binding for /secure-chosen/stdout-path

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 <jerome.forissier@linaro.org>
Signed-off-by: Rob Herring <robh@kernel.org>

authored by

Jerome Forissier and committed by
Rob Herring
22a7488c d81cc4a8

+18 -1
+18 -1
Documentation/devicetree/bindings/arm/secure.txt
··· 32 32 secure- bindings only need to be used where both the Secure and Normal 33 33 world views need to be described in a single device tree. 34 34 35 - Valid Secure world properties: 35 + Valid Secure world properties 36 + ----------------------------- 36 37 37 38 - secure-status : specifies whether the device is present and usable 38 39 in the secure world. The combination of this with "status" allows ··· 52 51 status = "disabled"; secure-status = "okay"; /* S-only */ 53 52 status = "disabled"; /* disabled in both */ 54 53 status = "disabled"; secure-status = "disabled"; /* disabled in both */ 54 + 55 + The secure-chosen node 56 + ---------------------- 57 + 58 + Similar to the /chosen node which serves as a place for passing data 59 + between firmware and the operating system, the /secure-chosen node may 60 + be used to pass data to the Secure OS. Only the properties defined 61 + below may appear in the /secure-chosen node. 62 + 63 + - stdout-path : specifies the device to be used by the Secure OS for 64 + its console output. The syntax is the same as for /chosen/stdout-path. 65 + If the /secure-chosen node exists but the stdout-path property is not 66 + present, the Secure OS should not perform any console output. If 67 + /secure-chosen does not exist, the Secure OS should use the value of 68 + /chosen/stdout-path instead (that is, use the same device as the 69 + Normal world OS).