1 // SPDX-License-Identifier: (GPL-2.0+ OR BSD-3-Clause)
2 /*
3 * Copyright 2013-2016 Freescale Semiconductor Inc.
4 *
5 */
6 #include <linux/kernel.h>
7 #include <linux/fsl/mc.h>
8
9 #include "fsl-mc-private.h"
10
11 /**
12 * dpmcp_open() - Open a control session for the specified object.
13 * @mc_io: Pointer to MC portal's I/O object
14 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
15 * @dpmcp_id: DPMCP unique ID
16 * @token: Returned token; use in subsequent API calls
17 *
18 * This function can be used to open a control session for an
19 * already created object; an object may have been declared in
20 * the DPL or by calling the dpmcp_create function.
21 * This function returns a unique authentication token,
22 * associated with the specific object ID and the specific MC
23 * portal; this token must be used in all subsequent commands for
24 * this specific object
25 *
26 * Return: '0' on Success; Error code otherwise.
27 */
28 int dpmcp_open(struct fsl_mc_io *mc_io,
29 u32 cmd_flags,
30 int dpmcp_id,
31 u16 *token)
32 {
33 struct fsl_mc_command cmd = { 0 };
34 struct dpmcp_cmd_open *cmd_params;
35 int err;
36
37 /* prepare command */
38 cmd.header = mc_encode_cmd_header(DPMCP_CMDID_OPEN,
39 cmd_flags, 0);
40 cmd_params = (struct dpmcp_cmd_open *)cmd.params;
41 cmd_params->dpmcp_id = cpu_to_le32(dpmcp_id);
42
43 /* send command to mc*/
44 err = mc_send_command(mc_io, &cmd);
45 if (err)
46 return err;
47
48 /* retrieve response parameters */
49 *token = mc_cmd_hdr_read_token(&cmd);
50
51 return err;
52 }
53
54 /**
55 * dpmcp_close() - Close the control session of the object
56 * @mc_io: Pointer to MC portal's I/O object
57 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
58 * @token: Token of DPMCP object
59 *
60 * After this function is called, no further operations are
61 * allowed on the object without opening a new control session.
62 *
63 * Return: '0' on Success; Error code otherwise.
64 */
65 int dpmcp_close(struct fsl_mc_io *mc_io,
66 u32 cmd_flags,
67 u16 token)
68 {
69 struct fsl_mc_command cmd = { 0 };
70
71 /* prepare command */
72 cmd.header = mc_encode_cmd_header(DPMCP_CMDID_CLOSE,
73 cmd_flags, token);
74
75 /* send command to mc*/
76 return mc_send_command(mc_io, &cmd);
77 }
78
79 /**
80 * dpmcp_reset() - Reset the DPMCP, returns the object to initial state.
81 * @mc_io: Pointer to MC portal's I/O object
82 * @cmd_flags: Command flags; one or more of 'MC_CMD_FLAG_'
83 * @token: Token of DPMCP object
84 *
85 * Return: '0' on Success; Error code otherwise.
86 */
87 int dpmcp_reset(struct fsl_mc_io *mc_io,
88 u32 cmd_flags,
89 u16 token)
90 {
91 struct fsl_mc_command cmd = { 0 };
92
93 /* prepare command */
94 cmd.header = mc_encode_cmd_header(DPMCP_CMDID_RESET,
95 cmd_flags, token);
96
97 /* send command to mc*/
98 return mc_send_command(mc_io, &cmd);
99 }