drivers/bus/fslmc/mc/dpmng.c

   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 }