| 1 |
What: /sys/devices/platform/HISI04Bx:00/chipX/all_linked |
| 2 |
What: /sys/devices/platform/HISI04Bx:00/chipX/linked_full_lane |
| 3 |
What: /sys/devices/platform/HISI04Bx:00/chipX/crc_err_cnt |
| 4 |
Date: November 2023 |
| 5 |
KernelVersion: 6.6 |
| 6 |
Contact: Huisong Li <[email protected]> |
| 7 |
Description: |
| 8 |
The /sys/devices/platform/HISI04Bx:00/chipX/ directory |
| 9 |
contains read-only attributes exposing some summarization |
| 10 |
information of all HCCS ports under a specified chip. |
| 11 |
The X in 'chipX' indicates the Xth chip on platform. |
| 12 |
|
| 13 |
There are following attributes in this directory: |
| 14 |
|
| 15 |
================= ==== ========================================= |
| 16 |
all_linked: (RO) if all enabled ports on this chip are |
| 17 |
linked (bool). |
| 18 |
linked_full_lane: (RO) if all linked ports on this chip are full |
| 19 |
lane (bool). |
| 20 |
crc_err_cnt: (RO) total CRC err count for all ports on this |
| 21 |
chip. |
| 22 |
================= ==== ========================================= |
| 23 |
|
| 24 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/all_linked |
| 25 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/linked_full_lane |
| 26 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/crc_err_cnt |
| 27 |
Date: November 2023 |
| 28 |
KernelVersion: 6.6 |
| 29 |
Contact: Huisong Li <[email protected]> |
| 30 |
Description: |
| 31 |
The /sys/devices/platform/HISI04Bx:00/chipX/dieY/ directory |
| 32 |
contains read-only attributes exposing some summarization |
| 33 |
information of all HCCS ports under a specified die. |
| 34 |
The Y in 'dieY' indicates the hardware id of the die on chip who |
| 35 |
has chip id X. |
| 36 |
|
| 37 |
There are following attributes in this directory: |
| 38 |
|
| 39 |
================= ==== ========================================= |
| 40 |
all_linked: (RO) if all enabled ports on this die are |
| 41 |
linked (bool). |
| 42 |
linked_full_lane: (RO) if all linked ports on this die are full |
| 43 |
lane (bool). |
| 44 |
crc_err_cnt: (RO) total CRC err count for all ports on this |
| 45 |
die. |
| 46 |
================= ==== ========================================= |
| 47 |
|
| 48 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/type |
| 49 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mode |
| 50 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/enable |
| 51 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/cur_lane_num |
| 52 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/link_fsm |
| 53 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/lane_mask |
| 54 |
What: /sys/devices/platform/HISI04Bx:00/chipX/dieY/hccsN/crc_err_cnt |
| 55 |
Date: November 2023 |
| 56 |
KernelVersion: 6.6 |
| 57 |
Contact: Huisong Li <[email protected]> |
| 58 |
Description: |
| 59 |
The /sys/devices/platform/HISI04Bx/chipX/dieX/hccsN/ directory |
| 60 |
contains read-only attributes exposing information about |
| 61 |
a HCCS port. The N value in 'hccsN' indicates this port id. |
| 62 |
The X in 'chipX' indicates the ID of the chip to which the |
| 63 |
HCCS port belongs. For example, X ranges from to 'n - 1' if the |
| 64 |
chip number on platform is n. |
| 65 |
The Y in 'dieY' indicates the hardware id of the die to which |
| 66 |
the hccs port belongs. |
| 67 |
Note: type, lane_mode and enable are fixed attributes on running |
| 68 |
platform. |
| 69 |
|
| 70 |
The HCCS port have the following attributes: |
| 71 |
|
| 72 |
============= ==== ============================================= |
| 73 |
type: (RO) port type (string), e.g. HCCS-v1 -> H32 |
| 74 |
lane_mode: (RO) the lane mode of this port (string), e.g. x8 |
| 75 |
enable: (RO) indicate if this port is enabled (bool). |
| 76 |
cur_lane_num: (RO) current lane number of this port. |
| 77 |
link_fsm: (RO) link finite state machine of this port. |
| 78 |
lane_mask: (RO) current lane mask of this port, every bit |
| 79 |
indicates a lane. |
| 80 |
crc_err_cnt: (RO) CRC err count on this port. |
| 81 |
============= ==== ============================================= |
| 82 |
|
| 83 |
What: /sys/devices/platform/HISI04Bx:00/used_types |
| 84 |
Date: August 2024 |
| 85 |
KernelVersion: 6.12 |
| 86 |
Contact: Huisong Li <[email protected]> |
| 87 |
Description: |
| 88 |
This interface is used to show all HCCS types used on the |
| 89 |
platform, like, HCCS-v1, HCCS-v2 and so on. |
| 90 |
|
| 91 |
What: /sys/devices/platform/HISI04Bx:00/available_inc_dec_lane_types |
| 92 |
What: /sys/devices/platform/HISI04Bx:00/dec_lane_of_type |
| 93 |
What: /sys/devices/platform/HISI04Bx:00/inc_lane_of_type |
| 94 |
Date: August 2024 |
| 95 |
KernelVersion: 6.12 |
| 96 |
Contact: Huisong Li <[email protected]> |
| 97 |
Description: |
| 98 |
These interfaces under /sys/devices/platform/HISI04Bx/ are |
| 99 |
used to support the low power consumption feature of some |
| 100 |
HCCS types by changing the number of lanes used. The interfaces |
| 101 |
changing the number of lanes used are 'dec_lane_of_type' and |
| 102 |
'inc_lane_of_type' which require root privileges. These |
| 103 |
interfaces aren't exposed if no HCCS type on platform support |
| 104 |
this feature. Please note that decreasing lane number is only |
| 105 |
allowed if all the specified HCCS ports are not busy. |
| 106 |
|
| 107 |
The low power consumption interfaces are as follows: |
| 108 |
|
| 109 |
============================= ==== ================================ |
| 110 |
available_inc_dec_lane_types: (RO) available HCCS types (string) to |
| 111 |
increase and decrease the number |
| 112 |
of lane used, e.g. HCCS-v2. |
| 113 |
dec_lane_of_type: (WO) input HCCS type supported |
| 114 |
decreasing lane to decrease the |
| 115 |
used lane number of all specified |
| 116 |
HCCS type ports on platform to |
| 117 |
the minimum. |
| 118 |
You can query the 'cur_lane_num' |
| 119 |
to get the minimum lane number |
| 120 |
after executing successfully. |
| 121 |
inc_lane_of_type: (WO) input HCCS type supported |
| 122 |
increasing lane to increase the |
| 123 |
used lane number of all specified |
| 124 |
HCCS type ports on platform to |
| 125 |
the full lane state. |
| 126 |
============================= ==== ================================ |