Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

iio: counter: Add deprecation markings for IIO Counter attributes

The IIO counter subdirectory is now superceded by the Counter subsystem.
This patch adds deprecation warnings to the documentation of the
relevant IIO Counter sysfs attributes.

Acked-by: Jonathan Cameron <Jonathan.Cameron@huawei.com>
Signed-off-by: William Breathitt Gray <vilhelm.gray@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

William Breathitt Gray and committed by
Greg Kroah-Hartman
4bb00e93 7657b2c1

+24
+8
Documentation/ABI/testing/sysfs-bus-iio
··· 1656 1656 KernelVersion: 4.10 1657 1657 Contact: linux-iio@vger.kernel.org 1658 1658 Description: 1659 + This interface is deprecated; please use the Counter subsystem. 1660 + 1659 1661 Raw counter device counts from channel Y. For quadrature 1660 1662 counters, multiplication by an available [Y]_scale results in 1661 1663 the counts of a single quadrature signal phase from channel Y. ··· 1666 1664 KernelVersion: 4.10 1667 1665 Contact: linux-iio@vger.kernel.org 1668 1666 Description: 1667 + This interface is deprecated; please use the Counter subsystem. 1668 + 1669 1669 Raw counter device index value from channel Y. This attribute 1670 1670 provides an absolute positional reference (e.g. a pulse once per 1671 1671 revolution) which may be used to home positional systems as ··· 1677 1673 KernelVersion: 4.12 1678 1674 Contact: linux-iio@vger.kernel.org 1679 1675 Description: 1676 + This interface is deprecated; please use the Counter subsystem. 1677 + 1680 1678 A list of possible counting directions which are: 1681 1679 - "up" : counter device is increasing. 1682 1680 - "down": counter device is decreasing. ··· 1687 1681 KernelVersion: 4.12 1688 1682 Contact: linux-iio@vger.kernel.org 1689 1683 Description: 1684 + This interface is deprecated; please use the Counter subsystem. 1685 + 1690 1686 Raw counter device counters direction for channel Y. 1691 1687 1692 1688 What: /sys/bus/iio/devices/iio:deviceX/in_phaseY_raw
+16
Documentation/ABI/testing/sysfs-bus-iio-counter-104-quad-8
··· 6 6 KernelVersion: 4.10 7 7 Contact: linux-iio@vger.kernel.org 8 8 Description: 9 + This interface is deprecated; please use the Counter subsystem. 10 + 9 11 Discrete set of available values for the respective counter 10 12 configuration are listed in this file. 11 13 ··· 15 13 KernelVersion: 4.10 16 14 Contact: linux-iio@vger.kernel.org 17 15 Description: 16 + This interface is deprecated; please use the Counter subsystem. 17 + 18 18 Count mode for channel Y. Four count modes are available: 19 19 normal, range limit, non-recycle, and modulo-n. The preset value 20 20 for channel Y is used by the count mode where required. ··· 51 47 KernelVersion: 4.10 52 48 Contact: linux-iio@vger.kernel.org 53 49 Description: 50 + This interface is deprecated; please use the Counter subsystem. 51 + 54 52 Read-only attribute that indicates whether excessive noise is 55 53 present at the channel Y count inputs in quadrature clock mode; 56 54 irrelevant in non-quadrature clock mode. ··· 61 55 KernelVersion: 4.10 62 56 Contact: linux-iio@vger.kernel.org 63 57 Description: 58 + This interface is deprecated; please use the Counter subsystem. 59 + 64 60 If the counter device supports preset registers, the preset 65 61 count for channel Y is provided by this attribute. 66 62 ··· 70 62 KernelVersion: 4.10 71 63 Contact: linux-iio@vger.kernel.org 72 64 Description: 65 + This interface is deprecated; please use the Counter subsystem. 66 + 73 67 Configure channel Y counter for non-quadrature or quadrature 74 68 clock mode. Selecting non-quadrature clock mode will disable 75 69 synchronous load mode. In quadrature clock mode, the channel Y ··· 93 83 KernelVersion: 4.10 94 84 Contact: linux-iio@vger.kernel.org 95 85 Description: 86 + This interface is deprecated; please use the Counter subsystem. 87 + 96 88 Whether to set channel Y counter with channel Y preset value 97 89 when channel Y index input is active, or continuously count. 98 90 Valid attribute values are boolean. ··· 103 91 KernelVersion: 4.10 104 92 Contact: linux-iio@vger.kernel.org 105 93 Description: 94 + This interface is deprecated; please use the Counter subsystem. 95 + 106 96 Active level of channel Y index input; irrelevant in 107 97 non-synchronous load mode. 108 98 ··· 112 98 KernelVersion: 4.10 113 99 Contact: linux-iio@vger.kernel.org 114 100 Description: 101 + This interface is deprecated; please use the Counter subsystem. 102 + 115 103 Configure channel Y counter for non-synchronous or synchronous 116 104 load mode. Synchronous load mode cannot be selected in 117 105 non-quadrature clock mode.