| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Message-Id: <20220206115939.3091265-5-luca@lucaceresoli.net>
Date: Sun, 6 Feb 2022 12:59:37 +0100
From: Luca Ceresoli <luca@...aceresoli.net>
To: linux-media@...r.kernel.org, linux-i2c@...r.kernel.org
Cc: Luca Ceresoli <luca@...aceresoli.net>, devicetree@...r.kernel.org,
linux-kernel@...r.kernel.org, Rob Herring <robh+dt@...nel.org>,
Mark Rutland <mark.rutland@....com>,
Wolfram Sang <wsa@...-dreams.de>,
Sakari Ailus <sakari.ailus@...ux.intel.com>,
Hans Verkuil <hverkuil-cisco@...all.nl>,
Laurent Pinchart <laurent.pinchart@...asonboard.com>,
Kieran Bingham <kieran.bingham@...asonboard.com>,
Jacopo Mondi <jacopo@...ndi.org>,
Vladimir Zapolskiy <vz@...ia.com>,
Peter Rosin <peda@...ntia.se>,
Mauro Carvalho Chehab <mchehab@...nel.org>,
Tomi Valkeinen <tomi.valkeinen@...asonboard.com>,
matti.vaittinen@...rohmeurope.com
Subject: [RFCv3 4/6] media: dt-bindings: add DS90UB954-Q1 video deserializer
Describe the Texas Instruments DS90UB954-Q1, a 2-input MIPI CSI-2 video
deserializer with I2C Address Translator and remote GPIOs.
Signed-off-by: Luca Ceresoli <luca@...aceresoli.net>
---
Changes RFCv2 -> RFCv3:
- rewrite in yaml
- use new layout based on remote-chips under the main deser node
- new clock configuration based on common clock framework
Changes RFCv1 -> RFCv2:
- add explicit aliases for the FPD-link RX ports (optional)
- add proper remote GPIO description
---
.../bindings/media/i2c/ti,ds90ub954-q1.yaml | 235 ++++++++++++++++++
MAINTAINERS | 6 +
2 files changed, 241 insertions(+)
create mode 100644 Documentation/devicetree/bindings/media/i2c/ti,ds90ub954-q1.yaml
diff --git a/Documentation/devicetree/bindings/media/i2c/ti,ds90ub954-q1.yaml b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub954-q1.yaml
new file mode 100644
index 000000000000..95dc3d22f5d8
--- /dev/null
+++ b/Documentation/devicetree/bindings/media/i2c/ti,ds90ub954-q1.yaml
@@ -0,0 +1,235 @@
+# 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,ds90ub954-q1.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Texas Instruments DS90UB954-Q1 dual video deserializer
+
+maintainers:
+ - Luca Ceresoli <luca@...aceresoli.net>
+
+description: |
+ The TI DS90UB954-Q1 is a MIPI CSI-2 video deserializer that forwards
+ video streams from up to two FPD-Link 3 connections to a MIPI CSI-2
+ output. It also allows access to remote I2C and GPIO.
+
+properties:
+ compatible:
+ const: ti,ds90ub954-q1
+
+ reg:
+ description: |
+ main I2C slave address; optionally aliases for RX port registers and
+ remote serializers. The main address is mandatory and must be the
+ first, others are optional and fall back to defaults if not
+ specified. See "reg-names".
+
+ reg-names:
+ description: |
+ Names of I2C address used to communicate with the chip, must match
+ the "reg" values; mandatory if there are 2 or more addresses.
+ "main" is the main I2C address, used to access shared registers.
+ "rxport0" and "rxport1" are the I2C alias to access FPD-link RX
+ port specific registers; must not be used by other slaves on the
+ same bus. "ser0" and "ser1" are the I2C alias to access the remote
+ serializer connected on each FPD-link RX port; must not be used by
+ other slaves on the same bus.
+ minItems: 1
+ maxItems: 5
+ items:
+ - const: main
+ - const: rxport0
+ - const: rxport1
+ - const: ser0
+ - const: ser1
+
+ clocks:
+ description: provider of the clock on the XIN/REFCLK pin
+ maxItems: 1
+
+ interrupts:
+ maxItems: 1
+
+ reset-gpios:
+ description: chip reset GPIO connected to PDB pin (active low)
+
+ i2c-alias-pool:
+ description: |
+ list of I2C addresses that are known to be available on the "local"
+ (SoC-to-deser) I2C bus; they will be picked at runtime and used as
+ aliases to reach remote I2C chips
+
+ '#clock-cells':
+ description: |
+ the DS90UB954 provides the FPD line rate clock to the serializer
+ const: 0
+
+ ports:
+ $ref: /schemas/graph.yaml#/properties/ports
+
+ patternProperties:
+ '^port@[01]$':
+ $ref: /schemas/graph.yaml#/$defs/port-base
+ description: FPD-Link RX port 0 (RIN0+/RIN0- pins)
+
+ properties:
+ endpoint:
+ $ref: /schemas/media/video-interfaces.yaml#
+ unevaluatedProperties: false
+
+ '^port@2$':
+ $ref: /schemas/graph.yaml#/properties/port
+ description: MIPI-CSI2 TX port
+
+ remote-chips:
+ type: object
+
+ properties:
+ '#address-cells':
+ const: 1
+ '#size-cells':
+ const: 0
+
+ patternProperties:
+ '^remote-chip@([01]+)$':
+ type: object
+ $ref: /schemas/media/i2c/ti,ds90ub953-q1.yaml#
+
+ required:
+ - '#address-cells'
+ - '#size-cells'
+
+ additionalProperties: false
+
+ i2c-atr:
+ description: |
+ Each child describes the I2C bus on the remote side of an RX port
+ type: object
+
+ properties:
+ '#address-cells':
+ const: 1
+ '#size-cells':
+ const: 0
+
+ patternProperties:
+ '^i2c@([01]+)$':
+ type: object
+
+ properties:
+ reg:
+ maxItems: 1
+ '#address-cells':
+ const: 1
+ '#size-cells':
+ const: 0
+ clock-frequency:
+ minimum: 1
+ maximum: 1000000
+
+ additionalProperties: false
+
+required:
+ - compatible
+ - reg
+ - clocks
+ - ports
+ - remote-chips
+ - i2c-atr
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/interrupt-controller/irq.h>
+ #include <dt-bindings/gpio/gpio.h>
+ #include <dt-bindings/media/ds90ub953.h>
+
+ i2c@0 {
+ reg = <0x0 0x100>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ deser: deser@3d {
+ compatible = "ti,ds90ub954-q1";
+ reg-names = "main", "rxport0", "rxport1", "ser0", "ser1";
+ reg = <0x3d>, <0x40>, <0x41>, <0x44>, <0x45>;
+ clocks = <&clk_25M>;
+ interrupt-parent = <&gic>;
+ interrupts = <3 1 IRQ_TYPE_LEVEL_LOW>;
+ reset-gpios = <&gpio 4 GPIO_ACTIVE_LOW>;
+
+ #clock-cells = <0>;
+
+ i2c-alias-pool = /bits/ 16 <0x4a 0x4b 0x4c 0x4d 0x4e 0x4f>;
+
+ ports {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ port@0 {
+ reg = <0>;
+ ds90ub954_fpd3_in0: endpoint {
+ remote-endpoint = <&sensor_0_out>;
+ };
+ };
+
+ port@2 {
+ reg = <2>;
+ ds90ub954_mipi_out0: endpoint {
+ data-lanes = <1 2 3 4>;
+ link-frequencies = /bits/ 64 <400000000>;
+ remote-endpoint = <&csirx_0_in>;
+ };
+ };
+ };
+
+ remote-chips {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ des0_ser0: 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>;
+ };
+ };
+
+ i2c-atr {
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ remote_i2c0: i2c@0 {
+ reg = <0>;
+ #address-cells = <1>;
+ #size-cells = <0>;
+
+ sensor_0@1a {
+ compatible = "sony,imx274";
+ reg = <0x1a>;
+
+ reset-gpios = <&des0_ser0 1 GPIO_ACTIVE_LOW>;
+
+ port {
+ sensor_0_out: endpoint {
+ remote-endpoint = <&ds90ub954_fpd3_in0>;
+ };
+ };
+ };
+ };
+ };
+ };
+ };
+
+...
diff --git a/MAINTAINERS b/MAINTAINERS
index 4429ce035496..f0156062f788 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -19097,6 +19097,12 @@ S: Maintained
F: Documentation/devicetree/bindings/media/i2c/ti,ds90ub953-q1.yaml
F: include/dt-bindings/media/ds90ub953.h
+TEXAS INSTRUMENTS DS90UB954 VIDEO DESERIALIZER DRIVER
+M: Luca Ceresoli <luca@...aceresoli.net>
+L: linux-media@...r.kernel.org
+S: Maintained
+F: Documentation/devicetree/bindings/media/i2c/ti,ds90ub954-q1.yaml
+
TEXAS INSTRUMENTS' SYSTEM CONTROL INTERFACE (TISCI) PROTOCOL DRIVER
M: Nishanth Menon <nm@...com>
M: Tero Kristo <kristo@...nel.org>
--
2.25.1
Powered by blists - more mailing lists