1 /* SPDX-License-Identifier: BSD-3-Clause */
2 /* Copyright (c) 2024, Intel Corporation
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are met:
7 *
8 * 1. Redistributions of source code must retain the above copyright notice,
9 * this list of conditions and the following disclaimer.
10 *
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 *
15 * 3. Neither the name of the Intel Corporation nor the names of its
16 * contributors may be used to endorse or promote products derived from
17 * this software without specific prior written permission.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32 /**
33 * @file ice_features.h
34 * @brief device feature controls
35 *
36 * Contains a list of various device features which could be enabled or
37 * disabled.
38 */
39
40 #ifndef _ICE_FEATURES_H_
41 #define _ICE_FEATURES_H_
42
43 /**
44 * @enum feat_list
45 * @brief driver feature enumeration
46 *
47 * Enumeration of possible device driver features that can be enabled or
48 * disabled. Each possible value represents a different feature which can be
49 * enabled or disabled.
50 *
51 * The driver stores a bitmap of the features that the device and OS are
52 * capable of, as well as another bitmap indicating which features are
53 * currently enabled for that device.
54 */
55 enum feat_list {
56 ICE_FEATURE_SRIOV,
57 ICE_FEATURE_RSS,
58 ICE_FEATURE_NETMAP,
59 ICE_FEATURE_FDIR,
60 ICE_FEATURE_MSI,
61 ICE_FEATURE_MSIX,
62 ICE_FEATURE_RDMA,
63 ICE_FEATURE_SAFE_MODE,
64 ICE_FEATURE_LENIENT_LINK_MODE,
65 ICE_FEATURE_LINK_MGMT_VER_1,
66 ICE_FEATURE_LINK_MGMT_VER_2,
67 ICE_FEATURE_HEALTH_STATUS,
68 ICE_FEATURE_FW_LOGGING,
69 ICE_FEATURE_HAS_PBA,
70 ICE_FEATURE_DCB,
71 ICE_FEATURE_TX_BALANCE,
72 ICE_FEATURE_DUAL_NAC,
73 ICE_FEATURE_TEMP_SENSOR,
74 ICE_FEATURE_NEXT_CLUSTER_ID,
75 ICE_FEATURE_PHY_STATISTICS,
76 /* Must be last entry */
77 ICE_FEATURE_COUNT
78 };
79
80 /**
81 * ice_disable_unsupported_features - Disable features not enabled by OS
82 * @bitmap: the feature bitmap
83 *
84 * Check for OS support of various driver features. Clear the feature bit for
85 * any feature which is not enabled by the OS. This should be called early
86 * during driver attach after setting up the feature bitmap.
87 *
88 * @remark the bitmap parameter is marked as unused in order to avoid an
89 * unused parameter warning in case none of the features need to be disabled.
90 */
91 static inline void
ice_disable_unsupported_features(ice_bitmap_t __unused * bitmap)92 ice_disable_unsupported_features(ice_bitmap_t __unused *bitmap)
93 {
94 ice_clear_bit(ICE_FEATURE_SRIOV, bitmap);
95 #ifndef DEV_NETMAP
96 ice_clear_bit(ICE_FEATURE_NETMAP, bitmap);
97 #endif
98 }
99
100 #endif
101