summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README61
1 files changed, 61 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..700bf88
--- /dev/null
+++ b/README
@@ -0,0 +1,61 @@
+I2C TOOLS FOR LINUX
+===================
+
+This package contains an heterogeneous set of I2C tools for Linux. These tools
+were originally part of the lm-sensors package but were finally split into
+their own package for convenience.
+
+
+CONTENTS
+--------
+
+The various tools included in this package are grouped by category, each
+category has its own sub-directory:
+
+* eeprom
+ Perl scripts for decoding different types of EEPROMs (SPD, EDID...) These
+ scripts rely on the "eeprom" kernel driver. They are installed by default.
+
+* eepromer
+ Tools for writing to EEPROMs. These tools rely on the "i2c-dev" kernel
+ driver. They are not installed by default.
+
+* include
+ C/C++ header files for I2C and SMBus access over i2c-dev. Installed by
+ default.
+
+* py-smbus
+ Python wrapper for SMBus access over i2c-dev. Not installed by default.
+
+* stub
+ A helper script to use with the i2c-stub kernel driver. Installed by
+ default.
+
+* tools
+ I2C device detection and register dump tools. These tools rely on the
+ "i2c-dev" kernel driver. They are installed by default.
+
+
+INSTALLATION
+------------
+
+There's no configure script, so simply run "make" to build the tools, and
+"make install" to install them. You also can use "make uninstall" to remove
+all the files you installed. By default, files are installed in /usr/local
+but you can change this behavior by editing the Makefile file and setting
+prefix to wherever you want. You may change the C compiler and the
+compilation flags as well.
+
+Optionally, you can run "make strip" prior to "make install" if you want
+smaller binaries. However, be aware that this will prevent any further
+attempt to debug the programs.
+
+
+DOCUMENTATION
+-------------
+
+The main tools have manual pages, which are installed by "make install".
+See these manual pages for command line interface details and tool specific
+information.
+
+The other tools come with simple text documentation, which isn't installed.