blob: 150fdeea11a1b144b9683f7a1676331ae7e21bc7 [file] [log] [blame]
Ben Skeggs6ee73862009-12-11 19:24:15 +10001/*
2 * Copyright 2005 Stephane Marchesin.
3 * All Rights Reserved.
4 *
5 * Permission is hereby granted, free of charge, to any person obtaining a
6 * copy of this software and associated documentation files (the "Software"),
7 * to deal in the Software without restriction, including without limitation
8 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
9 * and/or sell copies of the Software, and to permit persons to whom the
10 * Software is furnished to do so, subject to the following conditions:
11 *
12 * The above copyright notice and this permission notice (including the next
13 * paragraph) shall be included in all copies or substantial portions of the
14 * Software.
15 *
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25#ifndef __NOUVEAU_DRV_H__
26#define __NOUVEAU_DRV_H__
27
28#define DRIVER_AUTHOR "Stephane Marchesin"
29#define DRIVER_EMAIL "dri-devel@lists.sourceforge.net"
30
31#define DRIVER_NAME "nouveau"
32#define DRIVER_DESC "nVidia Riva/TNT/GeForce"
33#define DRIVER_DATE "20090420"
34
35#define DRIVER_MAJOR 0
36#define DRIVER_MINOR 0
Ben Skeggsa1606a92010-02-12 10:27:35 +100037#define DRIVER_PATCHLEVEL 16
Ben Skeggs6ee73862009-12-11 19:24:15 +100038
39#define NOUVEAU_FAMILY 0x0000FFFF
40#define NOUVEAU_FLAGS 0xFFFF0000
41
42#include "ttm/ttm_bo_api.h"
43#include "ttm/ttm_bo_driver.h"
44#include "ttm/ttm_placement.h"
45#include "ttm/ttm_memory.h"
46#include "ttm/ttm_module.h"
47
48struct nouveau_fpriv {
49 struct ttm_object_file *tfile;
50};
51
52#define DRM_FILE_PAGE_OFFSET (0x100000000ULL >> PAGE_SHIFT)
53
54#include "nouveau_drm.h"
55#include "nouveau_reg.h"
56#include "nouveau_bios.h"
Ben Skeggs054b93e2009-12-15 22:02:47 +100057struct nouveau_grctx;
Ben Skeggs6ee73862009-12-11 19:24:15 +100058
59#define MAX_NUM_DCB_ENTRIES 16
60
61#define NOUVEAU_MAX_CHANNEL_NR 128
Francisco Jereza0af9ad2009-12-11 16:51:09 +010062#define NOUVEAU_MAX_TILE_NR 15
Ben Skeggs6ee73862009-12-11 19:24:15 +100063
64#define NV50_VM_MAX_VRAM (2*1024*1024*1024ULL)
65#define NV50_VM_BLOCK (512*1024*1024ULL)
66#define NV50_VM_VRAM_NR (NV50_VM_MAX_VRAM / NV50_VM_BLOCK)
67
Francisco Jereza0af9ad2009-12-11 16:51:09 +010068struct nouveau_tile_reg {
69 struct nouveau_fence *fence;
70 uint32_t addr;
71 uint32_t size;
72 bool used;
73};
74
Ben Skeggs6ee73862009-12-11 19:24:15 +100075struct nouveau_bo {
76 struct ttm_buffer_object bo;
77 struct ttm_placement placement;
78 u32 placements[3];
Francisco Jerez78ad0f72010-03-18 13:07:47 +010079 u32 busy_placements[3];
Ben Skeggs6ee73862009-12-11 19:24:15 +100080 struct ttm_bo_kmap_obj kmap;
81 struct list_head head;
82
83 /* protected by ttm_bo_reserve() */
84 struct drm_file *reserved_by;
85 struct list_head entry;
86 int pbbo_index;
Ben Skeggsa1606a92010-02-12 10:27:35 +100087 bool validate_mapped;
Ben Skeggs6ee73862009-12-11 19:24:15 +100088
89 struct nouveau_channel *channel;
90
91 bool mappable;
92 bool no_vm;
93
94 uint32_t tile_mode;
95 uint32_t tile_flags;
Francisco Jereza0af9ad2009-12-11 16:51:09 +010096 struct nouveau_tile_reg *tile;
Ben Skeggs6ee73862009-12-11 19:24:15 +100097
98 struct drm_gem_object *gem;
99 struct drm_file *cpu_filp;
100 int pin_refcnt;
101};
102
103static inline struct nouveau_bo *
104nouveau_bo(struct ttm_buffer_object *bo)
105{
106 return container_of(bo, struct nouveau_bo, bo);
107}
108
109static inline struct nouveau_bo *
110nouveau_gem_object(struct drm_gem_object *gem)
111{
112 return gem ? gem->driver_private : NULL;
113}
114
115/* TODO: submit equivalent to TTM generic API upstream? */
116static inline void __iomem *
117nvbo_kmap_obj_iovirtual(struct nouveau_bo *nvbo)
118{
119 bool is_iomem;
120 void __iomem *ioptr = (void __force __iomem *)ttm_kmap_obj_virtual(
121 &nvbo->kmap, &is_iomem);
122 WARN_ON_ONCE(ioptr && !is_iomem);
123 return ioptr;
124}
125
Ben Skeggs6ee73862009-12-11 19:24:15 +1000126enum nouveau_flags {
127 NV_NFORCE = 0x10000000,
128 NV_NFORCE2 = 0x20000000
129};
130
131#define NVOBJ_ENGINE_SW 0
132#define NVOBJ_ENGINE_GR 1
133#define NVOBJ_ENGINE_DISPLAY 2
134#define NVOBJ_ENGINE_INT 0xdeadbeef
135
Ben Skeggs6ee73862009-12-11 19:24:15 +1000136#define NVOBJ_FLAG_ZERO_ALLOC (1 << 1)
137#define NVOBJ_FLAG_ZERO_FREE (1 << 2)
Ben Skeggs6ee73862009-12-11 19:24:15 +1000138struct nouveau_gpuobj {
Ben Skeggsb3beb162010-09-01 15:24:29 +1000139 struct drm_device *dev;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000140 struct list_head list;
141
Ben Skeggsb833ac22010-06-01 15:32:24 +1000142 struct drm_mm_node *im_pramin;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000143 struct nouveau_bo *im_backing;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000144 uint32_t *im_backing_suspend;
145 int im_bound;
146
147 uint32_t flags;
148 int refcount;
149
Ben Skeggs43efc9c2010-09-01 15:24:32 +1000150 u32 size;
Ben Skeggsde3a6c02010-09-01 15:24:30 +1000151 u32 pinst;
152 u32 cinst;
153 u64 vinst;
154
Ben Skeggs6ee73862009-12-11 19:24:15 +1000155 uint32_t engine;
156 uint32_t class;
157
158 void (*dtor)(struct drm_device *, struct nouveau_gpuobj *);
159 void *priv;
160};
161
Ben Skeggs6ee73862009-12-11 19:24:15 +1000162struct nouveau_channel {
163 struct drm_device *dev;
164 int id;
165
166 /* owner of this fifo */
167 struct drm_file *file_priv;
168 /* mapping of the fifo itself */
169 struct drm_local_map *map;
170
171 /* mapping of the regs controling the fifo */
172 void __iomem *user;
173 uint32_t user_get;
174 uint32_t user_put;
175
176 /* Fencing */
177 struct {
178 /* lock protects the pending list only */
179 spinlock_t lock;
180 struct list_head pending;
181 uint32_t sequence;
182 uint32_t sequence_ack;
Ben Skeggs047d1d32010-05-31 12:00:43 +1000183 atomic_t last_sequence_irq;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000184 } fence;
185
186 /* DMA push buffer */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000187 struct nouveau_gpuobj *pushbuf;
188 struct nouveau_bo *pushbuf_bo;
189 uint32_t pushbuf_base;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000190
191 /* Notifier memory */
192 struct nouveau_bo *notifier_bo;
Ben Skeggsb833ac22010-06-01 15:32:24 +1000193 struct drm_mm notifier_heap;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000194
195 /* PFIFO context */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000196 struct nouveau_gpuobj *ramfc;
197 struct nouveau_gpuobj *cache;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000198
199 /* PGRAPH context */
200 /* XXX may be merge 2 pointers as private data ??? */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000201 struct nouveau_gpuobj *ramin_grctx;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000202 void *pgraph_ctx;
203
204 /* NV50 VM */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000205 struct nouveau_gpuobj *vm_pd;
206 struct nouveau_gpuobj *vm_gart_pt;
207 struct nouveau_gpuobj *vm_vram_pt[NV50_VM_VRAM_NR];
Ben Skeggs6ee73862009-12-11 19:24:15 +1000208
209 /* Objects */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000210 struct nouveau_gpuobj *ramin; /* Private instmem */
211 struct drm_mm ramin_heap; /* Private PRAMIN heap */
212 struct nouveau_ramht *ramht; /* Hash table */
Ben Skeggs6ee73862009-12-11 19:24:15 +1000213
214 /* GPU object info for stuff used in-kernel (mm_enabled) */
215 uint32_t m2mf_ntfy;
216 uint32_t vram_handle;
217 uint32_t gart_handle;
218 bool accel_done;
219
220 /* Push buffer state (only for drm's channel on !mm_enabled) */
221 struct {
222 int max;
223 int free;
224 int cur;
225 int put;
226 /* access via pushbuf_bo */
Ben Skeggs9a391ad2010-02-11 16:37:26 +1000227
228 int ib_base;
229 int ib_max;
230 int ib_free;
231 int ib_put;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000232 } dma;
233
234 uint32_t sw_subchannel[8];
235
236 struct {
237 struct nouveau_gpuobj *vblsem;
238 uint32_t vblsem_offset;
239 uint32_t vblsem_rval;
240 struct list_head vbl_wait;
241 } nvsw;
242
243 struct {
244 bool active;
245 char name[32];
246 struct drm_info_list info;
247 } debugfs;
248};
249
250struct nouveau_instmem_engine {
251 void *priv;
252
253 int (*init)(struct drm_device *dev);
254 void (*takedown)(struct drm_device *dev);
255 int (*suspend)(struct drm_device *dev);
256 void (*resume)(struct drm_device *dev);
257
258 int (*populate)(struct drm_device *, struct nouveau_gpuobj *,
259 uint32_t *size);
260 void (*clear)(struct drm_device *, struct nouveau_gpuobj *);
261 int (*bind)(struct drm_device *, struct nouveau_gpuobj *);
262 int (*unbind)(struct drm_device *, struct nouveau_gpuobj *);
Ben Skeggsf56cb862010-07-08 11:29:10 +1000263 void (*flush)(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000264};
265
266struct nouveau_mc_engine {
267 int (*init)(struct drm_device *dev);
268 void (*takedown)(struct drm_device *dev);
269};
270
271struct nouveau_timer_engine {
272 int (*init)(struct drm_device *dev);
273 void (*takedown)(struct drm_device *dev);
274 uint64_t (*read)(struct drm_device *dev);
275};
276
277struct nouveau_fb_engine {
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100278 int num_tiles;
279
Ben Skeggs6ee73862009-12-11 19:24:15 +1000280 int (*init)(struct drm_device *dev);
281 void (*takedown)(struct drm_device *dev);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100282
283 void (*set_region_tiling)(struct drm_device *dev, int i, uint32_t addr,
284 uint32_t size, uint32_t pitch);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000285};
286
287struct nouveau_fifo_engine {
Ben Skeggs6ee73862009-12-11 19:24:15 +1000288 int channels;
289
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000290 struct nouveau_gpuobj *playlist[2];
Ben Skeggsac94a342010-07-08 15:28:48 +1000291 int cur_playlist;
292
Ben Skeggs6ee73862009-12-11 19:24:15 +1000293 int (*init)(struct drm_device *);
294 void (*takedown)(struct drm_device *);
295
296 void (*disable)(struct drm_device *);
297 void (*enable)(struct drm_device *);
298 bool (*reassign)(struct drm_device *, bool enable);
Francisco Jerez588d7d12009-12-13 20:07:42 +0100299 bool (*cache_flush)(struct drm_device *dev);
300 bool (*cache_pull)(struct drm_device *dev, bool enable);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000301
302 int (*channel_id)(struct drm_device *);
303
304 int (*create_context)(struct nouveau_channel *);
305 void (*destroy_context)(struct nouveau_channel *);
306 int (*load_context)(struct nouveau_channel *);
307 int (*unload_context)(struct drm_device *);
308};
309
310struct nouveau_pgraph_object_method {
311 int id;
312 int (*exec)(struct nouveau_channel *chan, int grclass, int mthd,
313 uint32_t data);
314};
315
316struct nouveau_pgraph_object_class {
317 int id;
318 bool software;
319 struct nouveau_pgraph_object_method *methods;
320};
321
322struct nouveau_pgraph_engine {
323 struct nouveau_pgraph_object_class *grclass;
324 bool accel_blocked;
Ben Skeggs054b93e2009-12-15 22:02:47 +1000325 int grctx_size;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000326
Ben Skeggsc50a5682010-07-08 15:40:18 +1000327 /* NV2x/NV3x context table (0x400780) */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000328 struct nouveau_gpuobj *ctx_table;
Ben Skeggsc50a5682010-07-08 15:40:18 +1000329
Ben Skeggs6ee73862009-12-11 19:24:15 +1000330 int (*init)(struct drm_device *);
331 void (*takedown)(struct drm_device *);
332
333 void (*fifo_access)(struct drm_device *, bool);
334
335 struct nouveau_channel *(*channel)(struct drm_device *);
336 int (*create_context)(struct nouveau_channel *);
337 void (*destroy_context)(struct nouveau_channel *);
338 int (*load_context)(struct nouveau_channel *);
339 int (*unload_context)(struct drm_device *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100340
341 void (*set_region_tiling)(struct drm_device *dev, int i, uint32_t addr,
342 uint32_t size, uint32_t pitch);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000343};
344
Francisco Jerezc88c2e02010-07-24 17:37:33 +0200345struct nouveau_display_engine {
346 int (*early_init)(struct drm_device *);
347 void (*late_takedown)(struct drm_device *);
348 int (*create)(struct drm_device *);
349 int (*init)(struct drm_device *);
350 void (*destroy)(struct drm_device *);
351};
352
Ben Skeggsee2e0132010-07-26 09:28:25 +1000353struct nouveau_gpio_engine {
354 int (*init)(struct drm_device *);
355 void (*takedown)(struct drm_device *);
356
357 int (*get)(struct drm_device *, enum dcb_gpio_tag);
358 int (*set)(struct drm_device *, enum dcb_gpio_tag, int state);
359
360 void (*irq_enable)(struct drm_device *, enum dcb_gpio_tag, bool on);
361};
362
Ben Skeggs6ee73862009-12-11 19:24:15 +1000363struct nouveau_engine {
364 struct nouveau_instmem_engine instmem;
365 struct nouveau_mc_engine mc;
366 struct nouveau_timer_engine timer;
367 struct nouveau_fb_engine fb;
368 struct nouveau_pgraph_engine graph;
369 struct nouveau_fifo_engine fifo;
Francisco Jerezc88c2e02010-07-24 17:37:33 +0200370 struct nouveau_display_engine display;
Ben Skeggsee2e0132010-07-26 09:28:25 +1000371 struct nouveau_gpio_engine gpio;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000372};
373
374struct nouveau_pll_vals {
375 union {
376 struct {
377#ifdef __BIG_ENDIAN
378 uint8_t N1, M1, N2, M2;
379#else
380 uint8_t M1, N1, M2, N2;
381#endif
382 };
383 struct {
384 uint16_t NM1, NM2;
385 } __attribute__((packed));
386 };
387 int log2P;
388
389 int refclk;
390};
391
392enum nv04_fp_display_regs {
393 FP_DISPLAY_END,
394 FP_TOTAL,
395 FP_CRTC,
396 FP_SYNC_START,
397 FP_SYNC_END,
398 FP_VALID_START,
399 FP_VALID_END
400};
401
402struct nv04_crtc_reg {
403 unsigned char MiscOutReg; /* */
Francisco Jerez4a9f8222010-07-20 16:48:08 +0200404 uint8_t CRTC[0xa0];
Ben Skeggs6ee73862009-12-11 19:24:15 +1000405 uint8_t CR58[0x10];
406 uint8_t Sequencer[5];
407 uint8_t Graphics[9];
408 uint8_t Attribute[21];
409 unsigned char DAC[768]; /* Internal Colorlookuptable */
410
411 /* PCRTC regs */
412 uint32_t fb_start;
413 uint32_t crtc_cfg;
414 uint32_t cursor_cfg;
415 uint32_t gpio_ext;
416 uint32_t crtc_830;
417 uint32_t crtc_834;
418 uint32_t crtc_850;
419 uint32_t crtc_eng_ctrl;
420
421 /* PRAMDAC regs */
422 uint32_t nv10_cursync;
423 struct nouveau_pll_vals pllvals;
424 uint32_t ramdac_gen_ctrl;
425 uint32_t ramdac_630;
426 uint32_t ramdac_634;
427 uint32_t tv_setup;
428 uint32_t tv_vtotal;
429 uint32_t tv_vskew;
430 uint32_t tv_vsync_delay;
431 uint32_t tv_htotal;
432 uint32_t tv_hskew;
433 uint32_t tv_hsync_delay;
434 uint32_t tv_hsync_delay2;
435 uint32_t fp_horiz_regs[7];
436 uint32_t fp_vert_regs[7];
437 uint32_t dither;
438 uint32_t fp_control;
439 uint32_t dither_regs[6];
440 uint32_t fp_debug_0;
441 uint32_t fp_debug_1;
442 uint32_t fp_debug_2;
443 uint32_t fp_margin_color;
444 uint32_t ramdac_8c0;
445 uint32_t ramdac_a20;
446 uint32_t ramdac_a24;
447 uint32_t ramdac_a34;
448 uint32_t ctv_regs[38];
449};
450
451struct nv04_output_reg {
452 uint32_t output;
453 int head;
454};
455
456struct nv04_mode_state {
457 uint32_t bpp;
458 uint32_t width;
459 uint32_t height;
460 uint32_t interlace;
461 uint32_t repaint0;
462 uint32_t repaint1;
463 uint32_t screen;
464 uint32_t scale;
465 uint32_t dither;
466 uint32_t extra;
467 uint32_t fifo;
468 uint32_t pixel;
469 uint32_t horiz;
470 int arbitration0;
471 int arbitration1;
472 uint32_t pll;
473 uint32_t pllB;
474 uint32_t vpll;
475 uint32_t vpll2;
476 uint32_t vpllB;
477 uint32_t vpll2B;
478 uint32_t pllsel;
479 uint32_t sel_clk;
480 uint32_t general;
481 uint32_t crtcOwner;
482 uint32_t head;
483 uint32_t head2;
484 uint32_t cursorConfig;
485 uint32_t cursor0;
486 uint32_t cursor1;
487 uint32_t cursor2;
488 uint32_t timingH;
489 uint32_t timingV;
490 uint32_t displayV;
491 uint32_t crtcSync;
492
493 struct nv04_crtc_reg crtc_reg[2];
494};
495
496enum nouveau_card_type {
497 NV_04 = 0x00,
498 NV_10 = 0x10,
499 NV_20 = 0x20,
500 NV_30 = 0x30,
501 NV_40 = 0x40,
502 NV_50 = 0x50,
Ben Skeggs4b223ee2010-08-03 10:00:56 +1000503 NV_C0 = 0xc0,
Ben Skeggs6ee73862009-12-11 19:24:15 +1000504};
505
506struct drm_nouveau_private {
507 struct drm_device *dev;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000508
509 /* the card type, takes NV_* as values */
510 enum nouveau_card_type card_type;
511 /* exact chipset, derived from NV_PMC_BOOT_0 */
512 int chipset;
513 int flags;
514
515 void __iomem *mmio;
Ben Skeggs5125bfd2010-09-01 15:24:33 +1000516
Ben Skeggs6ee73862009-12-11 19:24:15 +1000517 void __iomem *ramin;
Ben Skeggs5125bfd2010-09-01 15:24:33 +1000518 u32 ramin_size;
519 u32 ramin_base;
520 bool ramin_available;
521 spinlock_t ramin_lock;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000522
Ben Skeggsac8fb972010-01-15 09:24:20 +1000523 struct nouveau_bo *vga_ram;
524
Ben Skeggs6ee73862009-12-11 19:24:15 +1000525 struct workqueue_struct *wq;
526 struct work_struct irq_work;
Ben Skeggsa5acac62010-03-30 15:14:41 +1000527 struct work_struct hpd_work;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000528
529 struct list_head vbl_waiting;
530
531 struct {
Dave Airlieba4420c2010-03-09 10:56:52 +1000532 struct drm_global_reference mem_global_ref;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000533 struct ttm_bo_global_ref bo_global_ref;
534 struct ttm_bo_device bdev;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000535 atomic_t validate_sequence;
536 } ttm;
537
Ben Skeggs6ee73862009-12-11 19:24:15 +1000538 int fifo_alloc_count;
539 struct nouveau_channel *fifos[NOUVEAU_MAX_CHANNEL_NR];
540
541 struct nouveau_engine engine;
542 struct nouveau_channel *channel;
543
Maarten Maathuisff9e5272010-02-01 20:58:27 +0100544 /* For PFIFO and PGRAPH. */
545 spinlock_t context_switch_lock;
546
Ben Skeggs6ee73862009-12-11 19:24:15 +1000547 /* RAMIN configuration, RAMFC, RAMHT and RAMRO offsets */
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000548 struct nouveau_ramht *ramht;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000549 uint32_t ramin_rsvd_vram;
550 uint32_t ramht_offset;
551 uint32_t ramht_size;
552 uint32_t ramht_bits;
553 uint32_t ramfc_offset;
554 uint32_t ramfc_size;
555 uint32_t ramro_offset;
556 uint32_t ramro_size;
557
Ben Skeggs6ee73862009-12-11 19:24:15 +1000558 struct {
559 enum {
560 NOUVEAU_GART_NONE = 0,
561 NOUVEAU_GART_AGP,
562 NOUVEAU_GART_SGDMA
563 } type;
564 uint64_t aper_base;
565 uint64_t aper_size;
566 uint64_t aper_free;
567
568 struct nouveau_gpuobj *sg_ctxdma;
569 struct page *sg_dummy_page;
570 dma_addr_t sg_dummy_bus;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000571 } gart_info;
572
Francisco Jereza0af9ad2009-12-11 16:51:09 +0100573 /* nv10-nv40 tiling regions */
574 struct {
575 struct nouveau_tile_reg reg[NOUVEAU_MAX_TILE_NR];
576 spinlock_t lock;
577 } tile;
578
Ben Skeggsa76fb4e2010-03-18 09:45:20 +1000579 /* VRAM/fb configuration */
580 uint64_t vram_size;
581 uint64_t vram_sys_base;
Ben Skeggs6c3d7ef2010-08-12 12:37:28 +1000582 u32 vram_rblock_size;
Ben Skeggsa76fb4e2010-03-18 09:45:20 +1000583
584 uint64_t fb_phys;
585 uint64_t fb_available_size;
586 uint64_t fb_mappable_pages;
587 uint64_t fb_aper_free;
588 int fb_mtrr;
589
Ben Skeggs6ee73862009-12-11 19:24:15 +1000590 /* G8x/G9x virtual address space */
591 uint64_t vm_gart_base;
592 uint64_t vm_gart_size;
593 uint64_t vm_vram_base;
594 uint64_t vm_vram_size;
595 uint64_t vm_end;
596 struct nouveau_gpuobj *vm_vram_pt[NV50_VM_VRAM_NR];
597 int vm_vram_pt_nr;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000598
Ben Skeggsb833ac22010-06-01 15:32:24 +1000599 struct drm_mm ramin_heap;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000600
Ben Skeggs6ee73862009-12-11 19:24:15 +1000601 struct list_head gpuobj_list;
602
Ben Skeggs04a39c52010-02-24 10:03:05 +1000603 struct nvbios vbios;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000604
605 struct nv04_mode_state mode_reg;
606 struct nv04_mode_state saved_reg;
607 uint32_t saved_vga_font[4][16384];
608 uint32_t crtc_owner;
609 uint32_t dac_users[4];
610
611 struct nouveau_suspend_resume {
Ben Skeggs6ee73862009-12-11 19:24:15 +1000612 uint32_t *ramin_copy;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000613 } susres;
614
615 struct backlight_device *backlight;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000616
617 struct nouveau_channel *evo;
Ben Skeggs87c0e0e2010-07-06 08:54:34 +1000618 struct {
619 struct dcb_entry *dcb;
620 u16 script;
621 u32 pclk;
622 } evo_irq;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000623
624 struct {
625 struct dentry *channel_root;
626 } debugfs;
Dave Airlie38651672010-03-30 05:34:13 +0000627
Dave Airlie8be48d92010-03-30 05:34:14 +0000628 struct nouveau_fbdev *nfbdev;
Marcin Slusarz06415c52010-05-16 17:29:56 +0200629 struct apertures_struct *apertures;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000630};
631
632static inline struct drm_nouveau_private *
633nouveau_bdev(struct ttm_bo_device *bd)
634{
635 return container_of(bd, struct drm_nouveau_private, ttm.bdev);
636}
637
638static inline int
639nouveau_bo_ref(struct nouveau_bo *ref, struct nouveau_bo **pnvbo)
640{
641 struct nouveau_bo *prev;
642
643 if (!pnvbo)
644 return -EINVAL;
645 prev = *pnvbo;
646
647 *pnvbo = ref ? nouveau_bo(ttm_bo_reference(&ref->bo)) : NULL;
648 if (prev) {
649 struct ttm_buffer_object *bo = &prev->bo;
650
651 ttm_bo_unref(&bo);
652 }
653
654 return 0;
655}
656
Ben Skeggs6ee73862009-12-11 19:24:15 +1000657#define NOUVEAU_GET_USER_CHANNEL_WITH_RETURN(id, cl, ch) do { \
658 struct drm_nouveau_private *nv = dev->dev_private; \
659 if (!nouveau_channel_owner(dev, (cl), (id))) { \
660 NV_ERROR(dev, "pid %d doesn't own channel %d\n", \
661 DRM_CURRENTPID, (id)); \
662 return -EPERM; \
663 } \
664 (ch) = nv->fifos[(id)]; \
665} while (0)
666
667/* nouveau_drv.c */
668extern int nouveau_noagp;
669extern int nouveau_duallink;
670extern int nouveau_uscript_lvds;
671extern int nouveau_uscript_tmds;
672extern int nouveau_vram_pushbuf;
673extern int nouveau_vram_notify;
674extern int nouveau_fbpercrtc;
Ben Skeggsf4053502010-03-15 09:43:51 +1000675extern int nouveau_tv_disable;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000676extern char *nouveau_tv_norm;
677extern int nouveau_reg_debug;
678extern char *nouveau_vbios;
Ben Skeggsa1470892010-01-18 11:42:37 +1000679extern int nouveau_ignorelid;
Marcin Kościelnickia32ed692010-01-26 14:00:42 +0000680extern int nouveau_nofbaccel;
681extern int nouveau_noaccel;
Ben Skeggsda647d52010-03-04 12:00:39 +1000682extern int nouveau_override_conntype;
Ben Skeggs6ee73862009-12-11 19:24:15 +1000683
Dave Airlie6a9ee8a2010-02-01 15:38:10 +1000684extern int nouveau_pci_suspend(struct pci_dev *pdev, pm_message_t pm_state);
685extern int nouveau_pci_resume(struct pci_dev *pdev);
686
Ben Skeggs6ee73862009-12-11 19:24:15 +1000687/* nouveau_state.c */
688extern void nouveau_preclose(struct drm_device *dev, struct drm_file *);
689extern int nouveau_load(struct drm_device *, unsigned long flags);
690extern int nouveau_firstopen(struct drm_device *);
691extern void nouveau_lastclose(struct drm_device *);
692extern int nouveau_unload(struct drm_device *);
693extern int nouveau_ioctl_getparam(struct drm_device *, void *data,
694 struct drm_file *);
695extern int nouveau_ioctl_setparam(struct drm_device *, void *data,
696 struct drm_file *);
697extern bool nouveau_wait_until(struct drm_device *, uint64_t timeout,
698 uint32_t reg, uint32_t mask, uint32_t val);
699extern bool nouveau_wait_for_idle(struct drm_device *);
700extern int nouveau_card_init(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000701
702/* nouveau_mem.c */
Ben Skeggsa76fb4e2010-03-18 09:45:20 +1000703extern int nouveau_mem_detect(struct drm_device *dev);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000704extern int nouveau_mem_init(struct drm_device *);
705extern int nouveau_mem_init_agp(struct drm_device *);
Francisco Jereze04d8e82010-07-23 20:29:13 +0200706extern int nouveau_mem_reset_agp(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000707extern void nouveau_mem_close(struct drm_device *);
Francisco Jereza0af9ad2009-12-11 16:51:09 +0100708extern struct nouveau_tile_reg *nv10_mem_set_tiling(struct drm_device *dev,
709 uint32_t addr,
710 uint32_t size,
711 uint32_t pitch);
712extern void nv10_mem_expire_tiling(struct drm_device *dev,
713 struct nouveau_tile_reg *tile,
714 struct nouveau_fence *fence);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000715extern int nv50_mem_vm_bind_linear(struct drm_device *, uint64_t virt,
716 uint32_t size, uint32_t flags,
717 uint64_t phys);
718extern void nv50_mem_vm_unbind(struct drm_device *, uint64_t virt,
719 uint32_t size);
720
721/* nouveau_notifier.c */
722extern int nouveau_notifier_init_channel(struct nouveau_channel *);
723extern void nouveau_notifier_takedown_channel(struct nouveau_channel *);
724extern int nouveau_notifier_alloc(struct nouveau_channel *, uint32_t handle,
725 int cout, uint32_t *offset);
726extern int nouveau_notifier_offset(struct nouveau_gpuobj *, uint32_t *);
727extern int nouveau_ioctl_notifier_alloc(struct drm_device *, void *data,
728 struct drm_file *);
729extern int nouveau_ioctl_notifier_free(struct drm_device *, void *data,
730 struct drm_file *);
731
732/* nouveau_channel.c */
733extern struct drm_ioctl_desc nouveau_ioctls[];
734extern int nouveau_max_ioctl;
735extern void nouveau_channel_cleanup(struct drm_device *, struct drm_file *);
736extern int nouveau_channel_owner(struct drm_device *, struct drm_file *,
737 int channel);
738extern int nouveau_channel_alloc(struct drm_device *dev,
739 struct nouveau_channel **chan,
740 struct drm_file *file_priv,
741 uint32_t fb_ctxdma, uint32_t tt_ctxdma);
742extern void nouveau_channel_free(struct nouveau_channel *);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000743
744/* nouveau_object.c */
745extern int nouveau_gpuobj_early_init(struct drm_device *);
746extern int nouveau_gpuobj_init(struct drm_device *);
747extern void nouveau_gpuobj_takedown(struct drm_device *);
748extern void nouveau_gpuobj_late_takedown(struct drm_device *);
749extern int nouveau_gpuobj_suspend(struct drm_device *dev);
750extern void nouveau_gpuobj_suspend_cleanup(struct drm_device *dev);
751extern void nouveau_gpuobj_resume(struct drm_device *dev);
752extern int nouveau_gpuobj_channel_init(struct nouveau_channel *,
753 uint32_t vram_h, uint32_t tt_h);
754extern void nouveau_gpuobj_channel_takedown(struct nouveau_channel *);
755extern int nouveau_gpuobj_new(struct drm_device *, struct nouveau_channel *,
756 uint32_t size, int align, uint32_t flags,
757 struct nouveau_gpuobj **);
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000758extern void nouveau_gpuobj_ref(struct nouveau_gpuobj *,
759 struct nouveau_gpuobj **);
Ben Skeggs43efc9c2010-09-01 15:24:32 +1000760extern int nouveau_gpuobj_new_fake(struct drm_device *, u32 pinst, u64 vinst,
761 u32 size, u32 flags,
Ben Skeggsa8eaebc2010-09-01 15:24:31 +1000762 struct nouveau_gpuobj **);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000763extern int nouveau_gpuobj_dma_new(struct nouveau_channel *, int class,
764 uint64_t offset, uint64_t size, int access,
765 int target, struct nouveau_gpuobj **);
766extern int nouveau_gpuobj_gart_dma_new(struct nouveau_channel *,
767 uint64_t offset, uint64_t size,
768 int access, struct nouveau_gpuobj **,
769 uint32_t *o_ret);
770extern int nouveau_gpuobj_gr_new(struct nouveau_channel *, int class,
771 struct nouveau_gpuobj **);
Francisco Jerezf03a3142009-12-26 02:42:45 +0100772extern int nouveau_gpuobj_sw_new(struct nouveau_channel *, int class,
773 struct nouveau_gpuobj **);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000774extern int nouveau_ioctl_grobj_alloc(struct drm_device *, void *data,
775 struct drm_file *);
776extern int nouveau_ioctl_gpuobj_free(struct drm_device *, void *data,
777 struct drm_file *);
778
779/* nouveau_irq.c */
780extern irqreturn_t nouveau_irq_handler(DRM_IRQ_ARGS);
781extern void nouveau_irq_preinstall(struct drm_device *);
782extern int nouveau_irq_postinstall(struct drm_device *);
783extern void nouveau_irq_uninstall(struct drm_device *);
784
785/* nouveau_sgdma.c */
786extern int nouveau_sgdma_init(struct drm_device *);
787extern void nouveau_sgdma_takedown(struct drm_device *);
788extern int nouveau_sgdma_get_page(struct drm_device *, uint32_t offset,
789 uint32_t *page);
790extern struct ttm_backend *nouveau_sgdma_init_ttm(struct drm_device *);
791
792/* nouveau_debugfs.c */
793#if defined(CONFIG_DRM_NOUVEAU_DEBUG)
794extern int nouveau_debugfs_init(struct drm_minor *);
795extern void nouveau_debugfs_takedown(struct drm_minor *);
796extern int nouveau_debugfs_channel_init(struct nouveau_channel *);
797extern void nouveau_debugfs_channel_fini(struct nouveau_channel *);
798#else
799static inline int
800nouveau_debugfs_init(struct drm_minor *minor)
801{
802 return 0;
803}
804
805static inline void nouveau_debugfs_takedown(struct drm_minor *minor)
806{
807}
808
809static inline int
810nouveau_debugfs_channel_init(struct nouveau_channel *chan)
811{
812 return 0;
813}
814
815static inline void
816nouveau_debugfs_channel_fini(struct nouveau_channel *chan)
817{
818}
819#endif
820
821/* nouveau_dma.c */
Ben Skeggs75c99da2010-01-08 10:57:39 +1000822extern void nouveau_dma_pre_init(struct nouveau_channel *);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000823extern int nouveau_dma_init(struct nouveau_channel *);
Ben Skeggs9a391ad2010-02-11 16:37:26 +1000824extern int nouveau_dma_wait(struct nouveau_channel *, int slots, int size);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000825
826/* nouveau_acpi.c */
Dave Airlieafeb3e12010-04-07 13:55:09 +1000827#define ROM_BIOS_PAGE 4096
Dave Airlie2f41a7f2010-03-03 09:20:25 +1000828#if defined(CONFIG_ACPI)
Dave Airlie6a9ee8a2010-02-01 15:38:10 +1000829void nouveau_register_dsm_handler(void);
830void nouveau_unregister_dsm_handler(void);
Dave Airlieafeb3e12010-04-07 13:55:09 +1000831int nouveau_acpi_get_bios_chunk(uint8_t *bios, int offset, int len);
832bool nouveau_acpi_rom_supported(struct pci_dev *pdev);
Ben Skeggsa6ed76d2010-07-12 15:33:07 +1000833int nouveau_acpi_edid(struct drm_device *, struct drm_connector *);
Dave Airlie8edb3812010-03-01 21:50:01 +1100834#else
835static inline void nouveau_register_dsm_handler(void) {}
836static inline void nouveau_unregister_dsm_handler(void) {}
Dave Airlieafeb3e12010-04-07 13:55:09 +1000837static inline bool nouveau_acpi_rom_supported(struct pci_dev *pdev) { return false; }
838static inline int nouveau_acpi_get_bios_chunk(uint8_t *bios, int offset, int len) { return -EINVAL; }
Ben Skeggs5620ba42010-07-23 10:00:12 +1000839static inline int nouveau_acpi_edid(struct drm_device *dev, struct drm_connector *connector) { return -EINVAL; }
Dave Airlie8edb3812010-03-01 21:50:01 +1100840#endif
Ben Skeggs6ee73862009-12-11 19:24:15 +1000841
842/* nouveau_backlight.c */
843#ifdef CONFIG_DRM_NOUVEAU_BACKLIGHT
844extern int nouveau_backlight_init(struct drm_device *);
845extern void nouveau_backlight_exit(struct drm_device *);
846#else
847static inline int nouveau_backlight_init(struct drm_device *dev)
848{
849 return 0;
850}
851
852static inline void nouveau_backlight_exit(struct drm_device *dev) { }
853#endif
854
855/* nouveau_bios.c */
856extern int nouveau_bios_init(struct drm_device *);
857extern void nouveau_bios_takedown(struct drm_device *dev);
858extern int nouveau_run_vbios_init(struct drm_device *);
859extern void nouveau_bios_run_init_table(struct drm_device *, uint16_t table,
860 struct dcb_entry *);
861extern struct dcb_gpio_entry *nouveau_bios_gpio_entry(struct drm_device *,
862 enum dcb_gpio_tag);
863extern struct dcb_connector_table_entry *
864nouveau_bios_connector_entry(struct drm_device *, int index);
865extern int get_pll_limits(struct drm_device *, uint32_t limit_match,
866 struct pll_lims *);
867extern int nouveau_bios_run_display_table(struct drm_device *,
868 struct dcb_entry *,
869 uint32_t script, int pxclk);
870extern void *nouveau_bios_dp_table(struct drm_device *, struct dcb_entry *,
871 int *length);
872extern bool nouveau_bios_fp_mode(struct drm_device *, struct drm_display_mode *);
873extern uint8_t *nouveau_bios_embedded_edid(struct drm_device *);
874extern int nouveau_bios_parse_lvds_table(struct drm_device *, int pxclk,
875 bool *dl, bool *if_is_24bit);
876extern int run_tmds_table(struct drm_device *, struct dcb_entry *,
877 int head, int pxclk);
878extern int call_lvds_script(struct drm_device *, struct dcb_entry *, int head,
879 enum LVDS_script, int pxclk);
880
881/* nouveau_ttm.c */
882int nouveau_ttm_global_init(struct drm_nouveau_private *);
883void nouveau_ttm_global_release(struct drm_nouveau_private *);
884int nouveau_ttm_mmap(struct file *, struct vm_area_struct *);
885
886/* nouveau_dp.c */
887int nouveau_dp_auxch(struct nouveau_i2c_chan *auxch, int cmd, int addr,
888 uint8_t *data, int data_nr);
889bool nouveau_dp_detect(struct drm_encoder *);
890bool nouveau_dp_link_train(struct drm_encoder *);
891
892/* nv04_fb.c */
893extern int nv04_fb_init(struct drm_device *);
894extern void nv04_fb_takedown(struct drm_device *);
895
896/* nv10_fb.c */
897extern int nv10_fb_init(struct drm_device *);
898extern void nv10_fb_takedown(struct drm_device *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100899extern void nv10_fb_set_region_tiling(struct drm_device *, int, uint32_t,
900 uint32_t, uint32_t);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000901
Francisco Jerez8bded182010-07-21 21:08:11 +0200902/* nv30_fb.c */
903extern int nv30_fb_init(struct drm_device *);
904extern void nv30_fb_takedown(struct drm_device *);
905
Ben Skeggs6ee73862009-12-11 19:24:15 +1000906/* nv40_fb.c */
907extern int nv40_fb_init(struct drm_device *);
908extern void nv40_fb_takedown(struct drm_device *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100909extern void nv40_fb_set_region_tiling(struct drm_device *, int, uint32_t,
910 uint32_t, uint32_t);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000911
Marcin Kościelnicki304424e2010-03-01 00:18:39 +0000912/* nv50_fb.c */
913extern int nv50_fb_init(struct drm_device *);
914extern void nv50_fb_takedown(struct drm_device *);
915
Ben Skeggs4b223ee2010-08-03 10:00:56 +1000916/* nvc0_fb.c */
917extern int nvc0_fb_init(struct drm_device *);
918extern void nvc0_fb_takedown(struct drm_device *);
919
Ben Skeggs6ee73862009-12-11 19:24:15 +1000920/* nv04_fifo.c */
921extern int nv04_fifo_init(struct drm_device *);
922extern void nv04_fifo_disable(struct drm_device *);
923extern void nv04_fifo_enable(struct drm_device *);
924extern bool nv04_fifo_reassign(struct drm_device *, bool);
Francisco Jerez588d7d12009-12-13 20:07:42 +0100925extern bool nv04_fifo_cache_flush(struct drm_device *);
926extern bool nv04_fifo_cache_pull(struct drm_device *, bool);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000927extern int nv04_fifo_channel_id(struct drm_device *);
928extern int nv04_fifo_create_context(struct nouveau_channel *);
929extern void nv04_fifo_destroy_context(struct nouveau_channel *);
930extern int nv04_fifo_load_context(struct nouveau_channel *);
931extern int nv04_fifo_unload_context(struct drm_device *);
932
933/* nv10_fifo.c */
934extern int nv10_fifo_init(struct drm_device *);
935extern int nv10_fifo_channel_id(struct drm_device *);
936extern int nv10_fifo_create_context(struct nouveau_channel *);
937extern void nv10_fifo_destroy_context(struct nouveau_channel *);
938extern int nv10_fifo_load_context(struct nouveau_channel *);
939extern int nv10_fifo_unload_context(struct drm_device *);
940
941/* nv40_fifo.c */
942extern int nv40_fifo_init(struct drm_device *);
943extern int nv40_fifo_create_context(struct nouveau_channel *);
944extern void nv40_fifo_destroy_context(struct nouveau_channel *);
945extern int nv40_fifo_load_context(struct nouveau_channel *);
946extern int nv40_fifo_unload_context(struct drm_device *);
947
948/* nv50_fifo.c */
949extern int nv50_fifo_init(struct drm_device *);
950extern void nv50_fifo_takedown(struct drm_device *);
951extern int nv50_fifo_channel_id(struct drm_device *);
952extern int nv50_fifo_create_context(struct nouveau_channel *);
953extern void nv50_fifo_destroy_context(struct nouveau_channel *);
954extern int nv50_fifo_load_context(struct nouveau_channel *);
955extern int nv50_fifo_unload_context(struct drm_device *);
956
Ben Skeggs4b223ee2010-08-03 10:00:56 +1000957/* nvc0_fifo.c */
958extern int nvc0_fifo_init(struct drm_device *);
959extern void nvc0_fifo_takedown(struct drm_device *);
960extern void nvc0_fifo_disable(struct drm_device *);
961extern void nvc0_fifo_enable(struct drm_device *);
962extern bool nvc0_fifo_reassign(struct drm_device *, bool);
963extern bool nvc0_fifo_cache_flush(struct drm_device *);
964extern bool nvc0_fifo_cache_pull(struct drm_device *, bool);
965extern int nvc0_fifo_channel_id(struct drm_device *);
966extern int nvc0_fifo_create_context(struct nouveau_channel *);
967extern void nvc0_fifo_destroy_context(struct nouveau_channel *);
968extern int nvc0_fifo_load_context(struct nouveau_channel *);
969extern int nvc0_fifo_unload_context(struct drm_device *);
970
Ben Skeggs6ee73862009-12-11 19:24:15 +1000971/* nv04_graph.c */
972extern struct nouveau_pgraph_object_class nv04_graph_grclass[];
973extern int nv04_graph_init(struct drm_device *);
974extern void nv04_graph_takedown(struct drm_device *);
975extern void nv04_graph_fifo_access(struct drm_device *, bool);
976extern struct nouveau_channel *nv04_graph_channel(struct drm_device *);
977extern int nv04_graph_create_context(struct nouveau_channel *);
978extern void nv04_graph_destroy_context(struct nouveau_channel *);
979extern int nv04_graph_load_context(struct nouveau_channel *);
980extern int nv04_graph_unload_context(struct drm_device *);
981extern void nv04_graph_context_switch(struct drm_device *);
982
983/* nv10_graph.c */
984extern struct nouveau_pgraph_object_class nv10_graph_grclass[];
985extern int nv10_graph_init(struct drm_device *);
986extern void nv10_graph_takedown(struct drm_device *);
987extern struct nouveau_channel *nv10_graph_channel(struct drm_device *);
988extern int nv10_graph_create_context(struct nouveau_channel *);
989extern void nv10_graph_destroy_context(struct nouveau_channel *);
990extern int nv10_graph_load_context(struct nouveau_channel *);
991extern int nv10_graph_unload_context(struct drm_device *);
992extern void nv10_graph_context_switch(struct drm_device *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +0100993extern void nv10_graph_set_region_tiling(struct drm_device *, int, uint32_t,
994 uint32_t, uint32_t);
Ben Skeggs6ee73862009-12-11 19:24:15 +1000995
996/* nv20_graph.c */
997extern struct nouveau_pgraph_object_class nv20_graph_grclass[];
998extern struct nouveau_pgraph_object_class nv30_graph_grclass[];
999extern int nv20_graph_create_context(struct nouveau_channel *);
1000extern void nv20_graph_destroy_context(struct nouveau_channel *);
1001extern int nv20_graph_load_context(struct nouveau_channel *);
1002extern int nv20_graph_unload_context(struct drm_device *);
1003extern int nv20_graph_init(struct drm_device *);
1004extern void nv20_graph_takedown(struct drm_device *);
1005extern int nv30_graph_init(struct drm_device *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +01001006extern void nv20_graph_set_region_tiling(struct drm_device *, int, uint32_t,
1007 uint32_t, uint32_t);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001008
1009/* nv40_graph.c */
1010extern struct nouveau_pgraph_object_class nv40_graph_grclass[];
1011extern int nv40_graph_init(struct drm_device *);
1012extern void nv40_graph_takedown(struct drm_device *);
1013extern struct nouveau_channel *nv40_graph_channel(struct drm_device *);
1014extern int nv40_graph_create_context(struct nouveau_channel *);
1015extern void nv40_graph_destroy_context(struct nouveau_channel *);
1016extern int nv40_graph_load_context(struct nouveau_channel *);
1017extern int nv40_graph_unload_context(struct drm_device *);
Ben Skeggs054b93e2009-12-15 22:02:47 +10001018extern void nv40_grctx_init(struct nouveau_grctx *);
Francisco Jerezcb00f7c2009-12-16 12:12:27 +01001019extern void nv40_graph_set_region_tiling(struct drm_device *, int, uint32_t,
1020 uint32_t, uint32_t);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001021
1022/* nv50_graph.c */
1023extern struct nouveau_pgraph_object_class nv50_graph_grclass[];
1024extern int nv50_graph_init(struct drm_device *);
1025extern void nv50_graph_takedown(struct drm_device *);
1026extern void nv50_graph_fifo_access(struct drm_device *, bool);
1027extern struct nouveau_channel *nv50_graph_channel(struct drm_device *);
1028extern int nv50_graph_create_context(struct nouveau_channel *);
1029extern void nv50_graph_destroy_context(struct nouveau_channel *);
1030extern int nv50_graph_load_context(struct nouveau_channel *);
1031extern int nv50_graph_unload_context(struct drm_device *);
1032extern void nv50_graph_context_switch(struct drm_device *);
Marcin Kościelnickid5f3c902010-02-25 00:54:02 +00001033extern int nv50_grctx_init(struct nouveau_grctx *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001034
Ben Skeggs4b223ee2010-08-03 10:00:56 +10001035/* nvc0_graph.c */
1036extern int nvc0_graph_init(struct drm_device *);
1037extern void nvc0_graph_takedown(struct drm_device *);
1038extern void nvc0_graph_fifo_access(struct drm_device *, bool);
1039extern struct nouveau_channel *nvc0_graph_channel(struct drm_device *);
1040extern int nvc0_graph_create_context(struct nouveau_channel *);
1041extern void nvc0_graph_destroy_context(struct nouveau_channel *);
1042extern int nvc0_graph_load_context(struct nouveau_channel *);
1043extern int nvc0_graph_unload_context(struct drm_device *);
1044
Ben Skeggs6ee73862009-12-11 19:24:15 +10001045/* nv04_instmem.c */
1046extern int nv04_instmem_init(struct drm_device *);
1047extern void nv04_instmem_takedown(struct drm_device *);
1048extern int nv04_instmem_suspend(struct drm_device *);
1049extern void nv04_instmem_resume(struct drm_device *);
1050extern int nv04_instmem_populate(struct drm_device *, struct nouveau_gpuobj *,
1051 uint32_t *size);
1052extern void nv04_instmem_clear(struct drm_device *, struct nouveau_gpuobj *);
1053extern int nv04_instmem_bind(struct drm_device *, struct nouveau_gpuobj *);
1054extern int nv04_instmem_unbind(struct drm_device *, struct nouveau_gpuobj *);
Ben Skeggsf56cb862010-07-08 11:29:10 +10001055extern void nv04_instmem_flush(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001056
1057/* nv50_instmem.c */
1058extern int nv50_instmem_init(struct drm_device *);
1059extern void nv50_instmem_takedown(struct drm_device *);
1060extern int nv50_instmem_suspend(struct drm_device *);
1061extern void nv50_instmem_resume(struct drm_device *);
1062extern int nv50_instmem_populate(struct drm_device *, struct nouveau_gpuobj *,
1063 uint32_t *size);
1064extern void nv50_instmem_clear(struct drm_device *, struct nouveau_gpuobj *);
1065extern int nv50_instmem_bind(struct drm_device *, struct nouveau_gpuobj *);
1066extern int nv50_instmem_unbind(struct drm_device *, struct nouveau_gpuobj *);
Ben Skeggsf56cb862010-07-08 11:29:10 +10001067extern void nv50_instmem_flush(struct drm_device *);
Ben Skeggs734ee832010-07-15 11:02:54 +10001068extern void nv84_instmem_flush(struct drm_device *);
Ben Skeggs63187212010-07-08 11:39:18 +10001069extern void nv50_vm_flush(struct drm_device *, int engine);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001070
Ben Skeggs4b223ee2010-08-03 10:00:56 +10001071/* nvc0_instmem.c */
1072extern int nvc0_instmem_init(struct drm_device *);
1073extern void nvc0_instmem_takedown(struct drm_device *);
1074extern int nvc0_instmem_suspend(struct drm_device *);
1075extern void nvc0_instmem_resume(struct drm_device *);
1076extern int nvc0_instmem_populate(struct drm_device *, struct nouveau_gpuobj *,
1077 uint32_t *size);
1078extern void nvc0_instmem_clear(struct drm_device *, struct nouveau_gpuobj *);
1079extern int nvc0_instmem_bind(struct drm_device *, struct nouveau_gpuobj *);
1080extern int nvc0_instmem_unbind(struct drm_device *, struct nouveau_gpuobj *);
1081extern void nvc0_instmem_flush(struct drm_device *);
1082
Ben Skeggs6ee73862009-12-11 19:24:15 +10001083/* nv04_mc.c */
1084extern int nv04_mc_init(struct drm_device *);
1085extern void nv04_mc_takedown(struct drm_device *);
1086
1087/* nv40_mc.c */
1088extern int nv40_mc_init(struct drm_device *);
1089extern void nv40_mc_takedown(struct drm_device *);
1090
1091/* nv50_mc.c */
1092extern int nv50_mc_init(struct drm_device *);
1093extern void nv50_mc_takedown(struct drm_device *);
1094
1095/* nv04_timer.c */
1096extern int nv04_timer_init(struct drm_device *);
1097extern uint64_t nv04_timer_read(struct drm_device *);
1098extern void nv04_timer_takedown(struct drm_device *);
1099
1100extern long nouveau_compat_ioctl(struct file *file, unsigned int cmd,
1101 unsigned long arg);
1102
1103/* nv04_dac.c */
Ben Skeggs8f1a6082010-06-28 14:35:50 +10001104extern int nv04_dac_create(struct drm_connector *, struct dcb_entry *);
Francisco Jerez11d6eb22009-12-17 18:52:44 +01001105extern uint32_t nv17_dac_sample_load(struct drm_encoder *encoder);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001106extern int nv04_dac_output_offset(struct drm_encoder *encoder);
1107extern void nv04_dac_update_dacclk(struct drm_encoder *encoder, bool enable);
Francisco Jerez8ccfe9e2010-07-04 16:14:42 +02001108extern bool nv04_dac_in_use(struct drm_encoder *encoder);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001109
1110/* nv04_dfp.c */
Ben Skeggs8f1a6082010-06-28 14:35:50 +10001111extern int nv04_dfp_create(struct drm_connector *, struct dcb_entry *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001112extern int nv04_dfp_get_bound_head(struct drm_device *dev, struct dcb_entry *dcbent);
1113extern void nv04_dfp_bind_head(struct drm_device *dev, struct dcb_entry *dcbent,
1114 int head, bool dl);
1115extern void nv04_dfp_disable(struct drm_device *dev, int head);
1116extern void nv04_dfp_update_fp_control(struct drm_encoder *encoder, int mode);
1117
1118/* nv04_tv.c */
1119extern int nv04_tv_identify(struct drm_device *dev, int i2c_index);
Ben Skeggs8f1a6082010-06-28 14:35:50 +10001120extern int nv04_tv_create(struct drm_connector *, struct dcb_entry *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001121
1122/* nv17_tv.c */
Ben Skeggs8f1a6082010-06-28 14:35:50 +10001123extern int nv17_tv_create(struct drm_connector *, struct dcb_entry *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001124
1125/* nv04_display.c */
Francisco Jerezc88c2e02010-07-24 17:37:33 +02001126extern int nv04_display_early_init(struct drm_device *);
1127extern void nv04_display_late_takedown(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001128extern int nv04_display_create(struct drm_device *);
Francisco Jerezc88c2e02010-07-24 17:37:33 +02001129extern int nv04_display_init(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001130extern void nv04_display_destroy(struct drm_device *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001131
1132/* nv04_crtc.c */
1133extern int nv04_crtc_create(struct drm_device *, int index);
1134
1135/* nouveau_bo.c */
1136extern struct ttm_bo_driver nouveau_bo_driver;
1137extern int nouveau_bo_new(struct drm_device *, struct nouveau_channel *,
1138 int size, int align, uint32_t flags,
1139 uint32_t tile_mode, uint32_t tile_flags,
1140 bool no_vm, bool mappable, struct nouveau_bo **);
1141extern int nouveau_bo_pin(struct nouveau_bo *, uint32_t flags);
1142extern int nouveau_bo_unpin(struct nouveau_bo *);
1143extern int nouveau_bo_map(struct nouveau_bo *);
1144extern void nouveau_bo_unmap(struct nouveau_bo *);
Francisco Jerez78ad0f72010-03-18 13:07:47 +01001145extern void nouveau_bo_placement_set(struct nouveau_bo *, uint32_t type,
1146 uint32_t busy);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001147extern u16 nouveau_bo_rd16(struct nouveau_bo *nvbo, unsigned index);
1148extern void nouveau_bo_wr16(struct nouveau_bo *nvbo, unsigned index, u16 val);
1149extern u32 nouveau_bo_rd32(struct nouveau_bo *nvbo, unsigned index);
1150extern void nouveau_bo_wr32(struct nouveau_bo *nvbo, unsigned index, u32 val);
Ben Skeggs415e6182010-07-23 09:06:52 +10001151extern int nouveau_bo_sync_gpu(struct nouveau_bo *, struct nouveau_channel *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001152
1153/* nouveau_fence.c */
1154struct nouveau_fence;
1155extern int nouveau_fence_init(struct nouveau_channel *);
1156extern void nouveau_fence_fini(struct nouveau_channel *);
1157extern void nouveau_fence_update(struct nouveau_channel *);
1158extern int nouveau_fence_new(struct nouveau_channel *, struct nouveau_fence **,
1159 bool emit);
1160extern int nouveau_fence_emit(struct nouveau_fence *);
1161struct nouveau_channel *nouveau_fence_channel(struct nouveau_fence *);
1162extern bool nouveau_fence_signalled(void *obj, void *arg);
1163extern int nouveau_fence_wait(void *obj, void *arg, bool lazy, bool intr);
1164extern int nouveau_fence_flush(void *obj, void *arg);
1165extern void nouveau_fence_unref(void **obj);
1166extern void *nouveau_fence_ref(void *obj);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001167
1168/* nouveau_gem.c */
1169extern int nouveau_gem_new(struct drm_device *, struct nouveau_channel *,
1170 int size, int align, uint32_t flags,
1171 uint32_t tile_mode, uint32_t tile_flags,
1172 bool no_vm, bool mappable, struct nouveau_bo **);
1173extern int nouveau_gem_object_new(struct drm_gem_object *);
1174extern void nouveau_gem_object_del(struct drm_gem_object *);
1175extern int nouveau_gem_ioctl_new(struct drm_device *, void *,
1176 struct drm_file *);
1177extern int nouveau_gem_ioctl_pushbuf(struct drm_device *, void *,
1178 struct drm_file *);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001179extern int nouveau_gem_ioctl_cpu_prep(struct drm_device *, void *,
1180 struct drm_file *);
1181extern int nouveau_gem_ioctl_cpu_fini(struct drm_device *, void *,
1182 struct drm_file *);
1183extern int nouveau_gem_ioctl_info(struct drm_device *, void *,
1184 struct drm_file *);
1185
Ben Skeggsee2e0132010-07-26 09:28:25 +10001186/* nv10_gpio.c */
1187int nv10_gpio_get(struct drm_device *dev, enum dcb_gpio_tag tag);
1188int nv10_gpio_set(struct drm_device *dev, enum dcb_gpio_tag tag, int state);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001189
Ben Skeggs45284162010-04-07 12:57:35 +10001190/* nv50_gpio.c */
Ben Skeggsee2e0132010-07-26 09:28:25 +10001191int nv50_gpio_init(struct drm_device *dev);
Ben Skeggs45284162010-04-07 12:57:35 +10001192int nv50_gpio_get(struct drm_device *dev, enum dcb_gpio_tag tag);
1193int nv50_gpio_set(struct drm_device *dev, enum dcb_gpio_tag tag, int state);
Ben Skeggsd0875ed2010-07-23 11:31:08 +10001194void nv50_gpio_irq_enable(struct drm_device *, enum dcb_gpio_tag, bool on);
Ben Skeggs45284162010-04-07 12:57:35 +10001195
Ben Skeggse9ebb682010-04-28 14:07:06 +10001196/* nv50_calc. */
1197int nv50_calc_pll(struct drm_device *, struct pll_lims *, int clk,
1198 int *N1, int *M1, int *N2, int *M2, int *P);
1199int nv50_calc_pll2(struct drm_device *, struct pll_lims *,
1200 int clk, int *N, int *fN, int *M, int *P);
1201
Ben Skeggs6ee73862009-12-11 19:24:15 +10001202#ifndef ioread32_native
1203#ifdef __BIG_ENDIAN
1204#define ioread16_native ioread16be
1205#define iowrite16_native iowrite16be
1206#define ioread32_native ioread32be
1207#define iowrite32_native iowrite32be
1208#else /* def __BIG_ENDIAN */
1209#define ioread16_native ioread16
1210#define iowrite16_native iowrite16
1211#define ioread32_native ioread32
1212#define iowrite32_native iowrite32
1213#endif /* def __BIG_ENDIAN else */
1214#endif /* !ioread32_native */
1215
1216/* channel control reg access */
1217static inline u32 nvchan_rd32(struct nouveau_channel *chan, unsigned reg)
1218{
1219 return ioread32_native(chan->user + reg);
1220}
1221
1222static inline void nvchan_wr32(struct nouveau_channel *chan,
1223 unsigned reg, u32 val)
1224{
1225 iowrite32_native(val, chan->user + reg);
1226}
1227
1228/* register access */
1229static inline u32 nv_rd32(struct drm_device *dev, unsigned reg)
1230{
1231 struct drm_nouveau_private *dev_priv = dev->dev_private;
1232 return ioread32_native(dev_priv->mmio + reg);
1233}
1234
1235static inline void nv_wr32(struct drm_device *dev, unsigned reg, u32 val)
1236{
1237 struct drm_nouveau_private *dev_priv = dev->dev_private;
1238 iowrite32_native(val, dev_priv->mmio + reg);
1239}
1240
Ben Skeggs2a7fdb2b2010-08-30 16:14:51 +10001241static inline u32 nv_mask(struct drm_device *dev, u32 reg, u32 mask, u32 val)
Ben Skeggs49eed802010-07-23 11:17:57 +10001242{
1243 u32 tmp = nv_rd32(dev, reg);
Ben Skeggs2a7fdb2b2010-08-30 16:14:51 +10001244 nv_wr32(dev, reg, (tmp & ~mask) | val);
1245 return tmp;
Ben Skeggs49eed802010-07-23 11:17:57 +10001246}
1247
Ben Skeggs6ee73862009-12-11 19:24:15 +10001248static inline u8 nv_rd08(struct drm_device *dev, unsigned reg)
1249{
1250 struct drm_nouveau_private *dev_priv = dev->dev_private;
1251 return ioread8(dev_priv->mmio + reg);
1252}
1253
1254static inline void nv_wr08(struct drm_device *dev, unsigned reg, u8 val)
1255{
1256 struct drm_nouveau_private *dev_priv = dev->dev_private;
1257 iowrite8(val, dev_priv->mmio + reg);
1258}
1259
1260#define nv_wait(reg, mask, val) \
1261 nouveau_wait_until(dev, 2000000000ULL, (reg), (mask), (val))
1262
1263/* PRAMIN access */
1264static inline u32 nv_ri32(struct drm_device *dev, unsigned offset)
1265{
1266 struct drm_nouveau_private *dev_priv = dev->dev_private;
1267 return ioread32_native(dev_priv->ramin + offset);
1268}
1269
1270static inline void nv_wi32(struct drm_device *dev, unsigned offset, u32 val)
1271{
1272 struct drm_nouveau_private *dev_priv = dev->dev_private;
1273 iowrite32_native(val, dev_priv->ramin + offset);
1274}
1275
1276/* object access */
Ben Skeggsb3beb162010-09-01 15:24:29 +10001277extern u32 nv_ro32(struct nouveau_gpuobj *, u32 offset);
1278extern void nv_wo32(struct nouveau_gpuobj *, u32 offset, u32 val);
Ben Skeggs6ee73862009-12-11 19:24:15 +10001279
1280/*
1281 * Logging
1282 * Argument d is (struct drm_device *).
1283 */
1284#define NV_PRINTK(level, d, fmt, arg...) \
1285 printk(level "[" DRM_NAME "] " DRIVER_NAME " %s: " fmt, \
1286 pci_name(d->pdev), ##arg)
1287#ifndef NV_DEBUG_NOTRACE
1288#define NV_DEBUG(d, fmt, arg...) do { \
Maarten Maathuisef2bb502009-12-13 16:53:12 +01001289 if (drm_debug & DRM_UT_DRIVER) { \
1290 NV_PRINTK(KERN_DEBUG, d, "%s:%d - " fmt, __func__, \
1291 __LINE__, ##arg); \
1292 } \
1293} while (0)
1294#define NV_DEBUG_KMS(d, fmt, arg...) do { \
1295 if (drm_debug & DRM_UT_KMS) { \
Ben Skeggs6ee73862009-12-11 19:24:15 +10001296 NV_PRINTK(KERN_DEBUG, d, "%s:%d - " fmt, __func__, \
1297 __LINE__, ##arg); \
1298 } \
1299} while (0)
1300#else
1301#define NV_DEBUG(d, fmt, arg...) do { \
Maarten Maathuisef2bb502009-12-13 16:53:12 +01001302 if (drm_debug & DRM_UT_DRIVER) \
1303 NV_PRINTK(KERN_DEBUG, d, fmt, ##arg); \
1304} while (0)
1305#define NV_DEBUG_KMS(d, fmt, arg...) do { \
1306 if (drm_debug & DRM_UT_KMS) \
Ben Skeggs6ee73862009-12-11 19:24:15 +10001307 NV_PRINTK(KERN_DEBUG, d, fmt, ##arg); \
1308} while (0)
1309#endif
1310#define NV_ERROR(d, fmt, arg...) NV_PRINTK(KERN_ERR, d, fmt, ##arg)
1311#define NV_INFO(d, fmt, arg...) NV_PRINTK(KERN_INFO, d, fmt, ##arg)
1312#define NV_TRACEWARN(d, fmt, arg...) NV_PRINTK(KERN_NOTICE, d, fmt, ##arg)
1313#define NV_TRACE(d, fmt, arg...) NV_PRINTK(KERN_INFO, d, fmt, ##arg)
1314#define NV_WARN(d, fmt, arg...) NV_PRINTK(KERN_WARNING, d, fmt, ##arg)
1315
1316/* nouveau_reg_debug bitmask */
1317enum {
1318 NOUVEAU_REG_DEBUG_MC = 0x1,
1319 NOUVEAU_REG_DEBUG_VIDEO = 0x2,
1320 NOUVEAU_REG_DEBUG_FB = 0x4,
1321 NOUVEAU_REG_DEBUG_EXTDEV = 0x8,
1322 NOUVEAU_REG_DEBUG_CRTC = 0x10,
1323 NOUVEAU_REG_DEBUG_RAMDAC = 0x20,
1324 NOUVEAU_REG_DEBUG_VGACRTC = 0x40,
1325 NOUVEAU_REG_DEBUG_RMVIO = 0x80,
1326 NOUVEAU_REG_DEBUG_VGAATTR = 0x100,
1327 NOUVEAU_REG_DEBUG_EVO = 0x200,
1328};
1329
1330#define NV_REG_DEBUG(type, dev, fmt, arg...) do { \
1331 if (nouveau_reg_debug & NOUVEAU_REG_DEBUG_##type) \
1332 NV_PRINTK(KERN_DEBUG, dev, "%s: " fmt, __func__, ##arg); \
1333} while (0)
1334
1335static inline bool
1336nv_two_heads(struct drm_device *dev)
1337{
1338 struct drm_nouveau_private *dev_priv = dev->dev_private;
1339 const int impl = dev->pci_device & 0x0ff0;
1340
1341 if (dev_priv->card_type >= NV_10 && impl != 0x0100 &&
1342 impl != 0x0150 && impl != 0x01a0 && impl != 0x0200)
1343 return true;
1344
1345 return false;
1346}
1347
1348static inline bool
1349nv_gf4_disp_arch(struct drm_device *dev)
1350{
1351 return nv_two_heads(dev) && (dev->pci_device & 0x0ff0) != 0x0110;
1352}
1353
1354static inline bool
1355nv_two_reg_pll(struct drm_device *dev)
1356{
1357 struct drm_nouveau_private *dev_priv = dev->dev_private;
1358 const int impl = dev->pci_device & 0x0ff0;
1359
1360 if (impl == 0x0310 || impl == 0x0340 || dev_priv->card_type >= NV_40)
1361 return true;
1362 return false;
1363}
1364
Francisco Jerezacae1162010-08-15 14:31:31 +02001365static inline bool
1366nv_match_device(struct drm_device *dev, unsigned device,
1367 unsigned sub_vendor, unsigned sub_device)
1368{
1369 return dev->pdev->device == device &&
1370 dev->pdev->subsystem_vendor == sub_vendor &&
1371 dev->pdev->subsystem_device == sub_device;
1372}
1373
Francisco Jerezf03a3142009-12-26 02:42:45 +01001374#define NV_SW 0x0000506e
1375#define NV_SW_DMA_SEMAPHORE 0x00000060
1376#define NV_SW_SEMAPHORE_OFFSET 0x00000064
1377#define NV_SW_SEMAPHORE_ACQUIRE 0x00000068
1378#define NV_SW_SEMAPHORE_RELEASE 0x0000006c
1379#define NV_SW_DMA_VBLSEM 0x0000018c
1380#define NV_SW_VBLSEM_OFFSET 0x00000400
1381#define NV_SW_VBLSEM_RELEASE_VALUE 0x00000404
1382#define NV_SW_VBLSEM_RELEASE 0x00000408
Ben Skeggs6ee73862009-12-11 19:24:15 +10001383
1384#endif /* __NOUVEAU_DRV_H__ */