cam_isp.h 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994
  1. /* SPDX-License-Identifier: GPL-2.0-only WITH Linux-syscall-note */
  2. /*
  3. * Copyright (c) 2016-2021, The Linux Foundation. All rights reserved.
  4. */
  5. #ifndef __UAPI_CAM_ISP_H__
  6. #define __UAPI_CAM_ISP_H__
  7. #include <media/cam_defs.h>
  8. #include <media/cam_isp_vfe.h>
  9. #include <media/cam_isp_ife.h>
  10. #include <media/cam_isp_sfe.h>
  11. #include <media/cam_cpas.h>
  12. /* ISP driver name */
  13. #define CAM_ISP_DEV_NAME "cam-isp"
  14. /* HW type */
  15. #define CAM_ISP_HW_BASE 0
  16. #define CAM_ISP_HW_CSID 1
  17. #define CAM_ISP_HW_VFE 2
  18. #define CAM_ISP_HW_IFE 3
  19. #define CAM_ISP_HW_ISPIF 4
  20. #define CAM_ISP_HW_IFE_LITE 5
  21. #define CAM_ISP_HW_CSID_LITE 6
  22. #define CAM_ISP_HW_SFE 7
  23. #define CAM_ISP_HW_MAX 8
  24. /* Color Pattern */
  25. #define CAM_ISP_PATTERN_BAYER_RGRGRG 0
  26. #define CAM_ISP_PATTERN_BAYER_GRGRGR 1
  27. #define CAM_ISP_PATTERN_BAYER_BGBGBG 2
  28. #define CAM_ISP_PATTERN_BAYER_GBGBGB 3
  29. #define CAM_ISP_PATTERN_YUV_YCBYCR 4
  30. #define CAM_ISP_PATTERN_YUV_YCRYCB 5
  31. #define CAM_ISP_PATTERN_YUV_CBYCRY 6
  32. #define CAM_ISP_PATTERN_YUV_CRYCBY 7
  33. #define CAM_ISP_PATTERN_MAX 8
  34. /* Usage Type */
  35. #define CAM_ISP_RES_USAGE_SINGLE 0
  36. #define CAM_ISP_RES_USAGE_DUAL 1
  37. #define CAM_ISP_RES_USAGE_MAX 2
  38. /* Resource ID */
  39. #define CAM_ISP_RES_ID_PORT 0
  40. #define CAM_ISP_RES_ID_CLK 1
  41. #define CAM_ISP_RES_ID_MAX 2
  42. /* Resource Type - Type of resource for the resource id
  43. * defined in cam_isp_vfe.h, cam_isp_ife.h
  44. */
  45. /* Lane Type in input resource for Port */
  46. #define CAM_ISP_LANE_TYPE_DPHY 0
  47. #define CAM_ISP_LANE_TYPE_CPHY 1
  48. #define CAM_ISP_LANE_TYPE_MAX 2
  49. /* ISP Resurce Composite Group ID */
  50. #define CAM_ISP_RES_COMP_GROUP_NONE 0
  51. #define CAM_ISP_RES_COMP_GROUP_ID_0 1
  52. #define CAM_ISP_RES_COMP_GROUP_ID_1 2
  53. #define CAM_ISP_RES_COMP_GROUP_ID_2 3
  54. #define CAM_ISP_RES_COMP_GROUP_ID_3 4
  55. #define CAM_ISP_RES_COMP_GROUP_ID_4 5
  56. #define CAM_ISP_RES_COMP_GROUP_ID_5 6
  57. #define CAM_ISP_RES_COMP_GROUP_ID_MAX 6
  58. /* ISP packet opcode for ISP */
  59. #define CAM_ISP_PACKET_OP_BASE 0
  60. #define CAM_ISP_PACKET_INIT_DEV 1
  61. #define CAM_ISP_PACKET_UPDATE_DEV 2
  62. #define CAM_ISP_PACKET_OP_MAX 3
  63. /* ISP packet meta_data type for command buffer */
  64. #define CAM_ISP_PACKET_META_BASE 0
  65. #define CAM_ISP_PACKET_META_LEFT 1
  66. #define CAM_ISP_PACKET_META_RIGHT 2
  67. #define CAM_ISP_PACKET_META_COMMON 3
  68. #define CAM_ISP_PACKET_META_DMI_LEFT 4
  69. #define CAM_ISP_PACKET_META_DMI_RIGHT 5
  70. #define CAM_ISP_PACKET_META_DMI_COMMON 6
  71. #define CAM_ISP_PACKET_META_CLOCK 7
  72. #define CAM_ISP_PACKET_META_CSID 8
  73. #define CAM_ISP_PACKET_META_DUAL_CONFIG 9
  74. #define CAM_ISP_PACKET_META_GENERIC_BLOB_LEFT 10
  75. #define CAM_ISP_PACKET_META_GENERIC_BLOB_RIGHT 11
  76. #define CAM_ISP_PACKET_META_GENERIC_BLOB_COMMON 12
  77. #define CAM_ISP_PACKET_META_REG_DUMP_PER_REQUEST 13
  78. #define CAM_ISP_PACKET_META_REG_DUMP_ON_FLUSH 14
  79. #define CAM_ISP_PACKET_META_REG_DUMP_ON_ERROR 15
  80. #define CAM_ISP_PACKET_META_CSID_LEFT 16
  81. #define CAM_ISP_PACKET_META_CSID_RIGHT 17
  82. #define CAM_ISP_PACKET_META_CSID_COMMON 18
  83. /* SFE packet meta_data type for command buffer */
  84. #define CAM_ISP_SFE_PACKET_META_LEFT 0x15
  85. #define CAM_ISP_SFE_PACKET_META_RIGHT 0x16
  86. #define CAM_ISP_SFE_PACKET_META_COMMON 0x17
  87. #define CAM_ISP_SFE_PACKET_META_DUAL_CONFIG 0x18
  88. /* DSP mode */
  89. #define CAM_ISP_DSP_MODE_NONE 0
  90. #define CAM_ISP_DSP_MODE_ONE_WAY 1
  91. #define CAM_ISP_DSP_MODE_ROUND 2
  92. /* ISP Generic Cmd Buffer Blob types */
  93. #define CAM_ISP_GENERIC_BLOB_TYPE_HFR_CONFIG 0
  94. #define CAM_ISP_GENERIC_BLOB_TYPE_CLOCK_CONFIG 1
  95. #define CAM_ISP_GENERIC_BLOB_TYPE_BW_CONFIG 2
  96. #define CAM_ISP_GENERIC_BLOB_TYPE_UBWC_CONFIG 3
  97. #define CAM_ISP_GENERIC_BLOB_TYPE_CSID_CLOCK_CONFIG 4
  98. #define CAM_ISP_GENERIC_BLOB_TYPE_FE_CONFIG 5
  99. #define CAM_ISP_GENERIC_BLOB_TYPE_UBWC_CONFIG_V2 6
  100. #define CAM_ISP_GENERIC_BLOB_TYPE_IFE_CORE_CONFIG 7
  101. #define CAM_ISP_GENERIC_BLOB_TYPE_VFE_OUT_CONFIG 8
  102. #define CAM_ISP_GENERIC_BLOB_TYPE_BW_CONFIG_V2 9
  103. #define CAM_ISP_GENERIC_BLOB_TYPE_DISCARD_INITIAL_FRAMES 10
  104. #define CAM_ISP_GENERIC_BLOB_TYPE_SENSOR_DIMENSION_CONFIG 11
  105. #define CAM_ISP_GENERIC_BLOB_TYPE_CSID_QCFA_CONFIG 12
  106. #define CAM_ISP_GENERIC_BLOB_TYPE_SENSOR_BLANKING_CONFIG 13
  107. #define CAM_ISP_GENERIC_BLOB_TYPE_TPG_CORE_CONFIG 14
  108. #define CAM_ISP_GENERIC_BLOB_TYPE_DYNAMIC_MODE_SWITCH 15
  109. #define CAM_ISP_GENERIC_BLOB_TYPE_BW_LIMITER_CFG 16
  110. #define CAM_ISP_GENERIC_BLOB_TYPE_FPS_CONFIG 17
  111. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_CLOCK_CONFIG 21
  112. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_CORE_CONFIG 22
  113. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_OUT_CONFIG 23
  114. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_HFR_CONFIG 24
  115. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_FE_CONFIG 25
  116. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_SCRATCH_BUF_CFG 26
  117. #define CAM_ISP_GENERIC_BLOB_TYPE_SFE_EXP_ORDER_CFG 27
  118. #define CAM_ISP_VC_DT_CFG 4
  119. #define CAM_ISP_IFE0_HW 0x1
  120. #define CAM_ISP_IFE1_HW 0x2
  121. #define CAM_ISP_IFE0_LITE_HW 0x4
  122. #define CAM_ISP_IFE1_LITE_HW 0x8
  123. #define CAM_ISP_IFE2_LITE_HW 0x10
  124. #define CAM_ISP_IFE3_LITE_HW 0x20
  125. #define CAM_ISP_IFE4_LITE_HW 0x40
  126. #define CAM_ISP_IFE2_HW 0x100
  127. #define CAM_ISP_SFE0_HW 0x1000
  128. #define CAM_ISP_SFE1_HW 0x2000
  129. #define CAM_ISP_PXL_PATH 0x1
  130. #define CAM_ISP_PPP_PATH 0x2
  131. #define CAM_ISP_LCR_PATH 0x4
  132. #define CAM_ISP_RDI0_PATH 0x8
  133. #define CAM_ISP_RDI1_PATH 0x10
  134. #define CAM_ISP_RDI2_PATH 0x20
  135. #define CAM_ISP_RDI3_PATH 0x40
  136. /* Per Path Usage Data */
  137. #define CAM_ISP_USAGE_INVALID 0
  138. #define CAM_ISP_USAGE_LEFT_PX 1
  139. #define CAM_ISP_USAGE_RIGHT_PX 2
  140. #define CAM_ISP_USAGE_RDI 3
  141. #define CAM_ISP_USAGE_SFE_LEFT 4
  142. #define CAM_ISP_USAGE_SFE_RIGHT 5
  143. #define CAM_ISP_USAGE_SFE_RDI 6
  144. /* Acquire with custom hw */
  145. #define CAM_ISP_ACQ_CUSTOM_NONE 0
  146. #define CAM_ISP_ACQ_CUSTOM_PRIMARY 1
  147. #define CAM_ISP_ACQ_CUSTOM_SECONDARY 2
  148. #define CAM_IFE_CSID_RDI_MAX 5
  149. /* Feature Flag indicators */
  150. #define CAM_ISP_PARAM_FETCH_SECURITY_MODE BIT(0)
  151. #define CAM_ISP_CAN_USE_LITE_MODE BIT(1)
  152. #define CAM_ISP_DYNAMIC_SENOR_SWITCH_EN BIT(2)
  153. #define CAM_ISP_SFE_BINNED_EPOCH_CFG_ENABLE BIT(3)
  154. #define CAM_ISP_EPD_SUPPORT BIT(4)
  155. #define CAM_ISP_SFE_FS_MODE_EN BIT(5)
  156. /* ISP core cfg flag params */
  157. #define CAM_ISP_PARAM_CORE_CFG_HDR_MUX_SEL BIT(0)
  158. #define CAM_ISP_PARAM_CORE_CFG_PP_FORMAT BIT(16)
  159. /* Query devices */
  160. /**
  161. * struct cam_isp_dev_cap_info - A cap info for particular hw type
  162. *
  163. * @hw_type: Hardware type for the cap info
  164. * @num_hw: Number of HW of type @hw_type
  165. * @hw_version: Hardware version
  166. *
  167. */
  168. struct cam_isp_dev_cap_info {
  169. __u32 hw_type;
  170. __u32 num_hw;
  171. struct cam_hw_version hw_version;
  172. };
  173. /**
  174. * struct cam_isp_query_cap_cmd - ISP query device capability payload
  175. *
  176. * @device_iommu: returned iommu handles for device
  177. * @cdm_iommu: returned iommu handles for cdm
  178. * @num_dev: returned number of device capabilities
  179. * @reserved: reserved field for alignment
  180. * @dev_caps: returned device capability array
  181. *
  182. */
  183. struct cam_isp_query_cap_cmd {
  184. struct cam_iommu_handle device_iommu;
  185. struct cam_iommu_handle cdm_iommu;
  186. __s32 num_dev;
  187. __u32 reserved;
  188. struct cam_isp_dev_cap_info dev_caps[CAM_ISP_HW_MAX];
  189. };
  190. /* Acquire Device */
  191. /**
  192. * struct cam_isp_out_port_info - An output port resource info
  193. *
  194. * @res_type: output resource type defined in file
  195. * cam_isp_vfe.h or cam_isp_ife.h
  196. * @format: output format of the resource
  197. * @wdith: output width in pixels
  198. * @height: output height in lines
  199. * @comp_grp_id: composite group id for the resource.
  200. * @split_point: split point in pixels for the dual VFE.
  201. * @secure_mode: flag to tell if output should be run in secure
  202. * mode or not. See cam_defs.h for definition
  203. * @reserved: reserved field for alignment
  204. *
  205. */
  206. struct cam_isp_out_port_info {
  207. __u32 res_type;
  208. __u32 format;
  209. __u32 width;
  210. __u32 height;
  211. __u32 comp_grp_id;
  212. __u32 split_point;
  213. __u32 secure_mode;
  214. __u32 reserved;
  215. };
  216. /**
  217. * struct cam_isp_out_port_info_v2 - An output port resource info
  218. *
  219. * @res_type: output resource type defined in file
  220. * cam_isp_vfe.h or cam_isp_ife.h
  221. * @format: output format of the resource
  222. * @wdith: output width in pixels
  223. * @height: output height in lines
  224. * @comp_grp_id: composite group id for the resource.
  225. * @split_point: split point in pixels for the dual VFE.
  226. * @secure_mode: flag to tell if output should be run in secure
  227. * mode or not. See cam_defs.h for definition
  228. * @wm_mode: WM mode
  229. * @out_port_res1: Output reserved field
  230. * @out_port_res2: Output reserved field
  231. *
  232. */
  233. struct cam_isp_out_port_info_v2 {
  234. __u32 res_type;
  235. __u32 format;
  236. __u32 width;
  237. __u32 height;
  238. __u32 comp_grp_id;
  239. __u32 split_point;
  240. __u32 secure_mode;
  241. __u32 wm_mode;
  242. __u32 out_port_res1;
  243. __u32 out_port_res2;
  244. };
  245. /**
  246. * struct cam_isp_in_port_info - An input port resource info
  247. *
  248. * @res_type: input resource type define in file
  249. * cam_isp_vfe.h or cam_isp_ife.h
  250. * @lane_type: lane type: c-phy or d-phy.
  251. * @lane_num: active lane number
  252. * @lane_cfg: lane configurations: 4 bits per lane
  253. * @vc: input virtual channel number
  254. * @dt: input data type number
  255. * @format: input format
  256. * @test_pattern: test pattern for the testgen
  257. * @usage_type: whether dual vfe is required
  258. * @left_start: left input start offset in pixels
  259. * @left_stop: left input stop offset in pixels
  260. * @left_width: left input width in pixels
  261. * @right_start: right input start offset in pixels.
  262. * Only for Dual VFE
  263. * @right_stop: right input stop offset in pixels.
  264. * Only for Dual VFE
  265. * @right_width: right input width in pixels.
  266. * Only for dual VFE
  267. * @line_start: top of the line number
  268. * @line_stop: bottome of the line number
  269. * @height: input height in lines
  270. * @pixel_clk; sensor output clock
  271. * @batch_size: batch size for HFR mode
  272. * @dsp_mode: DSP stream mode (Defines as CAM_ISP_DSP_MODE_*)
  273. * @hbi_cnt: HBI count for the camif input
  274. * @reserved: Reserved field for alignment
  275. * @num_out_res: number of the output resource associated
  276. * @data: payload that contains the output resources
  277. *
  278. */
  279. struct cam_isp_in_port_info {
  280. __u32 res_type;
  281. __u32 lane_type;
  282. __u32 lane_num;
  283. __u32 lane_cfg;
  284. __u32 vc;
  285. __u32 dt;
  286. __u32 format;
  287. __u32 test_pattern;
  288. __u32 usage_type;
  289. __u32 left_start;
  290. __u32 left_stop;
  291. __u32 left_width;
  292. __u32 right_start;
  293. __u32 right_stop;
  294. __u32 right_width;
  295. __u32 line_start;
  296. __u32 line_stop;
  297. __u32 height;
  298. __u32 pixel_clk;
  299. __u32 batch_size;
  300. __u32 dsp_mode;
  301. __u32 hbi_cnt;
  302. __u32 reserved;
  303. __u32 num_out_res;
  304. struct cam_isp_out_port_info data[1];
  305. };
  306. /**
  307. * struct cam_isp_in_port_info_v2 - An input port resource info
  308. *
  309. * @res_type: input resource type define in file
  310. * cam_isp_vfe.h or cam_isp_ife.h
  311. * @lane_type: lane type: c-phy or d-phy.
  312. * @lane_num: active lane number
  313. * @lane_cfg: lane configurations: 4 bits per lane
  314. * @vc: input virtual channel number
  315. * @dt: input data type number
  316. * @num_valid_vc_dt: valid vc and dt in array
  317. * @format: input format
  318. * @test_pattern: test pattern for the testgen
  319. * @usage_type: whether dual vfe is required
  320. * @left_start: left input start offset in pixels
  321. * @left_stop: left input stop offset in pixels
  322. * @left_width: left input width in pixels
  323. * @right_start: right input start offset in pixels.
  324. * Only for Dual VFE
  325. * @right_stop: right input stop offset in pixels.
  326. * only for Dual VFE
  327. * @right_width: right input width in pixels.
  328. * only for dual VFE
  329. * @line_start: top of the line number
  330. * @line_stop: bottome of the line number
  331. * @height: input height in lines
  332. * @pixel_clk; sensor output clock
  333. * @batch_size: batch size for HFR mode
  334. * @dsp_mode: DSP stream mode (Defines as CAM_ISP_DSP_MODE_*)
  335. * @hbi_cnt: HBI count for the camif input
  336. * @cust_node: if any custom HW block is present before IFE
  337. * @num_out_res: number of the output resource associated
  338. * @horizontal_bin: Horizontal Binning info
  339. * @qcfa_bin: Quadra Binning info
  340. * @sfe_in_path_type: SFE input path type
  341. * 0:15 - refer to cam_isp_sfe.h for SFE paths
  342. * 16:31 - Corresponding IFE i/p path type
  343. * Example:((CAM_ISP_PXL_PATH << 16) |
  344. * CAM_ISP_SFE_INLINE_PIX)
  345. * This will acquire SFE inline IPP and IFE IPP
  346. * PPP is an exception CSID PPP -> IFE PPP
  347. * @feature_flag: See the macros defined under feature flag above
  348. * @ife_res_1: payload for future use.
  349. * @ife_res_2: payload for future use.
  350. * @data: payload that contains the output resources
  351. *
  352. */
  353. struct cam_isp_in_port_info_v2 {
  354. __u32 res_type;
  355. __u32 lane_type;
  356. __u32 lane_num;
  357. __u32 lane_cfg;
  358. __u32 vc[CAM_ISP_VC_DT_CFG];
  359. __u32 dt[CAM_ISP_VC_DT_CFG];
  360. __u32 num_valid_vc_dt;
  361. __u32 format;
  362. __u32 test_pattern;
  363. __u32 usage_type;
  364. __u32 left_start;
  365. __u32 left_stop;
  366. __u32 left_width;
  367. __u32 right_start;
  368. __u32 right_stop;
  369. __u32 right_width;
  370. __u32 line_start;
  371. __u32 line_stop;
  372. __u32 height;
  373. __u32 pixel_clk;
  374. __u32 batch_size;
  375. __u32 dsp_mode;
  376. __u32 hbi_cnt;
  377. __u32 cust_node;
  378. __u32 num_out_res;
  379. __u32 offline_mode;
  380. __u32 horizontal_bin;
  381. __u32 qcfa_bin;
  382. __u32 sfe_in_path_type;
  383. __u32 feature_flag;
  384. __u32 ife_res_1;
  385. __u32 ife_res_2;
  386. struct cam_isp_out_port_info_v2 data[1];
  387. };
  388. /**
  389. * struct cam_isp_resource - A resource bundle
  390. *
  391. * @resoruce_id: resource id for the resource bundle
  392. * @length: length of the while resource blob
  393. * @handle_type: type of the resource handle
  394. * @reserved: reserved field for alignment
  395. * @res_hdl: resource handle that points to the
  396. * resource array;
  397. *
  398. */
  399. struct cam_isp_resource {
  400. __u32 resource_id;
  401. __u32 length;
  402. __u32 handle_type;
  403. __u32 reserved;
  404. __u64 res_hdl;
  405. };
  406. /**
  407. * struct cam_isp_port_hfr_config - HFR configuration for this port
  408. *
  409. * @resource_type: Resource type
  410. * @subsample_pattern: Subsample pattern. Used in HFR mode. It
  411. * should be consistent with batchSize and
  412. * CAMIF programming.
  413. * @subsample_period: Subsample period. Used in HFR mode. It
  414. * should be consistent with batchSize and
  415. * CAMIF programming.
  416. * @framedrop_pattern: Framedrop pattern
  417. * @framedrop_period: Framedrop period
  418. * @reserved: Reserved for alignment
  419. */
  420. struct cam_isp_port_hfr_config {
  421. __u32 resource_type;
  422. __u32 subsample_pattern;
  423. __u32 subsample_period;
  424. __u32 framedrop_pattern;
  425. __u32 framedrop_period;
  426. __u32 reserved;
  427. } __attribute__((packed));
  428. /**
  429. * struct cam_isp_resource_hfr_config - Resource HFR configuration
  430. *
  431. * @num_ports: Number of ports
  432. * @reserved: Reserved for alignment
  433. * @port_hfr_config: HFR configuration for each IO port
  434. */
  435. struct cam_isp_resource_hfr_config {
  436. __u32 num_ports;
  437. __u32 reserved;
  438. struct cam_isp_port_hfr_config port_hfr_config[1];
  439. } __attribute__((packed));
  440. /**
  441. * struct cam_isp_dual_split_params - dual isp spilt parameters
  442. *
  443. * @split_point: Split point information x, where (0 < x < width)
  444. * left ISP's input ends at x + righ padding and
  445. * Right ISP's input starts at x - left padding
  446. * @right_padding: Padding added past the split point for left
  447. * ISP's input
  448. * @left_padding: Padding added before split point for right
  449. * ISP's input
  450. * @reserved: Reserved filed for alignment
  451. *
  452. */
  453. struct cam_isp_dual_split_params {
  454. __u32 split_point;
  455. __u32 right_padding;
  456. __u32 left_padding;
  457. __u32 reserved;
  458. };
  459. /**
  460. * struct cam_isp_dual_stripe_config - stripe config per bus client
  461. *
  462. * @offset: Start horizontal offset relative to
  463. * output buffer
  464. * In UBWC mode, this value indicates the H_INIT
  465. * value in pixel
  466. * @width: Width of the stripe in bytes
  467. * @tileconfig Ubwc meta tile config. Contain the partial
  468. * tile info
  469. * @port_id: port id of ISP output
  470. *
  471. */
  472. struct cam_isp_dual_stripe_config {
  473. __u32 offset;
  474. __u32 width;
  475. __u32 tileconfig;
  476. __u32 port_id;
  477. };
  478. /**
  479. * struct cam_isp_dual_config - dual isp configuration
  480. *
  481. * @num_ports Number of isp output ports
  482. * @reserved Reserved field for alignment
  483. * @split_params: Inpput split parameters
  484. * @stripes: Stripe information
  485. *
  486. */
  487. struct cam_isp_dual_config {
  488. __u32 num_ports;
  489. __u32 reserved;
  490. struct cam_isp_dual_split_params split_params;
  491. struct cam_isp_dual_stripe_config stripes[1];
  492. } __attribute__((packed));
  493. /**
  494. * struct cam_isp_clock_config - Clock configuration
  495. *
  496. * @usage_type: Usage type (Single/Dual)
  497. * @num_rdi: Number of RDI votes
  498. * @left_pix_hz: Pixel Clock for Left ISP
  499. * @right_pix_hz: Pixel Clock for Right ISP, valid only if Dual
  500. * @rdi_hz: RDI Clock. ISP clock will be max of RDI and
  501. * PIX clocks. For a particular context which ISP
  502. * HW the RDI is allocated to is not known to UMD.
  503. * Hence pass the clock and let KMD decide.
  504. */
  505. struct cam_isp_clock_config {
  506. __u32 usage_type;
  507. __u32 num_rdi;
  508. __u64 left_pix_hz;
  509. __u64 right_pix_hz;
  510. __u64 rdi_hz[1];
  511. } __attribute__((packed));
  512. /**
  513. * struct cam_isp_csid_clock_config - CSID clock configuration
  514. *
  515. * @csid_clock CSID clock
  516. */
  517. struct cam_isp_csid_clock_config {
  518. __u64 csid_clock;
  519. } __attribute__((packed));
  520. /**
  521. * struct cam_isp_csid_qcfa_config - CSID qcfa binning support configuration
  522. *
  523. * @csid_binning CSID binning
  524. */
  525. struct cam_isp_csid_qcfa_config {
  526. __u32 csid_binning;
  527. } __attribute__((packed));
  528. /**
  529. * struct cam_isp_bw_vote - Bandwidth vote information
  530. *
  531. * @resource_id: Resource ID
  532. * @reserved: Reserved field for alignment
  533. * @cam_bw_bps: Bandwidth vote for CAMNOC
  534. * @ext_bw_bps: Bandwidth vote for path-to-DDR after CAMNOC
  535. */
  536. struct cam_isp_bw_vote {
  537. __u32 resource_id;
  538. __u32 reserved;
  539. __u64 cam_bw_bps;
  540. __u64 ext_bw_bps;
  541. } __attribute__((packed));
  542. /**
  543. * struct cam_isp_bw_config - Bandwidth configuration
  544. *
  545. * @usage_type: Usage type (Single/Dual)
  546. * @num_rdi: Number of RDI votes
  547. * @left_pix_vote: Bandwidth vote for left ISP
  548. * @right_pix_vote: Bandwidth vote for right ISP
  549. * @rdi_vote: RDI bandwidth requirements
  550. */
  551. struct cam_isp_bw_config {
  552. __u32 usage_type;
  553. __u32 num_rdi;
  554. struct cam_isp_bw_vote left_pix_vote;
  555. struct cam_isp_bw_vote right_pix_vote;
  556. struct cam_isp_bw_vote rdi_vote[1];
  557. } __attribute__((packed));
  558. /**
  559. * struct cam_isp_bw_config_v2 - Bandwidth configuration
  560. *
  561. * @usage_type: Usage type (Single/Dual)
  562. * @num_paths: Number of axi data paths
  563. * @axi_path Per path vote info
  564. */
  565. struct cam_isp_bw_config_v2 {
  566. __u32 usage_type;
  567. __u32 num_paths;
  568. struct cam_axi_per_path_bw_vote axi_path[1];
  569. } __attribute__((packed));
  570. /**
  571. * struct cam_fe_config - Fetch Engine configuration
  572. *
  573. * @version: fetch engine veriosn
  574. * @min_vbi: require min vbi
  575. * @fs_mode: indicates if fs mode enabled
  576. * @fs_line_sync_en: frame level sync or line level
  577. * sync for fetch engine
  578. * @hbi_count: hbi count
  579. * @fs_sync_enable: indicates if fetch engine working
  580. * wokring in sync with write engine
  581. * @go_cmd_sel: softwrae go_cmd or hw go_cmd
  582. * @client_enable: enable read engine
  583. * @source_addr: adrress of buffer to read from
  584. * @width: buffer width
  585. * @height: buffer height
  586. * @stride: buffer stride (here equal to width)
  587. * @format: format of image in buffer
  588. * @unpacker_cfg: unpacker config type
  589. * @latency_buf_size: latency buffer for read engine
  590. */
  591. struct cam_fe_config {
  592. __u64 version;
  593. __u32 min_vbi;
  594. __u32 fs_mode;
  595. __u32 fs_line_sync_en;
  596. __u32 hbi_count;
  597. __u32 fs_sync_enable;
  598. __u32 go_cmd_sel;
  599. __u32 client_enable;
  600. __u32 source_addr;
  601. __u32 width;
  602. __u32 height;
  603. __u32 stride;
  604. __u32 format;
  605. __u32 unpacker_cfg;
  606. __u32 latency_buf_size;
  607. } __attribute__((packed));
  608. /**
  609. * struct cam_isp_sensor_path_dimension
  610. *
  611. * @width expected width
  612. * @height expected height
  613. * @measure_enabled flag to indicate if pixel measurement is to be enabled
  614. */
  615. struct cam_isp_sensor_dimension {
  616. __u32 width;
  617. __u32 height;
  618. __u32 measure_enabled;
  619. } __attribute__((packed));
  620. /**
  621. * struct cam_isp_sensor_blanking_config
  622. *
  623. * @hbi HBI value
  624. * @vbi VBI value
  625. */
  626. struct cam_isp_sensor_blanking_config {
  627. __u32 hbi;
  628. __u32 vbi;
  629. } __attribute__((packed));
  630. /**
  631. * struct cam_isp_sensor_config - Sensor Dimension configuration
  632. *
  633. * @ppp_path: expected ppp path configuration
  634. * @ipp_path: expected ipp path configuration
  635. * @rdi_path: expected rdi path configuration
  636. * @hbi: HBI value
  637. * @vbi: VBI value
  638. */
  639. struct cam_isp_sensor_config {
  640. struct cam_isp_sensor_dimension ppp_path;
  641. struct cam_isp_sensor_dimension ipp_path;
  642. struct cam_isp_sensor_dimension rdi_path[CAM_IFE_CSID_RDI_MAX];
  643. __u32 hbi;
  644. __u32 vbi;
  645. } __attribute__((packed));
  646. /**
  647. * struct cam_isp_core_config - ISP core registers configuration
  648. *
  649. * @version: Version info
  650. * @vid_ds16_r2pd: Enables Y and C merging PD output for video DS16
  651. * @vid_ds4_r2pd: Enables Y and C merging PD output for video DS4
  652. * @disp_ds16_r2pd: Enables Y and C merging PD output for disp DS16
  653. * @disp_ds4_r2pd: Enables Y and C merging PD output for disp DS4
  654. * @dsp_streaming_tap_point: This selects source for DSP streaming interface
  655. * @ihist_src_sel: Selects input for IHIST module
  656. * @hdr_be_src_sel: Selects input for HDR BE module
  657. * @hdr_bhist_src_sel: Selects input for HDR BHIST module
  658. * @input_mux_sel_pdaf: Selects input for PDAF
  659. * @input_mux_sel_pp: Selects input for Pixel Pipe
  660. * @core_cfg_flag: Core config flag to set HDR mux/PP
  661. * input format type
  662. */
  663. struct cam_isp_core_config {
  664. __u32 version;
  665. __u32 vid_ds16_r2pd;
  666. __u32 vid_ds4_r2pd;
  667. __u32 disp_ds16_r2pd;
  668. __u32 disp_ds4_r2pd;
  669. __u32 dsp_streaming_tap_point;
  670. __u32 ihist_src_sel;
  671. __u32 hdr_be_src_sel;
  672. __u32 hdr_bhist_src_sel;
  673. __u32 input_mux_sel_pdaf;
  674. __u32 input_mux_sel_pp;
  675. __u32 core_cfg_flag;
  676. } __attribute__((packed));
  677. /**
  678. * struct cam_isp_sfe_core_config - SFE core registers configuration
  679. *
  680. * @version : Version info
  681. * @mode_sel : Selects core for sHDR/non-sHDR mode
  682. * @ops_mode_cfg : Selects core if is inline/offline mode
  683. * @fs_mode_cfg : Selects output in fast shutter mode
  684. * @sfe_params : SFE params for future use
  685. */
  686. struct cam_isp_sfe_core_config {
  687. __u32 version;
  688. __u32 mode_sel;
  689. __u32 ops_mode_cfg;
  690. __u32 fs_mode_cfg;
  691. __u32 sfe_params[6];
  692. } __attribute__((packed));
  693. /**
  694. * struct cam_isp_sfe_scratch_buf_info - Scratch buf info
  695. *
  696. * @mem_handle : Scratch buffer handle
  697. * @offset : Offset to the buffer
  698. * @width : Width in pixels
  699. * @height : Height in pixels
  700. * @stride : Stride in pixels
  701. * @slice_height : Slice height in lines
  702. * @resource_type : rsrc type
  703. * @scratch_buf_params : for future use
  704. */
  705. struct cam_isp_sfe_scratch_buf_info {
  706. __s32 mem_handle;
  707. __u32 offset;
  708. __u32 width;
  709. __u32 height;
  710. __u32 stride;
  711. __u32 slice_height;
  712. __u32 resource_type;
  713. __u32 scratch_buf_params[5];
  714. };
  715. /**
  716. * struct cam_isp_sfe_init_scratch_buf_config - SFE init buffer cfg
  717. * Provides scratch buffer info for SFE ports
  718. * as part of INIT packet
  719. *
  720. * @num_ports : Number of ports
  721. * @reserved : reserved
  722. * @port_scratch_cfg : scratch buffer info
  723. */
  724. struct cam_isp_sfe_init_scratch_buf_config {
  725. __u32 num_ports;
  726. __u32 reserved;
  727. struct cam_isp_sfe_scratch_buf_info port_scratch_cfg[1];
  728. };
  729. /**
  730. * struct cam_isp_tpg_core_config - TPG core registers configuration
  731. *
  732. * @version : Version info
  733. * @vc_dt_pattern_id : TPG pattern - SparsePD, sHDR etc.
  734. * @qcfa_en : Selects qcfa in color bar
  735. * @pix_pattern : Pix pattern color bar cfg
  736. * @hbi_clk_cnt : Number of HBI # of cycles
  737. * @vbi_clk_cnt : Number of VBI # of cycles
  738. * @throttle_pattern : Defines bubble pattern in throttler
  739. * @tpg_params : TPG params for future use
  740. */
  741. struct cam_isp_tpg_core_config {
  742. __u32 version;
  743. __u32 vc_dt_pattern_id;
  744. __u32 qcfa_en;
  745. __u32 pix_pattern;
  746. __u32 hbi_clk_cnt;
  747. __u32 vbi_clk_cnt;
  748. __u32 throttle_pattern;
  749. __u32 tpg_params[3];
  750. } __attribute__((packed));
  751. /**
  752. * struct cam_isp_acquire_hw_info - ISP acquire HW params
  753. *
  754. * @common_info_version : Version of common info struct used
  755. * @common_info_size : Size of common info struct used
  756. * @common_info_offset : Offset of common info from start of data
  757. * @num_inputs : Number of inputs
  758. * @input_info_version : Version of input info struct used
  759. * @input_info_size : Size of input info struct used
  760. * @input_info_offset : Offset of input info from start of data
  761. * @data : Start of data region
  762. */
  763. struct cam_isp_acquire_hw_info {
  764. __u16 common_info_version;
  765. __u16 common_info_size;
  766. __u32 common_info_offset;
  767. __u32 num_inputs;
  768. __u32 input_info_version;
  769. __u32 input_info_size;
  770. __u32 input_info_offset;
  771. __u64 data;
  772. };
  773. /**
  774. * struct cam_fps_config - FPS info per request
  775. *
  776. * @fps : Fps value
  777. * @reserved: : Reserved field for alignment
  778. *
  779. */
  780. struct cam_fps_config {
  781. __u32 fps;
  782. __u32 reserved_params[3];
  783. } __attribute__((packed));
  784. /**
  785. * struct cam_isp_vfe_wm_config - VFE write master config per port
  786. *
  787. * @port_type : Unique ID of output port
  788. * @wm_mode : Write master mode
  789. * 0x0 - Line based mode
  790. * 0x1 - Frame based mode
  791. * 0x2 - Index based mode, valid for BAF only
  792. * @h_init : Horizontal starting coordinate in pixels. Must be a
  793. * multiple of 3 for TP10 format
  794. * @height : Height in pixels
  795. * @width : Width in pixels
  796. * @virtual_frame_en : Enabling virtual frame will prevent actual request from
  797. * being sent to NOC
  798. * @stride : Write master stride
  799. * @offset : Write master offset
  800. * @addr_reuse_en : Enabling addr-reuse will write output to the same addr
  801. * after the last addr that was read from FIFO.
  802. * @reserved_2 : Reserved field for Write master config
  803. * @reserved_3 : Reserved field for Write master config
  804. * @reserved_4 : Reserved field for Write master config
  805. */
  806. struct cam_isp_vfe_wm_config {
  807. __u32 port_type;
  808. __u32 wm_mode;
  809. __u32 h_init;
  810. __u32 height;
  811. __u32 width;
  812. __u32 virtual_frame_en;
  813. __u32 stride;
  814. __u32 offset;
  815. __u32 addr_reuse_en;
  816. __u32 reserved_2;
  817. __u32 reserved_3;
  818. __u32 reserved_4;
  819. };
  820. /**
  821. * struct cam_isp_vfe_out_config - VFE write master config
  822. *
  823. * @num_ports : Number of ports
  824. * @reserved : Reserved field
  825. * @wm_config : VFE out config
  826. */
  827. struct cam_isp_vfe_out_config {
  828. __u32 num_ports;
  829. __u32 reserved;
  830. struct cam_isp_vfe_wm_config wm_config[1];
  831. };
  832. /**
  833. * struct cam_isp_mode_switch_info - Dynamic mode switch info
  834. *
  835. * @mup : MUP for incoming VC of next frame
  836. * @num_expoures : Number of exposures
  837. * @reserved : Reserved
  838. */
  839. struct cam_isp_mode_switch_info{
  840. __u32 mup;
  841. __u32 num_expoures;
  842. __u32 reserved;
  843. } __attribute__((packed));
  844. /**
  845. * struct cam_isp_sfe_wm_exp_order_config - SFE write master
  846. * exposure order config
  847. *
  848. * This config will reflect for corresponding RM as well
  849. *
  850. * @res_type : output resource type defined in file
  851. * cam_isp_sfe.h or cam_isp_ife.h
  852. * @additional_params : Params for future use
  853. */
  854. struct cam_isp_sfe_wm_exp_order_config {
  855. __u32 res_type;
  856. __u32 additional_params[5];
  857. };
  858. /**
  859. * struct cam_isp_sfe_exp_config - SFE out exposure config
  860. *
  861. * Exp order is determined by it's index in wm_config[]
  862. * The last resource in the array will be considered as
  863. * last [shortest] exposure.
  864. *
  865. * @num_ports : Number of ports
  866. * @reserved : Reserved field
  867. * @wm_config : WM exp config
  868. */
  869. struct cam_isp_sfe_exp_config {
  870. __u32 num_ports;
  871. __u32 reserved;
  872. struct cam_isp_sfe_wm_exp_order_config wm_config[1];
  873. };
  874. /**
  875. * struct cam_isp_discard_initial_frames - Discard init frames
  876. *
  877. * Some sensors require discarding the initial frames
  878. * after the sensor is streamed on. The discard would be
  879. * applied on all paths [IPP/PPP/RDIx] for the given
  880. * pipeline.
  881. *
  882. * @num_frames : Number of frames to be discarded
  883. * @discard_params : Params for future use
  884. */
  885. struct cam_isp_discard_initial_frames {
  886. __u32 num_frames;
  887. __u32 discard_params[5];
  888. } __attribute__((packed));
  889. /**
  890. * struct cam_isp_wm_bw_limiter_config - ISP write master
  891. * BW limter config
  892. *
  893. *
  894. * @res_type : output resource type defined in file
  895. * cam_isp_sfe.h or cam_isp_ife.h
  896. * @enable_limiter : 0 for disable else enabled
  897. * @counter_limit : Max counter value
  898. * @additional_params : Params for future use
  899. */
  900. struct cam_isp_wm_bw_limiter_config {
  901. __u32 res_type;
  902. __u32 enable_limiter;
  903. __u32 counter_limit[CAM_PACKET_MAX_PLANES];
  904. __u32 additional_params[5];
  905. };
  906. /**
  907. * struct cam_isp_out_rsrc_bw_limiter_config - ISP out rsrc BW limiter config
  908. *
  909. * Configure BW limiter for ISP WMs
  910. *
  911. * @num_ports : Number of ports
  912. * @reserved : Reserved field
  913. * @bw_limit_config : WM BW limiter config
  914. */
  915. struct cam_isp_out_rsrc_bw_limiter_config {
  916. __u32 num_ports;
  917. __u32 reserved;
  918. struct cam_isp_wm_bw_limiter_config bw_limiter_config[1];
  919. };
  920. #define CAM_ISP_ACQUIRE_COMMON_VER0 0x1000
  921. #define CAM_ISP_ACQUIRE_COMMON_SIZE_VER0 0x0
  922. #define CAM_ISP_ACQUIRE_INPUT_VER0 0x2000
  923. #define CAM_ISP_ACQUIRE_INPUT_SIZE_VER0 sizeof(struct cam_isp_in_port_info)
  924. #define CAM_ISP_ACQUIRE_OUT_VER0 0x3000
  925. #define CAM_ISP_ACQUIRE_OUT_SIZE_VER0 sizeof(struct cam_isp_out_port_info)
  926. #endif /* __UAPI_CAM_ISP_H__ */