i2c-stub.c 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422
  1. /*
  2. i2c-stub.c - I2C/SMBus chip emulator
  3. Copyright (c) 2004 Mark M. Hoffman <mhoffman@lightlink.com>
  4. Copyright (C) 2007-2014 Jean Delvare <jdelvare@suse.de>
  5. This program is free software; you can redistribute it and/or modify
  6. it under the terms of the GNU General Public License as published by
  7. the Free Software Foundation; either version 2 of the License, or
  8. (at your option) any later version.
  9. This program is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. GNU General Public License for more details.
  13. */
  14. #define DEBUG 1
  15. #define pr_fmt(fmt) "i2c-stub: " fmt
  16. #include <linux/errno.h>
  17. #include <linux/i2c.h>
  18. #include <linux/init.h>
  19. #include <linux/kernel.h>
  20. #include <linux/list.h>
  21. #include <linux/module.h>
  22. #include <linux/slab.h>
  23. #define MAX_CHIPS 10
  24. /*
  25. * Support for I2C_FUNC_SMBUS_BLOCK_DATA is disabled by default and must
  26. * be enabled explicitly by setting the I2C_FUNC_SMBUS_BLOCK_DATA bits
  27. * in the 'functionality' module parameter.
  28. */
  29. #define STUB_FUNC_DEFAULT \
  30. (I2C_FUNC_SMBUS_QUICK | I2C_FUNC_SMBUS_BYTE | \
  31. I2C_FUNC_SMBUS_BYTE_DATA | I2C_FUNC_SMBUS_WORD_DATA | \
  32. I2C_FUNC_SMBUS_I2C_BLOCK)
  33. #define STUB_FUNC_ALL \
  34. (STUB_FUNC_DEFAULT | I2C_FUNC_SMBUS_BLOCK_DATA)
  35. static unsigned short chip_addr[MAX_CHIPS];
  36. module_param_array(chip_addr, ushort, NULL, S_IRUGO);
  37. MODULE_PARM_DESC(chip_addr,
  38. "Chip addresses (up to 10, between 0x03 and 0x77)");
  39. static unsigned long functionality = STUB_FUNC_DEFAULT;
  40. module_param(functionality, ulong, S_IRUGO | S_IWUSR);
  41. MODULE_PARM_DESC(functionality, "Override functionality bitfield");
  42. /* Some chips have banked register ranges */
  43. static u8 bank_reg[MAX_CHIPS];
  44. module_param_array(bank_reg, byte, NULL, S_IRUGO);
  45. MODULE_PARM_DESC(bank_reg, "Bank register");
  46. static u8 bank_mask[MAX_CHIPS];
  47. module_param_array(bank_mask, byte, NULL, S_IRUGO);
  48. MODULE_PARM_DESC(bank_mask, "Bank value mask");
  49. static u8 bank_start[MAX_CHIPS];
  50. module_param_array(bank_start, byte, NULL, S_IRUGO);
  51. MODULE_PARM_DESC(bank_start, "First banked register");
  52. static u8 bank_end[MAX_CHIPS];
  53. module_param_array(bank_end, byte, NULL, S_IRUGO);
  54. MODULE_PARM_DESC(bank_end, "Last banked register");
  55. struct smbus_block_data {
  56. struct list_head node;
  57. u8 command;
  58. u8 len;
  59. u8 block[I2C_SMBUS_BLOCK_MAX];
  60. };
  61. struct stub_chip {
  62. u8 pointer;
  63. u16 words[256]; /* Byte operations use the LSB as per SMBus
  64. specification */
  65. struct list_head smbus_blocks;
  66. /* For chips with banks, extra registers are allocated dynamically */
  67. u8 bank_reg;
  68. u8 bank_shift;
  69. u8 bank_mask;
  70. u8 bank_sel; /* Currently selected bank */
  71. u8 bank_start;
  72. u8 bank_end;
  73. u16 bank_size;
  74. u16 *bank_words; /* Room for bank_mask * bank_size registers */
  75. };
  76. static struct stub_chip *stub_chips;
  77. static int stub_chips_nr;
  78. static struct smbus_block_data *stub_find_block(struct device *dev,
  79. struct stub_chip *chip,
  80. u8 command, bool create)
  81. {
  82. struct smbus_block_data *b, *rb = NULL;
  83. list_for_each_entry(b, &chip->smbus_blocks, node) {
  84. if (b->command == command) {
  85. rb = b;
  86. break;
  87. }
  88. }
  89. if (rb == NULL && create) {
  90. rb = devm_kzalloc(dev, sizeof(*rb), GFP_KERNEL);
  91. if (rb == NULL)
  92. return rb;
  93. rb->command = command;
  94. list_add(&rb->node, &chip->smbus_blocks);
  95. }
  96. return rb;
  97. }
  98. static u16 *stub_get_wordp(struct stub_chip *chip, u8 offset)
  99. {
  100. if (chip->bank_sel &&
  101. offset >= chip->bank_start && offset <= chip->bank_end)
  102. return chip->bank_words +
  103. (chip->bank_sel - 1) * chip->bank_size +
  104. offset - chip->bank_start;
  105. else
  106. return chip->words + offset;
  107. }
  108. /* Return negative errno on error. */
  109. static s32 stub_xfer(struct i2c_adapter *adap, u16 addr, unsigned short flags,
  110. char read_write, u8 command, int size, union i2c_smbus_data *data)
  111. {
  112. s32 ret;
  113. int i, len;
  114. struct stub_chip *chip = NULL;
  115. struct smbus_block_data *b;
  116. u16 *wordp;
  117. /* Search for the right chip */
  118. for (i = 0; i < stub_chips_nr; i++) {
  119. if (addr == chip_addr[i]) {
  120. chip = stub_chips + i;
  121. break;
  122. }
  123. }
  124. if (!chip)
  125. return -ENODEV;
  126. switch (size) {
  127. case I2C_SMBUS_QUICK:
  128. dev_dbg(&adap->dev, "smbus quick - addr 0x%02x\n", addr);
  129. ret = 0;
  130. break;
  131. case I2C_SMBUS_BYTE:
  132. if (read_write == I2C_SMBUS_WRITE) {
  133. chip->pointer = command;
  134. dev_dbg(&adap->dev,
  135. "smbus byte - addr 0x%02x, wrote 0x%02x.\n",
  136. addr, command);
  137. } else {
  138. wordp = stub_get_wordp(chip, chip->pointer++);
  139. data->byte = *wordp & 0xff;
  140. dev_dbg(&adap->dev,
  141. "smbus byte - addr 0x%02x, read 0x%02x.\n",
  142. addr, data->byte);
  143. }
  144. ret = 0;
  145. break;
  146. case I2C_SMBUS_BYTE_DATA:
  147. wordp = stub_get_wordp(chip, command);
  148. if (read_write == I2C_SMBUS_WRITE) {
  149. *wordp &= 0xff00;
  150. *wordp |= data->byte;
  151. dev_dbg(&adap->dev,
  152. "smbus byte data - addr 0x%02x, wrote 0x%02x at 0x%02x.\n",
  153. addr, data->byte, command);
  154. /* Set the bank as needed */
  155. if (chip->bank_words && command == chip->bank_reg) {
  156. chip->bank_sel =
  157. (data->byte >> chip->bank_shift)
  158. & chip->bank_mask;
  159. dev_dbg(&adap->dev,
  160. "switching to bank %u.\n",
  161. chip->bank_sel);
  162. }
  163. } else {
  164. data->byte = *wordp & 0xff;
  165. dev_dbg(&adap->dev,
  166. "smbus byte data - addr 0x%02x, read 0x%02x at 0x%02x.\n",
  167. addr, data->byte, command);
  168. }
  169. chip->pointer = command + 1;
  170. ret = 0;
  171. break;
  172. case I2C_SMBUS_WORD_DATA:
  173. wordp = stub_get_wordp(chip, command);
  174. if (read_write == I2C_SMBUS_WRITE) {
  175. *wordp = data->word;
  176. dev_dbg(&adap->dev,
  177. "smbus word data - addr 0x%02x, wrote 0x%04x at 0x%02x.\n",
  178. addr, data->word, command);
  179. } else {
  180. data->word = *wordp;
  181. dev_dbg(&adap->dev,
  182. "smbus word data - addr 0x%02x, read 0x%04x at 0x%02x.\n",
  183. addr, data->word, command);
  184. }
  185. ret = 0;
  186. break;
  187. case I2C_SMBUS_I2C_BLOCK_DATA:
  188. /*
  189. * We ignore banks here, because banked chips don't use I2C
  190. * block transfers
  191. */
  192. if (data->block[0] > 256 - command) /* Avoid overrun */
  193. data->block[0] = 256 - command;
  194. len = data->block[0];
  195. if (read_write == I2C_SMBUS_WRITE) {
  196. for (i = 0; i < len; i++) {
  197. chip->words[command + i] &= 0xff00;
  198. chip->words[command + i] |= data->block[1 + i];
  199. }
  200. dev_dbg(&adap->dev,
  201. "i2c block data - addr 0x%02x, wrote %d bytes at 0x%02x.\n",
  202. addr, len, command);
  203. } else {
  204. for (i = 0; i < len; i++) {
  205. data->block[1 + i] =
  206. chip->words[command + i] & 0xff;
  207. }
  208. dev_dbg(&adap->dev,
  209. "i2c block data - addr 0x%02x, read %d bytes at 0x%02x.\n",
  210. addr, len, command);
  211. }
  212. ret = 0;
  213. break;
  214. case I2C_SMBUS_BLOCK_DATA:
  215. /*
  216. * We ignore banks here, because chips typically don't use both
  217. * banks and SMBus block transfers
  218. */
  219. b = stub_find_block(&adap->dev, chip, command, false);
  220. if (read_write == I2C_SMBUS_WRITE) {
  221. len = data->block[0];
  222. if (len == 0 || len > I2C_SMBUS_BLOCK_MAX) {
  223. ret = -EINVAL;
  224. break;
  225. }
  226. if (b == NULL) {
  227. b = stub_find_block(&adap->dev, chip, command,
  228. true);
  229. if (b == NULL) {
  230. ret = -ENOMEM;
  231. break;
  232. }
  233. }
  234. /* Largest write sets read block length */
  235. if (len > b->len)
  236. b->len = len;
  237. for (i = 0; i < len; i++)
  238. b->block[i] = data->block[i + 1];
  239. /* update for byte and word commands */
  240. chip->words[command] = (b->block[0] << 8) | b->len;
  241. dev_dbg(&adap->dev,
  242. "smbus block data - addr 0x%02x, wrote %d bytes at 0x%02x.\n",
  243. addr, len, command);
  244. } else {
  245. if (b == NULL) {
  246. dev_dbg(&adap->dev,
  247. "SMBus block read command without prior block write not supported\n");
  248. ret = -EOPNOTSUPP;
  249. break;
  250. }
  251. len = b->len;
  252. data->block[0] = len;
  253. for (i = 0; i < len; i++)
  254. data->block[i + 1] = b->block[i];
  255. dev_dbg(&adap->dev,
  256. "smbus block data - addr 0x%02x, read %d bytes at 0x%02x.\n",
  257. addr, len, command);
  258. }
  259. ret = 0;
  260. break;
  261. default:
  262. dev_dbg(&adap->dev, "Unsupported I2C/SMBus command\n");
  263. ret = -EOPNOTSUPP;
  264. break;
  265. } /* switch (size) */
  266. return ret;
  267. }
  268. static u32 stub_func(struct i2c_adapter *adapter)
  269. {
  270. return STUB_FUNC_ALL & functionality;
  271. }
  272. static const struct i2c_algorithm smbus_algorithm = {
  273. .functionality = stub_func,
  274. .smbus_xfer = stub_xfer,
  275. };
  276. static struct i2c_adapter stub_adapter = {
  277. .owner = THIS_MODULE,
  278. .class = I2C_CLASS_HWMON | I2C_CLASS_SPD,
  279. .algo = &smbus_algorithm,
  280. .name = "SMBus stub driver",
  281. };
  282. static int __init i2c_stub_allocate_banks(int i)
  283. {
  284. struct stub_chip *chip = stub_chips + i;
  285. chip->bank_reg = bank_reg[i];
  286. chip->bank_start = bank_start[i];
  287. chip->bank_end = bank_end[i];
  288. chip->bank_size = bank_end[i] - bank_start[i] + 1;
  289. /* We assume that all bits in the mask are contiguous */
  290. chip->bank_mask = bank_mask[i];
  291. while (!(chip->bank_mask & 1)) {
  292. chip->bank_shift++;
  293. chip->bank_mask >>= 1;
  294. }
  295. chip->bank_words = kzalloc(chip->bank_mask * chip->bank_size *
  296. sizeof(u16), GFP_KERNEL);
  297. if (!chip->bank_words)
  298. return -ENOMEM;
  299. pr_debug("Allocated %u banks of %u words each (registers 0x%02x to 0x%02x)\n",
  300. chip->bank_mask, chip->bank_size, chip->bank_start,
  301. chip->bank_end);
  302. return 0;
  303. }
  304. static void i2c_stub_free(void)
  305. {
  306. int i;
  307. for (i = 0; i < stub_chips_nr; i++)
  308. kfree(stub_chips[i].bank_words);
  309. kfree(stub_chips);
  310. }
  311. static int __init i2c_stub_init(void)
  312. {
  313. int i, ret;
  314. if (!chip_addr[0]) {
  315. pr_err("Please specify a chip address\n");
  316. return -ENODEV;
  317. }
  318. for (i = 0; i < MAX_CHIPS && chip_addr[i]; i++) {
  319. if (chip_addr[i] < 0x03 || chip_addr[i] > 0x77) {
  320. pr_err("Invalid chip address 0x%02x\n",
  321. chip_addr[i]);
  322. return -EINVAL;
  323. }
  324. pr_info("Virtual chip at 0x%02x\n", chip_addr[i]);
  325. }
  326. /* Allocate memory for all chips at once */
  327. stub_chips_nr = i;
  328. stub_chips = kcalloc(stub_chips_nr, sizeof(struct stub_chip),
  329. GFP_KERNEL);
  330. if (!stub_chips)
  331. return -ENOMEM;
  332. for (i = 0; i < stub_chips_nr; i++) {
  333. INIT_LIST_HEAD(&stub_chips[i].smbus_blocks);
  334. /* Allocate extra memory for banked register ranges */
  335. if (bank_mask[i]) {
  336. ret = i2c_stub_allocate_banks(i);
  337. if (ret)
  338. goto fail_free;
  339. }
  340. }
  341. ret = i2c_add_adapter(&stub_adapter);
  342. if (ret)
  343. goto fail_free;
  344. return 0;
  345. fail_free:
  346. i2c_stub_free();
  347. return ret;
  348. }
  349. static void __exit i2c_stub_exit(void)
  350. {
  351. i2c_del_adapter(&stub_adapter);
  352. i2c_stub_free();
  353. }
  354. MODULE_AUTHOR("Mark M. Hoffman <mhoffman@lightlink.com>");
  355. MODULE_DESCRIPTION("I2C stub driver");
  356. MODULE_LICENSE("GPL");
  357. module_init(i2c_stub_init);
  358. module_exit(i2c_stub_exit);