^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/bus/siox/devices/siox-X/active
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) On reading represents the current state of the bus. If it
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) contains a "0" the bus is stopped and connected devices are
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) expected to not do anything because their watchdog triggered.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) When the file contains a "1" the bus is operated and periodically
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) does a push-pull cycle to write and read data from the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) connected devices.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) When writing a "0" or "1" the bus moves to the described state.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) What: /sys/bus/siox/devices/siox-X/device_add
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Write-only file. Write
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) <type> <inbytes> <outbytes> <statustype>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) to add a new device dynamically. <type> is the name that is used to match
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) to a driver (similar to the platform bus). <inbytes> and <outbytes> define
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) the length of the input and output shift register in bytes respectively.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) <statustype> defines the 4 bit device type that is check to identify connection
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) problems.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) The new device is added to the end of the existing chain.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) What: /sys/bus/siox/devices/siox-X/device_remove
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Write-only file. A single write removes the last device in the siox chain.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) What: /sys/bus/siox/devices/siox-X/poll_interval_ns
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) Defines the interval between two poll cycles in nano seconds.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) Note this is rounded to jiffies on writing. On reading the current value
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) is returned.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) What: /sys/bus/siox/devices/siox-X-Y/connected
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) Read-only value. "0" means the Yth device on siox bus X isn't "connected" i.e.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) communication with it is not ensured. "1" signals a working connection.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) What: /sys/bus/siox/devices/siox-X-Y/inbytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) Read-only value reporting the inbytes value provided to siox-X/device_add
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) What: /sys/bus/siox/devices/siox-X-Y/status_errors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) Counts the number of time intervals when the read status byte doesn't yield the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63) expected value.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) What: /sys/bus/siox/devices/siox-X-Y/type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Read-only value reporting the type value provided to siox-X/device_add.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) What: /sys/bus/siox/devices/siox-X-Y/watchdog
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) Read-only value reporting if the watchdog of the siox device is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) active. "0" means the watchdog is not active and the device is expected to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77) be operational. "1" means the watchdog keeps the device in reset.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) What: /sys/bus/siox/devices/siox-X-Y/watchdog_errors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) Read-only value reporting the number to time intervals when the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) watchdog was active.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) What: /sys/bus/siox/devices/siox-X-Y/outbytes
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) KernelVersion: 4.16
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) Contact: Thorsten Scherer <t.scherer@eckelmann.de>, Uwe Kleine-König <u.kleine-koenig@pengutronix.de>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90) Read-only value reporting the outbytes value provided to siox-X/device_add.