[PATCH v5 2/2] platform/mellanox/mlxbf-bootctl: Add the ABI definitions

From: Liming Sun
Date: Fri May 17 2019 - 13:52:15 EST


This commit adds the ABI definitions exposed to userspace for
the platform/mellanox/mlxbf-bootctl driver.

Reviewed-by: Vadim Pasternak <vadimp@xxxxxxxxxxxx>
Signed-off-by: Liming Sun <lsun@xxxxxxxxxxxx>
---
.../ABI/testing/sysfs-platform-mellanox-bootctl | 58 ++++++++++++++++++++++
MAINTAINERS | 1 +
2 files changed, 59 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-platform-mellanox-bootctl

diff --git a/Documentation/ABI/testing/sysfs-platform-mellanox-bootctl b/Documentation/ABI/testing/sysfs-platform-mellanox-bootctl
new file mode 100644
index 0000000..19a14db
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-platform-mellanox-bootctl
@@ -0,0 +1,58 @@
+What: /sys/bus/platform/drivers/mlxbf-bootctl/lifecycle_state
+Date: May 2019
+KernelVersion: 5.3
+Contact: "Liming Sun <lsun@xxxxxxxxxxxx>"
+Description:
+ The Life-cycle state of the SoC, which could be one of the
+ following values.
+ Production - Production state and can be updated to secure
+ GA Secured - Secure chip and not able to change state
+ GA Non-Secured - Non-Secure chip and not able to change state
+ RMA - Return Merchandise Authorization
+
+What: /sys/bus/platform/drivers/mlxbf-bootctl/post_reset_wdog
+Date: May 2019
+KernelVersion: 5.3
+Contact: "Liming Sun <lsun@xxxxxxxxxxxx>"
+Description:
+ The watchdog setting in seconds for the next booting. It's used
+ to reboot the chip and recover it to the old state if the new
+ boot partition fails.
+
+What: /sys/bus/platform/drivers/mlxbf-bootctl/reset_action
+Date: May 2019
+KernelVersion: 5.3
+Contact: "Liming Sun <lsun@xxxxxxxxxxxx>"
+Description:
+ The source of the boot stream for the next reset. It could be
+ one of the following values.
+ external - boot from external source (USB or PCIe)
+ emmc - boot from the onchip eMMC
+ emmc_legacy - boot from the onchip eMMC in legacy (slow) mode
+
+What: /sys/bus/platform/drivers/mlxbf-bootctl/second_reset_action
+Date: May 2019
+KernelVersion: 5.3
+Contact: "Liming Sun <lsun@xxxxxxxxxxxx>"
+Description:
+ Update the source of the boot stream after next reset. It could
+ be one of the following values and will be applied after next
+ reset.
+ external - boot from external source (USB or PCIe)
+ emmc - boot from the onchip eMMC
+ emmc_legacy - boot from the onchip eMMC in legacy (slow) mode
+ swap_emmc - swap the primary / secondary boot partition
+ none - cancel the action
+
+What: /sys/bus/platform/drivers/mlxbf-bootctl/secure_boot_fuse_state
+Date: May 2019
+KernelVersion: 5.3
+Contact: "Liming Sun <lsun@xxxxxxxxxxxx>"
+Description:
+ The state of eFuse versions with the following values.
+ InUse - burnt, valid and currently in use
+ Used - burnt and valid
+ Free - not burnt and free to use
+ Skipped - not burnt but not free (skipped)
+ Wasted - burnt and invalid
+ Invalid - not burnt but marked as valid (error state).
diff --git a/MAINTAINERS b/MAINTAINERS
index fb9f9d7..8a9d9ce 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -10018,6 +10018,7 @@ M: Darren Hart <dvhart@xxxxxxxxxxxxx>
M: Vadim Pasternak <vadimp@xxxxxxxxxxxx>
L: platform-driver-x86@xxxxxxxxxxxxxxx
S: Supported
+F: Documentation/ABI/testing/sysfs-platform-mellanox-bootctl
F: drivers/platform/mellanox/
F: include/linux/platform_data/mlxreg.h

--
1.8.3.1