From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-lf1-f43.google.com (mail-lf1-f43.google.com [209.85.167.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51AB93451B3 for ; Fri, 24 Apr 2026 07:13:36 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777014820; cv=none; b=RRnQmMPHPn1tupXJvlfAfkU71NuTFKOw6HSp5i9gbuY87Me7my0Jsc/JohikazZArueIS2cmGzSDhHD2/zQ4lXea4ExAiBu70YLyf6ClQDejkx+te0ZcSQ4FaUe1mK9KPZl1LKj5E/nlgpd2TcRj9H4293xE4JEfTRX/dV7xFV0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777014820; c=relaxed/simple; bh=tnLPRL9A9azacxq4NLt+IId8izuY1ScptZDT7gzu40c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Uhux3SXU/Sb6qLSOvE9JlFh3mt5dHj2tFGywenx6kCjlpjk69DVirtsL3gKZGgf1ewQolji4xNEmIYEkXrmAsc82ml8P0Fkrmr5LH9sdFW83iG4GfCCEqUX2vLW6BRO0Nl3vqghIuHAslVwRZZGjZuIse3in/7QGOdQgcbChPgM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=JY4AFANb; arc=none smtp.client-ip=209.85.167.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="JY4AFANb" Received: by mail-lf1-f43.google.com with SMTP id 2adb3069b0e04-5a40502e63bso6907391e87.0 for ; Fri, 24 Apr 2026 00:13:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777014814; x=1777619614; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=RBE1o78vN0SIWnrb8j+CXJa2K5r2M8CfhkLvD2G7oEc=; b=JY4AFANbEnAu7Sm0MHnDuPYu5DcBcphUo8zr8wbxxIxCIMX1QWhV37CB2N3tJcHl31 MGJ7Oqaq/fvZCBtCFoJX0WK4vwNaCXoy5AY39WxlAyft8e9I8sDSAHUl9jB4+lMbBAgx hh4+eZoBk6eZVJ//ykx+gKR51D5rx5mNTo4cXUrBHZvfZe7otyL7obuzYUXqztsmKH0I 9qpm8OJHq+KyKz9WBYvDUbF2yMG431YAM6MCWl8njp7LD2we2A/CdTw8ZkXNx5Ji3txM nhZCGagNS/UoxBCFjNB9mIWNL16X9XOtCA8xXiNRH4HDSaO738FF4+SiMkkoGGa/I4JB iTYw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777014814; x=1777619614; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=RBE1o78vN0SIWnrb8j+CXJa2K5r2M8CfhkLvD2G7oEc=; b=Ir8ZBCLoyAAzy5nTGMR+jcUk8mAyInMWmxYdfNIOCsGHvhi/6iXU6jtWDZ1Jz0LaGi R009PsBnUfd5ow+eHtzjjvMEERd/XYmWvabG0AAhpNFdd+BbXio2ITRyuz1UBBu+DOcC h7yAiXRHr6zimRKYorUloIgSfb9X7j6TDyVIFACu3X9rGf09z2Rt/+ij+Fph3TUqKZZN KDj+QlFvT8m/JWAJDjY3E8l+dg9bhmnTBra5NwK4obLCm1xGyDO4+ZKt4yhkeylnX5Ho bpQNEQJgBAQxFhBe3f1RGs5rqrtMQByxX/mS7ib/bUBOxSLZyc0hG5HWASa57v+4A+sW VqJw== X-Forwarded-Encrypted: i=1; AFNElJ8wqIGb6JMQk1mWHuvRMmZsgBeeYjDl87ax8YQbxAYcdbTAOLeDB0sNmXswk0ssqshcxqX/pJlnAPuR@vger.kernel.org X-Gm-Message-State: AOJu0YyJBTVXjyo4wlUz8K4MWQkWX/TFZwE53RyKu7kYNlfMuc5jRU9p agJfXaS2g0O6by805F5QnP3IHjltE+QtSu6lAlDHQ5b7skvCMd+UZ67k X-Gm-Gg: AeBDiesrqMjXSi28EQ1GHOD4k4ShEhqAbeQZjSHa7KxGDCPEB2ipsrTP8UZu+ep9o6u etWfnMfQSt8iiyVls2WDfJfvW2M+CxDbzYcArsB1txqMfbbtS8QjLDeplXyTrQmgTtcax52oUSf LX3qPnyWSWz7E0s8Tzl8azChkUShL+PdsrouBuXLjifehSz5Z0jgQVCelWMkjFeIRcjNj6nY0sZ apj6xfSmP6r2aeAJiQzU7lH2c2ex17WEifCB8LZuid55ty5/nCdScNMp44SS90f3yJYDiWdYX4h bVzQF14KjpHdvpkTr0ibfjHeq/PIMjWmonRsviYj6TyHgt9H9fUHV59m4xJ5TfUh0OrMYXUSxWz PE5dXiRs1ewdHWXAhGYPKbkSLMNr/qa/58V+P0ZQ+5OJPFMzRLyoBhqXdT++MuKOLIlIaFUvSVo ccWOunBo4vVEbwMqlENiQ9tks= X-Received: by 2002:a05:6512:3b14:b0:5a3:d381:2a7c with SMTP id 2adb3069b0e04-5a4172e2d60mr12562766e87.31.1777014814198; Fri, 24 Apr 2026 00:13:34 -0700 (PDT) Received: from xeon ([188.163.112.56]) by smtp.gmail.com with ESMTPSA id 38308e7fff4ca-38ecb290095sm43760131fa.0.2026.04.24.00.13.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 24 Apr 2026 00:13:33 -0700 (PDT) From: Svyatoslav Ryhel To: Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Linus Walleij , Svyatoslav Ryhel Cc: linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v1 1/2] dt-bindings: input: Document Imagis ISA1200 haptic motor driver Date: Fri, 24 Apr 2026 10:13:04 +0300 Message-ID: <20260424071305.89503-2-clamor95@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20260424071305.89503-1-clamor95@gmail.com> References: <20260424071305.89503-1-clamor95@gmail.com> Precedence: bulk X-Mailing-List: devicetree@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Document the Imagis ISA1200 haptic motor driver, used primarily in mobile handheld devices and capable of supporting up to two motors. The exact datasheet for the ISA1200 is not available; all data was modeled based on available downstream kernel sources for various devices and fragments of information scattered across the internet. Signed-off-by: Svyatoslav Ryhel --- .../bindings/input/imagis,isa1200.yaml | 145 ++++++++++++++++++ include/dt-bindings/input/isa1200.h | 16 ++ 2 files changed, 161 insertions(+) create mode 100644 Documentation/devicetree/bindings/input/imagis,isa1200.yaml create mode 100644 include/dt-bindings/input/isa1200.h diff --git a/Documentation/devicetree/bindings/input/imagis,isa1200.yaml b/Documentation/devicetree/bindings/input/imagis,isa1200.yaml new file mode 100644 index 000000000000..51767fd8189d --- /dev/null +++ b/Documentation/devicetree/bindings/input/imagis,isa1200.yaml @@ -0,0 +1,145 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/input/imagis,isa1200.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Imagis ISA1200 haptic motor driver + +maintainers: + - Svyatoslav Ryhel + - Linus Walleij + +description: + The ISA1200 is a high-performance enhanced haptic motor driver designed + for mobile hand-held devices. It supports various voltages for both ERM + (Eccentric Rotating Mass) and LRA (Linear Resonant Actuator) type + actuators. Thanks to an embedded LDO, battery power can be used directly + in handheld applications. + +properties: + compatible: + const: imagis,isa1200 + + reg: + maxItems: 1 + + enable-gpios: + description: + One or two GPIOs flagged as active high linked to HEN and LEN pins + maxItems: 2 + + clocks: + maxItems: 1 + + pwms: + maxItems: 1 + + vdd-supply: + description: + Regulator for 2.4V - 5.5V power supply + + vddp-supply: + description: + Regulator for 2.4V - 3.6V IO power supply + + imagis,clk-div: + $ref: /schemas/types.yaml#/definitions/uint32 + description: | + Divider for the external input clock/PWM + 0 - 128 + 1 - 256 + 2 - 512 + 3 - 1024 + enum: [0, 1, 2, 3] + default: 0 + + imagis,pll-div: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Divider for the internal PLL clock + minimum: 1 + maximum: 15 + default: 1 + + imagis,mode: + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Defines the motor type isa1200 drives + 0 - LRA (Linear Resonant Actuator) + 1 - ERM (Eccentric Rotating Mass) + enum: [0, 1] + default: 0 + + imagis,period-ns: + description: + Period of the internal PWM channel in nanoseconds. + minimum: 128 + maximum: 254 + + imagis,duty-cycle-ns: + description: + Duty cycle of the external/internal PWM channel in nanoseconds, + defaults to 50% of the channel's period + + ldo: + $ref: /schemas/regulator/regulator.yaml# + type: object + description: + Embedded LDO regulator with voltage range 2.3V - 3.8V + unevaluatedProperties: false + + required: + - regulator-min-microvolt + - regulator-max-microvolt + +required: + - compatible + - reg + - ldo + +anyOf: + - required: + - clocks + - imagis,period-ns + - required: + - pwms + +additionalProperties: false + +examples: + - | + #include + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + haptic-engine@49 { + compatible = "imagis,isa1200"; + reg = <0x49>; + + clocks = <&isa1200_refclk>; + + enable-gpios = <&gpio 22 GPIO_ACTIVE_HIGH>, + <&gpio 23 GPIO_ACTIVE_HIGH>; + + vdd-supply = <&vdd_3v3_vbat>; + vddp-supply = <&vdd_2v8_vvib>; + + imagis,clk-div = ; + imagis,pll-div = <2>; + + imagis,mode = ; + + imagis,period-ns = <134>; + imagis,duty-cycle-ns = <100>; + + ldo { + regulator-name = "vdd_vib"; + regulator-min-microvolt = <2300000>; + regulator-max-microvolt = <2300000>; + }; + }; + }; diff --git a/include/dt-bindings/input/isa1200.h b/include/dt-bindings/input/isa1200.h new file mode 100644 index 000000000000..cbae47ccf99b --- /dev/null +++ b/include/dt-bindings/input/isa1200.h @@ -0,0 +1,16 @@ +/* SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause */ + +#ifndef _DT_BINDINGS_ISA1200_H +#define _DT_BINDINGS_ISA1200_H + +/* Linked actuator type */ +#define ISA1200_LRA_MODE 0 +#define ISA1200_ERM_MODE 1 + +/* External clock divider */ +#define ISA1200_CKLDIV_128 0 +#define ISA1200_CKLDIV_256 1 +#define ISA1200_CKLDIV_512 2 +#define ISA1200_CKLDIV_1024 3 + +#endif -- 2.51.0