i915_drv.h 64 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109
  1. /* i915_drv.h -- Private header for the I915 driver -*- linux-c -*-
  2. */
  3. /*
  4. *
  5. * Copyright 2003 Tungsten Graphics, Inc., Cedar Park, Texas.
  6. * All Rights Reserved.
  7. *
  8. * Permission is hereby granted, free of charge, to any person obtaining a
  9. * copy of this software and associated documentation files (the
  10. * "Software"), to deal in the Software without restriction, including
  11. * without limitation the rights to use, copy, modify, merge, publish,
  12. * distribute, sub license, and/or sell copies of the Software, and to
  13. * permit persons to whom the Software is furnished to do so, subject to
  14. * the following conditions:
  15. *
  16. * The above copyright notice and this permission notice (including the
  17. * next paragraph) shall be included in all copies or substantial portions
  18. * of the Software.
  19. *
  20. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  21. * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  22. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  23. * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
  24. * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  25. * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  26. * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  27. *
  28. */
  29. #ifndef _I915_DRV_H_
  30. #define _I915_DRV_H_
  31. #include <uapi/drm/i915_drm.h>
  32. #include "i915_reg.h"
  33. #include "intel_bios.h"
  34. #include "intel_ringbuffer.h"
  35. #include <linux/io-mapping.h>
  36. #include <linux/i2c.h>
  37. #include <linux/i2c-algo-bit.h>
  38. #include <drm/intel-gtt.h>
  39. #include <linux/backlight.h>
  40. #include <linux/intel-iommu.h>
  41. #include <linux/kref.h>
  42. #include <linux/pm_qos.h>
  43. /* General customization:
  44. */
  45. #define DRIVER_AUTHOR "Tungsten Graphics, Inc."
  46. #define DRIVER_NAME "i915"
  47. #define DRIVER_DESC "Intel Graphics"
  48. #define DRIVER_DATE "20080730"
  49. enum pipe {
  50. PIPE_A = 0,
  51. PIPE_B,
  52. PIPE_C,
  53. I915_MAX_PIPES
  54. };
  55. #define pipe_name(p) ((p) + 'A')
  56. enum transcoder {
  57. TRANSCODER_A = 0,
  58. TRANSCODER_B,
  59. TRANSCODER_C,
  60. TRANSCODER_EDP = 0xF,
  61. };
  62. #define transcoder_name(t) ((t) + 'A')
  63. enum plane {
  64. PLANE_A = 0,
  65. PLANE_B,
  66. PLANE_C,
  67. };
  68. #define plane_name(p) ((p) + 'A')
  69. #define sprite_name(p, s) ((p) * dev_priv->num_plane + (s) + 'A')
  70. enum port {
  71. PORT_A = 0,
  72. PORT_B,
  73. PORT_C,
  74. PORT_D,
  75. PORT_E,
  76. I915_MAX_PORTS
  77. };
  78. #define port_name(p) ((p) + 'A')
  79. enum intel_display_power_domain {
  80. POWER_DOMAIN_PIPE_A,
  81. POWER_DOMAIN_PIPE_B,
  82. POWER_DOMAIN_PIPE_C,
  83. POWER_DOMAIN_PIPE_A_PANEL_FITTER,
  84. POWER_DOMAIN_PIPE_B_PANEL_FITTER,
  85. POWER_DOMAIN_PIPE_C_PANEL_FITTER,
  86. POWER_DOMAIN_TRANSCODER_A,
  87. POWER_DOMAIN_TRANSCODER_B,
  88. POWER_DOMAIN_TRANSCODER_C,
  89. POWER_DOMAIN_TRANSCODER_EDP = POWER_DOMAIN_TRANSCODER_A + 0xF,
  90. };
  91. #define POWER_DOMAIN_PIPE(pipe) ((pipe) + POWER_DOMAIN_PIPE_A)
  92. #define POWER_DOMAIN_PIPE_PANEL_FITTER(pipe) \
  93. ((pipe) + POWER_DOMAIN_PIPE_A_PANEL_FITTER)
  94. #define POWER_DOMAIN_TRANSCODER(tran) ((tran) + POWER_DOMAIN_TRANSCODER_A)
  95. enum hpd_pin {
  96. HPD_NONE = 0,
  97. HPD_PORT_A = HPD_NONE, /* PORT_A is internal */
  98. HPD_TV = HPD_NONE, /* TV is known to be unreliable */
  99. HPD_CRT,
  100. HPD_SDVO_B,
  101. HPD_SDVO_C,
  102. HPD_PORT_B,
  103. HPD_PORT_C,
  104. HPD_PORT_D,
  105. HPD_NUM_PINS
  106. };
  107. #define I915_GEM_GPU_DOMAINS \
  108. (I915_GEM_DOMAIN_RENDER | \
  109. I915_GEM_DOMAIN_SAMPLER | \
  110. I915_GEM_DOMAIN_COMMAND | \
  111. I915_GEM_DOMAIN_INSTRUCTION | \
  112. I915_GEM_DOMAIN_VERTEX)
  113. #define for_each_pipe(p) for ((p) = 0; (p) < INTEL_INFO(dev)->num_pipes; (p)++)
  114. #define for_each_encoder_on_crtc(dev, __crtc, intel_encoder) \
  115. list_for_each_entry((intel_encoder), &(dev)->mode_config.encoder_list, base.head) \
  116. if ((intel_encoder)->base.crtc == (__crtc))
  117. struct drm_i915_private;
  118. enum intel_dpll_id {
  119. DPLL_ID_PRIVATE = -1, /* non-shared dpll in use */
  120. /* real shared dpll ids must be >= 0 */
  121. DPLL_ID_PCH_PLL_A,
  122. DPLL_ID_PCH_PLL_B,
  123. };
  124. #define I915_NUM_PLLS 2
  125. struct intel_dpll_hw_state {
  126. uint32_t dpll;
  127. uint32_t dpll_md;
  128. uint32_t fp0;
  129. uint32_t fp1;
  130. };
  131. struct intel_shared_dpll {
  132. int refcount; /* count of number of CRTCs sharing this PLL */
  133. int active; /* count of number of active CRTCs (i.e. DPMS on) */
  134. bool on; /* is the PLL actually active? Disabled during modeset */
  135. const char *name;
  136. /* should match the index in the dev_priv->shared_dplls array */
  137. enum intel_dpll_id id;
  138. struct intel_dpll_hw_state hw_state;
  139. void (*mode_set)(struct drm_i915_private *dev_priv,
  140. struct intel_shared_dpll *pll);
  141. void (*enable)(struct drm_i915_private *dev_priv,
  142. struct intel_shared_dpll *pll);
  143. void (*disable)(struct drm_i915_private *dev_priv,
  144. struct intel_shared_dpll *pll);
  145. bool (*get_hw_state)(struct drm_i915_private *dev_priv,
  146. struct intel_shared_dpll *pll,
  147. struct intel_dpll_hw_state *hw_state);
  148. };
  149. /* Used by dp and fdi links */
  150. struct intel_link_m_n {
  151. uint32_t tu;
  152. uint32_t gmch_m;
  153. uint32_t gmch_n;
  154. uint32_t link_m;
  155. uint32_t link_n;
  156. };
  157. void intel_link_compute_m_n(int bpp, int nlanes,
  158. int pixel_clock, int link_clock,
  159. struct intel_link_m_n *m_n);
  160. struct intel_ddi_plls {
  161. int spll_refcount;
  162. int wrpll1_refcount;
  163. int wrpll2_refcount;
  164. };
  165. /* Interface history:
  166. *
  167. * 1.1: Original.
  168. * 1.2: Add Power Management
  169. * 1.3: Add vblank support
  170. * 1.4: Fix cmdbuffer path, add heap destroy
  171. * 1.5: Add vblank pipe configuration
  172. * 1.6: - New ioctl for scheduling buffer swaps on vertical blank
  173. * - Support vertical blank on secondary display pipe
  174. */
  175. #define DRIVER_MAJOR 1
  176. #define DRIVER_MINOR 6
  177. #define DRIVER_PATCHLEVEL 0
  178. #define WATCH_COHERENCY 0
  179. #define WATCH_LISTS 0
  180. #define WATCH_GTT 0
  181. #define I915_GEM_PHYS_CURSOR_0 1
  182. #define I915_GEM_PHYS_CURSOR_1 2
  183. #define I915_GEM_PHYS_OVERLAY_REGS 3
  184. #define I915_MAX_PHYS_OBJECT (I915_GEM_PHYS_OVERLAY_REGS)
  185. struct drm_i915_gem_phys_object {
  186. int id;
  187. struct page **page_list;
  188. drm_dma_handle_t *handle;
  189. struct drm_i915_gem_object *cur_obj;
  190. };
  191. struct opregion_header;
  192. struct opregion_acpi;
  193. struct opregion_swsci;
  194. struct opregion_asle;
  195. struct intel_opregion {
  196. struct opregion_header __iomem *header;
  197. struct opregion_acpi __iomem *acpi;
  198. struct opregion_swsci __iomem *swsci;
  199. struct opregion_asle __iomem *asle;
  200. void __iomem *vbt;
  201. u32 __iomem *lid_state;
  202. };
  203. #define OPREGION_SIZE (8*1024)
  204. struct intel_overlay;
  205. struct intel_overlay_error_state;
  206. struct drm_i915_master_private {
  207. drm_local_map_t *sarea;
  208. struct _drm_i915_sarea *sarea_priv;
  209. };
  210. #define I915_FENCE_REG_NONE -1
  211. #define I915_MAX_NUM_FENCES 32
  212. /* 32 fences + sign bit for FENCE_REG_NONE */
  213. #define I915_MAX_NUM_FENCE_BITS 6
  214. struct drm_i915_fence_reg {
  215. struct list_head lru_list;
  216. struct drm_i915_gem_object *obj;
  217. int pin_count;
  218. };
  219. struct sdvo_device_mapping {
  220. u8 initialized;
  221. u8 dvo_port;
  222. u8 slave_addr;
  223. u8 dvo_wiring;
  224. u8 i2c_pin;
  225. u8 ddc_pin;
  226. };
  227. struct intel_display_error_state;
  228. struct drm_i915_error_state {
  229. struct kref ref;
  230. u32 eir;
  231. u32 pgtbl_er;
  232. u32 ier;
  233. u32 ccid;
  234. u32 derrmr;
  235. u32 forcewake;
  236. bool waiting[I915_NUM_RINGS];
  237. u32 pipestat[I915_MAX_PIPES];
  238. u32 tail[I915_NUM_RINGS];
  239. u32 head[I915_NUM_RINGS];
  240. u32 ctl[I915_NUM_RINGS];
  241. u32 ipeir[I915_NUM_RINGS];
  242. u32 ipehr[I915_NUM_RINGS];
  243. u32 instdone[I915_NUM_RINGS];
  244. u32 acthd[I915_NUM_RINGS];
  245. u32 semaphore_mboxes[I915_NUM_RINGS][I915_NUM_RINGS - 1];
  246. u32 semaphore_seqno[I915_NUM_RINGS][I915_NUM_RINGS - 1];
  247. u32 rc_psmi[I915_NUM_RINGS]; /* sleep state */
  248. /* our own tracking of ring head and tail */
  249. u32 cpu_ring_head[I915_NUM_RINGS];
  250. u32 cpu_ring_tail[I915_NUM_RINGS];
  251. u32 error; /* gen6+ */
  252. u32 err_int; /* gen7 */
  253. u32 instpm[I915_NUM_RINGS];
  254. u32 instps[I915_NUM_RINGS];
  255. u32 extra_instdone[I915_NUM_INSTDONE_REG];
  256. u32 seqno[I915_NUM_RINGS];
  257. u64 bbaddr;
  258. u32 fault_reg[I915_NUM_RINGS];
  259. u32 done_reg;
  260. u32 faddr[I915_NUM_RINGS];
  261. u64 fence[I915_MAX_NUM_FENCES];
  262. struct timeval time;
  263. struct drm_i915_error_ring {
  264. struct drm_i915_error_object {
  265. int page_count;
  266. u32 gtt_offset;
  267. u32 *pages[0];
  268. } *ringbuffer, *batchbuffer, *ctx;
  269. struct drm_i915_error_request {
  270. long jiffies;
  271. u32 seqno;
  272. u32 tail;
  273. } *requests;
  274. int num_requests;
  275. } ring[I915_NUM_RINGS];
  276. struct drm_i915_error_buffer {
  277. u32 size;
  278. u32 name;
  279. u32 rseqno, wseqno;
  280. u32 gtt_offset;
  281. u32 read_domains;
  282. u32 write_domain;
  283. s32 fence_reg:I915_MAX_NUM_FENCE_BITS;
  284. s32 pinned:2;
  285. u32 tiling:2;
  286. u32 dirty:1;
  287. u32 purgeable:1;
  288. s32 ring:4;
  289. u32 cache_level:2;
  290. } *active_bo, *pinned_bo;
  291. u32 active_bo_count, pinned_bo_count;
  292. struct intel_overlay_error_state *overlay;
  293. struct intel_display_error_state *display;
  294. };
  295. struct intel_crtc_config;
  296. struct intel_crtc;
  297. struct intel_limit;
  298. struct dpll;
  299. struct drm_i915_display_funcs {
  300. bool (*fbc_enabled)(struct drm_device *dev);
  301. void (*enable_fbc)(struct drm_crtc *crtc, unsigned long interval);
  302. void (*disable_fbc)(struct drm_device *dev);
  303. int (*get_display_clock_speed)(struct drm_device *dev);
  304. int (*get_fifo_size)(struct drm_device *dev, int plane);
  305. /**
  306. * find_dpll() - Find the best values for the PLL
  307. * @limit: limits for the PLL
  308. * @crtc: current CRTC
  309. * @target: target frequency in kHz
  310. * @refclk: reference clock frequency in kHz
  311. * @match_clock: if provided, @best_clock P divider must
  312. * match the P divider from @match_clock
  313. * used for LVDS downclocking
  314. * @best_clock: best PLL values found
  315. *
  316. * Returns true on success, false on failure.
  317. */
  318. bool (*find_dpll)(const struct intel_limit *limit,
  319. struct drm_crtc *crtc,
  320. int target, int refclk,
  321. struct dpll *match_clock,
  322. struct dpll *best_clock);
  323. void (*update_wm)(struct drm_device *dev);
  324. void (*update_sprite_wm)(struct drm_device *dev, int pipe,
  325. uint32_t sprite_width, int pixel_size,
  326. bool enable);
  327. void (*modeset_global_resources)(struct drm_device *dev);
  328. /* Returns the active state of the crtc, and if the crtc is active,
  329. * fills out the pipe-config with the hw state. */
  330. bool (*get_pipe_config)(struct intel_crtc *,
  331. struct intel_crtc_config *);
  332. int (*crtc_mode_set)(struct drm_crtc *crtc,
  333. int x, int y,
  334. struct drm_framebuffer *old_fb);
  335. void (*crtc_enable)(struct drm_crtc *crtc);
  336. void (*crtc_disable)(struct drm_crtc *crtc);
  337. void (*off)(struct drm_crtc *crtc);
  338. void (*write_eld)(struct drm_connector *connector,
  339. struct drm_crtc *crtc);
  340. void (*fdi_link_train)(struct drm_crtc *crtc);
  341. void (*init_clock_gating)(struct drm_device *dev);
  342. int (*queue_flip)(struct drm_device *dev, struct drm_crtc *crtc,
  343. struct drm_framebuffer *fb,
  344. struct drm_i915_gem_object *obj);
  345. int (*update_plane)(struct drm_crtc *crtc, struct drm_framebuffer *fb,
  346. int x, int y);
  347. void (*hpd_irq_setup)(struct drm_device *dev);
  348. /* clock updates for mode set */
  349. /* cursor updates */
  350. /* render clock increase/decrease */
  351. /* display clock increase/decrease */
  352. /* pll clock increase/decrease */
  353. };
  354. struct drm_i915_gt_funcs {
  355. void (*force_wake_get)(struct drm_i915_private *dev_priv);
  356. void (*force_wake_put)(struct drm_i915_private *dev_priv);
  357. };
  358. #define DEV_INFO_FOR_EACH_FLAG(func, sep) \
  359. func(is_mobile) sep \
  360. func(is_i85x) sep \
  361. func(is_i915g) sep \
  362. func(is_i945gm) sep \
  363. func(is_g33) sep \
  364. func(need_gfx_hws) sep \
  365. func(is_g4x) sep \
  366. func(is_pineview) sep \
  367. func(is_broadwater) sep \
  368. func(is_crestline) sep \
  369. func(is_ivybridge) sep \
  370. func(is_valleyview) sep \
  371. func(is_haswell) sep \
  372. func(has_force_wake) sep \
  373. func(has_fbc) sep \
  374. func(has_pipe_cxsr) sep \
  375. func(has_hotplug) sep \
  376. func(cursor_needs_physical) sep \
  377. func(has_overlay) sep \
  378. func(overlay_needs_physical) sep \
  379. func(supports_tv) sep \
  380. func(has_bsd_ring) sep \
  381. func(has_blt_ring) sep \
  382. func(has_vebox_ring) sep \
  383. func(has_llc) sep \
  384. func(has_ddi) sep \
  385. func(has_fpga_dbg)
  386. #define DEFINE_FLAG(name) u8 name:1
  387. #define SEP_SEMICOLON ;
  388. struct intel_device_info {
  389. u32 display_mmio_offset;
  390. u8 num_pipes:3;
  391. u8 gen;
  392. DEV_INFO_FOR_EACH_FLAG(DEFINE_FLAG, SEP_SEMICOLON);
  393. };
  394. #undef DEFINE_FLAG
  395. #undef SEP_SEMICOLON
  396. enum i915_cache_level {
  397. I915_CACHE_NONE = 0,
  398. I915_CACHE_LLC,
  399. I915_CACHE_LLC_MLC, /* gen6+, in docs at least! */
  400. };
  401. typedef uint32_t gen6_gtt_pte_t;
  402. /* The Graphics Translation Table is the way in which GEN hardware translates a
  403. * Graphics Virtual Address into a Physical Address. In addition to the normal
  404. * collateral associated with any va->pa translations GEN hardware also has a
  405. * portion of the GTT which can be mapped by the CPU and remain both coherent
  406. * and correct (in cases like swizzling). That region is referred to as GMADR in
  407. * the spec.
  408. */
  409. struct i915_gtt {
  410. unsigned long start; /* Start offset of used GTT */
  411. size_t total; /* Total size GTT can map */
  412. size_t stolen_size; /* Total size of stolen memory */
  413. unsigned long mappable_end; /* End offset that we can CPU map */
  414. struct io_mapping *mappable; /* Mapping to our CPU mappable region */
  415. phys_addr_t mappable_base; /* PA of our GMADR */
  416. /** "Graphics Stolen Memory" holds the global PTEs */
  417. void __iomem *gsm;
  418. bool do_idle_maps;
  419. struct {
  420. dma_addr_t addr;
  421. struct page *page;
  422. } scratch;
  423. int mtrr;
  424. /* global gtt ops */
  425. int (*gtt_probe)(struct drm_device *dev, size_t *gtt_total,
  426. size_t *stolen, phys_addr_t *mappable_base,
  427. unsigned long *mappable_end);
  428. void (*gtt_remove)(struct drm_device *dev);
  429. void (*gtt_clear_range)(struct drm_device *dev,
  430. unsigned int first_entry,
  431. unsigned int num_entries);
  432. void (*gtt_insert_entries)(struct drm_device *dev,
  433. struct sg_table *st,
  434. unsigned int pg_start,
  435. enum i915_cache_level cache_level);
  436. gen6_gtt_pte_t (*pte_encode)(dma_addr_t addr,
  437. enum i915_cache_level level);
  438. };
  439. #define gtt_total_entries(gtt) ((gtt).total >> PAGE_SHIFT)
  440. struct i915_hw_ppgtt {
  441. struct drm_device *dev;
  442. unsigned num_pd_entries;
  443. struct page **pt_pages;
  444. uint32_t pd_offset;
  445. dma_addr_t *pt_dma_addr;
  446. /* pte functions, mirroring the interface of the global gtt. */
  447. void (*clear_range)(struct i915_hw_ppgtt *ppgtt,
  448. unsigned int first_entry,
  449. unsigned int num_entries);
  450. void (*insert_entries)(struct i915_hw_ppgtt *ppgtt,
  451. struct sg_table *st,
  452. unsigned int pg_start,
  453. enum i915_cache_level cache_level);
  454. gen6_gtt_pte_t (*pte_encode)(dma_addr_t addr,
  455. enum i915_cache_level level);
  456. int (*enable)(struct drm_device *dev);
  457. void (*cleanup)(struct i915_hw_ppgtt *ppgtt);
  458. };
  459. struct i915_ctx_hang_stats {
  460. /* This context had batch pending when hang was declared */
  461. unsigned batch_pending;
  462. /* This context had batch active when hang was declared */
  463. unsigned batch_active;
  464. };
  465. /* This must match up with the value previously used for execbuf2.rsvd1. */
  466. #define DEFAULT_CONTEXT_ID 0
  467. struct i915_hw_context {
  468. struct kref ref;
  469. int id;
  470. bool is_initialized;
  471. struct drm_i915_file_private *file_priv;
  472. struct intel_ring_buffer *ring;
  473. struct drm_i915_gem_object *obj;
  474. struct i915_ctx_hang_stats hang_stats;
  475. };
  476. struct i915_fbc {
  477. unsigned long size;
  478. unsigned int fb_id;
  479. enum plane plane;
  480. int y;
  481. struct drm_mm_node *compressed_fb;
  482. struct drm_mm_node *compressed_llb;
  483. struct intel_fbc_work {
  484. struct delayed_work work;
  485. struct drm_crtc *crtc;
  486. struct drm_framebuffer *fb;
  487. int interval;
  488. } *fbc_work;
  489. enum {
  490. FBC_NO_OUTPUT, /* no outputs enabled to compress */
  491. FBC_STOLEN_TOO_SMALL, /* not enough space for buffers */
  492. FBC_UNSUPPORTED_MODE, /* interlace or doublescanned mode */
  493. FBC_MODE_TOO_LARGE, /* mode too large for compression */
  494. FBC_BAD_PLANE, /* fbc not supported on plane */
  495. FBC_NOT_TILED, /* buffer not tiled */
  496. FBC_MULTIPLE_PIPES, /* more than one pipe active */
  497. FBC_MODULE_PARAM,
  498. FBC_CHIP_DEFAULT, /* disabled by default on this chip */
  499. } no_fbc_reason;
  500. };
  501. enum intel_pch {
  502. PCH_NONE = 0, /* No PCH present */
  503. PCH_IBX, /* Ibexpeak PCH */
  504. PCH_CPT, /* Cougarpoint PCH */
  505. PCH_LPT, /* Lynxpoint PCH */
  506. PCH_NOP,
  507. };
  508. enum intel_sbi_destination {
  509. SBI_ICLK,
  510. SBI_MPHY,
  511. };
  512. #define QUIRK_PIPEA_FORCE (1<<0)
  513. #define QUIRK_LVDS_SSC_DISABLE (1<<1)
  514. #define QUIRK_INVERT_BRIGHTNESS (1<<2)
  515. struct intel_fbdev;
  516. struct intel_fbc_work;
  517. struct intel_gmbus {
  518. struct i2c_adapter adapter;
  519. u32 force_bit;
  520. u32 reg0;
  521. u32 gpio_reg;
  522. struct i2c_algo_bit_data bit_algo;
  523. struct drm_i915_private *dev_priv;
  524. };
  525. struct i915_suspend_saved_registers {
  526. u8 saveLBB;
  527. u32 saveDSPACNTR;
  528. u32 saveDSPBCNTR;
  529. u32 saveDSPARB;
  530. u32 savePIPEACONF;
  531. u32 savePIPEBCONF;
  532. u32 savePIPEASRC;
  533. u32 savePIPEBSRC;
  534. u32 saveFPA0;
  535. u32 saveFPA1;
  536. u32 saveDPLL_A;
  537. u32 saveDPLL_A_MD;
  538. u32 saveHTOTAL_A;
  539. u32 saveHBLANK_A;
  540. u32 saveHSYNC_A;
  541. u32 saveVTOTAL_A;
  542. u32 saveVBLANK_A;
  543. u32 saveVSYNC_A;
  544. u32 saveBCLRPAT_A;
  545. u32 saveTRANSACONF;
  546. u32 saveTRANS_HTOTAL_A;
  547. u32 saveTRANS_HBLANK_A;
  548. u32 saveTRANS_HSYNC_A;
  549. u32 saveTRANS_VTOTAL_A;
  550. u32 saveTRANS_VBLANK_A;
  551. u32 saveTRANS_VSYNC_A;
  552. u32 savePIPEASTAT;
  553. u32 saveDSPASTRIDE;
  554. u32 saveDSPASIZE;
  555. u32 saveDSPAPOS;
  556. u32 saveDSPAADDR;
  557. u32 saveDSPASURF;
  558. u32 saveDSPATILEOFF;
  559. u32 savePFIT_PGM_RATIOS;
  560. u32 saveBLC_HIST_CTL;
  561. u32 saveBLC_PWM_CTL;
  562. u32 saveBLC_PWM_CTL2;
  563. u32 saveBLC_CPU_PWM_CTL;
  564. u32 saveBLC_CPU_PWM_CTL2;
  565. u32 saveFPB0;
  566. u32 saveFPB1;
  567. u32 saveDPLL_B;
  568. u32 saveDPLL_B_MD;
  569. u32 saveHTOTAL_B;
  570. u32 saveHBLANK_B;
  571. u32 saveHSYNC_B;
  572. u32 saveVTOTAL_B;
  573. u32 saveVBLANK_B;
  574. u32 saveVSYNC_B;
  575. u32 saveBCLRPAT_B;
  576. u32 saveTRANSBCONF;
  577. u32 saveTRANS_HTOTAL_B;
  578. u32 saveTRANS_HBLANK_B;
  579. u32 saveTRANS_HSYNC_B;
  580. u32 saveTRANS_VTOTAL_B;
  581. u32 saveTRANS_VBLANK_B;
  582. u32 saveTRANS_VSYNC_B;
  583. u32 savePIPEBSTAT;
  584. u32 saveDSPBSTRIDE;
  585. u32 saveDSPBSIZE;
  586. u32 saveDSPBPOS;
  587. u32 saveDSPBADDR;
  588. u32 saveDSPBSURF;
  589. u32 saveDSPBTILEOFF;
  590. u32 saveVGA0;
  591. u32 saveVGA1;
  592. u32 saveVGA_PD;
  593. u32 saveVGACNTRL;
  594. u32 saveADPA;
  595. u32 saveLVDS;
  596. u32 savePP_ON_DELAYS;
  597. u32 savePP_OFF_DELAYS;
  598. u32 saveDVOA;
  599. u32 saveDVOB;
  600. u32 saveDVOC;
  601. u32 savePP_ON;
  602. u32 savePP_OFF;
  603. u32 savePP_CONTROL;
  604. u32 savePP_DIVISOR;
  605. u32 savePFIT_CONTROL;
  606. u32 save_palette_a[256];
  607. u32 save_palette_b[256];
  608. u32 saveDPFC_CB_BASE;
  609. u32 saveFBC_CFB_BASE;
  610. u32 saveFBC_LL_BASE;
  611. u32 saveFBC_CONTROL;
  612. u32 saveFBC_CONTROL2;
  613. u32 saveIER;
  614. u32 saveIIR;
  615. u32 saveIMR;
  616. u32 saveDEIER;
  617. u32 saveDEIMR;
  618. u32 saveGTIER;
  619. u32 saveGTIMR;
  620. u32 saveFDI_RXA_IMR;
  621. u32 saveFDI_RXB_IMR;
  622. u32 saveCACHE_MODE_0;
  623. u32 saveMI_ARB_STATE;
  624. u32 saveSWF0[16];
  625. u32 saveSWF1[16];
  626. u32 saveSWF2[3];
  627. u8 saveMSR;
  628. u8 saveSR[8];
  629. u8 saveGR[25];
  630. u8 saveAR_INDEX;
  631. u8 saveAR[21];
  632. u8 saveDACMASK;
  633. u8 saveCR[37];
  634. uint64_t saveFENCE[I915_MAX_NUM_FENCES];
  635. u32 saveCURACNTR;
  636. u32 saveCURAPOS;
  637. u32 saveCURABASE;
  638. u32 saveCURBCNTR;
  639. u32 saveCURBPOS;
  640. u32 saveCURBBASE;
  641. u32 saveCURSIZE;
  642. u32 saveDP_B;
  643. u32 saveDP_C;
  644. u32 saveDP_D;
  645. u32 savePIPEA_GMCH_DATA_M;
  646. u32 savePIPEB_GMCH_DATA_M;
  647. u32 savePIPEA_GMCH_DATA_N;
  648. u32 savePIPEB_GMCH_DATA_N;
  649. u32 savePIPEA_DP_LINK_M;
  650. u32 savePIPEB_DP_LINK_M;
  651. u32 savePIPEA_DP_LINK_N;
  652. u32 savePIPEB_DP_LINK_N;
  653. u32 saveFDI_RXA_CTL;
  654. u32 saveFDI_TXA_CTL;
  655. u32 saveFDI_RXB_CTL;
  656. u32 saveFDI_TXB_CTL;
  657. u32 savePFA_CTL_1;
  658. u32 savePFB_CTL_1;
  659. u32 savePFA_WIN_SZ;
  660. u32 savePFB_WIN_SZ;
  661. u32 savePFA_WIN_POS;
  662. u32 savePFB_WIN_POS;
  663. u32 savePCH_DREF_CONTROL;
  664. u32 saveDISP_ARB_CTL;
  665. u32 savePIPEA_DATA_M1;
  666. u32 savePIPEA_DATA_N1;
  667. u32 savePIPEA_LINK_M1;
  668. u32 savePIPEA_LINK_N1;
  669. u32 savePIPEB_DATA_M1;
  670. u32 savePIPEB_DATA_N1;
  671. u32 savePIPEB_LINK_M1;
  672. u32 savePIPEB_LINK_N1;
  673. u32 saveMCHBAR_RENDER_STANDBY;
  674. u32 savePCH_PORT_HOTPLUG;
  675. };
  676. struct intel_gen6_power_mgmt {
  677. struct work_struct work;
  678. struct delayed_work vlv_work;
  679. u32 pm_iir;
  680. /* lock - irqsave spinlock that protectects the work_struct and
  681. * pm_iir. */
  682. spinlock_t lock;
  683. /* The below variables an all the rps hw state are protected by
  684. * dev->struct mutext. */
  685. u8 cur_delay;
  686. u8 min_delay;
  687. u8 max_delay;
  688. u8 rpe_delay;
  689. u8 hw_max;
  690. struct delayed_work delayed_resume_work;
  691. /*
  692. * Protects RPS/RC6 register access and PCU communication.
  693. * Must be taken after struct_mutex if nested.
  694. */
  695. struct mutex hw_lock;
  696. };
  697. /* defined intel_pm.c */
  698. extern spinlock_t mchdev_lock;
  699. struct intel_ilk_power_mgmt {
  700. u8 cur_delay;
  701. u8 min_delay;
  702. u8 max_delay;
  703. u8 fmax;
  704. u8 fstart;
  705. u64 last_count1;
  706. unsigned long last_time1;
  707. unsigned long chipset_power;
  708. u64 last_count2;
  709. struct timespec last_time2;
  710. unsigned long gfx_power;
  711. u8 corr;
  712. int c_m;
  713. int r_t;
  714. struct drm_i915_gem_object *pwrctx;
  715. struct drm_i915_gem_object *renderctx;
  716. };
  717. /* Power well structure for haswell */
  718. struct i915_power_well {
  719. struct drm_device *device;
  720. spinlock_t lock;
  721. /* power well enable/disable usage count */
  722. int count;
  723. int i915_request;
  724. };
  725. struct i915_dri1_state {
  726. unsigned allow_batchbuffer : 1;
  727. u32 __iomem *gfx_hws_cpu_addr;
  728. unsigned int cpp;
  729. int back_offset;
  730. int front_offset;
  731. int current_page;
  732. int page_flipping;
  733. uint32_t counter;
  734. };
  735. struct intel_l3_parity {
  736. u32 *remap_info;
  737. struct work_struct error_work;
  738. };
  739. struct i915_gem_mm {
  740. /** Memory allocator for GTT stolen memory */
  741. struct drm_mm stolen;
  742. /** Memory allocator for GTT */
  743. struct drm_mm gtt_space;
  744. /** List of all objects in gtt_space. Used to restore gtt
  745. * mappings on resume */
  746. struct list_head bound_list;
  747. /**
  748. * List of objects which are not bound to the GTT (thus
  749. * are idle and not used by the GPU) but still have
  750. * (presumably uncached) pages still attached.
  751. */
  752. struct list_head unbound_list;
  753. /** Usable portion of the GTT for GEM */
  754. unsigned long stolen_base; /* limited to low memory (32-bit) */
  755. /** PPGTT used for aliasing the PPGTT with the GTT */
  756. struct i915_hw_ppgtt *aliasing_ppgtt;
  757. struct shrinker inactive_shrinker;
  758. bool shrinker_no_lock_stealing;
  759. /**
  760. * List of objects currently involved in rendering.
  761. *
  762. * Includes buffers having the contents of their GPU caches
  763. * flushed, not necessarily primitives. last_rendering_seqno
  764. * represents when the rendering involved will be completed.
  765. *
  766. * A reference is held on the buffer while on this list.
  767. */
  768. struct list_head active_list;
  769. /**
  770. * LRU list of objects which are not in the ringbuffer and
  771. * are ready to unbind, but are still in the GTT.
  772. *
  773. * last_rendering_seqno is 0 while an object is in this list.
  774. *
  775. * A reference is not held on the buffer while on this list,
  776. * as merely being GTT-bound shouldn't prevent its being
  777. * freed, and we'll pull it off the list in the free path.
  778. */
  779. struct list_head inactive_list;
  780. /** LRU list of objects with fence regs on them. */
  781. struct list_head fence_list;
  782. /**
  783. * We leave the user IRQ off as much as possible,
  784. * but this means that requests will finish and never
  785. * be retired once the system goes idle. Set a timer to
  786. * fire periodically while the ring is running. When it
  787. * fires, go retire requests.
  788. */
  789. struct delayed_work retire_work;
  790. /**
  791. * Are we in a non-interruptible section of code like
  792. * modesetting?
  793. */
  794. bool interruptible;
  795. /**
  796. * Flag if the X Server, and thus DRM, is not currently in
  797. * control of the device.
  798. *
  799. * This is set between LeaveVT and EnterVT. It needs to be
  800. * replaced with a semaphore. It also needs to be
  801. * transitioned away from for kernel modesetting.
  802. */
  803. int suspended;
  804. /** Bit 6 swizzling required for X tiling */
  805. uint32_t bit_6_swizzle_x;
  806. /** Bit 6 swizzling required for Y tiling */
  807. uint32_t bit_6_swizzle_y;
  808. /* storage for physical objects */
  809. struct drm_i915_gem_phys_object *phys_objs[I915_MAX_PHYS_OBJECT];
  810. /* accounting, useful for userland debugging */
  811. size_t object_memory;
  812. u32 object_count;
  813. };
  814. struct drm_i915_error_state_buf {
  815. unsigned bytes;
  816. unsigned size;
  817. int err;
  818. u8 *buf;
  819. loff_t start;
  820. loff_t pos;
  821. };
  822. struct i915_gpu_error {
  823. /* For hangcheck timer */
  824. #define DRM_I915_HANGCHECK_PERIOD 1500 /* in ms */
  825. #define DRM_I915_HANGCHECK_JIFFIES msecs_to_jiffies(DRM_I915_HANGCHECK_PERIOD)
  826. struct timer_list hangcheck_timer;
  827. /* For reset and error_state handling. */
  828. spinlock_t lock;
  829. /* Protected by the above dev->gpu_error.lock. */
  830. struct drm_i915_error_state *first_error;
  831. struct work_struct work;
  832. unsigned long last_reset;
  833. /**
  834. * State variable and reset counter controlling the reset flow
  835. *
  836. * Upper bits are for the reset counter. This counter is used by the
  837. * wait_seqno code to race-free noticed that a reset event happened and
  838. * that it needs to restart the entire ioctl (since most likely the
  839. * seqno it waited for won't ever signal anytime soon).
  840. *
  841. * This is important for lock-free wait paths, where no contended lock
  842. * naturally enforces the correct ordering between the bail-out of the
  843. * waiter and the gpu reset work code.
  844. *
  845. * Lowest bit controls the reset state machine: Set means a reset is in
  846. * progress. This state will (presuming we don't have any bugs) decay
  847. * into either unset (successful reset) or the special WEDGED value (hw
  848. * terminally sour). All waiters on the reset_queue will be woken when
  849. * that happens.
  850. */
  851. atomic_t reset_counter;
  852. /**
  853. * Special values/flags for reset_counter
  854. *
  855. * Note that the code relies on
  856. * I915_WEDGED & I915_RESET_IN_PROGRESS_FLAG
  857. * being true.
  858. */
  859. #define I915_RESET_IN_PROGRESS_FLAG 1
  860. #define I915_WEDGED 0xffffffff
  861. /**
  862. * Waitqueue to signal when the reset has completed. Used by clients
  863. * that wait for dev_priv->mm.wedged to settle.
  864. */
  865. wait_queue_head_t reset_queue;
  866. /* For gpu hang simulation. */
  867. unsigned int stop_rings;
  868. };
  869. enum modeset_restore {
  870. MODESET_ON_LID_OPEN,
  871. MODESET_DONE,
  872. MODESET_SUSPENDED,
  873. };
  874. struct intel_vbt_data {
  875. struct drm_display_mode *lfp_lvds_vbt_mode; /* if any */
  876. struct drm_display_mode *sdvo_lvds_vbt_mode; /* if any */
  877. /* Feature bits */
  878. unsigned int int_tv_support:1;
  879. unsigned int lvds_dither:1;
  880. unsigned int lvds_vbt:1;
  881. unsigned int int_crt_support:1;
  882. unsigned int lvds_use_ssc:1;
  883. unsigned int display_clock_mode:1;
  884. unsigned int fdi_rx_polarity_inverted:1;
  885. int lvds_ssc_freq;
  886. unsigned int bios_lvds_val; /* initial [PCH_]LVDS reg val in VBIOS */
  887. /* eDP */
  888. int edp_rate;
  889. int edp_lanes;
  890. int edp_preemphasis;
  891. int edp_vswing;
  892. bool edp_initialized;
  893. bool edp_support;
  894. int edp_bpp;
  895. struct edp_power_seq edp_pps;
  896. int crt_ddc_pin;
  897. int child_dev_num;
  898. struct child_device_config *child_dev;
  899. };
  900. typedef struct drm_i915_private {
  901. struct drm_device *dev;
  902. struct kmem_cache *slab;
  903. const struct intel_device_info *info;
  904. int relative_constants_mode;
  905. void __iomem *regs;
  906. struct drm_i915_gt_funcs gt;
  907. /** gt_fifo_count and the subsequent register write are synchronized
  908. * with dev->struct_mutex. */
  909. unsigned gt_fifo_count;
  910. /** forcewake_count is protected by gt_lock */
  911. unsigned forcewake_count;
  912. /** gt_lock is also taken in irq contexts. */
  913. spinlock_t gt_lock;
  914. struct intel_gmbus gmbus[GMBUS_NUM_PORTS];
  915. /** gmbus_mutex protects against concurrent usage of the single hw gmbus
  916. * controller on different i2c buses. */
  917. struct mutex gmbus_mutex;
  918. /**
  919. * Base address of the gmbus and gpio block.
  920. */
  921. uint32_t gpio_mmio_base;
  922. wait_queue_head_t gmbus_wait_queue;
  923. struct pci_dev *bridge_dev;
  924. struct intel_ring_buffer ring[I915_NUM_RINGS];
  925. uint32_t last_seqno, next_seqno;
  926. drm_dma_handle_t *status_page_dmah;
  927. struct resource mch_res;
  928. atomic_t irq_received;
  929. /* protects the irq masks */
  930. spinlock_t irq_lock;
  931. /* To control wakeup latency, e.g. for irq-driven dp aux transfers. */
  932. struct pm_qos_request pm_qos;
  933. /* DPIO indirect register protection */
  934. struct mutex dpio_lock;
  935. /** Cached value of IMR to avoid reads in updating the bitfield */
  936. u32 irq_mask;
  937. u32 gt_irq_mask;
  938. struct work_struct hotplug_work;
  939. bool enable_hotplug_processing;
  940. struct {
  941. unsigned long hpd_last_jiffies;
  942. int hpd_cnt;
  943. enum {
  944. HPD_ENABLED = 0,
  945. HPD_DISABLED = 1,
  946. HPD_MARK_DISABLED = 2
  947. } hpd_mark;
  948. } hpd_stats[HPD_NUM_PINS];
  949. u32 hpd_event_bits;
  950. struct timer_list hotplug_reenable_timer;
  951. int num_plane;
  952. struct i915_fbc fbc;
  953. struct intel_opregion opregion;
  954. struct intel_vbt_data vbt;
  955. /* overlay */
  956. struct intel_overlay *overlay;
  957. unsigned int sprite_scaling_enabled;
  958. /* backlight */
  959. struct {
  960. int level;
  961. bool enabled;
  962. spinlock_t lock; /* bl registers and the above bl fields */
  963. struct backlight_device *device;
  964. } backlight;
  965. /* LVDS info */
  966. struct drm_display_mode *lfp_lvds_vbt_mode; /* if any */
  967. struct drm_display_mode *sdvo_lvds_vbt_mode; /* if any */
  968. bool no_aux_handshake;
  969. struct drm_i915_fence_reg fence_regs[I915_MAX_NUM_FENCES]; /* assume 965 */
  970. int fence_reg_start; /* 4 if userland hasn't ioctl'd us yet */
  971. int num_fence_regs; /* 8 on pre-965, 16 otherwise */
  972. unsigned int fsb_freq, mem_freq, is_ddr3;
  973. struct workqueue_struct *wq;
  974. /* Display functions */
  975. struct drm_i915_display_funcs display;
  976. /* PCH chipset type */
  977. enum intel_pch pch_type;
  978. unsigned short pch_id;
  979. unsigned long quirks;
  980. enum modeset_restore modeset_restore;
  981. struct mutex modeset_restore_lock;
  982. struct i915_gtt gtt;
  983. struct i915_gem_mm mm;
  984. /* Kernel Modesetting */
  985. struct sdvo_device_mapping sdvo_mappings[2];
  986. struct drm_crtc *plane_to_crtc_mapping[3];
  987. struct drm_crtc *pipe_to_crtc_mapping[3];
  988. wait_queue_head_t pending_flip_queue;
  989. int num_shared_dpll;
  990. struct intel_shared_dpll shared_dplls[I915_NUM_PLLS];
  991. struct intel_ddi_plls ddi_plls;
  992. /* Reclocking support */
  993. bool render_reclock_avail;
  994. bool lvds_downclock_avail;
  995. /* indicates the reduced downclock for LVDS*/
  996. int lvds_downclock;
  997. u16 orig_clock;
  998. bool mchbar_need_disable;
  999. struct intel_l3_parity l3_parity;
  1000. /* gen6+ rps state */
  1001. struct intel_gen6_power_mgmt rps;
  1002. /* ilk-only ips/rps state. Everything in here is protected by the global
  1003. * mchdev_lock in intel_pm.c */
  1004. struct intel_ilk_power_mgmt ips;
  1005. /* Haswell power well */
  1006. struct i915_power_well power_well;
  1007. struct i915_gpu_error gpu_error;
  1008. struct drm_i915_gem_object *vlv_pctx;
  1009. /* list of fbdev register on this device */
  1010. struct intel_fbdev *fbdev;
  1011. /*
  1012. * The console may be contended at resume, but we don't
  1013. * want it to block on it.
  1014. */
  1015. struct work_struct console_resume_work;
  1016. struct drm_property *broadcast_rgb_property;
  1017. struct drm_property *force_audio_property;
  1018. bool hw_contexts_disabled;
  1019. uint32_t hw_context_size;
  1020. u32 fdi_rx_config;
  1021. struct i915_suspend_saved_registers regfile;
  1022. /* Old dri1 support infrastructure, beware the dragons ya fools entering
  1023. * here! */
  1024. struct i915_dri1_state dri1;
  1025. } drm_i915_private_t;
  1026. /* Iterate over initialised rings */
  1027. #define for_each_ring(ring__, dev_priv__, i__) \
  1028. for ((i__) = 0; (i__) < I915_NUM_RINGS; (i__)++) \
  1029. if (((ring__) = &(dev_priv__)->ring[(i__)]), intel_ring_initialized((ring__)))
  1030. enum hdmi_force_audio {
  1031. HDMI_AUDIO_OFF_DVI = -2, /* no aux data for HDMI-DVI converter */
  1032. HDMI_AUDIO_OFF, /* force turn off HDMI audio */
  1033. HDMI_AUDIO_AUTO, /* trust EDID */
  1034. HDMI_AUDIO_ON, /* force turn on HDMI audio */
  1035. };
  1036. #define I915_GTT_RESERVED ((struct drm_mm_node *)0x1)
  1037. struct drm_i915_gem_object_ops {
  1038. /* Interface between the GEM object and its backing storage.
  1039. * get_pages() is called once prior to the use of the associated set
  1040. * of pages before to binding them into the GTT, and put_pages() is
  1041. * called after we no longer need them. As we expect there to be
  1042. * associated cost with migrating pages between the backing storage
  1043. * and making them available for the GPU (e.g. clflush), we may hold
  1044. * onto the pages after they are no longer referenced by the GPU
  1045. * in case they may be used again shortly (for example migrating the
  1046. * pages to a different memory domain within the GTT). put_pages()
  1047. * will therefore most likely be called when the object itself is
  1048. * being released or under memory pressure (where we attempt to
  1049. * reap pages for the shrinker).
  1050. */
  1051. int (*get_pages)(struct drm_i915_gem_object *);
  1052. void (*put_pages)(struct drm_i915_gem_object *);
  1053. };
  1054. struct drm_i915_gem_object {
  1055. struct drm_gem_object base;
  1056. const struct drm_i915_gem_object_ops *ops;
  1057. /** Current space allocated to this object in the GTT, if any. */
  1058. struct drm_mm_node *gtt_space;
  1059. /** Stolen memory for this object, instead of being backed by shmem. */
  1060. struct drm_mm_node *stolen;
  1061. struct list_head global_list;
  1062. /** This object's place on the active/inactive lists */
  1063. struct list_head ring_list;
  1064. struct list_head mm_list;
  1065. /** This object's place in the batchbuffer or on the eviction list */
  1066. struct list_head exec_list;
  1067. /**
  1068. * This is set if the object is on the active lists (has pending
  1069. * rendering and so a non-zero seqno), and is not set if it i s on
  1070. * inactive (ready to be unbound) list.
  1071. */
  1072. unsigned int active:1;
  1073. /**
  1074. * This is set if the object has been written to since last bound
  1075. * to the GTT
  1076. */
  1077. unsigned int dirty:1;
  1078. /**
  1079. * Fence register bits (if any) for this object. Will be set
  1080. * as needed when mapped into the GTT.
  1081. * Protected by dev->struct_mutex.
  1082. */
  1083. signed int fence_reg:I915_MAX_NUM_FENCE_BITS;
  1084. /**
  1085. * Advice: are the backing pages purgeable?
  1086. */
  1087. unsigned int madv:2;
  1088. /**
  1089. * Current tiling mode for the object.
  1090. */
  1091. unsigned int tiling_mode:2;
  1092. /**
  1093. * Whether the tiling parameters for the currently associated fence
  1094. * register have changed. Note that for the purposes of tracking
  1095. * tiling changes we also treat the unfenced register, the register
  1096. * slot that the object occupies whilst it executes a fenced
  1097. * command (such as BLT on gen2/3), as a "fence".
  1098. */
  1099. unsigned int fence_dirty:1;
  1100. /** How many users have pinned this object in GTT space. The following
  1101. * users can each hold at most one reference: pwrite/pread, pin_ioctl
  1102. * (via user_pin_count), execbuffer (objects are not allowed multiple
  1103. * times for the same batchbuffer), and the framebuffer code. When
  1104. * switching/pageflipping, the framebuffer code has at most two buffers
  1105. * pinned per crtc.
  1106. *
  1107. * In the worst case this is 1 + 1 + 1 + 2*2 = 7. That would fit into 3
  1108. * bits with absolutely no headroom. So use 4 bits. */
  1109. unsigned int pin_count:4;
  1110. #define DRM_I915_GEM_OBJECT_MAX_PIN_COUNT 0xf
  1111. /**
  1112. * Is the object at the current location in the gtt mappable and
  1113. * fenceable? Used to avoid costly recalculations.
  1114. */
  1115. unsigned int map_and_fenceable:1;
  1116. /**
  1117. * Whether the current gtt mapping needs to be mappable (and isn't just
  1118. * mappable by accident). Track pin and fault separate for a more
  1119. * accurate mappable working set.
  1120. */
  1121. unsigned int fault_mappable:1;
  1122. unsigned int pin_mappable:1;
  1123. /*
  1124. * Is the GPU currently using a fence to access this buffer,
  1125. */
  1126. unsigned int pending_fenced_gpu_access:1;
  1127. unsigned int fenced_gpu_access:1;
  1128. unsigned int cache_level:2;
  1129. unsigned int has_aliasing_ppgtt_mapping:1;
  1130. unsigned int has_global_gtt_mapping:1;
  1131. unsigned int has_dma_mapping:1;
  1132. struct sg_table *pages;
  1133. int pages_pin_count;
  1134. /* prime dma-buf support */
  1135. void *dma_buf_vmapping;
  1136. int vmapping_count;
  1137. /**
  1138. * Used for performing relocations during execbuffer insertion.
  1139. */
  1140. struct hlist_node exec_node;
  1141. unsigned long exec_handle;
  1142. struct drm_i915_gem_exec_object2 *exec_entry;
  1143. /**
  1144. * Current offset of the object in GTT space.
  1145. *
  1146. * This is the same as gtt_space->start
  1147. */
  1148. uint32_t gtt_offset;
  1149. struct intel_ring_buffer *ring;
  1150. /** Breadcrumb of last rendering to the buffer. */
  1151. uint32_t last_read_seqno;
  1152. uint32_t last_write_seqno;
  1153. /** Breadcrumb of last fenced GPU access to the buffer. */
  1154. uint32_t last_fenced_seqno;
  1155. /** Current tiling stride for the object, if it's tiled. */
  1156. uint32_t stride;
  1157. /** Record of address bit 17 of each page at last unbind. */
  1158. unsigned long *bit_17;
  1159. /** User space pin count and filp owning the pin */
  1160. uint32_t user_pin_count;
  1161. struct drm_file *pin_filp;
  1162. /** for phy allocated objects */
  1163. struct drm_i915_gem_phys_object *phys_obj;
  1164. };
  1165. #define to_gem_object(obj) (&((struct drm_i915_gem_object *)(obj))->base)
  1166. #define to_intel_bo(x) container_of(x, struct drm_i915_gem_object, base)
  1167. /**
  1168. * Request queue structure.
  1169. *
  1170. * The request queue allows us to note sequence numbers that have been emitted
  1171. * and may be associated with active buffers to be retired.
  1172. *
  1173. * By keeping this list, we can avoid having to do questionable
  1174. * sequence-number comparisons on buffer last_rendering_seqnos, and associate
  1175. * an emission time with seqnos for tracking how far ahead of the GPU we are.
  1176. */
  1177. struct drm_i915_gem_request {
  1178. /** On Which ring this request was generated */
  1179. struct intel_ring_buffer *ring;
  1180. /** GEM sequence number associated with this request. */
  1181. uint32_t seqno;
  1182. /** Position in the ringbuffer of the start of the request */
  1183. u32 head;
  1184. /** Position in the ringbuffer of the end of the request */
  1185. u32 tail;
  1186. /** Context related to this request */
  1187. struct i915_hw_context *ctx;
  1188. /** Batch buffer related to this request if any */
  1189. struct drm_i915_gem_object *batch_obj;
  1190. /** Time at which this request was emitted, in jiffies. */
  1191. unsigned long emitted_jiffies;
  1192. /** global list entry for this request */
  1193. struct list_head list;
  1194. struct drm_i915_file_private *file_priv;
  1195. /** file_priv list entry for this request */
  1196. struct list_head client_list;
  1197. };
  1198. struct drm_i915_file_private {
  1199. struct {
  1200. spinlock_t lock;
  1201. struct list_head request_list;
  1202. } mm;
  1203. struct idr context_idr;
  1204. struct i915_ctx_hang_stats hang_stats;
  1205. };
  1206. #define INTEL_INFO(dev) (((struct drm_i915_private *) (dev)->dev_private)->info)
  1207. #define IS_I830(dev) ((dev)->pci_device == 0x3577)
  1208. #define IS_845G(dev) ((dev)->pci_device == 0x2562)
  1209. #define IS_I85X(dev) (INTEL_INFO(dev)->is_i85x)
  1210. #define IS_I865G(dev) ((dev)->pci_device == 0x2572)
  1211. #define IS_I915G(dev) (INTEL_INFO(dev)->is_i915g)
  1212. #define IS_I915GM(dev) ((dev)->pci_device == 0x2592)
  1213. #define IS_I945G(dev) ((dev)->pci_device == 0x2772)
  1214. #define IS_I945GM(dev) (INTEL_INFO(dev)->is_i945gm)
  1215. #define IS_BROADWATER(dev) (INTEL_INFO(dev)->is_broadwater)
  1216. #define IS_CRESTLINE(dev) (INTEL_INFO(dev)->is_crestline)
  1217. #define IS_GM45(dev) ((dev)->pci_device == 0x2A42)
  1218. #define IS_G4X(dev) (INTEL_INFO(dev)->is_g4x)
  1219. #define IS_PINEVIEW_G(dev) ((dev)->pci_device == 0xa001)
  1220. #define IS_PINEVIEW_M(dev) ((dev)->pci_device == 0xa011)
  1221. #define IS_PINEVIEW(dev) (INTEL_INFO(dev)->is_pineview)
  1222. #define IS_G33(dev) (INTEL_INFO(dev)->is_g33)
  1223. #define IS_IRONLAKE_D(dev) ((dev)->pci_device == 0x0042)
  1224. #define IS_IRONLAKE_M(dev) ((dev)->pci_device == 0x0046)
  1225. #define IS_IVYBRIDGE(dev) (INTEL_INFO(dev)->is_ivybridge)
  1226. #define IS_IVB_GT1(dev) ((dev)->pci_device == 0x0156 || \
  1227. (dev)->pci_device == 0x0152 || \
  1228. (dev)->pci_device == 0x015a)
  1229. #define IS_SNB_GT1(dev) ((dev)->pci_device == 0x0102 || \
  1230. (dev)->pci_device == 0x0106 || \
  1231. (dev)->pci_device == 0x010A)
  1232. #define IS_VALLEYVIEW(dev) (INTEL_INFO(dev)->is_valleyview)
  1233. #define IS_HASWELL(dev) (INTEL_INFO(dev)->is_haswell)
  1234. #define IS_MOBILE(dev) (INTEL_INFO(dev)->is_mobile)
  1235. #define IS_ULT(dev) (IS_HASWELL(dev) && \
  1236. ((dev)->pci_device & 0xFF00) == 0x0A00)
  1237. /*
  1238. * The genX designation typically refers to the render engine, so render
  1239. * capability related checks should use IS_GEN, while display and other checks
  1240. * have their own (e.g. HAS_PCH_SPLIT for ILK+ display, IS_foo for particular
  1241. * chips, etc.).
  1242. */
  1243. #define IS_GEN2(dev) (INTEL_INFO(dev)->gen == 2)
  1244. #define IS_GEN3(dev) (INTEL_INFO(dev)->gen == 3)
  1245. #define IS_GEN4(dev) (INTEL_INFO(dev)->gen == 4)
  1246. #define IS_GEN5(dev) (INTEL_INFO(dev)->gen == 5)
  1247. #define IS_GEN6(dev) (INTEL_INFO(dev)->gen == 6)
  1248. #define IS_GEN7(dev) (INTEL_INFO(dev)->gen == 7)
  1249. #define HAS_BSD(dev) (INTEL_INFO(dev)->has_bsd_ring)
  1250. #define HAS_BLT(dev) (INTEL_INFO(dev)->has_blt_ring)
  1251. #define HAS_VEBOX(dev) (INTEL_INFO(dev)->has_vebox_ring)
  1252. #define HAS_LLC(dev) (INTEL_INFO(dev)->has_llc)
  1253. #define I915_NEED_GFX_HWS(dev) (INTEL_INFO(dev)->need_gfx_hws)
  1254. #define HAS_HW_CONTEXTS(dev) (INTEL_INFO(dev)->gen >= 6)
  1255. #define HAS_ALIASING_PPGTT(dev) (INTEL_INFO(dev)->gen >=6 && !IS_VALLEYVIEW(dev))
  1256. #define HAS_OVERLAY(dev) (INTEL_INFO(dev)->has_overlay)
  1257. #define OVERLAY_NEEDS_PHYSICAL(dev) (INTEL_INFO(dev)->overlay_needs_physical)
  1258. /* Early gen2 have a totally busted CS tlb and require pinned batches. */
  1259. #define HAS_BROKEN_CS_TLB(dev) (IS_I830(dev) || IS_845G(dev))
  1260. /* With the 945 and later, Y tiling got adjusted so that it was 32 128-byte
  1261. * rows, which changed the alignment requirements and fence programming.
  1262. */
  1263. #define HAS_128_BYTE_Y_TILING(dev) (!IS_GEN2(dev) && !(IS_I915G(dev) || \
  1264. IS_I915GM(dev)))
  1265. #define SUPPORTS_DIGITAL_OUTPUTS(dev) (!IS_GEN2(dev) && !IS_PINEVIEW(dev))
  1266. #define SUPPORTS_INTEGRATED_HDMI(dev) (IS_G4X(dev) || IS_GEN5(dev))
  1267. #define SUPPORTS_INTEGRATED_DP(dev) (IS_G4X(dev) || IS_GEN5(dev))
  1268. #define SUPPORTS_EDP(dev) (IS_IRONLAKE_M(dev))
  1269. #define SUPPORTS_TV(dev) (INTEL_INFO(dev)->supports_tv)
  1270. #define I915_HAS_HOTPLUG(dev) (INTEL_INFO(dev)->has_hotplug)
  1271. /* dsparb controlled by hw only */
  1272. #define DSPARB_HWCONTROL(dev) (IS_G4X(dev) || IS_IRONLAKE(dev))
  1273. #define HAS_FW_BLC(dev) (INTEL_INFO(dev)->gen > 2)
  1274. #define HAS_PIPE_CXSR(dev) (INTEL_INFO(dev)->has_pipe_cxsr)
  1275. #define I915_HAS_FBC(dev) (INTEL_INFO(dev)->has_fbc)
  1276. #define HAS_IPS(dev) (IS_ULT(dev))
  1277. #define HAS_PIPE_CONTROL(dev) (INTEL_INFO(dev)->gen >= 5)
  1278. #define HAS_DDI(dev) (INTEL_INFO(dev)->has_ddi)
  1279. #define HAS_POWER_WELL(dev) (IS_HASWELL(dev))
  1280. #define HAS_FPGA_DBG_UNCLAIMED(dev) (INTEL_INFO(dev)->has_fpga_dbg)
  1281. #define INTEL_PCH_DEVICE_ID_MASK 0xff00
  1282. #define INTEL_PCH_IBX_DEVICE_ID_TYPE 0x3b00
  1283. #define INTEL_PCH_CPT_DEVICE_ID_TYPE 0x1c00
  1284. #define INTEL_PCH_PPT_DEVICE_ID_TYPE 0x1e00
  1285. #define INTEL_PCH_LPT_DEVICE_ID_TYPE 0x8c00
  1286. #define INTEL_PCH_LPT_LP_DEVICE_ID_TYPE 0x9c00
  1287. #define INTEL_PCH_TYPE(dev) (((struct drm_i915_private *)(dev)->dev_private)->pch_type)
  1288. #define HAS_PCH_LPT(dev) (INTEL_PCH_TYPE(dev) == PCH_LPT)
  1289. #define HAS_PCH_CPT(dev) (INTEL_PCH_TYPE(dev) == PCH_CPT)
  1290. #define HAS_PCH_IBX(dev) (INTEL_PCH_TYPE(dev) == PCH_IBX)
  1291. #define HAS_PCH_NOP(dev) (INTEL_PCH_TYPE(dev) == PCH_NOP)
  1292. #define HAS_PCH_SPLIT(dev) (INTEL_PCH_TYPE(dev) != PCH_NONE)
  1293. #define HAS_FORCE_WAKE(dev) (INTEL_INFO(dev)->has_force_wake)
  1294. #define HAS_L3_GPU_CACHE(dev) (IS_IVYBRIDGE(dev) || IS_HASWELL(dev))
  1295. #define GT_FREQUENCY_MULTIPLIER 50
  1296. #include "i915_trace.h"
  1297. /**
  1298. * RC6 is a special power stage which allows the GPU to enter an very
  1299. * low-voltage mode when idle, using down to 0V while at this stage. This
  1300. * stage is entered automatically when the GPU is idle when RC6 support is
  1301. * enabled, and as soon as new workload arises GPU wakes up automatically as well.
  1302. *
  1303. * There are different RC6 modes available in Intel GPU, which differentiate
  1304. * among each other with the latency required to enter and leave RC6 and
  1305. * voltage consumed by the GPU in different states.
  1306. *
  1307. * The combination of the following flags define which states GPU is allowed
  1308. * to enter, while RC6 is the normal RC6 state, RC6p is the deep RC6, and
  1309. * RC6pp is deepest RC6. Their support by hardware varies according to the
  1310. * GPU, BIOS, chipset and platform. RC6 is usually the safest one and the one
  1311. * which brings the most power savings; deeper states save more power, but
  1312. * require higher latency to switch to and wake up.
  1313. */
  1314. #define INTEL_RC6_ENABLE (1<<0)
  1315. #define INTEL_RC6p_ENABLE (1<<1)
  1316. #define INTEL_RC6pp_ENABLE (1<<2)
  1317. extern struct drm_ioctl_desc i915_ioctls[];
  1318. extern int i915_max_ioctl;
  1319. extern unsigned int i915_fbpercrtc __always_unused;
  1320. extern int i915_panel_ignore_lid __read_mostly;
  1321. extern unsigned int i915_powersave __read_mostly;
  1322. extern int i915_semaphores __read_mostly;
  1323. extern unsigned int i915_lvds_downclock __read_mostly;
  1324. extern int i915_lvds_channel_mode __read_mostly;
  1325. extern int i915_panel_use_ssc __read_mostly;
  1326. extern int i915_vbt_sdvo_panel_type __read_mostly;
  1327. extern int i915_enable_rc6 __read_mostly;
  1328. extern int i915_enable_fbc __read_mostly;
  1329. extern bool i915_enable_hangcheck __read_mostly;
  1330. extern int i915_enable_ppgtt __read_mostly;
  1331. extern unsigned int i915_preliminary_hw_support __read_mostly;
  1332. extern int i915_disable_power_well __read_mostly;
  1333. extern int i915_enable_ips __read_mostly;
  1334. extern int i915_suspend(struct drm_device *dev, pm_message_t state);
  1335. extern int i915_resume(struct drm_device *dev);
  1336. extern int i915_master_create(struct drm_device *dev, struct drm_master *master);
  1337. extern void i915_master_destroy(struct drm_device *dev, struct drm_master *master);
  1338. /* i915_dma.c */
  1339. void i915_update_dri1_breadcrumb(struct drm_device *dev);
  1340. extern void i915_kernel_lost_context(struct drm_device * dev);
  1341. extern int i915_driver_load(struct drm_device *, unsigned long flags);
  1342. extern int i915_driver_unload(struct drm_device *);
  1343. extern int i915_driver_open(struct drm_device *dev, struct drm_file *file_priv);
  1344. extern void i915_driver_lastclose(struct drm_device * dev);
  1345. extern void i915_driver_preclose(struct drm_device *dev,
  1346. struct drm_file *file_priv);
  1347. extern void i915_driver_postclose(struct drm_device *dev,
  1348. struct drm_file *file_priv);
  1349. extern int i915_driver_device_is_agp(struct drm_device * dev);
  1350. #ifdef CONFIG_COMPAT
  1351. extern long i915_compat_ioctl(struct file *filp, unsigned int cmd,
  1352. unsigned long arg);
  1353. #endif
  1354. extern int i915_emit_box(struct drm_device *dev,
  1355. struct drm_clip_rect *box,
  1356. int DR1, int DR4);
  1357. extern int intel_gpu_reset(struct drm_device *dev);
  1358. extern int i915_reset(struct drm_device *dev);
  1359. extern unsigned long i915_chipset_val(struct drm_i915_private *dev_priv);
  1360. extern unsigned long i915_mch_val(struct drm_i915_private *dev_priv);
  1361. extern unsigned long i915_gfx_val(struct drm_i915_private *dev_priv);
  1362. extern void i915_update_gfx_val(struct drm_i915_private *dev_priv);
  1363. extern void intel_console_resume(struct work_struct *work);
  1364. /* i915_irq.c */
  1365. void i915_hangcheck_elapsed(unsigned long data);
  1366. void i915_handle_error(struct drm_device *dev, bool wedged);
  1367. extern void intel_irq_init(struct drm_device *dev);
  1368. extern void intel_hpd_init(struct drm_device *dev);
  1369. extern void intel_gt_init(struct drm_device *dev);
  1370. extern void intel_gt_reset(struct drm_device *dev);
  1371. void i915_error_state_free(struct kref *error_ref);
  1372. void
  1373. i915_enable_pipestat(drm_i915_private_t *dev_priv, int pipe, u32 mask);
  1374. void
  1375. i915_disable_pipestat(drm_i915_private_t *dev_priv, int pipe, u32 mask);
  1376. #ifdef CONFIG_DEBUG_FS
  1377. extern void i915_destroy_error_state(struct drm_device *dev);
  1378. #else
  1379. #define i915_destroy_error_state(x)
  1380. #endif
  1381. /* i915_gem.c */
  1382. int i915_gem_init_ioctl(struct drm_device *dev, void *data,
  1383. struct drm_file *file_priv);
  1384. int i915_gem_create_ioctl(struct drm_device *dev, void *data,
  1385. struct drm_file *file_priv);
  1386. int i915_gem_pread_ioctl(struct drm_device *dev, void *data,
  1387. struct drm_file *file_priv);
  1388. int i915_gem_pwrite_ioctl(struct drm_device *dev, void *data,
  1389. struct drm_file *file_priv);
  1390. int i915_gem_mmap_ioctl(struct drm_device *dev, void *data,
  1391. struct drm_file *file_priv);
  1392. int i915_gem_mmap_gtt_ioctl(struct drm_device *dev, void *data,
  1393. struct drm_file *file_priv);
  1394. int i915_gem_set_domain_ioctl(struct drm_device *dev, void *data,
  1395. struct drm_file *file_priv);
  1396. int i915_gem_sw_finish_ioctl(struct drm_device *dev, void *data,
  1397. struct drm_file *file_priv);
  1398. int i915_gem_execbuffer(struct drm_device *dev, void *data,
  1399. struct drm_file *file_priv);
  1400. int i915_gem_execbuffer2(struct drm_device *dev, void *data,
  1401. struct drm_file *file_priv);
  1402. int i915_gem_pin_ioctl(struct drm_device *dev, void *data,
  1403. struct drm_file *file_priv);
  1404. int i915_gem_unpin_ioctl(struct drm_device *dev, void *data,
  1405. struct drm_file *file_priv);
  1406. int i915_gem_busy_ioctl(struct drm_device *dev, void *data,
  1407. struct drm_file *file_priv);
  1408. int i915_gem_get_caching_ioctl(struct drm_device *dev, void *data,
  1409. struct drm_file *file);
  1410. int i915_gem_set_caching_ioctl(struct drm_device *dev, void *data,
  1411. struct drm_file *file);
  1412. int i915_gem_throttle_ioctl(struct drm_device *dev, void *data,
  1413. struct drm_file *file_priv);
  1414. int i915_gem_madvise_ioctl(struct drm_device *dev, void *data,
  1415. struct drm_file *file_priv);
  1416. int i915_gem_entervt_ioctl(struct drm_device *dev, void *data,
  1417. struct drm_file *file_priv);
  1418. int i915_gem_leavevt_ioctl(struct drm_device *dev, void *data,
  1419. struct drm_file *file_priv);
  1420. int i915_gem_set_tiling(struct drm_device *dev, void *data,
  1421. struct drm_file *file_priv);
  1422. int i915_gem_get_tiling(struct drm_device *dev, void *data,
  1423. struct drm_file *file_priv);
  1424. int i915_gem_get_aperture_ioctl(struct drm_device *dev, void *data,
  1425. struct drm_file *file_priv);
  1426. int i915_gem_wait_ioctl(struct drm_device *dev, void *data,
  1427. struct drm_file *file_priv);
  1428. void i915_gem_load(struct drm_device *dev);
  1429. void *i915_gem_object_alloc(struct drm_device *dev);
  1430. void i915_gem_object_free(struct drm_i915_gem_object *obj);
  1431. int i915_gem_init_object(struct drm_gem_object *obj);
  1432. void i915_gem_object_init(struct drm_i915_gem_object *obj,
  1433. const struct drm_i915_gem_object_ops *ops);
  1434. struct drm_i915_gem_object *i915_gem_alloc_object(struct drm_device *dev,
  1435. size_t size);
  1436. void i915_gem_free_object(struct drm_gem_object *obj);
  1437. int __must_check i915_gem_object_pin(struct drm_i915_gem_object *obj,
  1438. uint32_t alignment,
  1439. bool map_and_fenceable,
  1440. bool nonblocking);
  1441. void i915_gem_object_unpin(struct drm_i915_gem_object *obj);
  1442. int __must_check i915_gem_object_unbind(struct drm_i915_gem_object *obj);
  1443. int i915_gem_object_put_pages(struct drm_i915_gem_object *obj);
  1444. void i915_gem_release_mmap(struct drm_i915_gem_object *obj);
  1445. void i915_gem_lastclose(struct drm_device *dev);
  1446. int __must_check i915_gem_object_get_pages(struct drm_i915_gem_object *obj);
  1447. static inline struct page *i915_gem_object_get_page(struct drm_i915_gem_object *obj, int n)
  1448. {
  1449. struct sg_page_iter sg_iter;
  1450. for_each_sg_page(obj->pages->sgl, &sg_iter, obj->pages->nents, n)
  1451. return sg_page_iter_page(&sg_iter);
  1452. return NULL;
  1453. }
  1454. static inline void i915_gem_object_pin_pages(struct drm_i915_gem_object *obj)
  1455. {
  1456. BUG_ON(obj->pages == NULL);
  1457. obj->pages_pin_count++;
  1458. }
  1459. static inline void i915_gem_object_unpin_pages(struct drm_i915_gem_object *obj)
  1460. {
  1461. BUG_ON(obj->pages_pin_count == 0);
  1462. obj->pages_pin_count--;
  1463. }
  1464. int __must_check i915_mutex_lock_interruptible(struct drm_device *dev);
  1465. int i915_gem_object_sync(struct drm_i915_gem_object *obj,
  1466. struct intel_ring_buffer *to);
  1467. void i915_gem_object_move_to_active(struct drm_i915_gem_object *obj,
  1468. struct intel_ring_buffer *ring);
  1469. int i915_gem_dumb_create(struct drm_file *file_priv,
  1470. struct drm_device *dev,
  1471. struct drm_mode_create_dumb *args);
  1472. int i915_gem_mmap_gtt(struct drm_file *file_priv, struct drm_device *dev,
  1473. uint32_t handle, uint64_t *offset);
  1474. int i915_gem_dumb_destroy(struct drm_file *file_priv, struct drm_device *dev,
  1475. uint32_t handle);
  1476. /**
  1477. * Returns true if seq1 is later than seq2.
  1478. */
  1479. static inline bool
  1480. i915_seqno_passed(uint32_t seq1, uint32_t seq2)
  1481. {
  1482. return (int32_t)(seq1 - seq2) >= 0;
  1483. }
  1484. int __must_check i915_gem_get_seqno(struct drm_device *dev, u32 *seqno);
  1485. int __must_check i915_gem_set_seqno(struct drm_device *dev, u32 seqno);
  1486. int __must_check i915_gem_object_get_fence(struct drm_i915_gem_object *obj);
  1487. int __must_check i915_gem_object_put_fence(struct drm_i915_gem_object *obj);
  1488. static inline bool
  1489. i915_gem_object_pin_fence(struct drm_i915_gem_object *obj)
  1490. {
  1491. if (obj->fence_reg != I915_FENCE_REG_NONE) {
  1492. struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
  1493. dev_priv->fence_regs[obj->fence_reg].pin_count++;
  1494. return true;
  1495. } else
  1496. return false;
  1497. }
  1498. static inline void
  1499. i915_gem_object_unpin_fence(struct drm_i915_gem_object *obj)
  1500. {
  1501. if (obj->fence_reg != I915_FENCE_REG_NONE) {
  1502. struct drm_i915_private *dev_priv = obj->base.dev->dev_private;
  1503. WARN_ON(dev_priv->fence_regs[obj->fence_reg].pin_count <= 0);
  1504. dev_priv->fence_regs[obj->fence_reg].pin_count--;
  1505. }
  1506. }
  1507. void i915_gem_retire_requests(struct drm_device *dev);
  1508. void i915_gem_retire_requests_ring(struct intel_ring_buffer *ring);
  1509. int __must_check i915_gem_check_wedge(struct i915_gpu_error *error,
  1510. bool interruptible);
  1511. static inline bool i915_reset_in_progress(struct i915_gpu_error *error)
  1512. {
  1513. return unlikely(atomic_read(&error->reset_counter)
  1514. & I915_RESET_IN_PROGRESS_FLAG);
  1515. }
  1516. static inline bool i915_terminally_wedged(struct i915_gpu_error *error)
  1517. {
  1518. return atomic_read(&error->reset_counter) == I915_WEDGED;
  1519. }
  1520. void i915_gem_reset(struct drm_device *dev);
  1521. void i915_gem_clflush_object(struct drm_i915_gem_object *obj);
  1522. int __must_check i915_gem_object_set_domain(struct drm_i915_gem_object *obj,
  1523. uint32_t read_domains,
  1524. uint32_t write_domain);
  1525. int __must_check i915_gem_object_finish_gpu(struct drm_i915_gem_object *obj);
  1526. int __must_check i915_gem_init(struct drm_device *dev);
  1527. int __must_check i915_gem_init_hw(struct drm_device *dev);
  1528. void i915_gem_l3_remap(struct drm_device *dev);
  1529. void i915_gem_init_swizzling(struct drm_device *dev);
  1530. void i915_gem_cleanup_ringbuffer(struct drm_device *dev);
  1531. int __must_check i915_gpu_idle(struct drm_device *dev);
  1532. int __must_check i915_gem_idle(struct drm_device *dev);
  1533. int __i915_add_request(struct intel_ring_buffer *ring,
  1534. struct drm_file *file,
  1535. struct drm_i915_gem_object *batch_obj,
  1536. u32 *seqno);
  1537. #define i915_add_request(ring, seqno) \
  1538. __i915_add_request(ring, NULL, NULL, seqno)
  1539. int __must_check i915_wait_seqno(struct intel_ring_buffer *ring,
  1540. uint32_t seqno);
  1541. int i915_gem_fault(struct vm_area_struct *vma, struct vm_fault *vmf);
  1542. int __must_check
  1543. i915_gem_object_set_to_gtt_domain(struct drm_i915_gem_object *obj,
  1544. bool write);
  1545. int __must_check
  1546. i915_gem_object_set_to_cpu_domain(struct drm_i915_gem_object *obj, bool write);
  1547. int __must_check
  1548. i915_gem_object_pin_to_display_plane(struct drm_i915_gem_object *obj,
  1549. u32 alignment,
  1550. struct intel_ring_buffer *pipelined);
  1551. int i915_gem_attach_phys_object(struct drm_device *dev,
  1552. struct drm_i915_gem_object *obj,
  1553. int id,
  1554. int align);
  1555. void i915_gem_detach_phys_object(struct drm_device *dev,
  1556. struct drm_i915_gem_object *obj);
  1557. void i915_gem_free_all_phys_object(struct drm_device *dev);
  1558. void i915_gem_release(struct drm_device *dev, struct drm_file *file);
  1559. uint32_t
  1560. i915_gem_get_gtt_size(struct drm_device *dev, uint32_t size, int tiling_mode);
  1561. uint32_t
  1562. i915_gem_get_gtt_alignment(struct drm_device *dev, uint32_t size,
  1563. int tiling_mode, bool fenced);
  1564. int i915_gem_object_set_cache_level(struct drm_i915_gem_object *obj,
  1565. enum i915_cache_level cache_level);
  1566. struct drm_gem_object *i915_gem_prime_import(struct drm_device *dev,
  1567. struct dma_buf *dma_buf);
  1568. struct dma_buf *i915_gem_prime_export(struct drm_device *dev,
  1569. struct drm_gem_object *gem_obj, int flags);
  1570. /* i915_gem_context.c */
  1571. void i915_gem_context_init(struct drm_device *dev);
  1572. void i915_gem_context_fini(struct drm_device *dev);
  1573. void i915_gem_context_close(struct drm_device *dev, struct drm_file *file);
  1574. int i915_switch_context(struct intel_ring_buffer *ring,
  1575. struct drm_file *file, int to_id);
  1576. void i915_gem_context_free(struct kref *ctx_ref);
  1577. static inline void i915_gem_context_reference(struct i915_hw_context *ctx)
  1578. {
  1579. kref_get(&ctx->ref);
  1580. }
  1581. static inline void i915_gem_context_unreference(struct i915_hw_context *ctx)
  1582. {
  1583. kref_put(&ctx->ref, i915_gem_context_free);
  1584. }
  1585. struct i915_ctx_hang_stats * __must_check
  1586. i915_gem_context_get_hang_stats(struct intel_ring_buffer *ring,
  1587. struct drm_file *file,
  1588. u32 id);
  1589. int i915_gem_context_create_ioctl(struct drm_device *dev, void *data,
  1590. struct drm_file *file);
  1591. int i915_gem_context_destroy_ioctl(struct drm_device *dev, void *data,
  1592. struct drm_file *file);
  1593. /* i915_gem_gtt.c */
  1594. void i915_gem_cleanup_aliasing_ppgtt(struct drm_device *dev);
  1595. void i915_ppgtt_bind_object(struct i915_hw_ppgtt *ppgtt,
  1596. struct drm_i915_gem_object *obj,
  1597. enum i915_cache_level cache_level);
  1598. void i915_ppgtt_unbind_object(struct i915_hw_ppgtt *ppgtt,
  1599. struct drm_i915_gem_object *obj);
  1600. void i915_gem_restore_gtt_mappings(struct drm_device *dev);
  1601. int __must_check i915_gem_gtt_prepare_object(struct drm_i915_gem_object *obj);
  1602. void i915_gem_gtt_bind_object(struct drm_i915_gem_object *obj,
  1603. enum i915_cache_level cache_level);
  1604. void i915_gem_gtt_unbind_object(struct drm_i915_gem_object *obj);
  1605. void i915_gem_gtt_finish_object(struct drm_i915_gem_object *obj);
  1606. void i915_gem_init_global_gtt(struct drm_device *dev);
  1607. void i915_gem_setup_global_gtt(struct drm_device *dev, unsigned long start,
  1608. unsigned long mappable_end, unsigned long end);
  1609. int i915_gem_gtt_init(struct drm_device *dev);
  1610. static inline void i915_gem_chipset_flush(struct drm_device *dev)
  1611. {
  1612. if (INTEL_INFO(dev)->gen < 6)
  1613. intel_gtt_chipset_flush();
  1614. }
  1615. /* i915_gem_evict.c */
  1616. int __must_check i915_gem_evict_something(struct drm_device *dev, int min_size,
  1617. unsigned alignment,
  1618. unsigned cache_level,
  1619. bool mappable,
  1620. bool nonblock);
  1621. int i915_gem_evict_everything(struct drm_device *dev);
  1622. /* i915_gem_stolen.c */
  1623. int i915_gem_init_stolen(struct drm_device *dev);
  1624. int i915_gem_stolen_setup_compression(struct drm_device *dev, int size);
  1625. void i915_gem_stolen_cleanup_compression(struct drm_device *dev);
  1626. void i915_gem_cleanup_stolen(struct drm_device *dev);
  1627. struct drm_i915_gem_object *
  1628. i915_gem_object_create_stolen(struct drm_device *dev, u32 size);
  1629. struct drm_i915_gem_object *
  1630. i915_gem_object_create_stolen_for_preallocated(struct drm_device *dev,
  1631. u32 stolen_offset,
  1632. u32 gtt_offset,
  1633. u32 size);
  1634. void i915_gem_object_release_stolen(struct drm_i915_gem_object *obj);
  1635. /* i915_gem_tiling.c */
  1636. inline static bool i915_gem_object_needs_bit17_swizzle(struct drm_i915_gem_object *obj)
  1637. {
  1638. drm_i915_private_t *dev_priv = obj->base.dev->dev_private;
  1639. return dev_priv->mm.bit_6_swizzle_x == I915_BIT_6_SWIZZLE_9_10_17 &&
  1640. obj->tiling_mode != I915_TILING_NONE;
  1641. }
  1642. void i915_gem_detect_bit_6_swizzle(struct drm_device *dev);
  1643. void i915_gem_object_do_bit_17_swizzle(struct drm_i915_gem_object *obj);
  1644. void i915_gem_object_save_bit_17_swizzle(struct drm_i915_gem_object *obj);
  1645. /* i915_gem_debug.c */
  1646. void i915_gem_dump_object(struct drm_i915_gem_object *obj, int len,
  1647. const char *where, uint32_t mark);
  1648. #if WATCH_LISTS
  1649. int i915_verify_lists(struct drm_device *dev);
  1650. #else
  1651. #define i915_verify_lists(dev) 0
  1652. #endif
  1653. void i915_gem_object_check_coherency(struct drm_i915_gem_object *obj,
  1654. int handle);
  1655. void i915_gem_dump_object(struct drm_i915_gem_object *obj, int len,
  1656. const char *where, uint32_t mark);
  1657. /* i915_debugfs.c */
  1658. int i915_debugfs_init(struct drm_minor *minor);
  1659. void i915_debugfs_cleanup(struct drm_minor *minor);
  1660. __printf(2, 3)
  1661. void i915_error_printf(struct drm_i915_error_state_buf *e, const char *f, ...);
  1662. /* i915_suspend.c */
  1663. extern int i915_save_state(struct drm_device *dev);
  1664. extern int i915_restore_state(struct drm_device *dev);
  1665. /* i915_ums.c */
  1666. void i915_save_display_reg(struct drm_device *dev);
  1667. void i915_restore_display_reg(struct drm_device *dev);
  1668. /* i915_sysfs.c */
  1669. void i915_setup_sysfs(struct drm_device *dev_priv);
  1670. void i915_teardown_sysfs(struct drm_device *dev_priv);
  1671. /* intel_i2c.c */
  1672. extern int intel_setup_gmbus(struct drm_device *dev);
  1673. extern void intel_teardown_gmbus(struct drm_device *dev);
  1674. static inline bool intel_gmbus_is_port_valid(unsigned port)
  1675. {
  1676. return (port >= GMBUS_PORT_SSC && port <= GMBUS_PORT_DPD);
  1677. }
  1678. extern struct i2c_adapter *intel_gmbus_get_adapter(
  1679. struct drm_i915_private *dev_priv, unsigned port);
  1680. extern void intel_gmbus_set_speed(struct i2c_adapter *adapter, int speed);
  1681. extern void intel_gmbus_force_bit(struct i2c_adapter *adapter, bool force_bit);
  1682. static inline bool intel_gmbus_is_forced_bit(struct i2c_adapter *adapter)
  1683. {
  1684. return container_of(adapter, struct intel_gmbus, adapter)->force_bit;
  1685. }
  1686. extern void intel_i2c_reset(struct drm_device *dev);
  1687. /* intel_opregion.c */
  1688. extern int intel_opregion_setup(struct drm_device *dev);
  1689. #ifdef CONFIG_ACPI
  1690. extern void intel_opregion_init(struct drm_device *dev);
  1691. extern void intel_opregion_fini(struct drm_device *dev);
  1692. extern void intel_opregion_asle_intr(struct drm_device *dev);
  1693. #else
  1694. static inline void intel_opregion_init(struct drm_device *dev) { return; }
  1695. static inline void intel_opregion_fini(struct drm_device *dev) { return; }
  1696. static inline void intel_opregion_asle_intr(struct drm_device *dev) { return; }
  1697. #endif
  1698. /* intel_acpi.c */
  1699. #ifdef CONFIG_ACPI
  1700. extern void intel_register_dsm_handler(void);
  1701. extern void intel_unregister_dsm_handler(void);
  1702. #else
  1703. static inline void intel_register_dsm_handler(void) { return; }
  1704. static inline void intel_unregister_dsm_handler(void) { return; }
  1705. #endif /* CONFIG_ACPI */
  1706. /* modesetting */
  1707. extern void intel_modeset_init_hw(struct drm_device *dev);
  1708. extern void intel_modeset_suspend_hw(struct drm_device *dev);
  1709. extern void intel_modeset_init(struct drm_device *dev);
  1710. extern void intel_modeset_gem_init(struct drm_device *dev);
  1711. extern void intel_modeset_cleanup(struct drm_device *dev);
  1712. extern int intel_modeset_vga_set_state(struct drm_device *dev, bool state);
  1713. extern void intel_modeset_setup_hw_state(struct drm_device *dev,
  1714. bool force_restore);
  1715. extern void i915_redisable_vga(struct drm_device *dev);
  1716. extern bool intel_fbc_enabled(struct drm_device *dev);
  1717. extern void intel_disable_fbc(struct drm_device *dev);
  1718. extern bool ironlake_set_drps(struct drm_device *dev, u8 val);
  1719. extern void intel_init_pch_refclk(struct drm_device *dev);
  1720. extern void gen6_set_rps(struct drm_device *dev, u8 val);
  1721. extern void valleyview_set_rps(struct drm_device *dev, u8 val);
  1722. extern int valleyview_rps_max_freq(struct drm_i915_private *dev_priv);
  1723. extern int valleyview_rps_min_freq(struct drm_i915_private *dev_priv);
  1724. extern void intel_detect_pch(struct drm_device *dev);
  1725. extern int intel_trans_dp_port_sel(struct drm_crtc *crtc);
  1726. extern int intel_enable_rc6(const struct drm_device *dev);
  1727. extern bool i915_semaphore_is_enabled(struct drm_device *dev);
  1728. int i915_reg_read_ioctl(struct drm_device *dev, void *data,
  1729. struct drm_file *file);
  1730. /* overlay */
  1731. #ifdef CONFIG_DEBUG_FS
  1732. extern struct intel_overlay_error_state *intel_overlay_capture_error_state(struct drm_device *dev);
  1733. extern void intel_overlay_print_error_state(struct drm_i915_error_state_buf *e,
  1734. struct intel_overlay_error_state *error);
  1735. extern struct intel_display_error_state *intel_display_capture_error_state(struct drm_device *dev);
  1736. extern void intel_display_print_error_state(struct drm_i915_error_state_buf *e,
  1737. struct drm_device *dev,
  1738. struct intel_display_error_state *error);
  1739. #endif
  1740. /* On SNB platform, before reading ring registers forcewake bit
  1741. * must be set to prevent GT core from power down and stale values being
  1742. * returned.
  1743. */
  1744. void gen6_gt_force_wake_get(struct drm_i915_private *dev_priv);
  1745. void gen6_gt_force_wake_put(struct drm_i915_private *dev_priv);
  1746. int __gen6_gt_wait_for_fifo(struct drm_i915_private *dev_priv);
  1747. int sandybridge_pcode_read(struct drm_i915_private *dev_priv, u8 mbox, u32 *val);
  1748. int sandybridge_pcode_write(struct drm_i915_private *dev_priv, u8 mbox, u32 val);
  1749. /* intel_sideband.c */
  1750. u32 vlv_punit_read(struct drm_i915_private *dev_priv, u8 addr);
  1751. void vlv_punit_write(struct drm_i915_private *dev_priv, u8 addr, u32 val);
  1752. u32 vlv_nc_read(struct drm_i915_private *dev_priv, u8 addr);
  1753. u32 vlv_dpio_read(struct drm_i915_private *dev_priv, int reg);
  1754. void vlv_dpio_write(struct drm_i915_private *dev_priv, int reg, u32 val);
  1755. u32 intel_sbi_read(struct drm_i915_private *dev_priv, u16 reg,
  1756. enum intel_sbi_destination destination);
  1757. void intel_sbi_write(struct drm_i915_private *dev_priv, u16 reg, u32 value,
  1758. enum intel_sbi_destination destination);
  1759. int vlv_gpu_freq(int ddr_freq, int val);
  1760. int vlv_freq_opcode(int ddr_freq, int val);
  1761. #define __i915_read(x, y) \
  1762. u##x i915_read##x(struct drm_i915_private *dev_priv, u32 reg);
  1763. __i915_read(8, b)
  1764. __i915_read(16, w)
  1765. __i915_read(32, l)
  1766. __i915_read(64, q)
  1767. #undef __i915_read
  1768. #define __i915_write(x, y) \
  1769. void i915_write##x(struct drm_i915_private *dev_priv, u32 reg, u##x val);
  1770. __i915_write(8, b)
  1771. __i915_write(16, w)
  1772. __i915_write(32, l)
  1773. __i915_write(64, q)
  1774. #undef __i915_write
  1775. #define I915_READ8(reg) i915_read8(dev_priv, (reg))
  1776. #define I915_WRITE8(reg, val) i915_write8(dev_priv, (reg), (val))
  1777. #define I915_READ16(reg) i915_read16(dev_priv, (reg))
  1778. #define I915_WRITE16(reg, val) i915_write16(dev_priv, (reg), (val))
  1779. #define I915_READ16_NOTRACE(reg) readw(dev_priv->regs + (reg))
  1780. #define I915_WRITE16_NOTRACE(reg, val) writew(val, dev_priv->regs + (reg))
  1781. #define I915_READ(reg) i915_read32(dev_priv, (reg))
  1782. #define I915_WRITE(reg, val) i915_write32(dev_priv, (reg), (val))
  1783. #define I915_READ_NOTRACE(reg) readl(dev_priv->regs + (reg))
  1784. #define I915_WRITE_NOTRACE(reg, val) writel(val, dev_priv->regs + (reg))
  1785. #define I915_WRITE64(reg, val) i915_write64(dev_priv, (reg), (val))
  1786. #define I915_READ64(reg) i915_read64(dev_priv, (reg))
  1787. #define POSTING_READ(reg) (void)I915_READ_NOTRACE(reg)
  1788. #define POSTING_READ16(reg) (void)I915_READ16_NOTRACE(reg)
  1789. /* "Broadcast RGB" property */
  1790. #define INTEL_BROADCAST_RGB_AUTO 0
  1791. #define INTEL_BROADCAST_RGB_FULL 1
  1792. #define INTEL_BROADCAST_RGB_LIMITED 2
  1793. static inline uint32_t i915_vgacntrl_reg(struct drm_device *dev)
  1794. {
  1795. if (HAS_PCH_SPLIT(dev))
  1796. return CPU_VGACNTRL;
  1797. else if (IS_VALLEYVIEW(dev))
  1798. return VLV_VGACNTRL;
  1799. else
  1800. return VGACNTRL;
  1801. }
  1802. static inline void __user *to_user_ptr(u64 address)
  1803. {
  1804. return (void __user *)(uintptr_t)address;
  1805. }
  1806. static inline unsigned long msecs_to_jiffies_timeout(const unsigned int m)
  1807. {
  1808. unsigned long j = msecs_to_jiffies(m);
  1809. return min_t(unsigned long, MAX_JIFFY_OFFSET, j + 1);
  1810. }
  1811. static inline unsigned long
  1812. timespec_to_jiffies_timeout(const struct timespec *value)
  1813. {
  1814. unsigned long j = timespec_to_jiffies(value);
  1815. return min_t(unsigned long, MAX_JIFFY_OFFSET, j + 1);
  1816. }
  1817. #endif