kernel/drivers/crypto/qat/qat_common/adf_pf2vf_msg.h

   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   GPL LICENSE SUMMARY
   6   Copyright(c) 2015 Intel Corporation.
   7   This program is free software; you can redistribute it and/or modify
   8   it under the terms of version 2 of the GNU General Public License as
   9   published by the Free Software Foundation.
  10
  11   This program is distributed in the hope that it will be useful, but
  12   WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14   General Public License for more details.
  15
  16   Contact Information:
  17   qat-linux@intel.com
  18
  19   BSD LICENSE
  20   Copyright(c) 2015 Intel Corporation.
  21   Redistribution and use in source and binary forms, with or without
  22   modification, are permitted provided that the following conditions
  23   are met:
  24
  25     * Redistributions of source code must retain the above copyright
  26       notice, this list of conditions and the following disclaimer.
  27     * Redistributions in binary form must reproduce the above copyright
  28       notice, this list of conditions and the following disclaimer in
  29       the documentation and/or other materials provided with the
  30       distribution.
  31     * Neither the name of Intel Corporation nor the names of its
  32       contributors may be used to endorse or promote products derived
  33       from this software without specific prior written permission.
  34
  35   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  36   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  37   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  38   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  39   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  42   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  43   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  44   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  45   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  46 */
  47 #ifndef ADF_PF2VF_MSG_H
  48 #define ADF_PF2VF_MSG_H
  49
  50 /*
  51  * PF<->VF Messaging
  52  * The PF has an array of 32-bit PF2VF registers, one for each VF.  The
  53  * PF can access all these registers; each VF can access only the one
  54  * register associated with that particular VF.
  55  *
  56  * The register functionally is split into two parts:
  57  * The bottom half is for PF->VF messages. In particular when the first
  58  * bit of this register (bit 0) gets set an interrupt will be triggered
  59  * in the respective VF.
  60  * The top half is for VF->PF messages. In particular when the first bit
  61  * of this half of register (bit 16) gets set an interrupt will be triggered
  62  * in the PF.
  63  *
  64  * The remaining bits within this register are available to encode messages.
  65  * and implement a collision control mechanism to prevent concurrent use of
  66  * the PF2VF register by both the PF and VF.
  67  *
  68  *  31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16
  69  *  _______________________________________________
  70  * |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
  71  * +-----------------------------------------------+
  72  *  \___________________________/ \_________/ ^   ^
  73  *                ^                    ^      |   |
  74  *                |                    |      |   VF2PF Int
  75  *                |                    |      Message Origin
  76  *                |                    Message Type
  77  *                Message-specific Data/Reserved
  78  *
  79  *  15 14 13 12 11 10  9  8  7  6  5  4  3  2  1  0
  80  *  _______________________________________________
  81  * |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
  82  * +-----------------------------------------------+
  83  *  \___________________________/ \_________/ ^   ^
  84  *                ^                    ^      |   |
  85  *                |                    |      |   PF2VF Int
  86  *                |                    |      Message Origin
  87  *                |                    Message Type
  88  *                Message-specific Data/Reserved
  89  *
  90  * Message Origin (Should always be 1)
  91  * A legacy out-of-tree QAT driver allowed for a set of messages not supported
  92  * by this driver; these had a Msg Origin of 0 and are ignored by this driver.
  93  *
  94  * When a PF or VF attempts to send a message in the lower or upper 16 bits,
  95  * respectively, the other 16 bits are written to first with a defined
  96  * IN_USE_BY pattern as part of a collision control scheme (see adf_iov_putmsg).
  97  */
  98
  99 #define ADF_PFVF_COMPATIBILITY_VERSION          0x1     /* PF<->VF compat */
 100
 101 /* PF->VF messages */
 102 #define ADF_PF2VF_INT                           BIT(0)
 103 #define ADF_PF2VF_MSGORIGIN_SYSTEM              BIT(1)
 104 #define ADF_PF2VF_MSGTYPE_MASK                  0x0000003C
 105 #define ADF_PF2VF_MSGTYPE_SHIFT                 2
 106 #define ADF_PF2VF_MSGTYPE_RESTARTING            0x01
 107 #define ADF_PF2VF_MSGTYPE_VERSION_RESP          0x02
 108 #define ADF_PF2VF_IN_USE_BY_PF                  0x6AC20000
 109 #define ADF_PF2VF_IN_USE_BY_PF_MASK             0xFFFE0000
 110
 111 /* PF->VF Version Response */
 112 #define ADF_PF2VF_VERSION_RESP_VERS_MASK        0x00003FC0
 113 #define ADF_PF2VF_VERSION_RESP_VERS_SHIFT       6
 114 #define ADF_PF2VF_VERSION_RESP_RESULT_MASK      0x0000C000
 115 #define ADF_PF2VF_VERSION_RESP_RESULT_SHIFT     14
 116 #define ADF_PF2VF_MINORVERSION_SHIFT            6
 117 #define ADF_PF2VF_MAJORVERSION_SHIFT            10
 118 #define ADF_PF2VF_VF_COMPATIBLE                 1
 119 #define ADF_PF2VF_VF_INCOMPATIBLE               2
 120 #define ADF_PF2VF_VF_COMPAT_UNKNOWN             3
 121
 122 /* VF->PF messages */
 123 #define ADF_VF2PF_IN_USE_BY_VF                  0x00006AC2
 124 #define ADF_VF2PF_IN_USE_BY_VF_MASK             0x0000FFFE
 125 #define ADF_VF2PF_INT                           BIT(16)
 126 #define ADF_VF2PF_MSGORIGIN_SYSTEM              BIT(17)
 127 #define ADF_VF2PF_MSGTYPE_MASK                  0x003C0000
 128 #define ADF_VF2PF_MSGTYPE_SHIFT                 18
 129 #define ADF_VF2PF_MSGTYPE_INIT                  0x3
 130 #define ADF_VF2PF_MSGTYPE_SHUTDOWN              0x4
 131 #define ADF_VF2PF_MSGTYPE_VERSION_REQ           0x5
 132 #define ADF_VF2PF_MSGTYPE_COMPAT_VER_REQ        0x6
 133
 134 /* VF->PF Compatible Version Request */
 135 #define ADF_VF2PF_COMPAT_VER_REQ_SHIFT          22
 136
 137 /* Collision detection */
 138 #define ADF_IOV_MSG_COLLISION_DETECT_DELAY      10
 139 #define ADF_IOV_MSG_ACK_DELAY                   2
 140 #define ADF_IOV_MSG_ACK_MAX_RETRY               100
 141 #define ADF_IOV_MSG_RETRY_DELAY                 5
 142 #define ADF_IOV_MSG_MAX_RETRIES                 3
 143 #define ADF_IOV_MSG_RESP_TIMEOUT        (ADF_IOV_MSG_ACK_DELAY * \
 144                                          ADF_IOV_MSG_ACK_MAX_RETRY + \
 145                                          ADF_IOV_MSG_COLLISION_DETECT_DELAY)
 146 #endif /* ADF_IOV_MSG_H */