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