uapi/misc/habanalabs.h

1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note
3  * Copyright 2016-2020 HabanaLabs, Ltd.
15  * Defines that are asic-specific but constitutes as ABI between kernel driver
240  * HW_IP_INFO            - Receive information about different IP blocks in the
242  * HL_INFO_HW_EVENTS     - Receive an array describing how many times each event
244  * HL_INFO_DRAM_USAGE    - Retrieve the dram usage inside the device and of the
247  * HL_INFO_HW_IDLE       - Retrieve information about the idle status of each
249  * HL_INFO_DEVICE_STATUS - Retrieve the device's status. This opcode doesn't
251  * HL_INFO_DEVICE_UTILIZATION  - Retrieve the total utilization of the device
254  *                               resolution of 100ms. The return value is a
256  * HL_INFO_HW_EVENTS_AGGREGATE - Receive an array describing how many times each
258  * HL_INFO_CLK_RATE            - Retrieve the current and maximum clock rate
261  * HL_INFO_RESET_COUNT   - Retrieve the counts of the soft and hard reset
264  * HL_INFO_TIME_SYNC     - Retrieve the device's time alongside the host's time
266  * HL_INFO_CS_COUNTERS   - Retrieve command submission counters
267  * HL_INFO_PCI_COUNTERS  - Retrieve PCI counters
268  * HL_INFO_CLK_THROTTLE_REASON - Retrieve clock throttling reason
269  * HL_INFO_SYNC_MANAGER  - Retrieve sync manager info per dcore
270  * HL_INFO_TOTAL_ENERGY  - Retrieve total energy consumption
321 	 * Bits definition is according to `enum <chip>_enging_id'.
327 	 * Bits definition is according to `enum <chip>_enging_id'.
358  * struct hl_info_pci_counters - pci counters
373  * struct hl_info_clk_throttle - clock throttling reason
381  * struct hl_info_energy - device energy information
389  * struct hl_info_sync_manager - sync manager information
399  * struct hl_info_cs_counters - command submission counters
404  * @max_cs_in_flight_drop_cnt: dropped due to maximum CS in-flight
446 		/* Context ID - Currently not in use */
448 		/* Period value for utilization rate (100ms - 1000ms, in 100ms
449 		 * resolution.
463 #define HL_MAX_CB_SIZE		(0x200000 - 32)
477 	/* Context ID - Currently not in use */
494  * This structure size must always be fixed to 64-bytes for backward
558 	/* this holds address of array of hl_cs_chunk for store phase -
573 	/* Number of chunks in restore phase array - Currently not in use */
579 	/* Context ID - Currently not in use */
604 	/* Context ID - Currently not in use */
642 		/* HL_MEM_OP_ALLOC- allocate device memory */
648 		/* HL_MEM_OP_FREE - free device memory */
654 		/* HL_MEM_OP_MAP - map device memory */
670 		/* HL_MEM_OP_MAP - map host memory */
688 		/* HL_MEM_OP_UNMAP - unmap host memory */
699 	/* Context ID - Currently not in use */
708 		 * assigned in the device VA space.
714 		 * Used for HL_MEM_OP_ALLOC. This is the assigned
830 	/* Context ID - Currently not in use */
836  * - H/W IP information
837  * - Current dram usage
840  * information. The user should supply a pointer to a user-allocated memory
853  * - Request a Command Buffer
854  * - Destroy a Command Buffer
856  * The command buffers are memory blocks that reside in DMA-able address
860  * When creating a new CB, the IOCTL returns a handle of it, and the user-space
883  * The JOBS on the "restore" phase are enqueued only after context-switch
887  * There are two types of queues - external and internal. External queues
912  * with sequence number N-1 also finished. The user can make this assumption if
913  * and only if CS N and CS N-1 are exactly the same (same CBs for the same
924  * inside the kernel until the CS has finished or until the user-requested
933  * EINTR     - Kernel waiting has been interrupted, e.g. due to OS signal
935  * ETIMEDOUT - The CS has caused a timeout on the device
936  * EIO       - The CS was aborted (usually because the device was reset)
937  * ENODEV    - The device wants to do hard-reset (so user need to close FD)
941  * HL_WAIT_CS_STATUS_COMPLETED   - The CS has been completed successfully (0)
942  * HL_WAIT_CS_STATUS_BUSY        - The CS is still executing (0)
943  * HL_WAIT_CS_STATUS_TIMEDOUT    - The CS has caused a timeout on the device
945  * HL_WAIT_CS_STATUS_ABORTED     - The CS was aborted, usually because the
947  * HL_WAIT_CS_STATUS_INTERRUPTED - Waiting for the CS was interrupted (EINTR)
956  * - Map host memory to device MMU
957  * - Unmap host memory from device MMU
962  * to allocate the memory in user-space (malloc/new). The driver pins the
974  * - Enable/disable the ETR/ETF/FUNNEL/STM/BMON/SPMU debug traces
991  * set the device into non-debug mode, i.e. disable debug mode.