blob: 835254de20391f0594b1fb772c5fa8352b7d9b3a [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef __SOUND_I2C_H
2#define __SOUND_I2C_H
3
4/*
5 *
6 *
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 *
21 *
22 */
23
Linus Torvalds1da177e2005-04-16 15:20:36 -070024#define SND_I2C_DEVICE_ADDRTEN (1<<0) /* 10-bit I2C address */
25
Takashi Iwai97f02e02005-11-17 14:17:19 +010026struct snd_i2c_device {
Linus Torvalds1da177e2005-04-16 15:20:36 -070027 struct list_head list;
Takashi Iwai97f02e02005-11-17 14:17:19 +010028 struct snd_i2c_bus *bus; /* I2C bus */
Linus Torvalds1da177e2005-04-16 15:20:36 -070029 char name[32]; /* some useful device name */
30 unsigned short flags; /* device flags */
31 unsigned short addr; /* device address (might be 10-bit) */
32 unsigned long private_value;
33 void *private_data;
Takashi Iwai97f02e02005-11-17 14:17:19 +010034 void (*private_free)(struct snd_i2c_device *device);
Linus Torvalds1da177e2005-04-16 15:20:36 -070035};
36
Takashi Iwai97f02e02005-11-17 14:17:19 +010037#define snd_i2c_device(n) list_entry(n, struct snd_i2c_device, list)
Linus Torvalds1da177e2005-04-16 15:20:36 -070038
Takashi Iwai97f02e02005-11-17 14:17:19 +010039struct snd_i2c_bit_ops {
40 void (*start)(struct snd_i2c_bus *bus); /* transfer start */
41 void (*stop)(struct snd_i2c_bus *bus); /* transfer stop */
42 void (*direction)(struct snd_i2c_bus *bus, int clock, int data); /* set line direction (0 = write, 1 = read) */
43 void (*setlines)(struct snd_i2c_bus *bus, int clock, int data);
44 int (*getclock)(struct snd_i2c_bus *bus);
45 int (*getdata)(struct snd_i2c_bus *bus, int ack);
46};
Linus Torvalds1da177e2005-04-16 15:20:36 -070047
Takashi Iwai97f02e02005-11-17 14:17:19 +010048struct snd_i2c_ops {
49 int (*sendbytes)(struct snd_i2c_device *device, unsigned char *bytes, int count);
50 int (*readbytes)(struct snd_i2c_device *device, unsigned char *bytes, int count);
51 int (*probeaddr)(struct snd_i2c_bus *bus, unsigned short addr);
52};
Linus Torvalds1da177e2005-04-16 15:20:36 -070053
Takashi Iwai97f02e02005-11-17 14:17:19 +010054struct snd_i2c_bus {
55 struct snd_card *card; /* card which I2C belongs to */
Linus Torvalds1da177e2005-04-16 15:20:36 -070056 char name[32]; /* some useful label */
57
Ingo Molnaref9f0a42006-01-16 16:31:42 +010058 struct mutex lock_mutex;
Linus Torvalds1da177e2005-04-16 15:20:36 -070059
Takashi Iwai97f02e02005-11-17 14:17:19 +010060 struct snd_i2c_bus *master; /* master bus when SCK/SCL is shared */
Linus Torvalds1da177e2005-04-16 15:20:36 -070061 struct list_head buses; /* master: slave buses sharing SCK/SCL, slave: link list */
62
63 struct list_head devices; /* attached devices to this bus */
64
65 union {
Takashi Iwai97f02e02005-11-17 14:17:19 +010066 struct snd_i2c_bit_ops *bit;
Linus Torvalds1da177e2005-04-16 15:20:36 -070067 void *ops;
68 } hw_ops; /* lowlevel operations */
Julia Lawall5df29bc2015-11-29 18:25:24 +010069 const struct snd_i2c_ops *ops; /* midlevel operations */
Linus Torvalds1da177e2005-04-16 15:20:36 -070070
71 unsigned long private_value;
72 void *private_data;
Takashi Iwai97f02e02005-11-17 14:17:19 +010073 void (*private_free)(struct snd_i2c_bus *bus);
Linus Torvalds1da177e2005-04-16 15:20:36 -070074};
75
Takashi Iwai97f02e02005-11-17 14:17:19 +010076#define snd_i2c_slave_bus(n) list_entry(n, struct snd_i2c_bus, buses)
Linus Torvalds1da177e2005-04-16 15:20:36 -070077
Takashi Iwai97f02e02005-11-17 14:17:19 +010078int snd_i2c_bus_create(struct snd_card *card, const char *name,
79 struct snd_i2c_bus *master, struct snd_i2c_bus **ri2c);
80int snd_i2c_device_create(struct snd_i2c_bus *bus, const char *name,
81 unsigned char addr, struct snd_i2c_device **rdevice);
82int snd_i2c_device_free(struct snd_i2c_device *device);
Linus Torvalds1da177e2005-04-16 15:20:36 -070083
Takashi Iwai97f02e02005-11-17 14:17:19 +010084static inline void snd_i2c_lock(struct snd_i2c_bus *bus)
85{
Linus Torvalds1da177e2005-04-16 15:20:36 -070086 if (bus->master)
Ingo Molnaref9f0a42006-01-16 16:31:42 +010087 mutex_lock(&bus->master->lock_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -070088 else
Ingo Molnaref9f0a42006-01-16 16:31:42 +010089 mutex_lock(&bus->lock_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -070090}
Takashi Iwai97f02e02005-11-17 14:17:19 +010091
92static inline void snd_i2c_unlock(struct snd_i2c_bus *bus)
93{
Linus Torvalds1da177e2005-04-16 15:20:36 -070094 if (bus->master)
Ingo Molnaref9f0a42006-01-16 16:31:42 +010095 mutex_unlock(&bus->master->lock_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -070096 else
Ingo Molnaref9f0a42006-01-16 16:31:42 +010097 mutex_unlock(&bus->lock_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -070098}
99
Takashi Iwai97f02e02005-11-17 14:17:19 +0100100int snd_i2c_sendbytes(struct snd_i2c_device *device, unsigned char *bytes, int count);
101int snd_i2c_readbytes(struct snd_i2c_device *device, unsigned char *bytes, int count);
102int snd_i2c_probeaddr(struct snd_i2c_bus *bus, unsigned short addr);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700103
104#endif /* __SOUND_I2C_H */