On Sun, Apr 08, 2018 at 05:50:31PM +0100, Jonathan Cameron wrote: > On Tue, 3 Apr 2018 17:36:34 +0200 > Peter Rosin <peda@xxxxxxxxxx> wrote: > > circuit in the patch title is spelled wrong. > > > An ADC is often used to measure other quantities indirectly. These > > bindings describe two cases, a current through a sense resistor, and > > a "big" voltage measured with the help of a voltage divider. > > > > Signed-off-by: Peter Rosin <peda@xxxxxxxxxx> > > Will definitely be wanting wide opinions on this one - Rob in particularly > for the binding side. > > One comment inline. What we have here is nice and generic, but is > it what would be 'expected' for current sense circuit? Should we > also be more specific in the naming. There are lots of options for > current sense circuits and this is just the simplest (current loop > for example). > > One option would be to use current-sense-shunt perhaps? > > https://en.wikipedia.org/wiki/Current_sensing_techniques > Gives a few that I didn't think of beyond current loops etc. > > > > --- > > .../bindings/iio/afe/current-sense-circuit.txt | 45 ++++++++++++++++++++++ > > .../bindings/iio/afe/voltage-divider.txt | 45 ++++++++++++++++++++++ > > MAINTAINERS | 7 ++++ > > 3 files changed, 97 insertions(+) > > create mode 100644 Documentation/devicetree/bindings/iio/afe/current-sense-circuit.txt > > create mode 100644 Documentation/devicetree/bindings/iio/afe/voltage-divider.txt > > > > diff --git a/Documentation/devicetree/bindings/iio/afe/current-sense-circuit.txt b/Documentation/devicetree/bindings/iio/afe/current-sense-circuit.txt > > new file mode 100644 > > index 000000000000..0bc7d89387c0 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/iio/afe/current-sense-circuit.txt > > @@ -0,0 +1,45 @@ > > +Current Sense Curcuit > > +===================== > > + > > +When an io-channel measures the voltage over a current sense resistor, > > +the interesting mesaurement is often the current through the resistor, > > +not the voltage over it. This binding describes such a current sense > > +curcuit. > > + > > +Required properties: > > +- compatible : "current-sense-circuit" > > +- io-channels : Channel node of a voltage io-channel. > > + > > +Optional properties: > > +- numerator : The io-channel scale is multiplied by this value (default 1). > > +- denominator : The io-channel scale is divided by this value (default 1). > > + > > +Example: > > +The system current is measured by measuring the voltage over a > > +3.3 ohms sense resistor. > > Hmm. It sort of feels like the binding doesn't really reflect the > hardware as directly as it might. Should we be explicitly having the > resistance in this case? (with some more mapping logic needed in the > driver to figure out the scaling this causes). I think having the resistance would be better as least in this case. For other cases like voltage dividers I'm not sure though. Those would be different compatibles so the associated properties don't necessarily need to be the same. Rob -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
