2005-04-16 22:20:36 +00:00
|
|
|
/*
|
2006-10-03 21:01:26 +00:00
|
|
|
* linux/include/asm-s390/qdio.h
|
2005-04-16 22:20:36 +00:00
|
|
|
*
|
|
|
|
* Linux for S/390 QDIO base support, Hipersocket base support
|
|
|
|
* version 2
|
|
|
|
*
|
|
|
|
* Copyright 2000,2002 IBM Corporation
|
|
|
|
* Author(s): Utz Bacher <utz.bacher@de.ibm.com>
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
#ifndef __QDIO_H__
|
|
|
|
#define __QDIO_H__
|
|
|
|
|
|
|
|
/* note, that most of the typedef's are from ingo. */
|
|
|
|
|
|
|
|
#include <linux/interrupt.h>
|
|
|
|
#include <asm/cio.h>
|
|
|
|
#include <asm/ccwdev.h>
|
|
|
|
|
|
|
|
#define QDIO_NAME "qdio "
|
|
|
|
|
|
|
|
#ifndef __s390x__
|
|
|
|
#define QDIO_32_BIT
|
|
|
|
#endif /* __s390x__ */
|
|
|
|
|
|
|
|
/**** CONSTANTS, that are relied on without using these symbols *****/
|
|
|
|
#define QDIO_MAX_QUEUES_PER_IRQ 32 /* used in width of unsigned int */
|
|
|
|
/************************ END of CONSTANTS **************************/
|
|
|
|
#define QDIO_MAX_BUFFERS_PER_Q 128 /* must be a power of 2 (%x=&(x-1)*/
|
|
|
|
#define QDIO_BUF_ORDER 7 /* 2**this == number of pages used for sbals in 1 q */
|
|
|
|
#define QDIO_MAX_ELEMENTS_PER_BUFFER 16
|
|
|
|
#define SBAL_SIZE 256
|
|
|
|
|
|
|
|
#define QDIO_QETH_QFMT 0
|
|
|
|
#define QDIO_ZFCP_QFMT 1
|
|
|
|
#define QDIO_IQDIO_QFMT 2
|
2006-12-15 16:18:14 +00:00
|
|
|
#define QDIO_IQDIO_QFMT_ASYNCH 3
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
struct qdio_buffer_element{
|
|
|
|
unsigned int flags;
|
|
|
|
unsigned int length;
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
void *reserved;
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
void *addr;
|
|
|
|
} __attribute__ ((packed,aligned(16)));
|
|
|
|
|
|
|
|
struct qdio_buffer{
|
|
|
|
volatile struct qdio_buffer_element element[16];
|
|
|
|
} __attribute__ ((packed,aligned(256)));
|
|
|
|
|
|
|
|
|
|
|
|
/* params are: ccw_device, status, qdio_error, siga_error,
|
|
|
|
queue_number, first element processed, number of elements processed,
|
|
|
|
int_parm */
|
|
|
|
typedef void qdio_handler_t(struct ccw_device *,unsigned int,unsigned int,
|
|
|
|
unsigned int,unsigned int,int,int,unsigned long);
|
|
|
|
|
|
|
|
|
|
|
|
#define QDIO_STATUS_INBOUND_INT 0x01
|
|
|
|
#define QDIO_STATUS_OUTBOUND_INT 0x02
|
|
|
|
#define QDIO_STATUS_LOOK_FOR_ERROR 0x04
|
|
|
|
#define QDIO_STATUS_MORE_THAN_ONE_QDIO_ERROR 0x08
|
|
|
|
#define QDIO_STATUS_MORE_THAN_ONE_SIGA_ERROR 0x10
|
|
|
|
#define QDIO_STATUS_ACTIVATE_CHECK_CONDITION 0x20
|
|
|
|
|
|
|
|
#define QDIO_SIGA_ERROR_ACCESS_EXCEPTION 0x10
|
|
|
|
#define QDIO_SIGA_ERROR_B_BIT_SET 0x20
|
|
|
|
|
|
|
|
/* for qdio_initialize */
|
|
|
|
#define QDIO_INBOUND_0COPY_SBALS 0x01
|
|
|
|
#define QDIO_OUTBOUND_0COPY_SBALS 0x02
|
|
|
|
#define QDIO_USE_OUTBOUND_PCIS 0x04
|
|
|
|
|
|
|
|
/* for qdio_cleanup */
|
|
|
|
#define QDIO_FLAG_CLEANUP_USING_CLEAR 0x01
|
|
|
|
#define QDIO_FLAG_CLEANUP_USING_HALT 0x02
|
|
|
|
|
|
|
|
struct qdio_initialize {
|
|
|
|
struct ccw_device *cdev;
|
|
|
|
unsigned char q_format;
|
|
|
|
unsigned char adapter_name[8];
|
|
|
|
unsigned int qib_param_field_format; /*adapter dependent*/
|
|
|
|
/* pointer to 128 bytes or NULL, if no param field */
|
|
|
|
unsigned char *qib_param_field; /* adapter dependent */
|
|
|
|
/* pointer to no_queues*128 words of data or NULL */
|
|
|
|
unsigned long *input_slib_elements;
|
|
|
|
unsigned long *output_slib_elements;
|
|
|
|
unsigned int min_input_threshold;
|
|
|
|
unsigned int max_input_threshold;
|
|
|
|
unsigned int min_output_threshold;
|
|
|
|
unsigned int max_output_threshold;
|
|
|
|
unsigned int no_input_qs;
|
|
|
|
unsigned int no_output_qs;
|
|
|
|
qdio_handler_t *input_handler;
|
|
|
|
qdio_handler_t *output_handler;
|
|
|
|
unsigned long int_parm;
|
|
|
|
unsigned long flags;
|
|
|
|
void **input_sbal_addr_array; /* addr of n*128 void ptrs */
|
|
|
|
void **output_sbal_addr_array; /* addr of n*128 void ptrs */
|
|
|
|
};
|
|
|
|
|
|
|
|
extern int qdio_initialize(struct qdio_initialize *init_data);
|
|
|
|
extern int qdio_allocate(struct qdio_initialize *init_data);
|
|
|
|
extern int qdio_establish(struct qdio_initialize *init_data);
|
|
|
|
|
|
|
|
extern int qdio_activate(struct ccw_device *,int flags);
|
|
|
|
|
|
|
|
#define QDIO_STATE_MUST_USE_OUTB_PCI 0x00000001
|
|
|
|
#define QDIO_STATE_INACTIVE 0x00000002 /* after qdio_cleanup */
|
|
|
|
#define QDIO_STATE_ESTABLISHED 0x00000004 /* after qdio_initialize */
|
|
|
|
#define QDIO_STATE_ACTIVE 0x00000008 /* after qdio_activate */
|
|
|
|
#define QDIO_STATE_STOPPED 0x00000010 /* after queues went down */
|
|
|
|
extern unsigned long qdio_get_status(int irq);
|
|
|
|
|
|
|
|
|
|
|
|
#define QDIO_FLAG_SYNC_INPUT 0x01
|
|
|
|
#define QDIO_FLAG_SYNC_OUTPUT 0x02
|
|
|
|
#define QDIO_FLAG_UNDER_INTERRUPT 0x04
|
|
|
|
#define QDIO_FLAG_NO_INPUT_INTERRUPT_CONTEXT 0x08 /* no effect on
|
|
|
|
adapter interrupts */
|
|
|
|
#define QDIO_FLAG_DONT_SIGA 0x10
|
2007-05-02 13:18:07 +00:00
|
|
|
#define QDIO_FLAG_PCI_OUT 0x20
|
2005-04-16 22:20:36 +00:00
|
|
|
|
|
|
|
extern int do_QDIO(struct ccw_device*, unsigned int flags,
|
|
|
|
unsigned int queue_number,
|
|
|
|
unsigned int qidx,unsigned int count,
|
|
|
|
struct qdio_buffer *buffers);
|
|
|
|
|
|
|
|
extern int qdio_synchronize(struct ccw_device*, unsigned int flags,
|
|
|
|
unsigned int queue_number);
|
|
|
|
|
|
|
|
extern int qdio_cleanup(struct ccw_device*, int how);
|
|
|
|
extern int qdio_shutdown(struct ccw_device*, int how);
|
|
|
|
extern int qdio_free(struct ccw_device*);
|
|
|
|
|
|
|
|
unsigned char qdio_get_slsb_state(struct ccw_device*, unsigned int flag,
|
|
|
|
unsigned int queue_number,
|
|
|
|
unsigned int qidx);
|
|
|
|
|
|
|
|
extern void qdio_init_scrubber(void);
|
|
|
|
|
|
|
|
struct qdesfmt0 {
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res1; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long sliba; /* storage-list-information-block
|
|
|
|
address */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res2; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long sla; /* storage-list address */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res3; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long slsba; /* storage-list-state-block address */
|
|
|
|
unsigned int res4; /* reserved */
|
|
|
|
unsigned int akey : 4; /* access key for DLIB */
|
|
|
|
unsigned int bkey : 4; /* access key for SL */
|
|
|
|
unsigned int ckey : 4; /* access key for SBALs */
|
|
|
|
unsigned int dkey : 4; /* access key for SLSB */
|
|
|
|
unsigned int res5 : 16; /* reserved */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Queue-Description record (QDR)
|
|
|
|
*/
|
|
|
|
struct qdr {
|
|
|
|
unsigned int qfmt : 8; /* queue format */
|
|
|
|
unsigned int pfmt : 8; /* impl. dep. parameter format */
|
|
|
|
unsigned int res1 : 8; /* reserved */
|
|
|
|
unsigned int ac : 8; /* adapter characteristics */
|
|
|
|
unsigned int res2 : 8; /* reserved */
|
|
|
|
unsigned int iqdcnt : 8; /* input-queue-descriptor count */
|
|
|
|
unsigned int res3 : 8; /* reserved */
|
|
|
|
unsigned int oqdcnt : 8; /* output-queue-descriptor count */
|
|
|
|
unsigned int res4 : 8; /* reserved */
|
|
|
|
unsigned int iqdsz : 8; /* input-queue-descriptor size */
|
|
|
|
unsigned int res5 : 8; /* reserved */
|
|
|
|
unsigned int oqdsz : 8; /* output-queue-descriptor size */
|
|
|
|
unsigned int res6[9]; /* reserved */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res7; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long qiba; /* queue-information-block address */
|
|
|
|
unsigned int res8; /* reserved */
|
|
|
|
unsigned int qkey : 4; /* queue-informatio-block key */
|
|
|
|
unsigned int res9 : 28; /* reserved */
|
|
|
|
/* union _qd {*/ /* why this? */
|
|
|
|
struct qdesfmt0 qdf0[126];
|
|
|
|
/* } qd;*/
|
|
|
|
} __attribute__ ((packed,aligned(4096)));
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* queue information block (QIB)
|
|
|
|
*/
|
2006-01-06 08:19:20 +00:00
|
|
|
#define QIB_AC_INBOUND_PCI_SUPPORTED 0x80
|
|
|
|
#define QIB_AC_OUTBOUND_PCI_SUPPORTED 0x40
|
|
|
|
#define QIB_RFLAGS_ENABLE_QEBSM 0x80
|
|
|
|
|
2005-04-16 22:20:36 +00:00
|
|
|
struct qib {
|
|
|
|
unsigned int qfmt : 8; /* queue format */
|
|
|
|
unsigned int pfmt : 8; /* impl. dep. parameter format */
|
2006-01-06 08:19:20 +00:00
|
|
|
unsigned int rflags : 8; /* QEBSM */
|
2005-04-16 22:20:36 +00:00
|
|
|
unsigned int ac : 8; /* adapter characteristics */
|
|
|
|
unsigned int res2; /* reserved */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res3; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long isliba; /* absolute address of 1st
|
|
|
|
input SLIB */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res4; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long osliba; /* absolute address of 1st
|
|
|
|
output SLIB */
|
|
|
|
unsigned int res5; /* reserved */
|
|
|
|
unsigned int res6; /* reserved */
|
|
|
|
unsigned char ebcnam[8]; /* adapter identifier in EBCDIC */
|
|
|
|
unsigned char res7[88]; /* reserved */
|
|
|
|
unsigned char parm[QDIO_MAX_BUFFERS_PER_Q];
|
|
|
|
/* implementation dependent
|
|
|
|
parameters */
|
|
|
|
} __attribute__ ((packed,aligned(256)));
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* storage-list-information block element (SLIBE)
|
|
|
|
*/
|
|
|
|
struct slibe {
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long parms; /* implementation dependent
|
|
|
|
parameters */
|
|
|
|
};
|
|
|
|
|
|
|
|
/*
|
|
|
|
* storage-list-information block (SLIB)
|
|
|
|
*/
|
|
|
|
struct slib {
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res1; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long nsliba; /* next SLIB address (if any) */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res2; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long sla; /* SL address */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res3; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long slsba; /* SLSB address */
|
|
|
|
unsigned char res4[1000]; /* reserved */
|
|
|
|
struct slibe slibe[QDIO_MAX_BUFFERS_PER_Q]; /* SLIB elements */
|
|
|
|
} __attribute__ ((packed,aligned(2048)));
|
|
|
|
|
|
|
|
struct sbal_flags {
|
|
|
|
unsigned char res1 : 1; /* reserved */
|
|
|
|
unsigned char last : 1; /* last entry */
|
|
|
|
unsigned char cont : 1; /* contiguous storage */
|
|
|
|
unsigned char res2 : 1; /* reserved */
|
|
|
|
unsigned char frag : 2; /* fragmentation (s.below) */
|
|
|
|
unsigned char res3 : 2; /* reserved */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
#define SBAL_FLAGS_FIRST_FRAG 0x04000000UL
|
|
|
|
#define SBAL_FLAGS_MIDDLE_FRAG 0x08000000UL
|
|
|
|
#define SBAL_FLAGS_LAST_FRAG 0x0c000000UL
|
|
|
|
#define SBAL_FLAGS_LAST_ENTRY 0x40000000UL
|
|
|
|
#define SBAL_FLAGS_CONTIGUOUS 0x20000000UL
|
|
|
|
|
|
|
|
#define SBAL_FLAGS0_DATA_CONTINUATION 0x20UL
|
|
|
|
|
|
|
|
/* Awesome OpenFCP extensions */
|
|
|
|
#define SBAL_FLAGS0_TYPE_STATUS 0x00UL
|
|
|
|
#define SBAL_FLAGS0_TYPE_WRITE 0x08UL
|
|
|
|
#define SBAL_FLAGS0_TYPE_READ 0x10UL
|
|
|
|
#define SBAL_FLAGS0_TYPE_WRITE_READ 0x18UL
|
|
|
|
#define SBAL_FLAGS0_MORE_SBALS 0x04UL
|
|
|
|
#define SBAL_FLAGS0_COMMAND 0x02UL
|
|
|
|
#define SBAL_FLAGS0_LAST_SBAL 0x00UL
|
|
|
|
#define SBAL_FLAGS0_ONLY_SBAL SBAL_FLAGS0_COMMAND
|
|
|
|
#define SBAL_FLAGS0_MIDDLE_SBAL SBAL_FLAGS0_MORE_SBALS
|
|
|
|
#define SBAL_FLAGS0_FIRST_SBAL SBAL_FLAGS0_MORE_SBALS | SBAL_FLAGS0_COMMAND
|
|
|
|
/* Naught of interest beyond this point */
|
|
|
|
|
|
|
|
#define SBAL_FLAGS0_PCI 0x40
|
|
|
|
struct sbal_sbalf_0 {
|
|
|
|
unsigned char res1 : 1; /* reserved */
|
|
|
|
unsigned char pci : 1; /* PCI indicator */
|
|
|
|
unsigned char cont : 1; /* data continuation */
|
|
|
|
unsigned char sbtype: 2; /* storage-block type (OpenFCP) */
|
|
|
|
unsigned char res2 : 3; /* reserved */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
struct sbal_sbalf_1 {
|
|
|
|
unsigned char res1 : 4; /* reserved */
|
|
|
|
unsigned char key : 4; /* storage key */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
struct sbal_sbalf_14 {
|
|
|
|
unsigned char res1 : 4; /* reserved */
|
|
|
|
unsigned char erridx : 4; /* error index */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
struct sbal_sbalf_15 {
|
|
|
|
unsigned char reason; /* reserved */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
union sbal_sbalf {
|
|
|
|
struct sbal_sbalf_0 i0;
|
|
|
|
struct sbal_sbalf_1 i1;
|
|
|
|
struct sbal_sbalf_14 i14;
|
|
|
|
struct sbal_sbalf_15 i15;
|
|
|
|
unsigned char value;
|
|
|
|
};
|
|
|
|
|
|
|
|
struct sbal_element {
|
|
|
|
union {
|
|
|
|
struct sbal_flags bits; /* flags */
|
|
|
|
unsigned char value;
|
|
|
|
} flags;
|
|
|
|
unsigned int res1 : 16; /* reserved */
|
|
|
|
union sbal_sbalf sbalf; /* SBAL flags */
|
|
|
|
unsigned int res2 : 16; /* reserved */
|
|
|
|
unsigned int count : 16; /* data count */
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res3; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long addr; /* absolute data address */
|
|
|
|
} __attribute__ ((packed,aligned(16)));
|
|
|
|
|
|
|
|
/*
|
|
|
|
* strorage-block access-list (SBAL)
|
|
|
|
*/
|
|
|
|
struct sbal {
|
|
|
|
struct sbal_element element[QDIO_MAX_ELEMENTS_PER_BUFFER];
|
|
|
|
} __attribute__ ((packed,aligned(256)));
|
|
|
|
|
|
|
|
/*
|
|
|
|
* storage-list (SL)
|
|
|
|
*/
|
|
|
|
struct sl_element {
|
|
|
|
#ifdef QDIO_32_BIT
|
|
|
|
unsigned long res; /* reserved */
|
|
|
|
#endif /* QDIO_32_BIT */
|
|
|
|
unsigned long sbal; /* absolute SBAL address */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
struct sl {
|
|
|
|
struct sl_element element[QDIO_MAX_BUFFERS_PER_Q];
|
|
|
|
} __attribute__ ((packed,aligned(1024)));
|
|
|
|
|
|
|
|
/*
|
|
|
|
* storage-list-state block (SLSB)
|
|
|
|
*/
|
|
|
|
struct slsb_flags {
|
|
|
|
unsigned char owner : 2; /* SBAL owner */
|
|
|
|
unsigned char type : 1; /* buffer type */
|
|
|
|
unsigned char state : 5; /* processing state */
|
|
|
|
} __attribute__ ((packed));
|
|
|
|
|
|
|
|
|
|
|
|
struct slsb {
|
|
|
|
union {
|
|
|
|
unsigned char val[QDIO_MAX_BUFFERS_PER_Q];
|
|
|
|
struct slsb_flags flags[QDIO_MAX_BUFFERS_PER_Q];
|
|
|
|
} acc;
|
|
|
|
} __attribute__ ((packed,aligned(256)));
|
|
|
|
|
|
|
|
/*
|
|
|
|
* SLSB values
|
|
|
|
*/
|
|
|
|
#define SLSB_OWNER_PROG 1
|
|
|
|
#define SLSB_OWNER_CU 2
|
|
|
|
|
|
|
|
#define SLSB_TYPE_INPUT 0
|
|
|
|
#define SLSB_TYPE_OUTPUT 1
|
|
|
|
|
|
|
|
#define SLSB_STATE_NOT_INIT 0
|
|
|
|
#define SLSB_STATE_EMPTY 1
|
|
|
|
#define SLSB_STATE_PRIMED 2
|
|
|
|
#define SLSB_STATE_HALTED 0xe
|
|
|
|
#define SLSB_STATE_ERROR 0xf
|
|
|
|
|
|
|
|
#define SLSB_P_INPUT_NOT_INIT 0x80
|
|
|
|
#define SLSB_P_INPUT_PROCESSING 0x81
|
|
|
|
#define SLSB_CU_INPUT_EMPTY 0x41
|
|
|
|
#define SLSB_P_INPUT_PRIMED 0x82
|
|
|
|
#define SLSB_P_INPUT_HALTED 0x8E
|
|
|
|
#define SLSB_P_INPUT_ERROR 0x8F
|
|
|
|
|
|
|
|
#define SLSB_P_OUTPUT_NOT_INIT 0xA0
|
|
|
|
#define SLSB_P_OUTPUT_EMPTY 0xA1
|
|
|
|
#define SLSB_CU_OUTPUT_PRIMED 0x62
|
|
|
|
#define SLSB_P_OUTPUT_HALTED 0xAE
|
|
|
|
#define SLSB_P_OUTPUT_ERROR 0xAF
|
|
|
|
|
|
|
|
#define SLSB_ERROR_DURING_LOOKUP 0xFF
|
|
|
|
|
|
|
|
#endif /* __QDIO_H__ */
|