mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-21 08:19:28 +00:00
![Amitay Isaacs](/assets/img/avatar_default.png)
FSI_SBEFIFO_READ_TIMEOUT_SECONDS ioctl sets the read timeout (in seconds) for the response received by sbefifo device from sbe. The timeout affects only the read operation on current sbefifo device fd. Certain SBE operations can take long time to complete and the default timeout of 10 seconds might not be sufficient to start receiving response from SBE. In such cases, allow the timeout to be set to the maximum of 120 seconds. The kernel does not contain the definition of the various SBE operations, so we must expose an interface to userspace to set the timeout for the given operation. Signed-off-by: Amitay Isaacs <amitay@ozlabs.org> Signed-off-by: Joel Stanley <joel@jms.id.au> Reviewed-by: Eddie James <eajames@linux.ibm.com> Link: https://lore.kernel.org/r/20220121053816.82253-3-joel@jms.id.au Signed-off-by: Joel Stanley <joel@jms.id.au>
72 lines
2.6 KiB
C
72 lines
2.6 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
|
|
#ifndef _UAPI_LINUX_FSI_H
|
|
#define _UAPI_LINUX_FSI_H
|
|
|
|
#include <linux/types.h>
|
|
#include <linux/ioctl.h>
|
|
|
|
/*
|
|
* /dev/scom "raw" ioctl interface
|
|
*
|
|
* The driver supports a high level "read/write" interface which
|
|
* handles retries and converts the status to Linux error codes,
|
|
* however low level tools an debugger need to access the "raw"
|
|
* HW status information and interpret it themselves, so this
|
|
* ioctl interface is also provided for their use case.
|
|
*/
|
|
|
|
/* Structure for SCOM read/write */
|
|
struct scom_access {
|
|
__u64 addr; /* SCOM address, supports indirect */
|
|
__u64 data; /* SCOM data (in for write, out for read) */
|
|
__u64 mask; /* Data mask for writes */
|
|
__u32 intf_errors; /* Interface error flags */
|
|
#define SCOM_INTF_ERR_PARITY 0x00000001 /* Parity error */
|
|
#define SCOM_INTF_ERR_PROTECTION 0x00000002 /* Blocked by secure boot */
|
|
#define SCOM_INTF_ERR_ABORT 0x00000004 /* PIB reset during access */
|
|
#define SCOM_INTF_ERR_UNKNOWN 0x80000000 /* Unknown error */
|
|
/*
|
|
* Note: Any other bit set in intf_errors need to be considered as an
|
|
* error. Future implementations may define new error conditions. The
|
|
* pib_status below is only valid if intf_errors is 0.
|
|
*/
|
|
__u8 pib_status; /* 3-bit PIB status */
|
|
#define SCOM_PIB_SUCCESS 0 /* Access successful */
|
|
#define SCOM_PIB_BLOCKED 1 /* PIB blocked, pls retry */
|
|
#define SCOM_PIB_OFFLINE 2 /* Chiplet offline */
|
|
#define SCOM_PIB_PARTIAL 3 /* Partial good */
|
|
#define SCOM_PIB_BAD_ADDR 4 /* Invalid address */
|
|
#define SCOM_PIB_CLK_ERR 5 /* Clock error */
|
|
#define SCOM_PIB_PARITY_ERR 6 /* Parity error on the PIB bus */
|
|
#define SCOM_PIB_TIMEOUT 7 /* Bus timeout */
|
|
__u8 pad;
|
|
};
|
|
|
|
/* Flags for SCOM check */
|
|
#define SCOM_CHECK_SUPPORTED 0x00000001 /* Interface supported */
|
|
#define SCOM_CHECK_PROTECTED 0x00000002 /* Interface blocked by secure boot */
|
|
|
|
/* Flags for SCOM reset */
|
|
#define SCOM_RESET_INTF 0x00000001 /* Reset interface */
|
|
#define SCOM_RESET_PIB 0x00000002 /* Reset PIB */
|
|
|
|
#define FSI_SCOM_CHECK _IOR('s', 0x00, __u32)
|
|
#define FSI_SCOM_READ _IOWR('s', 0x01, struct scom_access)
|
|
#define FSI_SCOM_WRITE _IOWR('s', 0x02, struct scom_access)
|
|
#define FSI_SCOM_RESET _IOW('s', 0x03, __u32)
|
|
|
|
/*
|
|
* /dev/sbefifo* ioctl interface
|
|
*/
|
|
|
|
/**
|
|
* FSI_SBEFIFO_READ_TIMEOUT sets the read timeout for response from SBE.
|
|
*
|
|
* The read timeout is specified in seconds. The minimum value of read
|
|
* timeout is 10 seconds (default) and the maximum value of read timeout is
|
|
* 120 seconds. A read timeout of 0 will reset the value to the default of
|
|
* (10 seconds).
|
|
*/
|
|
#define FSI_SBEFIFO_READ_TIMEOUT_SECONDS _IOW('s', 0x00, __u32)
|
|
|
|
#endif /* _UAPI_LINUX_FSI_H */
|