1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132
|
/* SPDX-License-Identifier: GPL-2.0-only */
/*
* MEN Chameleon Bus.
*
* Copyright (C) 2014 MEN Mikroelektronik GmbH (www.men.de)
* Author: Johannes Thumshirn <johannes.thumshirn@men.de>
*/
#ifndef _LINUX_MCB_H
#define _LINUX_MCB_H
#include <linux/mod_devicetable.h>
#include <linux/device.h>
#include <linux/irqreturn.h>
#define CHAMELEON_FILENAME_LEN 12
struct mcb_driver;
struct mcb_device;
/**
* struct mcb_bus - MEN Chameleon Bus
*
* @dev: bus device
* @carrier: pointer to carrier device
* @bus_nr: mcb bus number
* @get_irq: callback to get IRQ number
* @revision: the FPGA's revision number
* @model: the FPGA's model number
* @filename: the FPGA's name
*/
struct mcb_bus {
struct device dev;
struct device *carrier;
int bus_nr;
u8 revision;
char model;
u8 minor;
char name[CHAMELEON_FILENAME_LEN + 1];
int (*get_irq)(struct mcb_device *dev);
};
static inline struct mcb_bus *to_mcb_bus(struct device *dev)
{
return container_of(dev, struct mcb_bus, dev);
}
/**
* struct mcb_device - MEN Chameleon Bus device
*
* @dev: device in kernel representation
* @bus: mcb bus the device is plugged to
* @is_added: flag to check if device is added to bus
* @driver: associated mcb_driver
* @id: mcb device id
* @inst: instance in Chameleon table
* @group: group in Chameleon table
* @var: variant in Chameleon table
* @bar: BAR in Chameleon table
* @rev: revision in Chameleon table
* @irq: IRQ resource
* @memory: memory resource
*/
struct mcb_device {
struct device dev;
struct mcb_bus *bus;
struct mcb_driver *driver;
u16 id;
int inst;
int group;
int var;
int bar;
int rev;
struct resource irq;
struct resource mem;
struct device *dma_dev;
};
#define to_mcb_device(__dev) container_of_const(__dev, struct mcb_device, dev)
/**
* struct mcb_driver - MEN Chameleon Bus device driver
*
* @driver: device_driver
* @id_table: mcb id table
* @probe: probe callback
* @remove: remove callback
* @shutdown: shutdown callback
*/
struct mcb_driver {
struct device_driver driver;
const struct mcb_device_id *id_table;
int (*probe)(struct mcb_device *mdev, const struct mcb_device_id *id);
void (*remove)(struct mcb_device *mdev);
void (*shutdown)(struct mcb_device *mdev);
};
#define to_mcb_driver(__drv) container_of_const(__drv, struct mcb_driver, driver)
static inline void *mcb_get_drvdata(struct mcb_device *dev)
{
return dev_get_drvdata(&dev->dev);
}
static inline void mcb_set_drvdata(struct mcb_device *dev, void *data)
{
dev_set_drvdata(&dev->dev, data);
}
extern int __must_check __mcb_register_driver(struct mcb_driver *drv,
struct module *owner,
const char *mod_name);
#define mcb_register_driver(driver) \
__mcb_register_driver(driver, THIS_MODULE, KBUILD_MODNAME)
extern void mcb_unregister_driver(struct mcb_driver *driver);
#define module_mcb_driver(__mcb_driver) \
module_driver(__mcb_driver, mcb_register_driver, mcb_unregister_driver)
extern void mcb_bus_add_devices(const struct mcb_bus *bus);
extern int mcb_device_register(struct mcb_bus *bus, struct mcb_device *dev);
extern struct mcb_bus *mcb_alloc_bus(struct device *carrier);
extern struct mcb_bus *mcb_bus_get(struct mcb_bus *bus);
extern void mcb_bus_put(struct mcb_bus *bus);
extern struct mcb_device *mcb_alloc_dev(struct mcb_bus *bus);
extern void mcb_free_dev(struct mcb_device *dev);
extern void mcb_release_bus(struct mcb_bus *bus);
extern struct resource *mcb_request_mem(struct mcb_device *dev,
const char *name);
extern void mcb_release_mem(struct resource *mem);
extern int mcb_get_irq(struct mcb_device *dev);
extern struct resource *mcb_get_resource(struct mcb_device *dev,
unsigned int type);
#endif /* _LINUX_MCB_H */
|