documentation: convert the Documentation directory to UTF-8
[sfrench/cifs-2.6.git] / Documentation / i2c / busses / i2c-ocores
1 Kernel driver i2c-ocores
2
3 Supported adapters:
4   * OpenCores.org I2C controller by Richard Herveille (see datasheet link)
5     Datasheet: http://www.opencores.org/projects.cgi/web/i2c/overview
6
7 Author: Peter Korsgaard <jacmet@sunsite.dk>
8
9 Description
10 -----------
11
12 i2c-ocores is an i2c bus driver for the OpenCores.org I2C controller
13 IP core by Richard Herveille.
14
15 Usage
16 -----
17
18 i2c-ocores uses the platform bus, so you need to provide a struct
19 platform_device with the base address and interrupt number. The
20 dev.platform_data of the device should also point to a struct
21 ocores_i2c_platform_data (see linux/i2c-ocores.h) describing the
22 distance between registers and the input clock speed.
23
24 E.G. something like:
25
26 static struct resource ocores_resources[] = {
27         [0] = {
28                 .start  = MYI2C_BASEADDR,
29                 .end    = MYI2C_BASEADDR + 8,
30                 .flags  = IORESOURCE_MEM,
31         },
32         [1] = {
33                 .start  = MYI2C_IRQ,
34                 .end    = MYI2C_IRQ,
35                 .flags  = IORESOURCE_IRQ,
36         },
37 };
38
39 static struct ocores_i2c_platform_data myi2c_data = {
40         .regstep        = 2,            /* two bytes between registers */
41         .clock_khz      = 50000,        /* input clock of 50MHz */
42 };
43
44 static struct platform_device myi2c = {
45         .name                   = "ocores-i2c",
46         .dev = {
47                 .platform_data  = &myi2c_data,
48         },
49         .num_resources          = ARRAY_SIZE(ocores_resources),
50         .resource               = ocores_resources,
51 };