video: tegra: host: Remove version from dev name
[linux-2.6.git] / include / linux / nvhost.h
1 /*
2  * include/linux/nvhost.h
3  *
4  * Tegra graphics host driver
5  *
6  * Copyright (c) 2009-2012, NVIDIA Corporation.
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation; either version 2 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful, but WITHOUT
14  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
15  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
16  * more details.
17  *
18  * You should have received a copy of the GNU General Public License along
19  * with this program; if not, write to the Free Software Foundation, Inc.,
20  * 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21  */
22
23 #ifndef __LINUX_NVHOST_H
24 #define __LINUX_NVHOST_H
25
26 #include <linux/device.h>
27 #include <linux/types.h>
28
29 struct nvhost_master;
30
31 #define NVHOST_MODULE_MAX_CLOCKS 3
32 #define NVHOST_MODULE_MAX_POWERGATE_IDS 2
33 #define NVHOST_MODULE_NO_POWERGATE_IDS .powergate_ids = {-1, -1}
34 #define NVHOST_DEFAULT_CLOCKGATE_DELAY .clockgate_delay = 25
35 #define NVHOST_NAME_SIZE        24
36
37 struct nvhost_device_id {
38         char name[NVHOST_NAME_SIZE];
39         unsigned long version;
40 };
41
42 struct nvhost_clock {
43         char *name;
44         long default_rate;
45 };
46
47 enum nvhost_device_powerstate_t {
48         NVHOST_POWER_STATE_DEINIT,
49         NVHOST_POWER_STATE_RUNNING,
50         NVHOST_POWER_STATE_CLOCKGATED,
51         NVHOST_POWER_STATE_POWERGATED
52 };
53
54 struct nvhost_device {
55         const char      *name;          /* device name */
56         int             version;        /* ip version number of device */
57         struct device   dev;            /* Linux device struct */
58         int             id;             /* Separates clients of same hw */
59         int             index;          /* Hardware channel number */
60         u32             num_resources;  /* Number of resources following */
61         struct resource *resource;      /* Resources (IOMEM in particular) */
62         struct resource *reg_mem;
63         void __iomem    *aperture;      /* Iomem mapped to kernel */
64
65         u32             syncpts;        /* Bitfield of sync points used */
66         u32             waitbases;      /* Bit field of wait bases */
67         u32             modulemutexes;  /* Bit field of module mutexes */
68         u32             moduleid;       /* Module id for user space API */
69
70         u32             class;          /* Device class */
71         bool            exclusive;      /* True if only one user at a time */
72         bool            keepalive;      /* Do not power gate when opened */
73         bool            waitbasesync;   /* Force sync of wait bases */
74         bool            powerup_reset;  /* Do a reset after power un-gating */
75
76         int             powergate_ids[NVHOST_MODULE_MAX_POWERGATE_IDS];
77         bool            can_powergate;  /* True if module can be power gated */
78         int             clockgate_delay;/* Delay before clock gated */
79         int             powergate_delay;/* Delay before power gated */
80         struct nvhost_clock clocks[NVHOST_MODULE_MAX_CLOCKS];/* Clock names */
81
82         struct delayed_work powerstate_down;/* Power state management */
83         int             num_clks;       /* Number of clocks opened for dev */
84         struct clk      *clk[NVHOST_MODULE_MAX_CLOCKS];
85         struct mutex    lock;           /* Power management lock */
86         int             powerstate;     /* Current power state */
87         int             refcount;       /* Number of tasks active */
88         wait_queue_head_t idle_wq;      /* Work queue for idle */
89         struct list_head client_list;   /* List of clients and rate requests */
90
91         struct nvhost_channel *channel; /* Channel assigned for the module */
92 };
93
94 /* Register devices to nvhost bus */
95 extern int nvhost_add_devices(struct nvhost_device **, int num);
96
97 /* Register device to nvhost bus */
98 extern int nvhost_device_register(struct nvhost_device *);
99
100 /* Deregister device from nvhost bus */
101 extern void nvhost_device_unregister(struct nvhost_device *);
102
103 extern struct bus_type nvhost_bus_type;
104
105 struct nvhost_driver {
106         int (*probe)(struct nvhost_device *, struct nvhost_device_id *);
107         int (*remove)(struct nvhost_device *);
108         void (*shutdown)(struct nvhost_device *);
109         int (*suspend)(struct nvhost_device *, pm_message_t state);
110         int (*resume)(struct nvhost_device *);
111         struct device_driver driver;
112
113         struct nvhost_device_id *id_table;
114
115         /* Finalize power on. Can be used for context restore. */
116         void (*finalize_poweron)(struct nvhost_device *dev);
117
118         /* Device is busy. */
119         void (*busy)(struct nvhost_device *);
120
121         /* Device is idle. */
122         void (*idle)(struct nvhost_device *);
123
124         /* Device is going to be suspended */
125         void (*suspend_ndev)(struct nvhost_device *);
126
127         /* Device is initialized */
128         void (*init)(struct nvhost_device *dev);
129
130         /* Device is de-initialized. */
131         void (*deinit)(struct nvhost_device *dev);
132
133         /* Preparing for power off. Used for context save. */
134         int (*prepare_poweroff)(struct nvhost_device *dev);
135
136         /* Allocates a context handler for the device */
137         struct nvhost_hwctx_handler *(*alloc_hwctx_handler)(u32 syncpt,
138                         u32 waitbase, struct nvhost_channel *ch);
139 };
140
141 extern int nvhost_driver_register(struct nvhost_driver *);
142 extern void nvhost_driver_unregister(struct nvhost_driver *);
143 extern struct resource *nvhost_get_resource(struct nvhost_device *,
144                 unsigned int, unsigned int);
145 extern int nvhost_get_irq(struct nvhost_device *, unsigned int);
146 extern struct resource *nvhost_get_resource_byname(struct nvhost_device *,
147                 unsigned int, const char *);
148 extern int nvhost_get_irq_byname(struct nvhost_device *, const char *);
149
150 #define to_nvhost_device(x)     container_of((x), struct nvhost_device, dev)
151 #define to_nvhost_driver(drv)   (container_of((drv), struct nvhost_driver, \
152                                  driver))
153
154 #define nvhost_get_drvdata(_dev)        dev_get_drvdata(&(_dev)->dev)
155 #define nvhost_set_drvdata(_dev, data)  dev_set_drvdata(&(_dev)->dev, (data))
156 static inline struct nvhost_master *nvhost_get_host(struct nvhost_device *_dev)
157 {
158         return (_dev->dev.parent) ? \
159                 ((struct nvhost_master *) dev_get_drvdata(_dev->dev.parent)) : \
160                 ((struct nvhost_master *) dev_get_drvdata(&(_dev->dev)));
161 }
162
163 int nvhost_bus_add_host(struct nvhost_master *host);
164
165 #endif