Describe the Texas Instruments DS90UB953-Q1, a MIPI CSI-2 video serializer
with I2C Address Translator and remote GPIOs.
Signed-off-by: Luca Ceresoli <[email protected]>
---
Changes RFCv2 -> RFCv3:
- rewrite in yaml
Changes RFCv1 -> RFCv2: none, this patch is new in RFCv2
---
.../bindings/media/i2c/ti,ds90ub953-q1.yaml | 96 +++++++++++++++++++
MAINTAINERS | 7 ++
include/dt-bindings/media/ds90ub953.h | 16 ++++
3 files changed, 119 insertions(+)
create mode 100644 Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
create mode 100644 include/dt-bindings/media/ds90ub953.h
diff --git a/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
new file mode 100644
index 000000000000..2a836a3e65e9
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
@@ -0,0 +1,96 @@
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+# Copyright (C) 2019 Renesas Electronics Corp.
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/media/i2c/ti,ds90ub953-q1.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments DS90UB953-Q1 video serializer
+
+maintainers:
+ - Luca Ceresoli <[email protected]>
+
+description: |
+ The TI DS90UB953-Q1 is a MIPI CSI-2 video serializer that forwards a MIPI
+ CSI-2 input video stream over an FPD Link 3 connection to a remote
+ deserializer. It also allows access to I2C and GPIO from the deserializer.
+
+ The DT definitions can be found in include/dt-bindings/media/ds90ub953.h
+
+ When used as a the remote counterpart of a deserializer (e.g. the
+ DS90UB954-Q1), the serializer is described in the
+ "deserializer/remote-chips/remote-chip@[01]" node.
+
+properties:
+ compatible:
+ const: ti,ds90ub953-q1
+
+ reg:
+ description: |
+ Index of the remote (serializer) RX port that this serializer is
+ connected to.
+ maxItems: 1
+
+ clocks:
+ description: FPD-Link line rate (provided by the deserializer)
+ maxItems: 1
+
+ gpio-controller: true
+
+ '#gpio-cells':
+ const: 2
+
+ '#clock-cells':
+ const: 0
+
+ ti,gpio-functions:
+ description: |
+ A list of 4 values defining how the 4 GPIO pins are connected in
+ hardware; possible values are:
+ - DS90_GPIO_FUNC_UNUSED (0): the GPIO is not unused
+ - DS90_GPIO_FUNC_INPUT (1): the GPIO is an input to the ds90ub953,
+ the remote chip (deserializer) can read its value
+ - DS90_GPIO_FUNC_OUTPUT_REMOTE (2): the GPIO is an output from the
+ ds90ub953, the remote chip (deserializer) can set its value
+ For unspecified values the GPIO is assumed to be unused.
+ $ref: /schemas/types.yaml#/definitions/uint32-array
+ maxItems: 4
+
+patternProperties:
+ '^ti,ds90ub953-q1-(clk|d[0-3])-inv-pol-quirk$':
+ description: |
+ The MIPI CSI-2 input clock lane or any of the data lanes has inverted
+ polarity in hardware
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - gpio-controller
+ - '#gpio-cells'
+ - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/media/ds90ub953.h>
+ remote-chips {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ remote-chip@0 {
+ reg = <0>;
+ compatible = "ti,ds90ub953-q1";
+ clocks = <&deser>;
+ ti,gpio-functions =
+ <DS90_GPIO_FUNC_UNUSED
+ DS90_GPIO_FUNC_OUTPUT_REMOTE
+ DS90_GPIO_FUNC_UNUSED
+ DS90_GPIO_FUNC_UNUSED>;
+
+ gpio-controller;
+ #gpio-cells = <2>;
+ #clock-cells = <0>;
+ };
+ };
diff --git a/MAINTAINERS b/MAINTAINERS
index 7383aec87e4a..4429ce035496 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -19090,6 +19090,13 @@ F: include/linux/dma/k3-udma-glue.h
F: include/linux/dma/ti-cppi5.h
F: include/linux/dma/k3-psil.h
+TEXAS INSTRUMENTS DS90UB953 VIDEO SERIALIZER DRIVER
+M: Luca Ceresoli <[email protected]>
+L: [email protected]
+S: Maintained
+F: Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
+F: include/dt-bindings/media/ds90ub953.h
+
TEXAS INSTRUMENTS' SYSTEM CONTROL INTERFACE (TISCI) PROTOCOL DRIVER
M: Nishanth Menon <[email protected]>
M: Tero Kristo <[email protected]>
diff --git a/include/dt-bindings/media/ds90ub953.h b/include/dt-bindings/media/ds90ub953.h
new file mode 100644
index 000000000000..5359432968e9
--- /dev/null
+++ b/include/dt-bindings/media/ds90ub953.h
@@ -0,0 +1,16 @@
+/* SPDX-License-Identifier: GPL-2.0 */
+/**
+ * Definitions for the Texas Instruments DS90UB953-Q1 video serializer
+ *
+ * Copyright (c) 2019 Luca Ceresoli <[email protected]>
+ */
+
+#ifndef _DS90UB953_H
+#define _DS90UB953_H
+
+#define DS90_GPIO_FUNC_UNUSED 0
+#define DS90_GPIO_FUNC_INPUT 1
+#define DS90_GPIO_FUNC_OUTPUT_REMOTE 2
+#define DS90_GPIO_N_FUNCS 3
+
+#endif /* _DS90UB953_H */
--
2.25.1
On Sun, Feb 06, 2022 at 12:59:36PM +0100, Luca Ceresoli wrote:
> Describe the Texas Instruments DS90UB953-Q1, a MIPI CSI-2 video serializer
> with I2C Address Translator and remote GPIOs.
>
> Signed-off-by: Luca Ceresoli <[email protected]>
>
> ---
>
> Changes RFCv2 -> RFCv3:
>
> - rewrite in yaml
>
> Changes RFCv1 -> RFCv2: none, this patch is new in RFCv2
> ---
> .../bindings/media/i2c/ti,ds90ub953-q1.yaml | 96 +++++++++++++++++++
> MAINTAINERS | 7 ++
> include/dt-bindings/media/ds90ub953.h | 16 ++++
> 3 files changed, 119 insertions(+)
> create mode 100644 Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
> create mode 100644 include/dt-bindings/media/ds90ub953.h
>
> diff --git a/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
> new file mode 100644
> index 000000000000..2a836a3e65e9
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
> @@ -0,0 +1,96 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +# Copyright (C) 2019 Renesas Electronics Corp.
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/media/i2c/ti,ds90ub953-q1.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Texas Instruments DS90UB953-Q1 video serializer
> +
> +maintainers:
> + - Luca Ceresoli <[email protected]>
> +
> +description: |
> + The TI DS90UB953-Q1 is a MIPI CSI-2 video serializer that forwards a MIPI
> + CSI-2 input video stream over an FPD Link 3 connection to a remote
> + deserializer. It also allows access to I2C and GPIO from the deserializer.
> +
> + The DT definitions can be found in include/dt-bindings/media/ds90ub953.h
> +
> + When used as a the remote counterpart of a deserializer (e.g. the
> + DS90UB954-Q1), the serializer is described in the
> + "deserializer/remote-chips/remote-chip@[01]" node.
> +
> +properties:
> + compatible:
> + const: ti,ds90ub953-q1
> +
> + reg:
> + description: |
> + Index of the remote (serializer) RX port that this serializer is
> + connected to.
> + maxItems: 1
> +
> + clocks:
> + description: FPD-Link line rate (provided by the deserializer)
> + maxItems: 1
> +
> + gpio-controller: true
> +
> + '#gpio-cells':
> + const: 2
> +
> + '#clock-cells':
> + const: 0
> +
> + ti,gpio-functions:
> + description: |
> + A list of 4 values defining how the 4 GPIO pins are connected in
> + hardware; possible values are:
> + - DS90_GPIO_FUNC_UNUSED (0): the GPIO is not unused
> + - DS90_GPIO_FUNC_INPUT (1): the GPIO is an input to the ds90ub953,
> + the remote chip (deserializer) can read its value
> + - DS90_GPIO_FUNC_OUTPUT_REMOTE (2): the GPIO is an output from the
> + ds90ub953, the remote chip (deserializer) can set its value
> + For unspecified values the GPIO is assumed to be unused.
> + $ref: /schemas/types.yaml#/definitions/uint32-array
> + maxItems: 4
> +
> +patternProperties:
> + '^ti,ds90ub953-q1-(clk|d[0-3])-inv-pol-quirk$':
> + description: |
> + The MIPI CSI-2 input clock lane or any of the data lanes has inverted
> + polarity in hardware
What's the type?
> +
> +required:
> + - compatible
> + - reg
> + - clocks
> + - gpio-controller
> + - '#gpio-cells'
> + - '#clock-cells'
> +
> +additionalProperties: false
> +
> +examples:
> + - |
> + #include <dt-bindings/media/ds90ub953.h>
> + remote-chips {
> + #address-cells = <1>;
> + #size-cells = <0>;
> +
> + remote-chip@0 {
> + reg = <0>;
> + compatible = "ti,ds90ub953-q1";
> + clocks = <&deser>;
> + ti,gpio-functions =
> + <DS90_GPIO_FUNC_UNUSED
> + DS90_GPIO_FUNC_OUTPUT_REMOTE
> + DS90_GPIO_FUNC_UNUSED
> + DS90_GPIO_FUNC_UNUSED>;
> +
> + gpio-controller;
> + #gpio-cells = <2>;
> + #clock-cells = <0>;
> + };
> + };
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 7383aec87e4a..4429ce035496 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -19090,6 +19090,13 @@ F: include/linux/dma/k3-udma-glue.h
> F: include/linux/dma/ti-cppi5.h
> F: include/linux/dma/k3-psil.h
>
> +TEXAS INSTRUMENTS DS90UB953 VIDEO SERIALIZER DRIVER
> +M: Luca Ceresoli <[email protected]>
> +L: [email protected]
> +S: Maintained
> +F: Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
> +F: include/dt-bindings/media/ds90ub953.h
> +
> TEXAS INSTRUMENTS' SYSTEM CONTROL INTERFACE (TISCI) PROTOCOL DRIVER
> M: Nishanth Menon <[email protected]>
> M: Tero Kristo <[email protected]>
> diff --git a/include/dt-bindings/media/ds90ub953.h b/include/dt-bindings/media/ds90ub953.h
> new file mode 100644
> index 000000000000..5359432968e9
> --- /dev/null
> +++ b/include/dt-bindings/media/ds90ub953.h
> @@ -0,0 +1,16 @@
> +/* SPDX-License-Identifier: GPL-2.0 */
Dual license please.
> +/**
> + * Definitions for the Texas Instruments DS90UB953-Q1 video serializer
> + *
> + * Copyright (c) 2019 Luca Ceresoli <[email protected]>
> + */
> +
> +#ifndef _DS90UB953_H
> +#define _DS90UB953_H
> +
> +#define DS90_GPIO_FUNC_UNUSED 0
> +#define DS90_GPIO_FUNC_INPUT 1
> +#define DS90_GPIO_FUNC_OUTPUT_REMOTE 2
> +#define DS90_GPIO_N_FUNCS 3
> +
> +#endif /* _DS90UB953_H */
> --
> 2.25.1
>
>