dts: bindings: added stm32 tsc driver bindings

Added tsc pripheral bindings

Signed-off-by: Arif Balik <[email protected]>

Author: arifbalik

dts/bindings/input/st,stm32-tsc.yaml

@@ -0,0 +1,128 @@
+# Copyright (c) 2024 Arif Balik <[email protected]>
+# SPDX-License-Identifier: Apache-2.0
+
+description: STM32 Tocuh Sensing Controller (TSC) driver
+
+compatible: "st,stm32-tsc"
+
+include: [base.yaml, pinctrl-device.yaml, reset-device.yaml]
+
+properties:
+  reg:
+    required: true
+  clocks:
+    required: true
+  resets:
+    required: true
+  interrupts:
+    required: true
+  pinctrl-0:
+    required: true
+  pinctrl-names:
+    required: true
+
+  st,pulse-generator-prescaler:
+    type: int
+    default: 0
+    description: |
+      Prescaler for the pulse generator clock (t_pgclk=f_hclk/prescaler).
+      The prescaler is used to generate the charge transfer pulse. The final
+      prescaled value is 2^N where N is the value of this property. The default
+      uses the HCLK as the source clock with no prescaler.
+    enum: [0, 1, 2, 3, 4, 5, 6, 7]
+
+  st,charge-transfer-pulse-high:
+    type: int
+    default: 2
+    description: |
+      Number of cycles for the high state of the
+      charge transfer pulse (1 to 16 cycles of t_pgclk). The default keeps the
+      pulse for 2 cycles which is just enough to charge the capacitors for most
+      applications. Increase this value if change in capacitance is too low.
+    enum: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]
+
+  st,charge-transfer-pulse-low:
+    type: int
+    default: 2
+    description: |
+      Number of cycles for the low state of the
+      charge transfer pulse (1 to 16 cycles of t_pgclk). The default discharges
+      the capacitors for 2 cycles of the pulse generator clock, which is enough
+      for most applications.
+    enum: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]
+
+  st,spread-spectrum:
+    type: boolean
+    description: Spread spectrum enable
+
+  st,spread-spectrum-prescaler:
+    type: int
+    default: 1
+    description: Spread spectrum clock prescaler (t_ssclk)
+    enum:
+      - 1
+      - 2
+
+  st,spread-spectrum-deviation:
+    type: int
+    default: 1
+    description: Spread spectrum deviation (1 to 128 cycles of t_ssclk)
+
+  st,max-count-value:
+    type: int
+    default: 5
+    description: |
+      Max number of charge transfer pulses before max count error is generated.
+      The value of the counter is calculated as 256 * 2^max_count_value. Default
+      value is 5 which gives a maximum count of 8192, if you get max count error
+      increase this value or the st,charge-transfer-pulse-high value.
+    enum: [0, 1, 2, 3, 4, 5, 6, 7]
+
+  st,synced-acquisition:
+    type: boolean
+    description: |
+      Synchronized acquisition enable.
+      Acquisition starts when START bit and signal on sync pin.
+      You have to provide a pinctrl for the sync pin.
+
+  st,syncpol-rising:
+    type: boolean
+    description: Rising synchronization pin polarity, instead of falling
+
+  st,iodef-float:
+    type: boolean
+    description: |
+      Set default state (not acqusition) of all channel I/Os to floating.
+      push-pull down by default.
+
+child-binding:
+  description: STM32 TSC group configuration
+  properties:
+    group:
+      type: int
+      required: true
+      description: Group number (0 to 7)
+      enum: [0, 1, 2, 3, 4, 5, 6, 7]
+
+    channel-ios:
+      type: int
+      default: 1
+      description: Channel I/Os to be enabled
+      enum: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]
+
+    sampling-io:
+      type: int
+      required: true
+      description: Channel to be selected for sampling
+      enum:
+        - 1
+        - 2
+        - 4
+        - 8
+
+    st,use-as-shield:
+      type: boolean
+      description: |
+        Use channel as shield. This configures group but
+        does not enable it for acqusition. channel-io is used
+        as shield pin and can only have values 1, 2, 4 or 8.

include/zephyr/dt-bindings/input/stm32-tsc-defines.h

@@ -0,0 +1,32 @@
+/*
+ * Copyright (c) 2024 Arif Balik <[email protected]>
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef ZEPHYR_INCLUDE_DT_BINDINGS_STM32_TSC_H_
+#define ZEPHYR_INCLUDE_DT_BINDINGS_STM32_TSC_H_
+
+#define TSC_IO1 0x1UL
+#define TSC_IO2 0x2UL
+#define TSC_IO3 0x4UL
+#define TSC_IO4 0x8UL
+
+#define TSC_PG_PRESCALER_1 0x0UL
+#define TSC_PG_PRESCALER_2 0x1UL
+#define TSC_PG_PRESCALER_4 0x2UL
+#define TSC_PG_PRESCALER_8 0x3UL
+#define TSC_PG_PRESCALER_16 0x4UL
+#define TSC_PG_PRESCALER_32 0x5UL
+#define TSC_PG_PRESCALER_64 0x6UL
+#define TSC_PG_PRESCALER_128 0x7UL
+
+#define TSC_MAX_COUNT_255 0x0UL
+#define TSC_MAX_COUNT_511 0x1UL
+#define TSC_MAX_COUNT_1023 0x2UL
+#define TSC_MAX_COUNT_2047 0x3UL
+#define TSC_MAX_COUNT_4095 0x4UL
+#define TSC_MAX_COUNT_8191 0x5UL
+#define TSC_MAX_COUNT_16383 0x6UL
+#define TSC_MAX_COUNT_32767 0x7UL
+
+#endif /* ZEPHYR_INCLUDE_DT_BINDINGS_STM32_TSC_H_ */