2 * This file is provided under a dual BSD/GPLv2 license. When using or
3 * redistributing this file, you may do so under either license.
7 * Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of version 2 of the GNU General Public License as
11 * published by the Free Software Foundation.
13 * This program is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
21 * The full GNU General Public License is included in this distribution
22 * in the file called LICENSE.GPL.
26 * Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
27 * All rights reserved.
29 * Redistribution and use in source and binary forms, with or without
30 * modification, are permitted provided that the following conditions
33 * * Redistributions of source code must retain the above copyright
34 * notice, this list of conditions and the following disclaimer.
35 * * Redistributions in binary form must reproduce the above copyright
36 * notice, this list of conditions and the following disclaimer in
37 * the documentation and/or other materials provided with the
39 * * Neither the name of Intel Corporation nor the names of its
40 * contributors may be used to endorse or promote products derived
41 * from this software without specific prior written permission.
43 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
44 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
45 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
46 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
47 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
48 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
49 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
50 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
51 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
52 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
53 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
61 #define SCIC_SDS_PORT_HARD_RESET_TIMEOUT (1000)
62 #define SCU_DUMMY_INDEX (0xFFFF)
64 static struct scic_sds_port_state_handler scic_sds_port_state_handler_table[];
66 static void isci_port_change_state(struct isci_port *iport, enum isci_status status)
70 dev_dbg(&iport->isci_host->pdev->dev,
71 "%s: iport = %p, state = 0x%x\n",
72 __func__, iport, status);
74 /* XXX pointless lock */
75 spin_lock_irqsave(&iport->state_lock, flags);
76 iport->status = status;
77 spin_unlock_irqrestore(&iport->state_lock, flags);
81 * This function will indicate which protocols are supported by this port.
82 * @sci_port: a handle corresponding to the SAS port for which to return the
83 * supported protocols.
84 * @protocols: This parameter specifies a pointer to a data structure
85 * which the core will copy the protocol values for the port from the
86 * transmit_identification register.
89 scic_sds_port_get_protocols(struct scic_sds_port *sci_port,
90 struct scic_phy_proto *protocols)
96 for (index = 0; index < SCI_MAX_PHYS; index++) {
97 if (sci_port->phy_table[index] != NULL) {
98 scic_sds_phy_get_protocols(sci_port->phy_table[index],
105 * This method requests a list (mask) of the phys contained in the supplied SAS
107 * @sci_port: a handle corresponding to the SAS port for which to return the
110 * Return a bit mask indicating which phys are a part of this port. Each bit
111 * corresponds to a phy identifier (e.g. bit 0 = phy id 0).
113 static u32 scic_sds_port_get_phys(struct scic_sds_port *sci_port)
120 for (index = 0; index < SCI_MAX_PHYS; index++) {
121 if (sci_port->phy_table[index] != NULL) {
122 mask |= (1 << index);
130 * scic_port_get_properties() - This method simply returns the properties
131 * regarding the port, such as: physical index, protocols, sas address, etc.
132 * @port: this parameter specifies the port for which to retrieve the physical
134 * @properties: This parameter specifies the properties structure into which to
135 * copy the requested information.
137 * Indicate if the user specified a valid port. SCI_SUCCESS This value is
138 * returned if the specified port was valid. SCI_FAILURE_INVALID_PORT This
139 * value is returned if the specified port is not valid. When this value is
140 * returned, no data is copied to the properties output parameter.
142 static enum sci_status scic_port_get_properties(struct scic_sds_port *port,
143 struct scic_port_properties *prop)
145 if ((port == NULL) ||
146 (port->logical_port_index == SCIC_SDS_DUMMY_PORT))
147 return SCI_FAILURE_INVALID_PORT;
149 prop->index = port->logical_port_index;
150 prop->phy_mask = scic_sds_port_get_phys(port);
151 scic_sds_port_get_sas_address(port, &prop->local.sas_address);
152 scic_sds_port_get_protocols(port, &prop->local.protocols);
153 scic_sds_port_get_attached_sas_address(port, &prop->remote.sas_address);
158 static void isci_port_link_up(struct isci_host *isci_host,
159 struct scic_sds_port *port,
160 struct scic_sds_phy *phy)
163 struct scic_port_properties properties;
164 struct isci_phy *isci_phy = sci_phy_to_iphy(phy);
165 struct isci_port *isci_port = sci_port_to_iport(port);
166 unsigned long success = true;
168 BUG_ON(isci_phy->isci_port != NULL);
170 isci_phy->isci_port = isci_port;
172 dev_dbg(&isci_host->pdev->dev,
173 "%s: isci_port = %p\n",
174 __func__, isci_port);
176 spin_lock_irqsave(&isci_phy->sas_phy.frame_rcvd_lock, flags);
178 isci_port_change_state(isci_phy->isci_port, isci_starting);
180 scic_port_get_properties(port, &properties);
182 if (phy->protocol == SCIC_SDS_PHY_PROTOCOL_SATA) {
183 u64 attached_sas_address;
185 isci_phy->sas_phy.oob_mode = SATA_OOB_MODE;
186 isci_phy->sas_phy.frame_rcvd_size = sizeof(struct dev_to_host_fis);
189 * For direct-attached SATA devices, the SCI core will
190 * automagically assign a SAS address to the end device
191 * for the purpose of creating a port. This SAS address
192 * will not be the same as assigned to the PHY and needs
193 * to be obtained from struct scic_port_properties properties.
195 attached_sas_address = properties.remote.sas_address.high;
196 attached_sas_address <<= 32;
197 attached_sas_address |= properties.remote.sas_address.low;
198 swab64s(&attached_sas_address);
200 memcpy(&isci_phy->sas_phy.attached_sas_addr,
201 &attached_sas_address, sizeof(attached_sas_address));
202 } else if (phy->protocol == SCIC_SDS_PHY_PROTOCOL_SAS) {
203 isci_phy->sas_phy.oob_mode = SAS_OOB_MODE;
204 isci_phy->sas_phy.frame_rcvd_size = sizeof(struct sas_identify_frame);
206 /* Copy the attached SAS address from the IAF */
207 memcpy(isci_phy->sas_phy.attached_sas_addr,
208 isci_phy->frame_rcvd.iaf.sas_addr, SAS_ADDR_SIZE);
210 dev_err(&isci_host->pdev->dev, "%s: unkown target\n", __func__);
214 isci_phy->sas_phy.phy->negotiated_linkrate = sci_phy_linkrate(phy);
216 spin_unlock_irqrestore(&isci_phy->sas_phy.frame_rcvd_lock, flags);
218 /* Notify libsas that we have an address frame, if indeed
219 * we've found an SSP, SMP, or STP target */
221 isci_host->sas_ha.notify_port_event(&isci_phy->sas_phy,
227 * isci_port_link_down() - This function is called by the sci core when a link
229 * @isci_host: This parameter specifies the isci host object.
230 * @phy: This parameter specifies the isci phy with the active link.
231 * @port: This parameter specifies the isci port with the active link.
234 static void isci_port_link_down(struct isci_host *isci_host,
235 struct isci_phy *isci_phy,
236 struct isci_port *isci_port)
238 struct isci_remote_device *isci_device;
240 dev_dbg(&isci_host->pdev->dev,
241 "%s: isci_port = %p\n", __func__, isci_port);
245 /* check to see if this is the last phy on this port. */
246 if (isci_phy->sas_phy.port
247 && isci_phy->sas_phy.port->num_phys == 1) {
249 /* change the state for all devices on this port.
250 * The next task sent to this device will be returned
251 * as SAS_TASK_UNDELIVERED, and the scsi mid layer
252 * will remove the target
254 list_for_each_entry(isci_device,
255 &isci_port->remote_dev_list,
257 dev_dbg(&isci_host->pdev->dev,
258 "%s: isci_device = %p\n",
259 __func__, isci_device);
260 isci_remote_device_change_state(isci_device,
264 isci_port_change_state(isci_port, isci_stopping);
267 /* Notify libsas of the borken link, this will trigger calls to our
268 * isci_port_deformed and isci_dev_gone functions.
270 sas_phy_disconnected(&isci_phy->sas_phy);
271 isci_host->sas_ha.notify_phy_event(&isci_phy->sas_phy,
272 PHYE_LOSS_OF_SIGNAL);
274 isci_phy->isci_port = NULL;
276 dev_dbg(&isci_host->pdev->dev,
277 "%s: isci_port = %p - Done\n", __func__, isci_port);
282 * isci_port_ready() - This function is called by the sci core when a link
284 * @isci_host: This parameter specifies the isci host object.
285 * @port: This parameter specifies the sci port with the active link.
288 static void isci_port_ready(struct isci_host *isci_host, struct isci_port *isci_port)
290 dev_dbg(&isci_host->pdev->dev,
291 "%s: isci_port = %p\n", __func__, isci_port);
293 complete_all(&isci_port->start_complete);
294 isci_port_change_state(isci_port, isci_ready);
299 * isci_port_not_ready() - This function is called by the sci core when a link
300 * is not ready. All remote devices on this link will be removed if they are
301 * in the stopping state.
302 * @isci_host: This parameter specifies the isci host object.
303 * @port: This parameter specifies the sci port with the active link.
306 static void isci_port_not_ready(struct isci_host *isci_host, struct isci_port *isci_port)
308 dev_dbg(&isci_host->pdev->dev,
309 "%s: isci_port = %p\n", __func__, isci_port);
312 static void isci_port_stop_complete(struct scic_sds_controller *scic,
313 struct scic_sds_port *sci_port,
314 enum sci_status completion_status)
316 dev_dbg(&scic_to_ihost(scic)->pdev->dev, "Port stop complete\n");
320 * isci_port_hard_reset_complete() - This function is called by the sci core
321 * when the hard reset complete notification has been received.
322 * @port: This parameter specifies the sci port with the active link.
323 * @completion_status: This parameter specifies the core status for the reset
327 static void isci_port_hard_reset_complete(struct isci_port *isci_port,
328 enum sci_status completion_status)
330 dev_dbg(&isci_port->isci_host->pdev->dev,
331 "%s: isci_port = %p, completion_status=%x\n",
332 __func__, isci_port, completion_status);
334 /* Save the status of the hard reset from the port. */
335 isci_port->hard_reset_status = completion_status;
337 complete_all(&isci_port->hard_reset_complete);
340 /* This method will return a true value if the specified phy can be assigned to
341 * this port The following is a list of phys for each port that are allowed: -
342 * Port 0 - 3 2 1 0 - Port 1 - 1 - Port 2 - 3 2 - Port 3 - 3 This method
343 * doesn't preclude all configurations. It merely ensures that a phy is part
344 * of the allowable set of phy identifiers for that port. For example, one
345 * could assign phy 3 to port 0 and no other phys. Please refer to
346 * scic_sds_port_is_phy_mask_valid() for information regarding whether the
347 * phy_mask for a port can be supported. bool true if this is a valid phy
348 * assignment for the port false if this is not a valid phy assignment for the
351 bool scic_sds_port_is_valid_phy_assignment(struct scic_sds_port *sci_port,
354 /* Initialize to invalid value. */
355 u32 existing_phy_index = SCI_MAX_PHYS;
358 if ((sci_port->physical_port_index == 1) && (phy_index != 1)) {
362 if (sci_port->physical_port_index == 3 && phy_index != 3) {
367 (sci_port->physical_port_index == 2)
368 && ((phy_index == 0) || (phy_index == 1))
373 for (index = 0; index < SCI_MAX_PHYS; index++) {
374 if ((sci_port->phy_table[index] != NULL)
375 && (index != phy_index)) {
376 existing_phy_index = index;
381 * Ensure that all of the phys in the port are capable of
382 * operating at the same maximum link rate. */
384 (existing_phy_index < SCI_MAX_PHYS)
385 && (sci_port->owning_controller->user_parameters.sds1.phys[
386 phy_index].max_speed_generation !=
387 sci_port->owning_controller->user_parameters.sds1.phys[
388 existing_phy_index].max_speed_generation)
397 * @sci_port: This is the port object for which to determine if the phy mask
400 * This method will return a true value if the port's phy mask can be supported
401 * by the SCU. The following is a list of valid PHY mask configurations for
402 * each port: - Port 0 - [[3 2] 1] 0 - Port 1 - [1] - Port 2 - [[3] 2]
403 * - Port 3 - [3] This method returns a boolean indication specifying if the
404 * phy mask can be supported. true if this is a valid phy assignment for the
405 * port false if this is not a valid phy assignment for the port
407 static bool scic_sds_port_is_phy_mask_valid(
408 struct scic_sds_port *sci_port,
411 if (sci_port->physical_port_index == 0) {
412 if (((phy_mask & 0x0F) == 0x0F)
413 || ((phy_mask & 0x03) == 0x03)
414 || ((phy_mask & 0x01) == 0x01)
417 } else if (sci_port->physical_port_index == 1) {
418 if (((phy_mask & 0x02) == 0x02)
421 } else if (sci_port->physical_port_index == 2) {
422 if (((phy_mask & 0x0C) == 0x0C)
423 || ((phy_mask & 0x04) == 0x04)
426 } else if (sci_port->physical_port_index == 3) {
427 if (((phy_mask & 0x08) == 0x08)
437 * @sci_port: This parameter specifies the port from which to return a
440 * This method retrieves a currently active (i.e. connected) phy contained in
441 * the port. Currently, the lowest order phy that is connected is returned.
442 * This method returns a pointer to a SCIS_SDS_PHY object. NULL This value is
443 * returned if there are no currently active (i.e. connected to a remote end
444 * point) phys contained in the port. All other values specify a struct scic_sds_phy
445 * object that is active in the port.
447 static struct scic_sds_phy *scic_sds_port_get_a_connected_phy(
448 struct scic_sds_port *sci_port
451 struct scic_sds_phy *phy;
453 for (index = 0; index < SCI_MAX_PHYS; index++) {
455 * Ensure that the phy is both part of the port and currently
456 * connected to the remote end-point. */
457 phy = sci_port->phy_table[index];
460 && scic_sds_port_active_phy(sci_port, phy)
470 * scic_sds_port_set_phy() -
471 * @out]: port The port object to which the phy assignement is being made.
472 * @out]: phy The phy which is being assigned to the port.
474 * This method attempts to make the assignment of the phy to the port. If
475 * successful the phy is assigned to the ports phy table. bool true if the phy
476 * assignment can be made. false if the phy assignement can not be made. This
477 * is a functional test that only fails if the phy is currently assigned to a
480 static enum sci_status scic_sds_port_set_phy(
481 struct scic_sds_port *port,
482 struct scic_sds_phy *phy)
485 * Check to see if we can add this phy to a port
486 * that means that the phy is not part of a port and that the port does
487 * not already have a phy assinged to the phy index. */
489 (port->phy_table[phy->phy_index] == NULL)
490 && (phy_get_non_dummy_port(phy) == NULL)
491 && scic_sds_port_is_valid_phy_assignment(port, phy->phy_index)
494 * Phy is being added in the stopped state so we are in MPC mode
495 * make logical port index = physical port index */
496 port->logical_port_index = port->physical_port_index;
497 port->phy_table[phy->phy_index] = phy;
498 scic_sds_phy_set_port(phy, port);
507 * scic_sds_port_clear_phy() -
508 * @out]: port The port from which the phy is being cleared.
509 * @out]: phy The phy being cleared from the port.
511 * This method will clear the phy assigned to this port. This method fails if
512 * this phy is not currently assinged to this port. bool true if the phy is
513 * removed from the port. false if this phy is not assined to this port.
515 static enum sci_status scic_sds_port_clear_phy(
516 struct scic_sds_port *port,
517 struct scic_sds_phy *phy)
519 /* Make sure that this phy is part of this port */
520 if (port->phy_table[phy->phy_index] == phy &&
521 phy_get_non_dummy_port(phy) == port) {
522 struct scic_sds_controller *scic = port->owning_controller;
523 struct isci_host *ihost = scic_to_ihost(scic);
525 /* Yep it is assigned to this port so remove it */
526 scic_sds_phy_set_port(phy, &ihost->ports[SCI_MAX_PORTS].sci);
527 port->phy_table[phy->phy_index] = NULL;
535 * scic_sds_port_add_phy() -
536 * @sci_port: This parameter specifies the port in which the phy will be added.
537 * @sci_phy: This parameter is the phy which is to be added to the port.
539 * This method will add a PHY to the selected port. This method returns an
540 * enum sci_status. SCI_SUCCESS the phy has been added to the port. Any other status
541 * is failre to add the phy to the port.
543 enum sci_status scic_sds_port_add_phy(
544 struct scic_sds_port *sci_port,
545 struct scic_sds_phy *sci_phy)
547 return sci_port->state_handlers->add_phy_handler(
553 * scic_sds_port_remove_phy() -
554 * @sci_port: This parameter specifies the port in which the phy will be added.
555 * @sci_phy: This parameter is the phy which is to be added to the port.
557 * This method will remove the PHY from the selected PORT. This method returns
558 * an enum sci_status. SCI_SUCCESS the phy has been removed from the port. Any other
559 * status is failre to add the phy to the port.
561 enum sci_status scic_sds_port_remove_phy(
562 struct scic_sds_port *sci_port,
563 struct scic_sds_phy *sci_phy)
565 return sci_port->state_handlers->remove_phy_handler(
570 * This method requests the SAS address for the supplied SAS port from the SCI
572 * @sci_port: a handle corresponding to the SAS port for which to return the
574 * @sas_address: This parameter specifies a pointer to a SAS address structure
575 * into which the core will copy the SAS address for the port.
578 void scic_sds_port_get_sas_address(
579 struct scic_sds_port *sci_port,
580 struct sci_sas_address *sas_address)
584 sas_address->high = 0;
585 sas_address->low = 0;
587 for (index = 0; index < SCI_MAX_PHYS; index++) {
588 if (sci_port->phy_table[index] != NULL) {
589 scic_sds_phy_get_sas_address(sci_port->phy_table[index], sas_address);
595 * This function requests the SAS address for the device directly attached to
597 * @sci_port: a handle corresponding to the SAS port for which to return the
599 * @sas_address: This parameter specifies a pointer to a SAS address structure
600 * into which the core will copy the SAS address for the device directly
601 * attached to the port.
604 void scic_sds_port_get_attached_sas_address(
605 struct scic_sds_port *sci_port,
606 struct sci_sas_address *sas_address)
608 struct scic_sds_phy *sci_phy;
611 * Ensure that the phy is both part of the port and currently
612 * connected to the remote end-point.
614 sci_phy = scic_sds_port_get_a_connected_phy(sci_port);
616 if (sci_phy->protocol != SCIC_SDS_PHY_PROTOCOL_SATA) {
617 scic_sds_phy_get_attached_sas_address(sci_phy,
620 scic_sds_phy_get_sas_address(sci_phy, sas_address);
621 sas_address->low += sci_phy->phy_index;
624 sas_address->high = 0;
625 sas_address->low = 0;
630 * scic_sds_port_construct_dummy_rnc() - create dummy rnc for si workaround
632 * @sci_port: logical port on which we need to create the remote node context
633 * @rni: remote node index for this remote node context.
635 * This routine will construct a dummy remote node context data structure
636 * This structure will be posted to the hardware to work around a scheduler
637 * error in the hardware.
639 static void scic_sds_port_construct_dummy_rnc(struct scic_sds_port *sci_port, u16 rni)
641 union scu_remote_node_context *rnc;
643 rnc = &sci_port->owning_controller->remote_node_context_table[rni];
645 memset(rnc, 0, sizeof(union scu_remote_node_context));
647 rnc->ssp.remote_sas_address_hi = 0;
648 rnc->ssp.remote_sas_address_lo = 0;
650 rnc->ssp.remote_node_index = rni;
651 rnc->ssp.remote_node_port_width = 1;
652 rnc->ssp.logical_port_index = sci_port->physical_port_index;
654 rnc->ssp.nexus_loss_timer_enable = false;
655 rnc->ssp.check_bit = false;
656 rnc->ssp.is_valid = true;
657 rnc->ssp.is_remote_node_context = true;
658 rnc->ssp.function_number = 0;
659 rnc->ssp.arbitration_wait_time = 0;
663 * scic_sds_port_construct_dummy_task() - create dummy task for si workaround
664 * @sci_port The logical port on which we need to create the
665 * remote node context.
667 * @tci The remote node index for this remote node context.
669 * This routine will construct a dummy task context data structure. This
670 * structure will be posted to the hardwre to work around a scheduler error
674 static void scic_sds_port_construct_dummy_task(struct scic_sds_port *sci_port, u16 tci)
676 struct scu_task_context *task_context;
678 task_context = scic_sds_controller_get_task_context_buffer(sci_port->owning_controller, tci);
680 memset(task_context, 0, sizeof(struct scu_task_context));
682 task_context->abort = 0;
683 task_context->priority = 0;
684 task_context->initiator_request = 1;
685 task_context->connection_rate = 1;
686 task_context->protocol_engine_index = 0;
687 task_context->logical_port_index = sci_port->physical_port_index;
688 task_context->protocol_type = SCU_TASK_CONTEXT_PROTOCOL_SSP;
689 task_context->task_index = scic_sds_io_tag_get_index(tci);
690 task_context->valid = SCU_TASK_CONTEXT_VALID;
691 task_context->context_type = SCU_TASK_CONTEXT_TYPE;
693 task_context->remote_node_index = sci_port->reserved_rni;
694 task_context->command_code = 0;
696 task_context->link_layer_control = 0;
697 task_context->do_not_dma_ssp_good_response = 1;
698 task_context->strict_ordering = 0;
699 task_context->control_frame = 0;
700 task_context->timeout_enable = 0;
701 task_context->block_guard_enable = 0;
703 task_context->address_modifier = 0;
705 task_context->task_phase = 0x01;
708 static void scic_sds_port_destroy_dummy_resources(struct scic_sds_port *sci_port)
710 struct scic_sds_controller *scic = sci_port->owning_controller;
712 if (sci_port->reserved_tci != SCU_DUMMY_INDEX)
713 scic_controller_free_io_tag(scic, sci_port->reserved_tci);
715 if (sci_port->reserved_rni != SCU_DUMMY_INDEX)
716 scic_sds_remote_node_table_release_remote_node_index(&scic->available_remote_nodes,
717 1, sci_port->reserved_rni);
719 sci_port->reserved_rni = SCU_DUMMY_INDEX;
720 sci_port->reserved_tci = SCU_DUMMY_INDEX;
724 * This method performs initialization of the supplied port. Initialization
725 * includes: - state machine initialization - member variable initialization
726 * - configuring the phy_mask
728 * @transport_layer_registers:
729 * @port_task_scheduler_registers:
730 * @port_configuration_regsiter:
732 * enum sci_status SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION This value is returned
733 * if the phy being added to the port
735 enum sci_status scic_sds_port_initialize(
736 struct scic_sds_port *sci_port,
737 void __iomem *port_task_scheduler_registers,
738 void __iomem *port_configuration_regsiter,
739 void __iomem *viit_registers)
741 sci_port->port_task_scheduler_registers = port_task_scheduler_registers;
742 sci_port->port_pe_configuration_register = port_configuration_regsiter;
743 sci_port->viit_registers = viit_registers;
749 * scic_port_hard_reset() - perform port hard reset
750 * @port: a handle corresponding to the SAS port to be hard reset.
751 * @reset_timeout: This parameter specifies the number of milliseconds in which
752 * the port reset operation should complete.
754 * The SCI User callback in scic_user_callbacks_t will only be called once for
755 * each phy in the SAS Port at completion of the hard reset sequence. Return a
756 * status indicating whether the hard reset started successfully. SCI_SUCCESS
757 * This value is returned if the hard reset operation started successfully.
759 static enum sci_status scic_port_hard_reset(struct scic_sds_port *port,
762 return port->state_handlers->reset_handler(
763 port, reset_timeout);
767 * This method assigns the direct attached device ID for this port.
769 * @param[in] sci_port The port for which the direct attached device id is to
771 * @param[in] device_id The direct attached device ID to assign to the port.
772 * This will be the RNi for the device
774 void scic_sds_port_setup_transports(
775 struct scic_sds_port *sci_port,
780 for (index = 0; index < SCI_MAX_PHYS; index++) {
781 if (sci_port->active_phy_mask & (1 << index))
782 scic_sds_phy_setup_transport(sci_port->phy_table[index], device_id);
788 * @sci_port: This is the port on which the phy should be enabled.
789 * @sci_phy: This is the specific phy which to enable.
790 * @do_notify_user: This parameter specifies whether to inform the user (via
791 * scic_cb_port_link_up()) as to the fact that a new phy as become ready.
793 * This function will activate the phy in the port.
794 * Activation includes: - adding
795 * the phy to the port - enabling the Protocol Engine in the silicon. -
796 * notifying the user that the link is up. none
798 static void scic_sds_port_activate_phy(struct scic_sds_port *sci_port,
799 struct scic_sds_phy *sci_phy,
802 struct scic_sds_controller *scic = sci_port->owning_controller;
803 struct isci_host *ihost = scic_to_ihost(scic);
805 if (sci_phy->protocol != SCIC_SDS_PHY_PROTOCOL_SATA)
806 scic_sds_phy_resume(sci_phy);
808 sci_port->active_phy_mask |= 1 << sci_phy->phy_index;
810 scic_sds_controller_clear_invalid_phy(scic, sci_phy);
812 if (do_notify_user == true)
813 isci_port_link_up(ihost, sci_port, sci_phy);
816 void scic_sds_port_deactivate_phy(struct scic_sds_port *sci_port,
817 struct scic_sds_phy *sci_phy,
820 struct scic_sds_controller *scic = scic_sds_port_get_controller(sci_port);
821 struct isci_port *iport = sci_port_to_iport(sci_port);
822 struct isci_host *ihost = scic_to_ihost(scic);
823 struct isci_phy *iphy = sci_phy_to_iphy(sci_phy);
825 sci_port->active_phy_mask &= ~(1 << sci_phy->phy_index);
827 sci_phy->max_negotiated_speed = SAS_LINK_RATE_UNKNOWN;
829 /* Re-assign the phy back to the LP as if it were a narrow port */
830 writel(sci_phy->phy_index,
831 &sci_port->port_pe_configuration_register[sci_phy->phy_index]);
833 if (do_notify_user == true)
834 isci_port_link_down(ihost, iphy, iport);
839 * @sci_port: This is the port on which the phy should be disabled.
840 * @sci_phy: This is the specific phy which to disabled.
842 * This function will disable the phy and report that the phy is not valid for
843 * this port object. None
845 static void scic_sds_port_invalid_link_up(struct scic_sds_port *sci_port,
846 struct scic_sds_phy *sci_phy)
848 struct scic_sds_controller *scic = sci_port->owning_controller;
851 * Check to see if we have alreay reported this link as bad and if
852 * not go ahead and tell the SCI_USER that we have discovered an
855 if ((scic->invalid_phy_mask & (1 << sci_phy->phy_index)) == 0) {
856 scic_sds_controller_set_invalid_phy(scic, sci_phy);
857 dev_warn(&scic_to_ihost(scic)->pdev->dev, "Invalid link up!\n");
861 static bool is_port_ready_state(enum scic_sds_port_states state)
864 case SCI_BASE_PORT_STATE_READY:
865 case SCIC_SDS_PORT_READY_SUBSTATE_WAITING:
866 case SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL:
867 case SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING:
874 /* flag dummy rnc hanling when exiting a ready state */
875 static void port_state_machine_change(struct scic_sds_port *sci_port,
876 enum scic_sds_port_states state)
878 struct sci_base_state_machine *sm = &sci_port->state_machine;
879 enum scic_sds_port_states old_state = sm->current_state_id;
881 if (is_port_ready_state(old_state) && !is_port_ready_state(state))
882 sci_port->ready_exit = true;
884 sci_base_state_machine_change_state(sm, state);
885 sci_port->ready_exit = false;
889 * scic_sds_port_general_link_up_handler - phy can be assigned to port?
890 * @sci_port: scic_sds_port object for which has a phy that has gone link up.
891 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
892 * @do_notify_user: This parameter specifies whether to inform the user (via
893 * scic_cb_port_link_up()) as to the fact that a new phy as become ready.
895 * Determine if this phy can be assigned to this
896 * port . If the phy is not a valid PHY for
897 * this port then the function will notify the user. A PHY can only be
898 * part of a port if it's attached SAS ADDRESS is the same as all other PHYs in
899 * the same port. none
901 static void scic_sds_port_general_link_up_handler(struct scic_sds_port *sci_port,
902 struct scic_sds_phy *sci_phy,
905 struct sci_sas_address port_sas_address;
906 struct sci_sas_address phy_sas_address;
908 scic_sds_port_get_attached_sas_address(sci_port, &port_sas_address);
909 scic_sds_phy_get_attached_sas_address(sci_phy, &phy_sas_address);
911 /* If the SAS address of the new phy matches the SAS address of
912 * other phys in the port OR this is the first phy in the port,
913 * then activate the phy and allow it to be used for operations
916 if ((phy_sas_address.high == port_sas_address.high &&
917 phy_sas_address.low == port_sas_address.low) ||
918 sci_port->active_phy_mask == 0) {
919 struct sci_base_state_machine *sm = &sci_port->state_machine;
921 scic_sds_port_activate_phy(sci_port, sci_phy, do_notify_user);
922 if (sm->current_state_id == SCI_BASE_PORT_STATE_RESETTING)
923 port_state_machine_change(sci_port, SCI_BASE_PORT_STATE_READY);
925 scic_sds_port_invalid_link_up(sci_port, sci_phy);
931 * This method returns false if the port only has a single phy object assigned.
932 * If there are no phys or more than one phy then the method will return
934 * @sci_port: The port for which the wide port condition is to be checked.
936 * bool true Is returned if this is a wide ported port. false Is returned if
937 * this is a narrow port.
939 static bool scic_sds_port_is_wide(struct scic_sds_port *sci_port)
944 for (index = 0; index < SCI_MAX_PHYS; index++) {
945 if (sci_port->phy_table[index] != NULL) {
950 return phy_count != 1;
954 * This method is called by the PHY object when the link is detected. if the
955 * port wants the PHY to continue on to the link up state then the port
956 * layer must return true. If the port object returns false the phy object
957 * must halt its attempt to go link up.
958 * @sci_port: The port associated with the phy object.
959 * @sci_phy: The phy object that is trying to go link up.
961 * true if the phy object can continue to the link up condition. true Is
962 * returned if this phy can continue to the ready state. false Is returned if
963 * can not continue on to the ready state. This notification is in place for
964 * wide ports and direct attached phys. Since there are no wide ported SATA
965 * devices this could become an invalid port configuration.
967 bool scic_sds_port_link_detected(
968 struct scic_sds_port *sci_port,
969 struct scic_sds_phy *sci_phy)
971 if ((sci_port->logical_port_index != SCIC_SDS_DUMMY_PORT) &&
972 (sci_phy->protocol == SCIC_SDS_PHY_PROTOCOL_SATA) &&
973 scic_sds_port_is_wide(sci_port)) {
974 scic_sds_port_invalid_link_up(sci_port, sci_phy);
983 * This method is the entry point for the phy to inform the port that it is now
989 void scic_sds_port_link_up(
990 struct scic_sds_port *sci_port,
991 struct scic_sds_phy *sci_phy)
993 sci_phy->is_in_link_training = false;
995 sci_port->state_handlers->link_up_handler(sci_port, sci_phy);
999 * This method is the entry point for the phy to inform the port that it is no
1000 * longer in a ready state
1005 void scic_sds_port_link_down(
1006 struct scic_sds_port *sci_port,
1007 struct scic_sds_phy *sci_phy)
1009 sci_port->state_handlers->link_down_handler(sci_port, sci_phy);
1013 * This method is called to start an IO request on this port.
1020 enum sci_status scic_sds_port_start_io(
1021 struct scic_sds_port *sci_port,
1022 struct scic_sds_remote_device *sci_dev,
1023 struct scic_sds_request *sci_req)
1025 return sci_port->state_handlers->start_io_handler(
1026 sci_port, sci_dev, sci_req);
1030 * This method is called to complete an IO request to the port.
1037 enum sci_status scic_sds_port_complete_io(
1038 struct scic_sds_port *sci_port,
1039 struct scic_sds_remote_device *sci_dev,
1040 struct scic_sds_request *sci_req)
1042 return sci_port->state_handlers->complete_io_handler(
1043 sci_port, sci_dev, sci_req);
1047 * This method is provided to timeout requests for port operations. Mostly its
1048 * for the port reset operation.
1052 static void scic_sds_port_timeout_handler(void *port)
1054 struct scic_sds_port *sci_port = port;
1057 current_state = sci_base_state_machine_get_state(&sci_port->state_machine);
1059 if (current_state == SCI_BASE_PORT_STATE_RESETTING) {
1060 /* if the port is still in the resetting state then the timeout
1061 * fired before the reset completed.
1063 port_state_machine_change(sci_port, SCI_BASE_PORT_STATE_FAILED);
1064 } else if (current_state == SCI_BASE_PORT_STATE_STOPPED) {
1065 /* if the port is stopped then the start request failed In this
1066 * case stay in the stopped state.
1068 dev_err(sciport_to_dev(sci_port),
1069 "%s: SCIC Port 0x%p failed to stop before tiemout.\n",
1072 } else if (current_state == SCI_BASE_PORT_STATE_STOPPING) {
1073 /* if the port is still stopping then the stop has not completed */
1074 isci_port_stop_complete(sci_port->owning_controller,
1076 SCI_FAILURE_TIMEOUT);
1078 /* The port is in the ready state and we have a timer
1079 * reporting a timeout this should not happen.
1081 dev_err(sciport_to_dev(sci_port),
1082 "%s: SCIC Port 0x%p is processing a timeout operation "
1083 "in state %d.\n", __func__, sci_port, current_state);
1087 /* --------------------------------------------------------------------------- */
1090 * This function updates the hardwares VIIT entry for this port.
1094 static void scic_sds_port_update_viit_entry(struct scic_sds_port *sci_port)
1096 struct sci_sas_address sas_address;
1098 scic_sds_port_get_sas_address(sci_port, &sas_address);
1100 writel(sas_address.high,
1101 &sci_port->viit_registers->initiator_sas_address_hi);
1102 writel(sas_address.low,
1103 &sci_port->viit_registers->initiator_sas_address_lo);
1105 /* This value get cleared just in case its not already cleared */
1106 writel(0, &sci_port->viit_registers->reserved);
1108 /* We are required to update the status register last */
1109 writel(SCU_VIIT_ENTRY_ID_VIIT |
1110 SCU_VIIT_IPPT_INITIATOR |
1111 ((1 << sci_port->physical_port_index) << SCU_VIIT_ENTRY_LPVIE_SHIFT) |
1112 SCU_VIIT_STATUS_ALL_VALID,
1113 &sci_port->viit_registers->status);
1117 * This method returns the maximum allowed speed for data transfers on this
1118 * port. This maximum allowed speed evaluates to the maximum speed of the
1119 * slowest phy in the port.
1120 * @sci_port: This parameter specifies the port for which to retrieve the
1121 * maximum allowed speed.
1123 * This method returns the maximum negotiated speed of the slowest phy in the
1126 enum sas_linkrate scic_sds_port_get_max_allowed_speed(
1127 struct scic_sds_port *sci_port)
1130 enum sas_linkrate max_allowed_speed = SAS_LINK_RATE_6_0_GBPS;
1131 struct scic_sds_phy *phy = NULL;
1134 * Loop through all of the phys in this port and find the phy with the
1135 * lowest maximum link rate. */
1136 for (index = 0; index < SCI_MAX_PHYS; index++) {
1137 phy = sci_port->phy_table[index];
1140 && (scic_sds_port_active_phy(sci_port, phy) == true)
1141 && (phy->max_negotiated_speed < max_allowed_speed)
1143 max_allowed_speed = phy->max_negotiated_speed;
1146 return max_allowed_speed;
1149 static void scic_port_enable_broadcast_change_notification(struct scic_sds_port *port)
1151 struct scic_sds_phy *phy;
1155 /* Loop through all of the phys to enable BCN. */
1156 for (index = 0; index < SCI_MAX_PHYS; index++) {
1157 phy = port->phy_table[index];
1160 readl(&phy->link_layer_registers->link_layer_control);
1162 /* clear the bit by writing 1. */
1163 writel(register_value,
1164 &phy->link_layer_registers->link_layer_control);
1170 * ****************************************************************************
1171 * * READY SUBSTATE HANDLERS
1172 * **************************************************************************** */
1175 * This method is the general ready substate complete io handler for the
1176 * struct scic_sds_port object. This function decrments the outstanding request count
1177 * for this port object. enum sci_status SCI_SUCCESS
1179 static enum sci_status scic_sds_port_ready_substate_complete_io_handler(
1180 struct scic_sds_port *port,
1181 struct scic_sds_remote_device *device,
1182 struct scic_sds_request *io_request)
1184 scic_sds_port_decrement_request_count(port);
1189 static enum sci_status scic_sds_port_ready_substate_add_phy_handler(struct scic_sds_port *sci_port,
1190 struct scic_sds_phy *sci_phy)
1192 enum sci_status status;
1194 status = scic_sds_port_set_phy(sci_port, sci_phy);
1196 if (status != SCI_SUCCESS)
1199 scic_sds_port_general_link_up_handler(sci_port, sci_phy, true);
1200 sci_port->not_ready_reason = SCIC_PORT_NOT_READY_RECONFIGURING;
1201 port_state_machine_change(sci_port, SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING);
1207 static enum sci_status scic_sds_port_ready_substate_remove_phy_handler(struct scic_sds_port *port,
1208 struct scic_sds_phy *phy)
1210 enum sci_status status;
1212 status = scic_sds_port_clear_phy(port, phy);
1214 if (status != SCI_SUCCESS)
1217 scic_sds_port_deactivate_phy(port, phy, true);
1219 port->not_ready_reason = SCIC_PORT_NOT_READY_RECONFIGURING;
1221 port_state_machine_change(port,
1222 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING);
1227 * ****************************************************************************
1228 * * READY SUBSTATE WAITING HANDLERS
1229 * **************************************************************************** */
1233 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1235 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
1237 * This method is the ready waiting substate link up handler for the
1238 * struct scic_sds_port object. This methos will report the link up condition for
1239 * this port and will transition to the ready operational substate. none
1241 static void scic_sds_port_ready_waiting_substate_link_up_handler(
1242 struct scic_sds_port *sci_port,
1243 struct scic_sds_phy *sci_phy)
1246 * Since this is the first phy going link up for the port we can just enable
1247 * it and continue. */
1248 scic_sds_port_activate_phy(sci_port, sci_phy, true);
1250 port_state_machine_change(sci_port,
1251 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL);
1255 * This method is the ready waiting substate start io handler for the
1256 * struct scic_sds_port object. The port object can not accept new requests so the
1257 * request is failed. enum sci_status SCI_FAILURE_INVALID_STATE
1259 static enum sci_status scic_sds_port_ready_waiting_substate_start_io_handler(
1260 struct scic_sds_port *port,
1261 struct scic_sds_remote_device *device,
1262 struct scic_sds_request *io_request)
1264 return SCI_FAILURE_INVALID_STATE;
1268 * ****************************************************************************
1269 * * READY SUBSTATE OPERATIONAL HANDLERS
1270 * **************************************************************************** */
1273 * This method will casue the port to reset. enum sci_status SCI_SUCCESS
1276 sci_status scic_sds_port_ready_operational_substate_reset_handler(
1277 struct scic_sds_port *port,
1280 enum sci_status status = SCI_FAILURE_INVALID_PHY;
1282 struct scic_sds_phy *selected_phy = NULL;
1285 /* Select a phy on which we can send the hard reset request. */
1287 (phy_index < SCI_MAX_PHYS) && (selected_phy == NULL);
1289 selected_phy = port->phy_table[phy_index];
1291 if ((selected_phy != NULL) &&
1292 !scic_sds_port_active_phy(port, selected_phy)) {
1294 * We found a phy but it is not ready select
1297 selected_phy = NULL;
1301 /* If we have a phy then go ahead and start the reset procedure */
1302 if (selected_phy != NULL) {
1303 status = scic_sds_phy_reset(selected_phy);
1305 if (status == SCI_SUCCESS) {
1306 isci_timer_start(port->timer_handle, timeout);
1307 port->not_ready_reason =
1308 SCIC_PORT_NOT_READY_HARD_RESET_REQUESTED;
1310 port_state_machine_change(port,
1311 SCI_BASE_PORT_STATE_RESETTING);
1319 * scic_sds_port_ready_operational_substate_link_up_handler() -
1320 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1322 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
1324 * This method is the ready operational substate link up handler for the
1325 * struct scic_sds_port object. This function notifies the SCI User that the phy has
1326 * gone link up. none
1328 static void scic_sds_port_ready_operational_substate_link_up_handler(
1329 struct scic_sds_port *sci_port,
1330 struct scic_sds_phy *sci_phy)
1332 scic_sds_port_general_link_up_handler(sci_port, sci_phy, true);
1336 * scic_sds_port_ready_operational_substate_link_down_handler() -
1337 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1339 * @sci_phy: This is the struct scic_sds_phy object that has gone link down.
1341 * This method is the ready operational substate link down handler for the
1342 * struct scic_sds_port object. This function notifies the SCI User that the phy has
1343 * gone link down and if this is the last phy in the port the port will change
1344 * state to the ready waiting substate. none
1346 static void scic_sds_port_ready_operational_substate_link_down_handler(
1347 struct scic_sds_port *sci_port,
1348 struct scic_sds_phy *sci_phy)
1350 scic_sds_port_deactivate_phy(sci_port, sci_phy, true);
1353 * If there are no active phys left in the port, then transition
1354 * the port to the WAITING state until such time as a phy goes
1356 if (sci_port->active_phy_mask == 0)
1357 port_state_machine_change(sci_port,
1358 SCIC_SDS_PORT_READY_SUBSTATE_WAITING);
1362 * This method is the ready operational substate start io handler for the
1363 * struct scic_sds_port object. This function incremetns the outstanding request
1364 * count for this port object. enum sci_status SCI_SUCCESS
1366 static enum sci_status scic_sds_port_ready_operational_substate_start_io_handler(
1367 struct scic_sds_port *port,
1368 struct scic_sds_remote_device *device,
1369 struct scic_sds_request *io_request)
1371 port->started_request_count++;
1376 * ****************************************************************************
1377 * * READY SUBSTATE OPERATIONAL HANDLERS
1378 * **************************************************************************** */
1381 * This is the default method for a port add phy request. It will report a
1382 * warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE
1384 static enum sci_status scic_sds_port_ready_configuring_substate_add_phy_handler(
1385 struct scic_sds_port *port,
1386 struct scic_sds_phy *phy)
1388 enum sci_status status;
1390 status = scic_sds_port_set_phy(port, phy);
1392 if (status == SCI_SUCCESS) {
1393 scic_sds_port_general_link_up_handler(port, phy, true);
1396 * Re-enter the configuring state since this may be the last phy in
1398 port_state_machine_change(port,
1399 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING);
1406 * This is the default method for a port remove phy request. It will report a
1407 * warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE
1409 static enum sci_status scic_sds_port_ready_configuring_substate_remove_phy_handler(
1410 struct scic_sds_port *port,
1411 struct scic_sds_phy *phy)
1413 enum sci_status status;
1415 status = scic_sds_port_clear_phy(port, phy);
1417 if (status != SCI_SUCCESS)
1419 scic_sds_port_deactivate_phy(port, phy, true);
1421 /* Re-enter the configuring state since this may be the last phy in
1424 port_state_machine_change(port,
1425 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING);
1431 * scic_sds_port_ready_configuring_substate_complete_io_handler() -
1432 * @port: This is the port that is being requested to complete the io request.
1433 * @device: This is the device on which the io is completing.
1435 * This method will decrement the outstanding request count for this port. If
1436 * the request count goes to 0 then the port can be reprogrammed with its new
1439 static enum sci_status
1440 scic_sds_port_ready_configuring_substate_complete_io_handler(
1441 struct scic_sds_port *port,
1442 struct scic_sds_remote_device *device,
1443 struct scic_sds_request *io_request)
1445 scic_sds_port_decrement_request_count(port);
1447 if (port->started_request_count == 0) {
1448 port_state_machine_change(port,
1449 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL);
1455 static enum sci_status default_port_handler(struct scic_sds_port *sci_port,
1458 dev_warn(sciport_to_dev(sci_port),
1459 "%s: in wrong state: %d\n", func,
1460 sci_base_state_machine_get_state(&sci_port->state_machine));
1461 return SCI_FAILURE_INVALID_STATE;
1464 static enum sci_status
1465 scic_sds_port_default_reset_handler(struct scic_sds_port *sci_port,
1468 return default_port_handler(sci_port, __func__);
1471 static enum sci_status
1472 scic_sds_port_default_add_phy_handler(struct scic_sds_port *sci_port,
1473 struct scic_sds_phy *base_phy)
1475 return default_port_handler(sci_port, __func__);
1478 static enum sci_status
1479 scic_sds_port_default_remove_phy_handler(struct scic_sds_port *sci_port,
1480 struct scic_sds_phy *base_phy)
1482 return default_port_handler(sci_port, __func__);
1486 * This is the default method for a port unsolicited frame request. It will
1487 * report a warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE Is it even
1488 * possible to receive an unsolicited frame directed to a port object? It
1489 * seems possible if we implementing virtual functions but until then?
1491 static enum sci_status
1492 scic_sds_port_default_frame_handler(struct scic_sds_port *sci_port,
1495 struct scic_sds_controller *scic = scic_sds_port_get_controller(sci_port);
1497 default_port_handler(sci_port, __func__);
1498 scic_sds_controller_release_frame(scic, frame_index);
1500 return SCI_FAILURE_INVALID_STATE;
1503 static enum sci_status scic_sds_port_default_event_handler(struct scic_sds_port *sci_port,
1506 return default_port_handler(sci_port, __func__);
1509 static void scic_sds_port_default_link_up_handler(struct scic_sds_port *sci_port,
1510 struct scic_sds_phy *sci_phy)
1512 default_port_handler(sci_port, __func__);
1515 static void scic_sds_port_default_link_down_handler(struct scic_sds_port *sci_port,
1516 struct scic_sds_phy *sci_phy)
1518 default_port_handler(sci_port, __func__);
1521 static enum sci_status scic_sds_port_default_start_io_handler(struct scic_sds_port *sci_port,
1522 struct scic_sds_remote_device *sci_dev,
1523 struct scic_sds_request *sci_req)
1525 return default_port_handler(sci_port, __func__);
1528 static enum sci_status scic_sds_port_default_complete_io_handler(struct scic_sds_port *sci_port,
1529 struct scic_sds_remote_device *sci_dev,
1530 struct scic_sds_request *sci_req)
1532 return default_port_handler(sci_port, __func__);
1536 * ******************************************************************************
1537 * * PORT STATE PRIVATE METHODS
1538 * ****************************************************************************** */
1542 * @sci_port: This is the struct scic_sds_port object to suspend.
1544 * This method will susped the port task scheduler for this port object. none
1547 scic_sds_port_suspend_port_task_scheduler(struct scic_sds_port *port)
1549 u32 pts_control_value;
1551 pts_control_value = readl(&port->port_task_scheduler_registers->control);
1552 pts_control_value |= SCU_PTSxCR_GEN_BIT(SUSPEND);
1553 writel(pts_control_value, &port->port_task_scheduler_registers->control);
1557 * scic_sds_port_post_dummy_request() - post dummy/workaround request
1558 * @sci_port: port to post task
1560 * Prevent the hardware scheduler from posting new requests to the front
1561 * of the scheduler queue causing a starvation problem for currently
1565 static void scic_sds_port_post_dummy_request(struct scic_sds_port *sci_port)
1568 struct scu_task_context *task_context;
1569 struct scic_sds_controller *scic = sci_port->owning_controller;
1570 u16 tci = sci_port->reserved_tci;
1572 task_context = scic_sds_controller_get_task_context_buffer(scic, tci);
1574 task_context->abort = 0;
1576 command = SCU_CONTEXT_COMMAND_REQUEST_TYPE_POST_TC |
1577 sci_port->physical_port_index << SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT |
1580 scic_sds_controller_post_request(scic, command);
1584 * This routine will abort the dummy request. This will alow the hardware to
1585 * power down parts of the silicon to save power.
1587 * @sci_port: The port on which the task must be aborted.
1590 static void scic_sds_port_abort_dummy_request(struct scic_sds_port *sci_port)
1592 struct scic_sds_controller *scic = sci_port->owning_controller;
1593 u16 tci = sci_port->reserved_tci;
1594 struct scu_task_context *tc;
1597 tc = scic_sds_controller_get_task_context_buffer(scic, tci);
1601 command = SCU_CONTEXT_COMMAND_REQUEST_POST_TC_ABORT |
1602 sci_port->physical_port_index << SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT |
1605 scic_sds_controller_post_request(scic, command);
1610 * @sci_port: This is the struct scic_sds_port object to resume.
1612 * This method will resume the port task scheduler for this port object. none
1615 scic_sds_port_resume_port_task_scheduler(struct scic_sds_port *port)
1617 u32 pts_control_value;
1619 pts_control_value = readl(&port->port_task_scheduler_registers->control);
1620 pts_control_value &= ~SCU_PTSxCR_GEN_BIT(SUSPEND);
1621 writel(pts_control_value, &port->port_task_scheduler_registers->control);
1625 * ******************************************************************************
1626 * * PORT READY SUBSTATE METHODS
1627 * ****************************************************************************** */
1631 * @object: This is the object which is cast to a struct scic_sds_port object.
1633 * This method will perform the actions required by the struct scic_sds_port on
1634 * entering the SCIC_SDS_PORT_READY_SUBSTATE_WAITING. This function checks the
1635 * port for any ready phys. If there is at least one phy in a ready state then
1636 * the port transitions to the ready operational substate. none
1638 static void scic_sds_port_ready_substate_waiting_enter(void *object)
1640 struct scic_sds_port *sci_port = object;
1642 scic_sds_port_set_base_state_handlers(
1643 sci_port, SCIC_SDS_PORT_READY_SUBSTATE_WAITING
1646 scic_sds_port_suspend_port_task_scheduler(sci_port);
1648 sci_port->not_ready_reason = SCIC_PORT_NOT_READY_NO_ACTIVE_PHYS;
1650 if (sci_port->active_phy_mask != 0) {
1651 /* At least one of the phys on the port is ready */
1652 port_state_machine_change(sci_port,
1653 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL);
1659 * @object: This is the object which is cast to a struct scic_sds_port object.
1661 * This function will perform the actions required by the struct scic_sds_port
1662 * on entering the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function sets
1663 * the state handlers for the port object, notifies the SCI User that the port
1664 * is ready, and resumes port operations. none
1666 static void scic_sds_port_ready_substate_operational_enter(void *object)
1669 struct scic_sds_port *sci_port = object;
1670 struct scic_sds_controller *scic = sci_port->owning_controller;
1671 struct isci_host *ihost = scic_to_ihost(scic);
1672 struct isci_port *iport = sci_port_to_iport(sci_port);
1674 scic_sds_port_set_base_state_handlers(
1676 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL);
1678 isci_port_ready(ihost, iport);
1680 for (index = 0; index < SCI_MAX_PHYS; index++) {
1681 if (sci_port->phy_table[index]) {
1682 writel(sci_port->physical_port_index,
1683 &sci_port->port_pe_configuration_register[
1684 sci_port->phy_table[index]->phy_index]);
1688 scic_sds_port_update_viit_entry(sci_port);
1690 scic_sds_port_resume_port_task_scheduler(sci_port);
1693 * Post the dummy task for the port so the hardware can schedule
1696 scic_sds_port_post_dummy_request(sci_port);
1699 static void scic_sds_port_invalidate_dummy_remote_node(struct scic_sds_port *sci_port)
1701 struct scic_sds_controller *scic = sci_port->owning_controller;
1702 u8 phys_index = sci_port->physical_port_index;
1703 union scu_remote_node_context *rnc;
1704 u16 rni = sci_port->reserved_rni;
1707 rnc = &scic->remote_node_context_table[rni];
1709 rnc->ssp.is_valid = false;
1711 /* ensure the preceding tc abort request has reached the
1712 * controller and give it ample time to act before posting the rnc
1715 readl(&scic->smu_registers->interrupt_status); /* flush */
1718 command = SCU_CONTEXT_COMMAND_POST_RNC_INVALIDATE |
1719 phys_index << SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT | rni;
1721 scic_sds_controller_post_request(scic, command);
1726 * @object: This is the object which is cast to a struct scic_sds_port object.
1728 * This method will perform the actions required by the struct scic_sds_port on
1729 * exiting the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function reports
1730 * the port not ready and suspends the port task scheduler. none
1732 static void scic_sds_port_ready_substate_operational_exit(void *object)
1734 struct scic_sds_port *sci_port = object;
1735 struct scic_sds_controller *scic = sci_port->owning_controller;
1736 struct isci_host *ihost = scic_to_ihost(scic);
1737 struct isci_port *iport = sci_port_to_iport(sci_port);
1740 * Kill the dummy task for this port if it has not yet posted
1741 * the hardware will treat this as a NOP and just return abort
1744 scic_sds_port_abort_dummy_request(sci_port);
1746 isci_port_not_ready(ihost, iport);
1748 if (sci_port->ready_exit)
1749 scic_sds_port_invalidate_dummy_remote_node(sci_port);
1753 * ******************************************************************************
1754 * * PORT READY CONFIGURING METHODS
1755 * ****************************************************************************** */
1758 * scic_sds_port_ready_substate_configuring_enter() -
1759 * @object: This is the object which is cast to a struct scic_sds_port object.
1761 * This method will perform the actions required by the struct scic_sds_port on
1762 * exiting the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function reports
1763 * the port not ready and suspends the port task scheduler. none
1765 static void scic_sds_port_ready_substate_configuring_enter(void *object)
1767 struct scic_sds_port *sci_port = object;
1768 struct scic_sds_controller *scic = sci_port->owning_controller;
1769 struct isci_host *ihost = scic_to_ihost(scic);
1770 struct isci_port *iport = sci_port_to_iport(sci_port);
1772 scic_sds_port_set_base_state_handlers(
1774 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING);
1776 if (sci_port->active_phy_mask == 0) {
1777 isci_port_not_ready(ihost, iport);
1779 port_state_machine_change(sci_port,
1780 SCIC_SDS_PORT_READY_SUBSTATE_WAITING);
1781 } else if (sci_port->started_request_count == 0)
1782 port_state_machine_change(sci_port,
1783 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL);
1786 static void scic_sds_port_ready_substate_configuring_exit(void *object)
1788 struct scic_sds_port *sci_port = object;
1790 scic_sds_port_suspend_port_task_scheduler(sci_port);
1791 if (sci_port->ready_exit)
1792 scic_sds_port_invalidate_dummy_remote_node(sci_port);
1795 /* --------------------------------------------------------------------------- */
1799 * @port: This is the struct scic_sds_port object on which the io request count will
1801 * @device: This is the struct scic_sds_remote_device object to which the io request
1802 * is being directed. This parameter is not required to complete this
1804 * @io_request: This is the request that is being completed on this port
1805 * object. This parameter is not required to complete this operation.
1807 * This is a general complete io request handler for the struct scic_sds_port object.
1808 * enum sci_status SCI_SUCCESS
1810 static enum sci_status scic_sds_port_general_complete_io_handler(
1811 struct scic_sds_port *port,
1812 struct scic_sds_remote_device *device,
1813 struct scic_sds_request *io_request)
1815 scic_sds_port_decrement_request_count(port);
1821 * This method takes the struct scic_sds_port that is in a stopped state and handles
1822 * the add phy request. In MPC mode the only time a phy can be added to a port
1823 * is in the SCI_BASE_PORT_STATE_STOPPED. enum sci_status
1824 * SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION is returned when the phy can not
1825 * be added to the port. SCI_SUCCESS if the phy is added to the port.
1827 static enum sci_status scic_sds_port_stopped_state_add_phy_handler(
1828 struct scic_sds_port *port,
1829 struct scic_sds_phy *phy)
1831 struct sci_sas_address port_sas_address;
1833 /* Read the port assigned SAS Address if there is one */
1834 scic_sds_port_get_sas_address(port, &port_sas_address);
1836 if (port_sas_address.high != 0 && port_sas_address.low != 0) {
1837 struct sci_sas_address phy_sas_address;
1840 * Make sure that the PHY SAS Address matches the SAS Address
1842 scic_sds_phy_get_sas_address(phy, &phy_sas_address);
1845 (port_sas_address.high != phy_sas_address.high)
1846 || (port_sas_address.low != phy_sas_address.low)
1848 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
1852 return scic_sds_port_set_phy(port, phy);
1856 * This method takes the struct scic_sds_port that is in a stopped state and handles
1857 * the remove phy request. In MPC mode the only time a phy can be removed from
1858 * a port is in the SCI_BASE_PORT_STATE_STOPPED. enum sci_status
1859 * SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION is returned when the phy can not
1860 * be added to the port. SCI_SUCCESS if the phy is added to the port.
1862 static enum sci_status scic_sds_port_stopped_state_remove_phy_handler(
1863 struct scic_sds_port *port,
1864 struct scic_sds_phy *phy)
1866 return scic_sds_port_clear_phy(port, phy);
1870 * ****************************************************************************
1871 * * READY STATE HANDLERS
1872 * **************************************************************************** */
1875 * ****************************************************************************
1876 * * RESETTING STATE HANDLERS
1877 * **************************************************************************** */
1880 * ****************************************************************************
1881 * * STOPPING STATE HANDLERS
1882 * **************************************************************************** */
1885 * This method takes the struct scic_sds_port that is in a stopping state and handles
1886 * the complete io request. Should the request count reach 0 then the port
1887 * object will transition to the stopped state. enum sci_status SCI_SUCCESS
1889 static enum sci_status scic_sds_port_stopping_state_complete_io_handler(
1890 struct scic_sds_port *sci_port,
1891 struct scic_sds_remote_device *device,
1892 struct scic_sds_request *io_request)
1894 scic_sds_port_decrement_request_count(sci_port);
1896 if (sci_port->started_request_count == 0)
1897 port_state_machine_change(sci_port,
1898 SCI_BASE_PORT_STATE_STOPPED);
1904 * ****************************************************************************
1905 * * RESETTING STATE HANDLERS
1906 * **************************************************************************** */
1909 * This method will transition a failed port to its ready state. The port
1910 * failed because a hard reset request timed out but at some time later one or
1911 * more phys in the port became ready. enum sci_status SCI_SUCCESS
1913 static void scic_sds_port_reset_state_link_up_handler(
1914 struct scic_sds_port *port,
1915 struct scic_sds_phy *phy)
1918 * / @todo We should make sure that the phy that has gone link up is the same
1919 * / one on which we sent the reset. It is possible that the phy on
1920 * / which we sent the reset is not the one that has gone link up and we
1921 * / want to make sure that phy being reset comes back. Consider the
1922 * / case where a reset is sent but before the hardware processes the
1923 * / reset it get a link up on the port because of a hot plug event.
1924 * / because of the reset request this phy will go link down almost
1928 * In the resetting state we don't notify the user regarding
1929 * link up and link down notifications. */
1930 scic_sds_port_general_link_up_handler(port, phy, false);
1934 * This method process link down notifications that occur during a port reset
1935 * operation. Link downs can occur during the reset operation. enum sci_status
1938 static void scic_sds_port_reset_state_link_down_handler(
1939 struct scic_sds_port *port,
1940 struct scic_sds_phy *phy)
1943 * In the resetting state we don't notify the user regarding
1944 * link up and link down notifications. */
1945 scic_sds_port_deactivate_phy(port, phy, false);
1948 enum sci_status scic_sds_port_start(struct scic_sds_port *sci_port)
1950 struct scic_sds_controller *scic = sci_port->owning_controller;
1951 struct isci_host *ihost = scic_to_ihost(scic);
1952 enum sci_status status = SCI_SUCCESS;
1953 enum scic_sds_port_states state;
1956 state = sci_port->state_machine.current_state_id;
1957 if (state != SCI_BASE_PORT_STATE_STOPPED) {
1958 dev_warn(sciport_to_dev(sci_port),
1959 "%s: in wrong state: %d\n", __func__, state);
1960 return SCI_FAILURE_INVALID_STATE;
1963 if (sci_port->assigned_device_count > 0) {
1964 /* TODO This is a start failure operation because
1965 * there are still devices assigned to this port.
1966 * There must be no devices assigned to a port on a
1969 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
1972 sci_port->timer_handle =
1973 isci_timer_create(ihost,
1975 scic_sds_port_timeout_handler);
1977 if (!sci_port->timer_handle)
1978 return SCI_FAILURE_INSUFFICIENT_RESOURCES;
1980 if (sci_port->reserved_rni == SCU_DUMMY_INDEX) {
1981 u16 rni = scic_sds_remote_node_table_allocate_remote_node(
1982 &scic->available_remote_nodes, 1);
1984 if (rni != SCU_DUMMY_INDEX)
1985 scic_sds_port_construct_dummy_rnc(sci_port, rni);
1987 status = SCI_FAILURE_INSUFFICIENT_RESOURCES;
1988 sci_port->reserved_rni = rni;
1991 if (sci_port->reserved_tci == SCU_DUMMY_INDEX) {
1992 /* Allocate a TCI and remove the sequence nibble */
1993 u16 tci = scic_controller_allocate_io_tag(scic);
1995 if (tci != SCU_DUMMY_INDEX)
1996 scic_sds_port_construct_dummy_task(sci_port, tci);
1998 status = SCI_FAILURE_INSUFFICIENT_RESOURCES;
1999 sci_port->reserved_tci = tci;
2002 if (status == SCI_SUCCESS) {
2003 phy_mask = scic_sds_port_get_phys(sci_port);
2006 * There are one or more phys assigned to this port. Make sure
2007 * the port's phy mask is in fact legal and supported by the
2010 if (scic_sds_port_is_phy_mask_valid(sci_port, phy_mask) == true) {
2011 port_state_machine_change(sci_port,
2012 SCI_BASE_PORT_STATE_READY);
2016 status = SCI_FAILURE;
2019 if (status != SCI_SUCCESS)
2020 scic_sds_port_destroy_dummy_resources(sci_port);
2025 enum sci_status scic_sds_port_stop(struct scic_sds_port *sci_port)
2027 enum scic_sds_port_states state;
2029 state = sci_port->state_machine.current_state_id;
2031 case SCI_BASE_PORT_STATE_STOPPED:
2033 case SCIC_SDS_PORT_READY_SUBSTATE_WAITING:
2034 case SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL:
2035 case SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING:
2036 case SCI_BASE_PORT_STATE_RESETTING:
2037 port_state_machine_change(sci_port,
2038 SCI_BASE_PORT_STATE_STOPPING);
2041 dev_warn(sciport_to_dev(sci_port),
2042 "%s: in wrong state: %d\n", __func__, state);
2043 return SCI_FAILURE_INVALID_STATE;
2047 static struct scic_sds_port_state_handler scic_sds_port_state_handler_table[] = {
2048 [SCI_BASE_PORT_STATE_STOPPED] = {
2049 .reset_handler = scic_sds_port_default_reset_handler,
2050 .add_phy_handler = scic_sds_port_stopped_state_add_phy_handler,
2051 .remove_phy_handler = scic_sds_port_stopped_state_remove_phy_handler,
2052 .frame_handler = scic_sds_port_default_frame_handler,
2053 .event_handler = scic_sds_port_default_event_handler,
2054 .link_up_handler = scic_sds_port_default_link_up_handler,
2055 .link_down_handler = scic_sds_port_default_link_down_handler,
2056 .start_io_handler = scic_sds_port_default_start_io_handler,
2057 .complete_io_handler = scic_sds_port_default_complete_io_handler
2059 [SCI_BASE_PORT_STATE_STOPPING] = {
2060 .reset_handler = scic_sds_port_default_reset_handler,
2061 .add_phy_handler = scic_sds_port_default_add_phy_handler,
2062 .remove_phy_handler = scic_sds_port_default_remove_phy_handler,
2063 .frame_handler = scic_sds_port_default_frame_handler,
2064 .event_handler = scic_sds_port_default_event_handler,
2065 .link_up_handler = scic_sds_port_default_link_up_handler,
2066 .link_down_handler = scic_sds_port_default_link_down_handler,
2067 .start_io_handler = scic_sds_port_default_start_io_handler,
2068 .complete_io_handler = scic_sds_port_stopping_state_complete_io_handler
2070 [SCI_BASE_PORT_STATE_READY] = {
2071 .reset_handler = scic_sds_port_default_reset_handler,
2072 .add_phy_handler = scic_sds_port_default_add_phy_handler,
2073 .remove_phy_handler = scic_sds_port_default_remove_phy_handler,
2074 .frame_handler = scic_sds_port_default_frame_handler,
2075 .event_handler = scic_sds_port_default_event_handler,
2076 .link_up_handler = scic_sds_port_default_link_up_handler,
2077 .link_down_handler = scic_sds_port_default_link_down_handler,
2078 .start_io_handler = scic_sds_port_default_start_io_handler,
2079 .complete_io_handler = scic_sds_port_general_complete_io_handler
2081 [SCIC_SDS_PORT_READY_SUBSTATE_WAITING] = {
2082 .reset_handler = scic_sds_port_default_reset_handler,
2083 .add_phy_handler = scic_sds_port_ready_substate_add_phy_handler,
2084 .remove_phy_handler = scic_sds_port_default_remove_phy_handler,
2085 .frame_handler = scic_sds_port_default_frame_handler,
2086 .event_handler = scic_sds_port_default_event_handler,
2087 .link_up_handler = scic_sds_port_ready_waiting_substate_link_up_handler,
2088 .link_down_handler = scic_sds_port_default_link_down_handler,
2089 .start_io_handler = scic_sds_port_ready_waiting_substate_start_io_handler,
2090 .complete_io_handler = scic_sds_port_ready_substate_complete_io_handler,
2092 [SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL] = {
2093 .reset_handler = scic_sds_port_ready_operational_substate_reset_handler,
2094 .add_phy_handler = scic_sds_port_ready_substate_add_phy_handler,
2095 .remove_phy_handler = scic_sds_port_ready_substate_remove_phy_handler,
2096 .frame_handler = scic_sds_port_default_frame_handler,
2097 .event_handler = scic_sds_port_default_event_handler,
2098 .link_up_handler = scic_sds_port_ready_operational_substate_link_up_handler,
2099 .link_down_handler = scic_sds_port_ready_operational_substate_link_down_handler,
2100 .start_io_handler = scic_sds_port_ready_operational_substate_start_io_handler,
2101 .complete_io_handler = scic_sds_port_ready_substate_complete_io_handler,
2103 [SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING] = {
2104 .reset_handler = scic_sds_port_default_reset_handler,
2105 .add_phy_handler = scic_sds_port_ready_configuring_substate_add_phy_handler,
2106 .remove_phy_handler = scic_sds_port_ready_configuring_substate_remove_phy_handler,
2107 .frame_handler = scic_sds_port_default_frame_handler,
2108 .event_handler = scic_sds_port_default_event_handler,
2109 .link_up_handler = scic_sds_port_default_link_up_handler,
2110 .link_down_handler = scic_sds_port_default_link_down_handler,
2111 .start_io_handler = scic_sds_port_default_start_io_handler,
2112 .complete_io_handler = scic_sds_port_ready_configuring_substate_complete_io_handler
2114 [SCI_BASE_PORT_STATE_RESETTING] = {
2115 .reset_handler = scic_sds_port_default_reset_handler,
2116 .add_phy_handler = scic_sds_port_default_add_phy_handler,
2117 .remove_phy_handler = scic_sds_port_default_remove_phy_handler,
2118 .frame_handler = scic_sds_port_default_frame_handler,
2119 .event_handler = scic_sds_port_default_event_handler,
2120 .link_up_handler = scic_sds_port_reset_state_link_up_handler,
2121 .link_down_handler = scic_sds_port_reset_state_link_down_handler,
2122 .start_io_handler = scic_sds_port_default_start_io_handler,
2123 .complete_io_handler = scic_sds_port_general_complete_io_handler
2125 [SCI_BASE_PORT_STATE_FAILED] = {
2126 .reset_handler = scic_sds_port_default_reset_handler,
2127 .add_phy_handler = scic_sds_port_default_add_phy_handler,
2128 .remove_phy_handler = scic_sds_port_default_remove_phy_handler,
2129 .frame_handler = scic_sds_port_default_frame_handler,
2130 .event_handler = scic_sds_port_default_event_handler,
2131 .link_up_handler = scic_sds_port_default_link_up_handler,
2132 .link_down_handler = scic_sds_port_default_link_down_handler,
2133 .start_io_handler = scic_sds_port_default_start_io_handler,
2134 .complete_io_handler = scic_sds_port_general_complete_io_handler
2139 * ******************************************************************************
2140 * * PORT STATE PRIVATE METHODS
2141 * ****************************************************************************** */
2145 * @sci_port: This is the port object which to suspend.
2147 * This method will enable the SCU Port Task Scheduler for this port object but
2148 * will leave the port task scheduler in a suspended state. none
2151 scic_sds_port_enable_port_task_scheduler(struct scic_sds_port *port)
2153 u32 pts_control_value;
2155 pts_control_value = readl(&port->port_task_scheduler_registers->control);
2156 pts_control_value |= SCU_PTSxCR_GEN_BIT(ENABLE) | SCU_PTSxCR_GEN_BIT(SUSPEND);
2157 writel(pts_control_value, &port->port_task_scheduler_registers->control);
2162 * @sci_port: This is the port object which to resume.
2164 * This method will disable the SCU port task scheduler for this port object.
2168 scic_sds_port_disable_port_task_scheduler(struct scic_sds_port *port)
2170 u32 pts_control_value;
2172 pts_control_value = readl(&port->port_task_scheduler_registers->control);
2173 pts_control_value &=
2174 ~(SCU_PTSxCR_GEN_BIT(ENABLE) | SCU_PTSxCR_GEN_BIT(SUSPEND));
2175 writel(pts_control_value, &port->port_task_scheduler_registers->control);
2178 static void scic_sds_port_post_dummy_remote_node(struct scic_sds_port *sci_port)
2180 struct scic_sds_controller *scic = sci_port->owning_controller;
2181 u8 phys_index = sci_port->physical_port_index;
2182 union scu_remote_node_context *rnc;
2183 u16 rni = sci_port->reserved_rni;
2186 rnc = &scic->remote_node_context_table[rni];
2187 rnc->ssp.is_valid = true;
2189 command = SCU_CONTEXT_COMMAND_POST_RNC_32 |
2190 phys_index << SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT | rni;
2192 scic_sds_controller_post_request(scic, command);
2194 /* ensure hardware has seen the post rnc command and give it
2195 * ample time to act before sending the suspend
2197 readl(&scic->smu_registers->interrupt_status); /* flush */
2200 command = SCU_CONTEXT_COMMAND_POST_RNC_SUSPEND_TX_RX |
2201 phys_index << SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT | rni;
2203 scic_sds_controller_post_request(scic, command);
2207 * ******************************************************************************
2208 * * PORT STATE METHODS
2209 * ****************************************************************************** */
2213 * @object: This is the object which is cast to a struct scic_sds_port object.
2215 * This method will perform the actions required by the struct scic_sds_port on
2216 * entering the SCI_BASE_PORT_STATE_STOPPED. This function sets the stopped
2217 * state handlers for the struct scic_sds_port object and disables the port task
2218 * scheduler in the hardware. none
2220 static void scic_sds_port_stopped_state_enter(void *object)
2222 struct scic_sds_port *sci_port = object;
2224 scic_sds_port_set_base_state_handlers(
2225 sci_port, SCI_BASE_PORT_STATE_STOPPED
2229 SCI_BASE_PORT_STATE_STOPPING
2230 == sci_port->state_machine.previous_state_id
2233 * If we enter this state becasuse of a request to stop
2234 * the port then we want to disable the hardwares port
2235 * task scheduler. */
2236 scic_sds_port_disable_port_task_scheduler(sci_port);
2242 * @object: This is the object which is cast to a struct scic_sds_port object.
2244 * This method will perform the actions required by the struct scic_sds_port on
2245 * exiting the SCI_BASE_STATE_STOPPED. This function enables the SCU hardware
2246 * port task scheduler. none
2248 static void scic_sds_port_stopped_state_exit(void *object)
2250 struct scic_sds_port *sci_port = object;
2252 /* Enable and suspend the port task scheduler */
2253 scic_sds_port_enable_port_task_scheduler(sci_port);
2257 * scic_sds_port_ready_state_enter -
2258 * @object: This is the object which is cast to a struct scic_sds_port object.
2260 * This method will perform the actions required by the struct scic_sds_port on
2261 * entering the SCI_BASE_PORT_STATE_READY. This function sets the ready state
2262 * handlers for the struct scic_sds_port object, reports the port object as
2263 * not ready and starts the ready substate machine. none
2265 static void scic_sds_port_ready_state_enter(void *object)
2267 struct scic_sds_port *sci_port = object;
2268 struct scic_sds_controller *scic = sci_port->owning_controller;
2269 struct isci_host *ihost = scic_to_ihost(scic);
2270 struct isci_port *iport = sci_port_to_iport(sci_port);
2273 /* Put the ready state handlers in place though they will not be there long */
2274 scic_sds_port_set_base_state_handlers(sci_port, SCI_BASE_PORT_STATE_READY);
2276 prev_state = sci_port->state_machine.previous_state_id;
2277 if (prev_state == SCI_BASE_PORT_STATE_RESETTING)
2278 isci_port_hard_reset_complete(iport, SCI_SUCCESS);
2280 isci_port_not_ready(ihost, iport);
2282 /* Post and suspend the dummy remote node context for this port. */
2283 scic_sds_port_post_dummy_remote_node(sci_port);
2285 /* Start the ready substate machine */
2286 port_state_machine_change(sci_port,
2287 SCIC_SDS_PORT_READY_SUBSTATE_WAITING);
2292 * @object: This is the object which is cast to a struct scic_sds_port object.
2294 * This method will perform the actions required by the struct scic_sds_port on
2295 * entering the SCI_BASE_PORT_STATE_RESETTING. This function sets the resetting
2296 * state handlers for the struct scic_sds_port object. none
2298 static void scic_sds_port_resetting_state_enter(void *object)
2300 struct scic_sds_port *sci_port = object;
2302 scic_sds_port_set_base_state_handlers(
2303 sci_port, SCI_BASE_PORT_STATE_RESETTING
2309 * @object: This is the object which is cast to a struct scic_sds_port object.
2311 * This function will perform the actions required by the
2312 * struct scic_sds_port on
2313 * exiting the SCI_BASE_STATE_RESETTING. This function does nothing. none
2315 static inline void scic_sds_port_resetting_state_exit(void *object)
2317 struct scic_sds_port *sci_port = object;
2319 isci_timer_stop(sci_port->timer_handle);
2324 * @object: This is the void object which is cast to a
2325 * struct scic_sds_port object.
2327 * This method will perform the actions required by the struct scic_sds_port on
2328 * entering the SCI_BASE_PORT_STATE_STOPPING. This function sets the stopping
2329 * state handlers for the struct scic_sds_port object. none
2331 static void scic_sds_port_stopping_state_enter(void *object)
2333 struct scic_sds_port *sci_port = object;
2335 scic_sds_port_set_base_state_handlers(
2336 sci_port, SCI_BASE_PORT_STATE_STOPPING
2342 * @object: This is the object which is cast to a struct scic_sds_port object.
2344 * This function will perform the actions required by the
2345 * struct scic_sds_port on
2346 * exiting the SCI_BASE_STATE_STOPPING. This function does nothing. none
2349 scic_sds_port_stopping_state_exit(void *object)
2351 struct scic_sds_port *sci_port = object;
2353 isci_timer_stop(sci_port->timer_handle);
2355 scic_sds_port_destroy_dummy_resources(sci_port);
2360 * @object: This is the object which is cast to a struct scic_sds_port object.
2362 * This function will perform the actions required by the
2363 * struct scic_sds_port on
2364 * entering the SCI_BASE_PORT_STATE_STOPPING. This function sets the stopping
2365 * state handlers for the struct scic_sds_port object. none
2367 static void scic_sds_port_failed_state_enter(void *object)
2369 struct scic_sds_port *sci_port = object;
2370 struct isci_port *iport = sci_port_to_iport(sci_port);
2372 scic_sds_port_set_base_state_handlers(sci_port,
2373 SCI_BASE_PORT_STATE_FAILED);
2375 isci_port_hard_reset_complete(iport, SCI_FAILURE_TIMEOUT);
2378 /* --------------------------------------------------------------------------- */
2380 static const struct sci_base_state scic_sds_port_state_table[] = {
2381 [SCI_BASE_PORT_STATE_STOPPED] = {
2382 .enter_state = scic_sds_port_stopped_state_enter,
2383 .exit_state = scic_sds_port_stopped_state_exit
2385 [SCI_BASE_PORT_STATE_STOPPING] = {
2386 .enter_state = scic_sds_port_stopping_state_enter,
2387 .exit_state = scic_sds_port_stopping_state_exit
2389 [SCI_BASE_PORT_STATE_READY] = {
2390 .enter_state = scic_sds_port_ready_state_enter,
2392 [SCIC_SDS_PORT_READY_SUBSTATE_WAITING] = {
2393 .enter_state = scic_sds_port_ready_substate_waiting_enter,
2395 [SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL] = {
2396 .enter_state = scic_sds_port_ready_substate_operational_enter,
2397 .exit_state = scic_sds_port_ready_substate_operational_exit
2399 [SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING] = {
2400 .enter_state = scic_sds_port_ready_substate_configuring_enter,
2401 .exit_state = scic_sds_port_ready_substate_configuring_exit
2403 [SCI_BASE_PORT_STATE_RESETTING] = {
2404 .enter_state = scic_sds_port_resetting_state_enter,
2405 .exit_state = scic_sds_port_resetting_state_exit
2407 [SCI_BASE_PORT_STATE_FAILED] = {
2408 .enter_state = scic_sds_port_failed_state_enter,
2412 void scic_sds_port_construct(struct scic_sds_port *sci_port, u8 index,
2413 struct scic_sds_controller *scic)
2415 sci_base_state_machine_construct(&sci_port->state_machine,
2417 scic_sds_port_state_table,
2418 SCI_BASE_PORT_STATE_STOPPED);
2420 sci_base_state_machine_start(&sci_port->state_machine);
2422 sci_port->logical_port_index = SCIC_SDS_DUMMY_PORT;
2423 sci_port->physical_port_index = index;
2424 sci_port->active_phy_mask = 0;
2425 sci_port->ready_exit = false;
2427 sci_port->owning_controller = scic;
2429 sci_port->started_request_count = 0;
2430 sci_port->assigned_device_count = 0;
2432 sci_port->reserved_rni = SCU_DUMMY_INDEX;
2433 sci_port->reserved_tci = SCU_DUMMY_INDEX;
2435 sci_port->timer_handle = NULL;
2436 sci_port->port_task_scheduler_registers = NULL;
2438 for (index = 0; index < SCI_MAX_PHYS; index++)
2439 sci_port->phy_table[index] = NULL;
2442 void isci_port_init(struct isci_port *iport, struct isci_host *ihost, int index)
2444 INIT_LIST_HEAD(&iport->remote_dev_list);
2445 INIT_LIST_HEAD(&iport->domain_dev_list);
2446 spin_lock_init(&iport->state_lock);
2447 init_completion(&iport->start_complete);
2448 iport->isci_host = ihost;
2449 isci_port_change_state(iport, isci_freed);
2453 * isci_port_get_state() - This function gets the status of the port object.
2454 * @isci_port: This parameter points to the isci_port object
2456 * status of the object as a isci_status enum.
2458 enum isci_status isci_port_get_state(
2459 struct isci_port *isci_port)
2461 return isci_port->status;
2464 static void isci_port_bc_change_received(struct isci_host *ihost,
2465 struct scic_sds_port *sci_port,
2466 struct scic_sds_phy *sci_phy)
2468 struct isci_phy *iphy = sci_phy_to_iphy(sci_phy);
2470 dev_dbg(&ihost->pdev->dev, "%s: iphy = %p, sas_phy = %p\n",
2471 __func__, iphy, &iphy->sas_phy);
2473 ihost->sas_ha.notify_port_event(&iphy->sas_phy, PORTE_BROADCAST_RCVD);
2474 scic_port_enable_broadcast_change_notification(sci_port);
2477 void scic_sds_port_broadcast_change_received(
2478 struct scic_sds_port *sci_port,
2479 struct scic_sds_phy *sci_phy)
2481 struct scic_sds_controller *scic = sci_port->owning_controller;
2482 struct isci_host *ihost = scic_to_ihost(scic);
2484 /* notify the user. */
2485 isci_port_bc_change_received(ihost, sci_port, sci_phy);
2488 int isci_port_perform_hard_reset(struct isci_host *ihost, struct isci_port *iport,
2489 struct isci_phy *iphy)
2491 unsigned long flags;
2492 enum sci_status status;
2493 int ret = TMF_RESP_FUNC_COMPLETE;
2495 dev_dbg(&ihost->pdev->dev, "%s: iport = %p\n",
2498 init_completion(&iport->hard_reset_complete);
2500 spin_lock_irqsave(&ihost->scic_lock, flags);
2502 #define ISCI_PORT_RESET_TIMEOUT SCIC_SDS_SIGNATURE_FIS_TIMEOUT
2503 status = scic_port_hard_reset(&iport->sci, ISCI_PORT_RESET_TIMEOUT);
2505 spin_unlock_irqrestore(&ihost->scic_lock, flags);
2507 if (status == SCI_SUCCESS) {
2508 wait_for_completion(&iport->hard_reset_complete);
2510 dev_dbg(&ihost->pdev->dev,
2511 "%s: iport = %p; hard reset completion\n",
2514 if (iport->hard_reset_status != SCI_SUCCESS)
2515 ret = TMF_RESP_FUNC_FAILED;
2517 ret = TMF_RESP_FUNC_FAILED;
2519 dev_err(&ihost->pdev->dev,
2520 "%s: iport = %p; scic_port_hard_reset call"
2522 __func__, iport, status);
2526 /* If the hard reset for the port has failed, consider this
2527 * the same as link failures on all phys in the port.
2529 if (ret != TMF_RESP_FUNC_COMPLETE) {
2530 dev_err(&ihost->pdev->dev,
2531 "%s: iport = %p; hard reset failed "
2532 "(0x%x) - sending link down to libsas for phy %p\n",
2533 __func__, iport, iport->hard_reset_status, iphy);
2535 isci_port_link_down(ihost, iphy, iport);
2542 * isci_port_deformed() - This function is called by libsas when a port becomes
2544 * @phy: This parameter specifies the libsas phy with the inactive port.
2547 void isci_port_deformed(struct asd_sas_phy *phy)
2549 pr_debug("%s: sas_phy = %p\n", __func__, phy);
2553 * isci_port_formed() - This function is called by libsas when a port becomes
2555 * @phy: This parameter specifies the libsas phy with the active port.
2558 void isci_port_formed(struct asd_sas_phy *phy)
2560 pr_debug("%s: sas_phy = %p, sas_port = %p\n", __func__, phy, phy->port);