fmc-core.c 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. /*
  2. * Copyright (C) 2012 CERN (www.cern.ch)
  3. * Author: Alessandro Rubini <rubini@gnudd.com>
  4. *
  5. * Released according to the GNU GPL, version 2 or any later version.
  6. *
  7. * This work is part of the White Rabbit project, a research effort led
  8. * by CERN, the European Institute for Nuclear Research.
  9. */
  10. #include <linux/kernel.h>
  11. #include <linux/module.h>
  12. #include <linux/slab.h>
  13. #include <linux/init.h>
  14. #include <linux/device.h>
  15. #include <linux/fmc.h>
  16. static int fmc_check_version(unsigned long version, const char *name)
  17. {
  18. if (__FMC_MAJOR(version) != FMC_MAJOR) {
  19. pr_err("%s: \"%s\" has wrong major (has %li, expected %i)\n",
  20. __func__, name, __FMC_MAJOR(version), FMC_MAJOR);
  21. return -EINVAL;
  22. }
  23. if (__FMC_MINOR(version) != FMC_MINOR)
  24. pr_info("%s: \"%s\" has wrong minor (has %li, expected %i)\n",
  25. __func__, name, __FMC_MINOR(version), FMC_MINOR);
  26. return 0;
  27. }
  28. static int fmc_uevent(struct device *dev, struct kobj_uevent_env *env)
  29. {
  30. /* struct fmc_device *fdev = to_fmc_device(dev); */
  31. /* FIXME: The MODALIAS */
  32. add_uevent_var(env, "MODALIAS=%s", "fmc");
  33. return 0;
  34. }
  35. static int fmc_probe(struct device *dev)
  36. {
  37. struct fmc_driver *fdrv = to_fmc_driver(dev->driver);
  38. struct fmc_device *fdev = to_fmc_device(dev);
  39. return fdrv->probe(fdev);
  40. }
  41. static int fmc_remove(struct device *dev)
  42. {
  43. struct fmc_driver *fdrv = to_fmc_driver(dev->driver);
  44. struct fmc_device *fdev = to_fmc_device(dev);
  45. return fdrv->remove(fdev);
  46. }
  47. static void fmc_shutdown(struct device *dev)
  48. {
  49. /* not implemented but mandatory */
  50. }
  51. static struct bus_type fmc_bus_type = {
  52. .name = "fmc",
  53. .match = fmc_match,
  54. .uevent = fmc_uevent,
  55. .probe = fmc_probe,
  56. .remove = fmc_remove,
  57. .shutdown = fmc_shutdown,
  58. };
  59. static void fmc_release(struct device *dev)
  60. {
  61. struct fmc_device *fmc = container_of(dev, struct fmc_device, dev);
  62. kfree(fmc);
  63. }
  64. /*
  65. * The eeprom is exported in sysfs, through a binary attribute
  66. */
  67. static ssize_t fmc_read_eeprom(struct file *file, struct kobject *kobj,
  68. struct bin_attribute *bin_attr,
  69. char *buf, loff_t off, size_t count)
  70. {
  71. struct device *dev;
  72. struct fmc_device *fmc;
  73. int eelen;
  74. dev = container_of(kobj, struct device, kobj);
  75. fmc = container_of(dev, struct fmc_device, dev);
  76. eelen = fmc->eeprom_len;
  77. if (off > eelen)
  78. return -ESPIPE;
  79. if (off == eelen)
  80. return 0; /* EOF */
  81. if (off + count > eelen)
  82. count = eelen - off;
  83. memcpy(buf, fmc->eeprom + off, count);
  84. return count;
  85. }
  86. static struct bin_attribute fmc_eeprom_attr = {
  87. .attr = { .name = "eeprom", .mode = S_IRUGO, },
  88. .size = 8192, /* more or less standard */
  89. .read = fmc_read_eeprom,
  90. };
  91. /*
  92. * Functions for client modules follow
  93. */
  94. int fmc_driver_register(struct fmc_driver *drv)
  95. {
  96. if (fmc_check_version(drv->version, drv->driver.name))
  97. return -EINVAL;
  98. drv->driver.bus = &fmc_bus_type;
  99. return driver_register(&drv->driver);
  100. }
  101. EXPORT_SYMBOL(fmc_driver_register);
  102. void fmc_driver_unregister(struct fmc_driver *drv)
  103. {
  104. driver_unregister(&drv->driver);
  105. }
  106. EXPORT_SYMBOL(fmc_driver_unregister);
  107. /*
  108. * When a device set is registered, all eeproms must be read
  109. * and all FRUs must be parsed
  110. */
  111. int fmc_device_register_n(struct fmc_device **devs, int n)
  112. {
  113. struct fmc_device *fmc, **devarray;
  114. uint32_t device_id;
  115. int i, ret = 0;
  116. if (n < 1)
  117. return 0;
  118. /* Check the version of the first data structure (function prints) */
  119. if (fmc_check_version(devs[0]->version, devs[0]->carrier_name))
  120. return -EINVAL;
  121. devarray = kmemdup(devs, n * sizeof(*devs), GFP_KERNEL);
  122. if (!devarray)
  123. return -ENOMEM;
  124. /* Make all other checks before continuing, for all devices */
  125. for (i = 0; i < n; i++) {
  126. fmc = devarray[i];
  127. if (!fmc->hwdev) {
  128. pr_err("%s: device nr. %i has no hwdev pointer\n",
  129. __func__, i);
  130. ret = -EINVAL;
  131. break;
  132. }
  133. if (fmc->flags == FMC_DEVICE_NO_MEZZANINE) {
  134. dev_info(fmc->hwdev, "absent mezzanine in slot %d\n",
  135. fmc->slot_id);
  136. continue;
  137. }
  138. if (!fmc->eeprom) {
  139. dev_err(fmc->hwdev, "no eeprom provided for slot %i\n",
  140. fmc->slot_id);
  141. ret = -EINVAL;
  142. }
  143. if (!fmc->eeprom_addr) {
  144. dev_err(fmc->hwdev, "no eeprom_addr for slot %i\n",
  145. fmc->slot_id);
  146. ret = -EINVAL;
  147. }
  148. if (!fmc->carrier_name || !fmc->carrier_data ||
  149. !fmc->device_id) {
  150. dev_err(fmc->hwdev,
  151. "deivce nr %i: carrier name, "
  152. "data or dev_id not set\n", i);
  153. ret = -EINVAL;
  154. }
  155. if (ret)
  156. break;
  157. }
  158. if (ret) {
  159. kfree(devarray);
  160. return ret;
  161. }
  162. /* Validation is ok. Now init and register the devices */
  163. for (i = 0; i < n; i++) {
  164. fmc = devarray[i];
  165. if (fmc->flags == FMC_DEVICE_NO_MEZZANINE)
  166. continue; /* dev_info already done above */
  167. fmc->nr_slots = n; /* each slot must know how many are there */
  168. fmc->devarray = devarray;
  169. device_initialize(&fmc->dev);
  170. fmc->dev.release = fmc_release;
  171. fmc->dev.parent = fmc->hwdev;
  172. /* Fill the identification stuff (may fail) */
  173. fmc_fill_id_info(fmc);
  174. fmc->dev.bus = &fmc_bus_type;
  175. /* Name from mezzanine info or carrier info. Or 0,1,2.. */
  176. device_id = fmc->device_id;
  177. if (!fmc->mezzanine_name)
  178. dev_set_name(&fmc->dev, "fmc-%04x", device_id);
  179. else
  180. dev_set_name(&fmc->dev, "%s-%04x", fmc->mezzanine_name,
  181. device_id);
  182. ret = device_add(&fmc->dev);
  183. if (ret < 0) {
  184. dev_err(fmc->hwdev, "Slot %i: Failed in registering "
  185. "\"%s\"\n", fmc->slot_id, fmc->dev.kobj.name);
  186. goto out;
  187. }
  188. ret = sysfs_create_bin_file(&fmc->dev.kobj, &fmc_eeprom_attr);
  189. if (ret < 0) {
  190. dev_err(&fmc->dev, "Failed in registering eeprom\n");
  191. goto out1;
  192. }
  193. /* This device went well, give information to the user */
  194. fmc_dump_eeprom(fmc);
  195. fmc_dump_sdb(fmc);
  196. }
  197. return 0;
  198. out1:
  199. device_del(&fmc->dev);
  200. out:
  201. fmc_free_id_info(fmc);
  202. put_device(&fmc->dev);
  203. kfree(devarray);
  204. for (i--; i >= 0; i--) {
  205. sysfs_remove_bin_file(&devs[i]->dev.kobj, &fmc_eeprom_attr);
  206. device_del(&devs[i]->dev);
  207. fmc_free_id_info(devs[i]);
  208. put_device(&devs[i]->dev);
  209. }
  210. return ret;
  211. }
  212. EXPORT_SYMBOL(fmc_device_register_n);
  213. int fmc_device_register(struct fmc_device *fmc)
  214. {
  215. return fmc_device_register_n(&fmc, 1);
  216. }
  217. EXPORT_SYMBOL(fmc_device_register);
  218. void fmc_device_unregister_n(struct fmc_device **devs, int n)
  219. {
  220. int i;
  221. if (n < 1)
  222. return;
  223. /* Free devarray first, not used by the later loop */
  224. kfree(devs[0]->devarray);
  225. for (i = 0; i < n; i++) {
  226. if (devs[i]->flags == FMC_DEVICE_NO_MEZZANINE)
  227. continue;
  228. sysfs_remove_bin_file(&devs[i]->dev.kobj, &fmc_eeprom_attr);
  229. device_del(&devs[i]->dev);
  230. fmc_free_id_info(devs[i]);
  231. put_device(&devs[i]->dev);
  232. }
  233. }
  234. EXPORT_SYMBOL(fmc_device_unregister_n);
  235. void fmc_device_unregister(struct fmc_device *fmc)
  236. {
  237. fmc_device_unregister_n(&fmc, 1);
  238. }
  239. EXPORT_SYMBOL(fmc_device_unregister);
  240. /* Init and exit are trivial */
  241. static int fmc_init(void)
  242. {
  243. return bus_register(&fmc_bus_type);
  244. }
  245. static void fmc_exit(void)
  246. {
  247. bus_unregister(&fmc_bus_type);
  248. }
  249. module_init(fmc_init);
  250. module_exit(fmc_exit);
  251. MODULE_LICENSE("GPL");