drivers/scsi/isci/scu_remote_node_context.h

Source file repositories/reference/linux-study-clean/drivers/scsi/isci/scu_remote_node_context.h

File Facts

System
Linux kernel
Corpus path
drivers/scsi/isci/scu_remote_node_context.h
Extension
.h
Size
6777 bytes
Lines
230
Domain
Driver Families
Bucket
drivers/scsi
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct ssp_remote_node_context {
	/* WORD 0 */

	/**
	 * This field is the remote node index assigned for this remote node. All
	 * remote nodes must have a unique remote node index. The value of the remote
	 * node index can not exceed the maximum number of remote nodes reported in
	 * the SCU device context capacity register.
	 */
	u32 remote_node_index:12;
	u32 reserved0_1:4;

	/**
	 * This field tells the SCU hardware how many simultaneous connections that
	 * this remote node will support.
	 */
	u32 remote_node_port_width:4;

	/**
	 * This field tells the SCU hardware which logical port to associate with this
	 * remote node.
	 */
	u32 logical_port_index:3;
	u32 reserved0_2:5;

	/**
	 * This field will enable the I_T nexus loss timer for this remote node.
	 */
	u32 nexus_loss_timer_enable:1;

	/**
	 * This field is the for driver debug only and is not used.
	 */
	u32 check_bit:1;

	/**
	 * This field must be set to true when the hardware DMAs the remote node
	 * context to the hardware SRAM.  When the remote node is being invalidated
	 * this field must be set to false.
	 */
	u32 is_valid:1;

	/**
	 * This field must be set to true.
	 */
	u32 is_remote_node_context:1;

	/* WORD 1 - 2 */

	/**
	 * This is the low word of the remote device SAS Address
	 */
	u32 remote_sas_address_lo;

	/**
	 * This field is the high word of the remote device SAS Address
	 */
	u32 remote_sas_address_hi;

	/* WORD 3 */
	/**
	 * This field reprensets the function number assigned to this remote device.
	 * This value must match the virtual function number that is being used to
	 * communicate to the device.
	 */
	u32 function_number:8;
	u32 reserved3_1:8;

	/**
	 * This field provides the driver a way to cheat on the arbitration wait time
	 * for this remote node.
	 */
	u32 arbitration_wait_time:16;

	/* WORD 4 */
	/**
	 * This field tells the SCU hardware how long this device may occupy the
	 * connection before it must be closed.
	 */
	u32 connection_occupancy_timeout:16;

	/**
	 * This field tells the SCU hardware how long to maintain a connection when
	 * there are no frames being transmitted on the link.
	 */
	u32 connection_inactivity_timeout:16;

	/* WORD  5 */
	/**
	 * This field allows the driver to cheat on the arbitration wait time for this

Annotation

Implementation Notes