Re: [PATCH V4 2/3] dt-bindings: input: Add document bindings for DA7280

[Pavel Machek <pavel@ucw.cz>]

[-- Attachment #1: Type: text/plain, Size: 2812 bytes --]

Hi!

> +++ b/Documentation/devicetree/bindings/input/dlg,da7280.txt
> @@ -0,0 +1,101 @@
> +Dialog Semiconductor DA7280 Haptics bindings
> +
> +Required properties:
> +- compatible: Should be "dlg,da7280".
> +- reg: Specifies the I2C slave address.
> +
> +- interrupt-parent : Specifies the phandle of the interrupt controller to
> +  which the IRQs from DA7280 are delivered to.
> +
> +- dlg,vib-mode:
> +  "LRA-MODE" - Linear Resonance Actuator mode.
> +  "ERM-BAR" - Bar type Eccentric Rotating Mass mode.
> +  "ERM-COIN" - Coin type Eccentric Rotating Mass mode.

So this is some kind of "vibration motor" on steroids)?

> +- dlg,op-mode: Haptic operation mode.
> +  Possible values:
> +	1 - Direct register override mode triggered by i2c(default),
> +	2 - PWM data source mode setting duty to 0 - 0xffff(0% - 100%),

Space after 0xffff?

> +	3 - Register triggered waveform memory mode, the pattern assigned
> +	    to the PS_SEQ_ID played as much times as PS_SEQ_LOOP,
> +	4 - Edge triggered waveform memory mode, external GPI(N) condtrol

"control"

> +	    are required to enable/disable and it needs to keep
> +	    device enabled by sending magnitude (X > 0),
> +	    the pattern is assigned to the GPI(N)_SEQUENCE_ID below

"below."

> +- dlg,imax-microamp: Actuator max current rating.
> +  Valid values: 0 - 252000.
> +  Default: 130000.
> +- dlg,impd-micro-ohms: the impedance of the actuator in micro ohm,

"ohms"

> +  as read from its datasheet.

"as read" does not sound english.

> +- dlg,mem-array: use in case that memory registers should be updated,
> +  Please fill the whole buffers(100 bytes) to avoid any error in driver.
> +  For example,
> +	dlg,mem-array = <
> +		0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A
> +		...
> +		0x71 0x72 0x73 0x74 0x75 0x76 0x77 0x78 0x79 0x7A
> +		0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
> +		0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
> +	>;

I'd not understand what this is from this description. (And I'd put
example below... in the exampls section).


> +For further information, see device datasheet.
> +
> +======
> +
> +Example:
> +
> +	haptics: da7280-haptics@4a {
> +		compatible = "dlg,da7280";
> +		reg = <0x4a>;
> +		interrupt-parent = <&gpio6>;
> +		interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
> +		dlg,vib-mode = "LRA-MODE";
> +		dlg,op-mode = <1>;
> +		dlg,nom-microvolt = <2000000>;
> +		dlg,abs-max-microvolt = <2000000>;
> +		dlg,imax-microamp = <170000>;
> +		dlg,resonant-freq-hz = <180>;
> +		dlg,impd-micro-ohms = <10500000>;
> +		dlg,freq-track-enable;
> +		dlg,rapid-stop-enable;
> +	};

-- 
(english) http://www.livejournal.com/~pavelmachek
(cesky, pictures) http://atrey.karlin.mff.cuni.cz/~pavel/picture/horses/blog.html

[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 181 bytes --]