summaryrefslogtreecommitdiffstats
path: root/driver/common.h
blob: 48b276941ab0b29e2b041bcf9e3ea112d66430df (plain)
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
#ifndef _PCIDRIVER_COMMON_H
#define _PCIDRIVER_COMMON_H

#include "../pcilib/kmem.h"
/*************************************************************************/
/* Private data types and structures */


/* Define an entry in the kmem list (this list is per device) */
/* This list keeps references to the allocated kernel buffers */
typedef struct {
    int id;
    enum dma_data_direction direction;

    struct list_head list;
    dma_addr_t dma_handle;
    unsigned long cpua;
    unsigned long size;
    unsigned long type;
    unsigned long align;

    unsigned long use;
    unsigned long item;

    spinlock_t lock;
    unsigned long mode;
    unsigned long refs;

    struct class_device_attribute sysfs_attr;	/* initialized when adding the entry */
} pcidriver_kmem_entry_t;

/* Define an entry in the umem list (this list is per device) */
/* This list keeps references to the SG lists for each mapped userspace region */
typedef struct {
    int id;
    struct list_head list;
    unsigned int nr_pages;		/* number of pages for this user memeory area */
    struct page **pages;		/* list of pointers to the pages */
    unsigned int nents;		/* actual entries in the scatter/gatter list (NOT nents for the map function, but the result) */
    struct scatterlist *sg;		/* list of sg entries */
    struct class_device_attribute sysfs_attr;	/* initialized when adding the entry */
} pcidriver_umem_entry_t;

/* Hold the driver private data */
typedef struct  {
    int devid;                                      /* the device id */
    dev_t devno;					/* device number (major and minor) */
    struct pci_dev *pdev;				/* PCI device */
    struct class_device *class_dev;                 /* Class device */
    struct cdev cdev;				/* char device struct */
    int mmap_mode;					/* current mmap mode */
    int mmap_area;					/* current PCI mmap area */

#ifdef ENABLE_IRQ
    int irq_enabled;				/* Non-zero if IRQ is enabled */
    int irq_count;					/* Just an IRQ counter */

    wait_queue_head_t irq_queues[ PCIDRIVER_INT_MAXSOURCES ];       /* One queue per interrupt source */
    atomic_t irq_outstanding[ PCIDRIVER_INT_MAXSOURCES ];           /* Outstanding interrupts per queue */
    volatile unsigned int *bars_kmapped[6];		                /* PCI BARs mmapped in kernel space */
#endif

    spinlock_t kmemlist_lock;			/* Spinlock to lock kmem list operations */
    struct list_head kmem_list;			/* List of 'kmem_list_entry's associated with this device */
    pcidriver_kmem_entry_t *kmem_last_sync;		/* Last accessed kmem entry */
    atomic_t kmem_count;				/* id for next kmem entry */

    int kmem_cur_id;				/* Currently selected kmem buffer, for mmap */

    spinlock_t umemlist_lock;			/* Spinlock to lock umem list operations */
    struct list_head umem_list;			/* List of 'umem_list_entry's associated with this device */
    atomic_t umem_count;				/* id for next umem entry */

    int msi_mode;					/* Flag specifying if interrupt have been initialized in MSI mode */
    atomic_t refs;					/* Reference counter */
} pcidriver_privdata_t;


void pcidriver_module_get(pcidriver_privdata_t *privdata);
void pcidriver_module_put(pcidriver_privdata_t *privdata);

pcidriver_privdata_t *pcidriver_get_privdata(int devid);
void pcidriver_put_privdata(pcidriver_privdata_t *privdata);


/*************************************************************************/
/* Some nice defines that make code more readable */
/* This is to print nice info in the log */

#ifdef DEBUG
#define mod_info( args... ) \
    do { printk( KERN_INFO "%s - %s : ", MODNAME , __FUNCTION__ );\
    printk( args ); } while(0)
#define mod_info_dbg( args... ) \
    do { printk( KERN_INFO "%s - %s : ", MODNAME , __FUNCTION__ );\
    printk( args ); } while(0)
#else
#define mod_info( args... ) \
    do { printk( KERN_INFO "%s: ", MODNAME );\
    printk( args ); } while(0)
#define mod_info_dbg( args... )
#endif

#define mod_crit( args... ) \
    do { printk( KERN_CRIT "%s: ", MODNAME );\
    printk( args ); } while(0)

#define MIN(a, b) ((a) < (b) ? (a) : (b))

#endif