1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */ 2 #ifndef _UAPI_LINUX_FSI_H 3 #define _UAPI_LINUX_FSI_H 4 5 #include <linux/types.h> 6 #include <linux/ioctl.h> 7 8 /* 9 * /dev/scom "raw" ioctl interface 10 * 11 * The driver supports a high level "read/write" interface which 12 * handles retries and converts the status to Linux error codes, 13 * however low level tools an debugger need to access the "raw" 14 * HW status information and interpret it themselves, so this 15 * ioctl interface is also provided for their use case. 16 */ 17 18 /* Structure for SCOM read/write */ 19 struct scom_access { 20 __u64 addr; /* SCOM address, supports indirect */ 21 __u64 data; /* SCOM data (in for write, out for read) */ 22 __u64 mask; /* Data mask for writes */ 23 __u32 intf_errors; /* Interface error flags */ 24 #define SCOM_INTF_ERR_PARITY 0x00000001 /* Parity error */ 25 #define SCOM_INTF_ERR_PROTECTION 0x00000002 /* Blocked by secure boot */ 26 #define SCOM_INTF_ERR_ABORT 0x00000004 /* PIB reset during access */ 27 #define SCOM_INTF_ERR_UNKNOWN 0x80000000 /* Unknown error */ 28 /* 29 * Note: Any other bit set in intf_errors need to be considered as an 30 * error. Future implementations may define new error conditions. The 31 * pib_status below is only valid if intf_errors is 0. 32 */ 33 __u8 pib_status; /* 3-bit PIB status */ 34 #define SCOM_PIB_SUCCESS 0 /* Access successful */ 35 #define SCOM_PIB_BLOCKED 1 /* PIB blocked, pls retry */ 36 #define SCOM_PIB_OFFLINE 2 /* Chiplet offline */ 37 #define SCOM_PIB_PARTIAL 3 /* Partial good */ 38 #define SCOM_PIB_BAD_ADDR 4 /* Invalid address */ 39 #define SCOM_PIB_CLK_ERR 5 /* Clock error */ 40 #define SCOM_PIB_PARITY_ERR 6 /* Parity error on the PIB bus */ 41 #define SCOM_PIB_TIMEOUT 7 /* Bus timeout */ 42 __u8 pad; 43 }; 44 45 /* Flags for SCOM check */ 46 #define SCOM_CHECK_SUPPORTED 0x00000001 /* Interface supported */ 47 #define SCOM_CHECK_PROTECTED 0x00000002 /* Interface blocked by secure boot */ 48 49 /* Flags for SCOM reset */ 50 #define SCOM_RESET_INTF 0x00000001 /* Reset interface */ 51 #define SCOM_RESET_PIB 0x00000002 /* Reset PIB */ 52 53 #define FSI_SCOM_CHECK _IOR('s', 0x00, __u32) 54 #define FSI_SCOM_READ _IOWR('s', 0x01, struct scom_access) 55 #define FSI_SCOM_WRITE _IOWR('s', 0x02, struct scom_access) 56 #define FSI_SCOM_RESET _IOW('s', 0x03, __u32) 57 58 /* 59 * /dev/sbefifo* ioctl interface 60 */ 61 62 /** 63 * FSI_SBEFIFO_CMD_TIMEOUT sets the timeout for writing data to the SBEFIFO. 64 * 65 * The command timeout is specified in seconds. The minimum value of command 66 * timeout is 1 seconds (default) and the maximum value of command timeout is 67 * 120 seconds. A command timeout of 0 will reset the value to the default of 68 * 1 seconds. 69 */ 70 #define FSI_SBEFIFO_CMD_TIMEOUT_SECONDS _IOW('s', 0x01, __u32) 71 72 /** 73 * FSI_SBEFIFO_READ_TIMEOUT sets the read timeout for response from SBE. 74 * 75 * The read timeout is specified in seconds. The minimum value of read 76 * timeout is 10 seconds (default) and the maximum value of read timeout is 77 * 120 seconds. A read timeout of 0 will reset the value to the default of 78 * (10 seconds). 79 */ 80 #define FSI_SBEFIFO_READ_TIMEOUT_SECONDS _IOW('s', 0x00, __u32) 81 82 #endif /* _UAPI_LINUX_FSI_H */ 83