From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Return-path: Subject: Re: [PATCH linux dev-4.10 4/6] Documentation: dt-bindings: Add a generic PECI hwmon To: Arnd Bergmann Cc: Joel Stanley , Andrew Jeffery , gregkh , Jean Delvare , Guenter Roeck , Linux Kernel Mailing List , linux-doc@vger.kernel.org, DTML , linux-hwmon@vger.kernel.org, Linux ARM , OpenBMC Maillist References: <20180109223126.13093-1-jae.hyun.yoo@linux.intel.com> <20180109223126.13093-5-jae.hyun.yoo@linux.intel.com> From: Jae Hyun Yoo Message-ID: <9e39dd66-7f8a-e788-f711-ae34b97806fc@linux.intel.com> Date: Wed, 10 Jan 2018 15:20:36 -0800 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit List-ID: On 1/10/2018 4:20 AM, Arnd Bergmann wrote: > On Tue, Jan 9, 2018 at 11:31 PM, Jae Hyun Yoo > wrote: >> This commit add a dt-bindings document for a generic PECI hwmon >> driver. >> >> Signed-off-by: Jae Hyun Yoo >> --- >> .../devicetree/bindings/hwmon/peci-hwmon.txt | 33 ++++++++++++++++++++++ >> 1 file changed, 33 insertions(+) >> create mode 100644 Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> >> diff --git a/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt b/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> new file mode 100644 >> index 0000000..20b86f5 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> @@ -0,0 +1,33 @@ >> +* Generic PECI (Platform Environment Control Interface) hwmon driver. >> + >> +Dependency: >> +- This driver uses a PECI misc driver as a controller interface so one of PECI >> + misc drivers which provides compatible ioctls has to be enabled. > > The binding should only explain how we describe the hardware in an > operating-system > independent way, but not talk about how an OS is supposed to implement those > drivers. > > Having multiple drivers each provide an exported function is not possible > in Linux: it immediately breaks building an 'allyesconfig' kernel, and prevents > you from running the same kernel across multiple implementations, so that > has to be redesigned anyway. > Agreed, I'll consider redesigning of it. >> +Required properties: >> +- compatible: "peci-hwmon" >> +- cpu-id: Should contain CPU socket ID >> + - 0 ~ 7 >> + >> +Optional properties: >> +- show-core: If this protperty is defined, core tmeperature attrubites will be > > s/protperty/property/ > s/tmeperature/temperature/ > s/attrubites/attributes/ > Oops! I made this many typos in this single line. Thanks for your pointing it out. Will fix these. >> + enumerated. >> +- dimm-nums: Should contain the number of DIMM slots that attached to each CPU >> + which is indicated by cpu-id. >> + 0 ~ 16 (default: 16) >> + In case of 0, DIMM temperature attrubites will not be enumerated. > > Is this only an initial list that you expect to be extended in the > future, or is this > a complete list of sensors that can ever be connected to PECI? > > Should this be PECI version specific? > > Arnd > The maximum supportable number of dimm slots is not PECI version specific but depends on CPU architecture. Currently IA supports up to 16 slot as the maximum but it could vary in the future architecture. Thanks, Jae From mboxrd@z Thu Jan 1 00:00:00 1970 From: jae.hyun.yoo@linux.intel.com (Jae Hyun Yoo) Date: Wed, 10 Jan 2018 15:20:36 -0800 Subject: [PATCH linux dev-4.10 4/6] Documentation: dt-bindings: Add a generic PECI hwmon In-Reply-To: References: <20180109223126.13093-1-jae.hyun.yoo@linux.intel.com> <20180109223126.13093-5-jae.hyun.yoo@linux.intel.com> Message-ID: <9e39dd66-7f8a-e788-f711-ae34b97806fc@linux.intel.com> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org On 1/10/2018 4:20 AM, Arnd Bergmann wrote: > On Tue, Jan 9, 2018 at 11:31 PM, Jae Hyun Yoo > wrote: >> This commit add a dt-bindings document for a generic PECI hwmon >> driver. >> >> Signed-off-by: Jae Hyun Yoo >> --- >> .../devicetree/bindings/hwmon/peci-hwmon.txt | 33 ++++++++++++++++++++++ >> 1 file changed, 33 insertions(+) >> create mode 100644 Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> >> diff --git a/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt b/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> new file mode 100644 >> index 0000000..20b86f5 >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/hwmon/peci-hwmon.txt >> @@ -0,0 +1,33 @@ >> +* Generic PECI (Platform Environment Control Interface) hwmon driver. >> + >> +Dependency: >> +- This driver uses a PECI misc driver as a controller interface so one of PECI >> + misc drivers which provides compatible ioctls has to be enabled. > > The binding should only explain how we describe the hardware in an > operating-system > independent way, but not talk about how an OS is supposed to implement those > drivers. > > Having multiple drivers each provide an exported function is not possible > in Linux: it immediately breaks building an 'allyesconfig' kernel, and prevents > you from running the same kernel across multiple implementations, so that > has to be redesigned anyway. > Agreed, I'll consider redesigning of it. >> +Required properties: >> +- compatible: "peci-hwmon" >> +- cpu-id: Should contain CPU socket ID >> + - 0 ~ 7 >> + >> +Optional properties: >> +- show-core: If this protperty is defined, core tmeperature attrubites will be > > s/protperty/property/ > s/tmeperature/temperature/ > s/attrubites/attributes/ > Oops! I made this many typos in this single line. Thanks for your pointing it out. Will fix these. >> + enumerated. >> +- dimm-nums: Should contain the number of DIMM slots that attached to each CPU >> + which is indicated by cpu-id. >> + 0 ~ 16 (default: 16) >> + In case of 0, DIMM temperature attrubites will not be enumerated. > > Is this only an initial list that you expect to be extended in the > future, or is this > a complete list of sensors that can ever be connected to PECI? > > Should this be PECI version specific? > > Arnd > The maximum supportable number of dimm slots is not PECI version specific but depends on CPU architecture. Currently IA supports up to 16 slot as the maximum but it could vary in the future architecture. Thanks, Jae