From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757235AbaCFBbd (ORCPT ); Wed, 5 Mar 2014 20:31:33 -0500 Received: from smtp.codeaurora.org ([198.145.11.231]:58765 "EHLO smtp.codeaurora.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755378AbaCFBba (ORCPT ); Wed, 5 Mar 2014 20:31:30 -0500 Message-ID: <5317CFEF.1060003@codeaurora.org> Date: Wed, 05 Mar 2014 17:31:27 -0800 From: Stephen Boyd User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130329 Thunderbird/17.0.5 MIME-Version: 1.0 To: Josh Cartwright CC: Alessandro Zummo , linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , Rob Landley , devicetree@vger.kernel.org, linux-doc@vger.kernel.org Subject: Re: [PATCH 6/6] documentation: bindings: document PMIC8921/8058 RTC References: <1394047776-13827-1-git-send-email-joshc@codeaurora.org> <1394047776-13827-7-git-send-email-joshc@codeaurora.org> <5317900F.5030803@codeaurora.org> <20140306000058.GE18529@joshc.qualcomm.com> In-Reply-To: <20140306000058.GE18529@joshc.qualcomm.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 03/05/14 16:00, Josh Cartwright wrote: > On Wed, Mar 05, 2014 at 12:58:55PM -0800, Stephen Boyd wrote: >> On 03/05/14 11:29, Josh Cartwright wrote: >>> diff --git a/Documentation/devicetree/bindings/rtc/qcom,pm8xxx-rtc.txt b/Documentation/devicetree/bindings/rtc/qcom,pm8xxx-rtc.txt >>> new file mode 100644 >>> index 0000000..699bd30 >>> --- /dev/null >>> +++ b/Documentation/devicetree/bindings/rtc/qcom,pm8xxx-rtc.txt >>> @@ -0,0 +1,29 @@ >>> +* Real-Time Clock for Qualcomm 8058/8921 PMICs >>> + >>> +Required properties: >>> +- compatible: should be one of the following. >>> + * "qcom,pm8058-rtc" >>> + * "qcom,pm8921-rtc" >>> +- reg: base address of the register region >>> +- reg-names: corresponding reg names for the regions listed in the 'reg' >>> + property, must contain: >>> + "rtc_base" - base of the RTC register region >> optional reg-names? >> >>> +- interrupts: interrupt list for the RTC, must contain a single interrupt >>> + specifier for the alarm interrupt >>> +- interrupt-names: corresponding interrupt names for the interrupts listed in >>> + the 'interrupts' property, must contain: >>> + "alarm" - summary interrupt for PMIC peripherals >> optional interrupt-names? > It isn't clear to me why these should be made optional, I hope Rob > provides some clarification in the sdhci-msm thread. Looks like the driver isn't using either of these properties, so I'm not sure why they're needed. Maybe they should just be removed. > > >>> +- linux,allow-set-time: indicates that the setting of RTC time is allowed by >>> + the host CPU >> Is this a "linux" property? It seems like something that other OSes >> would want to know about and doesn't require any explicit knowledge >> about operating system things (like keymaps for example). > Yeah, I wasn't quite sure how to name this property. It's > Linux-specific in the sense that the underlying operation method is > "set_time", but I agree this should be named something else... > > How do you feel about simply "allow-set-time"? Sounds ok to me. -- Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum, hosted by The Linux Foundation