diff mbox series

[v7,4/7] dt-bindings: media: max9286: Document 'maxim,reverse-channel-microvolt'

Message ID 20210113185506.119808-5-jacopo+renesas@jmondi.org
State Superseded
Headers show
Series None | expand

Commit Message

Jacopo Mondi Jan. 13, 2021, 6:55 p.m. UTC 
Document the 'reverse-channel-microvolt' vendor property in the
bindings document of the max9286 driver.

The newly introduced property allows to specifying the initial
configuration of the GMSL reverse control channel to accommodate
remote serializers pre-programmed with the high threshold power
supply noise immunity enabled.

Reviewed-by: Rob Herring <robh@kernel.org>
Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Kieran Bingham <kieran.bingham+renesas@ideasonboard.com>
Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org>
---
 .../bindings/media/i2c/maxim,max9286.yaml     | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

Comments

Sergei Shtylyov Jan. 14, 2021, 8:20 a.m. UTC | #1 
Hello!

On 13.01.2021 21:55, Jacopo Mondi wrote:

> Document the 'reverse-channel-microvolt' vendor property in the


    Where is "maxim,"?

> bindings document of the max9286 driver.

> 

> The newly introduced property allows to specifying the initial


    Specify?

> configuration of the GMSL reverse control channel to accommodate

> remote serializers pre-programmed with the high threshold power

> supply noise immunity enabled.

> 

> Reviewed-by: Rob Herring <robh@kernel.org>

> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

> Reviewed-by: Kieran Bingham <kieran.bingham+renesas@ideasonboard.com>

> Signed-off-by: Jacopo Mondi <jacopo+renesas@jmondi.org>

[...]

MBR, Sergei
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/media/i2c/maxim,max9286.yaml b/Documentation/devicetree/bindings/media/i2c/maxim,max9286.yaml
index 68ee8c7d9e79..1406236e37ef 100644
--- a/Documentation/devicetree/bindings/media/i2c/maxim,max9286.yaml
+++ b/Documentation/devicetree/bindings/media/i2c/maxim,max9286.yaml
@@ -50,6 +50,26 @@  properties:
   '#gpio-cells':
     const: 2
 
+  maxim,reverse-channel-microvolt:
+    minimum: 30000
+    maximum: 200000
+    default: 170000
+    description: |
+      Initial amplitude of the reverse control channel, in micro volts.
+
+      The initial amplitude shall be adjusted to a value compatible with the
+      configuration of the connected remote serializer.
+
+      Some camera modules (for example RDACM20) include an on-board MCU that
+      pre-programs the embedded serializer with power supply noise immunity
+      (high-threshold) enabled. A typical value of the deserializer's reverse
+      channel amplitude to communicate with pre-programmed serializers is
+      170000 micro volts.
+
+      A typical value for the reverse channel amplitude to communicate with
+      a remote serializer whose high-threshold noise immunity is not enabled
+      is 100000 micro volts
+
   ports:
     type: object
     description: |
@@ -242,6 +262,8 @@  examples:
         gpio-controller;
         #gpio-cells = <2>;
 
+        maxim,reverse-channel-microvolt = <170000>;
+
         ports {
           #address-cells = <1>;
           #size-cells = <0>;