xref: /linux/Documentation/ABI/testing/sysfs-bus-iio-sx9324 (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
14c18a890SGwendal GrignouWhat:		/sys/bus/iio/devices/iio:deviceX/in_proximity<id>_setup
24c18a890SGwendal GrignouDate:		November 2021
34c18a890SGwendal GrignouKernelVersion:	5.17
44c18a890SGwendal GrignouContact:	Gwendal Grignou <gwendal@chromium.org>
54c18a890SGwendal GrignouDescription:
64c18a890SGwendal Grignou		SX9324 has 3 inputs, CS0, CS1 and CS2. Hardware layout
74c18a890SGwendal Grignou		defines if the input is
8*7aa68dccSAkira Yokosawa
94c18a890SGwendal Grignou		+ not connected (HZ),
104c18a890SGwendal Grignou		+ grounded (GD),
114c18a890SGwendal Grignou		+ connected to an antenna where it can act as a base
124c18a890SGwendal Grignou		  (DS - data shield), or measured input (MI).
134c18a890SGwendal Grignou
144c18a890SGwendal Grignou		The sensor rotates measurement across 4 phases
154c18a890SGwendal Grignou		(PH0, PH1, PH2, PH3), where the inputs are configured
164c18a890SGwendal Grignou		and then measured.
174c18a890SGwendal Grignou
184c18a890SGwendal Grignou		By default,  during the first phase, [PH0], CS0 is measured,
194c18a890SGwendal Grignou		while CS1 and CS2 are used as shields.
204c18a890SGwendal Grignou		`cat in_proximity0_setup` returns "MI,DS,DS".
214c18a890SGwendal Grignou		[PH1], CS1 is measured, CS0 and CS2 are shield:
224c18a890SGwendal Grignou		`cat in_proximity1_setup` returns "DS,MI,DS".
234c18a890SGwendal Grignou		[PH2], CS2 is measured, CS0 and CS1 are shield:
244c18a890SGwendal Grignou		`cat in_proximity1_setup` returns "DS,DS,MI".
254c18a890SGwendal Grignou		[PH3], CS1 and CS2 are measured (combo mode):
264c18a890SGwendal Grignou		`cat in_proximity1_setup` returns "DS,MI,MI".
274c18a890SGwendal Grignou
284c18a890SGwendal Grignou		Note, these are the chip default. Hardware layout will most
294c18a890SGwendal Grignou		likely dictate different output. The entry is read-only.
30