xref: /linux/Documentation/networking/devlink/octeontx2.rst (revision cdd30ebb1b9f36159d66f088b61aee264e649d7a)
1.. SPDX-License-Identifier: GPL-2.0
2
3=========================
4octeontx2 devlink support
5=========================
6
7This document describes the devlink features implemented by the ``octeontx2 AF, PF and VF``
8device drivers.
9
10Parameters
11==========
12
13The ``octeontx2 PF and VF`` drivers implement the following driver-specific parameters.
14
15.. list-table:: Driver-specific parameters implemented
16   :widths: 5 5 5 85
17
18   * - Name
19     - Type
20     - Mode
21     - Description
22   * - ``mcam_count``
23     - u16
24     - runtime
25     - Select number of match CAM entries to be allocated for an interface.
26       The same is used for ntuple filters of the interface. Supported by
27       PF and VF drivers.
28
29The ``octeontx2 AF`` driver implements the following driver-specific parameters.
30
31.. list-table:: Driver-specific parameters implemented
32   :widths: 5 5 5 85
33
34   * - Name
35     - Type
36     - Mode
37     - Description
38   * - ``dwrr_mtu``
39     - u32
40     - runtime
41     - Use to set the quantum which hardware uses for scheduling among transmit queues.
42       Hardware uses weighted DWRR algorithm to schedule among all transmit queues.
43   * - ``npc_mcam_high_zone_percent``
44     - u8
45     - runtime
46     - Use to set the number of high priority zone entries in NPC MCAM that can be allocated
47       by a user, out of the three priority zone categories high, mid and low.
48   * - ``npc_def_rule_cntr``
49     - bool
50     - runtime
51     - Use to enable or disable hit counters for the default rules in NPC MCAM.
52       Its not guaranteed that counters gets enabled and mapped to all the default rules,
53       since the counters are scarce and driver follows a best effort approach.
54       The default rule serves as the primary packet steering rule for a specific PF or VF,
55       based on its DMAC address which is installed by AF driver as part of its initialization.
56       Sample command to read hit counters for default rule from debugfs is as follows,
57       cat /sys/kernel/debug/cn10k/npc/mcam_rules
58   * - ``nix_maxlf``
59     - u16
60     - runtime
61     - Use to set the maximum number of LFs in NIX hardware block. This would be useful
62       to increase the availability of default resources allocated to enabled LFs like
63       MCAM entries for example.
64
65The ``octeontx2 PF`` driver implements the following driver-specific parameters.
66
67.. list-table:: Driver-specific parameters implemented
68   :widths: 5 5 5 85
69
70   * - Name
71     - Type
72     - Mode
73     - Description
74   * - ``unicast_filter_count``
75     - u8
76     - runtime
77     - Set the maximum number of unicast filters that can be programmed for
78       the device. This can be used to achieve better device resource
79       utilization, avoiding over consumption of unused MCAM table entries.
80