From nobody Sat Sep 26 23:52:23 2026 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9C77D3F8246 for ; Fri, 28 Aug 2026 09:49:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787910599; cv=none; b=I8gp2WbuLi7O21XD8GJNpzKYBvu/r2ac9YJ1/7N6SYE7lHsTyoCfJUrk5DBCj/JdhaKEtXX5pS17grkwjZhFGqX6jafmlUOwmG6F/40mjIMzuBewrV1H5CH8DcRTypWpWwpqJe/uBUKCBKOKUsYFAAYgP8h3F3Bdyw+nLJkg5D0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787910599; c=relaxed/simple; bh=YcJzWuwZ1RPM60Xmk1Fr6v59EnVXQyCH0dMpsNpXZwI=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=ll+Jni/Va0xAZ2fnifA0Z85QykvPghpcYe1YmZIRNuRBzN5s8E2sHWw7jrqPjEz5imMcWpUhbOSahDm/MlFT9Xt/Sx2OiB82K3R0H0xYUEOKs57FnHQLPNyiVAUzRbTT5hPCF5iTPEAZtlKzlUnaZmDAu0AahoapliPkLynJdNY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=AtIQ/bsW; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=Ecc9mkSm; arc=none smtp.client-ip=205.220.180.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="AtIQ/bsW"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="Ecc9mkSm" Received: from pps.filterd (m0279873.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 67S66pur2046035 for ; Fri, 28 Aug 2026 09:49:38 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= hYYmAr/X6jkEKVI/rUiLckvRRdWrzEQRkaCP6T8C01U=; b=AtIQ/bsWp4n3wEmX 1y+L3yXaOGP/lQ+xPwRu/e1Zed2KvnRK249wWj0M1s9GmVJ5HeJcSCkkhMpB4/79 owJVeRS9vwkWbKuCRtyG4VAmuGhodlL5A0iJ039bXbwutvb6K/bOgqPmBMPzj3gf dYAoK6C5I/agpX74vm/OQKdgip4lKVxrpMDXroQOB8HXL51h0P7oasl+yV7I8goY x2+q2u38jXdNr/iqAmTSgyMJ2cKXparjO6LeS0mObNeFkwnLKb1I+Gfu0ZfwTxRA aDbsmV/J22Lm+6C6zGITlhLcrF0meh4+R7l1S0coOrrd7/icBTyyhzTBF9PZZVFC UJfJ3Q== Received: from mail-pg1-f198.google.com (mail-pg1-f198.google.com [209.85.215.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4gb1v39jxy-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Fri, 28 Aug 2026 09:49:37 +0000 (GMT) Received: by mail-pg1-f198.google.com with SMTP id 41be03b00d2f7-cc1b8088203so1079541a12.3 for ; Fri, 28 Aug 2026 02:49:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1787910577; x=1788515377; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=hYYmAr/X6jkEKVI/rUiLckvRRdWrzEQRkaCP6T8C01U=; b=Ecc9mkSm5+pr0UC/mYybbmN5qm2sDKLivLbOQqktkAOeZTqe/F0y1acQrI/LjlOFCJ wEpMbxc7h2kl6lDQFzF26E7OklY3OAPGzwR1X3wrd//c7d8tPLiTdsP2uiMn2TsYt+ma F5BSC14SxFvPY9xQcknsgyHO5Dnd5jyQ7QkexliO+OJh6gFzgeCXrE8lLEkMo31mcLAv 9oXzURH40LIltjcB2xLUQZQSzXyFrq6AGKwjjWwenWTIKy8MS9n42ftS/aFM6UVSFVEF Defzy1N3D5lNk51/YlCRe4yiRGksqESxe062e16kB9+djXg8n+Ca4r+cp9B7tn4Lp3NU FzKg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787910577; x=1788515377; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=hYYmAr/X6jkEKVI/rUiLckvRRdWrzEQRkaCP6T8C01U=; b=k2lXHDcf1W0oKsLO6y0/BpCCXIyQFW/B80uaQbO2rJqU32XnYzxvlKur5Ue0aTCuC4 2Ed7dA1Q6/hRs2jIdcYMuN/dwZ4gNu+NrEravx+hkq6UfBgL5hjwDsepZRQdBIxN8+ba GTc7qNY9J+ou84/65no3YKvSxlfUPbZWIqOpJ5zEy1U+peN+I/z9G/rrcawvD1R7yD42 o6fICZC1dSmt/GRGtkWHGpnazMV0aTTNPurydU0SUWu2T0lr++dVs+6BCrS14/srW0NW 3nuH5DiZZZsEndW8YSibYoFvxFRaNInPlQeIbrSo8gXIvRciFxYmys7BCkr9KVKJlEnw FyPA== X-Forwarded-Encrypted: i=1; AHgh+RrGdqCxvamO5B3VFX8stcABkTZyGZdc/N66Zq39+uWBt2yTd1XelwjfblySinVhT4HzDV34jPBHEjP3tLk=@vger.kernel.org X-Gm-Message-State: AFuF++lvhveniG68dhAM9NPPFO3hZstAL8VMbTOXbi2SSSZfPboO7fhv JZw6EF0a+x9oyEb9EMuMZ1HMJ9VVoUtUlLTHtNcE6qidlLJblsb5m1uunnpitM6GYTOQPmiOT52 U0E6Vr4FukJgVh2uTiYr22rSxN29b0A3UlzlUIQ6AOHpdkV/l9KkTO29DCBWLdGf0nqE= X-Gm-Gg: AR+sD12VUqmaBCiKGMSMQn6CrKjrQAlWVFMHY/FTromMLpnUfT3L9BjCKtMV1Y3YqcR FJ0HvWMSMOgs+xv04DM2mmWkKtfjtGAx/JItOK+EH606fDKAOnehjWE13bK20XBZX2Pe0j9Ac3L W+TeNkaY6cPWSsX6PeyLgBJcqv+lGahsf/bgP0APGbyS1ub+xxWG4yJT+sUYVw34V+bd/bDqYMj 1Od5SU/r5U8rdAYFl4hwb6Zl2h8I4P7aulkASNA0BdEjyuWAl+5KHfSMbgh++EquZesE4g0Sxik ZIdsVfrmCtTjWUDflMs5S+Y7fuK1Zx97eARF53R9vz5qEWExoM9kUR94ZGZDK8udBBSGl6kj6Zw uFpoGEheb4vknstcXlkDY15rUOoEh6dNNllqOkCYF5D+YIiK6vLHH X-Received: by 2002:a05:6a20:db0a:b0:3d0:ba81:79b7 with SMTP id adf61e73a8af0-3d26784f3a8mr12211050637.12.1787910576798; Fri, 28 Aug 2026 02:49:36 -0700 (PDT) X-Received: by 2002:a05:6a20:db0a:b0:3d0:ba81:79b7 with SMTP id adf61e73a8af0-3d26784f3a8mr12210707637.12.1787910574941; Fri, 28 Aug 2026 02:49:34 -0700 (PDT) Received: from hu-fenglinw-lv.qualcomm.com (Global_NAT1.qualcomm.com. [129.46.96.20]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-3286f783c57sm4851549eec.4.2026.08.28.02.49.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 28 Aug 2026 02:49:34 -0700 (PDT) From: Fenglin Wu Date: Fri, 28 Aug 2026 02:49:19 -0700 Subject: [PATCH v7 1/2] dt-bindings: input: Add Qualcomm SPMI PMIC haptics Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260828-qcom-spmi-haptics-v7-1-0367b3ac2e1e@oss.qualcomm.com> References: <20260828-qcom-spmi-haptics-v7-0-0367b3ac2e1e@oss.qualcomm.com> In-Reply-To: <20260828-qcom-spmi-haptics-v7-0-0367b3ac2e1e@oss.qualcomm.com> To: linux-arm-msm@vger.kernel.org, Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Lee Jones , Stephen Boyd , Bjorn Andersson , Konrad Dybcio Cc: David Collins , Subbaraman Narayanamurthy , Kamal Wadhwa , linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, David Heidelberg , Fenglin Wu , Krzysztof Kozlowski X-Mailer: b4 0.16-dev-17187 X-Developer-Signature: v=1; a=ed25519-sha256; t=1787910573; l=6461; i=fenglin.wu@oss.qualcomm.com; s=20260324; h=from:subject:message-id; bh=YcJzWuwZ1RPM60Xmk1Fr6v59EnVXQyCH0dMpsNpXZwI=; b=K90zooDTYZ589cAtVeKL9aS4swwJGlljOoatZpGEue6YcxFrgVCTUelwbtQ/p7C9g7QCr1hmw dOwWvkfzbXpC/vmYQrnY5kv6zRrbZN6IzuY+Rxq0Pz4wprBWHueR4FS X-Developer-Key: i=fenglin.wu@oss.qualcomm.com; a=ed25519; pk=hJdt3E7o54lql+miD2GaxwF74cDyhgNwMbmFOZ46bRU= X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwODI4MDA4MyBTYWx0ZWRfX7W8Ef8TLIbz7 JAMAsdEheQVuZBm4l3Cf/pKhyymJQ0yw37HFuGnT3wUOr0PiYwX7FVVgVrtB1cq5r8zc11CMBSu NEEG8e2QeLtn6+aUvLWoP95fXdKTOZmwIzvfNDNyiwB+QZX8aLvxyp7RjCaaaxbr6ohKdkB8Sp+ l/77jDyRUEZIADhCoR7HDxWr12gZ4tvgEwer+V1O8ouYjGzTb0mSjPWWQxdoBQMkTDGslK3hFw8 +SEo3oopQtTGpnr9Y3k+HfqkfDd8XsFUOadqeGwy6xe1NVvZlxLSEo+yY8Voh+qcDhDDdbqIj5Z U9m9BGxj2U71SMaaqUiO0RrO/AR8N3aX8kv2oR1N5m3pyZaFdT9pO4BwnMYgy+Cn6UxkEfdDiiP qwjse0fPXaR5I7Nu6barkAnYVmhc/+31q6CFdcDUDjvdq57IA8zqK/JpEv5VLbO99idejPh6Qse g45UzD74x8JPiIHQw1A== X-Proofpoint-ORIG-GUID: hRs1n8-mSC5NHRBeEqvJ8qsw3fCjbe2d X-Proofpoint-Spam-Info: AW1haW4tMjYwODI4MDA4MyBTYWx0ZWRfX5SvROa94p8Hk SFBBPG/+Va0LQ8Qwo+Jag6TOICUBOIAbcSuycv4a8z30IZoonH69Utp4OO6EZAEyqut9viFRu0e xxGJHGbc9e3A8IzBoCQ6sDylj9E7V4A= X-Authority-Analysis: v=2.4 cv=faedDUQF c=1 sm=1 tr=0 ts=6a9159b1 cx=c_pps a=Qgeoaf8Lrialg5Z894R3/Q==:117 a=ouPCqIW2jiPt+lZRy3xVPw==:17 a=IkcTkHD0fZMA:10 a=Sv0fKeRqtYgA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=rJkE3RaqiGZ5pbrm-msn:22 a=gEfo2CItAAAA:8 a=EUspDBNiAAAA:8 a=bI6yuv9Qsz7HNVLwNVgA:9 a=QEXdDO2ut3YA:10 a=x9snwWr2DeNwDh03kgHS:22 a=sptkURWiP4Gy88Gu7hUp:22 X-Proofpoint-GUID: hRs1n8-mSC5NHRBeEqvJ8qsw3fCjbe2d X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1176,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-08-28_02,2026-08-27_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 priorityscore=1501 phishscore=0 spamscore=0 impostorscore=0 lowpriorityscore=0 suspectscore=0 adultscore=0 malwarescore=0 clxscore=1015 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2608280083 Add binding document for the haptics module inside Qualcomm PMIC PMIH0108. Assisted-by: Claude:claude-4-8-opus Reviewed-by: Krzysztof Kozlowski Signed-off-by: Fenglin Wu --- .../bindings/input/qcom,spmi-haptics.yaml | 139 +++++++++++++++++= ++++ 1 file changed, 139 insertions(+) diff --git a/Documentation/devicetree/bindings/input/qcom,spmi-haptics.yaml= b/Documentation/devicetree/bindings/input/qcom,spmi-haptics.yaml new file mode 100644 index 000000000000..ce2c9e893a0d --- /dev/null +++ b/Documentation/devicetree/bindings/input/qcom,spmi-haptics.yaml @@ -0,0 +1,139 @@ +# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/qcom,spmi-haptics.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Haptics device inside Qualcomm Technologies, Inc. PMIC + +maintainers: + - Fenglin Wu + +description: | + Certain Qualcomm PMICs integrate a haptics module, such as the HAP530_HV= haptics + module in the PMIH0108 PMIC, which drives an LRA (Linear Resonant Actuat= or) with + an output voltage up to 10 V. Several play modes are supported in HAP530= _HV: + + DIRECT_PLAY: The hardware outputs sinusoidal waveforms whose period is + defined by qcom,lra-period-us and whose peak voltage is defined by + qcom,vmax-microvolt. The driving amplitude can be scaled in the range + [0, 255] via a single register byte. Hardware-based LRA auto-resona= nce + tracking is enabled by default in this mode, allowing the haptics en= gine + to follow the actual resonant frequency of the LRA and update the dr= iving + period accordingly to achieve stronger vibration magnitude. + + FIFO: The hardware can play an arbitrary waveform composed of a sequen= ce + of 8-bit samples at a configurable play rate. Samples are pre-filled + into the internal FIFO memory of the haptics module and continuously + replenished via the FIFO-empty IRQ until all samples have been playe= d. + An 8K-byte FIFO memory bank is available in the HAP530_HV haptics mo= dule, + shared between the FIFO and PAT_MEM play modes. The memory partition + between the two modes is configurable via registers, and FIFO mode a= lways + uses the 1st partition starting from offset 0. + + PAT_MEM: This mode is very similar to FIFO streaming mode but without = the + data refilling capability. It is designed mainly for short, latency-= critical + vibrations. The memory space for PAT_MEM mode must be reserved for d= edicated + usage, and the waveform data should be preloaded and remain unchanged + thereafter. The haptics module can play the waveform data from the m= emory + region specified by the PAT_MEM play start address and length regist= ers. + + In either FIFO mode or PAT_MEM mode, the following play rates are supp= orted: + -- 0(T_LRA): each FIFO byte drives one full sinusoidal cycle with the + period defined in qcom,lra-period-us. + -- 1/2/3(T_LRA_DIV_2/4/8): each FIFO byte drives a half/quarter/eigh= th + sinusoidal cycle with the period defined in qcom,lra-period-us. + -- 4/5/6(T_LRA_X_2/4/8): each FIFO byte drives 2/4/8 sinusoidal cycl= es + with the period defined in qcom,lra-period-us. + -- 8/9/10/11/12/13(8KHz/16KHz/24KHz/32KHz/44.1KHz/48KHz): the FIFO + data is treated as PCM samples and drives the output with an + arbitrarily shaped waveform. This mode is typically used to define + custom driving waveforms for specific vibration effects such as fa= st + attack, crisp brake, etc. + + The drive voltage in FIFO or PAT_MEM mode can exceed the value defined= in + qcom,vmax-microvolt to achieve a special vibration effect, but the wav= eform + must be short enough to prevent the LRA from being damaged by operatin= g at + an overvoltage. + + Also, hardware-based LRA auto-resonance tracking is normally disabled = in + FIFO or PAT_MEM mode, as these modes are intended to drive arbitrary + waveforms that may not follow the resonant frequency; autonomous hardw= are + resonance correction would interfere with the intended output. + +properties: + compatible: + items: + - const: qcom,pmih0108-haptics + - const: qcom,spmi-haptics + + reg: + items: + - description: HAP_CFG module base address + - description: HAP_PTN module base address + + reg-names: + items: + - const: cfg + - const: ptn + + interrupts: + maxItems: 1 + + interrupt-names: + items: + - const: fifo-empty + + qcom,vmax-microvolt: + description: + Maximum allowed output driving voltage in microvolts, must be a mult= iple + of 50,000 uV. This is the peak driving voltage in DIRECT_PLAY mode, + which outputs sinusoidal waveforms. The value should be equal to the + square root of 2 times the Vrms voltage of the LRA. + minimum: 50000 + maximum: 10000000 + multipleOf: 50000 + + qcom,lra-period-us: + description: + LRA actuator initial resonance period in microseconds + (1,000,000 / resonant_freq_hz). Used to configure T_LRA-based play + rates and the auto-resonance zero-crossing window. It could be also = used + as the initial period if the LRA wants to be driven off resonance. + minimum: 5 + maximum: 20475 + multipleOf: 5 + +required: + - compatible + - reg + - reg-names + - interrupts + - interrupt-names + - qcom,vmax-microvolt + - qcom,lra-period-us + +additionalProperties: false + +examples: + - | + #include + #include + + pmic@7 { + compatible =3D "qcom,pmih0108", "qcom,spmi-pmic"; + reg =3D <0x7 SPMI_USID>; + #address-cells =3D <1>; + #size-cells =3D <0>; + + haptics@f000 { + compatible =3D "qcom,pmih0108-haptics", "qcom,spmi-haptics"; + reg =3D <0xf000>, <0xf100>; + reg-names =3D "cfg", "ptn"; + interrupts =3D <0x7 0xf0 0x1 IRQ_TYPE_EDGE_RISING>; + interrupt-names =3D "fifo-empty"; + + qcom,vmax-microvolt =3D <1300000>; + qcom,lra-period-us =3D <5880>; + }; + }; --=20 2.43.0 From nobody Sat Sep 26 23:52:23 2026 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F1EF1367B96 for ; Fri, 28 Aug 2026 09:49:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.168.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787910599; cv=none; b=TIW5X7UhnR91H+OdlxHKC+Bu0VsmuED1fs34RCdVPu6aKvSkEWrTKE/VrUSpyzWTGF45rK7+HDf/bKv78krLQYlDf0wkWYGd9y06OBPV6k/CZWyY5jlGNhSYw6JHxkF4vJBjbkHvgIeokSYLkVqDvxD53w+aWhtRSMNCh18TEJA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787910599; c=relaxed/simple; bh=RqxPk4EvDczrBg/rkp0aJsw1yFLEmBzZ7FI0RQ6jHFM=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=EyPibpNiEO03qrerjMAu5yVbiJc064xuKt9Hwl+Boe6CcQyAeU5D6dHjpWVqzqE/HeGH9Cf7q/oRYi6l5h6tilTmZXNu14/o1oaSl0HAGp7w5//mu6KvpAVobbGBjygfAzdZjKtFuCfYsImyphaKGhrAb+Z8lxOY/6vF+FzXrZE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=pAKAeaRs; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=V9+CGhq6; arc=none smtp.client-ip=205.220.168.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="pAKAeaRs"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="V9+CGhq6" Received: from pps.filterd (m0279867.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 67S66iUF3205990 for ; Fri, 28 Aug 2026 09:49:39 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= UYCUu+y2C3iVjUKmaZoGGPYOtJZWTGcMetZhuboMgcs=; b=pAKAeaRs8TcWchz4 m/NyoyDqXqUaXpJJSNIYsTiCaWMoZtY55EkJX1o8/626RN7IoIq6wL7K6gi7jsB1 3LINwGxjW2OrULSRBDFfmTovfdAWM9bQvX8jmNzGjoFY3xSd1Il0FRUx0hhPckvH qvEBYh0qlb4lnu/ie8TjJP0Z9TICIJ0n+eAkjL6oxLHxRLmQhEuPKxyvLDIK2PYS DDkdaojZ0QISJzlgEhEIXSZH5+RaAJ2hhL1Q1pXM4ME5GhXXPYKm0vEz/vxBoe4b N4fvkmHR8XhDMncEbpASWlBPG3CvEJtuamLvG0c+cpBgzq/D/tpt/6wK18be39EE 4tB50g== Received: from mail-pg1-f197.google.com (mail-pg1-f197.google.com [209.85.215.197]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4gatfxke3u-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Fri, 28 Aug 2026 09:49:39 +0000 (GMT) Received: by mail-pg1-f197.google.com with SMTP id 41be03b00d2f7-cc1cb806660so1180835a12.3 for ; Fri, 28 Aug 2026 02:49:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1787910578; x=1788515378; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=UYCUu+y2C3iVjUKmaZoGGPYOtJZWTGcMetZhuboMgcs=; b=V9+CGhq6M7FKJwaNwmucZDgdUtQPoDmyZ/Oh19DsUkzgBmsaQsk2USYS2gV215nI5P wwb9q8Xg3YYsCRqPbGXb3M7aV2qwamx9mkhd2mOMAhmah2AWMTNFyYJB3eD6igZOgKSK jYmRAqXrxiZect5Tfe37soJ+EKI4GAQhlRzGPyBu6HVPPTGnsa8vldrvoXXJ/aqPdj8r w4FWnqNa9Y6cEkTw1JB31fVrS3k6iUk93SB+2TNFRCyDFMfMjbqqsMUlCgJhArox17lh 1WbHNAuenmw62kCdOJNWIHkzuVjY7dUdOVoEwJ3qziGHXS3oWLO+3vX9dNEMMcyK7/Ir fxSA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787910578; x=1788515378; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=UYCUu+y2C3iVjUKmaZoGGPYOtJZWTGcMetZhuboMgcs=; b=CM2u/clkTBwSMguKp/yWpsIYd7oGM9qNYvKVlHURLB2PJKSEY61qmuIkA56CrWvQ7/ 3aPw24GncijEN5mFxVSpPaXfjFd7unhbalqATERoYEeLYB4H9DVei3LV18phYLvnydvI WDNW4c0D/uHVRiJimIp84wq8Uxh3g6z7DUf3bOMn6+OgC/EJA4ff2hpROwyCfKNKaO1g XDlFOQ92vtDS/yfZWA9i5Mwp/3Qkntf9i9kPXe1vw1mRfkOzFQQ/f/05MrqB78QcGaLK kBCxYkM1fpfKzqjFDn0cyAEdaiAjJWpP+usV+bTCsIjdp9scXvd6LKwlBBhSeNxnjhzv 9aSg== X-Forwarded-Encrypted: i=1; AHgh+RrEoHw7GWVu/nAx/D2SINVtyUKqjANfalGtKjXAcBJTDkXZfvJdz5CDElw+NWS9XDqBA8FgTqcVvL9tWFA=@vger.kernel.org X-Gm-Message-State: AFuF++mcN1rEOn6hdtRYjs10Rv0ITCtzo1u1pk5xan+6Tg3Zr32Xiynz s5OgW5p1NS1/VT67hEPSYCnEbRL1rLiEeK/GLYn/xiCagg5LFKL3iO8jvSk9KiIsdZkD6W/NvUw 1FswAi1hlNgLXsO6IAJkHcqfyhn1NKrGr+9T68/PaszuPOOxegs0dSedTPztS+dDIGLI= X-Gm-Gg: AR+sD1339qPJR+k4L36pYzXdJEr2x83nQ6lZkgbc5a9g+cXl30wFfwlTpg/jpydoM5A f3R5vIxismYPNC9lKDf+w9OwsMBvNkD+hV0vZtIxphLQcUxoXpW/hImU7AVikES7Jpt8bhhxIGg 8pkIqUrYDSW+8mPUuD75+dgVon/OoOlMAr0dhxIO2se7GPGwHhyTTvGUHj1G0umw2SwZjaEWe90 52ejQZVjT8iiTxMDlqrQmN/V9s1zinJ1o90r2SUB/wK52erUlEfrIhFfGDnrO43BYMsDC2B2KPW mhTUH5z5UTWyqMyLqPgMWS6HJm16e7TtGszzfsSZidBGjuOlDptQ9NQo0Gjo4gVu5wcz/nIWsXL rLImlX3HveqBcKflQZYei6oOqLkgt7nq+/wk/LbtD6ibu4f2pyevc X-Received: by 2002:a05:6a21:99a3:b0:3cc:927e:354c with SMTP id adf61e73a8af0-3d267b64ecbmr11068281637.9.1787910578051; Fri, 28 Aug 2026 02:49:38 -0700 (PDT) X-Received: by 2002:a05:6a21:99a3:b0:3cc:927e:354c with SMTP id adf61e73a8af0-3d267b64ecbmr11068158637.9.1787910577385; Fri, 28 Aug 2026 02:49:37 -0700 (PDT) Received: from hu-fenglinw-lv.qualcomm.com (Global_NAT1.qualcomm.com. [129.46.96.20]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-3286f783c57sm4851549eec.4.2026.08.28.02.49.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 28 Aug 2026 02:49:36 -0700 (PDT) From: Fenglin Wu Date: Fri, 28 Aug 2026 02:49:20 -0700 Subject: [PATCH v7 2/2] input: misc: Add Qualcomm SPMI PMIC haptics driver Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260828-qcom-spmi-haptics-v7-2-0367b3ac2e1e@oss.qualcomm.com> References: <20260828-qcom-spmi-haptics-v7-0-0367b3ac2e1e@oss.qualcomm.com> In-Reply-To: <20260828-qcom-spmi-haptics-v7-0-0367b3ac2e1e@oss.qualcomm.com> To: linux-arm-msm@vger.kernel.org, Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Lee Jones , Stephen Boyd , Bjorn Andersson , Konrad Dybcio Cc: David Collins , Subbaraman Narayanamurthy , Kamal Wadhwa , linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, David Heidelberg , Fenglin Wu X-Mailer: b4 0.16-dev-17187 X-Developer-Signature: v=1; a=ed25519-sha256; t=1787910573; l=37997; i=fenglin.wu@oss.qualcomm.com; s=20260324; h=from:subject:message-id; bh=RqxPk4EvDczrBg/rkp0aJsw1yFLEmBzZ7FI0RQ6jHFM=; b=ZjWPT+gl69Zw/ZJ3dBpc/tsa5KRtwdwHcOYUXlnfCoYHB0QyVcbp+j0wyFqPq4Kgx2/Hk6FY9 sCHYMjBCcTLDDuHr/1nlvLVgJRA5wYWafzLpzZEJ8upFw9X3pdV06aL X-Developer-Key: i=fenglin.wu@oss.qualcomm.com; a=ed25519; pk=hJdt3E7o54lql+miD2GaxwF74cDyhgNwMbmFOZ46bRU= X-Authority-Analysis: v=2.4 cv=UKLt2ify c=1 sm=1 tr=0 ts=6a9159b3 cx=c_pps a=rz3CxIlbcmazkYymdCej/Q==:117 a=ouPCqIW2jiPt+lZRy3xVPw==:17 a=IkcTkHD0fZMA:10 a=Sv0fKeRqtYgA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=eoimf2acIAo5FJnRuUoq:22 a=EUspDBNiAAAA:8 a=3_Ji5GFWK-rhiyT1rKgA:9 a=Of39h0EOZMdwZqCN:21 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=bFCP_H2QrGi7Okbo017w:22 X-Proofpoint-GUID: AvyNKUH8B2vBWkFTlnBfBTdT0yesuPDJ X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwODI4MDA4MyBTYWx0ZWRfX1oxwysuqorJf nkggcib8om/HodNaHtn0cuJu1pcHs/4frF/NCHAQ9Tf5r70o75R/Gm7gbyPZjfOT4EbA14fzpRf BjR5sY9d1POBlJ6mHihz7+45zMjDjHaBtCyQ4mOqkROuEXOuHdYEu3NA+qlBzM+jYP2I7taOyV3 fhC2GLtlhSWQu3tfJ/upbeqck/mB8K6U3aLfvv0L1V18pSGbPjR3FSD5bqfOY8jWFWCh83ZzWCV 5JsDC06od8QCqjyidDWGb2WIG8hQhOluCYVzL2fuJEt17KF5J+6z8yS+iU0244f5viXEavyA68J Xe0X0o7WQnpAO6wXql7zFcvVBH+SV97qHNiBgdPqCabwxmg7etHMqCe0YrMlRRTGro9RLWEmteN YLk/gZsIvEuUA7xE2bdcmsLCi5+nmP0pV1dAdTkn105F2oip1vLPEH7N/RDMi5+AzM/Jbm2tWRi H8L6LjgkhYyiLcNXf7w== X-Proofpoint-Spam-Info: AW1haW4tMjYwODI4MDA4MyBTYWx0ZWRfXw+c5dtC5avW6 wYXN7aVAmVPQ4uBsjVVHvQRUiw7yrlTpWFVP/7G9UotJzkBtwXFAsmT7Wj1DnaX6W4esQdhKhPG y7vuxcQe5OxJii4Yipf0wsM7hYaAcug= X-Proofpoint-ORIG-GUID: AvyNKUH8B2vBWkFTlnBfBTdT0yesuPDJ X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1176,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-08-28_02,2026-08-27_02,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 adultscore=0 bulkscore=0 suspectscore=0 lowpriorityscore=0 clxscore=1015 phishscore=0 malwarescore=0 priorityscore=1501 impostorscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2608280083 Add an initial driver for the Qualcomm PMIH0108 PMIC haptics module, named as HAP530_HV. This module supports several play modes, including DIRECT_PLAY, FIFO, PAT_MEM, and SWR, each with distinct data sourcing and hardware data handling logic. Currently, the driver provides support for two play modes using the input force-feedback framework: FF_CONSTANT effect for DIRECT_PLAY mode and FF_PERIODIC effect with FF_CUSTOM waveform for FIFO mode. Assisted-by: Claude:claude-4-8-opus Signed-off-by: Fenglin Wu --- drivers/input/misc/Kconfig | 11 + drivers/input/misc/Makefile | 1 + drivers/input/misc/qcom-spmi-haptics.c | 1251 ++++++++++++++++++++++++++++= ++++ 3 files changed, 1263 insertions(+) diff --git a/drivers/input/misc/Kconfig b/drivers/input/misc/Kconfig index 1f6c57dba030..4f40940973e4 100644 --- a/drivers/input/misc/Kconfig +++ b/drivers/input/misc/Kconfig @@ -236,6 +236,17 @@ config INPUT_PMIC8XXX_PWRKEY To compile this driver as a module, choose M here: the module will be called pmic8xxx-pwrkey. =20 +config INPUT_QCOM_SPMI_HAPTICS + tristate "Qualcomm SPMI PMIC haptics support" + depends on MFD_SPMI_PMIC + help + Say Y to enable support for the Qualcomm PMIH0108 SPMI PMIC haptics + module. Supports DIRECT_PLAY, FIFO streaming play modes via the + Linux input force-feedback framework. + + To compile this driver as a module, choose M here: the module will + be called qcom-spmi-haptics. + config INPUT_SPARCSPKR tristate "SPARC Speaker support" depends on PCI && SPARC64 diff --git a/drivers/input/misc/Makefile b/drivers/input/misc/Makefile index 2281d6803fce..c5c9aa139a11 100644 --- a/drivers/input/misc/Makefile +++ b/drivers/input/misc/Makefile @@ -69,6 +69,7 @@ obj-$(CONFIG_INPUT_PMIC8XXX_PWRKEY) +=3D pmic8xxx-pwrkey.o obj-$(CONFIG_INPUT_POWERMATE) +=3D powermate.o obj-$(CONFIG_INPUT_PWM_BEEPER) +=3D pwm-beeper.o obj-$(CONFIG_INPUT_PWM_VIBRA) +=3D pwm-vibra.o +obj-$(CONFIG_INPUT_QCOM_SPMI_HAPTICS) +=3D qcom-spmi-haptics.o obj-$(CONFIG_INPUT_QNAP_MCU) +=3D qnap-mcu-input.o obj-$(CONFIG_INPUT_RAVE_SP_PWRBUTTON) +=3D rave-sp-pwrbutton.o obj-$(CONFIG_INPUT_RB532_BUTTON) +=3D rb532_button.o diff --git a/drivers/input/misc/qcom-spmi-haptics.c b/drivers/input/misc/qc= om-spmi-haptics.c new file mode 100644 index 000000000000..f589ac137403 --- /dev/null +++ b/drivers/input/misc/qcom-spmi-haptics.c @@ -0,0 +1,1251 @@ +// SPDX-License-Identifier: GPL-2.0-only +/* + * Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +/* HAP_CFG register offsets, bit fields, value constants */ +#define HAP_CFG_INT_RT_STS_REG 0x10 +#define FIFO_EMPTY_BIT BIT(1) +#define HAP_CFG_EN_CTL_REG 0x46 +#define HAPTICS_EN_BIT BIT(7) +#define HAP_CFG_VMAX_REG 0x48 +#define VMAX_STEP_MV 50 +#define VMAX_MV_MAX 10000 +#define HAP_CFG_SPMI_PLAY_REG 0x4C +#define PLAY_EN_BIT BIT(7) +#define PAT_SRC_MASK GENMASK(2, 0) +#define PAT_SRC_FIFO 0 +#define PAT_SRC_DIRECT_PLAY 1 +#define HAP_CFG_TLRA_OL_HIGH_REG 0x5C +#define TLRA_OL_MSB_MASK GENMASK(3, 0) +#define TLRA_STEP_US 5 +#define TLRA_US_MAX 20475 +#define HAP_CFG_TLRA_OL_LOW_REG 0x5D +#define HAP_CFG_DRV_DUTY_CFG_REG 0x60 +#define ADT_DRV_DUTY_EN_BIT BIT(7) +#define ADT_BRK_DUTY_EN_BIT BIT(6) +#define DRV_DUTY_MASK GENMASK(5, 3) +#define AUTORES_DRV_DUTY_62P5 2 +#define BRK_DUTY_MASK GENMASK(2, 0) +#define AUTORES_BRK_DUTY_62P5 5 +#define HAP_CFG_ZX_WIND_CFG_REG 0x62 +#define ZX_DEBOUNCE_MASK GENMASK(6, 4) +#define AUTORES_ZX_DEBOUNCE 3 +#define ZX_WIN_HEIGHT_MASK GENMASK(2, 0) +#define AUTORES_ZX_WIN_HEIGHT 2 +#define HAP_CFG_AUTORES_CFG_REG 0x63 +#define AUTORES_EN_BIT BIT(7) +#define AUTORES_EN_DLY_MASK GENMASK(6, 2) +#define AUTORES_EN_DLY_CYCLES 10 +#define AUTORES_ERR_WIN_MASK GENMASK(1, 0) +#define AUTORES_ERR_WIN_25PCT 1 +#define HAP_CFG_FAULT_CLR_REG 0x66 +#define ZX_TO_FAULT_CLR_BIT BIT(4) +#define SC_CLR_BIT BIT(2) +#define AUTO_RES_ERR_CLR_BIT BIT(1) +#define HPWR_RDY_FAULT_CLR_BIT BIT(0) +#define FAULT_CLR_ALL (ZX_TO_FAULT_CLR_BIT | SC_CLR_BIT | \ + AUTO_RES_ERR_CLR_BIT | HPWR_RDY_FAULT_CLR_BIT) +#define HAP_CFG_RAMP_DN_CFG2_REG 0x86 +#define AUTORES_PRE_HIZ_DLY_10US 1 + +/* HAP_PTN register offsets, bit fields, value constants */ +#define HAP_PTN_FIFO_DIN_0_REG 0x20 +#define HAP_PTN_FIFO_PLAY_RATE_REG 0x24 +#define FIFO_PLAY_RATE_MASK GENMASK(3, 0) +#define HAP_PTN_DIRECT_PLAY_REG 0x26 +#define HAP_PTN_FIFO_EMPTY_CFG_REG 0x2A +#define FIFO_THRESH_LSB 64 +#define HAP_PTN_FIFO_DIN_1B_REG 0x2C +#define HAP_PTN_MEM_OP_ACCESS_REG 0x2D +#define MEM_FLUSH_RELOAD_BIT BIT(0) +#define HAP_PTN_MMAP_FIFO_REG 0xA0 +#define MMAP_FIFO_EXIST_BIT BIT(7) +#define MMAP_FIFO_LEN_MASK GENMASK(6, 0) + +#define HAP530_MEM_TOTAL_BYTES 8192 +#define FIFO_EMPTY_THRESH 256 +#define FIFO_INIT_FILL 320 + +#define HAPTICS_AUTOSUSPEND_MS 1000 + +/* + * FF_CUSTOM data layout (custom_data[] of type s16): + * [0] =3D play rate (PLAY_RATE_*) + * [1] =3D vmax in mV (0 =3D use device default from qcom,vmax-microvolt) + * [2..N-1] =3D signed 8-bit PCM samples packed one per s16 (lower byte = used) + */ +#define CUSTOM_DATA_RATE_IDX 0 +#define CUSTOM_DATA_VMAX_IDX 1 +#define CUSTOM_DATA_SAMPLE_START 2 +#define CUSTOM_DATA_MAX_LEN (48 * 1024) + +#define HAPTICS_MAX_EFFECTS 8 + +enum qcom_haptics_mode { + HAPTICS_MODE_NONE, + HAPTICS_DIRECT_PLAY, + HAPTICS_FIFO, +}; + +enum qcom_haptics_play_rate { + PLAY_RATE_T_LRA =3D 0, + PLAY_RATE_T_LRA_DIV_2 =3D 1, + PLAY_RATE_T_LRA_DIV_4 =3D 2, + PLAY_RATE_T_LRA_DIV_8 =3D 3, + PLAY_RATE_T_LRA_X_2 =3D 4, + PLAY_RATE_T_LRA_X_4 =3D 5, + PLAY_RATE_T_LRA_X_8 =3D 6, + PLAY_RATE_RESERVED =3D 7, + PLAY_RATE_F_8KHZ =3D 8, + PLAY_RATE_F_16KHZ =3D 9, + PLAY_RATE_F_24KHZ =3D 10, + PLAY_RATE_F_32KHZ =3D 11, + PLAY_RATE_F_44P1KHZ =3D 12, + PLAY_RATE_F_48KHZ =3D 13, + PLAY_RATE_MAX =3D PLAY_RATE_F_48KHZ, +}; + +/** + * struct qcom_haptics_effect - A haptics effect + * @mode: haptics HW play mode + * @vmax_mv: peak voltage of the haptics output waveform + * @length_ms: vibration play duration + * @amplitude: DIRECT_PLAY mode output waveform amplitude + * @play_rate: FIFO mode play rate + * @fifo_data: 8-bit data samples consumed in FIFO mode + * @data_len: length of the FIFO data samples + */ +struct qcom_haptics_effect { + enum qcom_haptics_mode mode; + u32 vmax_mv; + u32 length_ms; + + u8 amplitude; + + enum qcom_haptics_play_rate play_rate; + s8 *fifo_data; + u32 data_len; +}; + +/** + * struct haptics_play_req - A haptics play request + * @node: list node of the request + * @effect_id: effect index of the request + * @play: flag of starting or stopping the play + */ +struct haptics_play_req { + struct list_head node; + int effect_id; + bool play; +}; + +/** + * struct qcom_haptics + * @dev: underlying SPMI device + * @regmap: regmap for SPMI register access + * @input: input device exposing the FF interface + * @cfg_base: base address of the CFG peripheral + * @ptn_base: base address of the PTN peripheral + * @t_lra_us: LRA resonance period in microseconds + * @vmax_mv: maximum actuator drive voltage in millivolts + * @fifo_len: programmed HW FIFO depth in bytes + * @gain: playback gain scaler + * @gain_work: work that changes gain setting for active play + * @play_work: delayed work that plays the queued requests + * @stop_work: delayed work that auto-stops the active effect on durati= on expiry + * @play_lock: mutex lock to serialize playbacks + * @play_queue_lock: spinlock protecting @play_queue + * @play_queue: The list of pending start/stop requests + * @active_effect_id: index into @effects[] currently under play + * @active_mode: mode of the effect currently armed in hardware + * @stop_timeline: the jiffies value at which @stop_work would execute + * @fifo_empty_irq: IRQ number for the FIFO-empty interrupt + * @pm_ref_held: true while a pm_runtime_get is held + * @irq_enabled: true if fifo_empty_irq is enabled + * @fifo_lock: mutex protecting the FIFO streaming data + * @fifo_data: pointer of the data buffer for FIFO streaming + * @data_len: length of the data buffer for current effect + * @data_written: number of samples written to the hardware FIFO + * @effects: table of the effects + */ +struct qcom_haptics { + struct device *dev; + struct regmap *regmap; + struct input_dev *input; + + u32 cfg_base; + u32 ptn_base; + u32 t_lra_us; + u32 vmax_mv; + u32 fifo_len; + atomic_t gain; + struct work_struct gain_work; + + struct delayed_work play_work; + struct delayed_work stop_work; + struct mutex play_lock; /* mutex used to serialize playbacks */ + + spinlock_t play_queue_lock; /* protects play_queue */ + struct list_head play_queue; + + int active_effect_id; + enum qcom_haptics_mode active_mode; + unsigned long stop_timeline; + + int fifo_empty_irq; + bool pm_ref_held; + bool irq_enabled; + + struct mutex fifo_lock; /* protect the FIFO data during play */ + const s8 *fifo_data; + u32 data_len; + u32 data_written; + + struct qcom_haptics_effect effects[HAPTICS_MAX_EFFECTS]; +}; + +static int cfg_write(struct qcom_haptics *h, u32 off, u32 val) +{ + return regmap_write(h->regmap, h->cfg_base + off, val); +} + +static int cfg_update_bits(struct qcom_haptics *h, u32 off, u32 mask, u32 = val) +{ + return regmap_update_bits(h->regmap, h->cfg_base + off, mask, val); +} + +static int ptn_write(struct qcom_haptics *h, u32 off, u32 val) +{ + return regmap_write(h->regmap, h->ptn_base + off, val); +} + +static int ptn_update_bits(struct qcom_haptics *h, u32 off, u32 mask, u32 = val) +{ + return regmap_update_bits(h->regmap, h->ptn_base + off, mask, val); +} + +static int ptn_bulk_write(struct qcom_haptics *h, u32 off, + const void *buf, size_t count) +{ + return regmap_bulk_write(h->regmap, h->ptn_base + off, buf, count); +} + +static int haptics_clear_faults(struct qcom_haptics *h) +{ + return cfg_write(h, HAP_CFG_FAULT_CLR_REG, FAULT_CLR_ALL); +} + +static int haptics_set_vmax(struct qcom_haptics *h, u32 vmax_mv) +{ + return cfg_write(h, HAP_CFG_VMAX_REG, vmax_mv / VMAX_STEP_MV); +} + +static int haptics_config_lra_period(struct qcom_haptics *h) +{ + u32 tmp =3D h->t_lra_us / TLRA_STEP_US; + int err; + + err =3D cfg_write(h, HAP_CFG_TLRA_OL_HIGH_REG, (tmp >> 8) & TLRA_OL_MSB_M= ASK); + if (err) + return err; + + err =3D cfg_write(h, HAP_CFG_TLRA_OL_LOW_REG, tmp & 0xFF); + if (err) + return err; + + return 0; +} + +static int haptics_enable_module(struct qcom_haptics *h, bool enable) +{ + return cfg_update_bits(h, HAP_CFG_EN_CTL_REG, HAPTICS_EN_BIT, + enable ? HAPTICS_EN_BIT : 0); +} + +static int haptics_configure_autores(struct qcom_haptics *h) +{ + int err; + + /* AUTORES_CFG: enable, 10-cycle delay, 25% error window */ + err =3D cfg_write(h, HAP_CFG_AUTORES_CFG_REG, + AUTORES_EN_BIT | + FIELD_PREP(AUTORES_EN_DLY_MASK, AUTORES_EN_DLY_CYCLES) | + FIELD_PREP(AUTORES_ERR_WIN_MASK, AUTORES_ERR_WIN_25PCT)); + if (err) + return err; + + /* DRV_DUTY: adaptive drive/brake duty cycles at 62.5% */ + err =3D cfg_write(h, HAP_CFG_DRV_DUTY_CFG_REG, + ADT_DRV_DUTY_EN_BIT | ADT_BRK_DUTY_EN_BIT | + FIELD_PREP(DRV_DUTY_MASK, AUTORES_DRV_DUTY_62P5) | + FIELD_PREP(BRK_DUTY_MASK, AUTORES_BRK_DUTY_62P5)); + if (err) + return err; + + /* Pre-HIZ delay: 10 =C2=B5s */ + err =3D cfg_write(h, HAP_CFG_RAMP_DN_CFG2_REG, AUTORES_PRE_HIZ_DLY_10US); + if (err) + return err; + + /* Zero-cross window: debounce 3, no hysteresis, height 2 */ + err =3D cfg_write(h, HAP_CFG_ZX_WIND_CFG_REG, + FIELD_PREP(ZX_DEBOUNCE_MASK, AUTORES_ZX_DEBOUNCE) | + FIELD_PREP(ZX_WIN_HEIGHT_MASK, AUTORES_ZX_WIN_HEIGHT)); + if (err) + return err; + + return 0; +} + +static int haptics_write_fifo_chunk(struct qcom_haptics *h, + const s8 *data, u32 len) +{ + u32 bulk_len =3D ALIGN_DOWN(len, 4); + int i, err; + + /* + * FIFO data writing supports both 4-byte bulk writes using registers + * [HAP_PTN_FIFO_DIN_0_REG ... HAP_PTN_FIFO_DIN_3_REG], and 1-byte writes + * using the HAP_PTN_FIFO_DIN_1B_REG register. The 4-byte bulk write is m= ore + * efficient, so use 4-byte writes for the initial 4-byte aligned data, + * and 1-byte writes for any trailing remainder. + */ + for (i =3D 0; i < bulk_len; i +=3D 4) { + err =3D ptn_bulk_write(h, HAP_PTN_FIFO_DIN_0_REG, &data[i], 4); + if (err) + return err; + } + + for (; i < len; i++) { + err =3D ptn_write(h, HAP_PTN_FIFO_DIN_1B_REG, (u8)data[i]); + if (err) + return err; + } + + return 0; +} + +static int haptics_configure_fifo_mmap(struct qcom_haptics *h) +{ + u32 fifo_len, fifo_units; + + /* Config all memory space for FIFO usage for now */ + fifo_len =3D HAP530_MEM_TOTAL_BYTES; + fifo_len =3D ALIGN_DOWN(fifo_len, 64); + fifo_units =3D fifo_len / 64; + h->fifo_len =3D fifo_len; + + return ptn_write(h, HAP_PTN_MMAP_FIFO_REG, + MMAP_FIFO_EXIST_BIT | + FIELD_PREP(MMAP_FIFO_LEN_MASK, fifo_units - 1)); +} + +static u32 haptics_gain_scaled_vmax(struct qcom_haptics *h, u32 vmax_mv) +{ + u16 gain =3D atomic_read(&h->gain); + + return mult_frac(vmax_mv, gain, 0xFFFF); +} + +static void haptics_fifo_irq_enable(struct qcom_haptics *h, bool enable) +{ + if (h->irq_enabled =3D=3D enable) + return; + + if (enable) + enable_irq(h->fifo_empty_irq); + else + disable_irq_nosync(h->fifo_empty_irq); + + h->irq_enabled =3D enable; +} + +static int haptics_enqueue_play_req(struct qcom_haptics *h, int effect_id,= bool play) +{ + struct haptics_play_req *req; + + guard(spinlock_irqsave)(&h->play_queue_lock); + + /* + * Coalesce with an already queued request for + * the same effect instead of appending. + */ + list_for_each_entry(req, &h->play_queue, node) { + if (req->effect_id =3D=3D effect_id) { + req->play =3D play; + return 0; + } + } + + req =3D kmalloc_obj(*req, GFP_ATOMIC); + if (!req) + return -ENOMEM; + + req->effect_id =3D effect_id; + req->play =3D play; + + list_add_tail(&req->node, &h->play_queue); + + return 0; +} + +static struct haptics_play_req *haptics_dequeue_play_req(struct qcom_hapti= cs *h) +{ + struct haptics_play_req *req =3D NULL; + + guard(spinlock_irqsave)(&h->play_queue_lock); + + if (!list_empty(&h->play_queue)) { + req =3D list_first_entry(&h->play_queue, struct haptics_play_req, node); + list_del(&req->node); + } + + return req; +} + +static void haptics_queue_remove_effect(struct qcom_haptics *h, int effect= _id) +{ + struct haptics_play_req *req, *tmp; + + guard(spinlock_irqsave)(&h->play_queue_lock); + + list_for_each_entry_safe(req, tmp, &h->play_queue, node) { + if (req->effect_id =3D=3D effect_id) { + list_del(&req->node); + kfree(req); + } + } +} + +static void haptics_queue_flush(struct qcom_haptics *h) +{ + struct haptics_play_req *req, *tmp; + + guard(spinlock_irqsave)(&h->play_queue_lock); + + list_for_each_entry_safe(req, tmp, &h->play_queue, node) { + list_del(&req->node); + kfree(req); + } +} + +static int haptics_start_direct_play(struct qcom_haptics *h, int effect_id) +{ + struct qcom_haptics_effect *eff =3D &h->effects[effect_id]; + int err; + + err =3D haptics_clear_faults(h); + if (err) + return err; + + /* Enable auto-resonance for DIRECT_PLAY mode */ + err =3D cfg_update_bits(h, HAP_CFG_AUTORES_CFG_REG, + AUTORES_EN_BIT, AUTORES_EN_BIT); + if (err) + return err; + + err =3D haptics_set_vmax(h, haptics_gain_scaled_vmax(h, h->vmax_mv)); + if (err) + return err; + + err =3D ptn_write(h, HAP_PTN_DIRECT_PLAY_REG, eff->amplitude); + if (err) + return err; + + err =3D cfg_write(h, HAP_CFG_SPMI_PLAY_REG, + PLAY_EN_BIT | FIELD_PREP(PAT_SRC_MASK, PAT_SRC_DIRECT_PLAY)); + if (err) + return err; + + return 0; +} + +static int haptics_start_fifo(struct qcom_haptics *h, int effect_id) +{ + struct qcom_haptics_effect *eff =3D &h->effects[effect_id]; + u32 vmax =3D eff->vmax_mv ? eff->vmax_mv : h->vmax_mv; + u32 init_len; + bool data_done; + int err; + + if (!eff->fifo_data || !eff->data_len) + return -EINVAL; + + err =3D haptics_clear_faults(h); + if (err) + return err; + + /* Disable auto-resonance for FIFO mode */ + err =3D cfg_update_bits(h, HAP_CFG_AUTORES_CFG_REG, AUTORES_EN_BIT, 0); + if (err) + return err; + + err =3D haptics_set_vmax(h, haptics_gain_scaled_vmax(h, vmax)); + if (err) + return err; + + err =3D ptn_update_bits(h, HAP_PTN_FIFO_PLAY_RATE_REG, + FIFO_PLAY_RATE_MASK, + FIELD_PREP(FIFO_PLAY_RATE_MASK, eff->play_rate)); + if (err) + return err; + + /* Flush FIFO before loading new data */ + err =3D ptn_write(h, HAP_PTN_MEM_OP_ACCESS_REG, MEM_FLUSH_RELOAD_BIT); + if (err) + return err; + err =3D ptn_write(h, HAP_PTN_MEM_OP_ACCESS_REG, 0); + if (err) + return err; + + guard(mutex)(&h->fifo_lock); + + /* Write the initial chunk and initialise streaming state */ + init_len =3D min_t(u32, eff->data_len, FIFO_INIT_FILL); + err =3D haptics_write_fifo_chunk(h, eff->fifo_data, init_len); + if (err) + return err; + + h->fifo_data =3D eff->fifo_data; + h->data_len =3D eff->data_len; + h->data_written =3D init_len; + + /* + * Set empty threshold. When threshold > 0 the hardware fires the + * FIFO-empty interrupt when occupancy drops below the threshold, + * allowing the driver to refill. + */ + data_done =3D (h->data_written >=3D h->data_len); + if (!data_done) { + err =3D ptn_write(h, HAP_PTN_FIFO_EMPTY_CFG_REG, + FIFO_EMPTY_THRESH / FIFO_THRESH_LSB); + if (err) { + dev_err(h->dev, "set FIFO empty threshold failed, err=3D%d\n", err); + h->fifo_data =3D NULL; + return err; + } + + haptics_fifo_irq_enable(h, true); + } + + err =3D cfg_write(h, HAP_CFG_SPMI_PLAY_REG, + PLAY_EN_BIT | FIELD_PREP(PAT_SRC_MASK, PAT_SRC_FIFO)); + if (err) { + dev_err(h->dev, "trigger FIFO play failed, err=3D%d\n", err); + ptn_write(h, HAP_PTN_FIFO_EMPTY_CFG_REG, 0); + haptics_fifo_irq_enable(h, false); + h->fifo_data =3D NULL; + return err; + } + + return 0; +} + +/* + * haptics_fifo_empty_irq: Threaded IRQ handler for the FIFO-empty interru= pt. + * + * While a FIFO play is in progress the hardware fires this interrupt when + * the number of samples in the FIFO drops below the programmed threshold. + * The handler refills the FIFO from the effect's data buffer. When all + * samples have been written the threshold is set to zero. The HW would + * stop the play automatically after all of the samples in FIFO memory are + * played out. + */ +static irqreturn_t haptics_fifo_empty_irq(int irq, void *dev_id) +{ + struct qcom_haptics *h =3D dev_id; + u32 sts, to_write; + int err; + + err =3D regmap_read(h->regmap, + h->cfg_base + HAP_CFG_INT_RT_STS_REG, &sts); + if (err || !(sts & FIFO_EMPTY_BIT)) + return IRQ_NONE; + + guard(mutex)(&h->fifo_lock); + + if (!h->fifo_data) + return IRQ_HANDLED; + + /* Refill: write the next chunk */ + to_write =3D min_t(u32, h->data_len - h->data_written, + h->fifo_len - FIFO_EMPTY_THRESH); + err =3D haptics_write_fifo_chunk(h, &h->fifo_data[h->data_written], to_wr= ite); + if (err) { + dev_err(h->dev, "refill FIFO samples failed, err=3D%d\n", err); + /* + * If data refilling is failed, clear the FIFO empty threshold + * and disable the IRQ to prevent the FIFO empty IRQ being fired + * continuously. The HW would still play out the data which has + * already been programmed and then stop automatically after that. + */ + ptn_write(h, HAP_PTN_FIFO_EMPTY_CFG_REG, 0); + haptics_fifo_irq_enable(h, false); + return IRQ_HANDLED; + } + + h->data_written +=3D to_write; + + /* Disable the interrupt after all the data is queued */ + if (h->data_written >=3D h->data_len) + ptn_write(h, HAP_PTN_FIFO_EMPTY_CFG_REG, 0); + + return IRQ_HANDLED; +} + +/* + * haptics_stop: stop play in HW and put runtime PM + * @h: haptics device + * @put_noidle: a flag to put noidle + * + * Stop HW play, clear the FIFO data if the active effect was FIFO-mode, a= nd + * put runtime PM into either noidle or autosuspend based on put_noidle fl= ag. + * + */ +static void haptics_stop(struct qcom_haptics *h, bool put_noidle) +{ + lockdep_assert_held(&h->play_lock); + + cancel_delayed_work(&h->stop_work); + + cfg_write(h, HAP_CFG_SPMI_PLAY_REG, 0); + + if (h->active_mode =3D=3D HAPTICS_FIFO) { + ptn_write(h, HAP_PTN_FIFO_EMPTY_CFG_REG, 0); + scoped_guard(mutex, &h->fifo_lock) + haptics_fifo_irq_enable(h, false); + + /* + * Wait for an in-flight FIFO-empty IRQ thread to finish before + * clearing fifo_data below, so the handler can't touch it + * after it's freed. + */ + synchronize_irq(h->fifo_empty_irq); + + scoped_guard(mutex, &h->fifo_lock) + h->fifo_data =3D NULL; + } + + h->active_effect_id =3D -1; + h->active_mode =3D HAPTICS_MODE_NONE; + + if (h->pm_ref_held) { + if (put_noidle) + pm_runtime_put_noidle(h->dev); + else + pm_runtime_put_autosuspend(h->dev); + + h->pm_ref_held =3D false; + } +} + +/* + * haptics_start: start to play an effect + * @h: haptics device + * @effect_id: the index of the effect + * + * If an effect is currently active, stop it 1st. Acquires a PM ref + * if not already held, and then trigger the play based on the + * play mode. Update active_effect_id/active_mode on success. + * + */ +static int haptics_start(struct qcom_haptics *h, int effect_id) +{ + struct qcom_haptics_effect *eff =3D &h->effects[effect_id]; + unsigned long timeout; + int ret; + + lockdep_assert_held(&h->play_lock); + + if (h->active_effect_id !=3D -1) + haptics_stop(h, false); + + /* Ignore the play if the length is 0 */ + if (eff->length_ms =3D=3D 0) + return 0; + + if (!h->pm_ref_held) { + ret =3D pm_runtime_resume_and_get(h->dev); + if (ret < 0) { + dev_err(h->dev, "failed to resume device: %d\n", ret); + return ret; + } + + h->pm_ref_held =3D true; + } + + switch (h->effects[effect_id].mode) { + case HAPTICS_DIRECT_PLAY: + ret =3D haptics_start_direct_play(h, effect_id); + break; + case HAPTICS_FIFO: + ret =3D haptics_start_fifo(h, effect_id); + break; + default: + ret =3D -EINVAL; + } + + if (ret) { + dev_err(h->dev, "failed to start effect %d: %d\n", effect_id, ret); + if (h->pm_ref_held) { + pm_runtime_put_autosuspend(h->dev); + h->pm_ref_held =3D false; + } + + return ret; + } + + h->active_effect_id =3D effect_id; + h->active_mode =3D eff->mode; + + timeout =3D msecs_to_jiffies(eff->length_ms); + h->stop_timeline =3D jiffies + timeout; + mod_delayed_work(system_percpu_wq, &h->stop_work, timeout); + + return 0; +} + +static void haptics_stop_work(struct work_struct *work) +{ + struct qcom_haptics *h =3D container_of(to_delayed_work(work), + struct qcom_haptics, stop_work); + + guard(mutex)(&h->play_lock); + + if (h->active_effect_id !=3D -1 && time_after_eq(jiffies, h->stop_timelin= e)) + haptics_stop(h, false); +} + +static void haptics_play_work(struct work_struct *work) +{ + struct qcom_haptics *h =3D container_of(to_delayed_work(work), + struct qcom_haptics, play_work); + struct haptics_play_req *req =3D haptics_dequeue_play_req(h); + int ret; + + if (!req) + return; + + scoped_guard(mutex, &h->play_lock) { + if (req->play) { + ret =3D haptics_start(h, req->effect_id); + if (ret) + dev_err(h->dev, "play haptics failed, ret=3D%d\n", ret); + } else if (req->effect_id =3D=3D h->active_effect_id) { + haptics_stop(h, false); + } + } + + kfree(req); + + /* Handle the remaining requests if the queue is not empty */ + guard(spinlock_irqsave)(&h->play_queue_lock); + if (!list_empty(&h->play_queue)) + schedule_delayed_work(&h->play_work, 0); +} + +static void haptics_clear_effect(struct qcom_haptics *h, + struct qcom_haptics_effect *effect) +{ + guard(mutex)(&h->fifo_lock); + + if (h->fifo_data =3D=3D effect->fifo_data) + h->fifo_data =3D NULL; + + kvfree(effect->fifo_data); + effect->fifo_data =3D NULL; + effect->data_len =3D 0; + effect->play_rate =3D 0; + effect->vmax_mv =3D 0; + effect->length_ms =3D 0; +} + +/* + * haptics_fifo_length_us: Calculate the play duration of a FIFO effect. + * @h: haptics device pointer + * @rate: FIFO data play rate + * @data_len: FIFO data length + * + * Each FIFO sample is played out over one play-rate period, so the total + * duration is the number of samples times that period: + * + * length_us =3D (clk_base * data_len * multiplier) / divider + * + * For T_LRA-based rates the period derives from the LRA resonance period + * (h->t_lra_us): DIV_2/4/8 shorten it, X_2/4/8 lengthen it. For the + * kHz-based rates the period is 1000 us / freq_khz. + */ +static u64 haptics_fifo_length_us(struct qcom_haptics *h, + enum qcom_haptics_play_rate rate, + u32 data_len) +{ + u32 clk_base =3D 1000, multiplier =3D 1, divider =3D 1; + + switch (rate) { + case PLAY_RATE_T_LRA: + clk_base =3D h->t_lra_us; + break; + case PLAY_RATE_T_LRA_DIV_2: + clk_base =3D h->t_lra_us; + divider =3D 2; + break; + case PLAY_RATE_T_LRA_DIV_4: + clk_base =3D h->t_lra_us; + divider =3D 4; + break; + case PLAY_RATE_T_LRA_DIV_8: + clk_base =3D h->t_lra_us; + divider =3D 8; + break; + case PLAY_RATE_T_LRA_X_2: + clk_base =3D h->t_lra_us; + multiplier =3D 2; + break; + case PLAY_RATE_T_LRA_X_4: + clk_base =3D h->t_lra_us; + multiplier =3D 4; + break; + case PLAY_RATE_T_LRA_X_8: + clk_base =3D h->t_lra_us; + multiplier =3D 8; + break; + case PLAY_RATE_F_8KHZ: + divider =3D 8; + break; + case PLAY_RATE_F_16KHZ: + divider =3D 16; + break; + case PLAY_RATE_F_24KHZ: + divider =3D 24; + break; + case PLAY_RATE_F_32KHZ: + divider =3D 32; + break; + case PLAY_RATE_F_44P1KHZ: + clk_base *=3D 10; + divider =3D 441; + break; + case PLAY_RATE_F_48KHZ: + divider =3D 48; + break; + default: + /* Unexpected rate: fall back to the resonance period. */ + clk_base =3D h->t_lra_us; + break; + } + + return div_u64((u64)clk_base * data_len * multiplier, divider); +} + +static int haptics_upload_effect(struct input_dev *dev, + struct ff_effect *effect, + struct ff_effect *old) +{ + struct qcom_haptics *h =3D input_get_drvdata(dev); + struct qcom_haptics_effect *priv; + int id =3D effect->id; + u32 data_len, level; + u64 length_us; + s8 *fifo; + + guard(mutex)(&h->play_lock); + + if (id < 0 || id >=3D HAPTICS_MAX_EFFECTS) + return -EINVAL; + + if (id =3D=3D h->active_effect_id) { + dev_err(h->dev, "effect %d is under playing\n", id); + return -EBUSY; + } + + priv =3D &h->effects[id]; + + switch (effect->type) { + case FF_CONSTANT: + haptics_clear_effect(h, priv); + level =3D effect->u.constant.level <=3D 0 ? 0 : effect->u.constant.level; + priv->amplitude =3D (u8)mult_frac(level, 255, 0x7FFF); + priv->length_ms =3D effect->replay.length; + priv->mode =3D HAPTICS_DIRECT_PLAY; + priv->vmax_mv =3D h->vmax_mv; + return 0; + + case FF_PERIODIC: { + /* + * FF_RUMBLE effect is converted to FF_PERIODIC/FF_SINE and play + * it using DIRECT_PLAY mode which drives sinusoidal waveforms + */ + if (effect->u.periodic.waveform =3D=3D FF_SINE) { + haptics_clear_effect(h, priv); + level =3D effect->u.periodic.magnitude <=3D 0 ? + 0 : effect->u.periodic.magnitude; + priv->amplitude =3D (u8)mult_frac(level, 255, 0x7FFF); + priv->length_ms =3D effect->replay.length; + priv->mode =3D HAPTICS_DIRECT_PLAY; + priv->vmax_mv =3D h->vmax_mv; + return 0; + } + + if (effect->u.periodic.waveform !=3D FF_CUSTOM) + return -EINVAL; + /* + * Minimum 3 elements: play-rate code + vmax + at least one sample. + * Limit the maximum data length to ~48K so that it can at least + * handle ~1s vibration at the fast (48K) play rate. + * + * custom_data here is a raw play-rate + sample buffer for direct + * HW FIFO streaming rather than a parameterized waveform, so + * replay.delay, u.periodic.magnitude and the envelope do not + * apply, and the buffer is played back exactly once per + * playback() call (no repeat-count support). + */ + if (effect->u.periodic.custom_len < 3 || + effect->u.periodic.custom_len > CUSTOM_DATA_MAX_LEN + 2) + return -EINVAL; + + s16 *buf __free(kvfree) =3D vmemdup_array_user(effect->u.periodic.custom= _data, + effect->u.periodic.custom_len, + sizeof(s16)); + if (IS_ERR(buf)) + return PTR_ERR(no_free_ptr(buf)); + + if (buf[CUSTOM_DATA_RATE_IDX] < 0 || + buf[CUSTOM_DATA_RATE_IDX] > PLAY_RATE_MAX || + buf[CUSTOM_DATA_RATE_IDX] =3D=3D PLAY_RATE_RESERVED) + return -EINVAL; + + data_len =3D effect->u.periodic.custom_len - CUSTOM_DATA_SAMPLE_START; + + fifo =3D kvmalloc(data_len, GFP_KERNEL); + if (!fifo) + return -ENOMEM; + + /* Pack: one s8 sample per s16 slot (lower byte) */ + for (int i =3D 0; i < data_len; i++) + fifo[i] =3D (s8)buf[CUSTOM_DATA_SAMPLE_START + i]; + + haptics_clear_effect(h, priv); + + scoped_guard(mutex, &h->fifo_lock) { + priv->fifo_data =3D fifo; + priv->data_len =3D data_len; + } + + priv->play_rate =3D (u8)buf[CUSTOM_DATA_RATE_IDX]; + priv->vmax_mv =3D (u32)clamp_val(buf[CUSTOM_DATA_VMAX_IDX], 0, VMAX_MV= _MAX); + length_us =3D haptics_fifo_length_us(h, priv->play_rate, data_len); + priv->length_ms =3D DIV_ROUND_UP_ULL(length_us, USEC_PER_MSEC); + if (effect->replay.length) + priv->length_ms =3D min_t(u64, priv->length_ms, effect->replay.length); + + priv->mode =3D HAPTICS_FIFO; + + return 0; + } + + default: + return -EINVAL; + } +} + +static int haptics_playback(struct input_dev *dev, int effect_id, int val) +{ + struct qcom_haptics *h =3D input_get_drvdata(dev); + int ret; + + ret =3D haptics_enqueue_play_req(h, effect_id, val > 0); + if (ret) + return ret; + + schedule_delayed_work(&h->play_work, 0); + + return 0; +} + +static int haptics_erase(struct input_dev *dev, int effect_id) +{ + struct qcom_haptics *h =3D input_get_drvdata(dev); + struct qcom_haptics_effect *priv =3D &h->effects[effect_id]; + + guard(mutex)(&h->play_lock); + + haptics_queue_remove_effect(h, effect_id); + + if (h->active_effect_id =3D=3D effect_id) + haptics_stop(h, false); + + haptics_clear_effect(h, priv); + priv->mode =3D HAPTICS_MODE_NONE; + + return 0; +} + +static void haptics_gain_work(struct work_struct *work) +{ + struct qcom_haptics *h =3D container_of(work, struct qcom_haptics, gain_w= ork); + struct qcom_haptics_effect *eff; + int effect_id; + u32 vmax; + + guard(mutex)(&h->play_lock); + + effect_id =3D h->active_effect_id; + if (effect_id =3D=3D -1) + return; + + eff =3D &h->effects[effect_id]; + vmax =3D eff->vmax_mv ? eff->vmax_mv : h->vmax_mv; + + haptics_set_vmax(h, haptics_gain_scaled_vmax(h, vmax)); +} + +static void haptics_set_gain(struct input_dev *dev, u16 gain) +{ + struct qcom_haptics *h =3D input_get_drvdata(dev); + + atomic_set(&h->gain, gain); + schedule_work(&h->gain_work); +} + +static void qcom_haptics_close(struct input_dev *input) +{ + struct qcom_haptics *h =3D input_get_drvdata(input); + + cancel_work_sync(&h->gain_work); + cancel_delayed_work_sync(&h->play_work); + cancel_delayed_work_sync(&h->stop_work); + scoped_guard(mutex, &h->play_lock) { + haptics_queue_flush(h); + haptics_stop(h, false); + } +} + +static void qcom_haptics_cleanup(void *data) +{ + struct qcom_haptics *h =3D data; + int i; + + cancel_work_sync(&h->gain_work); + cancel_delayed_work_sync(&h->play_work); + cancel_delayed_work_sync(&h->stop_work); + + for (i =3D 0; i < HAPTICS_MAX_EFFECTS; i++) + haptics_clear_effect(h, &h->effects[i]); + + haptics_enable_module(h, false); +} + +static int qcom_haptics_probe(struct platform_device *pdev) +{ + struct qcom_haptics *h; + struct input_dev *input; + struct ff_device *ff; + u32 regs[2], vmax_uv; + int ret, irq; + + h =3D devm_kzalloc(&pdev->dev, sizeof(*h), GFP_KERNEL); + if (!h) + return -ENOMEM; + + h->dev =3D &pdev->dev; + + h->regmap =3D dev_get_regmap(pdev->dev.parent, NULL); + if (!h->regmap) + return dev_err_probe(h->dev, -ENODEV, "no regmap from parent\n"); + + ret =3D device_property_read_u32_array(h->dev, "reg", regs, ARRAY_SIZE(re= gs)); + if (ret) + return dev_err_probe(h->dev, ret, "failed to read 'reg' property\n"); + + h->cfg_base =3D regs[0]; + h->ptn_base =3D regs[1]; + + ret =3D device_property_read_u32(h->dev, "qcom,lra-period-us", &h->t_lra_= us); + if (ret) + return dev_err_probe(h->dev, ret, "missing qcom,lra-period-us\n"); + + h->t_lra_us =3D clamp(h->t_lra_us, (u32)TLRA_STEP_US, (u32)TLRA_US_MAX); + + ret =3D device_property_read_u32(h->dev, "qcom,vmax-microvolt", &vmax_uv); + if (ret) + return dev_err_probe(h->dev, ret, "missing qcom,vmax-microvolt\n"); + + h->vmax_mv =3D clamp(vmax_uv / 1000, (u32)VMAX_STEP_MV, (u32)VMAX_MV_MAX); + + ret =3D haptics_config_lra_period(h); + if (ret) + return ret; + + ret =3D haptics_configure_autores(h); + if (ret) + return ret; + + ret =3D haptics_set_vmax(h, h->vmax_mv); + if (ret) + return ret; + + ret =3D haptics_configure_fifo_mmap(h); + if (ret) + return ret; + + ret =3D devm_mutex_init(h->dev, &h->play_lock); + if (ret) + return ret; + + ret =3D devm_mutex_init(h->dev, &h->fifo_lock); + if (ret) + return ret; + + spin_lock_init(&h->play_queue_lock); + INIT_LIST_HEAD(&h->play_queue); + INIT_DELAYED_WORK(&h->play_work, haptics_play_work); + INIT_DELAYED_WORK(&h->stop_work, haptics_stop_work); + INIT_WORK(&h->gain_work, haptics_gain_work); + atomic_set(&h->gain, 0xFFFF); + h->active_effect_id =3D -1; + + ret =3D devm_add_action_or_reset(h->dev, qcom_haptics_cleanup, h); + if (ret) + return ret; + + irq =3D platform_get_irq_byname(pdev, "fifo-empty"); + if (irq < 0) + return dev_err_probe(h->dev, irq, "failed to get fifo-empty IRQ\n"); + + ret =3D devm_request_threaded_irq(h->dev, irq, NULL, + haptics_fifo_empty_irq, + IRQF_ONESHOT | IRQF_NO_AUTOEN, + "qcom-haptics-fifo-empty", h); + if (ret) + return dev_err_probe(h->dev, ret, "failed to request fifo-empty IRQ\n"); + + h->fifo_empty_irq =3D irq; + platform_set_drvdata(pdev, h); + + pm_runtime_use_autosuspend(h->dev); + pm_runtime_set_autosuspend_delay(h->dev, HAPTICS_AUTOSUSPEND_MS); + ret =3D devm_pm_runtime_enable(h->dev); + if (ret) + return dev_err_probe(h->dev, ret, "enable runtime PM failed\n"); + + input =3D devm_input_allocate_device(h->dev); + if (!input) + return -ENOMEM; + + input->name =3D "qcom-spmi-haptics"; + input->id.bustype =3D BUS_HOST; + input->close =3D qcom_haptics_close; + input_set_drvdata(input, h); + h->input =3D input; + + input_set_capability(input, EV_FF, FF_CONSTANT); + input_set_capability(input, EV_FF, FF_PERIODIC); + input_set_capability(input, EV_FF, FF_CUSTOM); + input_set_capability(input, EV_FF, FF_GAIN); + + ret =3D input_ff_create(input, HAPTICS_MAX_EFFECTS); + if (ret) + return ret; + + ff =3D input->ff; + ff->upload =3D haptics_upload_effect; + ff->playback =3D haptics_playback; + ff->erase =3D haptics_erase; + ff->set_gain =3D haptics_set_gain; + + ret =3D input_register_device(input); + if (ret) + return dev_err_probe(h->dev, ret, "failed to register input device\n"); + + return 0; +} + +static int qcom_haptics_runtime_suspend(struct device *dev) +{ + struct qcom_haptics *h =3D dev_get_drvdata(dev); + + return haptics_enable_module(h, false); +} + +static int qcom_haptics_runtime_resume(struct device *dev) +{ + struct qcom_haptics *h =3D dev_get_drvdata(dev); + + return haptics_enable_module(h, true); +} + +static int qcom_haptics_suspend(struct device *dev) +{ + struct qcom_haptics *h =3D dev_get_drvdata(dev); + int ret; + + cancel_work_sync(&h->gain_work); + disable_delayed_work_sync(&h->play_work); + disable_delayed_work_sync(&h->stop_work); + scoped_guard(mutex, &h->play_lock) { + haptics_queue_flush(h); + haptics_stop(h, true); + } + + ret =3D pm_runtime_force_suspend(dev); + if (ret) { + enable_delayed_work(&h->play_work); + enable_delayed_work(&h->stop_work); + } + + return ret; +} + +static int qcom_haptics_resume(struct device *dev) +{ + struct qcom_haptics *h =3D dev_get_drvdata(dev); + + enable_delayed_work(&h->play_work); + enable_delayed_work(&h->stop_work); + + return pm_runtime_force_resume(dev); +} + +static const struct dev_pm_ops qcom_haptics_pm_ops =3D { + SYSTEM_SLEEP_PM_OPS(qcom_haptics_suspend, qcom_haptics_resume) + RUNTIME_PM_OPS(qcom_haptics_runtime_suspend, qcom_haptics_runtime_resume, + NULL) +}; + +static const struct of_device_id qcom_haptics_of_match[] =3D { + { .compatible =3D "qcom,spmi-haptics" }, + { } +}; +MODULE_DEVICE_TABLE(of, qcom_haptics_of_match); + +static struct platform_driver qcom_haptics_driver =3D { + .probe =3D qcom_haptics_probe, + .driver =3D { + .name =3D "qcom-spmi-haptics", + .of_match_table =3D qcom_haptics_of_match, + .pm =3D pm_ptr(&qcom_haptics_pm_ops), + }, +}; +module_platform_driver(qcom_haptics_driver); + +MODULE_DESCRIPTION("Qualcomm SPMI PMIC Haptics driver"); +MODULE_LICENSE("GPL"); --=20 2.43.0