From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.9 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_PASS,URIBL_BLOCKED, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7BB2FC04AAB for ; Tue, 7 May 2019 18:37:23 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 5DD7520675 for ; Tue, 7 May 2019 18:37:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727579AbfEGShW (ORCPT ); Tue, 7 May 2019 14:37:22 -0400 Received: from mga14.intel.com ([192.55.52.115]:41333 "EHLO mga14.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727438AbfEGShT (ORCPT ); Tue, 7 May 2019 14:37:19 -0400 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 07 May 2019 11:37:17 -0700 X-ExtLoop1: 1 Received: from marshy.an.intel.com ([10.122.105.159]) by fmsmga004.fm.intel.com with ESMTP; 07 May 2019 11:37:18 -0700 From: richard.gong@linux.intel.com To: gregkh@linuxfoundation.org, robh+dt@kernel.org, mark.rutland@arm.com, dinguyen@kernel.org, atull@kernel.org Cc: linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, richard.gong@linux.intel.com, Richard Gong Subject: [PATCHv2 3/4] firmware: rsu: document sysfs interface Date: Tue, 7 May 2019 13:46:38 -0500 Message-Id: <1557254799-7416-4-git-send-email-richard.gong@linux.intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1557254799-7416-1-git-send-email-richard.gong@linux.intel.com> References: <1557254799-7416-1-git-send-email-richard.gong@linux.intel.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Richard Gong Describe Intel Stratix10 Remote System Update (RSU) device attributes Signed-off-by: Richard Gong Reviewed-by: Alan Tull --- v2: changed to use tab everywhere and wrap lines at 72 colums s/soc:firmware:svc:rsu/stratix10-rsu.0 added for watchdog --- .../testing/sysfs-devices-platform-stratix10-rsu | 100 +++++++++++++++++++++ 1 file changed, 100 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..f949dfa --- /dev/null +++ b/Documentation/ABI/testing/sysfs-devices-platform-stratix10-rsu @@ -0,0 +1,100 @@ + Intel Stratix10 Remote System Update (RSU) device attributes + +What: /sys/devices/platform/stratix10-rsu.0/current_image +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (RO) the address of image currently running in flash. + +What: /sys/devices/platform/stratix10-rsu.0/fail_image +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (RO) the address of failed image in flash. + +What: /sys/devices/platform/stratix10-rsu.0/state +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +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. + + Major error code: + 0xF001 bitstream error + 0xF002 hardware access failure + 0xF003 bitstream corruption + 0xF004 internal error + 0xF005 device error + 0xF006 CPU watchdog timeout + 0xF007 internal unknown error + Minor error code: + Currently used only when major error is 0xF006 + (CPU watchdog timeout), in which case the minor + error code is the value reported by CPU to + firmware through the RSU notify command before + the watchdog timeout occurs. + +What: /sys/devices/platform/stratix10-rsu.0/fail_image +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (RO) the version number of RSU firmware. + +What: /sys/devices/platform/stratix10-rsu.0/error_location +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (RO) the error offset inside the image that failed. + +What: /sys/devices/platform/stratix10-rsu.0/error_details +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (RO) error code. + +What: /sys/devices/platform/stratix10-rsu.0/reboot_image +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (WO) the address of image to be loaded on next reboot command. + +What: /sys/devices/platform/stratix10-rsu.0/notify +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (WO) inform firmware that the current software state as + a 16-bit numerical value below: + 0 is for the first stage bootloader didn't run + or didn't reach the point of launching second + stage bootloader. + 1 is for failed in second bootloader or didn't + get to the point of launching the operating + system. + 2 is for both first and second stage bootloader + ran and the operating system launch was + attempted. + +What: /sys/devices/platform/stratix10-rsu.0/watchdog +Date: May 2019 +KernelVersion: 5.2 +Contact: Richard Gong +Description: + (WO) instruct firmware what to do when rebooting due to + a watchdog timer expiration. The attribute takes a + 32 bits word as the parameter indicating the action for + firmware to take: + + b[0] is set to 0, the firmware should reboot + with the normal RSU flow. + b[0] is set to 1, the firmware shall always + reboot with the current running image. + b[31:1] reserved. -- 2.7.4