xref: /f-stack/dpdk/drivers/bus/fslmc/mc/dpmng.c (revision 031be553)
1 /*-
2  * This file is provided under a dual BSD/GPLv2 license. When using or
3  * redistributing this file, you may do so under either license.
4  *
5  *   BSD LICENSE
6  *
7  * Copyright 2013-2015 Freescale Semiconductor Inc.
8  * Copyright 2017 NXP.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  * * Redistributions of source code must retain the above copyright
13  * notice, this list of conditions and the following disclaimer.
14  * * Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in the
16  * documentation and/or other materials provided with the distribution.
17  * * Neither the name of the above-listed copyright holders nor the
18  * names of any contributors may be used to endorse or promote products
19  * derived from this software without specific prior written permission.
20  *
21  *   GPL LICENSE SUMMARY
22  *
23  * ALTERNATIVELY, this software may be distributed under the terms of the
24  * GNU General Public License ("GPL") as published by the Free Software
25  * Foundation, either version 2 of that License or (at your option) any
26  * later version.
27  *
28  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
29  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
31  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
32  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
33  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
34  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
35  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
36  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
37  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
38  * POSSIBILITY OF SUCH DAMAGE.
39  */
40 #include <fsl_mc_sys.h>
41 #include <fsl_mc_cmd.h>
42 #include <fsl_dpmng.h>
43 #include <fsl_dpmng_cmd.h>
44 
45 /**
46  * mc_get_version() - Retrieves the Management Complex firmware
47  *			version information
48  * @mc_io:		Pointer to opaque I/O object
49  * @cmd_flags:		Command flags; one or more of 'MC_CMD_FLAG_'
50  * @mc_ver_info:	Returned version information structure
51  *
52  * Return:	'0' on Success; Error code otherwise.
53  */
54 int mc_get_version(struct fsl_mc_io *mc_io,
55 		   uint32_t cmd_flags,
56 		   struct mc_version *mc_ver_info)
57 {
58 	struct mc_command cmd = { 0 };
59 	struct dpmng_rsp_get_version *rsp_params;
60 	int err;
61 
62 	/* prepare command */
63 	cmd.header = mc_encode_cmd_header(DPMNG_CMDID_GET_VERSION,
64 					  cmd_flags,
65 					  0);
66 
67 	/* send command to mc*/
68 	err = mc_send_command(mc_io, &cmd);
69 	if (err)
70 		return err;
71 
72 	/* retrieve response parameters */
73 	rsp_params = (struct dpmng_rsp_get_version *)cmd.params;
74 	mc_ver_info->revision = le32_to_cpu(rsp_params->revision);
75 	mc_ver_info->major = le32_to_cpu(rsp_params->version_major);
76 	mc_ver_info->minor = le32_to_cpu(rsp_params->version_minor);
77 
78 	return 0;
79 }
80 
81 /**
82  * mc_get_soc_version() - Retrieves the Management Complex firmware
83  *                     version information
84  * @mc_io		Pointer to opaque I/O object
85  * @cmd_flags:		Command flags; one or more of 'MC_CMD_FLAG_'
86  * @mc_platform_info:	Returned version information structure. The structure
87  *			contains the values of SVR and PVR registers.
88  *			Please consult platform specific reference manual
89  *			for detailed information.
90  *
91  * Return:     '0' on Success; Error code otherwise.
92  */
93 int mc_get_soc_version(struct fsl_mc_io *mc_io,
94 		       uint32_t cmd_flags,
95 		       struct mc_soc_version *mc_platform_info)
96 {
97 	struct dpmng_rsp_get_soc_version *rsp_params;
98 	struct mc_command cmd = { 0 };
99 	int err;
100 
101 	/* prepare command */
102 	cmd.header = mc_encode_cmd_header(DPMNG_CMDID_GET_SOC_VERSION,
103 					  cmd_flags,
104 					  0);
105 
106 	/* send command to mc*/
107 	err = mc_send_command(mc_io, &cmd);
108 	if (err)
109 		return err;
110 
111 	/* retrieve response parameters */
112 	rsp_params = (struct dpmng_rsp_get_soc_version *)cmd.params;
113 	mc_platform_info->svr = le32_to_cpu(rsp_params->svr);
114 	mc_platform_info->pvr = le32_to_cpu(rsp_params->pvr);
115 
116 	return 0;
117 }
118