On Thu, May 29, 2014 at 09:04:33PM +0200, Stephen Warren wrote:

On 05/28/2014 06:54 AM, Peter De Schrijver wrote:

quoted

Implement fuse driver for Tegra20, Tegra30, Tegra114 and Tegra124.

quoted

diff --git a/Documentation/ABI/testing/sysfs-driver-tegra-fuse b/Documentation/ABI/testing/sysfs-driver-tegra-fuse

quoted

+Description:	read-only access to the efuses on Tegra20, Tegra30, Tegra114
+		and Tegra124 SoC's from NVIDIA. The efuses contain write once
+		data programmed at the factory. The data is layed out in 32bit
+		words in LSB first formnat. The number of valid bits depends

s/formnat/format/

quoted

+		on the word and the SoC. The mapping is as follows:
+
+		For Tegra20:
+		Word 0 - 1    : bit 0
+		Word 2        : unused
+		Word 3        : bits 0 - 31
+		Word 4        : bits 0 - 7

Do we really need these long tables that indicate which bits are used?
As I mentioned before, when I asked for documentation of the format of
these files, all I wanted was a brief not indicating that the data was
binary, and that each bit potentially represents a fuse... Either we
should leave it at that, or actually document what each bit represents,
which would hopefully be a pointless duplication of the TRM.

Some fuses are OEM defined, so there is no way to document all fuses there.
Would you be ok with just dropping the tables then? So, the description would
become:

Description:    read-only access to the efuses on Tegra20, Tegra30, Tegra114
                and Tegra124 SoC's from NVIDIA. The efuses contain write once
                data programmed at the factory. The data is layed out in 32bit
                words in LSB first format. The number of valid bits depends
                on the word and the SoC.

Cheers,

Peter.