Linux 2.6.16
[linux-2.6] / include / asm-powerpc / pmac_low_i2c.h
1 /* 
2  *  include/asm-ppc/pmac_low_i2c.h
3  *
4  *  Copyright (C) 2003 Ben. Herrenschmidt (benh@kernel.crashing.org)
5  *
6  *  This program is free software; you can redistribute it and/or
7  *  modify it under the terms of the GNU General Public License
8  *  as published by the Free Software Foundation; either version
9  *  2 of the License, or (at your option) any later version.
10  *
11  */
12 #ifndef __PMAC_LOW_I2C_H__
13 #define __PMAC_LOW_I2C_H__
14 #ifdef __KERNEL__
15
16 /* i2c mode (based on the platform functions format) */
17 enum {
18         pmac_i2c_mode_dumb      = 1,
19         pmac_i2c_mode_std       = 2,
20         pmac_i2c_mode_stdsub    = 3,
21         pmac_i2c_mode_combined  = 4,
22 };
23
24 /* RW bit in address */
25 enum {
26         pmac_i2c_read           = 0x01,
27         pmac_i2c_write          = 0x00
28 };
29
30 /* i2c bus type */
31 enum {
32         pmac_i2c_bus_keywest    = 0,
33         pmac_i2c_bus_pmu        = 1,
34         pmac_i2c_bus_smu        = 2,
35 };
36
37 /* i2c bus features */
38 enum {
39         /* can_largesub : supports >1 byte subaddresses (SMU only) */
40         pmac_i2c_can_largesub   = 0x00000001u,
41
42         /* multibus : device node holds multiple busses, bus number is
43          * encoded in bits 0xff00 of "reg" of a given device
44          */
45         pmac_i2c_multibus       = 0x00000002u,
46 };
47
48 /* i2c busses in the system */
49 struct pmac_i2c_bus;
50 struct i2c_adapter;
51
52 /* Init, called early during boot */
53 extern int pmac_i2c_init(void);
54
55 /* Lookup an i2c bus for a device-node. The node can be either the bus
56  * node itself or a device below it. In the case of a multibus, the bus
57  * node itself is the controller node, else, it's a child of the controller
58  * node
59  */
60 extern struct pmac_i2c_bus *pmac_i2c_find_bus(struct device_node *node);
61
62 /* Get the address for an i2c device. This strips the bus number if
63  * necessary. The 7 bits address is returned 1 bit right shifted so that the
64  * direction can be directly ored in
65  */
66 extern u8 pmac_i2c_get_dev_addr(struct device_node *device);
67
68 /* Get infos about a bus */
69 extern struct device_node *pmac_i2c_get_controller(struct pmac_i2c_bus *bus);
70 extern struct device_node *pmac_i2c_get_bus_node(struct pmac_i2c_bus *bus);
71 extern int pmac_i2c_get_type(struct pmac_i2c_bus *bus);
72 extern int pmac_i2c_get_flags(struct pmac_i2c_bus *bus);
73 extern int pmac_i2c_get_channel(struct pmac_i2c_bus *bus);
74
75 /* i2c layer adapter attach/detach */
76 extern void pmac_i2c_attach_adapter(struct pmac_i2c_bus *bus,
77                                     struct i2c_adapter *adapter);
78 extern void pmac_i2c_detach_adapter(struct pmac_i2c_bus *bus,
79                                     struct i2c_adapter *adapter);
80 extern struct i2c_adapter *pmac_i2c_get_adapter(struct pmac_i2c_bus *bus);
81 extern struct pmac_i2c_bus *pmac_i2c_adapter_to_bus(struct i2c_adapter *adapter);
82
83 /* March a device or bus with an i2c adapter structure, to be used by drivers
84  * to match device-tree nodes with i2c adapters during adapter discovery
85  * callbacks
86  */
87 extern int pmac_i2c_match_adapter(struct device_node *dev,
88                                   struct i2c_adapter *adapter);
89
90
91 /* (legacy) Locking functions exposed to i2c-keywest */
92 extern int pmac_low_i2c_lock(struct device_node *np);
93 extern int pmac_low_i2c_unlock(struct device_node *np);
94
95 /* Access functions for platform code */
96 extern int pmac_i2c_open(struct pmac_i2c_bus *bus, int polled);
97 extern void pmac_i2c_close(struct pmac_i2c_bus *bus);
98 extern int pmac_i2c_setmode(struct pmac_i2c_bus *bus, int mode);
99 extern int pmac_i2c_xfer(struct pmac_i2c_bus *bus, u8 addrdir, int subsize,
100                          u32 subaddr, u8 *data,  int len);
101
102 /* Suspend/resume code called by via-pmu directly for now */
103 extern void pmac_pfunc_i2c_suspend(void);
104 extern void pmac_pfunc_i2c_resume(void);
105
106 #endif /* __KERNEL__ */
107 #endif /* __PMAC_LOW_I2C_H__ */