Received: by 2002:ac0:da4c:0:0:0:0:0 with SMTP id a12csp517937imi; Thu, 21 Jul 2022 05:57:29 -0700 (PDT) X-Google-Smtp-Source: AGRyM1v+t1o9kDqw3vKihRL59pk1DATVWM1yc7BrILLkq32uM2EV1whp8MJp8izoRf7ZaUWwITTE X-Received: by 2002:a17:90b:4b4d:b0:1ef:a2c2:6bcc with SMTP id mi13-20020a17090b4b4d00b001efa2c26bccmr11387432pjb.186.1658408249520; Thu, 21 Jul 2022 05:57:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1658408249; cv=none; d=google.com; s=arc-20160816; b=pFhYck3Nm0d1sCZ64hkIHHNL2uocCBm90v6OPJCTp3FLKhiBZtawiPM97fY9yiYKL9 B8aaY5q3N8RVv8MLH0E0DbEgxnZxlC0PSllI/GTrGkHmOzc9z7G3QxjV/fV14PAn9Ddh tKJOSUUuE20Fjy+saVsTlpcvLQnAd+RMmnrghs+Uhj1XdXP9VVDCdrtciwq9sTUICv8R ZaaEP1WMY34XuF2QQn9A1oYcNS4bbhcsji5CIptQeMj/A2PoRF3gbD+Wr5YzDugDIiI+ 5UCcOHZYjss/Cwq9FkMzPppoGNiY5IuYeLsSTuAL5iAdnES1Y23pDdRMK5zH1102OTYg Fwag== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=ubh2t70nEuRezrGb4Dpf1+LfKBQbSBVOudTLmnHjho8=; b=oraK1FquhYAA3N2ZlHvSikF3k018ZHHHBB98MRTh39q785CXZB3mDztARY/3KYoRKD wdJjeh7wfsXQOAbPslUDHei9pFC4hvWjhE/Uy8Vls/u2noFenV/ak9j4igs28UZHU+sw SxK03ench/mhfOsj0NBlLkJDbtG2reDaepMhvPelqycHXAGrQTcl2f+pSN0Jpgr1Q7wd vBNf3xQN5k7BGTU1dK+VjaUPHvQOAUEsiXohB80KR87KJuVARzk5iYHjEh2b1jfR3MYF zkiyxKChITqJ82i1u7LdicfJ5DTf3t139xkO/aDs5ZD3NLIkrIhNKRjtIBjZi6Qf+J0U 62DQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=OJSP0q9s; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id k13-20020a170902c40d00b0016d0bf9febasi2326577plk.390.2022.07.21.05.57.15; Thu, 21 Jul 2022 05:57:29 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=OJSP0q9s; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233615AbiGUMdQ (ORCPT + 99 others); Thu, 21 Jul 2022 08:33:16 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39666 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229497AbiGUMdO (ORCPT ); Thu, 21 Jul 2022 08:33:14 -0400 Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2C9CC743C4 for ; Thu, 21 Jul 2022 05:33:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1658406794; x=1689942794; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=9Mastm4bVBpgeITeul311rbm3Z4aqMWvLnpkTWQve5Q=; b=OJSP0q9ssN1S2rjiNsljXOHqaAno/TNMr3Br+Z+VY8lwyD1lGFVmA5dK Xhy4yeAPQNhyzCH3sNeTb3rUNiuEEJhdNJGSgvKI6g8gGOltx3jhbEYNW a55q0B0FV15QtgpPhAXMUW1tzEhsfQ27/45SEs+JX1D1DphzvSQQdGtjq GPaO2g/bzuueM8fwtOmb6LYAq0MWdYRau2M2aAXjRjGSt2So4S60wqzQT ADT7YSDggangEkogZy3Zfnzz9b9zoGbqRXT4B0Ewkak6++7UIFnAesi7D Bhf4buuKjWd7p/Fr4dEMr1pbK+6Hc4EIxZaSWwR2QLKz442IIuMWu5igm A==; X-IronPort-AV: E=McAfee;i="6400,9594,10414"; a="373332458" X-IronPort-AV: E=Sophos;i="5.92,289,1650956400"; d="scan'208";a="373332458" Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Jul 2022 05:33:13 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,289,1650956400"; d="scan'208";a="573720813" Received: from unknown (HELO localhost.localdomain) ([10.226.216.117]) by orsmga006.jf.intel.com with ESMTP; 21 Jul 2022 05:33:11 -0700 From: kah.jing.lee@intel.com To: linux-kernel@vger.kernel.org, gregkh@linuxfoundation.org, arnd@arndb.de Cc: rafael.j.wysocki@intel.com, tien.sung.ang@intel.com, dinh.nguyen@intel.com, Kah Jing Lee , Zhou Furong , Pierre-Louis Bossart Subject: [PATCH v2 3/3] documentation: misc: intel_sysid: Add the system id sysfs documentation for Altera(Intel) FPGA platform Date: Thu, 21 Jul 2022 20:32:59 +0800 Message-Id: <20220721123258.416802-1-kah.jing.lee@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220721123017.416438-1-kah.jing.lee@intel.com> References: <20220721123017.416438-1-kah.jing.lee@intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-5.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED, SPF_HELO_NONE,SPF_NONE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Kah Jing Lee This sysfs documentation is created for Altera(Intel) FPGA platform System ID soft IP. The Altera(Intel) Sysid component is generally part of an FPGA design. The component can be hotplugged when the FPGA is reconfigured. Based on an initial contribution from Ley Foon Tan at Altera Signed-off-by: Kah Jing Lee Reviewed-by: Zhou Furong Reviewed-by: Pierre-Louis Bossart --- .../testing/sysfs-devices-platform-soc-sysid | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 Documentation/ABI/testing/sysfs-devices-platform-soc-sysid diff --git a/Documentation/ABI/testing/sysfs-devices-platform-soc-sysid b/Documentation/ABI/testing/sysfs-devices-platform-soc-sysid new file mode 100644 index 000000000000..9fa58fd88dc0 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-devices-platform-soc-sysid @@ -0,0 +1,27 @@ +What: /sys/devices/platform/soc@X/soc:base_fpga_region/ +soc:base_fpga_region:fpga_pr_region0/XXXXXXXX.sysid/ +Date: May 2022 +KernelVersion: v5.18 +Contact: Kah Jing Lee +Description: + The soc@X/soc:base_fpga_region/soc:base_fpga_region:fpga_pr_region0/ + XXXXXXXX.sysid/ directory contains read-only attributes exposing + information about an System ID soft IP device. The X values could vary, + based on the FPGA platform System ID soft IP register address. + +What: .../XXXXXXX.sysid/sysid +Date: May 2022 +KernelVersion: v5.18 +Contact: Kah Jing Lee +Description: + The .../XXXXXXX.sysid/sysid file contains the System ID for the FPGA + platform which is unique for the platform type and can be used for + checking the platform type for software download purposes. + +What: .../XXXXXXX.sysid/buildtime +Date: May 2022 +KernelVersion: v5.18 +Contact: Kah Jing Lee +Description: + The .../XXXXXXX.sysid/buildtime file contains the buildtime for the + FPGA board file generation. -- 2.25.1