		 2
		I C-Bus interface for Linux

This is version 0.5 of the i2c-bus interface device driver.
It is, in short, an adapter to a 2-wire serial bus for a series of speccial 
integrated circuits, including microcontrollers and consumer electronics
circuits, but also general purpose devices like ad/da-converters and switches.
For a detailed survey, have a look into the doc directory, or at one of the
FAQs on the net (like Victor Himpe's: http://www.ping.be/~ping0751).


Installation:
-------------
The driver is configured to use major 89, so you should create the following
entry|~ies in your /dev/ directory:
	crw-rw-rw-   1 i2c      i2c       89,   0 Oct 25 21:53 /dev/i2c0
	crw-rw-rw-   1 i2c      i2c       89,   1 Oct 25 21:53 /dev/i2c1
	crw-rw-rw-   1 i2c      i2c       89,   2 Oct 25 21:53 /dev/i2c2
To do this, type 
	mknod  /dev/i2c0 c 89 0
Change the permissions & user to the needs of your system (mine is not on a 
network, so anyone may). The number of devices will depend on how many
adapters you are having, but this will normally be only one.

Then enter the mod/ directory, edit the Makefile: choose the type(s) of
hardware adapter(s) you want to access with the driver, and configure the
device settings for the individual minors in i2c-main.c.

After that you are ready to say 'make' to compile the kernel module, and
'make run' will load the module into the kernel. Alternatively you could
also say 'insmod i2c.o'.


Docs
----
Included with the driver are - as stated above - TeX documentation files,
which were initially written as a part of my computer science studies, but
which will be maintained and expanded in the future (when I will have some
spare time, so possibly around the next millenium ;).


Sample Code
-----------
Also, some sample applications, which use the Tcl/Tk package written by John
Ousterhout (versions 7.3 / 3.6 ). 

The videotext decoder in  the directory vtex currently can only be started in 
this directory. If you want to install in in another directory, you will
have to change the value for vtex(prefix) in the procedure initVars in the
file vt.tcl .  Also, the path to ish in the first line of vt will have to be
changed.

The same applies to the file mem/mem, which is a simple interface to a 256 byte 
EEPROM chip.


Copyright, WARNING
------------------
The whole package may be freely distrubuted and/or modified under the terms
of the GNU General Public License, Version 2, which is included in the file
COPYING. You may also feel free to send me any amount of comments,
modifications, improvements or beer (or single malt whisky if you like ;-).

Also, you should take care when hacking hardware, especially when opening
TV sets, and the like. You should really know what you are doing, as I
cannot guarantee the correctness of the presented schematics (although they
work fine in my environment).

Therefore: _BE CAREFUL_ - you should know what you are doing beforehand, so
don't claim me.

Contact
-------

You can reach me at	simon@tk.uni-linz.ac.at or at
Or write by mail to 
	Simon G. Vogl
	Breitwiesergutstr. 50
	A-4020 Linz
	Austria
