intel_guc_fwif.h 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629
  1. /*
  2. * Copyright © 2014 Intel Corporation
  3. *
  4. * Permission is hereby granted, free of charge, to any person obtaining a
  5. * copy of this software and associated documentation files (the "Software"),
  6. * to deal in the Software without restriction, including without limitation
  7. * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  8. * and/or sell copies of the Software, and to permit persons to whom the
  9. * Software is furnished to do so, subject to the following conditions:
  10. *
  11. * The above copyright notice and this permission notice (including the next
  12. * paragraph) shall be included in all copies or substantial portions of the
  13. * Software.
  14. *
  15. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  18. * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20. * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  21. * IN THE SOFTWARE.
  22. */
  23. #ifndef _INTEL_GUC_FWIF_H
  24. #define _INTEL_GUC_FWIF_H
  25. #define GUC_CORE_FAMILY_GEN9 12
  26. #define GUC_CORE_FAMILY_UNKNOWN 0x7fffffff
  27. #define GUC_CLIENT_PRIORITY_KMD_HIGH 0
  28. #define GUC_CLIENT_PRIORITY_HIGH 1
  29. #define GUC_CLIENT_PRIORITY_KMD_NORMAL 2
  30. #define GUC_CLIENT_PRIORITY_NORMAL 3
  31. #define GUC_CLIENT_PRIORITY_NUM 4
  32. #define GUC_MAX_STAGE_DESCRIPTORS 1024
  33. #define GUC_INVALID_STAGE_ID GUC_MAX_STAGE_DESCRIPTORS
  34. #define GUC_RENDER_ENGINE 0
  35. #define GUC_VIDEO_ENGINE 1
  36. #define GUC_BLITTER_ENGINE 2
  37. #define GUC_VIDEOENHANCE_ENGINE 3
  38. #define GUC_VIDEO_ENGINE2 4
  39. #define GUC_MAX_ENGINES_NUM (GUC_VIDEO_ENGINE2 + 1)
  40. /* Work queue item header definitions */
  41. #define WQ_STATUS_ACTIVE 1
  42. #define WQ_STATUS_SUSPENDED 2
  43. #define WQ_STATUS_CMD_ERROR 3
  44. #define WQ_STATUS_ENGINE_ID_NOT_USED 4
  45. #define WQ_STATUS_SUSPENDED_FROM_RESET 5
  46. #define WQ_TYPE_SHIFT 0
  47. #define WQ_TYPE_BATCH_BUF (0x1 << WQ_TYPE_SHIFT)
  48. #define WQ_TYPE_PSEUDO (0x2 << WQ_TYPE_SHIFT)
  49. #define WQ_TYPE_INORDER (0x3 << WQ_TYPE_SHIFT)
  50. #define WQ_TARGET_SHIFT 10
  51. #define WQ_LEN_SHIFT 16
  52. #define WQ_NO_WCFLUSH_WAIT (1 << 27)
  53. #define WQ_PRESENT_WORKLOAD (1 << 28)
  54. #define WQ_RING_TAIL_SHIFT 20
  55. #define WQ_RING_TAIL_MAX 0x7FF /* 2^11 QWords */
  56. #define WQ_RING_TAIL_MASK (WQ_RING_TAIL_MAX << WQ_RING_TAIL_SHIFT)
  57. #define GUC_DOORBELL_ENABLED 1
  58. #define GUC_DOORBELL_DISABLED 0
  59. #define GUC_STAGE_DESC_ATTR_ACTIVE BIT(0)
  60. #define GUC_STAGE_DESC_ATTR_PENDING_DB BIT(1)
  61. #define GUC_STAGE_DESC_ATTR_KERNEL BIT(2)
  62. #define GUC_STAGE_DESC_ATTR_PREEMPT BIT(3)
  63. #define GUC_STAGE_DESC_ATTR_RESET BIT(4)
  64. #define GUC_STAGE_DESC_ATTR_WQLOCKED BIT(5)
  65. #define GUC_STAGE_DESC_ATTR_PCH BIT(6)
  66. #define GUC_STAGE_DESC_ATTR_TERMINATED BIT(7)
  67. /* The guc control data is 10 DWORDs */
  68. #define GUC_CTL_CTXINFO 0
  69. #define GUC_CTL_CTXNUM_IN16_SHIFT 0
  70. #define GUC_CTL_BASE_ADDR_SHIFT 12
  71. #define GUC_CTL_ARAT_HIGH 1
  72. #define GUC_CTL_ARAT_LOW 2
  73. #define GUC_CTL_DEVICE_INFO 3
  74. #define GUC_CTL_GT_TYPE_SHIFT 0
  75. #define GUC_CTL_CORE_FAMILY_SHIFT 7
  76. #define GUC_CTL_LOG_PARAMS 4
  77. #define GUC_LOG_VALID (1 << 0)
  78. #define GUC_LOG_NOTIFY_ON_HALF_FULL (1 << 1)
  79. #define GUC_LOG_ALLOC_IN_MEGABYTE (1 << 3)
  80. #define GUC_LOG_CRASH_PAGES 1
  81. #define GUC_LOG_CRASH_SHIFT 4
  82. #define GUC_LOG_DPC_PAGES 7
  83. #define GUC_LOG_DPC_SHIFT 6
  84. #define GUC_LOG_ISR_PAGES 7
  85. #define GUC_LOG_ISR_SHIFT 9
  86. #define GUC_LOG_BUF_ADDR_SHIFT 12
  87. #define GUC_CTL_PAGE_FAULT_CONTROL 5
  88. #define GUC_CTL_WA 6
  89. #define GUC_CTL_WA_UK_BY_DRIVER (1 << 3)
  90. #define GUC_CTL_FEATURE 7
  91. #define GUC_CTL_VCS2_ENABLED (1 << 0)
  92. #define GUC_CTL_KERNEL_SUBMISSIONS (1 << 1)
  93. #define GUC_CTL_FEATURE2 (1 << 2)
  94. #define GUC_CTL_POWER_GATING (1 << 3)
  95. #define GUC_CTL_DISABLE_SCHEDULER (1 << 4)
  96. #define GUC_CTL_PREEMPTION_LOG (1 << 5)
  97. #define GUC_CTL_ENABLE_SLPC (1 << 7)
  98. #define GUC_CTL_RESET_ON_PREMPT_FAILURE (1 << 8)
  99. #define GUC_CTL_DEBUG 8
  100. #define GUC_LOG_VERBOSITY_SHIFT 0
  101. #define GUC_LOG_VERBOSITY_LOW (0 << GUC_LOG_VERBOSITY_SHIFT)
  102. #define GUC_LOG_VERBOSITY_MED (1 << GUC_LOG_VERBOSITY_SHIFT)
  103. #define GUC_LOG_VERBOSITY_HIGH (2 << GUC_LOG_VERBOSITY_SHIFT)
  104. #define GUC_LOG_VERBOSITY_ULTRA (3 << GUC_LOG_VERBOSITY_SHIFT)
  105. /* Verbosity range-check limits, without the shift */
  106. #define GUC_LOG_VERBOSITY_MIN 0
  107. #define GUC_LOG_VERBOSITY_MAX 3
  108. #define GUC_LOG_VERBOSITY_MASK 0x0000000f
  109. #define GUC_LOG_DESTINATION_MASK (3 << 4)
  110. #define GUC_LOG_DISABLED (1 << 6)
  111. #define GUC_PROFILE_ENABLED (1 << 7)
  112. #define GUC_WQ_TRACK_ENABLED (1 << 8)
  113. #define GUC_ADS_ENABLED (1 << 9)
  114. #define GUC_DEBUG_RESERVED (1 << 10)
  115. #define GUC_ADS_ADDR_SHIFT 11
  116. #define GUC_ADS_ADDR_MASK 0xfffff800
  117. #define GUC_CTL_RSRVD 9
  118. #define GUC_CTL_MAX_DWORDS (SOFT_SCRATCH_COUNT - 2) /* [1..14] */
  119. /**
  120. * DOC: GuC Firmware Layout
  121. *
  122. * The GuC firmware layout looks like this:
  123. *
  124. * +-------------------------------+
  125. * | uc_css_header |
  126. * | |
  127. * | contains major/minor version |
  128. * +-------------------------------+
  129. * | uCode |
  130. * +-------------------------------+
  131. * | RSA signature |
  132. * +-------------------------------+
  133. * | modulus key |
  134. * +-------------------------------+
  135. * | exponent val |
  136. * +-------------------------------+
  137. *
  138. * The firmware may or may not have modulus key and exponent data. The header,
  139. * uCode and RSA signature are must-have components that will be used by driver.
  140. * Length of each components, which is all in dwords, can be found in header.
  141. * In the case that modulus and exponent are not present in fw, a.k.a truncated
  142. * image, the length value still appears in header.
  143. *
  144. * Driver will do some basic fw size validation based on the following rules:
  145. *
  146. * 1. Header, uCode and RSA are must-have components.
  147. * 2. All firmware components, if they present, are in the sequence illustrated
  148. * in the layout table above.
  149. * 3. Length info of each component can be found in header, in dwords.
  150. * 4. Modulus and exponent key are not required by driver. They may not appear
  151. * in fw. So driver will load a truncated firmware in this case.
  152. *
  153. * HuC firmware layout is same as GuC firmware.
  154. *
  155. * HuC firmware css header is different. However, the only difference is where
  156. * the version information is saved. The uc_css_header is unified to support
  157. * both. Driver should get HuC version from uc_css_header.huc_sw_version, while
  158. * uc_css_header.guc_sw_version for GuC.
  159. */
  160. struct uc_css_header {
  161. u32 module_type;
  162. /* header_size includes all non-uCode bits, including css_header, rsa
  163. * key, modulus key and exponent data. */
  164. u32 header_size_dw;
  165. u32 header_version;
  166. u32 module_id;
  167. u32 module_vendor;
  168. union {
  169. struct {
  170. u8 day;
  171. u8 month;
  172. u16 year;
  173. };
  174. u32 date;
  175. };
  176. u32 size_dw; /* uCode plus header_size_dw */
  177. u32 key_size_dw;
  178. u32 modulus_size_dw;
  179. u32 exponent_size_dw;
  180. union {
  181. struct {
  182. u8 hour;
  183. u8 min;
  184. u16 sec;
  185. };
  186. u32 time;
  187. };
  188. char username[8];
  189. char buildnumber[12];
  190. union {
  191. struct {
  192. u32 branch_client_version;
  193. u32 sw_version;
  194. } guc;
  195. struct {
  196. u32 sw_version;
  197. u32 reserved;
  198. } huc;
  199. };
  200. u32 prod_preprod_fw;
  201. u32 reserved[12];
  202. u32 header_info;
  203. } __packed;
  204. struct guc_doorbell_info {
  205. u32 db_status;
  206. u32 cookie;
  207. u32 reserved[14];
  208. } __packed;
  209. union guc_doorbell_qw {
  210. struct {
  211. u32 db_status;
  212. u32 cookie;
  213. };
  214. u64 value_qw;
  215. } __packed;
  216. #define GUC_NUM_DOORBELLS 256
  217. #define GUC_DOORBELL_INVALID (GUC_NUM_DOORBELLS)
  218. #define GUC_DB_SIZE (PAGE_SIZE)
  219. #define GUC_WQ_SIZE (PAGE_SIZE * 2)
  220. /* Work item for submitting workloads into work queue of GuC. */
  221. struct guc_wq_item {
  222. u32 header;
  223. u32 context_desc;
  224. u32 submit_element_info;
  225. u32 fence_id;
  226. } __packed;
  227. struct guc_process_desc {
  228. u32 stage_id;
  229. u64 db_base_addr;
  230. u32 head;
  231. u32 tail;
  232. u32 error_offset;
  233. u64 wq_base_addr;
  234. u32 wq_size_bytes;
  235. u32 wq_status;
  236. u32 engine_presence;
  237. u32 priority;
  238. u32 reserved[30];
  239. } __packed;
  240. /* engine id and context id is packed into guc_execlist_context.context_id*/
  241. #define GUC_ELC_CTXID_OFFSET 0
  242. #define GUC_ELC_ENGINE_OFFSET 29
  243. /* The execlist context including software and HW information */
  244. struct guc_execlist_context {
  245. u32 context_desc;
  246. u32 context_id;
  247. u32 ring_status;
  248. u32 ring_lrca;
  249. u32 ring_begin;
  250. u32 ring_end;
  251. u32 ring_next_free_location;
  252. u32 ring_current_tail_pointer_value;
  253. u8 engine_state_submit_value;
  254. u8 engine_state_wait_value;
  255. u16 pagefault_count;
  256. u16 engine_submit_queue_count;
  257. } __packed;
  258. /*
  259. * This structure describes a stage set arranged for a particular communication
  260. * between uKernel (GuC) and Driver (KMD). Technically, this is known as a
  261. * "GuC Context descriptor" in the specs, but we use the term "stage descriptor"
  262. * to avoid confusion with all the other things already named "context" in the
  263. * driver. A static pool of these descriptors are stored inside a GEM object
  264. * (stage_desc_pool) which is held for the entire lifetime of our interaction
  265. * with the GuC, being allocated before the GuC is loaded with its firmware.
  266. */
  267. struct guc_stage_desc {
  268. u32 sched_common_area;
  269. u32 stage_id;
  270. u32 pas_id;
  271. u8 engines_used;
  272. u64 db_trigger_cpu;
  273. u32 db_trigger_uk;
  274. u64 db_trigger_phy;
  275. u16 db_id;
  276. struct guc_execlist_context lrc[GUC_MAX_ENGINES_NUM];
  277. u8 attribute;
  278. u32 priority;
  279. u32 wq_sampled_tail_offset;
  280. u32 wq_total_submit_enqueues;
  281. u32 process_desc;
  282. u32 wq_addr;
  283. u32 wq_size;
  284. u32 engine_presence;
  285. u8 engine_suspended;
  286. u8 reserved0[3];
  287. u64 reserved1[1];
  288. u64 desc_private;
  289. } __packed;
  290. /*
  291. * Describes single command transport buffer.
  292. * Used by both guc-master and clients.
  293. */
  294. struct guc_ct_buffer_desc {
  295. u32 addr; /* gfx address */
  296. u64 host_private; /* host private data */
  297. u32 size; /* size in bytes */
  298. u32 head; /* offset updated by GuC*/
  299. u32 tail; /* offset updated by owner */
  300. u32 is_in_error; /* error indicator */
  301. u32 fence; /* fence updated by GuC */
  302. u32 status; /* status updated by GuC */
  303. u32 owner; /* id of the channel owner */
  304. u32 owner_sub_id; /* owner-defined field for extra tracking */
  305. u32 reserved[5];
  306. } __packed;
  307. /* Type of command transport buffer */
  308. #define INTEL_GUC_CT_BUFFER_TYPE_SEND 0x0u
  309. #define INTEL_GUC_CT_BUFFER_TYPE_RECV 0x1u
  310. /*
  311. * Definition of the command transport message header (DW0)
  312. *
  313. * bit[4..0] message len (in dwords)
  314. * bit[7..5] reserved
  315. * bit[8] write fence to desc
  316. * bit[9] write status to H2G buff
  317. * bit[10] send status (via G2H)
  318. * bit[15..11] reserved
  319. * bit[31..16] action code
  320. */
  321. #define GUC_CT_MSG_LEN_SHIFT 0
  322. #define GUC_CT_MSG_LEN_MASK 0x1F
  323. #define GUC_CT_MSG_WRITE_FENCE_TO_DESC (1 << 8)
  324. #define GUC_CT_MSG_WRITE_STATUS_TO_BUFF (1 << 9)
  325. #define GUC_CT_MSG_SEND_STATUS (1 << 10)
  326. #define GUC_CT_MSG_ACTION_SHIFT 16
  327. #define GUC_CT_MSG_ACTION_MASK 0xFFFF
  328. #define GUC_FORCEWAKE_RENDER (1 << 0)
  329. #define GUC_FORCEWAKE_MEDIA (1 << 1)
  330. #define GUC_POWER_UNSPECIFIED 0
  331. #define GUC_POWER_D0 1
  332. #define GUC_POWER_D1 2
  333. #define GUC_POWER_D2 3
  334. #define GUC_POWER_D3 4
  335. /* Scheduling policy settings */
  336. /* Reset engine upon preempt failure */
  337. #define POLICY_RESET_ENGINE (1<<0)
  338. /* Preempt to idle on quantum expiry */
  339. #define POLICY_PREEMPT_TO_IDLE (1<<1)
  340. #define POLICY_MAX_NUM_WI 15
  341. #define POLICY_DEFAULT_DPC_PROMOTE_TIME_US 500000
  342. #define POLICY_DEFAULT_EXECUTION_QUANTUM_US 1000000
  343. #define POLICY_DEFAULT_PREEMPTION_TIME_US 500000
  344. #define POLICY_DEFAULT_FAULT_TIME_US 250000
  345. struct guc_policy {
  346. /* Time for one workload to execute. (in micro seconds) */
  347. u32 execution_quantum;
  348. u32 reserved1;
  349. /* Time to wait for a preemption request to completed before issuing a
  350. * reset. (in micro seconds). */
  351. u32 preemption_time;
  352. /* How much time to allow to run after the first fault is observed.
  353. * Then preempt afterwards. (in micro seconds) */
  354. u32 fault_time;
  355. u32 policy_flags;
  356. u32 reserved[2];
  357. } __packed;
  358. struct guc_policies {
  359. struct guc_policy policy[GUC_CLIENT_PRIORITY_NUM][GUC_MAX_ENGINES_NUM];
  360. /* In micro seconds. How much time to allow before DPC processing is
  361. * called back via interrupt (to prevent DPC queue drain starving).
  362. * Typically 1000s of micro seconds (example only, not granularity). */
  363. u32 dpc_promote_time;
  364. /* Must be set to take these new values. */
  365. u32 is_valid;
  366. /* Max number of WIs to process per call. A large value may keep CS
  367. * idle. */
  368. u32 max_num_work_items;
  369. u32 reserved[19];
  370. } __packed;
  371. /* GuC MMIO reg state struct */
  372. #define GUC_REGSET_FLAGS_NONE 0x0
  373. #define GUC_REGSET_POWERCYCLE 0x1
  374. #define GUC_REGSET_MASKED 0x2
  375. #define GUC_REGSET_ENGINERESET 0x4
  376. #define GUC_REGSET_SAVE_DEFAULT_VALUE 0x8
  377. #define GUC_REGSET_SAVE_CURRENT_VALUE 0x10
  378. #define GUC_REGSET_MAX_REGISTERS 25
  379. #define GUC_MMIO_WHITE_LIST_START 0x24d0
  380. #define GUC_MMIO_WHITE_LIST_MAX 12
  381. #define GUC_S3_SAVE_SPACE_PAGES 10
  382. struct guc_mmio_regset {
  383. struct __packed {
  384. u32 offset;
  385. u32 value;
  386. u32 flags;
  387. } registers[GUC_REGSET_MAX_REGISTERS];
  388. u32 values_valid;
  389. u32 number_of_registers;
  390. } __packed;
  391. /* MMIO registers that are set as non privileged */
  392. struct mmio_white_list {
  393. u32 mmio_start;
  394. u32 offsets[GUC_MMIO_WHITE_LIST_MAX];
  395. u32 count;
  396. } __packed;
  397. struct guc_mmio_reg_state {
  398. struct guc_mmio_regset global_reg;
  399. struct guc_mmio_regset engine_reg[GUC_MAX_ENGINES_NUM];
  400. struct mmio_white_list white_list[GUC_MAX_ENGINES_NUM];
  401. } __packed;
  402. /* GuC Additional Data Struct */
  403. struct guc_ads {
  404. u32 reg_state_addr;
  405. u32 reg_state_buffer;
  406. u32 golden_context_lrca;
  407. u32 scheduler_policies;
  408. u32 reserved0[3];
  409. u32 eng_state_size[GUC_MAX_ENGINES_NUM];
  410. u32 reserved2[4];
  411. } __packed;
  412. /* GuC logging structures */
  413. enum guc_log_buffer_type {
  414. GUC_ISR_LOG_BUFFER,
  415. GUC_DPC_LOG_BUFFER,
  416. GUC_CRASH_DUMP_LOG_BUFFER,
  417. GUC_MAX_LOG_BUFFER
  418. };
  419. /**
  420. * DOC: GuC Log buffer Layout
  421. *
  422. * Page0 +-------------------------------+
  423. * | ISR state header (32 bytes) |
  424. * | DPC state header |
  425. * | Crash dump state header |
  426. * Page1 +-------------------------------+
  427. * | ISR logs |
  428. * Page9 +-------------------------------+
  429. * | DPC logs |
  430. * Page17 +-------------------------------+
  431. * | Crash Dump logs |
  432. * +-------------------------------+
  433. *
  434. * Below state structure is used for coordination of retrieval of GuC firmware
  435. * logs. Separate state is maintained for each log buffer type.
  436. * read_ptr points to the location where i915 read last in log buffer and
  437. * is read only for GuC firmware. write_ptr is incremented by GuC with number
  438. * of bytes written for each log entry and is read only for i915.
  439. * When any type of log buffer becomes half full, GuC sends a flush interrupt.
  440. * GuC firmware expects that while it is writing to 2nd half of the buffer,
  441. * first half would get consumed by Host and then get a flush completed
  442. * acknowledgment from Host, so that it does not end up doing any overwrite
  443. * causing loss of logs. So when buffer gets half filled & i915 has requested
  444. * for interrupt, GuC will set flush_to_file field, set the sampled_write_ptr
  445. * to the value of write_ptr and raise the interrupt.
  446. * On receiving the interrupt i915 should read the buffer, clear flush_to_file
  447. * field and also update read_ptr with the value of sample_write_ptr, before
  448. * sending an acknowledgment to GuC. marker & version fields are for internal
  449. * usage of GuC and opaque to i915. buffer_full_cnt field is incremented every
  450. * time GuC detects the log buffer overflow.
  451. */
  452. struct guc_log_buffer_state {
  453. u32 marker[2];
  454. u32 read_ptr;
  455. u32 write_ptr;
  456. u32 size;
  457. u32 sampled_write_ptr;
  458. union {
  459. struct {
  460. u32 flush_to_file:1;
  461. u32 buffer_full_cnt:4;
  462. u32 reserved:27;
  463. };
  464. u32 flags;
  465. };
  466. u32 version;
  467. } __packed;
  468. union guc_log_control {
  469. struct {
  470. u32 logging_enabled:1;
  471. u32 reserved1:3;
  472. u32 verbosity:4;
  473. u32 reserved2:24;
  474. };
  475. u32 value;
  476. } __packed;
  477. struct guc_ctx_report {
  478. u32 report_return_status;
  479. u32 reserved1[64];
  480. u32 affected_count;
  481. u32 reserved2[2];
  482. } __packed;
  483. /* GuC Shared Context Data Struct */
  484. struct guc_shared_ctx_data {
  485. u32 addr_of_last_preempted_data_low;
  486. u32 addr_of_last_preempted_data_high;
  487. u32 addr_of_last_preempted_data_high_tmp;
  488. u32 padding;
  489. u32 is_mapped_to_proxy;
  490. u32 proxy_ctx_id;
  491. u32 engine_reset_ctx_id;
  492. u32 media_reset_count;
  493. u32 reserved1[8];
  494. u32 uk_last_ctx_switch_reason;
  495. u32 was_reset;
  496. u32 lrca_gpu_addr;
  497. u64 execlist_ctx;
  498. u32 reserved2[66];
  499. struct guc_ctx_report preempt_ctx_report[GUC_MAX_ENGINES_NUM];
  500. } __packed;
  501. /* This Action will be programmed in C180 - SOFT_SCRATCH_O_REG */
  502. enum intel_guc_action {
  503. INTEL_GUC_ACTION_DEFAULT = 0x0,
  504. INTEL_GUC_ACTION_REQUEST_PREEMPTION = 0x2,
  505. INTEL_GUC_ACTION_REQUEST_ENGINE_RESET = 0x3,
  506. INTEL_GUC_ACTION_SAMPLE_FORCEWAKE = 0x6,
  507. INTEL_GUC_ACTION_ALLOCATE_DOORBELL = 0x10,
  508. INTEL_GUC_ACTION_DEALLOCATE_DOORBELL = 0x20,
  509. INTEL_GUC_ACTION_LOG_BUFFER_FILE_FLUSH_COMPLETE = 0x30,
  510. INTEL_GUC_ACTION_FORCE_LOG_BUFFER_FLUSH = 0x302,
  511. INTEL_GUC_ACTION_ENTER_S_STATE = 0x501,
  512. INTEL_GUC_ACTION_EXIT_S_STATE = 0x502,
  513. INTEL_GUC_ACTION_SLPC_REQUEST = 0x3003,
  514. INTEL_GUC_ACTION_AUTHENTICATE_HUC = 0x4000,
  515. INTEL_GUC_ACTION_REGISTER_COMMAND_TRANSPORT_BUFFER = 0x4505,
  516. INTEL_GUC_ACTION_DEREGISTER_COMMAND_TRANSPORT_BUFFER = 0x4506,
  517. INTEL_GUC_ACTION_UK_LOG_ENABLE_LOGGING = 0x0E000,
  518. INTEL_GUC_ACTION_LIMIT
  519. };
  520. enum intel_guc_preempt_options {
  521. INTEL_GUC_PREEMPT_OPTION_DROP_WORK_Q = 0x4,
  522. INTEL_GUC_PREEMPT_OPTION_DROP_SUBMIT_Q = 0x8,
  523. };
  524. enum intel_guc_report_status {
  525. INTEL_GUC_REPORT_STATUS_UNKNOWN = 0x0,
  526. INTEL_GUC_REPORT_STATUS_ACKED = 0x1,
  527. INTEL_GUC_REPORT_STATUS_ERROR = 0x2,
  528. INTEL_GUC_REPORT_STATUS_COMPLETE = 0x4,
  529. };
  530. /*
  531. * The GuC sends its response to a command by overwriting the
  532. * command in SS0. The response is distinguishable from a command
  533. * by the fact that all the MASK bits are set. The remaining bits
  534. * give more detail.
  535. */
  536. #define INTEL_GUC_RECV_MASK ((u32)0xF0000000)
  537. #define INTEL_GUC_RECV_IS_RESPONSE(x) ((u32)(x) >= INTEL_GUC_RECV_MASK)
  538. #define INTEL_GUC_RECV_STATUS(x) (INTEL_GUC_RECV_MASK | (x))
  539. /* GUC will return status back to SOFT_SCRATCH_O_REG */
  540. enum intel_guc_status {
  541. INTEL_GUC_STATUS_SUCCESS = INTEL_GUC_RECV_STATUS(0x0),
  542. INTEL_GUC_STATUS_ALLOCATE_DOORBELL_FAIL = INTEL_GUC_RECV_STATUS(0x10),
  543. INTEL_GUC_STATUS_DEALLOCATE_DOORBELL_FAIL = INTEL_GUC_RECV_STATUS(0x20),
  544. INTEL_GUC_STATUS_GENERIC_FAIL = INTEL_GUC_RECV_STATUS(0x0000F000)
  545. };
  546. /* This action will be programmed in C1BC - SOFT_SCRATCH_15_REG */
  547. enum intel_guc_recv_message {
  548. INTEL_GUC_RECV_MSG_CRASH_DUMP_POSTED = BIT(1),
  549. INTEL_GUC_RECV_MSG_FLUSH_LOG_BUFFER = BIT(3)
  550. };
  551. #endif