From abe30a288d8b4689bd0d4e85714dc39db413ea9e Mon Sep 17 00:00:00 2001 From: Jean Delvare Date: Sun, 14 Oct 2007 09:35:51 +0000 Subject: [PATCH] Add a description of the package, together with installation instructions. git-svn-id: http://lm-sensors.org/svn/i2c-tools/trunk@4945 7894878c-1315-0410-8ee3-d5d059ff63e0 --- README | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 README diff --git a/README b/README new file mode 100644 index 0000000..ee118f4 --- /dev/null +++ b/README @@ -0,0 +1,57 @@ +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. + +* 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.