[PATCHv5 6/7] dt-bindings: fpga: add authenticate-fpga-config property

richard.gong
2021-02-10T00:53:13Z

From: Richard Gong <richard.gong@intel.com>

Add authenticate-fpga-config property for FPGA bitstream authentication,
which makes sure a signed bitstream has valid signatures.

Signed-off-by: Richard Gong <richard.gong@intel.com>
---
v5: rewrite the description to highlight two things with
authenticate-fpga-config flag
v4: explain authenticate-fpga-config flag further
v3: no change
v2: put authenticate-fpga-config above partial-fpga-config
update commit messages
---
Documentation/devicetree/bindings/fpga/fpga-region.txt | 10 ++++++++++
1 file changed, 10 insertions(+)

diff --git a/Documentation/devicetree/bindings/fpga/fpga-region.txt b/Documentation/devicetree/bindings/fpga/fpga-region.txt
index e811cf8..dca0e37 100644
--- a/Documentation/devicetree/bindings/fpga/fpga-region.txt
+++ b/Documentation/devicetree/bindings/fpga/fpga-region.txt
@@ -182,6 +182,16 @@ Optional properties:
This property is optional if the FPGA Manager handles the bridges.
If the fpga-region is the child of a fpga-bridge, the list should not
contain the parent bridge.
+- authenticate-fpga-config : boolean, set if do bitstream authentication only.
+ If 'authenticate-fpga-config' is added then adding a new node or another
+ operation is not allowed.
+ Flag authenticate-fpga-config is used to check the integrity of the
+ bitstream.
+ Except for the actual configuration of the device, the authentication
+ works in the same way as FPGA configuration. If the authentication passes,
+ other operations such as full or partial reconfiguration can be performed.
+ When the bitstream into QSPI flash memory at device is programmed, it is
+ expected that there will be no issue when starting the device.
- partial-fpga-config : boolean, set if partial reconfiguration is to be done,
otherwise full reconfiguration is done.
- external-fpga-config : boolean, set if the FPGA has already been configured
--
2.7.4