xref: /openbmc/linux/drivers/i2c/busses/i2c-parport.c (revision 22246614)
1 /* ------------------------------------------------------------------------ *
2  * i2c-parport.c I2C bus over parallel port                                 *
3  * ------------------------------------------------------------------------ *
4    Copyright (C) 2003-2007 Jean Delvare <khali@linux-fr.org>
5 
6    Based on older i2c-philips-par.c driver
7    Copyright (C) 1995-2000 Simon G. Vogl
8    With some changes from:
9    Frodo Looijaard <frodol@dds.nl>
10    Kyösti Mälkki <kmalkki@cc.hut.fi>
11 
12    This program is free software; you can redistribute it and/or modify
13    it under the terms of the GNU General Public License as published by
14    the Free Software Foundation; either version 2 of the License, or
15    (at your option) any later version.
16 
17    This program is distributed in the hope that it will be useful,
18    but WITHOUT ANY WARRANTY; without even the implied warranty of
19    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20    GNU General Public License for more details.
21 
22    You should have received a copy of the GNU General Public License
23    along with this program; if not, write to the Free Software
24    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
25  * ------------------------------------------------------------------------ */
26 
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/init.h>
30 #include <linux/parport.h>
31 #include <linux/i2c.h>
32 #include <linux/i2c-algo-bit.h>
33 #include "i2c-parport.h"
34 
35 /* ----- Device list ------------------------------------------------------ */
36 
37 struct i2c_par {
38 	struct pardevice *pdev;
39 	struct i2c_adapter adapter;
40 	struct i2c_algo_bit_data algo_data;
41 	struct i2c_par *next;
42 };
43 
44 static struct i2c_par *adapter_list;
45 
46 /* ----- Low-level parallel port access ----------------------------------- */
47 
48 static void port_write_data(struct parport *p, unsigned char d)
49 {
50 	parport_write_data(p, d);
51 }
52 
53 static void port_write_control(struct parport *p, unsigned char d)
54 {
55 	parport_write_control(p, d);
56 }
57 
58 static unsigned char port_read_data(struct parport *p)
59 {
60 	return parport_read_data(p);
61 }
62 
63 static unsigned char port_read_status(struct parport *p)
64 {
65 	return parport_read_status(p);
66 }
67 
68 static unsigned char port_read_control(struct parport *p)
69 {
70 	return parport_read_control(p);
71 }
72 
73 static void (*port_write[])(struct parport *, unsigned char) = {
74 	port_write_data,
75 	NULL,
76 	port_write_control,
77 };
78 
79 static unsigned char (*port_read[])(struct parport *) = {
80 	port_read_data,
81 	port_read_status,
82 	port_read_control,
83 };
84 
85 /* ----- Unified line operation functions --------------------------------- */
86 
87 static inline void line_set(struct parport *data, int state,
88 	const struct lineop *op)
89 {
90 	u8 oldval = port_read[op->port](data);
91 
92 	/* Touch only the bit(s) needed */
93 	if ((op->inverted && !state) || (!op->inverted && state))
94 		port_write[op->port](data, oldval | op->val);
95 	else
96 		port_write[op->port](data, oldval & ~op->val);
97 }
98 
99 static inline int line_get(struct parport *data,
100 	const struct lineop *op)
101 {
102 	u8 oldval = port_read[op->port](data);
103 
104 	return ((op->inverted && (oldval & op->val) != op->val)
105 	    || (!op->inverted && (oldval & op->val) == op->val));
106 }
107 
108 /* ----- I2C algorithm call-back functions and structures ----------------- */
109 
110 static void parport_setscl(void *data, int state)
111 {
112 	line_set((struct parport *) data, state, &adapter_parm[type].setscl);
113 }
114 
115 static void parport_setsda(void *data, int state)
116 {
117 	line_set((struct parport *) data, state, &adapter_parm[type].setsda);
118 }
119 
120 static int parport_getscl(void *data)
121 {
122 	return line_get((struct parport *) data, &adapter_parm[type].getscl);
123 }
124 
125 static int parport_getsda(void *data)
126 {
127 	return line_get((struct parport *) data, &adapter_parm[type].getsda);
128 }
129 
130 /* Encapsulate the functions above in the correct structure.
131    Note that this is only a template, from which the real structures are
132    copied. The attaching code will set getscl to NULL for adapters that
133    cannot read SCL back, and will also make the data field point to
134    the parallel port structure. */
135 static struct i2c_algo_bit_data parport_algo_data = {
136 	.setsda		= parport_setsda,
137 	.setscl		= parport_setscl,
138 	.getsda		= parport_getsda,
139 	.getscl		= parport_getscl,
140 	.udelay		= 10, /* ~50 kbps */
141 	.timeout	= HZ,
142 };
143 
144 /* ----- I2c and parallel port call-back functions and structures --------- */
145 
146 static void i2c_parport_attach (struct parport *port)
147 {
148 	struct i2c_par *adapter;
149 
150 	adapter = kzalloc(sizeof(struct i2c_par), GFP_KERNEL);
151 	if (adapter == NULL) {
152 		printk(KERN_ERR "i2c-parport: Failed to kzalloc\n");
153 		return;
154 	}
155 
156 	pr_debug("i2c-parport: attaching to %s\n", port->name);
157 	adapter->pdev = parport_register_device(port, "i2c-parport",
158 		NULL, NULL, NULL, PARPORT_FLAG_EXCL, NULL);
159 	if (!adapter->pdev) {
160 		printk(KERN_ERR "i2c-parport: Unable to register with parport\n");
161 		goto ERROR0;
162 	}
163 
164 	/* Fill the rest of the structure */
165 	adapter->adapter.owner = THIS_MODULE;
166 	adapter->adapter.class = I2C_CLASS_HWMON;
167 	adapter->adapter.id = I2C_HW_B_LP;
168 	strlcpy(adapter->adapter.name, "Parallel port adapter",
169 		sizeof(adapter->adapter.name));
170 	adapter->algo_data = parport_algo_data;
171 	/* Slow down if we can't sense SCL */
172 	if (!adapter_parm[type].getscl.val) {
173 		adapter->algo_data.getscl = NULL;
174 		adapter->algo_data.udelay = 50; /* ~10 kbps */
175 	}
176 	adapter->algo_data.data = port;
177 	adapter->adapter.algo_data = &adapter->algo_data;
178 	adapter->adapter.dev.parent = port->physport->dev;
179 
180 	if (parport_claim_or_block(adapter->pdev) < 0) {
181 		printk(KERN_ERR "i2c-parport: Could not claim parallel port\n");
182 		goto ERROR1;
183 	}
184 
185 	/* Reset hardware to a sane state (SCL and SDA high) */
186 	parport_setsda(port, 1);
187 	parport_setscl(port, 1);
188 	/* Other init if needed (power on...) */
189 	if (adapter_parm[type].init.val)
190 		line_set(port, 1, &adapter_parm[type].init);
191 
192 	parport_release(adapter->pdev);
193 
194 	if (i2c_bit_add_bus(&adapter->adapter) < 0) {
195 		printk(KERN_ERR "i2c-parport: Unable to register with I2C\n");
196 		goto ERROR1;
197 	}
198 
199 	/* Add the new adapter to the list */
200 	adapter->next = adapter_list;
201 	adapter_list = adapter;
202         return;
203 
204 ERROR1:
205 	parport_unregister_device(adapter->pdev);
206 ERROR0:
207 	kfree(adapter);
208 }
209 
210 static void i2c_parport_detach (struct parport *port)
211 {
212 	struct i2c_par *adapter, *prev;
213 
214 	/* Walk the list */
215 	for (prev = NULL, adapter = adapter_list; adapter;
216 	     prev = adapter, adapter = adapter->next) {
217 		if (adapter->pdev->port == port) {
218 			i2c_del_adapter(&adapter->adapter);
219 
220 			/* Un-init if needed (power off...) */
221 			if (adapter_parm[type].init.val)
222 				line_set(port, 0, &adapter_parm[type].init);
223 
224 			parport_unregister_device(adapter->pdev);
225 			if (prev)
226 				prev->next = adapter->next;
227 			else
228 				adapter_list = adapter->next;
229 			kfree(adapter);
230 			return;
231 		}
232 	}
233 }
234 
235 static struct parport_driver i2c_parport_driver = {
236 	.name	= "i2c-parport",
237 	.attach	= i2c_parport_attach,
238 	.detach	= i2c_parport_detach,
239 };
240 
241 /* ----- Module loading, unloading and information ------------------------ */
242 
243 static int __init i2c_parport_init(void)
244 {
245 	if (type < 0) {
246 		printk(KERN_WARNING "i2c-parport: adapter type unspecified\n");
247 		return -ENODEV;
248 	}
249 
250 	if (type >= ARRAY_SIZE(adapter_parm)) {
251 		printk(KERN_WARNING "i2c-parport: invalid type (%d)\n", type);
252 		return -ENODEV;
253 	}
254 
255 	return parport_register_driver(&i2c_parport_driver);
256 }
257 
258 static void __exit i2c_parport_exit(void)
259 {
260 	parport_unregister_driver(&i2c_parport_driver);
261 }
262 
263 MODULE_AUTHOR("Jean Delvare <khali@linux-fr.org>");
264 MODULE_DESCRIPTION("I2C bus over parallel port");
265 MODULE_LICENSE("GPL");
266 
267 module_init(i2c_parport_init);
268 module_exit(i2c_parport_exit);
269