cvp_hfi_api.h 7.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305
  1. /* SPDX-License-Identifier: GPL-2.0-only */
  2. /*
  3. * Copyright (c) 2018-2021, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef __CVP_HFI_API_H__
  6. #define __CVP_HFI_API_H__
  7. #include <linux/log2.h>
  8. #include <linux/platform_device.h>
  9. #include <linux/types.h>
  10. #include <linux/errno.h>
  11. #include <linux/hash.h>
  12. #include "msm_cvp_core.h"
  13. #include "msm_cvp_resources.h"
  14. #include "cvp_hfi_helper.h"
  15. #define CONTAINS(__a, __sz, __t) (\
  16. (__t >= __a) && \
  17. (__t < __a + __sz) \
  18. )
  19. #define OVERLAPS(__t, __tsz, __a, __asz) (\
  20. (__t <= __a) && \
  21. (__t + __tsz >= __a + __asz) \
  22. )
  23. #define CVP_VERSION_LENGTH 128
  24. /* 16 encoder and 16 decoder sessions */
  25. #define CVP_MAX_SESSIONS 32
  26. #define HFI_VERSION_MAJOR_MASK 0xFF000000
  27. #define HFI_VERSION_MAJOR_SHFIT 24
  28. #define HFI_VERSION_MINOR_MASK 0x00FFFFE0
  29. #define HFI_VERSION_MINOR_SHIFT 5
  30. #define HFI_VERSION_BRANCH_MASK 0x0000001F
  31. #define HFI_VERSION_BRANCH_SHIFT 0
  32. enum cvp_status {
  33. CVP_ERR_NONE = 0x0,
  34. CVP_ERR_FAIL = 0x80000000,
  35. CVP_ERR_ALLOC_FAIL,
  36. CVP_ERR_ILLEGAL_OP,
  37. CVP_ERR_BAD_PARAM,
  38. CVP_ERR_BAD_HANDLE,
  39. CVP_ERR_NOT_SUPPORTED,
  40. CVP_ERR_BAD_STATE,
  41. CVP_ERR_MAX_CLIENTS,
  42. CVP_ERR_IFRAME_EXPECTED,
  43. CVP_ERR_HW_FATAL,
  44. CVP_ERR_BITSTREAM_ERR,
  45. CVP_ERR_INDEX_NOMORE,
  46. CVP_ERR_SEQHDR_PARSE_FAIL,
  47. CVP_ERR_INSUFFICIENT_BUFFER,
  48. CVP_ERR_BAD_POWER_STATE,
  49. CVP_ERR_NO_VALID_SESSION,
  50. CVP_ERR_TIMEOUT,
  51. CVP_ERR_CMDQFULL,
  52. CVP_ERR_START_CODE_NOT_FOUND,
  53. CVP_ERR_NOC_ERROR,
  54. CVP_ERR_CLIENT_PRESENT = 0x90000001,
  55. CVP_ERR_CLIENT_FATAL,
  56. CVP_ERR_CMD_QUEUE_FULL,
  57. CVP_ERR_UNUSED = 0x10000000
  58. };
  59. enum hal_property {
  60. HAL_UNUSED_PROPERTY = 0xFFFFFFFF,
  61. };
  62. enum hal_ssr_trigger_type {
  63. SSR_ERR_FATAL = 1,
  64. SSR_SW_DIV_BY_ZERO,
  65. SSR_HW_WDOG_IRQ,
  66. SSR_SESSION_ABORT,
  67. };
  68. enum hal_intra_refresh_mode {
  69. HAL_INTRA_REFRESH_NONE,
  70. HAL_INTRA_REFRESH_CYCLIC,
  71. HAL_INTRA_REFRESH_RANDOM,
  72. HAL_UNUSED_INTRA = 0x10000000,
  73. };
  74. enum cvp_resource_id {
  75. CVP_RESOURCE_NONE,
  76. CVP_RESOURCE_SYSCACHE,
  77. CVP_UNUSED_RESOURCE = 0x10000000,
  78. };
  79. struct cvp_resource_hdr {
  80. enum cvp_resource_id resource_id;
  81. void *resource_handle;
  82. };
  83. struct cvp_hal_fw_info {
  84. char version[CVP_VERSION_LENGTH];
  85. phys_addr_t base_addr;
  86. int register_base;
  87. int register_size;
  88. int irq;
  89. };
  90. enum hal_event_type {
  91. HAL_EVENT_SEQ_CHANGED_SUFFICIENT_RESOURCES,
  92. HAL_EVENT_SEQ_CHANGED_INSUFFICIENT_RESOURCES,
  93. HAL_EVENT_RELEASE_BUFFER_REFERENCE,
  94. HAL_UNUSED_SEQCHG = 0x10000000,
  95. };
  96. /* HAL Response */
  97. #define IS_HAL_SYS_CMD(cmd) ((cmd) >= HAL_SYS_INIT_DONE && \
  98. (cmd) <= HAL_SYS_ERROR)
  99. #define IS_HAL_SESSION_CMD(cmd) ((cmd) >= HAL_SESSION_EVENT_CHANGE && \
  100. (cmd) <= HAL_SESSION_ERROR)
  101. enum hal_command_response {
  102. HAL_NO_RESP,
  103. HAL_SYS_INIT_DONE,
  104. HAL_SYS_SET_RESOURCE_DONE,
  105. HAL_SYS_RELEASE_RESOURCE_DONE,
  106. HAL_SYS_PING_ACK_DONE,
  107. HAL_SYS_PC_PREP_DONE,
  108. HAL_SYS_IDLE,
  109. HAL_SYS_DEBUG,
  110. HAL_SYS_WATCHDOG_TIMEOUT,
  111. HAL_SYS_ERROR,
  112. /* SESSION COMMANDS_DONE */
  113. HAL_SESSION_EVENT_CHANGE,
  114. HAL_SESSION_INIT_DONE,
  115. HAL_SESSION_END_DONE,
  116. HAL_SESSION_SET_BUFFER_DONE,
  117. HAL_SESSION_ABORT_DONE,
  118. HAL_SESSION_STOP_DONE,
  119. HAL_SESSION_CVP_OPERATION_CONFIG,
  120. HAL_SESSION_FLUSH_DONE,
  121. HAL_SESSION_SUSPEND_DONE,
  122. HAL_SESSION_RESUME_DONE,
  123. HAL_SESSION_SET_PROP_DONE,
  124. HAL_SESSION_GET_PROP_DONE,
  125. HAL_SESSION_RELEASE_BUFFER_DONE,
  126. HAL_SESSION_REGISTER_BUFFER_DONE,
  127. HAL_SESSION_UNREGISTER_BUFFER_DONE,
  128. HAL_SESSION_RELEASE_RESOURCE_DONE,
  129. HAL_SESSION_PROPERTY_INFO,
  130. HAL_SESSION_DUMP_NOTIFY,
  131. HAL_SESSION_ERROR,
  132. HAL_RESPONSE_UNUSED = 0x10000000,
  133. };
  134. struct msm_cvp_capability {
  135. u32 reserved[183];
  136. };
  137. struct cvp_hal_sys_init_done {
  138. u32 dec_codec_supported;
  139. u32 enc_codec_supported;
  140. u32 codec_count;
  141. struct msm_cvp_capability *capabilities;
  142. u32 max_sessions_supported;
  143. };
  144. struct cvp_hal_session_init_done {
  145. struct msm_cvp_capability capability;
  146. };
  147. struct msm_cvp_cb_cmd_done {
  148. u32 device_id;
  149. void *session_id;
  150. enum cvp_status status;
  151. u32 size;
  152. union {
  153. struct cvp_hfi_msg_session_hdr msg_hdr;
  154. struct cvp_resource_hdr resource_hdr;
  155. struct cvp_hal_sys_init_done sys_init_done;
  156. struct cvp_hal_session_init_done session_init_done;
  157. u32 buffer_addr;
  158. } data;
  159. };
  160. struct msm_cvp_cb_data_done {
  161. u32 device_id;
  162. void *session_id;
  163. enum cvp_status status;
  164. u32 size;
  165. u32 client_data;
  166. };
  167. struct msm_cvp_cb_info {
  168. enum hal_command_response response_type;
  169. union {
  170. struct msm_cvp_cb_cmd_done cmd;
  171. struct msm_cvp_cb_data_done data;
  172. } response;
  173. };
  174. enum msm_cvp_hfi_type {
  175. CVP_HFI_IRIS,
  176. };
  177. enum msm_cvp_thermal_level {
  178. CVP_THERMAL_NORMAL = 0,
  179. CVP_THERMAL_LOW,
  180. CVP_THERMAL_HIGH,
  181. CVP_THERMAL_CRITICAL
  182. };
  183. struct msm_cvp_gov_data {
  184. struct cvp_bus_vote_data *data;
  185. u32 data_count;
  186. };
  187. enum msm_cvp_power_mode {
  188. CVP_POWER_NORMAL = 0,
  189. CVP_POWER_LOW,
  190. CVP_POWER_TURBO
  191. };
  192. struct cvp_bus_vote_data {
  193. u32 domain;
  194. u32 ddr_bw;
  195. u32 sys_cache_bw;
  196. enum msm_cvp_power_mode power_mode;
  197. bool use_sys_cache;
  198. };
  199. struct cvp_hal_cmd_sys_get_property_packet {
  200. u32 size;
  201. u32 packet_type;
  202. u32 num_properties;
  203. u32 rg_property_data[1];
  204. };
  205. #define call_hfi_op(q, op, args...) \
  206. (((q) && (q)->op) ? ((q)->op(args)) : 0)
  207. struct msm_cvp_hfi_defs {
  208. unsigned int size;
  209. unsigned int type;
  210. bool is_config_pkt;
  211. enum hal_command_response resp;
  212. };
  213. struct cvp_hfi_device {
  214. void *hfi_device_data;
  215. /*Add function pointers for all the hfi functions below*/
  216. int (*core_init)(void *device);
  217. int (*core_release)(void *device);
  218. int (*core_trigger_ssr)(void *device, enum hal_ssr_trigger_type);
  219. int (*session_init)(void *device, void *session_id, void **new_session);
  220. int (*session_end)(void *session);
  221. int (*session_abort)(void *session);
  222. int (*session_set_buffers)(void *sess, u32 iova, u32 size);
  223. int (*session_release_buffers)(void *sess);
  224. int (*session_send)(void *sess, struct eva_kmd_hfi_packet *in_pkt);
  225. int (*session_flush)(void *sess);
  226. int (*scale_clocks)(void *dev, u32 freq);
  227. int (*vote_bus)(void *dev, struct cvp_bus_vote_data *data,
  228. int num_data);
  229. int (*get_fw_info)(void *dev, struct cvp_hal_fw_info *fw_info);
  230. int (*session_clean)(void *sess);
  231. int (*get_core_capabilities)(void *dev);
  232. int (*suspend)(void *dev);
  233. int (*resume)(void *dev);
  234. int (*flush_debug_queue)(void *dev);
  235. int (*noc_error_info)(void *dev);
  236. int (*validate_session)(void *sess, const char *func);
  237. };
  238. typedef void (*hfi_cmd_response_callback) (enum hal_command_response cmd,
  239. void *data);
  240. typedef void (*msm_cvp_callback) (enum hal_command_response response,
  241. void *callback);
  242. struct msm_cvp_fw {
  243. int cookie;
  244. };
  245. int cvp_hfi_process_msg_packet(u32 device_id,
  246. void *msg_hdr, struct msm_cvp_cb_info *info);
  247. enum cvp_status cvp_hfi_process_sys_init_done_prop_read(
  248. struct cvp_hfi_msg_sys_init_done_packet *pkt,
  249. struct cvp_hal_sys_init_done *sys_init_done);
  250. enum cvp_status hfi_process_session_init_done_prop_read(
  251. struct cvp_hfi_msg_sys_session_init_done_packet *pkt,
  252. struct cvp_hal_session_init_done *session_init_done);
  253. struct cvp_hfi_device *cvp_hfi_initialize(enum msm_cvp_hfi_type hfi_type,
  254. u32 device_id, struct msm_cvp_platform_resources *res,
  255. hfi_cmd_response_callback callback);
  256. void cvp_hfi_deinitialize(enum msm_cvp_hfi_type hfi_type,
  257. struct cvp_hfi_device *hdev);
  258. int get_pkt_index(struct cvp_hal_session_cmd_pkt *hdr);
  259. int get_pkt_array_size(void);
  260. int get_hfi_version(void);
  261. unsigned int get_msg_size(struct cvp_hfi_msg_session_hdr *hdr);
  262. unsigned int get_msg_session_id(void *msg);
  263. unsigned int get_msg_errorcode(void *msg);
  264. int get_msg_opconfigs(void *msg, unsigned int *session_id,
  265. unsigned int *error_type, unsigned int *config_id);
  266. extern const struct msm_cvp_hfi_defs cvp_hfi_defs[];
  267. #endif /*__CVP_HFI_API_H__ */