summaryrefslogtreecommitdiffstats
path: root/sys/dev/isci/scil/scic_sds_remote_node_context.c
diff options
context:
space:
mode:
Diffstat (limited to 'sys/dev/isci/scil/scic_sds_remote_node_context.c')
-rw-r--r--sys/dev/isci/scil/scic_sds_remote_node_context.c1500
1 files changed, 1500 insertions, 0 deletions
diff --git a/sys/dev/isci/scil/scic_sds_remote_node_context.c b/sys/dev/isci/scil/scic_sds_remote_node_context.c
new file mode 100644
index 0000000..c2ec1c2
--- /dev/null
+++ b/sys/dev/isci/scil/scic_sds_remote_node_context.c
@@ -0,0 +1,1500 @@
+/*-
+ * This file is provided under a dual BSD/GPLv2 license. When using or
+ * redistributing this file, you may do so under either license.
+*
+* GPL LICENSE SUMMARY
+*
+* Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
+*
+* This program is free software; you can redistribute it and/or modify
+* it under the terms of version 2 of the GNU General Public License as
+* published by the Free Software Foundation.
+*
+* This program is distributed in the hope that it will be useful, but
+* WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* General Public License for more details.
+*
+* You should have received a copy of the GNU General Public License
+* along with this program; if not, write to the Free Software
+* Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
+* The full GNU General Public License is included in this distribution
+* in the file called LICENSE.GPL.
+*
+* BSD LICENSE
+*
+* Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
+* All rights reserved.
+*
+* Redistribution and use in source and binary forms, with or without
+* modification, are permitted provided that the following conditions
+* are met:
+*
+* * Redistributions of source code must retain the above copyright
+* notice, this list of conditions and the following disclaimer.
+* * Redistributions in binary form must reproduce the above copyright
+* notice, this list of conditions and the following disclaimer in
+* the documentation and/or other materials provided with the
+* distribution.
+*
+* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <sys/cdefs.h>
+__FBSDID("$FreeBSD$");
+
+/**
+* @file
+*
+* @brief This file contains the structures, constants, and prototypes
+* associated with the remote node context in the silicon. It
+* exists to model and manage the remote node context in the silicon.
+*/
+
+#include <dev/isci/scil/sci_util.h>
+#include <dev/isci/scil/scic_sds_logger.h>
+#include <dev/isci/scil/scic_sds_controller.h>
+#include <dev/isci/scil/scic_sds_remote_device.h>
+#include <dev/isci/scil/scic_sds_remote_node_context.h>
+#include <dev/isci/scil/sci_base_state_machine.h>
+#include <dev/isci/scil/scic_remote_device.h>
+#include <dev/isci/scil/scic_sds_port.h>
+#include <dev/isci/scil/scu_event_codes.h>
+#include <dev/isci/scil/scu_task_context.h>
+
+/**
+* @brief
+*/
+ void scic_sds_remote_node_context_construct(
+ SCIC_SDS_REMOTE_DEVICE_T * device,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc,
+ U16 remote_node_index
+ )
+{
+ memset (rnc, 0, sizeof(SCIC_SDS_REMOTE_NODE_CONTEXT_T) );
+
+ rnc->remote_node_index = remote_node_index;
+ rnc->device = device;
+ rnc->destination_state = SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_UNSPECIFIED;
+
+ rnc->parent.logger = device->parent.parent.logger;
+
+ sci_base_state_machine_construct(
+ &rnc->state_machine,
+ &rnc->parent,
+ scic_sds_remote_node_context_state_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE
+ );
+
+ sci_base_state_machine_start(&rnc->state_machine);
+
+ // State logging initialization takes place late for the remote node context
+ // see the resume state handler for the initial state.
+}
+
+/**
+* This method will return TRUE if the RNC is not in the initial state. In
+* all other states the RNC is considered active and this will return TRUE.
+*
+* @note The destroy request of the state machine drives the RNC back to the
+* initial state. If the state machine changes then this routine will
+* also have to be changed.
+*
+* @param[in] this_rnc The RNC for which the is posted request is being made.
+*
+* @return BOOL
+* @retval TRUE if the state machine is not in the initial state
+* @retval FALSE if the state machine is in the initial state
+*/
+ BOOL scic_sds_remote_node_context_is_initialized(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+ )
+{
+ U32 current_state = sci_base_state_machine_get_state(&this_rnc->state_machine);
+
+ if (current_state == SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE)
+ {
+ return FALSE;
+ }
+
+ return TRUE;
+}
+
+/**
+* This method will return TRUE if the remote node context is in a READY state
+* otherwise it will return FALSE
+*
+* @param[in] this_rnc The state of the remote node context object to check.
+*
+* @return BOOL
+* @retval TRUE if the remote node context is in the ready state.
+* @retval FALSE if the remote node context is not in the ready state.
+*/
+ BOOL scic_sds_remote_node_context_is_ready(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+ )
+{
+ U32 current_state = sci_base_state_machine_get_state(&this_rnc->state_machine);
+
+ if (current_state == SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE)
+ {
+ return TRUE;
+ }
+
+ return FALSE;
+}
+
+/**
+* This method will construct the RNC buffer for this remote device object.
+*
+* @param[in] this_device The remote device to use to construct the RNC
+* buffer.
+* @param[in] rnc The buffer into which the remote device data will be copied.
+*
+* @return none
+*/
+ void scic_sds_remote_node_context_construct_buffer(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+ )
+{
+ SCU_REMOTE_NODE_CONTEXT_T * rnc;
+ SCIC_SDS_CONTROLLER_T * the_controller;
+
+ the_controller = scic_sds_remote_device_get_controller(this_rnc->device);
+
+ rnc = scic_sds_controller_get_remote_node_context_buffer(
+ the_controller, this_rnc->remote_node_index);
+
+ memset(
+ rnc,
+ 0x00,
+ sizeof(SCU_REMOTE_NODE_CONTEXT_T)
+ * scic_sds_remote_device_node_count(this_rnc->device)
+ );
+
+ rnc->ssp.remote_node_index = this_rnc->remote_node_index;
+ rnc->ssp.remote_node_port_width = this_rnc->device->device_port_width;
+ rnc->ssp.logical_port_index =
+ scic_sds_remote_device_get_port_index(this_rnc->device);
+
+ rnc->ssp.remote_sas_address_hi = SCIC_SWAP_DWORD(this_rnc->device->device_address.high);
+ rnc->ssp.remote_sas_address_lo = SCIC_SWAP_DWORD(this_rnc->device->device_address.low);
+
+ rnc->ssp.nexus_loss_timer_enable = TRUE;
+ rnc->ssp.check_bit = FALSE;
+ rnc->ssp.is_valid = FALSE;
+ rnc->ssp.is_remote_node_context = TRUE;
+ rnc->ssp.function_number = 0;
+
+ rnc->ssp.arbitration_wait_time = 0;
+
+
+ if (
+ this_rnc->device->target_protocols.u.bits.attached_sata_device
+ || this_rnc->device->target_protocols.u.bits.attached_stp_target
+ )
+ {
+ rnc->ssp.connection_occupancy_timeout =
+ the_controller->user_parameters.sds1.stp_max_occupancy_timeout;
+ rnc->ssp.connection_inactivity_timeout =
+ the_controller->user_parameters.sds1.stp_inactivity_timeout;
+ }
+ else
+ {
+ rnc->ssp.connection_occupancy_timeout =
+ the_controller->user_parameters.sds1.ssp_max_occupancy_timeout;
+ rnc->ssp.connection_inactivity_timeout =
+ the_controller->user_parameters.sds1.ssp_inactivity_timeout;
+ }
+
+ rnc->ssp.initial_arbitration_wait_time = 0;
+
+ // Open Address Frame Parameters
+ rnc->ssp.oaf_connection_rate = this_rnc->device->connection_rate;
+ rnc->ssp.oaf_features = 0;
+ rnc->ssp.oaf_source_zone_group = 0;
+ rnc->ssp.oaf_more_compatibility_features = 0;
+}
+
+// ---------------------------------------------------------------------------
+
+#ifdef SCI_LOGGING
+/**
+* This method will enable and turn on state transition logging for the remote
+* node context object.
+*
+* @param[in] this_rnc The remote node context for which state transition
+* logging is to be enabled.
+*
+* @return none
+*/
+ void scic_sds_remote_node_context_initialize_state_logging(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+ )
+{
+ sci_base_state_machine_logger_initialize(
+ &this_rnc->state_machine_logger,
+ &this_rnc->state_machine,
+ &this_rnc->parent,
+ scic_cb_logger_log_states,
+ "SCIC_SDS_REMOTE_NODE_CONTEXT_T", "state machine",
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET
+ );
+}
+
+/**
+* This method will stop the state machine logging for this object and should
+* be called before the object is destroyed.
+*
+* @param[in] this_rnc The remote node context on which to stop logging state
+* transitions.
+*
+* @return none
+*/
+ void scic_sds_remote_node_context_deinitialize_state_logging(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+ )
+{
+ sci_base_state_machine_logger_deinitialize(
+ &this_rnc->state_machine_logger,
+ &this_rnc->state_machine
+ );
+}
+#endif
+
+/**
+* This method will setup the remote node context object so it will transition
+* to its ready state. If the remote node context is already setup to
+* transition to its final state then this function does nothing.
+*
+* @param[in] this_rnc
+* @param[in] the_callback
+* @param[in] callback_parameter
+*
+* @return none
+*/
+static
+void scic_sds_remote_node_context_setup_to_resume(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ if (this_rnc->destination_state != SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_FINAL)
+ {
+ this_rnc->destination_state = SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_READY;
+ this_rnc->user_callback = the_callback;
+ this_rnc->user_cookie = callback_parameter;
+ }
+}
+
+/**
+* This method will setup the remote node context object so it will
+* transistion to its final state.
+*
+* @param[in] this_rnc
+* @param[in] the_callback
+* @param[in] callback_parameter
+*
+* @return none
+*/
+static
+void scic_sds_remote_node_context_setup_to_destory(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ this_rnc->destination_state = SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_FINAL;
+ this_rnc->user_callback = the_callback;
+ this_rnc->user_cookie = callback_parameter;
+}
+
+/**
+* This method will continue to resume a remote node context. This is used
+* in the states where a resume is requested while a resume is in progress.
+*
+* @param[in] this_rnc
+* @param[in] the_callback
+* @param[in] callback_parameter
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_continue_to_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ if (this_rnc->destination_state == SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_READY)
+ {
+ this_rnc->user_callback = the_callback;
+ this_rnc->user_cookie = callback_parameter;
+
+ return SCI_SUCCESS;
+ }
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+//******************************************************************************
+//* REMOTE NODE CONTEXT STATE MACHINE
+//******************************************************************************
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_destruct_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to stop while in unexpected state %d\n",
+ this_rnc, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ // We have decided that the destruct request on the remote node context can not fail
+ // since it is either in the initial/destroyed state or is can be destroyed.
+ return SCI_SUCCESS;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_suspend_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ U32 suspend_type,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to suspend while in wrong state %d\n",
+ this_rnc, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to resume while in wrong state %d\n",
+ this_rnc, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_start_io_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to start io 0x%x while in wrong state %d\n",
+ this_rnc, the_request, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_start_task_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to start task 0x%x while in wrong state %d\n",
+ this_rnc, the_request, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_default_event_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ U32 event_code
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process event 0x%x while in wrong state %d\n",
+ this_rnc, event_code, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+/**
+* This method determines if the task request can be started by the SCU
+* hardware. When the RNC is in the ready state any task can be started.
+*
+* @param[in] this_rnc The rnc for which the task request is targeted.
+* @param[in] the_request The request which is going to be started.
+*
+* @return SCI_STATUS
+* @retval SCI_SUCCESS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_success_start_task_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ return SCI_SUCCESS;
+}
+
+/**
+* This method handles destruct calls from the various state handlers. The
+* remote node context can be requested to destroy from any state. If there
+* was a user callback it is always replaced with the request to destroy user
+* callback.
+*
+* @param[in] this_rnc
+* @param[in] the_callback
+* @param[in] callback_parameter
+*
+* @return SCI_STATUS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_general_destruct_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ scic_sds_remote_node_context_setup_to_destory(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE
+ );
+
+ return SCI_SUCCESS;
+}
+// ---------------------------------------------------------------------------
+static
+SCI_STATUS scic_sds_remote_node_context_reset_required_start_io_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to start io 0x%x while in wrong state %d\n",
+ this_rnc, the_request, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ return SCI_FAILURE_REMOTE_DEVICE_RESET_REQUIRED;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_initial_state_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ if (this_rnc->remote_node_index != SCIC_SDS_REMOTE_NODE_CONTEXT_INVALID_INDEX)
+ {
+ scic_sds_remote_node_context_setup_to_resume(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ scic_sds_remote_node_context_construct_buffer(this_rnc);
+
+#if defined (SCI_LOGGING)
+ // If a remote node context has a logger already, don't work on its state
+ // logging.
+ if (this_rnc->state_machine.previous_state_id
+ != SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE)
+ scic_sds_remote_node_context_initialize_state_logging(this_rnc);
+#endif
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_POSTING_STATE
+ );
+
+ return SCI_SUCCESS;
+ }
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_posting_state_event_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ U32 event_code
+)
+{
+ SCI_STATUS status;
+
+ switch (scu_get_event_code(event_code))
+ {
+ case SCU_EVENT_POST_RNC_COMPLETE:
+ status = SCI_SUCCESS;
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE
+ );
+ break;
+
+ default:
+ status = SCI_FAILURE;
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process unexpected event 0x%x while in posting state\n",
+ this_rnc, event_code
+ ));
+ break;
+ }
+
+ return status;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_invalidating_state_destruct_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ scic_sds_remote_node_context_setup_to_destory(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ return SCI_SUCCESS;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_invalidating_state_event_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ U32 event_code
+)
+{
+ SCI_STATUS status;
+
+ if (scu_get_event_code(event_code) == SCU_EVENT_POST_RNC_INVALIDATE_COMPLETE)
+ {
+ status = SCI_SUCCESS;
+
+ if (this_rnc->destination_state == SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_FINAL)
+ {
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE
+ );
+ }
+ else
+ {
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_POSTING_STATE
+ );
+ }
+ }
+ else
+ {
+ switch (scu_get_event_type(event_code))
+ {
+ case SCU_EVENT_TYPE_RNC_SUSPEND_TX:
+ case SCU_EVENT_TYPE_RNC_SUSPEND_TX_RX:
+ // We really dont care if the hardware is going to suspend
+ // the device since it's being invalidated anyway
+ SCIC_LOG_INFO((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x was suspeneded by hardware while being invalidated.\n",
+ this_rnc
+ ));
+ status = SCI_SUCCESS;
+ break;
+
+ default:
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process event 0x%x while in state %d.\n",
+ this_rnc, event_code, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+ status = SCI_FAILURE;
+ break;
+ }
+ }
+
+ return status;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_resuming_state_event_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ U32 event_code
+)
+{
+ SCI_STATUS status;
+
+ if (scu_get_event_code(event_code) == SCU_EVENT_POST_RCN_RELEASE)
+ {
+ status = SCI_SUCCESS;
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE
+ );
+ }
+ else
+ {
+ switch (scu_get_event_type(event_code))
+ {
+ case SCU_EVENT_TYPE_RNC_SUSPEND_TX:
+ case SCU_EVENT_TYPE_RNC_SUSPEND_TX_RX:
+ // We really dont care if the hardware is going to suspend
+ // the device since it's being resumed anyway
+ SCIC_LOG_INFO((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x was suspeneded by hardware while being resumed.\n",
+ this_rnc
+ ));
+ status = SCI_SUCCESS;
+ break;
+
+ default:
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process event 0x%x while in state %d.\n",
+ this_rnc, event_code, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+ status = SCI_FAILURE;
+ break;
+ }
+ }
+
+ return status;
+}
+
+// ---------------------------------------------------------------------------
+
+/**
+* This method will handle the suspend requests from the ready state.
+*
+* @param[in] this_rnc The remote node context object being suspended.
+* @param[in] the_callback The callback when the suspension is complete.
+* @param[in] callback_parameter The parameter that is to be passed into the
+* callback.
+*
+* @return SCI_SUCCESS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_ready_state_suspend_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ U32 suspend_type,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ this_rnc->user_callback = the_callback;
+ this_rnc->user_cookie = callback_parameter;
+ this_rnc->suspension_code = suspend_type;
+
+ if (suspend_type == SCI_SOFTWARE_SUSPENSION)
+ {
+ scic_sds_remote_device_post_request(
+ this_rnc->device,
+ SCU_CONTEXT_COMMAND_POST_RNC_SUSPEND_TX
+ );
+ }
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_AWAIT_SUSPENSION_STATE
+ );
+
+ return SCI_SUCCESS;
+}
+
+/**
+* This method determines if the io request can be started by the SCU
+* hardware. When the RNC is in the ready state any io request can be started.
+*
+* @param[in] this_rnc The rnc for which the io request is targeted.
+* @param[in] the_request The request which is going to be started.
+*
+* @return SCI_STATUS
+* @retval SCI_SUCCESS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_ready_state_start_io_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ return SCI_SUCCESS;
+}
+
+
+static
+SCI_STATUS scic_sds_remote_node_context_ready_state_event_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ U32 event_code
+)
+{
+ SCI_STATUS status;
+
+ switch (scu_get_event_type(event_code))
+ {
+ case SCU_EVENT_TL_RNC_SUSPEND_TX:
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_SUSPENDED_STATE
+ );
+
+ this_rnc->suspension_code = scu_get_event_specifier(event_code);
+ status = SCI_SUCCESS;
+ break;
+
+ case SCU_EVENT_TL_RNC_SUSPEND_TX_RX:
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_RX_SUSPENDED_STATE
+ );
+
+ this_rnc->suspension_code = scu_get_event_specifier(event_code);
+ status = SCI_SUCCESS;
+ break;
+
+ default:
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process event 0x%x while in state %d.\n",
+ this_rnc, event_code, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ status = SCI_FAILURE;
+ break;
+ }
+
+ return status;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_tx_suspended_state_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ SMP_DISCOVER_RESPONSE_PROTOCOLS_T protocols;
+
+ scic_sds_remote_node_context_setup_to_resume(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ // If this is an expander attached SATA device we must invalidate
+ // and repost the RNC since this is the only way to clear the
+ // TCi to NCQ tag mapping table for the RNi
+ // All other device types we can just resume.
+ scic_remote_device_get_protocols(this_rnc->device, &protocols);
+
+ if (
+ (protocols.u.bits.attached_stp_target == 1)
+ && !(this_rnc->device->is_direct_attached)
+ )
+ {
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE
+ );
+ }
+ else
+ {
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_RESUMING_STATE
+ );
+ }
+
+ return SCI_SUCCESS;
+}
+
+/**
+* This method will report a success or failure attempt to start a new task
+* request to the hardware. Since all task requests are sent on the high
+* priority queue they can be sent when the RCN is in a TX suspend state.
+*
+* @param[in] this_rnc The remote node context which is to receive the task
+* request.
+* @param[in] the_request The task request to be transmitted to to the remote
+* target device.
+*
+* @return SCI_STATUS
+* @retval SCI_SUCCESS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_suspended_start_task_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ scic_sds_remote_node_context_resume(this_rnc, NULL, NULL);
+
+ return SCI_SUCCESS;
+}
+
+// ---------------------------------------------------------------------------
+
+static
+SCI_STATUS scic_sds_remote_node_context_tx_rx_suspended_state_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ scic_sds_remote_node_context_setup_to_resume(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_RESUMING_STATE
+ );
+
+ return SCI_FAILURE_INVALID_STATE;
+}
+
+// ---------------------------------------------------------------------------
+
+/**
+*
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_await_suspension_state_resume_handler(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK the_callback,
+ void * callback_parameter
+)
+{
+ scic_sds_remote_node_context_setup_to_resume(
+ this_rnc, the_callback, callback_parameter
+ );
+
+ return SCI_SUCCESS;
+}
+
+/**
+* This method will report a success or failure attempt to start a new task
+* request to the hardware. Since all task requests are sent on the high
+* priority queue they can be sent when the RCN is in a TX suspend state.
+*
+* @param[in] this_rnc The remote node context which is to receive the task
+* request.
+* @param[in] the_request The task request to be transmitted to to the remote
+* target device.
+*
+* @return SCI_STATUS
+* @retval SCI_SUCCESS
+*/
+static
+SCI_STATUS scic_sds_remote_node_context_await_suspension_state_start_task_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ struct SCIC_SDS_REQUEST * the_request
+)
+{
+ return SCI_SUCCESS;
+}
+
+static
+SCI_STATUS scic_sds_remote_node_context_await_suspension_state_event_handler(
+ struct SCIC_SDS_REMOTE_NODE_CONTEXT * this_rnc,
+ U32 event_code
+)
+{
+ SCI_STATUS status;
+
+ switch (scu_get_event_type(event_code))
+ {
+ case SCU_EVENT_TL_RNC_SUSPEND_TX:
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_SUSPENDED_STATE
+ );
+
+ this_rnc->suspension_code = scu_get_event_specifier(event_code);
+ status = SCI_SUCCESS;
+ break;
+
+ case SCU_EVENT_TL_RNC_SUSPEND_TX_RX:
+ sci_base_state_machine_change_state(
+ &this_rnc->state_machine,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_RX_SUSPENDED_STATE
+ );
+
+ this_rnc->suspension_code = scu_get_event_specifier(event_code);
+ status = SCI_SUCCESS;
+ break;
+
+ default:
+ SCIC_LOG_WARNING((
+ sci_base_object_get_logger(this_rnc->device),
+ SCIC_LOG_OBJECT_SSP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_SMP_REMOTE_TARGET |
+ SCIC_LOG_OBJECT_STP_REMOTE_TARGET,
+ "SCIC Remote Node Context 0x%x requested to process event 0x%x while in state %d.\n",
+ this_rnc, event_code, sci_base_state_machine_get_state(&this_rnc->state_machine)
+ ));
+
+ status = SCI_FAILURE;
+ break;
+ }
+
+ return status;
+}
+
+// ---------------------------------------------------------------------------
+
+ SCIC_SDS_REMOTE_NODE_CONTEXT_HANDLERS
+ scic_sds_remote_node_context_state_handler_table[
+ SCIC_SDS_REMOTE_NODE_CONTEXT_MAX_STATES] =
+{
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE
+ {
+ scic_sds_remote_node_context_default_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_initial_state_resume_handler,
+ scic_sds_remote_node_context_default_start_io_handler,
+ scic_sds_remote_node_context_default_start_task_handler,
+ scic_sds_remote_node_context_default_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_POSTING_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_continue_to_resume_handler,
+ scic_sds_remote_node_context_default_start_io_handler,
+ scic_sds_remote_node_context_default_start_task_handler,
+ scic_sds_remote_node_context_posting_state_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE
+ {
+ scic_sds_remote_node_context_invalidating_state_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_continue_to_resume_handler,
+ scic_sds_remote_node_context_default_start_io_handler,
+ scic_sds_remote_node_context_default_start_task_handler,
+ scic_sds_remote_node_context_invalidating_state_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_RESUMING_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_continue_to_resume_handler,
+ scic_sds_remote_node_context_default_start_io_handler,
+ scic_sds_remote_node_context_success_start_task_handler,
+ scic_sds_remote_node_context_resuming_state_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_ready_state_suspend_handler,
+ scic_sds_remote_node_context_default_resume_handler,
+ scic_sds_remote_node_context_ready_state_start_io_handler,
+ scic_sds_remote_node_context_success_start_task_handler,
+ scic_sds_remote_node_context_ready_state_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_TX_SUSPENDED_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_tx_suspended_state_resume_handler,
+ scic_sds_remote_node_context_reset_required_start_io_handler,
+ scic_sds_remote_node_context_suspended_start_task_handler,
+ scic_sds_remote_node_context_default_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_TX_RX_SUSPENDED_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_tx_rx_suspended_state_resume_handler,
+ scic_sds_remote_node_context_reset_required_start_io_handler,
+ scic_sds_remote_node_context_suspended_start_task_handler,
+ scic_sds_remote_node_context_default_event_handler
+ },
+ // SCIC_SDS_REMOTE_NODE_CONTEXT_AWAIT_SUSPENSION_STATE
+ {
+ scic_sds_remote_node_context_general_destruct_handler,
+ scic_sds_remote_node_context_default_suspend_handler,
+ scic_sds_remote_node_context_await_suspension_state_resume_handler,
+ scic_sds_remote_node_context_reset_required_start_io_handler,
+ scic_sds_remote_node_context_await_suspension_state_start_task_handler,
+ scic_sds_remote_node_context_await_suspension_state_event_handler
+ }
+};
+
+//*****************************************************************************
+//* REMOTE NODE CONTEXT PRIVATE METHODS
+//*****************************************************************************
+
+/**
+* This method just calls the user callback function and then resets the
+* callback.
+*
+* @param[in out] rnc
+*/
+static
+void scic_sds_remote_node_context_notify_user(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T *rnc
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_CALLBACK local_user_callback = rnc->user_callback;
+ void * local_user_cookie = rnc->user_cookie;
+
+ //we need to set the user_callback to NULL before it is called, because
+ //the user callback's stack may eventually also set up a new set of
+ //user callback. If we nullify the user_callback after it is called,
+ //we are in the risk to lose the freshly set user callback.
+ rnc->user_callback = NULL;
+ rnc->user_cookie = NULL;
+
+ if (local_user_callback != NULL)
+ {
+ (*local_user_callback)(local_user_cookie);
+ }
+}
+
+/**
+* This method will continue the remote node context state machine by
+* requesting to resume the remote node context state machine from its current
+* state.
+*
+* @param[in] rnc
+*/
+static
+void scic_sds_remote_node_context_continue_state_transitions(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc
+)
+{
+ if (rnc->destination_state == SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_READY)
+ {
+ rnc->state_handlers->resume_handler(
+ rnc, rnc->user_callback, rnc->user_cookie
+ );
+ }
+}
+
+/**
+* This method will mark the rnc buffer as being valid and post the request to
+* the hardware.
+*
+* @param[in] this_rnc The remote node context object that is to be
+* validated.
+*
+* @return none
+*/
+static
+void scic_sds_remote_node_context_validate_context_buffer(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+)
+{
+ SCU_REMOTE_NODE_CONTEXT_T *rnc_buffer;
+
+ rnc_buffer = scic_sds_controller_get_remote_node_context_buffer(
+ scic_sds_remote_device_get_controller(this_rnc->device),
+ this_rnc->remote_node_index
+ );
+
+ rnc_buffer->ssp.is_valid = TRUE;
+
+ if (
+ !this_rnc->device->is_direct_attached
+ && this_rnc->device->target_protocols.u.bits.attached_stp_target
+ )
+ {
+ scic_sds_remote_device_post_request(
+ this_rnc->device,
+ SCU_CONTEXT_COMMAND_POST_RNC_96
+ );
+ }
+ else
+ {
+ scic_sds_remote_device_post_request(
+ this_rnc->device,
+ SCU_CONTEXT_COMMAND_POST_RNC_32
+ );
+
+ if (this_rnc->device->is_direct_attached)
+ {
+ scic_sds_port_setup_transports(
+ this_rnc->device->owning_port,
+ this_rnc->remote_node_index
+ );
+ }
+ }
+}
+
+/**
+* This method will update the RNC buffer and post the invalidate request.
+*
+* @param[in] this_rnc The remote node context object that is to be
+* invalidated.
+*
+* @return none
+*/
+static
+void scic_sds_remote_node_context_invalidate_context_buffer(
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc
+)
+{
+ SCU_REMOTE_NODE_CONTEXT_T *rnc_buffer;
+
+ rnc_buffer = scic_sds_controller_get_remote_node_context_buffer(
+ scic_sds_remote_device_get_controller(this_rnc->device),
+ this_rnc->remote_node_index
+ );
+
+ rnc_buffer->ssp.is_valid = FALSE;
+
+ scic_sds_remote_device_post_request(
+ this_rnc->device,
+ SCU_CONTEXT_COMMAND_POST_RNC_INVALIDATE
+ );
+}
+
+//*****************************************************************************
+//* REMOTE NODE CONTEXT STATE ENTER AND EXIT METHODS
+//*****************************************************************************
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_initial_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE
+ );
+
+ // Check to see if we have gotten back to the initial state because someone
+ // requested to destroy the remote node context object.
+ if (
+ rnc->state_machine.previous_state_id
+ == SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE
+ )
+ {
+ rnc->destination_state = SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_UNSPECIFIED;
+
+ scic_sds_remote_node_context_notify_user(rnc);
+
+ // Since we are destroying the remote node context deinitialize the state logging
+ // should we resume the remote node context the state logging will be reinitialized
+ // on the resume handler.
+ scic_sds_remote_node_context_deinitialize_state_logging(rnc);
+ }
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_posting_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * this_rnc;
+ this_rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ this_rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_POSTING_STATE
+ );
+
+ scic_sds_remote_node_context_validate_context_buffer(this_rnc);
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_invalidating_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE
+ );
+
+ scic_sds_remote_node_context_invalidate_context_buffer(rnc);
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_resuming_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ SMP_DISCOVER_RESPONSE_PROTOCOLS_T protocols;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_RESUMING_STATE
+ );
+
+ // For direct attached SATA devices we need to clear the TLCR
+ // NCQ to TCi tag mapping on the phy and in cases where we
+ // resume because of a target reset we also need to update
+ // the STPTLDARNI register with the RNi of the device
+ scic_remote_device_get_protocols(rnc->device, &protocols);
+
+ if (
+ (protocols.u.bits.attached_stp_target == 1)
+ && (rnc->device->is_direct_attached)
+ )
+ {
+ scic_sds_port_setup_transports(
+ rnc->device->owning_port, rnc->remote_node_index
+ );
+ }
+
+ scic_sds_remote_device_post_request(
+ rnc->device,
+ SCU_CONTEXT_COMMAND_POST_RNC_RESUME
+ );
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_ready_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE
+ );
+
+ rnc->destination_state = SCIC_SDS_REMOTE_NODE_DESTINATION_STATE_UNSPECIFIED;
+
+ if (rnc->user_callback != NULL)
+ {
+ scic_sds_remote_node_context_notify_user(rnc);
+ }
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_tx_suspended_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_SUSPENDED_STATE
+ );
+
+ scic_sds_remote_node_context_continue_state_transitions(rnc);
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_tx_rx_suspended_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_RX_SUSPENDED_STATE
+ );
+
+ scic_sds_remote_node_context_continue_state_transitions(rnc);
+}
+
+/**
+*
+*
+* @param[in] object
+*/
+static
+void scic_sds_remote_node_context_await_suspension_state_enter(
+ SCI_BASE_OBJECT_T * object
+)
+{
+ SCIC_SDS_REMOTE_NODE_CONTEXT_T * rnc;
+ rnc = (SCIC_SDS_REMOTE_NODE_CONTEXT_T *)object;
+
+ SET_STATE_HANDLER(
+ rnc,
+ scic_sds_remote_node_context_state_handler_table,
+ SCIC_SDS_REMOTE_NODE_CONTEXT_AWAIT_SUSPENSION_STATE
+ );
+}
+
+// ---------------------------------------------------------------------------
+
+ SCI_BASE_STATE_T
+ scic_sds_remote_node_context_state_table[
+ SCIC_SDS_REMOTE_NODE_CONTEXT_MAX_STATES] =
+{
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INITIAL_STATE,
+ scic_sds_remote_node_context_initial_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_POSTING_STATE,
+ scic_sds_remote_node_context_posting_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_INVALIDATING_STATE,
+ scic_sds_remote_node_context_invalidating_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_RESUMING_STATE,
+ scic_sds_remote_node_context_resuming_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_READY_STATE,
+ scic_sds_remote_node_context_ready_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_SUSPENDED_STATE,
+ scic_sds_remote_node_context_tx_suspended_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_TX_RX_SUSPENDED_STATE,
+ scic_sds_remote_node_context_tx_rx_suspended_state_enter,
+ NULL
+ },
+ {
+ SCIC_SDS_REMOTE_NODE_CONTEXT_AWAIT_SUSPENSION_STATE,
+ scic_sds_remote_node_context_await_suspension_state_enter,
+ NULL
+ }
+};
+
OpenPOWER on IntegriCloud