Documentation/ABI/testing/sysfs-driver-habanalabs

   1 What:           /sys/class/habanalabs/hl<n>/armcp_kernel_ver
   2 Date:           Jan 2019
   3 KernelVersion:  5.1
   4 Contact:        oded.gabbay@gmail.com
   5 Description:    Version of the Linux kernel running on the device's CPU
   6
   7 What:           /sys/class/habanalabs/hl<n>/armcp_ver
   8 Date:           Jan 2019
   9 KernelVersion:  5.1
  10 Contact:        oded.gabbay@gmail.com
  11 Description:    Version of the application running on the device's CPU
  12
  13 What:           /sys/class/habanalabs/hl<n>/cpld_ver
  14 Date:           Jan 2019
  15 KernelVersion:  5.1
  16 Contact:        oded.gabbay@gmail.com
  17 Description:    Version of the Device's CPLD F/W
  18
  19 What:           /sys/class/habanalabs/hl<n>/device_type
  20 Date:           Jan 2019
  21 KernelVersion:  5.1
  22 Contact:        oded.gabbay@gmail.com
  23 Description:    Displays the code name of the device according to its type.
  24                 The supported values are: "GOYA"
  25
  26 What:           /sys/class/habanalabs/hl<n>/eeprom
  27 Date:           Jan 2019
  28 KernelVersion:  5.1
  29 Contact:        oded.gabbay@gmail.com
  30 Description:    A binary file attribute that contains the contents of the
  31                 on-board EEPROM
  32
  33 What:           /sys/class/habanalabs/hl<n>/fuse_ver
  34 Date:           Jan 2019
  35 KernelVersion:  5.1
  36 Contact:        oded.gabbay@gmail.com
  37 Description:    Displays the device's version from the eFuse
  38
  39 What:           /sys/class/habanalabs/hl<n>/hard_reset
  40 Date:           Jan 2019
  41 KernelVersion:  5.1
  42 Contact:        oded.gabbay@gmail.com
  43 Description:    Interface to trigger a hard-reset operation for the device.
  44                 Hard-reset will reset ALL internal components of the device
  45                 except for the PCI interface and the internal PLLs
  46
  47 What:           /sys/class/habanalabs/hl<n>/hard_reset_cnt
  48 Date:           Jan 2019
  49 KernelVersion:  5.1
  50 Contact:        oded.gabbay@gmail.com
  51 Description:    Displays how many times the device have undergone a hard-reset
  52                 operation since the driver was loaded
  53
  54 What:           /sys/class/habanalabs/hl<n>/high_pll
  55 Date:           Jan 2019
  56 KernelVersion:  5.1
  57 Contact:        oded.gabbay@gmail.com
  58 Description:    Allows the user to set the maximum clock frequency for MME, TPC
  59                 and IC when the power management profile is set to "automatic".
  60
  61 What:           /sys/class/habanalabs/hl<n>/ic_clk
  62 Date:           Jan 2019
  63 KernelVersion:  5.1
  64 Contact:        oded.gabbay@gmail.com
  65 Description:    Allows the user to set the maximum clock frequency of the
  66                 Interconnect fabric. Writes to this parameter affect the device
  67                 only when the power management profile is set to "manual" mode.
  68                 The device IC clock might be set to lower value then the
  69                 maximum. The user should read the ic_clk_curr to see the actual
  70                 frequency value of the IC
  71
  72 What:           /sys/class/habanalabs/hl<n>/ic_clk_curr
  73 Date:           Jan 2019
  74 KernelVersion:  5.1
  75 Contact:        oded.gabbay@gmail.com
  76 Description:    Displays the current clock frequency of the Interconnect fabric
  77
  78 What:           /sys/class/habanalabs/hl<n>/infineon_ver
  79 Date:           Jan 2019
  80 KernelVersion:  5.1
  81 Contact:        oded.gabbay@gmail.com
  82 Description:    Version of the Device's power supply F/W code
  83
  84 What:           /sys/class/habanalabs/hl<n>/max_power
  85 Date:           Jan 2019
  86 KernelVersion:  5.1
  87 Contact:        oded.gabbay@gmail.com
  88 Description:    Allows the user to set the maximum power consumption of the
  89                 device in milliwatts.
  90
  91 What:           /sys/class/habanalabs/hl<n>/mme_clk
  92 Date:           Jan 2019
  93 KernelVersion:  5.1
  94 Contact:        oded.gabbay@gmail.com
  95 Description:    Allows the user to set the maximum clock frequency of the
  96                 MME compute engine. Writes to this parameter affect the device
  97                 only when the power management profile is set to "manual" mode.
  98                 The device MME clock might be set to lower value then the
  99                 maximum. The user should read the mme_clk_curr to see the actual
 100                 frequency value of the MME
 101
 102 What:           /sys/class/habanalabs/hl<n>/mme_clk_curr
 103 Date:           Jan 2019
 104 KernelVersion:  5.1
 105 Contact:        oded.gabbay@gmail.com
 106 Description:    Displays the current clock frequency of the MME compute engine
 107
 108 What:           /sys/class/habanalabs/hl<n>/pci_addr
 109 Date:           Jan 2019
 110 KernelVersion:  5.1
 111 Contact:        oded.gabbay@gmail.com
 112 Description:    Displays the PCI address of the device. This is needed so the
 113                 user would be able to open a device based on its PCI address
 114
 115 What:           /sys/class/habanalabs/hl<n>/pm_mng_profile
 116 Date:           Jan 2019
 117 KernelVersion:  5.1
 118 Contact:        oded.gabbay@gmail.com
 119 Description:    Power management profile. Values are "auto", "manual". In "auto"
 120                 mode, the driver will set the maximum clock frequency to a high
 121                 value when a user-space process opens the device's file (unless
 122                 it was already opened by another process). The driver will set
 123                 the max clock frequency to a low value when there are no user
 124                 processes that are opened on the device's file. In "manual"
 125                 mode, the user sets the maximum clock frequency by writing to
 126                 ic_clk, mme_clk and tpc_clk
 127
 128
 129 What:           /sys/class/habanalabs/hl<n>/preboot_btl_ver
 130 Date:           Jan 2019
 131 KernelVersion:  5.1
 132 Contact:        oded.gabbay@gmail.com
 133 Description:    Version of the device's preboot F/W code
 134
 135 What:           /sys/class/habanalabs/hl<n>/soft_reset
 136 Date:           Jan 2019
 137 KernelVersion:  5.1
 138 Contact:        oded.gabbay@gmail.com
 139 Description:    Interface to trigger a soft-reset operation for the device.
 140                 Soft-reset will reset only the compute and DMA engines of the
 141                 device
 142
 143 What:           /sys/class/habanalabs/hl<n>/soft_reset_cnt
 144 Date:           Jan 2019
 145 KernelVersion:  5.1
 146 Contact:        oded.gabbay@gmail.com
 147 Description:    Displays how many times the device have undergone a soft-reset
 148                 operation since the driver was loaded
 149
 150 What:           /sys/class/habanalabs/hl<n>/status
 151 Date:           Jan 2019
 152 KernelVersion:  5.1
 153 Contact:        oded.gabbay@gmail.com
 154 Description:    Status of the card: "Operational", "Malfunction", "In reset".
 155
 156 What:           /sys/class/habanalabs/hl<n>/thermal_ver
 157 Date:           Jan 2019
 158 KernelVersion:  5.1
 159 Contact:        oded.gabbay@gmail.com
 160 Description:    Version of the Device's thermal daemon
 161
 162 What:           /sys/class/habanalabs/hl<n>/tpc_clk
 163 Date:           Jan 2019
 164 KernelVersion:  5.1
 165 Contact:        oded.gabbay@gmail.com
 166 Description:    Allows the user to set the maximum clock frequency of the
 167                 TPC compute engines. Writes to this parameter affect the device
 168                 only when the power management profile is set to "manual" mode.
 169                 The device TPC clock might be set to lower value then the
 170                 maximum. The user should read the tpc_clk_curr to see the actual
 171                 frequency value of the TPC
 172
 173 What:           /sys/class/habanalabs/hl<n>/tpc_clk_curr
 174 Date:           Jan 2019
 175 KernelVersion:  5.1
 176 Contact:        oded.gabbay@gmail.com
 177 Description:    Displays the current clock frequency of the TPC compute engines
 178
 179 What:           /sys/class/habanalabs/hl<n>/uboot_ver
 180 Date:           Jan 2019
 181 KernelVersion:  5.1
 182 Contact:        oded.gabbay@gmail.com
 183 Description:    Version of the u-boot running on the device's CPU
 184
 185 What:           /sys/class/habanalabs/hl<n>/write_open_cnt
 186 Date:           Jan 2019
 187 KernelVersion:  5.1
 188 Contact:        oded.gabbay@gmail.com
 189 Description:    Displays the total number of user processes that are currently
 190                 opened on the device's file