1 // SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause)
3 * Copyright 2013-2016 Freescale Semiconductor Inc.
6 #include <linux/kernel.h>
7 #include <linux/fsl/mc.h>
9 #include "fsl-mc-private.h"
12 * dprc_open() - Open DPRC object for use
13 * @mc_io: Pointer to MC portal's I/O object
14 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
15 * @container_id: Container ID to open
16 * @token: Returned token of DPRC object
18 * Return: '0' on Success; Error code otherwise.
20 * @warning Required before any operation on the object.
22 int dprc_open(struct fsl_mc_io *mc_io,
27 struct fsl_mc_command cmd = { 0 };
28 struct dprc_cmd_open *cmd_params;
32 cmd.header = mc_encode_cmd_header(DPRC_CMDID_OPEN, cmd_flags,
34 cmd_params = (struct dprc_cmd_open *)cmd.params;
35 cmd_params->container_id = cpu_to_le32(container_id);
37 /* send command to mc*/
38 err = mc_send_command(mc_io, &cmd);
42 /* retrieve response parameters */
43 *token = mc_cmd_hdr_read_token(&cmd);
47 EXPORT_SYMBOL_GPL(dprc_open);
50 * dprc_close() - Close the control session of the object
51 * @mc_io: Pointer to MC portal's I/O object
52 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
53 * @token: Token of DPRC object
55 * After this function is called, no further operations are
56 * allowed on the object without opening a new control session.
58 * Return: '0' on Success; Error code otherwise.
60 int dprc_close(struct fsl_mc_io *mc_io,
64 struct fsl_mc_command cmd = { 0 };
67 cmd.header = mc_encode_cmd_header(DPRC_CMDID_CLOSE, cmd_flags,
70 /* send command to mc*/
71 return mc_send_command(mc_io, &cmd);
73 EXPORT_SYMBOL_GPL(dprc_close);
76 * dprc_set_irq() - Set IRQ information for the DPRC to trigger an interrupt.
77 * @mc_io: Pointer to MC portal's I/O object
78 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
79 * @token: Token of DPRC object
80 * @irq_index: Identifies the interrupt index to configure
81 * @irq_cfg: IRQ configuration
83 * Return: '0' on Success; Error code otherwise.
85 int dprc_set_irq(struct fsl_mc_io *mc_io,
89 struct dprc_irq_cfg *irq_cfg)
91 struct fsl_mc_command cmd = { 0 };
92 struct dprc_cmd_set_irq *cmd_params;
95 cmd.header = mc_encode_cmd_header(DPRC_CMDID_SET_IRQ,
98 cmd_params = (struct dprc_cmd_set_irq *)cmd.params;
99 cmd_params->irq_val = cpu_to_le32(irq_cfg->val);
100 cmd_params->irq_index = irq_index;
101 cmd_params->irq_addr = cpu_to_le64(irq_cfg->paddr);
102 cmd_params->irq_num = cpu_to_le32(irq_cfg->irq_num);
104 /* send command to mc*/
105 return mc_send_command(mc_io, &cmd);
109 * dprc_set_irq_enable() - Set overall interrupt state.
110 * @mc_io: Pointer to MC portal's I/O object
111 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
112 * @token: Token of DPRC object
113 * @irq_index: The interrupt index to configure
114 * @en: Interrupt state - enable = 1, disable = 0
116 * Allows GPP software to control when interrupts are generated.
117 * Each interrupt can have up to 32 causes. The enable/disable control's the
118 * overall interrupt state. if the interrupt is disabled no causes will cause
121 * Return: '0' on Success; Error code otherwise.
123 int dprc_set_irq_enable(struct fsl_mc_io *mc_io,
129 struct fsl_mc_command cmd = { 0 };
130 struct dprc_cmd_set_irq_enable *cmd_params;
132 /* prepare command */
133 cmd.header = mc_encode_cmd_header(DPRC_CMDID_SET_IRQ_ENABLE,
135 cmd_params = (struct dprc_cmd_set_irq_enable *)cmd.params;
136 cmd_params->enable = en & DPRC_ENABLE;
137 cmd_params->irq_index = irq_index;
139 /* send command to mc*/
140 return mc_send_command(mc_io, &cmd);
144 * dprc_set_irq_mask() - Set interrupt mask.
145 * @mc_io: Pointer to MC portal's I/O object
146 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
147 * @token: Token of DPRC object
148 * @irq_index: The interrupt index to configure
149 * @mask: event mask to trigger interrupt;
152 * 1 = consider event for asserting irq
154 * Every interrupt can have up to 32 causes and the interrupt model supports
155 * masking/unmasking each cause independently
157 * Return: '0' on Success; Error code otherwise.
159 int dprc_set_irq_mask(struct fsl_mc_io *mc_io,
165 struct fsl_mc_command cmd = { 0 };
166 struct dprc_cmd_set_irq_mask *cmd_params;
168 /* prepare command */
169 cmd.header = mc_encode_cmd_header(DPRC_CMDID_SET_IRQ_MASK,
171 cmd_params = (struct dprc_cmd_set_irq_mask *)cmd.params;
172 cmd_params->mask = cpu_to_le32(mask);
173 cmd_params->irq_index = irq_index;
175 /* send command to mc*/
176 return mc_send_command(mc_io, &cmd);
180 * dprc_get_irq_status() - Get the current status of any pending interrupts.
181 * @mc_io: Pointer to MC portal's I/O object
182 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
183 * @token: Token of DPRC object
184 * @irq_index: The interrupt index to configure
185 * @status: Returned interrupts status - one bit per cause:
186 * 0 = no interrupt pending
187 * 1 = interrupt pending
189 * Return: '0' on Success; Error code otherwise.
191 int dprc_get_irq_status(struct fsl_mc_io *mc_io,
197 struct fsl_mc_command cmd = { 0 };
198 struct dprc_cmd_get_irq_status *cmd_params;
199 struct dprc_rsp_get_irq_status *rsp_params;
202 /* prepare command */
203 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_IRQ_STATUS,
205 cmd_params = (struct dprc_cmd_get_irq_status *)cmd.params;
206 cmd_params->status = cpu_to_le32(*status);
207 cmd_params->irq_index = irq_index;
209 /* send command to mc*/
210 err = mc_send_command(mc_io, &cmd);
214 /* retrieve response parameters */
215 rsp_params = (struct dprc_rsp_get_irq_status *)cmd.params;
216 *status = le32_to_cpu(rsp_params->status);
222 * dprc_clear_irq_status() - Clear a pending interrupt's status
223 * @mc_io: Pointer to MC portal's I/O object
224 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
225 * @token: Token of DPRC object
226 * @irq_index: The interrupt index to configure
227 * @status: bits to clear (W1C) - one bit per cause:
229 * 1 = clear status bit
231 * Return: '0' on Success; Error code otherwise.
233 int dprc_clear_irq_status(struct fsl_mc_io *mc_io,
239 struct fsl_mc_command cmd = { 0 };
240 struct dprc_cmd_clear_irq_status *cmd_params;
242 /* prepare command */
243 cmd.header = mc_encode_cmd_header(DPRC_CMDID_CLEAR_IRQ_STATUS,
245 cmd_params = (struct dprc_cmd_clear_irq_status *)cmd.params;
246 cmd_params->status = cpu_to_le32(status);
247 cmd_params->irq_index = irq_index;
249 /* send command to mc*/
250 return mc_send_command(mc_io, &cmd);
254 * dprc_get_attributes() - Obtains container attributes
255 * @mc_io: Pointer to MC portal's I/O object
256 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
257 * @token: Token of DPRC object
258 * @attributes Returned container attributes
260 * Return: '0' on Success; Error code otherwise.
262 int dprc_get_attributes(struct fsl_mc_io *mc_io,
265 struct dprc_attributes *attr)
267 struct fsl_mc_command cmd = { 0 };
268 struct dprc_rsp_get_attributes *rsp_params;
271 /* prepare command */
272 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_ATTR,
276 /* send command to mc*/
277 err = mc_send_command(mc_io, &cmd);
281 /* retrieve response parameters */
282 rsp_params = (struct dprc_rsp_get_attributes *)cmd.params;
283 attr->container_id = le32_to_cpu(rsp_params->container_id);
284 attr->icid = le16_to_cpu(rsp_params->icid);
285 attr->options = le32_to_cpu(rsp_params->options);
286 attr->portal_id = le32_to_cpu(rsp_params->portal_id);
292 * dprc_get_obj_count() - Obtains the number of objects in the DPRC
293 * @mc_io: Pointer to MC portal's I/O object
294 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
295 * @token: Token of DPRC object
296 * @obj_count: Number of objects assigned to the DPRC
298 * Return: '0' on Success; Error code otherwise.
300 int dprc_get_obj_count(struct fsl_mc_io *mc_io,
305 struct fsl_mc_command cmd = { 0 };
306 struct dprc_rsp_get_obj_count *rsp_params;
309 /* prepare command */
310 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_OBJ_COUNT,
313 /* send command to mc*/
314 err = mc_send_command(mc_io, &cmd);
318 /* retrieve response parameters */
319 rsp_params = (struct dprc_rsp_get_obj_count *)cmd.params;
320 *obj_count = le32_to_cpu(rsp_params->obj_count);
324 EXPORT_SYMBOL_GPL(dprc_get_obj_count);
327 * dprc_get_obj() - Get general information on an object
328 * @mc_io: Pointer to MC portal's I/O object
329 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
330 * @token: Token of DPRC object
331 * @obj_index: Index of the object to be queried (< obj_count)
332 * @obj_desc: Returns the requested object descriptor
334 * The object descriptors are retrieved one by one by incrementing
335 * obj_index up to (not including) the value of obj_count returned
336 * from dprc_get_obj_count(). dprc_get_obj_count() must
337 * be called prior to dprc_get_obj().
339 * Return: '0' on Success; Error code otherwise.
341 int dprc_get_obj(struct fsl_mc_io *mc_io,
345 struct fsl_mc_obj_desc *obj_desc)
347 struct fsl_mc_command cmd = { 0 };
348 struct dprc_cmd_get_obj *cmd_params;
349 struct dprc_rsp_get_obj *rsp_params;
352 /* prepare command */
353 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_OBJ,
356 cmd_params = (struct dprc_cmd_get_obj *)cmd.params;
357 cmd_params->obj_index = cpu_to_le32(obj_index);
359 /* send command to mc*/
360 err = mc_send_command(mc_io, &cmd);
364 /* retrieve response parameters */
365 rsp_params = (struct dprc_rsp_get_obj *)cmd.params;
366 obj_desc->id = le32_to_cpu(rsp_params->id);
367 obj_desc->vendor = le16_to_cpu(rsp_params->vendor);
368 obj_desc->irq_count = rsp_params->irq_count;
369 obj_desc->region_count = rsp_params->region_count;
370 obj_desc->state = le32_to_cpu(rsp_params->state);
371 obj_desc->ver_major = le16_to_cpu(rsp_params->version_major);
372 obj_desc->ver_minor = le16_to_cpu(rsp_params->version_minor);
373 obj_desc->flags = le16_to_cpu(rsp_params->flags);
374 strncpy(obj_desc->type, rsp_params->type, 16);
375 obj_desc->type[15] = '\0';
376 strncpy(obj_desc->label, rsp_params->label, 16);
377 obj_desc->label[15] = '\0';
380 EXPORT_SYMBOL_GPL(dprc_get_obj);
383 * dprc_set_obj_irq() - Set IRQ information for object to trigger an interrupt.
384 * @mc_io: Pointer to MC portal's I/O object
385 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
386 * @token: Token of DPRC object
387 * @obj_type: Type of the object to set its IRQ
388 * @obj_id: ID of the object to set its IRQ
389 * @irq_index: The interrupt index to configure
390 * @irq_cfg: IRQ configuration
392 * Return: '0' on Success; Error code otherwise.
394 int dprc_set_obj_irq(struct fsl_mc_io *mc_io,
400 struct dprc_irq_cfg *irq_cfg)
402 struct fsl_mc_command cmd = { 0 };
403 struct dprc_cmd_set_obj_irq *cmd_params;
405 /* prepare command */
406 cmd.header = mc_encode_cmd_header(DPRC_CMDID_SET_OBJ_IRQ,
409 cmd_params = (struct dprc_cmd_set_obj_irq *)cmd.params;
410 cmd_params->irq_val = cpu_to_le32(irq_cfg->val);
411 cmd_params->irq_index = irq_index;
412 cmd_params->irq_addr = cpu_to_le64(irq_cfg->paddr);
413 cmd_params->irq_num = cpu_to_le32(irq_cfg->irq_num);
414 cmd_params->obj_id = cpu_to_le32(obj_id);
415 strncpy(cmd_params->obj_type, obj_type, 16);
416 cmd_params->obj_type[15] = '\0';
418 /* send command to mc*/
419 return mc_send_command(mc_io, &cmd);
421 EXPORT_SYMBOL_GPL(dprc_set_obj_irq);
424 * dprc_get_obj_region() - Get region information for a specified object.
425 * @mc_io: Pointer to MC portal's I/O object
426 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
427 * @token: Token of DPRC object
428 * @obj_type; Object type as returned in dprc_get_obj()
429 * @obj_id: Unique object instance as returned in dprc_get_obj()
430 * @region_index: The specific region to query
431 * @region_desc: Returns the requested region descriptor
433 * Return: '0' on Success; Error code otherwise.
435 int dprc_get_obj_region(struct fsl_mc_io *mc_io,
441 struct dprc_region_desc *region_desc)
443 struct fsl_mc_command cmd = { 0 };
444 struct dprc_cmd_get_obj_region *cmd_params;
445 struct dprc_rsp_get_obj_region *rsp_params;
446 u16 major_ver, minor_ver;
449 /* prepare command */
450 err = dprc_get_api_version(mc_io, 0,
457 * MC API version 6.3 introduced a new field to the region
458 * descriptor: base_address. If the older API is in use then the base
459 * address is set to zero to indicate it needs to be obtained elsewhere
460 * (typically the device tree).
462 if (major_ver > 6 || (major_ver == 6 && minor_ver >= 3))
464 mc_encode_cmd_header(DPRC_CMDID_GET_OBJ_REG_V2,
468 mc_encode_cmd_header(DPRC_CMDID_GET_OBJ_REG,
471 cmd_params = (struct dprc_cmd_get_obj_region *)cmd.params;
472 cmd_params->obj_id = cpu_to_le32(obj_id);
473 cmd_params->region_index = region_index;
474 strncpy(cmd_params->obj_type, obj_type, 16);
475 cmd_params->obj_type[15] = '\0';
477 /* send command to mc*/
478 err = mc_send_command(mc_io, &cmd);
482 /* retrieve response parameters */
483 rsp_params = (struct dprc_rsp_get_obj_region *)cmd.params;
484 region_desc->base_offset = le64_to_cpu(rsp_params->base_offset);
485 region_desc->size = le32_to_cpu(rsp_params->size);
486 if (major_ver > 6 || (major_ver == 6 && minor_ver >= 3))
487 region_desc->base_address = le64_to_cpu(rsp_params->base_addr);
489 region_desc->base_address = 0;
493 EXPORT_SYMBOL_GPL(dprc_get_obj_region);
496 * dprc_get_api_version - Get Data Path Resource Container API version
497 * @mc_io: Pointer to Mc portal's I/O object
498 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
499 * @major_ver: Major version of Data Path Resource Container API
500 * @minor_ver: Minor version of Data Path Resource Container API
502 * Return: '0' on Success; Error code otherwise.
504 int dprc_get_api_version(struct fsl_mc_io *mc_io,
509 struct fsl_mc_command cmd = { 0 };
512 /* prepare command */
513 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_API_VERSION,
516 /* send command to mc */
517 err = mc_send_command(mc_io, &cmd);
521 /* retrieve response parameters */
522 mc_cmd_read_api_version(&cmd, major_ver, minor_ver);
528 * dprc_get_container_id - Get container ID associated with a given portal.
529 * @mc_io: Pointer to Mc portal's I/O object
530 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
531 * @container_id: Requested container id
533 * Return: '0' on Success; Error code otherwise.
535 int dprc_get_container_id(struct fsl_mc_io *mc_io,
539 struct fsl_mc_command cmd = { 0 };
542 /* prepare command */
543 cmd.header = mc_encode_cmd_header(DPRC_CMDID_GET_CONT_ID,
547 /* send command to mc*/
548 err = mc_send_command(mc_io, &cmd);
552 /* retrieve response parameters */
553 *container_id = (int)mc_cmd_read_object_id(&cmd);