Received: by 2002:a25:ab43:0:0:0:0:0 with SMTP id u61csp818437ybi; Fri, 24 May 2019 11:58:40 -0700 (PDT) X-Google-Smtp-Source: APXvYqwAgAt4ldeFsvRSkGXjLwFO2UKFYS/4uILPUnAwOG40T5uHKKerh/DH7vMH8rYdqcjWqXAf X-Received: by 2002:a63:17:: with SMTP id 23mr106626164pga.206.1558724320285; Fri, 24 May 2019 11:58:40 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1558724320; cv=none; d=google.com; s=arc-20160816; b=dO9JnpXnqmJMeYIHupblG+C0BZE0k8hzrE3ibedp3mfnidbUpCbqVhvtDEkQ4M4CGS fu7kHCOWyNSHds0WHbXxRxHHoZlK8aP9hq51Aui3pA3UjnLNdzBBKlHfn6+KM788Jh8+ kIodPpXJBf/kCLM7svcieb5OVHXz6eacZeaNHQY7SBrggzoYVMlBFuloOSwXvaSVF+IB +vBsZyHYuBcYqg42eqyLOq5i3Eoohrvf381HMz2rAGW/97eBKu/0b1yI7//OuuvpUSIH Z5JLfcsCabxWJGmnfQ000iT7ZpxTo6gaxK74Mvu7KDuEfRdnLS1vors0ZtGkRkf92pAS 7asw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:dkim-signature; bh=9sybizUeKsGYzGFVMqkLR0khYREMg6IY64YjgtcG+g4=; b=VCjsETxf3QI5HyhJhoBb06DZRpxyP/GiLxiww2FjQz30s23RaOtYX04KxUcpLyhlqN uu2YnVcO2eC0MtI+UTHdI501e8HC57T+QFHvxGXU0VZPkUNYQbhPB9kP88I1nbKDfYvg 1CQWZrEUfP5s1DNyCuO/THMTZUrmd+tjmqRx+ykR9ms1QeBIl5B4cW1SCiFaPlRIY4Bp L3saKkI1yTguk2y2NQBpO+4Mr47/0AcQPkm+afSgItwq0LeFGFdEN4yqF1SB4u7s6tSQ MuS4E20VGemI7z/IPtMSYqVVBOBM3+HWGAnORVCurlgLOfJZ6vyAOTptiGzvI/HVn909 8dYw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=UkL5oanR; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id f11si4782628pgl.539.2019.05.24.11.58.24; Fri, 24 May 2019 11:58:40 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=default header.b=UkL5oanR; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730008AbfEXS4j (ORCPT + 99 others); Fri, 24 May 2019 14:56:39 -0400 Received: from mail.kernel.org ([198.145.29.99]:59774 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1729017AbfEXS4i (ORCPT ); Fri, 24 May 2019 14:56:38 -0400 Received: from localhost (83-86-89-107.cable.dynamic.v4.ziggo.nl [83.86.89.107]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 01E262184E; Fri, 24 May 2019 18:56:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1558724197; bh=mDq/DWwgp3UM71BT18cgNx7A9Iyxv2hOHPkkrxaLreY=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=UkL5oanR0C4pERFmmeGAEx005S21NpvisgZIXizHIlgfhFI5z9XQqxOmiAcorXohw ktqNZQYGo62yjCX2ADIFb2diz51G0Pz2LHOkL4e7je7dY7rsIF0ahZ8hrCIt0XRbAe OzdADpJAFitmnOYrmYa29LnFFGZIm8oDXZ1k4YmM= Date: Fri, 24 May 2019 20:56:35 +0200 From: Greg KH To: richard.gong@linux.intel.com Cc: robh+dt@kernel.org, mark.rutland@arm.com, dinguyen@kernel.org, atull@kernel.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org, sen.li@intel.com, Richard Gong Subject: Re: [PATCHv3 3/4] firmware: rsu: document sysfs interface Message-ID: <20190524185635.GA13200@kroah.com> References: <1558616610-499-1-git-send-email-richard.gong@linux.intel.com> <1558616610-499-4-git-send-email-richard.gong@linux.intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1558616610-499-4-git-send-email-richard.gong@linux.intel.com> User-Agent: Mutt/1.11.4 (2019-03-13) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, May 23, 2019 at 08:03:29AM -0500, richard.gong@linux.intel.com wrote: > 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 > v3: s/KernelVersion:5.2/KernelVersion:5.3 > --- > .../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..73ebaf2 > --- /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.3 > +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.3 > +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.3 > +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.3 > +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.3 > +Contact: Richard Gong > +Description: > + (RO) the error offset inside the image that failed. > + You are mixing tabs and spaces in this file. Please always just use tabs. thanks, greg k-h