| .. | .. |
|---|
| 17 | 17 | #include <linux/bitfield.h> |
|---|
| 18 | 18 | #include <linux/cdev.h> |
|---|
| 19 | 19 | #include <linux/delay.h> |
|---|
| 20 | +#include <linux/eventfd.h> |
|---|
| 20 | 21 | #include <linux/fs.h> |
|---|
| 22 | +#include <linux/interrupt.h> |
|---|
| 21 | 23 | #include <linux/iopoll.h> |
|---|
| 22 | 24 | #include <linux/io-64-nonatomic-lo-hi.h> |
|---|
| 23 | 25 | #include <linux/platform_device.h> |
|---|
| .. | .. |
|---|
| 30 | 32 | /* plus one for fme device */ |
|---|
| 31 | 33 | #define MAX_DFL_FEATURE_DEV_NUM (MAX_DFL_FPGA_PORT_NUM + 1) |
|---|
| 32 | 34 | |
|---|
| 33 | | -/* Reserved 0x0 for Header Group Register and 0xff for AFU */ |
|---|
| 34 | | -#define FEATURE_ID_FIU_HEADER 0x0 |
|---|
| 35 | +/* Reserved 0xfe for Header Group Register and 0xff for AFU */ |
|---|
| 36 | +#define FEATURE_ID_FIU_HEADER 0xfe |
|---|
| 35 | 37 | #define FEATURE_ID_AFU 0xff |
|---|
| 36 | 38 | |
|---|
| 37 | 39 | #define FME_FEATURE_ID_HEADER FEATURE_ID_FIU_HEADER |
|---|
| .. | .. |
|---|
| 112 | 114 | #define FME_PORT_OFST_ACC_VF 1 |
|---|
| 113 | 115 | #define FME_PORT_OFST_IMP BIT_ULL(60) |
|---|
| 114 | 116 | |
|---|
| 117 | +/* FME Error Capability Register */ |
|---|
| 118 | +#define FME_ERROR_CAP 0x70 |
|---|
| 119 | + |
|---|
| 120 | +/* FME Error Capability Register Bitfield */ |
|---|
| 121 | +#define FME_ERROR_CAP_SUPP_INT BIT_ULL(0) /* Interrupt Support */ |
|---|
| 122 | +#define FME_ERROR_CAP_INT_VECT GENMASK_ULL(12, 1) /* Interrupt vector */ |
|---|
| 123 | + |
|---|
| 115 | 124 | /* PORT Header Register Set */ |
|---|
| 116 | 125 | #define PORT_HDR_DFH DFH |
|---|
| 117 | 126 | #define PORT_HDR_GUID_L GUID_L |
|---|
| .. | .. |
|---|
| 119 | 128 | #define PORT_HDR_NEXT_AFU NEXT_AFU |
|---|
| 120 | 129 | #define PORT_HDR_CAP 0x30 |
|---|
| 121 | 130 | #define PORT_HDR_CTRL 0x38 |
|---|
| 131 | +#define PORT_HDR_STS 0x40 |
|---|
| 132 | +#define PORT_HDR_USRCLK_CMD0 0x50 |
|---|
| 133 | +#define PORT_HDR_USRCLK_CMD1 0x58 |
|---|
| 134 | +#define PORT_HDR_USRCLK_STS0 0x60 |
|---|
| 135 | +#define PORT_HDR_USRCLK_STS1 0x68 |
|---|
| 122 | 136 | |
|---|
| 123 | 137 | /* Port Capability Register Bitfield */ |
|---|
| 124 | 138 | #define PORT_CAP_PORT_NUM GENMASK_ULL(1, 0) /* ID of this port */ |
|---|
| .. | .. |
|---|
| 130 | 144 | /* Latency tolerance reporting. '1' >= 40us, '0' < 40us.*/ |
|---|
| 131 | 145 | #define PORT_CTRL_LATENCY BIT_ULL(2) |
|---|
| 132 | 146 | #define PORT_CTRL_SFTRST_ACK BIT_ULL(4) /* HW ack for reset */ |
|---|
| 147 | + |
|---|
| 148 | +/* Port Status Register Bitfield */ |
|---|
| 149 | +#define PORT_STS_AP2_EVT BIT_ULL(13) /* AP2 event detected */ |
|---|
| 150 | +#define PORT_STS_AP1_EVT BIT_ULL(12) /* AP1 event detected */ |
|---|
| 151 | +#define PORT_STS_PWR_STATE GENMASK_ULL(11, 8) /* AFU power states */ |
|---|
| 152 | +#define PORT_STS_PWR_STATE_NORM 0 |
|---|
| 153 | +#define PORT_STS_PWR_STATE_AP1 1 /* 50% throttling */ |
|---|
| 154 | +#define PORT_STS_PWR_STATE_AP2 2 /* 90% throttling */ |
|---|
| 155 | +#define PORT_STS_PWR_STATE_AP6 6 /* 100% throttling */ |
|---|
| 156 | + |
|---|
| 157 | +/* Port Error Capability Register */ |
|---|
| 158 | +#define PORT_ERROR_CAP 0x38 |
|---|
| 159 | + |
|---|
| 160 | +/* Port Error Capability Register Bitfield */ |
|---|
| 161 | +#define PORT_ERROR_CAP_SUPP_INT BIT_ULL(0) /* Interrupt Support */ |
|---|
| 162 | +#define PORT_ERROR_CAP_INT_VECT GENMASK_ULL(12, 1) /* Interrupt vector */ |
|---|
| 163 | + |
|---|
| 164 | +/* Port Uint Capability Register */ |
|---|
| 165 | +#define PORT_UINT_CAP 0x8 |
|---|
| 166 | + |
|---|
| 167 | +/* Port Uint Capability Register Bitfield */ |
|---|
| 168 | +#define PORT_UINT_CAP_INT_NUM GENMASK_ULL(11, 0) /* Interrupts num */ |
|---|
| 169 | +#define PORT_UINT_CAP_FST_VECT GENMASK_ULL(23, 12) /* First Vector */ |
|---|
| 170 | + |
|---|
| 133 | 171 | /** |
|---|
| 134 | 172 | * struct dfl_fpga_port_ops - port ops |
|---|
| 135 | 173 | * |
|---|
| .. | .. |
|---|
| 154 | 192 | int dfl_fpga_check_port_id(struct platform_device *pdev, void *pport_id); |
|---|
| 155 | 193 | |
|---|
| 156 | 194 | /** |
|---|
| 157 | | - * struct dfl_feature_driver - sub feature's driver |
|---|
| 195 | + * struct dfl_feature_id - dfl private feature id |
|---|
| 158 | 196 | * |
|---|
| 159 | | - * @id: sub feature id. |
|---|
| 160 | | - * @ops: ops of this sub feature. |
|---|
| 197 | + * @id: unique dfl private feature id. |
|---|
| 198 | + */ |
|---|
| 199 | +struct dfl_feature_id { |
|---|
| 200 | + u16 id; |
|---|
| 201 | +}; |
|---|
| 202 | + |
|---|
| 203 | +/** |
|---|
| 204 | + * struct dfl_feature_driver - dfl private feature driver |
|---|
| 205 | + * |
|---|
| 206 | + * @id_table: id_table for dfl private features supported by this driver. |
|---|
| 207 | + * @ops: ops of this dfl private feature driver. |
|---|
| 161 | 208 | */ |
|---|
| 162 | 209 | struct dfl_feature_driver { |
|---|
| 163 | | - u64 id; |
|---|
| 210 | + const struct dfl_feature_id *id_table; |
|---|
| 164 | 211 | const struct dfl_feature_ops *ops; |
|---|
| 212 | +}; |
|---|
| 213 | + |
|---|
| 214 | +/** |
|---|
| 215 | + * struct dfl_feature_irq_ctx - dfl private feature interrupt context |
|---|
| 216 | + * |
|---|
| 217 | + * @irq: Linux IRQ number of this interrupt. |
|---|
| 218 | + * @trigger: eventfd context to signal when interrupt happens. |
|---|
| 219 | + * @name: irq name needed when requesting irq. |
|---|
| 220 | + */ |
|---|
| 221 | +struct dfl_feature_irq_ctx { |
|---|
| 222 | + int irq; |
|---|
| 223 | + struct eventfd_ctx *trigger; |
|---|
| 224 | + char *name; |
|---|
| 165 | 225 | }; |
|---|
| 166 | 226 | |
|---|
| 167 | 227 | /** |
|---|
| 168 | 228 | * struct dfl_feature - sub feature of the feature devices |
|---|
| 169 | 229 | * |
|---|
| 230 | + * @dev: ptr to pdev of the feature device which has the sub feature. |
|---|
| 170 | 231 | * @id: sub feature id. |
|---|
| 171 | 232 | * @resource_index: each sub feature has one mmio resource for its registers. |
|---|
| 172 | 233 | * this index is used to find its mmio resource from the |
|---|
| 173 | 234 | * feature dev (platform device)'s reources. |
|---|
| 174 | 235 | * @ioaddr: mapped mmio resource address. |
|---|
| 236 | + * @irq_ctx: interrupt context list. |
|---|
| 237 | + * @nr_irqs: number of interrupt contexts. |
|---|
| 175 | 238 | * @ops: ops of this sub feature. |
|---|
| 239 | + * @ddev: ptr to the dfl device of this sub feature. |
|---|
| 240 | + * @priv: priv data of this feature. |
|---|
| 176 | 241 | */ |
|---|
| 177 | 242 | struct dfl_feature { |
|---|
| 178 | | - u64 id; |
|---|
| 243 | + struct platform_device *dev; |
|---|
| 244 | + u16 id; |
|---|
| 179 | 245 | int resource_index; |
|---|
| 180 | 246 | void __iomem *ioaddr; |
|---|
| 247 | + struct dfl_feature_irq_ctx *irq_ctx; |
|---|
| 248 | + unsigned int nr_irqs; |
|---|
| 181 | 249 | const struct dfl_feature_ops *ops; |
|---|
| 250 | + struct dfl_device *ddev; |
|---|
| 251 | + void *priv; |
|---|
| 182 | 252 | }; |
|---|
| 183 | 253 | |
|---|
| 184 | | -#define DEV_STATUS_IN_USE 0 |
|---|
| 254 | +#define FEATURE_DEV_ID_UNUSED (-1) |
|---|
| 185 | 255 | |
|---|
| 186 | 256 | /** |
|---|
| 187 | 257 | * struct dfl_feature_platform_data - platform data for feature devices |
|---|
| .. | .. |
|---|
| 191 | 261 | * @cdev: cdev of feature dev. |
|---|
| 192 | 262 | * @dev: ptr to platform device linked with this platform data. |
|---|
| 193 | 263 | * @dfl_cdev: ptr to container device. |
|---|
| 264 | + * @id: id used for this feature device. |
|---|
| 194 | 265 | * @disable_count: count for port disable. |
|---|
| 266 | + * @excl_open: set on feature device exclusive open. |
|---|
| 267 | + * @open_count: count for feature device open. |
|---|
| 195 | 268 | * @num: number for sub features. |
|---|
| 196 | | - * @dev_status: dev status (e.g. DEV_STATUS_IN_USE). |
|---|
| 197 | 269 | * @private: ptr to feature dev private data. |
|---|
| 198 | 270 | * @features: sub features of this feature dev. |
|---|
| 199 | 271 | */ |
|---|
| .. | .. |
|---|
| 203 | 275 | struct cdev cdev; |
|---|
| 204 | 276 | struct platform_device *dev; |
|---|
| 205 | 277 | struct dfl_fpga_cdev *dfl_cdev; |
|---|
| 278 | + int id; |
|---|
| 206 | 279 | unsigned int disable_count; |
|---|
| 207 | | - unsigned long dev_status; |
|---|
| 280 | + bool excl_open; |
|---|
| 281 | + int open_count; |
|---|
| 208 | 282 | void *private; |
|---|
| 209 | 283 | int num; |
|---|
| 210 | | - struct dfl_feature features[0]; |
|---|
| 284 | + struct dfl_feature features[]; |
|---|
| 211 | 285 | }; |
|---|
| 212 | 286 | |
|---|
| 213 | 287 | static inline |
|---|
| 214 | | -int dfl_feature_dev_use_begin(struct dfl_feature_platform_data *pdata) |
|---|
| 288 | +int dfl_feature_dev_use_begin(struct dfl_feature_platform_data *pdata, |
|---|
| 289 | + bool excl) |
|---|
| 215 | 290 | { |
|---|
| 216 | | - /* Test and set IN_USE flags to ensure file is exclusively used */ |
|---|
| 217 | | - if (test_and_set_bit_lock(DEV_STATUS_IN_USE, &pdata->dev_status)) |
|---|
| 291 | + if (pdata->excl_open) |
|---|
| 218 | 292 | return -EBUSY; |
|---|
| 293 | + |
|---|
| 294 | + if (excl) { |
|---|
| 295 | + if (pdata->open_count) |
|---|
| 296 | + return -EBUSY; |
|---|
| 297 | + |
|---|
| 298 | + pdata->excl_open = true; |
|---|
| 299 | + } |
|---|
| 300 | + pdata->open_count++; |
|---|
| 219 | 301 | |
|---|
| 220 | 302 | return 0; |
|---|
| 221 | 303 | } |
|---|
| .. | .. |
|---|
| 223 | 305 | static inline |
|---|
| 224 | 306 | void dfl_feature_dev_use_end(struct dfl_feature_platform_data *pdata) |
|---|
| 225 | 307 | { |
|---|
| 226 | | - clear_bit_unlock(DEV_STATUS_IN_USE, &pdata->dev_status); |
|---|
| 308 | + pdata->excl_open = false; |
|---|
| 309 | + |
|---|
| 310 | + if (WARN_ON(pdata->open_count <= 0)) |
|---|
| 311 | + return; |
|---|
| 312 | + |
|---|
| 313 | + pdata->open_count--; |
|---|
| 314 | +} |
|---|
| 315 | + |
|---|
| 316 | +static inline |
|---|
| 317 | +int dfl_feature_dev_use_count(struct dfl_feature_platform_data *pdata) |
|---|
| 318 | +{ |
|---|
| 319 | + return pdata->open_count; |
|---|
| 227 | 320 | } |
|---|
| 228 | 321 | |
|---|
| 229 | 322 | static inline |
|---|
| .. | .. |
|---|
| 250 | 343 | #define DFL_FPGA_FEATURE_DEV_FME "dfl-fme" |
|---|
| 251 | 344 | #define DFL_FPGA_FEATURE_DEV_PORT "dfl-port" |
|---|
| 252 | 345 | |
|---|
| 253 | | -static inline int dfl_feature_platform_data_size(const int num) |
|---|
| 254 | | -{ |
|---|
| 255 | | - return sizeof(struct dfl_feature_platform_data) + |
|---|
| 256 | | - num * sizeof(struct dfl_feature); |
|---|
| 257 | | -} |
|---|
| 258 | | - |
|---|
| 259 | 346 | void dfl_fpga_dev_feature_uinit(struct platform_device *pdev); |
|---|
| 260 | 347 | int dfl_fpga_dev_feature_init(struct platform_device *pdev, |
|---|
| 261 | 348 | struct dfl_feature_driver *feature_drvs); |
|---|
| .. | .. |
|---|
| 280 | 367 | (feature) < (pdata)->features + (pdata)->num; (feature)++) |
|---|
| 281 | 368 | |
|---|
| 282 | 369 | static inline |
|---|
| 283 | | -struct dfl_feature *dfl_get_feature_by_id(struct device *dev, u64 id) |
|---|
| 370 | +struct dfl_feature *dfl_get_feature_by_id(struct device *dev, u16 id) |
|---|
| 284 | 371 | { |
|---|
| 285 | 372 | struct dfl_feature_platform_data *pdata = dev_get_platdata(dev); |
|---|
| 286 | 373 | struct dfl_feature *feature; |
|---|
| .. | .. |
|---|
| 293 | 380 | } |
|---|
| 294 | 381 | |
|---|
| 295 | 382 | static inline |
|---|
| 296 | | -void __iomem *dfl_get_feature_ioaddr_by_id(struct device *dev, u64 id) |
|---|
| 383 | +void __iomem *dfl_get_feature_ioaddr_by_id(struct device *dev, u16 id) |
|---|
| 297 | 384 | { |
|---|
| 298 | 385 | struct dfl_feature *feature = dfl_get_feature_by_id(dev, id); |
|---|
| 299 | 386 | |
|---|
| .. | .. |
|---|
| 304 | 391 | return NULL; |
|---|
| 305 | 392 | } |
|---|
| 306 | 393 | |
|---|
| 307 | | -static inline bool is_dfl_feature_present(struct device *dev, u64 id) |
|---|
| 394 | +static inline bool is_dfl_feature_present(struct device *dev, u16 id) |
|---|
| 308 | 395 | { |
|---|
| 309 | 396 | return !!dfl_get_feature_ioaddr_by_id(dev, id); |
|---|
| 310 | 397 | } |
|---|
| .. | .. |
|---|
| 331 | 418 | (FIELD_GET(DFH_ID, v) == DFH_ID_FIU_PORT); |
|---|
| 332 | 419 | } |
|---|
| 333 | 420 | |
|---|
| 421 | +static inline u8 dfl_feature_revision(void __iomem *base) |
|---|
| 422 | +{ |
|---|
| 423 | + return (u8)FIELD_GET(DFH_REVISION, readq(base + DFH)); |
|---|
| 424 | +} |
|---|
| 425 | + |
|---|
| 334 | 426 | /** |
|---|
| 335 | 427 | * struct dfl_fpga_enum_info - DFL FPGA enumeration information |
|---|
| 336 | 428 | * |
|---|
| 337 | 429 | * @dev: parent device. |
|---|
| 338 | 430 | * @dfls: list of device feature lists. |
|---|
| 431 | + * @nr_irqs: number of irqs for all feature devices. |
|---|
| 432 | + * @irq_table: Linux IRQ numbers for all irqs, indexed by hw irq numbers. |
|---|
| 339 | 433 | */ |
|---|
| 340 | 434 | struct dfl_fpga_enum_info { |
|---|
| 341 | 435 | struct device *dev; |
|---|
| 342 | 436 | struct list_head dfls; |
|---|
| 437 | + unsigned int nr_irqs; |
|---|
| 438 | + int *irq_table; |
|---|
| 343 | 439 | }; |
|---|
| 344 | 440 | |
|---|
| 345 | 441 | /** |
|---|
| .. | .. |
|---|
| 347 | 443 | * |
|---|
| 348 | 444 | * @start: base address of this device feature list. |
|---|
| 349 | 445 | * @len: size of this device feature list. |
|---|
| 350 | | - * @ioaddr: mapped base address of this device feature list. |
|---|
| 351 | 446 | * @node: node in list of device feature lists. |
|---|
| 352 | 447 | */ |
|---|
| 353 | 448 | struct dfl_fpga_enum_dfl { |
|---|
| 354 | 449 | resource_size_t start; |
|---|
| 355 | 450 | resource_size_t len; |
|---|
| 356 | | - |
|---|
| 357 | | - void __iomem *ioaddr; |
|---|
| 358 | | - |
|---|
| 359 | 451 | struct list_head node; |
|---|
| 360 | 452 | }; |
|---|
| 361 | 453 | |
|---|
| 362 | 454 | struct dfl_fpga_enum_info *dfl_fpga_enum_info_alloc(struct device *dev); |
|---|
| 363 | 455 | int dfl_fpga_enum_info_add_dfl(struct dfl_fpga_enum_info *info, |
|---|
| 364 | | - resource_size_t start, resource_size_t len, |
|---|
| 365 | | - void __iomem *ioaddr); |
|---|
| 456 | + resource_size_t start, resource_size_t len); |
|---|
| 457 | +int dfl_fpga_enum_info_add_irq(struct dfl_fpga_enum_info *info, |
|---|
| 458 | + unsigned int nr_irqs, int *irq_table); |
|---|
| 366 | 459 | void dfl_fpga_enum_info_free(struct dfl_fpga_enum_info *info); |
|---|
| 367 | 460 | |
|---|
| 368 | 461 | /** |
|---|
| .. | .. |
|---|
| 373 | 466 | * @fme_dev: FME feature device under this container device. |
|---|
| 374 | 467 | * @lock: mutex lock to protect the port device list. |
|---|
| 375 | 468 | * @port_dev_list: list of all port feature devices under this container device. |
|---|
| 469 | + * @released_port_num: released port number under this container device. |
|---|
| 376 | 470 | */ |
|---|
| 377 | 471 | struct dfl_fpga_cdev { |
|---|
| 378 | 472 | struct device *parent; |
|---|
| .. | .. |
|---|
| 380 | 474 | struct device *fme_dev; |
|---|
| 381 | 475 | struct mutex lock; |
|---|
| 382 | 476 | struct list_head port_dev_list; |
|---|
| 477 | + int released_port_num; |
|---|
| 383 | 478 | }; |
|---|
| 384 | 479 | |
|---|
| 385 | 480 | struct dfl_fpga_cdev * |
|---|
| .. | .. |
|---|
| 407 | 502 | |
|---|
| 408 | 503 | return pdev; |
|---|
| 409 | 504 | } |
|---|
| 505 | + |
|---|
| 506 | +int dfl_fpga_cdev_release_port(struct dfl_fpga_cdev *cdev, int port_id); |
|---|
| 507 | +int dfl_fpga_cdev_assign_port(struct dfl_fpga_cdev *cdev, int port_id); |
|---|
| 508 | +void dfl_fpga_cdev_config_ports_pf(struct dfl_fpga_cdev *cdev); |
|---|
| 509 | +int dfl_fpga_cdev_config_ports_vf(struct dfl_fpga_cdev *cdev, int num_vf); |
|---|
| 510 | +int dfl_fpga_set_irq_triggers(struct dfl_feature *feature, unsigned int start, |
|---|
| 511 | + unsigned int count, int32_t *fds); |
|---|
| 512 | +long dfl_feature_ioctl_get_num_irqs(struct platform_device *pdev, |
|---|
| 513 | + struct dfl_feature *feature, |
|---|
| 514 | + unsigned long arg); |
|---|
| 515 | +long dfl_feature_ioctl_set_irq(struct platform_device *pdev, |
|---|
| 516 | + struct dfl_feature *feature, |
|---|
| 517 | + unsigned long arg); |
|---|
| 518 | + |
|---|
| 519 | +/** |
|---|
| 520 | + * enum dfl_id_type - define the DFL FIU types |
|---|
| 521 | + */ |
|---|
| 522 | +enum dfl_id_type { |
|---|
| 523 | + FME_ID, |
|---|
| 524 | + PORT_ID, |
|---|
| 525 | + DFL_ID_MAX, |
|---|
| 526 | +}; |
|---|
| 527 | + |
|---|
| 528 | +/** |
|---|
| 529 | + * struct dfl_device_id - dfl device identifier |
|---|
| 530 | + * @type: contains 4 bits DFL FIU type of the device. See enum dfl_id_type. |
|---|
| 531 | + * @feature_id: contains 12 bits feature identifier local to its DFL FIU type. |
|---|
| 532 | + * @driver_data: driver specific data. |
|---|
| 533 | + */ |
|---|
| 534 | +struct dfl_device_id { |
|---|
| 535 | + u8 type; |
|---|
| 536 | + u16 feature_id; |
|---|
| 537 | + unsigned long driver_data; |
|---|
| 538 | +}; |
|---|
| 539 | + |
|---|
| 540 | +/** |
|---|
| 541 | + * struct dfl_device - represent an dfl device on dfl bus |
|---|
| 542 | + * |
|---|
| 543 | + * @dev: generic device interface. |
|---|
| 544 | + * @id: id of the dfl device. |
|---|
| 545 | + * @type: type of DFL FIU of the device. See enum dfl_id_type. |
|---|
| 546 | + * @feature_id: 16 bits feature identifier local to its DFL FIU type. |
|---|
| 547 | + * @mmio_res: mmio resource of this dfl device. |
|---|
| 548 | + * @irqs: list of Linux IRQ numbers of this dfl device. |
|---|
| 549 | + * @num_irqs: number of IRQs supported by this dfl device. |
|---|
| 550 | + * @cdev: pointer to DFL FPGA container device this dfl device belongs to. |
|---|
| 551 | + * @id_entry: matched id entry in dfl driver's id table. |
|---|
| 552 | + */ |
|---|
| 553 | +struct dfl_device { |
|---|
| 554 | + struct device dev; |
|---|
| 555 | + int id; |
|---|
| 556 | + u8 type; |
|---|
| 557 | + u16 feature_id; |
|---|
| 558 | + struct resource mmio_res; |
|---|
| 559 | + int *irqs; |
|---|
| 560 | + unsigned int num_irqs; |
|---|
| 561 | + struct dfl_fpga_cdev *cdev; |
|---|
| 562 | + const struct dfl_device_id *id_entry; |
|---|
| 563 | +}; |
|---|
| 564 | + |
|---|
| 565 | +/** |
|---|
| 566 | + * struct dfl_driver - represent an dfl device driver |
|---|
| 567 | + * |
|---|
| 568 | + * @drv: driver model structure. |
|---|
| 569 | + * @id_table: pointer to table of device IDs the driver is interested in. |
|---|
| 570 | + * { } member terminated. |
|---|
| 571 | + * @probe: mandatory callback for device binding. |
|---|
| 572 | + * @remove: callback for device unbinding. |
|---|
| 573 | + */ |
|---|
| 574 | +struct dfl_driver { |
|---|
| 575 | + struct device_driver drv; |
|---|
| 576 | + const struct dfl_device_id *id_table; |
|---|
| 577 | + |
|---|
| 578 | + int (*probe)(struct dfl_device *dfl_dev); |
|---|
| 579 | + void (*remove)(struct dfl_device *dfl_dev); |
|---|
| 580 | +}; |
|---|
| 581 | + |
|---|
| 582 | +#define to_dfl_dev(d) container_of(d, struct dfl_device, dev) |
|---|
| 583 | +#define to_dfl_drv(d) container_of(d, struct dfl_driver, drv) |
|---|
| 584 | + |
|---|
| 585 | +/* |
|---|
| 586 | + * use a macro to avoid include chaining to get THIS_MODULE. |
|---|
| 587 | + */ |
|---|
| 588 | +#define dfl_driver_register(drv) \ |
|---|
| 589 | + __dfl_driver_register(drv, THIS_MODULE) |
|---|
| 590 | +int __dfl_driver_register(struct dfl_driver *dfl_drv, struct module *owner); |
|---|
| 591 | +void dfl_driver_unregister(struct dfl_driver *dfl_drv); |
|---|
| 592 | + |
|---|
| 593 | +/* |
|---|
| 594 | + * module_dfl_driver() - Helper macro for drivers that don't do |
|---|
| 595 | + * anything special in module init/exit. This eliminates a lot of |
|---|
| 596 | + * boilerplate. Each module may only use this macro once, and |
|---|
| 597 | + * calling it replaces module_init() and module_exit(). |
|---|
| 598 | + */ |
|---|
| 599 | +#define module_dfl_driver(__dfl_driver) \ |
|---|
| 600 | + module_driver(__dfl_driver, dfl_driver_register, \ |
|---|
| 601 | + dfl_driver_unregister) |
|---|
| 602 | + |
|---|
| 410 | 603 | #endif /* __FPGA_DFL_H */ |
|---|