| I2C TOOLS FOR LINUX |
| =================== |
| |
| This package contains an heterogeneous set of I2C tools for the Linux kernel. |
| These tools were originally part of the lm-sensors project but were finally |
| split into their own package for convenience. They compile, run and have been |
| tested on GNU/Linux. |
| |
| |
| 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. |
| |
| If you wish to include sub-directories that are not enabled by default, then |
| just set them via the EXTRA make variable. For example, to build py-smbus, |
| do: |
| $ make EXTRA="py-smbus" |
| |
| |
| 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. |
| |
| |
| QUESTIONS AND BUG REPORTS |
| ------------------------- |
| |
| Please post your questions and bug reports to the linux-i2c mailing list: |
| linux-i2c@vger.kernel.org |
| For additional information about this list, see: |
| http://vger.kernel.org/vger-lists.html#linux-i2c |
