lkml.org 
[lkml]   [2019]   [Apr]   [9]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
Patch in this message
/
From
Subject[PATCHv1 5/6] firmware: rsu: document sysfs interface
Date
From: Richard Gong <richard.gong@intel.com>

Describe Intel Stratix10 Remote System Update (RSU) device attributes

Signed-off-by: Richard Gong <richard.gong@intel.com>
Reviewed-by: Alan Tull <atull@kernel.org>
---
.../testing/sysfs-devices-platform-stratix10-rsu | 78 ++++++++++++++++++++++
1 file changed, 78 insertions(+)
create mode 100644 Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu

diff --git a/Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu b/Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu
new file mode 100644
index 0000000..cb461ee
--- /dev/null
+++ b/Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu
@@ -0,0 +1,78 @@
+ Intel Stratix10 Remote System Update (RSU) device attributes
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/current_image
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) the address of image currently running in flash.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/fail_image
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) the address of failed image in flash.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/state
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) the state of RSU system.
+ The state field has two parts: major error code in upper 16 bits and minor error code
+ in lower 16 bits.
+ 1. Major error code
+ 0xF001 -- bitstream error
+ 0xF002 -- hardware access failure
+ 0xF003 -- bitstream corruption
+ 0xF004 -- internal error
+ 0xF005 -- device error
+ 0xF006 -- HPS watchdog timeout
+ 0xF007 -- internal unknown error
+ 2: Minor error code
+ Currently used only when major error is 0xF006 (HPS watchdog timeout), in which
+ case the minor error code is the value reported by HPS to firmware through the RSU notify
+ command before the watchdog timeout occurs.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/version
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) the version number of RSU firmware.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/error_location
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) the error offset inside the image that failed.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/error_details
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (RO) error code.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/reboot_image
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (WO) the address of image to be loaded on next reboot command.
+
+What: /sys/devices/platform/soc:firmware:svc/soc:firmware:svc:rsu/notify
+Date: April 2019
+KernelVersion: 5.2
+Contact: Richard Gong <richard.gong@intel.com>
+Description:
+ (WO) inform firmware that the current software state as a 16-bit
+ numerical value below:
+ 0 -- the first stage bootloader didn't run or didn't reach the
+ point of launching second stage bootloader
+ 1 -- failed in second bootloader or didn't get to the point of
+ launching the operating system
+ 2 -- both first and second stage bootloader ran and the operating
+ system launch was attempted.
--
2.7.4
\
 
 \ /
  Last update: 2019-04-09 20:38    [W:0.100 / U:7.172 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site