From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bjorn Andersson Subject: [PATCH v6 1/2] DT: hwspinlock: Add binding documentation for Qualcomm hwmutex Date: Fri, 27 Feb 2015 14:30:16 -0800 Message-ID: <1425076217-10415-1-git-send-email-bjorn.andersson@sonymobile.com> Mime-Version: 1.0 Content-Type: text/plain Return-path: Sender: linux-kernel-owner@vger.kernel.org To: Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Ohad Ben-Cohen , Kumar Gala Cc: Suman Anna , linux-arm-msm@vger.kernel.org, Jeffrey Hugo , Andy Gross , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org List-Id: devicetree@vger.kernel.org Add binding documentation for the Qualcomm Hardware Mutex. Signed-off-by: Bjorn Andersson --- I think the conclusion on the dt binding discussion for hwspinlocks was that we're down to having the #hwlock-cells intact. So this version includes that, but non of the other previously discussed properties. Changes since v5: - Extracted the dt binding documentation into a separate patch - Moved the driver to consume a syscon - Dropped previously suggested generic hwlock dt bindings .../devicetree/bindings/hwlock/qcom-hwspinlock.txt | 39 ++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 Documentation/devicetree/bindings/hwlock/qcom-hwspinlock.txt diff --git a/Documentation/devicetree/bindings/hwlock/qcom-hwspinlock.txt b/Documentation/devicetree/bindings/hwlock/qcom-hwspinlock.txt new file mode 100644 index 0000000..28ade7d --- /dev/null +++ b/Documentation/devicetree/bindings/hwlock/qcom-hwspinlock.txt @@ -0,0 +1,39 @@ +Qualcomm Hardware Mutex Block: + +The hardware block provides mutexes utilized between different processors on +the SoC as part of the communication protocol used by these processors. + +- compatible: + Usage: required + Value type: + Definition: must be one of: + "qcom,sfpb-mutex", + "qcom,tcsr-mutex" + +- syscon: + Usage: required + Value type: + Definition: one cell containing: + syscon phandle + offset of the hwmutex block within the syscon + stride of the hwmutex registers + +- #hwlock-cells: + Usage: required + Value type: + Definition: must be 1, the specified cell represent the lock id + (hwlock standard property, see hwlock.txt) + +Example: + + tcsr: syscon@1a400000 { + compatible = "qcom,tcsr-msm8974", "syscon"; + reg = <0xfd484000 0x2000>; + }; + + hwlock@fd484000 { + compatible = "qcom,tcsr-mutex"; + syscon = <&tcsr 0 0x80>; + + #hwlock-cells = <1>; + }; -- 1.8.2.2