diff options
Diffstat (limited to 'sys/dev/isci/scil/scif_sas_remote_device_ready_substates.c')
-rw-r--r-- | sys/dev/isci/scil/scif_sas_remote_device_ready_substates.c | 290 |
1 files changed, 290 insertions, 0 deletions
diff --git a/sys/dev/isci/scil/scif_sas_remote_device_ready_substates.c b/sys/dev/isci/scil/scif_sas_remote_device_ready_substates.c new file mode 100644 index 0000000..2240be8 --- /dev/null +++ b/sys/dev/isci/scil/scif_sas_remote_device_ready_substates.c @@ -0,0 +1,290 @@ +/*- + * 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 entrance and exit methods for the ready + * sub-state machine states (OPERATIONAL, TASK_MGMT). + */ + +#include <dev/isci/scil/scif_sas_remote_device.h> +#include <dev/isci/scil/scif_sas_domain.h> +#include <dev/isci/scil/scif_sas_logger.h> +#include <dev/isci/scil/scif_sas_internal_io_request.h> +#include <dev/isci/scil/scif_sas_controller.h> +#include <dev/isci/scil/sci_controller.h> + +//****************************************************************************** +//* P R O T E C T E D M E T H O D S +//****************************************************************************** + +/** + * @brief This method implements the actions taken when entering the + * READY OPERATIONAL substate. This includes setting the state + * handler methods and issuing a scif_cb_remote_device_ready() + * notification to the user. + * + * @param[in] object This parameter specifies the base object for which + * the state transition is occurring. This is cast into a + * SCIF_SAS_REMOTE_DEVICE object in the method implementation. + * + * @return none + */ +static +void scif_sas_remote_device_ready_operational_substate_enter( + SCI_BASE_OBJECT_T *object +) +{ + SCIF_SAS_REMOTE_DEVICE_T * fw_device = (SCIF_SAS_REMOTE_DEVICE_T *)object; + + SET_STATE_HANDLER( + fw_device, + scif_sas_remote_device_ready_substate_handler_table, + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_OPERATIONAL + ); + + SCIF_LOG_INFO(( + sci_base_object_get_logger(fw_device), + SCIF_LOG_OBJECT_REMOTE_DEVICE | SCIF_LOG_OBJECT_REMOTE_DEVICE_CONFIG, + "Domain:0x%x Device:0x%x device ready\n", + fw_device->domain, fw_device + )); + + // Notify the user that the device has become ready. + scif_cb_remote_device_ready( + fw_device->domain->controller, fw_device->domain, fw_device + ); +} + +/** + * @brief This method implements the actions taken when exiting the + * READY OPERATIONAL substate. This method issues a + * scif_cb_remote_device_not_ready() notification to the framework + * user. + * + * @param[in] object This parameter specifies the base object for which + * the state transition is occurring. This is cast into a + * SCIF_SAS_REMOTE_DEVICE object in the method implementation. + * + * @return none + */ +static +void scif_sas_remote_device_ready_operational_substate_exit( + SCI_BASE_OBJECT_T *object +) +{ + SCIF_SAS_REMOTE_DEVICE_T * fw_device = (SCIF_SAS_REMOTE_DEVICE_T *)object; + + // Notify the user that the device has become ready. + scif_cb_remote_device_not_ready( + fw_device->domain->controller, fw_device->domain, fw_device + ); +} + +/** + * @brief This method implements the actions taken when entering the + * READY SUSPENDED substate. This includes setting the state + * handler methods. + * + * @param[in] object This parameter specifies the base object for which + * the state transition is occurring. This is cast into a + * SCIF_SAS_REMOTE_DEVICE object in the method implementation. + * + * @return none + */ +static +void scif_sas_remote_device_ready_suspended_substate_enter( + SCI_BASE_OBJECT_T *object +) +{ + SCIF_SAS_REMOTE_DEVICE_T * fw_device = (SCIF_SAS_REMOTE_DEVICE_T *)object; + + SET_STATE_HANDLER( + fw_device, + scif_sas_remote_device_ready_substate_handler_table, + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_SUSPENDED + ); +} + +/** + * @brief This method implements the actions taken when entering the + * READY TASK MGMT substate. This includes setting the state + * handler methods. + * + * @param[in] object This parameter specifies the base object for which + * the state transition is occurring. This is cast into a + * SCIF_SAS_REMOTE_DEVICE object in the method implementation. + * + * @return none + */ +static +void scif_sas_remote_device_ready_taskmgmt_substate_enter( + SCI_BASE_OBJECT_T *object +) +{ + SCIF_SAS_REMOTE_DEVICE_T * fw_device = (SCIF_SAS_REMOTE_DEVICE_T *)object; + + SET_STATE_HANDLER( + fw_device, + scif_sas_remote_device_ready_substate_handler_table, + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_TASK_MGMT + ); +} + +/** +* @brief This method implements the actions taken when entering the +* READY NCQ ERROR substate. This includes setting the state +* handler methods. +* +* @param[in] object This parameter specifies the base object for which +* the state transition is occurring. This is cast into a +* SCIF_SAS_REMOTE_DEVICE object in the method implementation. +* +* @return none +*/ +static +void scif_sas_remote_device_ready_ncq_error_substate_enter( + SCI_BASE_OBJECT_T *object +) +{ + SCIF_SAS_REMOTE_DEVICE_T * fw_device = (SCIF_SAS_REMOTE_DEVICE_T *)object; + SCI_STATUS status = SCI_SUCCESS; + SCI_TASK_REQUEST_HANDLE_T handle; + SCIF_SAS_CONTROLLER_T * fw_controller = fw_device->domain->controller; + SCIF_SAS_TASK_REQUEST_T * fw_task_request; + SCIF_SAS_REQUEST_T * fw_request; + void * internal_task_memory; + SCIF_SAS_DOMAIN_T * fw_domain = fw_device->domain; + SCI_FAST_LIST_ELEMENT_T * pending_request_element; + SCIF_SAS_REQUEST_T * pending_request = NULL; + + SET_STATE_HANDLER( + fw_device, + scif_sas_remote_device_ready_substate_handler_table, + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_NCQ_ERROR + ); + + internal_task_memory = scif_sas_controller_allocate_internal_request(fw_controller); + ASSERT(internal_task_memory != NULL); + + fw_task_request = (SCIF_SAS_TASK_REQUEST_T*)internal_task_memory; + + fw_request = &fw_task_request->parent; + + //construct the scif io request + status = scif_sas_internal_task_request_construct( + fw_controller, + fw_device, + SCI_CONTROLLER_INVALID_IO_TAG, + (void *)fw_task_request, + &handle, + SCI_SAS_ABORT_TASK_SET + ); + + pending_request_element = fw_domain->request_list.list_head; + + // Cycle through the fast list of IO requests. Mark each request + // pending to this remote device so that they are not completed + // to the operating system when the request is terminated, but + // rather when the abort task set completes. + while (pending_request_element != NULL) + { + pending_request = + (SCIF_SAS_REQUEST_T*) sci_fast_list_get_object(pending_request_element); + + // The current element may be deleted from the list becasue of + // IO completion so advance to the next element early + pending_request_element = sci_fast_list_get_next(pending_request_element); + + if (pending_request->device == fw_device) + { + pending_request->is_waiting_for_abort_task_set = TRUE; + } + } + + status = scif_controller_start_task( + fw_controller, + fw_device, + fw_request, + SCI_CONTROLLER_INVALID_IO_TAG + ); +} + +SCI_BASE_STATE_T scif_sas_remote_device_ready_substate_table +[SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_MAX_STATES] = +{ + { + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_OPERATIONAL, + scif_sas_remote_device_ready_operational_substate_enter, + scif_sas_remote_device_ready_operational_substate_exit + }, + { + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_SUSPENDED, + scif_sas_remote_device_ready_suspended_substate_enter, + NULL + }, + { + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_TASK_MGMT, + scif_sas_remote_device_ready_taskmgmt_substate_enter, + NULL + }, + { + SCIF_SAS_REMOTE_DEVICE_READY_SUBSTATE_NCQ_ERROR, + scif_sas_remote_device_ready_ncq_error_substate_enter, + NULL + } +}; + |