Greg Kroah-Hartman
598cf27219
Link: https://lore.kernel.org/r/20260217200002.683975158@linuxfoundation.org Tested-by: Florian Fainelli <florian.fainelli@broadcom.com> Tested-by: Takeshi Ogasawara <takeshi.ogasawara@futuring-girl.com> Tested-by: Peter Schneider <pschneider1968@googlemail.com> Tested-by: Jon Hunter <jonathanh@nvidia.com> Tested-by: Salvatore Bonaccorso <carnil@debian.org> Tested-by: Brett A C Sheffield <bacs@librecast.net> Tested-by: Mark Brown <broonie@kernel.org> Tested-by: Luna Jernberg <droidbittin@gmail.com> Tested-by: Ronald Warsow <rwarsow@gmx.de> Tested-by: Justin M. Forbes <jforbes@fedoraproject.org> Tested-by: Ron Economos <re@w6rz.net> Tested-by: Miguel Ojeda <ojeda@kernel.org> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
60 lines
1.8 KiB
ReStructuredText
60 lines
1.8 KiB
ReStructuredText
=======================
|
|
Kernel driver w1_ds2413
|
|
=======================
|
|
|
|
Supported chips:
|
|
|
|
* Maxim DS2413 1-Wire Dual Channel Addressable Switch
|
|
|
|
supported family codes:
|
|
|
|
================ ====
|
|
W1_FAMILY_DS2413 0x3A
|
|
================ ====
|
|
|
|
Author: Mariusz Bialonczyk <manio@skyboo.net>
|
|
|
|
Description
|
|
-----------
|
|
|
|
The DS2413 chip has two open-drain outputs (PIO A and PIO B).
|
|
Support is provided through the sysfs files "output" and "state".
|
|
|
|
Reading state
|
|
-------------
|
|
The "state" file provides one-byte value which is in the same format as for
|
|
the chip PIO_ACCESS_READ command (refer the datasheet for details):
|
|
|
|
======== =============================================================
|
|
Bit 0: PIOA Pin State
|
|
Bit 1: PIOA Output Latch State
|
|
Bit 2: PIOB Pin State
|
|
Bit 3: PIOB Output Latch State
|
|
Bit 4-7: Complement of Bit 3 to Bit 0 (verified by the kernel module)
|
|
======== =============================================================
|
|
|
|
This file is readonly.
|
|
|
|
Writing output
|
|
--------------
|
|
You can set the PIO pins using the "output" file.
|
|
It is writable, you can write one-byte value to this sysfs file.
|
|
Similarly the byte format is the same as for the PIO_ACCESS_WRITE command:
|
|
|
|
======== ======================================
|
|
Bit 0: PIOA
|
|
Bit 1: PIOB
|
|
Bit 2-7: No matter (driver will set it to "1"s)
|
|
======== ======================================
|
|
|
|
|
|
The chip has some kind of basic protection against transmission errors.
|
|
When reading the state, there is a four complement bits.
|
|
The driver is checking this complement, and when it is wrong then it is
|
|
returning I/O error.
|
|
|
|
When writing output, the master must repeat the PIO Output Data byte in
|
|
its inverted form and it is waiting for a confirmation.
|
|
If the write is unsuccessful for three times, the write also returns
|
|
I/O error.
|