]> pilppa.org Git - linux-2.6-omap-h63xx.git/blobdiff - drivers/ieee1394/sbp2.h
Merge branch 'upstream-linus' of master.kernel.org:/pub/scm/linux/kernel/git/jgarzik...
[linux-2.6-omap-h63xx.git] / drivers / ieee1394 / sbp2.h
index 5483b458bd77de3c9ba125a28d51ef109585c438..333a4bb767434997bc0fa06e6fd922a063d46c86 100644 (file)
@@ -25,7 +25,7 @@
 #define SBP2_DEVICE_NAME               "sbp2"
 
 /*
- * SBP2 specific structures and defines
+ * SBP-2 specific definitions
  */
 
 #define ORB_DIRECTION_WRITE_TO_MEDIA   0x0
@@ -67,7 +67,7 @@ struct sbp2_command_orb {
 #define ORB_SET_LUN(v)                 ((v) & 0xffff)
 #define ORB_SET_FUNCTION(v)            (((v) & 0xf) << 16)
 #define ORB_SET_RECONNECT(v)           (((v) & 0xf) << 20)
-#define ORB_SET_EXCLUSIVE(v)           (((v) & 0x1) << 28)
+#define ORB_SET_EXCLUSIVE(v)           ((v) ? 1 << 28 : 0)
 #define ORB_SET_LOGIN_RESP_LENGTH(v)   ((v) & 0xffff)
 #define ORB_SET_PASSWD_LENGTH(v)       (((v) & 0xffff) << 16)
 
@@ -185,8 +185,9 @@ struct sbp2_status_block {
        u8 command_set_dependent[24];
 } __attribute__((packed));
 
+
 /*
- * Miscellaneous SBP2 related config rom defines
+ * SBP2 related configuration ROM definitions
  */
 
 #define SBP2_UNIT_DIRECTORY_OFFSET_KEY         0xd1
@@ -207,19 +208,17 @@ struct sbp2_status_block {
 #define SBP2_UNSOLICITED_STATUS_VALUE          0xf
 
 #define SBP2_BUSY_TIMEOUT_ADDRESS              0xfffff0000210ULL
+/* biggest possible value for Single Phase Retry count is 0xf */
 #define SBP2_BUSY_TIMEOUT_VALUE                        0xf
 
 #define SBP2_AGENT_RESET_DATA                  0xf
 
-/*
- * Unit spec id and sw version entry for SBP-2 devices
- */
-
 #define SBP2_UNIT_SPEC_ID_ENTRY                        0x0000609e
 #define SBP2_SW_VERSION_ENTRY                  0x00010483
 
+
 /*
- * SCSI specific stuff
+ * SCSI specific definitions
  */
 
 #define SBP2_MAX_SG_ELEMENT_LENGTH             0xf000
@@ -237,44 +236,45 @@ struct sbp2_status_block {
 #define SBP2_SCSI_STATUS_COMMAND_TERMINATED    0x22
 #define SBP2_SCSI_STATUS_SELECTION_TIMEOUT     0xff
 
-/* This is the two dma types we use for cmd_dma below */
-enum cmd_dma_types {
+
+/*
+ * Representations of commands and devices
+ */
+
+enum sbp2_dma_types {
        CMD_DMA_NONE,
        CMD_DMA_PAGE,
        CMD_DMA_SINGLE
 };
 
-/*
- * Encapsulates all the info necessary for an outstanding command.
- */
+/* Per SCSI command */
 struct sbp2_command_info {
-
        struct list_head list;
-       struct sbp2_command_orb command_orb ____cacheline_aligned;
-       dma_addr_t command_orb_dma ____cacheline_aligned;
+       struct sbp2_command_orb command_orb;
+       dma_addr_t command_orb_dma;
        struct scsi_cmnd *Current_SCpnt;
        void (*Current_done)(struct scsi_cmnd *);
 
        /* Also need s/g structure for each sbp2 command */
-       struct sbp2_unrestricted_page_table scatter_gather_element[SG_ALL] ____cacheline_aligned;
-       dma_addr_t sge_dma ____cacheline_aligned;
+       struct sbp2_unrestricted_page_table
+               scatter_gather_element[SG_ALL] __attribute__((aligned(8)));
+       dma_addr_t sge_dma;
        void *sge_buffer;
        dma_addr_t cmd_dma;
-       enum cmd_dma_types dma_type;
+       enum sbp2_dma_types dma_type;
        unsigned long dma_size;
-       int dma_dir;
-
+       enum dma_data_direction dma_dir;
 };
 
-struct sbp2scsi_host_info;
+/* Per FireWire host */
+struct sbp2_fwhost_info {
+       struct hpsb_host *host;
+       struct list_head logical_units;
+};
 
-/*
- * Information needed on a per scsi id basis (one for each sbp2 device)
- */
-struct scsi_id_instance_data {
-       /*
-        * Various sbp2 specific structures
-        */
+/* Per logical unit */
+struct sbp2_lu {
+       /* Operation request blocks */
        struct sbp2_command_orb *last_orb;
        dma_addr_t last_orb_dma;
        struct sbp2_login_orb *login_orb;
@@ -291,74 +291,55 @@ struct scsi_id_instance_data {
        dma_addr_t logout_orb_dma;
        struct sbp2_status_block status_block;
 
-       /*
-        * Stuff we need to know about the sbp2 device itself
-        */
-       u64 sbp2_management_agent_addr;
-       u64 sbp2_command_block_agent_addr;
+       /* How to talk to the unit */
+       u64 management_agent_addr;
+       u64 command_block_agent_addr;
        u32 speed_code;
        u32 max_payload_size;
+       u16 lun;
 
-       /*
-        * Values pulled from the device's unit directory
-        */
-       u32 sbp2_command_set_spec_id;
-       u32 sbp2_command_set;
-       u32 sbp2_unit_characteristics;
-       u32 sbp2_lun;
-       u32 sbp2_firmware_revision;
-
-       /*
-        * Address for the device to write status blocks to
-        */
+       /* Address for the unit to write status blocks to */
        u64 status_fifo_addr;
 
-       /*
-        * Waitqueue flag for logins, reconnects, logouts, query logins
-        */
-       int access_complete:1;
+       /* Waitqueue flag for logins, reconnects, logouts, query logins */
+       unsigned int access_complete:1;
 
-       /*
-        * Pool of command orbs, so we can have more than overlapped command per id
-        */
-       spinlock_t sbp2_command_orb_lock;
-       struct list_head sbp2_command_orb_inuse;
-       struct list_head sbp2_command_orb_completed;
+       /* Pool of command ORBs for this logical unit */
+       spinlock_t cmd_orb_lock;
+       struct list_head cmd_orb_inuse;
+       struct list_head cmd_orb_completed;
 
-       struct list_head scsi_list;
+       /* Backlink to FireWire host; list of units attached to the host */
+       struct sbp2_fwhost_info *hi;
+       struct list_head lu_list;
 
-       /* Node entry, as retrieved from NodeMgr entries */
+       /* IEEE 1394 core's device representations */
        struct node_entry *ne;
        struct unit_directory *ud;
 
-       /* A backlink to our host_info */
-       struct sbp2scsi_host_info *hi;
-
-       /* SCSI related pointers */
+       /* SCSI core's device representations */
        struct scsi_device *sdev;
-       struct Scsi_Host *scsi_host;
+       struct Scsi_Host *shost;
 
        /* Device specific workarounds/brokeness */
        unsigned workarounds;
 
+       /* Connection state */
        atomic_t state;
+
+       /* For deferred requests to the fetch agent */
        struct work_struct protocol_work;
 };
 
-/* For use in scsi_id_instance_data.state */
+/* For use in sbp2_lu.state */
 enum sbp2lu_state_types {
        SBP2LU_STATE_RUNNING,           /* all normal */
        SBP2LU_STATE_IN_RESET,          /* between bus reset and reconnect */
        SBP2LU_STATE_IN_SHUTDOWN        /* when sbp2_remove was called */
 };
 
-/* Sbp2 host data structure (one per IEEE1394 host) */
-struct sbp2scsi_host_info {
-       struct hpsb_host *host;         /* IEEE1394 host */
-       struct list_head scsi_ids;      /* List of scsi ids on this host */
-};
-
-/* Flags for detected oddities and brokeness */
+/* For use in sbp2_lu.workarounds and in the corresponding
+ * module load parameter */
 #define SBP2_WORKAROUND_128K_MAX_TRANS 0x1
 #define SBP2_WORKAROUND_INQUIRY_36     0x2
 #define SBP2_WORKAROUND_MODE_SENSE_8   0x4