nouveau_drv.h 50 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603
  1. /*
  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. #ifndef __NOUVEAU_DRV_H__
  25. #define __NOUVEAU_DRV_H__
  26. #define DRIVER_AUTHOR "Stephane Marchesin"
  27. #define DRIVER_EMAIL "dri-devel@lists.sourceforge.net"
  28. #define DRIVER_NAME "nouveau"
  29. #define DRIVER_DESC "nVidia Riva/TNT/GeForce"
  30. #define DRIVER_DATE "20090420"
  31. #define DRIVER_MAJOR 0
  32. #define DRIVER_MINOR 0
  33. #define DRIVER_PATCHLEVEL 16
  34. #define NOUVEAU_FAMILY 0x0000FFFF
  35. #define NOUVEAU_FLAGS 0xFFFF0000
  36. #include "ttm/ttm_bo_api.h"
  37. #include "ttm/ttm_bo_driver.h"
  38. #include "ttm/ttm_placement.h"
  39. #include "ttm/ttm_memory.h"
  40. #include "ttm/ttm_module.h"
  41. struct nouveau_fpriv {
  42. spinlock_t lock;
  43. struct list_head channels;
  44. struct nouveau_vm *vm;
  45. };
  46. static inline struct nouveau_fpriv *
  47. nouveau_fpriv(struct drm_file *file_priv)
  48. {
  49. return file_priv ? file_priv->driver_priv : NULL;
  50. }
  51. #define DRM_FILE_PAGE_OFFSET (0x100000000ULL >> PAGE_SHIFT)
  52. #include "nouveau_drm.h"
  53. #include "nouveau_reg.h"
  54. #include "nouveau_bios.h"
  55. #include "nouveau_util.h"
  56. struct nouveau_grctx;
  57. struct nouveau_mem;
  58. #include "nouveau_vm.h"
  59. #define MAX_NUM_DCB_ENTRIES 16
  60. #define NOUVEAU_MAX_CHANNEL_NR 128
  61. #define NOUVEAU_MAX_TILE_NR 15
  62. struct nouveau_mem {
  63. struct drm_device *dev;
  64. struct nouveau_vma bar_vma;
  65. struct nouveau_vma vma[2];
  66. u8 page_shift;
  67. struct drm_mm_node *tag;
  68. struct list_head regions;
  69. dma_addr_t *pages;
  70. u32 memtype;
  71. u64 offset;
  72. u64 size;
  73. };
  74. struct nouveau_tile_reg {
  75. bool used;
  76. uint32_t addr;
  77. uint32_t limit;
  78. uint32_t pitch;
  79. uint32_t zcomp;
  80. struct drm_mm_node *tag_mem;
  81. struct nouveau_fence *fence;
  82. };
  83. struct nouveau_bo {
  84. struct ttm_buffer_object bo;
  85. struct ttm_placement placement;
  86. u32 valid_domains;
  87. u32 placements[3];
  88. u32 busy_placements[3];
  89. struct ttm_bo_kmap_obj kmap;
  90. struct list_head head;
  91. /* protected by ttm_bo_reserve() */
  92. struct drm_file *reserved_by;
  93. struct list_head entry;
  94. int pbbo_index;
  95. bool validate_mapped;
  96. struct nouveau_channel *channel;
  97. struct nouveau_vma vma;
  98. unsigned page_shift;
  99. uint32_t tile_mode;
  100. uint32_t tile_flags;
  101. struct nouveau_tile_reg *tile;
  102. struct drm_gem_object *gem;
  103. int pin_refcnt;
  104. };
  105. #define nouveau_bo_tile_layout(nvbo) \
  106. ((nvbo)->tile_flags & NOUVEAU_GEM_TILE_LAYOUT_MASK)
  107. static inline struct nouveau_bo *
  108. nouveau_bo(struct ttm_buffer_object *bo)
  109. {
  110. return container_of(bo, struct nouveau_bo, bo);
  111. }
  112. static inline struct nouveau_bo *
  113. nouveau_gem_object(struct drm_gem_object *gem)
  114. {
  115. return gem ? gem->driver_private : NULL;
  116. }
  117. /* TODO: submit equivalent to TTM generic API upstream? */
  118. static inline void __iomem *
  119. nvbo_kmap_obj_iovirtual(struct nouveau_bo *nvbo)
  120. {
  121. bool is_iomem;
  122. void __iomem *ioptr = (void __force __iomem *)ttm_kmap_obj_virtual(
  123. &nvbo->kmap, &is_iomem);
  124. WARN_ON_ONCE(ioptr && !is_iomem);
  125. return ioptr;
  126. }
  127. enum nouveau_flags {
  128. NV_NFORCE = 0x10000000,
  129. NV_NFORCE2 = 0x20000000
  130. };
  131. #define NVOBJ_ENGINE_SW 0
  132. #define NVOBJ_ENGINE_GR 1
  133. #define NVOBJ_ENGINE_CRYPT 2
  134. #define NVOBJ_ENGINE_COPY0 3
  135. #define NVOBJ_ENGINE_COPY1 4
  136. #define NVOBJ_ENGINE_MPEG 5
  137. #define NVOBJ_ENGINE_DISPLAY 15
  138. #define NVOBJ_ENGINE_NR 16
  139. #define NVOBJ_FLAG_DONT_MAP (1 << 0)
  140. #define NVOBJ_FLAG_ZERO_ALLOC (1 << 1)
  141. #define NVOBJ_FLAG_ZERO_FREE (1 << 2)
  142. #define NVOBJ_FLAG_VM (1 << 3)
  143. #define NVOBJ_FLAG_VM_USER (1 << 4)
  144. #define NVOBJ_CINST_GLOBAL 0xdeadbeef
  145. struct nouveau_gpuobj {
  146. struct drm_device *dev;
  147. struct kref refcount;
  148. struct list_head list;
  149. void *node;
  150. u32 *suspend;
  151. uint32_t flags;
  152. u32 size;
  153. u32 pinst; /* PRAMIN BAR offset */
  154. u32 cinst; /* Channel offset */
  155. u64 vinst; /* VRAM address */
  156. u64 linst; /* VM address */
  157. uint32_t engine;
  158. uint32_t class;
  159. void (*dtor)(struct drm_device *, struct nouveau_gpuobj *);
  160. void *priv;
  161. };
  162. struct nouveau_page_flip_state {
  163. struct list_head head;
  164. struct drm_pending_vblank_event *event;
  165. int crtc, bpp, pitch, x, y;
  166. uint64_t offset;
  167. };
  168. enum nouveau_channel_mutex_class {
  169. NOUVEAU_UCHANNEL_MUTEX,
  170. NOUVEAU_KCHANNEL_MUTEX
  171. };
  172. struct nouveau_channel {
  173. struct drm_device *dev;
  174. struct list_head list;
  175. int id;
  176. /* references to the channel data structure */
  177. struct kref ref;
  178. /* users of the hardware channel resources, the hardware
  179. * context will be kicked off when it reaches zero. */
  180. atomic_t users;
  181. struct mutex mutex;
  182. /* owner of this fifo */
  183. struct drm_file *file_priv;
  184. /* mapping of the fifo itself */
  185. struct drm_local_map *map;
  186. /* mapping of the regs controlling the fifo */
  187. void __iomem *user;
  188. uint32_t user_get;
  189. uint32_t user_put;
  190. /* Fencing */
  191. struct {
  192. /* lock protects the pending list only */
  193. spinlock_t lock;
  194. struct list_head pending;
  195. uint32_t sequence;
  196. uint32_t sequence_ack;
  197. atomic_t last_sequence_irq;
  198. } fence;
  199. /* DMA push buffer */
  200. struct nouveau_gpuobj *pushbuf;
  201. struct nouveau_bo *pushbuf_bo;
  202. uint32_t pushbuf_base;
  203. /* Notifier memory */
  204. struct nouveau_bo *notifier_bo;
  205. struct drm_mm notifier_heap;
  206. /* PFIFO context */
  207. struct nouveau_gpuobj *ramfc;
  208. struct nouveau_gpuobj *cache;
  209. void *fifo_priv;
  210. /* Execution engine contexts */
  211. void *engctx[NVOBJ_ENGINE_NR];
  212. /* NV50 VM */
  213. struct nouveau_vm *vm;
  214. struct nouveau_gpuobj *vm_pd;
  215. /* Objects */
  216. struct nouveau_gpuobj *ramin; /* Private instmem */
  217. struct drm_mm ramin_heap; /* Private PRAMIN heap */
  218. struct nouveau_ramht *ramht; /* Hash table */
  219. /* GPU object info for stuff used in-kernel (mm_enabled) */
  220. uint32_t m2mf_ntfy;
  221. uint32_t vram_handle;
  222. uint32_t gart_handle;
  223. bool accel_done;
  224. /* Push buffer state (only for drm's channel on !mm_enabled) */
  225. struct {
  226. int max;
  227. int free;
  228. int cur;
  229. int put;
  230. /* access via pushbuf_bo */
  231. int ib_base;
  232. int ib_max;
  233. int ib_free;
  234. int ib_put;
  235. } dma;
  236. uint32_t sw_subchannel[8];
  237. struct {
  238. struct nouveau_gpuobj *vblsem;
  239. uint32_t vblsem_head;
  240. uint32_t vblsem_offset;
  241. uint32_t vblsem_rval;
  242. struct list_head vbl_wait;
  243. struct list_head flip;
  244. } nvsw;
  245. struct {
  246. bool active;
  247. char name[32];
  248. struct drm_info_list info;
  249. } debugfs;
  250. };
  251. struct nouveau_exec_engine {
  252. void (*destroy)(struct drm_device *, int engine);
  253. int (*init)(struct drm_device *, int engine);
  254. int (*fini)(struct drm_device *, int engine);
  255. int (*context_new)(struct nouveau_channel *, int engine);
  256. void (*context_del)(struct nouveau_channel *, int engine);
  257. int (*object_new)(struct nouveau_channel *, int engine,
  258. u32 handle, u16 class);
  259. void (*set_tile_region)(struct drm_device *dev, int i);
  260. void (*tlb_flush)(struct drm_device *, int engine);
  261. };
  262. struct nouveau_instmem_engine {
  263. void *priv;
  264. int (*init)(struct drm_device *dev);
  265. void (*takedown)(struct drm_device *dev);
  266. int (*suspend)(struct drm_device *dev);
  267. void (*resume)(struct drm_device *dev);
  268. int (*get)(struct nouveau_gpuobj *, struct nouveau_channel *,
  269. u32 size, u32 align);
  270. void (*put)(struct nouveau_gpuobj *);
  271. int (*map)(struct nouveau_gpuobj *);
  272. void (*unmap)(struct nouveau_gpuobj *);
  273. void (*flush)(struct drm_device *);
  274. };
  275. struct nouveau_mc_engine {
  276. int (*init)(struct drm_device *dev);
  277. void (*takedown)(struct drm_device *dev);
  278. };
  279. struct nouveau_timer_engine {
  280. int (*init)(struct drm_device *dev);
  281. void (*takedown)(struct drm_device *dev);
  282. uint64_t (*read)(struct drm_device *dev);
  283. };
  284. struct nouveau_fb_engine {
  285. int num_tiles;
  286. struct drm_mm tag_heap;
  287. void *priv;
  288. int (*init)(struct drm_device *dev);
  289. void (*takedown)(struct drm_device *dev);
  290. void (*init_tile_region)(struct drm_device *dev, int i,
  291. uint32_t addr, uint32_t size,
  292. uint32_t pitch, uint32_t flags);
  293. void (*set_tile_region)(struct drm_device *dev, int i);
  294. void (*free_tile_region)(struct drm_device *dev, int i);
  295. };
  296. struct nouveau_fifo_engine {
  297. void *priv;
  298. int channels;
  299. struct nouveau_gpuobj *playlist[2];
  300. int cur_playlist;
  301. int (*init)(struct drm_device *);
  302. void (*takedown)(struct drm_device *);
  303. void (*disable)(struct drm_device *);
  304. void (*enable)(struct drm_device *);
  305. bool (*reassign)(struct drm_device *, bool enable);
  306. bool (*cache_pull)(struct drm_device *dev, bool enable);
  307. int (*channel_id)(struct drm_device *);
  308. int (*create_context)(struct nouveau_channel *);
  309. void (*destroy_context)(struct nouveau_channel *);
  310. int (*load_context)(struct nouveau_channel *);
  311. int (*unload_context)(struct drm_device *);
  312. void (*tlb_flush)(struct drm_device *dev);
  313. };
  314. struct nouveau_display_engine {
  315. void *priv;
  316. int (*early_init)(struct drm_device *);
  317. void (*late_takedown)(struct drm_device *);
  318. int (*create)(struct drm_device *);
  319. int (*init)(struct drm_device *);
  320. void (*destroy)(struct drm_device *);
  321. };
  322. struct nouveau_gpio_engine {
  323. void *priv;
  324. int (*init)(struct drm_device *);
  325. void (*takedown)(struct drm_device *);
  326. int (*get)(struct drm_device *, enum dcb_gpio_tag);
  327. int (*set)(struct drm_device *, enum dcb_gpio_tag, int state);
  328. int (*irq_register)(struct drm_device *, enum dcb_gpio_tag,
  329. void (*)(void *, int), void *);
  330. void (*irq_unregister)(struct drm_device *, enum dcb_gpio_tag,
  331. void (*)(void *, int), void *);
  332. bool (*irq_enable)(struct drm_device *, enum dcb_gpio_tag, bool on);
  333. };
  334. struct nouveau_pm_voltage_level {
  335. u8 voltage;
  336. u8 vid;
  337. };
  338. struct nouveau_pm_voltage {
  339. bool supported;
  340. u8 vid_mask;
  341. struct nouveau_pm_voltage_level *level;
  342. int nr_level;
  343. };
  344. struct nouveau_pm_memtiming {
  345. int id;
  346. u32 reg_100220;
  347. u32 reg_100224;
  348. u32 reg_100228;
  349. u32 reg_10022c;
  350. u32 reg_100230;
  351. u32 reg_100234;
  352. u32 reg_100238;
  353. u32 reg_10023c;
  354. u32 reg_100240;
  355. };
  356. #define NOUVEAU_PM_MAX_LEVEL 8
  357. struct nouveau_pm_level {
  358. struct device_attribute dev_attr;
  359. char name[32];
  360. int id;
  361. u32 core;
  362. u32 memory;
  363. u32 shader;
  364. u32 unk05;
  365. u32 unk0a;
  366. u8 voltage;
  367. u8 fanspeed;
  368. u16 memscript;
  369. struct nouveau_pm_memtiming *timing;
  370. };
  371. struct nouveau_pm_temp_sensor_constants {
  372. u16 offset_constant;
  373. s16 offset_mult;
  374. u16 offset_div;
  375. u16 slope_mult;
  376. u16 slope_div;
  377. };
  378. struct nouveau_pm_threshold_temp {
  379. s16 critical;
  380. s16 down_clock;
  381. s16 fan_boost;
  382. };
  383. struct nouveau_pm_memtimings {
  384. bool supported;
  385. struct nouveau_pm_memtiming *timing;
  386. int nr_timing;
  387. };
  388. struct nouveau_pm_engine {
  389. struct nouveau_pm_voltage voltage;
  390. struct nouveau_pm_level perflvl[NOUVEAU_PM_MAX_LEVEL];
  391. int nr_perflvl;
  392. struct nouveau_pm_memtimings memtimings;
  393. struct nouveau_pm_temp_sensor_constants sensor_constants;
  394. struct nouveau_pm_threshold_temp threshold_temp;
  395. struct nouveau_pm_level boot;
  396. struct nouveau_pm_level *cur;
  397. struct device *hwmon;
  398. struct notifier_block acpi_nb;
  399. int (*clock_get)(struct drm_device *, u32 id);
  400. void *(*clock_pre)(struct drm_device *, struct nouveau_pm_level *,
  401. u32 id, int khz);
  402. void (*clock_set)(struct drm_device *, void *);
  403. int (*voltage_get)(struct drm_device *);
  404. int (*voltage_set)(struct drm_device *, int voltage);
  405. int (*fanspeed_get)(struct drm_device *);
  406. int (*fanspeed_set)(struct drm_device *, int fanspeed);
  407. int (*temp_get)(struct drm_device *);
  408. };
  409. struct nouveau_vram_engine {
  410. int (*init)(struct drm_device *);
  411. int (*get)(struct drm_device *, u64, u32 align, u32 size_nc,
  412. u32 type, struct nouveau_mem **);
  413. void (*put)(struct drm_device *, struct nouveau_mem **);
  414. bool (*flags_valid)(struct drm_device *, u32 tile_flags);
  415. };
  416. struct nouveau_engine {
  417. struct nouveau_instmem_engine instmem;
  418. struct nouveau_mc_engine mc;
  419. struct nouveau_timer_engine timer;
  420. struct nouveau_fb_engine fb;
  421. struct nouveau_fifo_engine fifo;
  422. struct nouveau_display_engine display;
  423. struct nouveau_gpio_engine gpio;
  424. struct nouveau_pm_engine pm;
  425. struct nouveau_vram_engine vram;
  426. };
  427. struct nouveau_pll_vals {
  428. union {
  429. struct {
  430. #ifdef __BIG_ENDIAN
  431. uint8_t N1, M1, N2, M2;
  432. #else
  433. uint8_t M1, N1, M2, N2;
  434. #endif
  435. };
  436. struct {
  437. uint16_t NM1, NM2;
  438. } __attribute__((packed));
  439. };
  440. int log2P;
  441. int refclk;
  442. };
  443. enum nv04_fp_display_regs {
  444. FP_DISPLAY_END,
  445. FP_TOTAL,
  446. FP_CRTC,
  447. FP_SYNC_START,
  448. FP_SYNC_END,
  449. FP_VALID_START,
  450. FP_VALID_END
  451. };
  452. struct nv04_crtc_reg {
  453. unsigned char MiscOutReg;
  454. uint8_t CRTC[0xa0];
  455. uint8_t CR58[0x10];
  456. uint8_t Sequencer[5];
  457. uint8_t Graphics[9];
  458. uint8_t Attribute[21];
  459. unsigned char DAC[768];
  460. /* PCRTC regs */
  461. uint32_t fb_start;
  462. uint32_t crtc_cfg;
  463. uint32_t cursor_cfg;
  464. uint32_t gpio_ext;
  465. uint32_t crtc_830;
  466. uint32_t crtc_834;
  467. uint32_t crtc_850;
  468. uint32_t crtc_eng_ctrl;
  469. /* PRAMDAC regs */
  470. uint32_t nv10_cursync;
  471. struct nouveau_pll_vals pllvals;
  472. uint32_t ramdac_gen_ctrl;
  473. uint32_t ramdac_630;
  474. uint32_t ramdac_634;
  475. uint32_t tv_setup;
  476. uint32_t tv_vtotal;
  477. uint32_t tv_vskew;
  478. uint32_t tv_vsync_delay;
  479. uint32_t tv_htotal;
  480. uint32_t tv_hskew;
  481. uint32_t tv_hsync_delay;
  482. uint32_t tv_hsync_delay2;
  483. uint32_t fp_horiz_regs[7];
  484. uint32_t fp_vert_regs[7];
  485. uint32_t dither;
  486. uint32_t fp_control;
  487. uint32_t dither_regs[6];
  488. uint32_t fp_debug_0;
  489. uint32_t fp_debug_1;
  490. uint32_t fp_debug_2;
  491. uint32_t fp_margin_color;
  492. uint32_t ramdac_8c0;
  493. uint32_t ramdac_a20;
  494. uint32_t ramdac_a24;
  495. uint32_t ramdac_a34;
  496. uint32_t ctv_regs[38];
  497. };
  498. struct nv04_output_reg {
  499. uint32_t output;
  500. int head;
  501. };
  502. struct nv04_mode_state {
  503. struct nv04_crtc_reg crtc_reg[2];
  504. uint32_t pllsel;
  505. uint32_t sel_clk;
  506. };
  507. enum nouveau_card_type {
  508. NV_04 = 0x00,
  509. NV_10 = 0x10,
  510. NV_20 = 0x20,
  511. NV_30 = 0x30,
  512. NV_40 = 0x40,
  513. NV_50 = 0x50,
  514. NV_C0 = 0xc0,
  515. };
  516. struct drm_nouveau_private {
  517. struct drm_device *dev;
  518. bool noaccel;
  519. /* the card type, takes NV_* as values */
  520. enum nouveau_card_type card_type;
  521. /* exact chipset, derived from NV_PMC_BOOT_0 */
  522. int chipset;
  523. int stepping;
  524. int flags;
  525. void __iomem *mmio;
  526. spinlock_t ramin_lock;
  527. void __iomem *ramin;
  528. u32 ramin_size;
  529. u32 ramin_base;
  530. bool ramin_available;
  531. struct drm_mm ramin_heap;
  532. struct nouveau_exec_engine *eng[NVOBJ_ENGINE_NR];
  533. struct list_head gpuobj_list;
  534. struct list_head classes;
  535. struct nouveau_bo *vga_ram;
  536. /* interrupt handling */
  537. void (*irq_handler[32])(struct drm_device *);
  538. bool msi_enabled;
  539. struct list_head vbl_waiting;
  540. struct {
  541. struct drm_global_reference mem_global_ref;
  542. struct ttm_bo_global_ref bo_global_ref;
  543. struct ttm_bo_device bdev;
  544. atomic_t validate_sequence;
  545. } ttm;
  546. struct {
  547. spinlock_t lock;
  548. struct drm_mm heap;
  549. struct nouveau_bo *bo;
  550. } fence;
  551. struct {
  552. spinlock_t lock;
  553. struct nouveau_channel *ptr[NOUVEAU_MAX_CHANNEL_NR];
  554. } channels;
  555. struct nouveau_engine engine;
  556. struct nouveau_channel *channel;
  557. /* For PFIFO and PGRAPH. */
  558. spinlock_t context_switch_lock;
  559. /* VM/PRAMIN flush, legacy PRAMIN aperture */
  560. spinlock_t vm_lock;
  561. /* RAMIN configuration, RAMFC, RAMHT and RAMRO offsets */
  562. struct nouveau_ramht *ramht;
  563. struct nouveau_gpuobj *ramfc;
  564. struct nouveau_gpuobj *ramro;
  565. uint32_t ramin_rsvd_vram;
  566. struct {
  567. enum {
  568. NOUVEAU_GART_NONE = 0,
  569. NOUVEAU_GART_AGP, /* AGP */
  570. NOUVEAU_GART_PDMA, /* paged dma object */
  571. NOUVEAU_GART_HW /* on-chip gart/vm */
  572. } type;
  573. uint64_t aper_base;
  574. uint64_t aper_size;
  575. uint64_t aper_free;
  576. struct ttm_backend_func *func;
  577. struct {
  578. struct page *page;
  579. dma_addr_t addr;
  580. } dummy;
  581. struct nouveau_gpuobj *sg_ctxdma;
  582. } gart_info;
  583. /* nv10-nv40 tiling regions */
  584. struct {
  585. struct nouveau_tile_reg reg[NOUVEAU_MAX_TILE_NR];
  586. spinlock_t lock;
  587. } tile;
  588. /* VRAM/fb configuration */
  589. uint64_t vram_size;
  590. uint64_t vram_sys_base;
  591. u32 vram_rblock_size;
  592. uint64_t fb_phys;
  593. uint64_t fb_available_size;
  594. uint64_t fb_mappable_pages;
  595. uint64_t fb_aper_free;
  596. int fb_mtrr;
  597. /* BAR control (NV50-) */
  598. struct nouveau_vm *bar1_vm;
  599. struct nouveau_vm *bar3_vm;
  600. /* G8x/G9x virtual address space */
  601. struct nouveau_vm *chan_vm;
  602. struct nvbios vbios;
  603. struct nv04_mode_state mode_reg;
  604. struct nv04_mode_state saved_reg;
  605. uint32_t saved_vga_font[4][16384];
  606. uint32_t crtc_owner;
  607. uint32_t dac_users[4];
  608. struct backlight_device *backlight;
  609. struct {
  610. struct dentry *channel_root;
  611. } debugfs;
  612. struct nouveau_fbdev *nfbdev;
  613. struct apertures_struct *apertures;
  614. };
  615. static inline struct drm_nouveau_private *
  616. nouveau_private(struct drm_device *dev)
  617. {
  618. return dev->dev_private;
  619. }
  620. static inline struct drm_nouveau_private *
  621. nouveau_bdev(struct ttm_bo_device *bd)
  622. {
  623. return container_of(bd, struct drm_nouveau_private, ttm.bdev);
  624. }
  625. static inline int
  626. nouveau_bo_ref(struct nouveau_bo *ref, struct nouveau_bo **pnvbo)
  627. {
  628. struct nouveau_bo *prev;
  629. if (!pnvbo)
  630. return -EINVAL;
  631. prev = *pnvbo;
  632. *pnvbo = ref ? nouveau_bo(ttm_bo_reference(&ref->bo)) : NULL;
  633. if (prev) {
  634. struct ttm_buffer_object *bo = &prev->bo;
  635. ttm_bo_unref(&bo);
  636. }
  637. return 0;
  638. }
  639. /* nouveau_drv.c */
  640. extern int nouveau_agpmode;
  641. extern int nouveau_duallink;
  642. extern int nouveau_uscript_lvds;
  643. extern int nouveau_uscript_tmds;
  644. extern int nouveau_vram_pushbuf;
  645. extern int nouveau_vram_notify;
  646. extern int nouveau_fbpercrtc;
  647. extern int nouveau_tv_disable;
  648. extern char *nouveau_tv_norm;
  649. extern int nouveau_reg_debug;
  650. extern char *nouveau_vbios;
  651. extern int nouveau_ignorelid;
  652. extern int nouveau_nofbaccel;
  653. extern int nouveau_noaccel;
  654. extern int nouveau_force_post;
  655. extern int nouveau_override_conntype;
  656. extern char *nouveau_perflvl;
  657. extern int nouveau_perflvl_wr;
  658. extern int nouveau_msi;
  659. extern int nouveau_ctxfw;
  660. extern int nouveau_pci_suspend(struct pci_dev *pdev, pm_message_t pm_state);
  661. extern int nouveau_pci_resume(struct pci_dev *pdev);
  662. /* nouveau_state.c */
  663. extern int nouveau_open(struct drm_device *, struct drm_file *);
  664. extern void nouveau_preclose(struct drm_device *dev, struct drm_file *);
  665. extern void nouveau_postclose(struct drm_device *, struct drm_file *);
  666. extern int nouveau_load(struct drm_device *, unsigned long flags);
  667. extern int nouveau_firstopen(struct drm_device *);
  668. extern void nouveau_lastclose(struct drm_device *);
  669. extern int nouveau_unload(struct drm_device *);
  670. extern int nouveau_ioctl_getparam(struct drm_device *, void *data,
  671. struct drm_file *);
  672. extern int nouveau_ioctl_setparam(struct drm_device *, void *data,
  673. struct drm_file *);
  674. extern bool nouveau_wait_eq(struct drm_device *, uint64_t timeout,
  675. uint32_t reg, uint32_t mask, uint32_t val);
  676. extern bool nouveau_wait_ne(struct drm_device *, uint64_t timeout,
  677. uint32_t reg, uint32_t mask, uint32_t val);
  678. extern bool nouveau_wait_for_idle(struct drm_device *);
  679. extern int nouveau_card_init(struct drm_device *);
  680. /* nouveau_mem.c */
  681. extern int nouveau_mem_vram_init(struct drm_device *);
  682. extern void nouveau_mem_vram_fini(struct drm_device *);
  683. extern int nouveau_mem_gart_init(struct drm_device *);
  684. extern void nouveau_mem_gart_fini(struct drm_device *);
  685. extern int nouveau_mem_init_agp(struct drm_device *);
  686. extern int nouveau_mem_reset_agp(struct drm_device *);
  687. extern void nouveau_mem_close(struct drm_device *);
  688. extern int nouveau_mem_detect(struct drm_device *);
  689. extern bool nouveau_mem_flags_valid(struct drm_device *, u32 tile_flags);
  690. extern struct nouveau_tile_reg *nv10_mem_set_tiling(
  691. struct drm_device *dev, uint32_t addr, uint32_t size,
  692. uint32_t pitch, uint32_t flags);
  693. extern void nv10_mem_put_tile_region(struct drm_device *dev,
  694. struct nouveau_tile_reg *tile,
  695. struct nouveau_fence *fence);
  696. extern const struct ttm_mem_type_manager_func nouveau_vram_manager;
  697. extern const struct ttm_mem_type_manager_func nouveau_gart_manager;
  698. /* nouveau_notifier.c */
  699. extern int nouveau_notifier_init_channel(struct nouveau_channel *);
  700. extern void nouveau_notifier_takedown_channel(struct nouveau_channel *);
  701. extern int nouveau_notifier_alloc(struct nouveau_channel *, uint32_t handle,
  702. int cout, uint32_t start, uint32_t end,
  703. uint32_t *offset);
  704. extern int nouveau_notifier_offset(struct nouveau_gpuobj *, uint32_t *);
  705. extern int nouveau_ioctl_notifier_alloc(struct drm_device *, void *data,
  706. struct drm_file *);
  707. extern int nouveau_ioctl_notifier_free(struct drm_device *, void *data,
  708. struct drm_file *);
  709. /* nouveau_channel.c */
  710. extern struct drm_ioctl_desc nouveau_ioctls[];
  711. extern int nouveau_max_ioctl;
  712. extern void nouveau_channel_cleanup(struct drm_device *, struct drm_file *);
  713. extern int nouveau_channel_alloc(struct drm_device *dev,
  714. struct nouveau_channel **chan,
  715. struct drm_file *file_priv,
  716. uint32_t fb_ctxdma, uint32_t tt_ctxdma);
  717. extern struct nouveau_channel *
  718. nouveau_channel_get_unlocked(struct nouveau_channel *);
  719. extern struct nouveau_channel *
  720. nouveau_channel_get(struct drm_file *, int id);
  721. extern void nouveau_channel_put_unlocked(struct nouveau_channel **);
  722. extern void nouveau_channel_put(struct nouveau_channel **);
  723. extern void nouveau_channel_ref(struct nouveau_channel *chan,
  724. struct nouveau_channel **pchan);
  725. extern void nouveau_channel_idle(struct nouveau_channel *chan);
  726. /* nouveau_object.c */
  727. #define NVOBJ_ENGINE_ADD(d, e, p) do { \
  728. struct drm_nouveau_private *dev_priv = (d)->dev_private; \
  729. dev_priv->eng[NVOBJ_ENGINE_##e] = (p); \
  730. } while (0)
  731. #define NVOBJ_ENGINE_DEL(d, e) do { \
  732. struct drm_nouveau_private *dev_priv = (d)->dev_private; \
  733. dev_priv->eng[NVOBJ_ENGINE_##e] = NULL; \
  734. } while (0)
  735. #define NVOBJ_CLASS(d, c, e) do { \
  736. int ret = nouveau_gpuobj_class_new((d), (c), NVOBJ_ENGINE_##e); \
  737. if (ret) \
  738. return ret; \
  739. } while (0)
  740. #define NVOBJ_MTHD(d, c, m, e) do { \
  741. int ret = nouveau_gpuobj_mthd_new((d), (c), (m), (e)); \
  742. if (ret) \
  743. return ret; \
  744. } while (0)
  745. extern int nouveau_gpuobj_early_init(struct drm_device *);
  746. extern int nouveau_gpuobj_init(struct drm_device *);
  747. extern void nouveau_gpuobj_takedown(struct drm_device *);
  748. extern int nouveau_gpuobj_suspend(struct drm_device *dev);
  749. extern void nouveau_gpuobj_resume(struct drm_device *dev);
  750. extern int nouveau_gpuobj_class_new(struct drm_device *, u32 class, u32 eng);
  751. extern int nouveau_gpuobj_mthd_new(struct drm_device *, u32 class, u32 mthd,
  752. int (*exec)(struct nouveau_channel *,
  753. u32 class, u32 mthd, u32 data));
  754. extern int nouveau_gpuobj_mthd_call(struct nouveau_channel *, u32, u32, u32);
  755. extern int nouveau_gpuobj_mthd_call2(struct drm_device *, int, u32, u32, u32);
  756. extern int nouveau_gpuobj_channel_init(struct nouveau_channel *,
  757. uint32_t vram_h, uint32_t tt_h);
  758. extern void nouveau_gpuobj_channel_takedown(struct nouveau_channel *);
  759. extern int nouveau_gpuobj_new(struct drm_device *, struct nouveau_channel *,
  760. uint32_t size, int align, uint32_t flags,
  761. struct nouveau_gpuobj **);
  762. extern void nouveau_gpuobj_ref(struct nouveau_gpuobj *,
  763. struct nouveau_gpuobj **);
  764. extern int nouveau_gpuobj_new_fake(struct drm_device *, u32 pinst, u64 vinst,
  765. u32 size, u32 flags,
  766. struct nouveau_gpuobj **);
  767. extern int nouveau_gpuobj_dma_new(struct nouveau_channel *, int class,
  768. uint64_t offset, uint64_t size, int access,
  769. int target, struct nouveau_gpuobj **);
  770. extern int nouveau_gpuobj_gr_new(struct nouveau_channel *, u32 handle, int class);
  771. extern int nv50_gpuobj_dma_new(struct nouveau_channel *, int class, u64 base,
  772. u64 size, int target, int access, u32 type,
  773. u32 comp, struct nouveau_gpuobj **pobj);
  774. extern void nv50_gpuobj_dma_init(struct nouveau_gpuobj *, u32 offset,
  775. int class, u64 base, u64 size, int target,
  776. int access, u32 type, u32 comp);
  777. extern int nouveau_ioctl_grobj_alloc(struct drm_device *, void *data,
  778. struct drm_file *);
  779. extern int nouveau_ioctl_gpuobj_free(struct drm_device *, void *data,
  780. struct drm_file *);
  781. /* nouveau_irq.c */
  782. extern int nouveau_irq_init(struct drm_device *);
  783. extern void nouveau_irq_fini(struct drm_device *);
  784. extern irqreturn_t nouveau_irq_handler(DRM_IRQ_ARGS);
  785. extern void nouveau_irq_register(struct drm_device *, int status_bit,
  786. void (*)(struct drm_device *));
  787. extern void nouveau_irq_unregister(struct drm_device *, int status_bit);
  788. extern void nouveau_irq_preinstall(struct drm_device *);
  789. extern int nouveau_irq_postinstall(struct drm_device *);
  790. extern void nouveau_irq_uninstall(struct drm_device *);
  791. /* nouveau_sgdma.c */
  792. extern int nouveau_sgdma_init(struct drm_device *);
  793. extern void nouveau_sgdma_takedown(struct drm_device *);
  794. extern uint32_t nouveau_sgdma_get_physical(struct drm_device *,
  795. uint32_t offset);
  796. extern struct ttm_backend *nouveau_sgdma_init_ttm(struct drm_device *);
  797. /* nouveau_debugfs.c */
  798. #if defined(CONFIG_DRM_NOUVEAU_DEBUG)
  799. extern int nouveau_debugfs_init(struct drm_minor *);
  800. extern void nouveau_debugfs_takedown(struct drm_minor *);
  801. extern int nouveau_debugfs_channel_init(struct nouveau_channel *);
  802. extern void nouveau_debugfs_channel_fini(struct nouveau_channel *);
  803. #else
  804. static inline int
  805. nouveau_debugfs_init(struct drm_minor *minor)
  806. {
  807. return 0;
  808. }
  809. static inline void nouveau_debugfs_takedown(struct drm_minor *minor)
  810. {
  811. }
  812. static inline int
  813. nouveau_debugfs_channel_init(struct nouveau_channel *chan)
  814. {
  815. return 0;
  816. }
  817. static inline void
  818. nouveau_debugfs_channel_fini(struct nouveau_channel *chan)
  819. {
  820. }
  821. #endif
  822. /* nouveau_dma.c */
  823. extern void nouveau_dma_pre_init(struct nouveau_channel *);
  824. extern int nouveau_dma_init(struct nouveau_channel *);
  825. extern int nouveau_dma_wait(struct nouveau_channel *, int slots, int size);
  826. /* nouveau_acpi.c */
  827. #define ROM_BIOS_PAGE 4096
  828. #if defined(CONFIG_ACPI)
  829. void nouveau_register_dsm_handler(void);
  830. void nouveau_unregister_dsm_handler(void);
  831. int nouveau_acpi_get_bios_chunk(uint8_t *bios, int offset, int len);
  832. bool nouveau_acpi_rom_supported(struct pci_dev *pdev);
  833. int nouveau_acpi_edid(struct drm_device *, struct drm_connector *);
  834. #else
  835. static inline void nouveau_register_dsm_handler(void) {}
  836. static inline void nouveau_unregister_dsm_handler(void) {}
  837. static inline bool nouveau_acpi_rom_supported(struct pci_dev *pdev) { return false; }
  838. static inline int nouveau_acpi_get_bios_chunk(uint8_t *bios, int offset, int len) { return -EINVAL; }
  839. static inline int nouveau_acpi_edid(struct drm_device *dev, struct drm_connector *connector) { return -EINVAL; }
  840. #endif
  841. /* nouveau_backlight.c */
  842. #ifdef CONFIG_DRM_NOUVEAU_BACKLIGHT
  843. extern int nouveau_backlight_init(struct drm_connector *);
  844. extern void nouveau_backlight_exit(struct drm_connector *);
  845. #else
  846. static inline int nouveau_backlight_init(struct drm_connector *dev)
  847. {
  848. return 0;
  849. }
  850. static inline void nouveau_backlight_exit(struct drm_connector *dev) { }
  851. #endif
  852. /* nouveau_bios.c */
  853. extern int nouveau_bios_init(struct drm_device *);
  854. extern void nouveau_bios_takedown(struct drm_device *dev);
  855. extern int nouveau_run_vbios_init(struct drm_device *);
  856. extern void nouveau_bios_run_init_table(struct drm_device *, uint16_t table,
  857. struct dcb_entry *);
  858. extern struct dcb_gpio_entry *nouveau_bios_gpio_entry(struct drm_device *,
  859. enum dcb_gpio_tag);
  860. extern struct dcb_connector_table_entry *
  861. nouveau_bios_connector_entry(struct drm_device *, int index);
  862. extern u32 get_pll_register(struct drm_device *, enum pll_types);
  863. extern int get_pll_limits(struct drm_device *, uint32_t limit_match,
  864. struct pll_lims *);
  865. extern int nouveau_bios_run_display_table(struct drm_device *,
  866. struct dcb_entry *,
  867. uint32_t script, int pxclk);
  868. extern void *nouveau_bios_dp_table(struct drm_device *, struct dcb_entry *,
  869. int *length);
  870. extern bool nouveau_bios_fp_mode(struct drm_device *, struct drm_display_mode *);
  871. extern uint8_t *nouveau_bios_embedded_edid(struct drm_device *);
  872. extern int nouveau_bios_parse_lvds_table(struct drm_device *, int pxclk,
  873. bool *dl, bool *if_is_24bit);
  874. extern int run_tmds_table(struct drm_device *, struct dcb_entry *,
  875. int head, int pxclk);
  876. extern int call_lvds_script(struct drm_device *, struct dcb_entry *, int head,
  877. enum LVDS_script, int pxclk);
  878. /* nouveau_ttm.c */
  879. int nouveau_ttm_global_init(struct drm_nouveau_private *);
  880. void nouveau_ttm_global_release(struct drm_nouveau_private *);
  881. int nouveau_ttm_mmap(struct file *, struct vm_area_struct *);
  882. /* nouveau_dp.c */
  883. int nouveau_dp_auxch(struct nouveau_i2c_chan *auxch, int cmd, int addr,
  884. uint8_t *data, int data_nr);
  885. bool nouveau_dp_detect(struct drm_encoder *);
  886. bool nouveau_dp_link_train(struct drm_encoder *);
  887. /* nv04_fb.c */
  888. extern int nv04_fb_init(struct drm_device *);
  889. extern void nv04_fb_takedown(struct drm_device *);
  890. /* nv10_fb.c */
  891. extern int nv10_fb_init(struct drm_device *);
  892. extern void nv10_fb_takedown(struct drm_device *);
  893. extern void nv10_fb_init_tile_region(struct drm_device *dev, int i,
  894. uint32_t addr, uint32_t size,
  895. uint32_t pitch, uint32_t flags);
  896. extern void nv10_fb_set_tile_region(struct drm_device *dev, int i);
  897. extern void nv10_fb_free_tile_region(struct drm_device *dev, int i);
  898. /* nv30_fb.c */
  899. extern int nv30_fb_init(struct drm_device *);
  900. extern void nv30_fb_takedown(struct drm_device *);
  901. extern void nv30_fb_init_tile_region(struct drm_device *dev, int i,
  902. uint32_t addr, uint32_t size,
  903. uint32_t pitch, uint32_t flags);
  904. extern void nv30_fb_free_tile_region(struct drm_device *dev, int i);
  905. /* nv40_fb.c */
  906. extern int nv40_fb_init(struct drm_device *);
  907. extern void nv40_fb_takedown(struct drm_device *);
  908. extern void nv40_fb_set_tile_region(struct drm_device *dev, int i);
  909. /* nv50_fb.c */
  910. extern int nv50_fb_init(struct drm_device *);
  911. extern void nv50_fb_takedown(struct drm_device *);
  912. extern void nv50_fb_vm_trap(struct drm_device *, int display);
  913. /* nvc0_fb.c */
  914. extern int nvc0_fb_init(struct drm_device *);
  915. extern void nvc0_fb_takedown(struct drm_device *);
  916. /* nv04_fifo.c */
  917. extern int nv04_fifo_init(struct drm_device *);
  918. extern void nv04_fifo_fini(struct drm_device *);
  919. extern void nv04_fifo_disable(struct drm_device *);
  920. extern void nv04_fifo_enable(struct drm_device *);
  921. extern bool nv04_fifo_reassign(struct drm_device *, bool);
  922. extern bool nv04_fifo_cache_pull(struct drm_device *, bool);
  923. extern int nv04_fifo_channel_id(struct drm_device *);
  924. extern int nv04_fifo_create_context(struct nouveau_channel *);
  925. extern void nv04_fifo_destroy_context(struct nouveau_channel *);
  926. extern int nv04_fifo_load_context(struct nouveau_channel *);
  927. extern int nv04_fifo_unload_context(struct drm_device *);
  928. extern void nv04_fifo_isr(struct drm_device *);
  929. /* nv10_fifo.c */
  930. extern int nv10_fifo_init(struct drm_device *);
  931. extern int nv10_fifo_channel_id(struct drm_device *);
  932. extern int nv10_fifo_create_context(struct nouveau_channel *);
  933. extern int nv10_fifo_load_context(struct nouveau_channel *);
  934. extern int nv10_fifo_unload_context(struct drm_device *);
  935. /* nv40_fifo.c */
  936. extern int nv40_fifo_init(struct drm_device *);
  937. extern int nv40_fifo_create_context(struct nouveau_channel *);
  938. extern int nv40_fifo_load_context(struct nouveau_channel *);
  939. extern int nv40_fifo_unload_context(struct drm_device *);
  940. /* nv50_fifo.c */
  941. extern int nv50_fifo_init(struct drm_device *);
  942. extern void nv50_fifo_takedown(struct drm_device *);
  943. extern int nv50_fifo_channel_id(struct drm_device *);
  944. extern int nv50_fifo_create_context(struct nouveau_channel *);
  945. extern void nv50_fifo_destroy_context(struct nouveau_channel *);
  946. extern int nv50_fifo_load_context(struct nouveau_channel *);
  947. extern int nv50_fifo_unload_context(struct drm_device *);
  948. extern void nv50_fifo_tlb_flush(struct drm_device *dev);
  949. /* nvc0_fifo.c */
  950. extern int nvc0_fifo_init(struct drm_device *);
  951. extern void nvc0_fifo_takedown(struct drm_device *);
  952. extern void nvc0_fifo_disable(struct drm_device *);
  953. extern void nvc0_fifo_enable(struct drm_device *);
  954. extern bool nvc0_fifo_reassign(struct drm_device *, bool);
  955. extern bool nvc0_fifo_cache_pull(struct drm_device *, bool);
  956. extern int nvc0_fifo_channel_id(struct drm_device *);
  957. extern int nvc0_fifo_create_context(struct nouveau_channel *);
  958. extern void nvc0_fifo_destroy_context(struct nouveau_channel *);
  959. extern int nvc0_fifo_load_context(struct nouveau_channel *);
  960. extern int nvc0_fifo_unload_context(struct drm_device *);
  961. /* nv04_graph.c */
  962. extern int nv04_graph_create(struct drm_device *);
  963. extern void nv04_graph_fifo_access(struct drm_device *, bool);
  964. extern int nv04_graph_object_new(struct nouveau_channel *, int, u32, u16);
  965. extern int nv04_graph_mthd_page_flip(struct nouveau_channel *chan,
  966. u32 class, u32 mthd, u32 data);
  967. extern struct nouveau_bitfield nv04_graph_nsource[];
  968. /* nv10_graph.c */
  969. extern int nv10_graph_create(struct drm_device *);
  970. extern struct nouveau_channel *nv10_graph_channel(struct drm_device *);
  971. extern struct nouveau_bitfield nv10_graph_intr[];
  972. extern struct nouveau_bitfield nv10_graph_nstatus[];
  973. /* nv20_graph.c */
  974. extern int nv20_graph_create(struct drm_device *);
  975. /* nv40_graph.c */
  976. extern int nv40_graph_create(struct drm_device *);
  977. extern void nv40_grctx_init(struct nouveau_grctx *);
  978. /* nv50_graph.c */
  979. extern int nv50_graph_create(struct drm_device *);
  980. extern int nv50_grctx_init(struct nouveau_grctx *);
  981. extern struct nouveau_enum nv50_data_error_names[];
  982. extern int nv50_graph_isr_chid(struct drm_device *dev, u64 inst);
  983. /* nvc0_graph.c */
  984. extern int nvc0_graph_create(struct drm_device *);
  985. extern int nvc0_graph_isr_chid(struct drm_device *dev, u64 inst);
  986. /* nv84_crypt.c */
  987. extern int nv84_crypt_create(struct drm_device *);
  988. /* nva3_copy.c */
  989. extern int nva3_copy_create(struct drm_device *dev);
  990. /* nvc0_copy.c */
  991. extern int nvc0_copy_create(struct drm_device *dev, int engine);
  992. /* nv40_mpeg.c */
  993. extern int nv40_mpeg_create(struct drm_device *dev);
  994. /* nv50_mpeg.c */
  995. extern int nv50_mpeg_create(struct drm_device *dev);
  996. /* nv04_instmem.c */
  997. extern int nv04_instmem_init(struct drm_device *);
  998. extern void nv04_instmem_takedown(struct drm_device *);
  999. extern int nv04_instmem_suspend(struct drm_device *);
  1000. extern void nv04_instmem_resume(struct drm_device *);
  1001. extern int nv04_instmem_get(struct nouveau_gpuobj *, struct nouveau_channel *,
  1002. u32 size, u32 align);
  1003. extern void nv04_instmem_put(struct nouveau_gpuobj *);
  1004. extern int nv04_instmem_map(struct nouveau_gpuobj *);
  1005. extern void nv04_instmem_unmap(struct nouveau_gpuobj *);
  1006. extern void nv04_instmem_flush(struct drm_device *);
  1007. /* nv50_instmem.c */
  1008. extern int nv50_instmem_init(struct drm_device *);
  1009. extern void nv50_instmem_takedown(struct drm_device *);
  1010. extern int nv50_instmem_suspend(struct drm_device *);
  1011. extern void nv50_instmem_resume(struct drm_device *);
  1012. extern int nv50_instmem_get(struct nouveau_gpuobj *, struct nouveau_channel *,
  1013. u32 size, u32 align);
  1014. extern void nv50_instmem_put(struct nouveau_gpuobj *);
  1015. extern int nv50_instmem_map(struct nouveau_gpuobj *);
  1016. extern void nv50_instmem_unmap(struct nouveau_gpuobj *);
  1017. extern void nv50_instmem_flush(struct drm_device *);
  1018. extern void nv84_instmem_flush(struct drm_device *);
  1019. /* nvc0_instmem.c */
  1020. extern int nvc0_instmem_init(struct drm_device *);
  1021. extern void nvc0_instmem_takedown(struct drm_device *);
  1022. extern int nvc0_instmem_suspend(struct drm_device *);
  1023. extern void nvc0_instmem_resume(struct drm_device *);
  1024. /* nv04_mc.c */
  1025. extern int nv04_mc_init(struct drm_device *);
  1026. extern void nv04_mc_takedown(struct drm_device *);
  1027. /* nv40_mc.c */
  1028. extern int nv40_mc_init(struct drm_device *);
  1029. extern void nv40_mc_takedown(struct drm_device *);
  1030. /* nv50_mc.c */
  1031. extern int nv50_mc_init(struct drm_device *);
  1032. extern void nv50_mc_takedown(struct drm_device *);
  1033. /* nv04_timer.c */
  1034. extern int nv04_timer_init(struct drm_device *);
  1035. extern uint64_t nv04_timer_read(struct drm_device *);
  1036. extern void nv04_timer_takedown(struct drm_device *);
  1037. extern long nouveau_compat_ioctl(struct file *file, unsigned int cmd,
  1038. unsigned long arg);
  1039. /* nv04_dac.c */
  1040. extern int nv04_dac_create(struct drm_connector *, struct dcb_entry *);
  1041. extern uint32_t nv17_dac_sample_load(struct drm_encoder *encoder);
  1042. extern int nv04_dac_output_offset(struct drm_encoder *encoder);
  1043. extern void nv04_dac_update_dacclk(struct drm_encoder *encoder, bool enable);
  1044. extern bool nv04_dac_in_use(struct drm_encoder *encoder);
  1045. /* nv04_dfp.c */
  1046. extern int nv04_dfp_create(struct drm_connector *, struct dcb_entry *);
  1047. extern int nv04_dfp_get_bound_head(struct drm_device *dev, struct dcb_entry *dcbent);
  1048. extern void nv04_dfp_bind_head(struct drm_device *dev, struct dcb_entry *dcbent,
  1049. int head, bool dl);
  1050. extern void nv04_dfp_disable(struct drm_device *dev, int head);
  1051. extern void nv04_dfp_update_fp_control(struct drm_encoder *encoder, int mode);
  1052. /* nv04_tv.c */
  1053. extern int nv04_tv_identify(struct drm_device *dev, int i2c_index);
  1054. extern int nv04_tv_create(struct drm_connector *, struct dcb_entry *);
  1055. /* nv17_tv.c */
  1056. extern int nv17_tv_create(struct drm_connector *, struct dcb_entry *);
  1057. /* nv04_display.c */
  1058. extern int nv04_display_early_init(struct drm_device *);
  1059. extern void nv04_display_late_takedown(struct drm_device *);
  1060. extern int nv04_display_create(struct drm_device *);
  1061. extern int nv04_display_init(struct drm_device *);
  1062. extern void nv04_display_destroy(struct drm_device *);
  1063. /* nv04_crtc.c */
  1064. extern int nv04_crtc_create(struct drm_device *, int index);
  1065. /* nouveau_bo.c */
  1066. extern struct ttm_bo_driver nouveau_bo_driver;
  1067. extern int nouveau_bo_new(struct drm_device *, struct nouveau_channel *,
  1068. int size, int align, uint32_t flags,
  1069. uint32_t tile_mode, uint32_t tile_flags,
  1070. struct nouveau_bo **);
  1071. extern int nouveau_bo_pin(struct nouveau_bo *, uint32_t flags);
  1072. extern int nouveau_bo_unpin(struct nouveau_bo *);
  1073. extern int nouveau_bo_map(struct nouveau_bo *);
  1074. extern void nouveau_bo_unmap(struct nouveau_bo *);
  1075. extern void nouveau_bo_placement_set(struct nouveau_bo *, uint32_t type,
  1076. uint32_t busy);
  1077. extern u16 nouveau_bo_rd16(struct nouveau_bo *nvbo, unsigned index);
  1078. extern void nouveau_bo_wr16(struct nouveau_bo *nvbo, unsigned index, u16 val);
  1079. extern u32 nouveau_bo_rd32(struct nouveau_bo *nvbo, unsigned index);
  1080. extern void nouveau_bo_wr32(struct nouveau_bo *nvbo, unsigned index, u32 val);
  1081. extern void nouveau_bo_fence(struct nouveau_bo *, struct nouveau_fence *);
  1082. extern int nouveau_bo_validate(struct nouveau_bo *, bool interruptible,
  1083. bool no_wait_reserve, bool no_wait_gpu);
  1084. /* nouveau_fence.c */
  1085. struct nouveau_fence;
  1086. extern int nouveau_fence_init(struct drm_device *);
  1087. extern void nouveau_fence_fini(struct drm_device *);
  1088. extern int nouveau_fence_channel_init(struct nouveau_channel *);
  1089. extern void nouveau_fence_channel_fini(struct nouveau_channel *);
  1090. extern void nouveau_fence_update(struct nouveau_channel *);
  1091. extern int nouveau_fence_new(struct nouveau_channel *, struct nouveau_fence **,
  1092. bool emit);
  1093. extern int nouveau_fence_emit(struct nouveau_fence *);
  1094. extern void nouveau_fence_work(struct nouveau_fence *fence,
  1095. void (*work)(void *priv, bool signalled),
  1096. void *priv);
  1097. struct nouveau_channel *nouveau_fence_channel(struct nouveau_fence *);
  1098. extern bool __nouveau_fence_signalled(void *obj, void *arg);
  1099. extern int __nouveau_fence_wait(void *obj, void *arg, bool lazy, bool intr);
  1100. extern int __nouveau_fence_flush(void *obj, void *arg);
  1101. extern void __nouveau_fence_unref(void **obj);
  1102. extern void *__nouveau_fence_ref(void *obj);
  1103. static inline bool nouveau_fence_signalled(struct nouveau_fence *obj)
  1104. {
  1105. return __nouveau_fence_signalled(obj, NULL);
  1106. }
  1107. static inline int
  1108. nouveau_fence_wait(struct nouveau_fence *obj, bool lazy, bool intr)
  1109. {
  1110. return __nouveau_fence_wait(obj, NULL, lazy, intr);
  1111. }
  1112. extern int nouveau_fence_sync(struct nouveau_fence *, struct nouveau_channel *);
  1113. static inline int nouveau_fence_flush(struct nouveau_fence *obj)
  1114. {
  1115. return __nouveau_fence_flush(obj, NULL);
  1116. }
  1117. static inline void nouveau_fence_unref(struct nouveau_fence **obj)
  1118. {
  1119. __nouveau_fence_unref((void **)obj);
  1120. }
  1121. static inline struct nouveau_fence *nouveau_fence_ref(struct nouveau_fence *obj)
  1122. {
  1123. return __nouveau_fence_ref(obj);
  1124. }
  1125. /* nouveau_gem.c */
  1126. extern int nouveau_gem_new(struct drm_device *, int size, int align,
  1127. uint32_t domain, uint32_t tile_mode,
  1128. uint32_t tile_flags, struct nouveau_bo **);
  1129. extern int nouveau_gem_object_new(struct drm_gem_object *);
  1130. extern void nouveau_gem_object_del(struct drm_gem_object *);
  1131. extern int nouveau_gem_object_open(struct drm_gem_object *, struct drm_file *);
  1132. extern void nouveau_gem_object_close(struct drm_gem_object *,
  1133. struct drm_file *);
  1134. extern int nouveau_gem_ioctl_new(struct drm_device *, void *,
  1135. struct drm_file *);
  1136. extern int nouveau_gem_ioctl_pushbuf(struct drm_device *, void *,
  1137. struct drm_file *);
  1138. extern int nouveau_gem_ioctl_cpu_prep(struct drm_device *, void *,
  1139. struct drm_file *);
  1140. extern int nouveau_gem_ioctl_cpu_fini(struct drm_device *, void *,
  1141. struct drm_file *);
  1142. extern int nouveau_gem_ioctl_info(struct drm_device *, void *,
  1143. struct drm_file *);
  1144. /* nouveau_display.c */
  1145. int nouveau_vblank_enable(struct drm_device *dev, int crtc);
  1146. void nouveau_vblank_disable(struct drm_device *dev, int crtc);
  1147. int nouveau_crtc_page_flip(struct drm_crtc *crtc, struct drm_framebuffer *fb,
  1148. struct drm_pending_vblank_event *event);
  1149. int nouveau_finish_page_flip(struct nouveau_channel *,
  1150. struct nouveau_page_flip_state *);
  1151. /* nv10_gpio.c */
  1152. int nv10_gpio_get(struct drm_device *dev, enum dcb_gpio_tag tag);
  1153. int nv10_gpio_set(struct drm_device *dev, enum dcb_gpio_tag tag, int state);
  1154. /* nv50_gpio.c */
  1155. int nv50_gpio_init(struct drm_device *dev);
  1156. void nv50_gpio_fini(struct drm_device *dev);
  1157. int nv50_gpio_get(struct drm_device *dev, enum dcb_gpio_tag tag);
  1158. int nv50_gpio_set(struct drm_device *dev, enum dcb_gpio_tag tag, int state);
  1159. int nv50_gpio_irq_register(struct drm_device *, enum dcb_gpio_tag,
  1160. void (*)(void *, int), void *);
  1161. void nv50_gpio_irq_unregister(struct drm_device *, enum dcb_gpio_tag,
  1162. void (*)(void *, int), void *);
  1163. bool nv50_gpio_irq_enable(struct drm_device *, enum dcb_gpio_tag, bool on);
  1164. /* nv50_calc. */
  1165. int nv50_calc_pll(struct drm_device *, struct pll_lims *, int clk,
  1166. int *N1, int *M1, int *N2, int *M2, int *P);
  1167. int nva3_calc_pll(struct drm_device *, struct pll_lims *,
  1168. int clk, int *N, int *fN, int *M, int *P);
  1169. #ifndef ioread32_native
  1170. #ifdef __BIG_ENDIAN
  1171. #define ioread16_native ioread16be
  1172. #define iowrite16_native iowrite16be
  1173. #define ioread32_native ioread32be
  1174. #define iowrite32_native iowrite32be
  1175. #else /* def __BIG_ENDIAN */
  1176. #define ioread16_native ioread16
  1177. #define iowrite16_native iowrite16
  1178. #define ioread32_native ioread32
  1179. #define iowrite32_native iowrite32
  1180. #endif /* def __BIG_ENDIAN else */
  1181. #endif /* !ioread32_native */
  1182. /* channel control reg access */
  1183. static inline u32 nvchan_rd32(struct nouveau_channel *chan, unsigned reg)
  1184. {
  1185. return ioread32_native(chan->user + reg);
  1186. }
  1187. static inline void nvchan_wr32(struct nouveau_channel *chan,
  1188. unsigned reg, u32 val)
  1189. {
  1190. iowrite32_native(val, chan->user + reg);
  1191. }
  1192. /* register access */
  1193. static inline u32 nv_rd32(struct drm_device *dev, unsigned reg)
  1194. {
  1195. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1196. return ioread32_native(dev_priv->mmio + reg);
  1197. }
  1198. static inline void nv_wr32(struct drm_device *dev, unsigned reg, u32 val)
  1199. {
  1200. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1201. iowrite32_native(val, dev_priv->mmio + reg);
  1202. }
  1203. static inline u32 nv_mask(struct drm_device *dev, u32 reg, u32 mask, u32 val)
  1204. {
  1205. u32 tmp = nv_rd32(dev, reg);
  1206. nv_wr32(dev, reg, (tmp & ~mask) | val);
  1207. return tmp;
  1208. }
  1209. static inline u8 nv_rd08(struct drm_device *dev, unsigned reg)
  1210. {
  1211. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1212. return ioread8(dev_priv->mmio + reg);
  1213. }
  1214. static inline void nv_wr08(struct drm_device *dev, unsigned reg, u8 val)
  1215. {
  1216. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1217. iowrite8(val, dev_priv->mmio + reg);
  1218. }
  1219. #define nv_wait(dev, reg, mask, val) \
  1220. nouveau_wait_eq(dev, 2000000000ULL, (reg), (mask), (val))
  1221. #define nv_wait_ne(dev, reg, mask, val) \
  1222. nouveau_wait_ne(dev, 2000000000ULL, (reg), (mask), (val))
  1223. /* PRAMIN access */
  1224. static inline u32 nv_ri32(struct drm_device *dev, unsigned offset)
  1225. {
  1226. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1227. return ioread32_native(dev_priv->ramin + offset);
  1228. }
  1229. static inline void nv_wi32(struct drm_device *dev, unsigned offset, u32 val)
  1230. {
  1231. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1232. iowrite32_native(val, dev_priv->ramin + offset);
  1233. }
  1234. /* object access */
  1235. extern u32 nv_ro32(struct nouveau_gpuobj *, u32 offset);
  1236. extern void nv_wo32(struct nouveau_gpuobj *, u32 offset, u32 val);
  1237. /*
  1238. * Logging
  1239. * Argument d is (struct drm_device *).
  1240. */
  1241. #define NV_PRINTK(level, d, fmt, arg...) \
  1242. printk(level "[" DRM_NAME "] " DRIVER_NAME " %s: " fmt, \
  1243. pci_name(d->pdev), ##arg)
  1244. #ifndef NV_DEBUG_NOTRACE
  1245. #define NV_DEBUG(d, fmt, arg...) do { \
  1246. if (drm_debug & DRM_UT_DRIVER) { \
  1247. NV_PRINTK(KERN_DEBUG, d, "%s:%d - " fmt, __func__, \
  1248. __LINE__, ##arg); \
  1249. } \
  1250. } while (0)
  1251. #define NV_DEBUG_KMS(d, fmt, arg...) do { \
  1252. if (drm_debug & DRM_UT_KMS) { \
  1253. NV_PRINTK(KERN_DEBUG, d, "%s:%d - " fmt, __func__, \
  1254. __LINE__, ##arg); \
  1255. } \
  1256. } while (0)
  1257. #else
  1258. #define NV_DEBUG(d, fmt, arg...) do { \
  1259. if (drm_debug & DRM_UT_DRIVER) \
  1260. NV_PRINTK(KERN_DEBUG, d, fmt, ##arg); \
  1261. } while (0)
  1262. #define NV_DEBUG_KMS(d, fmt, arg...) do { \
  1263. if (drm_debug & DRM_UT_KMS) \
  1264. NV_PRINTK(KERN_DEBUG, d, fmt, ##arg); \
  1265. } while (0)
  1266. #endif
  1267. #define NV_ERROR(d, fmt, arg...) NV_PRINTK(KERN_ERR, d, fmt, ##arg)
  1268. #define NV_INFO(d, fmt, arg...) NV_PRINTK(KERN_INFO, d, fmt, ##arg)
  1269. #define NV_TRACEWARN(d, fmt, arg...) NV_PRINTK(KERN_NOTICE, d, fmt, ##arg)
  1270. #define NV_TRACE(d, fmt, arg...) NV_PRINTK(KERN_INFO, d, fmt, ##arg)
  1271. #define NV_WARN(d, fmt, arg...) NV_PRINTK(KERN_WARNING, d, fmt, ##arg)
  1272. /* nouveau_reg_debug bitmask */
  1273. enum {
  1274. NOUVEAU_REG_DEBUG_MC = 0x1,
  1275. NOUVEAU_REG_DEBUG_VIDEO = 0x2,
  1276. NOUVEAU_REG_DEBUG_FB = 0x4,
  1277. NOUVEAU_REG_DEBUG_EXTDEV = 0x8,
  1278. NOUVEAU_REG_DEBUG_CRTC = 0x10,
  1279. NOUVEAU_REG_DEBUG_RAMDAC = 0x20,
  1280. NOUVEAU_REG_DEBUG_VGACRTC = 0x40,
  1281. NOUVEAU_REG_DEBUG_RMVIO = 0x80,
  1282. NOUVEAU_REG_DEBUG_VGAATTR = 0x100,
  1283. NOUVEAU_REG_DEBUG_EVO = 0x200,
  1284. };
  1285. #define NV_REG_DEBUG(type, dev, fmt, arg...) do { \
  1286. if (nouveau_reg_debug & NOUVEAU_REG_DEBUG_##type) \
  1287. NV_PRINTK(KERN_DEBUG, dev, "%s: " fmt, __func__, ##arg); \
  1288. } while (0)
  1289. static inline bool
  1290. nv_two_heads(struct drm_device *dev)
  1291. {
  1292. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1293. const int impl = dev->pci_device & 0x0ff0;
  1294. if (dev_priv->card_type >= NV_10 && impl != 0x0100 &&
  1295. impl != 0x0150 && impl != 0x01a0 && impl != 0x0200)
  1296. return true;
  1297. return false;
  1298. }
  1299. static inline bool
  1300. nv_gf4_disp_arch(struct drm_device *dev)
  1301. {
  1302. return nv_two_heads(dev) && (dev->pci_device & 0x0ff0) != 0x0110;
  1303. }
  1304. static inline bool
  1305. nv_two_reg_pll(struct drm_device *dev)
  1306. {
  1307. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1308. const int impl = dev->pci_device & 0x0ff0;
  1309. if (impl == 0x0310 || impl == 0x0340 || dev_priv->card_type >= NV_40)
  1310. return true;
  1311. return false;
  1312. }
  1313. static inline bool
  1314. nv_match_device(struct drm_device *dev, unsigned device,
  1315. unsigned sub_vendor, unsigned sub_device)
  1316. {
  1317. return dev->pdev->device == device &&
  1318. dev->pdev->subsystem_vendor == sub_vendor &&
  1319. dev->pdev->subsystem_device == sub_device;
  1320. }
  1321. static inline void *
  1322. nv_engine(struct drm_device *dev, int engine)
  1323. {
  1324. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1325. return (void *)dev_priv->eng[engine];
  1326. }
  1327. /* returns 1 if device is one of the nv4x using the 0x4497 object class,
  1328. * helpful to determine a number of other hardware features
  1329. */
  1330. static inline int
  1331. nv44_graph_class(struct drm_device *dev)
  1332. {
  1333. struct drm_nouveau_private *dev_priv = dev->dev_private;
  1334. if ((dev_priv->chipset & 0xf0) == 0x60)
  1335. return 1;
  1336. return !(0x0baf & (1 << (dev_priv->chipset & 0x0f)));
  1337. }
  1338. /* memory type/access flags, do not match hardware values */
  1339. #define NV_MEM_ACCESS_RO 1
  1340. #define NV_MEM_ACCESS_WO 2
  1341. #define NV_MEM_ACCESS_RW (NV_MEM_ACCESS_RO | NV_MEM_ACCESS_WO)
  1342. #define NV_MEM_ACCESS_SYS 4
  1343. #define NV_MEM_ACCESS_VM 8
  1344. #define NV_MEM_TARGET_VRAM 0
  1345. #define NV_MEM_TARGET_PCI 1
  1346. #define NV_MEM_TARGET_PCI_NOSNOOP 2
  1347. #define NV_MEM_TARGET_VM 3
  1348. #define NV_MEM_TARGET_GART 4
  1349. #define NV_MEM_TYPE_VM 0x7f
  1350. #define NV_MEM_COMP_VM 0x03
  1351. /* NV_SW object class */
  1352. #define NV_SW 0x0000506e
  1353. #define NV_SW_DMA_SEMAPHORE 0x00000060
  1354. #define NV_SW_SEMAPHORE_OFFSET 0x00000064
  1355. #define NV_SW_SEMAPHORE_ACQUIRE 0x00000068
  1356. #define NV_SW_SEMAPHORE_RELEASE 0x0000006c
  1357. #define NV_SW_YIELD 0x00000080
  1358. #define NV_SW_DMA_VBLSEM 0x0000018c
  1359. #define NV_SW_VBLSEM_OFFSET 0x00000400
  1360. #define NV_SW_VBLSEM_RELEASE_VALUE 0x00000404
  1361. #define NV_SW_VBLSEM_RELEASE 0x00000408
  1362. #define NV_SW_PAGE_FLIP 0x00000500
  1363. #endif /* __NOUVEAU_DRV_H__ */