1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* ------------------------------------------------------------------------ * 3 * i2c-parport.c I2C bus over parallel port * 4 * ------------------------------------------------------------------------ * 5 Copyright (C) 2003-2011 Jean Delvare <jdelvare@suse.de> 6 7 Based on older i2c-philips-par.c driver 8 Copyright (C) 1995-2000 Simon G. Vogl 9 With some changes from: 10 Frodo Looijaard <frodol@dds.nl> 11 Kyösti Mälkki <kmalkki@cc.hut.fi> 12 13 * ------------------------------------------------------------------------ */ 14 15 #define pr_fmt(fmt) "i2c-parport: " fmt 16 17 #include <linux/kernel.h> 18 #include <linux/module.h> 19 #include <linux/init.h> 20 #include <linux/delay.h> 21 #include <linux/parport.h> 22 #include <linux/i2c.h> 23 #include <linux/i2c-algo-bit.h> 24 #include <linux/i2c-smbus.h> 25 #include <linux/slab.h> 26 #include <linux/list.h> 27 #include <linux/mutex.h> 28 #include "i2c-parport.h" 29 30 /* ----- Device list ------------------------------------------------------ */ 31 32 struct i2c_par { 33 struct pardevice *pdev; 34 struct i2c_adapter adapter; 35 struct i2c_algo_bit_data algo_data; 36 struct i2c_smbus_alert_setup alert_data; 37 struct i2c_client *ara; 38 struct list_head node; 39 }; 40 41 static LIST_HEAD(adapter_list); 42 static DEFINE_MUTEX(adapter_list_lock); 43 #define MAX_DEVICE 4 44 static int parport[MAX_DEVICE] = {0, -1, -1, -1}; 45 46 47 /* ----- Low-level parallel port access ----------------------------------- */ 48 49 static void port_write_data(struct parport *p, unsigned char d) 50 { 51 parport_write_data(p, d); 52 } 53 54 static void port_write_control(struct parport *p, unsigned char d) 55 { 56 parport_write_control(p, d); 57 } 58 59 static unsigned char port_read_data(struct parport *p) 60 { 61 return parport_read_data(p); 62 } 63 64 static unsigned char port_read_status(struct parport *p) 65 { 66 return parport_read_status(p); 67 } 68 69 static unsigned char port_read_control(struct parport *p) 70 { 71 return parport_read_control(p); 72 } 73 74 static void (* const port_write[])(struct parport *, unsigned char) = { 75 port_write_data, 76 NULL, 77 port_write_control, 78 }; 79 80 static unsigned char (* const port_read[])(struct parport *) = { 81 port_read_data, 82 port_read_status, 83 port_read_control, 84 }; 85 86 /* ----- Unified line operation functions --------------------------------- */ 87 88 static inline void line_set(struct parport *data, int state, 89 const struct lineop *op) 90 { 91 u8 oldval = port_read[op->port](data); 92 93 /* Touch only the bit(s) needed */ 94 if ((op->inverted && !state) || (!op->inverted && state)) 95 port_write[op->port](data, oldval | op->val); 96 else 97 port_write[op->port](data, oldval & ~op->val); 98 } 99 100 static inline int line_get(struct parport *data, 101 const struct lineop *op) 102 { 103 u8 oldval = port_read[op->port](data); 104 105 return ((op->inverted && (oldval & op->val) != op->val) 106 || (!op->inverted && (oldval & op->val) == op->val)); 107 } 108 109 /* ----- I2C algorithm call-back functions and structures ----------------- */ 110 111 static void parport_setscl(void *data, int state) 112 { 113 line_set((struct parport *) data, state, &adapter_parm[type].setscl); 114 } 115 116 static void parport_setsda(void *data, int state) 117 { 118 line_set((struct parport *) data, state, &adapter_parm[type].setsda); 119 } 120 121 static int parport_getscl(void *data) 122 { 123 return line_get((struct parport *) data, &adapter_parm[type].getscl); 124 } 125 126 static int parport_getsda(void *data) 127 { 128 return line_get((struct parport *) data, &adapter_parm[type].getsda); 129 } 130 131 /* Encapsulate the functions above in the correct structure. 132 Note that this is only a template, from which the real structures are 133 copied. The attaching code will set getscl to NULL for adapters that 134 cannot read SCL back, and will also make the data field point to 135 the parallel port structure. */ 136 static const struct i2c_algo_bit_data parport_algo_data = { 137 .setsda = parport_setsda, 138 .setscl = parport_setscl, 139 .getsda = parport_getsda, 140 .getscl = parport_getscl, 141 .udelay = 10, /* ~50 kbps */ 142 .timeout = HZ, 143 }; 144 145 /* ----- I2c and parallel port call-back functions and structures --------- */ 146 147 static void i2c_parport_irq(void *data) 148 { 149 struct i2c_par *adapter = data; 150 struct i2c_client *ara = adapter->ara; 151 152 if (ara) { 153 dev_dbg(&ara->dev, "SMBus alert received\n"); 154 i2c_handle_smbus_alert(ara); 155 } else 156 dev_dbg(&adapter->adapter.dev, 157 "SMBus alert received but no ARA client!\n"); 158 } 159 160 static void i2c_parport_attach(struct parport *port) 161 { 162 struct i2c_par *adapter; 163 int i; 164 struct pardev_cb i2c_parport_cb; 165 166 for (i = 0; i < MAX_DEVICE; i++) { 167 if (parport[i] == -1) 168 continue; 169 if (port->number == parport[i]) 170 break; 171 } 172 if (i == MAX_DEVICE) { 173 pr_debug("Not using parport%d.\n", port->number); 174 return; 175 } 176 177 adapter = kzalloc(sizeof(struct i2c_par), GFP_KERNEL); 178 if (!adapter) 179 return; 180 memset(&i2c_parport_cb, 0, sizeof(i2c_parport_cb)); 181 i2c_parport_cb.flags = PARPORT_FLAG_EXCL; 182 i2c_parport_cb.irq_func = i2c_parport_irq; 183 i2c_parport_cb.private = adapter; 184 185 pr_debug("attaching to %s\n", port->name); 186 parport_disable_irq(port); 187 adapter->pdev = parport_register_dev_model(port, "i2c-parport", 188 &i2c_parport_cb, i); 189 if (!adapter->pdev) { 190 pr_err("Unable to register with parport\n"); 191 goto err_free; 192 } 193 194 /* Fill the rest of the structure */ 195 adapter->adapter.owner = THIS_MODULE; 196 adapter->adapter.class = I2C_CLASS_HWMON; 197 strlcpy(adapter->adapter.name, "Parallel port adapter", 198 sizeof(adapter->adapter.name)); 199 adapter->algo_data = parport_algo_data; 200 /* Slow down if we can't sense SCL */ 201 if (!adapter_parm[type].getscl.val) { 202 adapter->algo_data.getscl = NULL; 203 adapter->algo_data.udelay = 50; /* ~10 kbps */ 204 } 205 adapter->algo_data.data = port; 206 adapter->adapter.algo_data = &adapter->algo_data; 207 adapter->adapter.dev.parent = port->physport->dev; 208 209 if (parport_claim_or_block(adapter->pdev) < 0) { 210 dev_err(&adapter->pdev->dev, 211 "Could not claim parallel port\n"); 212 goto err_unregister; 213 } 214 215 /* Reset hardware to a sane state (SCL and SDA high) */ 216 parport_setsda(port, 1); 217 parport_setscl(port, 1); 218 /* Other init if needed (power on...) */ 219 if (adapter_parm[type].init.val) { 220 line_set(port, 1, &adapter_parm[type].init); 221 /* Give powered devices some time to settle */ 222 msleep(100); 223 } 224 225 if (i2c_bit_add_bus(&adapter->adapter) < 0) { 226 dev_err(&adapter->pdev->dev, "Unable to register with I2C\n"); 227 goto err_unregister; 228 } 229 230 /* Setup SMBus alert if supported */ 231 if (adapter_parm[type].smbus_alert) { 232 adapter->ara = i2c_setup_smbus_alert(&adapter->adapter, 233 &adapter->alert_data); 234 if (adapter->ara) 235 parport_enable_irq(port); 236 else 237 dev_warn(&adapter->pdev->dev, 238 "Failed to register ARA client\n"); 239 } 240 241 /* Add the new adapter to the list */ 242 mutex_lock(&adapter_list_lock); 243 list_add_tail(&adapter->node, &adapter_list); 244 mutex_unlock(&adapter_list_lock); 245 return; 246 247 err_unregister: 248 parport_release(adapter->pdev); 249 parport_unregister_device(adapter->pdev); 250 err_free: 251 kfree(adapter); 252 } 253 254 static void i2c_parport_detach(struct parport *port) 255 { 256 struct i2c_par *adapter, *_n; 257 258 /* Walk the list */ 259 mutex_lock(&adapter_list_lock); 260 list_for_each_entry_safe(adapter, _n, &adapter_list, node) { 261 if (adapter->pdev->port == port) { 262 if (adapter->ara) { 263 parport_disable_irq(port); 264 i2c_unregister_device(adapter->ara); 265 } 266 i2c_del_adapter(&adapter->adapter); 267 268 /* Un-init if needed (power off...) */ 269 if (adapter_parm[type].init.val) 270 line_set(port, 0, &adapter_parm[type].init); 271 272 parport_release(adapter->pdev); 273 parport_unregister_device(adapter->pdev); 274 list_del(&adapter->node); 275 kfree(adapter); 276 } 277 } 278 mutex_unlock(&adapter_list_lock); 279 } 280 281 static struct parport_driver i2c_parport_driver = { 282 .name = "i2c-parport", 283 .match_port = i2c_parport_attach, 284 .detach = i2c_parport_detach, 285 .devmodel = true, 286 }; 287 288 /* ----- Module loading, unloading and information ------------------------ */ 289 290 static int __init i2c_parport_init(void) 291 { 292 if (type < 0) { 293 pr_warn("adapter type unspecified\n"); 294 return -ENODEV; 295 } 296 297 if (type >= ARRAY_SIZE(adapter_parm)) { 298 pr_warn("invalid type (%d)\n", type); 299 return -ENODEV; 300 } 301 302 return parport_register_driver(&i2c_parport_driver); 303 } 304 305 static void __exit i2c_parport_exit(void) 306 { 307 parport_unregister_driver(&i2c_parport_driver); 308 } 309 310 MODULE_AUTHOR("Jean Delvare <jdelvare@suse.de>"); 311 MODULE_DESCRIPTION("I2C bus over parallel port"); 312 MODULE_LICENSE("GPL"); 313 314 module_param_array(parport, int, NULL, 0); 315 MODULE_PARM_DESC(parport, 316 "List of parallel ports to bind to, by index.\n" 317 " Atmost " __stringify(MAX_DEVICE) " devices are supported.\n" 318 " Default is one device connected to parport0.\n" 319 ); 320 321 module_init(i2c_parport_init); 322 module_exit(i2c_parport_exit); 323