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;
888 static void port_state_machine_stop(struct scic_sds_port
*sci_port
)
890 sci_port
->ready_exit
= true;
891 sci_base_state_machine_stop(&sci_port
->state_machine
);
892 sci_port
->ready_exit
= false;
896 * scic_sds_port_general_link_up_handler - phy can be assigned to port?
897 * @sci_port: scic_sds_port object for which has a phy that has gone link up.
898 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
899 * @do_notify_user: This parameter specifies whether to inform the user (via
900 * scic_cb_port_link_up()) as to the fact that a new phy as become ready.
902 * Determine if this phy can be assigned to this
903 * port . If the phy is not a valid PHY for
904 * this port then the function will notify the user. A PHY can only be
905 * part of a port if it's attached SAS ADDRESS is the same as all other PHYs in
906 * the same port. none
908 static void scic_sds_port_general_link_up_handler(struct scic_sds_port
*sci_port
,
909 struct scic_sds_phy
*sci_phy
,
912 struct sci_sas_address port_sas_address
;
913 struct sci_sas_address phy_sas_address
;
915 scic_sds_port_get_attached_sas_address(sci_port
, &port_sas_address
);
916 scic_sds_phy_get_attached_sas_address(sci_phy
, &phy_sas_address
);
918 /* If the SAS address of the new phy matches the SAS address of
919 * other phys in the port OR this is the first phy in the port,
920 * then activate the phy and allow it to be used for operations
923 if ((phy_sas_address
.high
== port_sas_address
.high
&&
924 phy_sas_address
.low
== port_sas_address
.low
) ||
925 sci_port
->active_phy_mask
== 0) {
926 struct sci_base_state_machine
*sm
= &sci_port
->state_machine
;
928 scic_sds_port_activate_phy(sci_port
, sci_phy
, do_notify_user
);
929 if (sm
->current_state_id
== SCI_BASE_PORT_STATE_RESETTING
)
930 port_state_machine_change(sci_port
, SCI_BASE_PORT_STATE_READY
);
932 scic_sds_port_invalid_link_up(sci_port
, sci_phy
);
938 * This method returns false if the port only has a single phy object assigned.
939 * If there are no phys or more than one phy then the method will return
941 * @sci_port: The port for which the wide port condition is to be checked.
943 * bool true Is returned if this is a wide ported port. false Is returned if
944 * this is a narrow port.
946 static bool scic_sds_port_is_wide(struct scic_sds_port
*sci_port
)
951 for (index
= 0; index
< SCI_MAX_PHYS
; index
++) {
952 if (sci_port
->phy_table
[index
] != NULL
) {
957 return phy_count
!= 1;
961 * This method is called by the PHY object when the link is detected. if the
962 * port wants the PHY to continue on to the link up state then the port
963 * layer must return true. If the port object returns false the phy object
964 * must halt its attempt to go link up.
965 * @sci_port: The port associated with the phy object.
966 * @sci_phy: The phy object that is trying to go link up.
968 * true if the phy object can continue to the link up condition. true Is
969 * returned if this phy can continue to the ready state. false Is returned if
970 * can not continue on to the ready state. This notification is in place for
971 * wide ports and direct attached phys. Since there are no wide ported SATA
972 * devices this could become an invalid port configuration.
974 bool scic_sds_port_link_detected(
975 struct scic_sds_port
*sci_port
,
976 struct scic_sds_phy
*sci_phy
)
978 if ((sci_port
->logical_port_index
!= SCIC_SDS_DUMMY_PORT
) &&
979 (sci_phy
->protocol
== SCIC_SDS_PHY_PROTOCOL_SATA
) &&
980 scic_sds_port_is_wide(sci_port
)) {
981 scic_sds_port_invalid_link_up(sci_port
, sci_phy
);
990 * This method is the entry point for the phy to inform the port that it is now
996 void scic_sds_port_link_up(
997 struct scic_sds_port
*sci_port
,
998 struct scic_sds_phy
*sci_phy
)
1000 sci_phy
->is_in_link_training
= false;
1002 sci_port
->state_handlers
->link_up_handler(sci_port
, sci_phy
);
1006 * This method is the entry point for the phy to inform the port that it is no
1007 * longer in a ready state
1012 void scic_sds_port_link_down(
1013 struct scic_sds_port
*sci_port
,
1014 struct scic_sds_phy
*sci_phy
)
1016 sci_port
->state_handlers
->link_down_handler(sci_port
, sci_phy
);
1020 * This method is called to start an IO request on this port.
1027 enum sci_status
scic_sds_port_start_io(
1028 struct scic_sds_port
*sci_port
,
1029 struct scic_sds_remote_device
*sci_dev
,
1030 struct scic_sds_request
*sci_req
)
1032 return sci_port
->state_handlers
->start_io_handler(
1033 sci_port
, sci_dev
, sci_req
);
1037 * This method is called to complete an IO request to the port.
1044 enum sci_status
scic_sds_port_complete_io(
1045 struct scic_sds_port
*sci_port
,
1046 struct scic_sds_remote_device
*sci_dev
,
1047 struct scic_sds_request
*sci_req
)
1049 return sci_port
->state_handlers
->complete_io_handler(
1050 sci_port
, sci_dev
, sci_req
);
1054 * This method is provided to timeout requests for port operations. Mostly its
1055 * for the port reset operation.
1059 static void scic_sds_port_timeout_handler(void *port
)
1061 struct scic_sds_port
*sci_port
= port
;
1064 current_state
= sci_base_state_machine_get_state(&sci_port
->state_machine
);
1066 if (current_state
== SCI_BASE_PORT_STATE_RESETTING
) {
1067 /* if the port is still in the resetting state then the timeout
1068 * fired before the reset completed.
1070 port_state_machine_change(sci_port
, SCI_BASE_PORT_STATE_FAILED
);
1071 } else if (current_state
== SCI_BASE_PORT_STATE_STOPPED
) {
1072 /* if the port is stopped then the start request failed In this
1073 * case stay in the stopped state.
1075 dev_err(sciport_to_dev(sci_port
),
1076 "%s: SCIC Port 0x%p failed to stop before tiemout.\n",
1079 } else if (current_state
== SCI_BASE_PORT_STATE_STOPPING
) {
1080 /* if the port is still stopping then the stop has not completed */
1081 isci_port_stop_complete(sci_port
->owning_controller
,
1083 SCI_FAILURE_TIMEOUT
);
1085 /* The port is in the ready state and we have a timer
1086 * reporting a timeout this should not happen.
1088 dev_err(sciport_to_dev(sci_port
),
1089 "%s: SCIC Port 0x%p is processing a timeout operation "
1090 "in state %d.\n", __func__
, sci_port
, current_state
);
1094 /* --------------------------------------------------------------------------- */
1097 * This function updates the hardwares VIIT entry for this port.
1101 static void scic_sds_port_update_viit_entry(struct scic_sds_port
*sci_port
)
1103 struct sci_sas_address sas_address
;
1105 scic_sds_port_get_sas_address(sci_port
, &sas_address
);
1107 writel(sas_address
.high
,
1108 &sci_port
->viit_registers
->initiator_sas_address_hi
);
1109 writel(sas_address
.low
,
1110 &sci_port
->viit_registers
->initiator_sas_address_lo
);
1112 /* This value get cleared just in case its not already cleared */
1113 writel(0, &sci_port
->viit_registers
->reserved
);
1115 /* We are required to update the status register last */
1116 writel(SCU_VIIT_ENTRY_ID_VIIT
|
1117 SCU_VIIT_IPPT_INITIATOR
|
1118 ((1 << sci_port
->physical_port_index
) << SCU_VIIT_ENTRY_LPVIE_SHIFT
) |
1119 SCU_VIIT_STATUS_ALL_VALID
,
1120 &sci_port
->viit_registers
->status
);
1124 * This method returns the maximum allowed speed for data transfers on this
1125 * port. This maximum allowed speed evaluates to the maximum speed of the
1126 * slowest phy in the port.
1127 * @sci_port: This parameter specifies the port for which to retrieve the
1128 * maximum allowed speed.
1130 * This method returns the maximum negotiated speed of the slowest phy in the
1133 enum sas_linkrate
scic_sds_port_get_max_allowed_speed(
1134 struct scic_sds_port
*sci_port
)
1137 enum sas_linkrate max_allowed_speed
= SAS_LINK_RATE_6_0_GBPS
;
1138 struct scic_sds_phy
*phy
= NULL
;
1141 * Loop through all of the phys in this port and find the phy with the
1142 * lowest maximum link rate. */
1143 for (index
= 0; index
< SCI_MAX_PHYS
; index
++) {
1144 phy
= sci_port
->phy_table
[index
];
1147 && (scic_sds_port_active_phy(sci_port
, phy
) == true)
1148 && (phy
->max_negotiated_speed
< max_allowed_speed
)
1150 max_allowed_speed
= phy
->max_negotiated_speed
;
1153 return max_allowed_speed
;
1156 static void scic_port_enable_broadcast_change_notification(struct scic_sds_port
*port
)
1158 struct scic_sds_phy
*phy
;
1162 /* Loop through all of the phys to enable BCN. */
1163 for (index
= 0; index
< SCI_MAX_PHYS
; index
++) {
1164 phy
= port
->phy_table
[index
];
1167 readl(&phy
->link_layer_registers
->link_layer_control
);
1169 /* clear the bit by writing 1. */
1170 writel(register_value
,
1171 &phy
->link_layer_registers
->link_layer_control
);
1177 * ****************************************************************************
1178 * * READY SUBSTATE HANDLERS
1179 * **************************************************************************** */
1182 * This method is the general ready substate complete io handler for the
1183 * struct scic_sds_port object. This function decrments the outstanding request count
1184 * for this port object. enum sci_status SCI_SUCCESS
1186 static enum sci_status
scic_sds_port_ready_substate_complete_io_handler(
1187 struct scic_sds_port
*port
,
1188 struct scic_sds_remote_device
*device
,
1189 struct scic_sds_request
*io_request
)
1191 scic_sds_port_decrement_request_count(port
);
1196 static enum sci_status
scic_sds_port_ready_substate_add_phy_handler(struct scic_sds_port
*sci_port
,
1197 struct scic_sds_phy
*sci_phy
)
1199 enum sci_status status
;
1201 status
= scic_sds_port_set_phy(sci_port
, sci_phy
);
1203 if (status
!= SCI_SUCCESS
)
1206 scic_sds_port_general_link_up_handler(sci_port
, sci_phy
, true);
1207 sci_port
->not_ready_reason
= SCIC_PORT_NOT_READY_RECONFIGURING
;
1208 port_state_machine_change(sci_port
, SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
);
1214 static enum sci_status
scic_sds_port_ready_substate_remove_phy_handler(struct scic_sds_port
*port
,
1215 struct scic_sds_phy
*phy
)
1217 enum sci_status status
;
1219 status
= scic_sds_port_clear_phy(port
, phy
);
1221 if (status
!= SCI_SUCCESS
)
1224 scic_sds_port_deactivate_phy(port
, phy
, true);
1226 port
->not_ready_reason
= SCIC_PORT_NOT_READY_RECONFIGURING
;
1228 port_state_machine_change(port
,
1229 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
);
1234 * ****************************************************************************
1235 * * READY SUBSTATE WAITING HANDLERS
1236 * **************************************************************************** */
1240 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1242 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
1244 * This method is the ready waiting substate link up handler for the
1245 * struct scic_sds_port object. This methos will report the link up condition for
1246 * this port and will transition to the ready operational substate. none
1248 static void scic_sds_port_ready_waiting_substate_link_up_handler(
1249 struct scic_sds_port
*sci_port
,
1250 struct scic_sds_phy
*sci_phy
)
1253 * Since this is the first phy going link up for the port we can just enable
1254 * it and continue. */
1255 scic_sds_port_activate_phy(sci_port
, sci_phy
, true);
1257 port_state_machine_change(sci_port
,
1258 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
);
1262 * This method is the ready waiting substate start io handler for the
1263 * struct scic_sds_port object. The port object can not accept new requests so the
1264 * request is failed. enum sci_status SCI_FAILURE_INVALID_STATE
1266 static enum sci_status
scic_sds_port_ready_waiting_substate_start_io_handler(
1267 struct scic_sds_port
*port
,
1268 struct scic_sds_remote_device
*device
,
1269 struct scic_sds_request
*io_request
)
1271 return SCI_FAILURE_INVALID_STATE
;
1275 * ****************************************************************************
1276 * * READY SUBSTATE OPERATIONAL HANDLERS
1277 * **************************************************************************** */
1280 * This method will casue the port to reset. enum sci_status SCI_SUCCESS
1283 sci_status
scic_sds_port_ready_operational_substate_reset_handler(
1284 struct scic_sds_port
*port
,
1287 enum sci_status status
= SCI_FAILURE_INVALID_PHY
;
1289 struct scic_sds_phy
*selected_phy
= NULL
;
1292 /* Select a phy on which we can send the hard reset request. */
1294 (phy_index
< SCI_MAX_PHYS
) && (selected_phy
== NULL
);
1296 selected_phy
= port
->phy_table
[phy_index
];
1298 if ((selected_phy
!= NULL
) &&
1299 !scic_sds_port_active_phy(port
, selected_phy
)) {
1301 * We found a phy but it is not ready select
1304 selected_phy
= NULL
;
1308 /* If we have a phy then go ahead and start the reset procedure */
1309 if (selected_phy
!= NULL
) {
1310 status
= scic_sds_phy_reset(selected_phy
);
1312 if (status
== SCI_SUCCESS
) {
1313 isci_timer_start(port
->timer_handle
, timeout
);
1314 port
->not_ready_reason
=
1315 SCIC_PORT_NOT_READY_HARD_RESET_REQUESTED
;
1317 port_state_machine_change(port
,
1318 SCI_BASE_PORT_STATE_RESETTING
);
1326 * scic_sds_port_ready_operational_substate_link_up_handler() -
1327 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1329 * @sci_phy: This is the struct scic_sds_phy object that has gone link up.
1331 * This method is the ready operational substate link up handler for the
1332 * struct scic_sds_port object. This function notifies the SCI User that the phy has
1333 * gone link up. none
1335 static void scic_sds_port_ready_operational_substate_link_up_handler(
1336 struct scic_sds_port
*sci_port
,
1337 struct scic_sds_phy
*sci_phy
)
1339 scic_sds_port_general_link_up_handler(sci_port
, sci_phy
, true);
1343 * scic_sds_port_ready_operational_substate_link_down_handler() -
1344 * @sci_port: This is the struct scic_sds_port object that which has a phy that has
1346 * @sci_phy: This is the struct scic_sds_phy object that has gone link down.
1348 * This method is the ready operational substate link down handler for the
1349 * struct scic_sds_port object. This function notifies the SCI User that the phy has
1350 * gone link down and if this is the last phy in the port the port will change
1351 * state to the ready waiting substate. none
1353 static void scic_sds_port_ready_operational_substate_link_down_handler(
1354 struct scic_sds_port
*sci_port
,
1355 struct scic_sds_phy
*sci_phy
)
1357 scic_sds_port_deactivate_phy(sci_port
, sci_phy
, true);
1360 * If there are no active phys left in the port, then transition
1361 * the port to the WAITING state until such time as a phy goes
1363 if (sci_port
->active_phy_mask
== 0)
1364 port_state_machine_change(sci_port
,
1365 SCIC_SDS_PORT_READY_SUBSTATE_WAITING
);
1369 * This method is the ready operational substate start io handler for the
1370 * struct scic_sds_port object. This function incremetns the outstanding request
1371 * count for this port object. enum sci_status SCI_SUCCESS
1373 static enum sci_status
scic_sds_port_ready_operational_substate_start_io_handler(
1374 struct scic_sds_port
*port
,
1375 struct scic_sds_remote_device
*device
,
1376 struct scic_sds_request
*io_request
)
1378 port
->started_request_count
++;
1383 * ****************************************************************************
1384 * * READY SUBSTATE OPERATIONAL HANDLERS
1385 * **************************************************************************** */
1388 * This is the default method for a port add phy request. It will report a
1389 * warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE
1391 static enum sci_status
scic_sds_port_ready_configuring_substate_add_phy_handler(
1392 struct scic_sds_port
*port
,
1393 struct scic_sds_phy
*phy
)
1395 enum sci_status status
;
1397 status
= scic_sds_port_set_phy(port
, phy
);
1399 if (status
== SCI_SUCCESS
) {
1400 scic_sds_port_general_link_up_handler(port
, phy
, true);
1403 * Re-enter the configuring state since this may be the last phy in
1405 port_state_machine_change(port
,
1406 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
);
1413 * This is the default method for a port remove phy request. It will report a
1414 * warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE
1416 static enum sci_status
scic_sds_port_ready_configuring_substate_remove_phy_handler(
1417 struct scic_sds_port
*port
,
1418 struct scic_sds_phy
*phy
)
1420 enum sci_status status
;
1422 status
= scic_sds_port_clear_phy(port
, phy
);
1424 if (status
!= SCI_SUCCESS
)
1426 scic_sds_port_deactivate_phy(port
, phy
, true);
1428 /* Re-enter the configuring state since this may be the last phy in
1431 port_state_machine_change(port
,
1432 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
);
1438 * scic_sds_port_ready_configuring_substate_complete_io_handler() -
1439 * @port: This is the port that is being requested to complete the io request.
1440 * @device: This is the device on which the io is completing.
1442 * This method will decrement the outstanding request count for this port. If
1443 * the request count goes to 0 then the port can be reprogrammed with its new
1446 static enum sci_status
1447 scic_sds_port_ready_configuring_substate_complete_io_handler(
1448 struct scic_sds_port
*port
,
1449 struct scic_sds_remote_device
*device
,
1450 struct scic_sds_request
*io_request
)
1452 scic_sds_port_decrement_request_count(port
);
1454 if (port
->started_request_count
== 0) {
1455 port_state_machine_change(port
,
1456 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
);
1462 static enum sci_status
default_port_handler(struct scic_sds_port
*sci_port
,
1465 dev_warn(sciport_to_dev(sci_port
),
1466 "%s: in wrong state: %d\n", func
,
1467 sci_base_state_machine_get_state(&sci_port
->state_machine
));
1468 return SCI_FAILURE_INVALID_STATE
;
1471 static enum sci_status
1472 scic_sds_port_default_destruct_handler(struct scic_sds_port
*sci_port
)
1474 return default_port_handler(sci_port
, __func__
);
1477 static enum sci_status
1478 scic_sds_port_default_reset_handler(struct scic_sds_port
*sci_port
,
1481 return default_port_handler(sci_port
, __func__
);
1484 static enum sci_status
1485 scic_sds_port_default_add_phy_handler(struct scic_sds_port
*sci_port
,
1486 struct scic_sds_phy
*base_phy
)
1488 return default_port_handler(sci_port
, __func__
);
1491 static enum sci_status
1492 scic_sds_port_default_remove_phy_handler(struct scic_sds_port
*sci_port
,
1493 struct scic_sds_phy
*base_phy
)
1495 return default_port_handler(sci_port
, __func__
);
1499 * This is the default method for a port unsolicited frame request. It will
1500 * report a warning and exit. enum sci_status SCI_FAILURE_INVALID_STATE Is it even
1501 * possible to receive an unsolicited frame directed to a port object? It
1502 * seems possible if we implementing virtual functions but until then?
1504 static enum sci_status
1505 scic_sds_port_default_frame_handler(struct scic_sds_port
*sci_port
,
1508 struct scic_sds_controller
*scic
= scic_sds_port_get_controller(sci_port
);
1510 default_port_handler(sci_port
, __func__
);
1511 scic_sds_controller_release_frame(scic
, frame_index
);
1513 return SCI_FAILURE_INVALID_STATE
;
1516 static enum sci_status
scic_sds_port_default_event_handler(struct scic_sds_port
*sci_port
,
1519 return default_port_handler(sci_port
, __func__
);
1522 static void scic_sds_port_default_link_up_handler(struct scic_sds_port
*sci_port
,
1523 struct scic_sds_phy
*sci_phy
)
1525 default_port_handler(sci_port
, __func__
);
1528 static void scic_sds_port_default_link_down_handler(struct scic_sds_port
*sci_port
,
1529 struct scic_sds_phy
*sci_phy
)
1531 default_port_handler(sci_port
, __func__
);
1534 static enum sci_status
scic_sds_port_default_start_io_handler(struct scic_sds_port
*sci_port
,
1535 struct scic_sds_remote_device
*sci_dev
,
1536 struct scic_sds_request
*sci_req
)
1538 return default_port_handler(sci_port
, __func__
);
1541 static enum sci_status
scic_sds_port_default_complete_io_handler(struct scic_sds_port
*sci_port
,
1542 struct scic_sds_remote_device
*sci_dev
,
1543 struct scic_sds_request
*sci_req
)
1545 return default_port_handler(sci_port
, __func__
);
1549 * ******************************************************************************
1550 * * PORT STATE PRIVATE METHODS
1551 * ****************************************************************************** */
1555 * @sci_port: This is the struct scic_sds_port object to suspend.
1557 * This method will susped the port task scheduler for this port object. none
1560 scic_sds_port_suspend_port_task_scheduler(struct scic_sds_port
*port
)
1562 u32 pts_control_value
;
1564 pts_control_value
= readl(&port
->port_task_scheduler_registers
->control
);
1565 pts_control_value
|= SCU_PTSxCR_GEN_BIT(SUSPEND
);
1566 writel(pts_control_value
, &port
->port_task_scheduler_registers
->control
);
1570 * scic_sds_port_post_dummy_request() - post dummy/workaround request
1571 * @sci_port: port to post task
1573 * Prevent the hardware scheduler from posting new requests to the front
1574 * of the scheduler queue causing a starvation problem for currently
1578 static void scic_sds_port_post_dummy_request(struct scic_sds_port
*sci_port
)
1581 struct scu_task_context
*task_context
;
1582 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1583 u16 tci
= sci_port
->reserved_tci
;
1585 task_context
= scic_sds_controller_get_task_context_buffer(scic
, tci
);
1587 task_context
->abort
= 0;
1589 command
= SCU_CONTEXT_COMMAND_REQUEST_TYPE_POST_TC
|
1590 sci_port
->physical_port_index
<< SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT
|
1593 scic_sds_controller_post_request(scic
, command
);
1597 * This routine will abort the dummy request. This will alow the hardware to
1598 * power down parts of the silicon to save power.
1600 * @sci_port: The port on which the task must be aborted.
1603 static void scic_sds_port_abort_dummy_request(struct scic_sds_port
*sci_port
)
1605 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1606 u16 tci
= sci_port
->reserved_tci
;
1607 struct scu_task_context
*tc
;
1610 tc
= scic_sds_controller_get_task_context_buffer(scic
, tci
);
1614 command
= SCU_CONTEXT_COMMAND_REQUEST_POST_TC_ABORT
|
1615 sci_port
->physical_port_index
<< SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT
|
1618 scic_sds_controller_post_request(scic
, command
);
1623 * @sci_port: This is the struct scic_sds_port object to resume.
1625 * This method will resume the port task scheduler for this port object. none
1628 scic_sds_port_resume_port_task_scheduler(struct scic_sds_port
*port
)
1630 u32 pts_control_value
;
1632 pts_control_value
= readl(&port
->port_task_scheduler_registers
->control
);
1633 pts_control_value
&= ~SCU_PTSxCR_GEN_BIT(SUSPEND
);
1634 writel(pts_control_value
, &port
->port_task_scheduler_registers
->control
);
1638 * ******************************************************************************
1639 * * PORT READY SUBSTATE METHODS
1640 * ****************************************************************************** */
1644 * @object: This is the object which is cast to a struct scic_sds_port object.
1646 * This method will perform the actions required by the struct scic_sds_port on
1647 * entering the SCIC_SDS_PORT_READY_SUBSTATE_WAITING. This function checks the
1648 * port for any ready phys. If there is at least one phy in a ready state then
1649 * the port transitions to the ready operational substate. none
1651 static void scic_sds_port_ready_substate_waiting_enter(void *object
)
1653 struct scic_sds_port
*sci_port
= object
;
1655 scic_sds_port_set_base_state_handlers(
1656 sci_port
, SCIC_SDS_PORT_READY_SUBSTATE_WAITING
1659 scic_sds_port_suspend_port_task_scheduler(sci_port
);
1661 sci_port
->not_ready_reason
= SCIC_PORT_NOT_READY_NO_ACTIVE_PHYS
;
1663 if (sci_port
->active_phy_mask
!= 0) {
1664 /* At least one of the phys on the port is ready */
1665 port_state_machine_change(sci_port
,
1666 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
);
1672 * @object: This is the object which is cast to a struct scic_sds_port object.
1674 * This function will perform the actions required by the struct scic_sds_port
1675 * on entering the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function sets
1676 * the state handlers for the port object, notifies the SCI User that the port
1677 * is ready, and resumes port operations. none
1679 static void scic_sds_port_ready_substate_operational_enter(void *object
)
1682 struct scic_sds_port
*sci_port
= object
;
1683 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1684 struct isci_host
*ihost
= scic_to_ihost(scic
);
1685 struct isci_port
*iport
= sci_port_to_iport(sci_port
);
1687 scic_sds_port_set_base_state_handlers(
1689 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
);
1691 isci_port_ready(ihost
, iport
);
1693 for (index
= 0; index
< SCI_MAX_PHYS
; index
++) {
1694 if (sci_port
->phy_table
[index
]) {
1695 writel(sci_port
->physical_port_index
,
1696 &sci_port
->port_pe_configuration_register
[
1697 sci_port
->phy_table
[index
]->phy_index
]);
1701 scic_sds_port_update_viit_entry(sci_port
);
1703 scic_sds_port_resume_port_task_scheduler(sci_port
);
1706 * Post the dummy task for the port so the hardware can schedule
1709 scic_sds_port_post_dummy_request(sci_port
);
1712 static void scic_sds_port_invalidate_dummy_remote_node(struct scic_sds_port
*sci_port
)
1714 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1715 u8 phys_index
= sci_port
->physical_port_index
;
1716 union scu_remote_node_context
*rnc
;
1717 u16 rni
= sci_port
->reserved_rni
;
1720 rnc
= &scic
->remote_node_context_table
[rni
];
1722 rnc
->ssp
.is_valid
= false;
1724 /* ensure the preceding tc abort request has reached the
1725 * controller and give it ample time to act before posting the rnc
1728 readl(&scic
->smu_registers
->interrupt_status
); /* flush */
1731 command
= SCU_CONTEXT_COMMAND_POST_RNC_INVALIDATE
|
1732 phys_index
<< SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT
| rni
;
1734 scic_sds_controller_post_request(scic
, command
);
1739 * @object: This is the object which is cast to a struct scic_sds_port object.
1741 * This method will perform the actions required by the struct scic_sds_port on
1742 * exiting the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function reports
1743 * the port not ready and suspends the port task scheduler. none
1745 static void scic_sds_port_ready_substate_operational_exit(void *object
)
1747 struct scic_sds_port
*sci_port
= object
;
1748 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1749 struct isci_host
*ihost
= scic_to_ihost(scic
);
1750 struct isci_port
*iport
= sci_port_to_iport(sci_port
);
1753 * Kill the dummy task for this port if it has not yet posted
1754 * the hardware will treat this as a NOP and just return abort
1757 scic_sds_port_abort_dummy_request(sci_port
);
1759 isci_port_not_ready(ihost
, iport
);
1761 if (sci_port
->ready_exit
)
1762 scic_sds_port_invalidate_dummy_remote_node(sci_port
);
1766 * ******************************************************************************
1767 * * PORT READY CONFIGURING METHODS
1768 * ****************************************************************************** */
1771 * scic_sds_port_ready_substate_configuring_enter() -
1772 * @object: This is the object which is cast to a struct scic_sds_port object.
1774 * This method will perform the actions required by the struct scic_sds_port on
1775 * exiting the SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL. This function reports
1776 * the port not ready and suspends the port task scheduler. none
1778 static void scic_sds_port_ready_substate_configuring_enter(void *object
)
1780 struct scic_sds_port
*sci_port
= object
;
1781 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1782 struct isci_host
*ihost
= scic_to_ihost(scic
);
1783 struct isci_port
*iport
= sci_port_to_iport(sci_port
);
1785 scic_sds_port_set_base_state_handlers(
1787 SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
);
1789 if (sci_port
->active_phy_mask
== 0) {
1790 isci_port_not_ready(ihost
, iport
);
1792 port_state_machine_change(sci_port
,
1793 SCIC_SDS_PORT_READY_SUBSTATE_WAITING
);
1794 } else if (sci_port
->started_request_count
== 0)
1795 port_state_machine_change(sci_port
,
1796 SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
);
1799 static void scic_sds_port_ready_substate_configuring_exit(void *object
)
1801 struct scic_sds_port
*sci_port
= object
;
1803 scic_sds_port_suspend_port_task_scheduler(sci_port
);
1804 if (sci_port
->ready_exit
)
1805 scic_sds_port_invalidate_dummy_remote_node(sci_port
);
1808 /* --------------------------------------------------------------------------- */
1812 * @port: This is the struct scic_sds_port object on which the io request count will
1814 * @device: This is the struct scic_sds_remote_device object to which the io request
1815 * is being directed. This parameter is not required to complete this
1817 * @io_request: This is the request that is being completed on this port
1818 * object. This parameter is not required to complete this operation.
1820 * This is a general complete io request handler for the struct scic_sds_port object.
1821 * enum sci_status SCI_SUCCESS
1823 static enum sci_status
scic_sds_port_general_complete_io_handler(
1824 struct scic_sds_port
*port
,
1825 struct scic_sds_remote_device
*device
,
1826 struct scic_sds_request
*io_request
)
1828 scic_sds_port_decrement_request_count(port
);
1834 * This method takes the struct scic_sds_port that is in a stopped state and handles
1835 * the destruct request. The stopped state is the only state in which the
1836 * struct scic_sds_port can be destroyed. This function causes the port object to
1837 * transition to the SCI_BASE_PORT_STATE_FINAL. enum sci_status SCI_SUCCESS
1839 static enum sci_status
scic_sds_port_stopped_state_destruct_handler(struct scic_sds_port
*port
)
1841 port_state_machine_stop(port
);
1847 * This method takes the struct scic_sds_port that is in a stopped state and handles
1848 * the add phy request. In MPC mode the only time a phy can be added to a port
1849 * is in the SCI_BASE_PORT_STATE_STOPPED. enum sci_status
1850 * SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION is returned when the phy can not
1851 * be added to the port. SCI_SUCCESS if the phy is added to the port.
1853 static enum sci_status
scic_sds_port_stopped_state_add_phy_handler(
1854 struct scic_sds_port
*port
,
1855 struct scic_sds_phy
*phy
)
1857 struct sci_sas_address port_sas_address
;
1859 /* Read the port assigned SAS Address if there is one */
1860 scic_sds_port_get_sas_address(port
, &port_sas_address
);
1862 if (port_sas_address
.high
!= 0 && port_sas_address
.low
!= 0) {
1863 struct sci_sas_address phy_sas_address
;
1866 * Make sure that the PHY SAS Address matches the SAS Address
1868 scic_sds_phy_get_sas_address(phy
, &phy_sas_address
);
1871 (port_sas_address
.high
!= phy_sas_address
.high
)
1872 || (port_sas_address
.low
!= phy_sas_address
.low
)
1874 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION
;
1878 return scic_sds_port_set_phy(port
, phy
);
1882 * This method takes the struct scic_sds_port that is in a stopped state and handles
1883 * the remove phy request. In MPC mode the only time a phy can be removed from
1884 * a port is in the SCI_BASE_PORT_STATE_STOPPED. enum sci_status
1885 * SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION is returned when the phy can not
1886 * be added to the port. SCI_SUCCESS if the phy is added to the port.
1888 static enum sci_status
scic_sds_port_stopped_state_remove_phy_handler(
1889 struct scic_sds_port
*port
,
1890 struct scic_sds_phy
*phy
)
1892 return scic_sds_port_clear_phy(port
, phy
);
1896 * ****************************************************************************
1897 * * READY STATE HANDLERS
1898 * **************************************************************************** */
1901 * ****************************************************************************
1902 * * RESETTING STATE HANDLERS
1903 * **************************************************************************** */
1906 * ****************************************************************************
1907 * * STOPPING STATE HANDLERS
1908 * **************************************************************************** */
1911 * This method takes the struct scic_sds_port that is in a stopping state and handles
1912 * the complete io request. Should the request count reach 0 then the port
1913 * object will transition to the stopped state. enum sci_status SCI_SUCCESS
1915 static enum sci_status
scic_sds_port_stopping_state_complete_io_handler(
1916 struct scic_sds_port
*sci_port
,
1917 struct scic_sds_remote_device
*device
,
1918 struct scic_sds_request
*io_request
)
1920 scic_sds_port_decrement_request_count(sci_port
);
1922 if (sci_port
->started_request_count
== 0)
1923 port_state_machine_change(sci_port
,
1924 SCI_BASE_PORT_STATE_STOPPED
);
1930 * ****************************************************************************
1931 * * RESETTING STATE HANDLERS
1932 * **************************************************************************** */
1935 * This method will transition a failed port to its ready state. The port
1936 * failed because a hard reset request timed out but at some time later one or
1937 * more phys in the port became ready. enum sci_status SCI_SUCCESS
1939 static void scic_sds_port_reset_state_link_up_handler(
1940 struct scic_sds_port
*port
,
1941 struct scic_sds_phy
*phy
)
1944 * / @todo We should make sure that the phy that has gone link up is the same
1945 * / one on which we sent the reset. It is possible that the phy on
1946 * / which we sent the reset is not the one that has gone link up and we
1947 * / want to make sure that phy being reset comes back. Consider the
1948 * / case where a reset is sent but before the hardware processes the
1949 * / reset it get a link up on the port because of a hot plug event.
1950 * / because of the reset request this phy will go link down almost
1954 * In the resetting state we don't notify the user regarding
1955 * link up and link down notifications. */
1956 scic_sds_port_general_link_up_handler(port
, phy
, false);
1960 * This method process link down notifications that occur during a port reset
1961 * operation. Link downs can occur during the reset operation. enum sci_status
1964 static void scic_sds_port_reset_state_link_down_handler(
1965 struct scic_sds_port
*port
,
1966 struct scic_sds_phy
*phy
)
1969 * In the resetting state we don't notify the user regarding
1970 * link up and link down notifications. */
1971 scic_sds_port_deactivate_phy(port
, phy
, false);
1974 enum sci_status
scic_sds_port_start(struct scic_sds_port
*sci_port
)
1976 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
1977 struct isci_host
*ihost
= scic_to_ihost(scic
);
1978 enum sci_status status
= SCI_SUCCESS
;
1979 enum scic_sds_port_states state
;
1982 state
= sci_port
->state_machine
.current_state_id
;
1983 if (state
!= SCI_BASE_PORT_STATE_STOPPED
) {
1984 dev_warn(sciport_to_dev(sci_port
),
1985 "%s: in wrong state: %d\n", __func__
, state
);
1986 return SCI_FAILURE_INVALID_STATE
;
1989 if (sci_port
->assigned_device_count
> 0) {
1990 /* TODO This is a start failure operation because
1991 * there are still devices assigned to this port.
1992 * There must be no devices assigned to a port on a
1995 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION
;
1998 sci_port
->timer_handle
=
1999 isci_timer_create(ihost
,
2001 scic_sds_port_timeout_handler
);
2003 if (!sci_port
->timer_handle
)
2004 return SCI_FAILURE_INSUFFICIENT_RESOURCES
;
2006 if (sci_port
->reserved_rni
== SCU_DUMMY_INDEX
) {
2007 u16 rni
= scic_sds_remote_node_table_allocate_remote_node(
2008 &scic
->available_remote_nodes
, 1);
2010 if (rni
!= SCU_DUMMY_INDEX
)
2011 scic_sds_port_construct_dummy_rnc(sci_port
, rni
);
2013 status
= SCI_FAILURE_INSUFFICIENT_RESOURCES
;
2014 sci_port
->reserved_rni
= rni
;
2017 if (sci_port
->reserved_tci
== SCU_DUMMY_INDEX
) {
2018 /* Allocate a TCI and remove the sequence nibble */
2019 u16 tci
= scic_controller_allocate_io_tag(scic
);
2021 if (tci
!= SCU_DUMMY_INDEX
)
2022 scic_sds_port_construct_dummy_task(sci_port
, tci
);
2024 status
= SCI_FAILURE_INSUFFICIENT_RESOURCES
;
2025 sci_port
->reserved_tci
= tci
;
2028 if (status
== SCI_SUCCESS
) {
2029 phy_mask
= scic_sds_port_get_phys(sci_port
);
2032 * There are one or more phys assigned to this port. Make sure
2033 * the port's phy mask is in fact legal and supported by the
2036 if (scic_sds_port_is_phy_mask_valid(sci_port
, phy_mask
) == true) {
2037 port_state_machine_change(sci_port
,
2038 SCI_BASE_PORT_STATE_READY
);
2042 status
= SCI_FAILURE
;
2045 if (status
!= SCI_SUCCESS
)
2046 scic_sds_port_destroy_dummy_resources(sci_port
);
2051 enum sci_status
scic_sds_port_stop(struct scic_sds_port
*sci_port
)
2053 enum scic_sds_port_states state
;
2055 state
= sci_port
->state_machine
.current_state_id
;
2057 case SCI_BASE_PORT_STATE_STOPPED
:
2059 case SCIC_SDS_PORT_READY_SUBSTATE_WAITING
:
2060 case SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
:
2061 case SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
:
2062 case SCI_BASE_PORT_STATE_RESETTING
:
2063 port_state_machine_change(sci_port
,
2064 SCI_BASE_PORT_STATE_STOPPING
);
2067 dev_warn(sciport_to_dev(sci_port
),
2068 "%s: in wrong state: %d\n", __func__
, state
);
2069 return SCI_FAILURE_INVALID_STATE
;
2073 static struct scic_sds_port_state_handler scic_sds_port_state_handler_table
[] = {
2074 [SCI_BASE_PORT_STATE_STOPPED
] = {
2075 .destruct_handler
= scic_sds_port_stopped_state_destruct_handler
,
2076 .reset_handler
= scic_sds_port_default_reset_handler
,
2077 .add_phy_handler
= scic_sds_port_stopped_state_add_phy_handler
,
2078 .remove_phy_handler
= scic_sds_port_stopped_state_remove_phy_handler
,
2079 .frame_handler
= scic_sds_port_default_frame_handler
,
2080 .event_handler
= scic_sds_port_default_event_handler
,
2081 .link_up_handler
= scic_sds_port_default_link_up_handler
,
2082 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2083 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2084 .complete_io_handler
= scic_sds_port_default_complete_io_handler
2086 [SCI_BASE_PORT_STATE_STOPPING
] = {
2087 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2088 .reset_handler
= scic_sds_port_default_reset_handler
,
2089 .add_phy_handler
= scic_sds_port_default_add_phy_handler
,
2090 .remove_phy_handler
= scic_sds_port_default_remove_phy_handler
,
2091 .frame_handler
= scic_sds_port_default_frame_handler
,
2092 .event_handler
= scic_sds_port_default_event_handler
,
2093 .link_up_handler
= scic_sds_port_default_link_up_handler
,
2094 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2095 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2096 .complete_io_handler
= scic_sds_port_stopping_state_complete_io_handler
2098 [SCI_BASE_PORT_STATE_READY
] = {
2099 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2100 .reset_handler
= scic_sds_port_default_reset_handler
,
2101 .add_phy_handler
= scic_sds_port_default_add_phy_handler
,
2102 .remove_phy_handler
= scic_sds_port_default_remove_phy_handler
,
2103 .frame_handler
= scic_sds_port_default_frame_handler
,
2104 .event_handler
= scic_sds_port_default_event_handler
,
2105 .link_up_handler
= scic_sds_port_default_link_up_handler
,
2106 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2107 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2108 .complete_io_handler
= scic_sds_port_general_complete_io_handler
2110 [SCIC_SDS_PORT_READY_SUBSTATE_WAITING
] = {
2111 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2112 .reset_handler
= scic_sds_port_default_reset_handler
,
2113 .add_phy_handler
= scic_sds_port_ready_substate_add_phy_handler
,
2114 .remove_phy_handler
= scic_sds_port_default_remove_phy_handler
,
2115 .frame_handler
= scic_sds_port_default_frame_handler
,
2116 .event_handler
= scic_sds_port_default_event_handler
,
2117 .link_up_handler
= scic_sds_port_ready_waiting_substate_link_up_handler
,
2118 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2119 .start_io_handler
= scic_sds_port_ready_waiting_substate_start_io_handler
,
2120 .complete_io_handler
= scic_sds_port_ready_substate_complete_io_handler
,
2122 [SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
] = {
2123 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2124 .reset_handler
= scic_sds_port_ready_operational_substate_reset_handler
,
2125 .add_phy_handler
= scic_sds_port_ready_substate_add_phy_handler
,
2126 .remove_phy_handler
= scic_sds_port_ready_substate_remove_phy_handler
,
2127 .frame_handler
= scic_sds_port_default_frame_handler
,
2128 .event_handler
= scic_sds_port_default_event_handler
,
2129 .link_up_handler
= scic_sds_port_ready_operational_substate_link_up_handler
,
2130 .link_down_handler
= scic_sds_port_ready_operational_substate_link_down_handler
,
2131 .start_io_handler
= scic_sds_port_ready_operational_substate_start_io_handler
,
2132 .complete_io_handler
= scic_sds_port_ready_substate_complete_io_handler
,
2134 [SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
] = {
2135 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2136 .reset_handler
= scic_sds_port_default_reset_handler
,
2137 .add_phy_handler
= scic_sds_port_ready_configuring_substate_add_phy_handler
,
2138 .remove_phy_handler
= scic_sds_port_ready_configuring_substate_remove_phy_handler
,
2139 .frame_handler
= scic_sds_port_default_frame_handler
,
2140 .event_handler
= scic_sds_port_default_event_handler
,
2141 .link_up_handler
= scic_sds_port_default_link_up_handler
,
2142 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2143 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2144 .complete_io_handler
= scic_sds_port_ready_configuring_substate_complete_io_handler
2146 [SCI_BASE_PORT_STATE_RESETTING
] = {
2147 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2148 .reset_handler
= scic_sds_port_default_reset_handler
,
2149 .add_phy_handler
= scic_sds_port_default_add_phy_handler
,
2150 .remove_phy_handler
= scic_sds_port_default_remove_phy_handler
,
2151 .frame_handler
= scic_sds_port_default_frame_handler
,
2152 .event_handler
= scic_sds_port_default_event_handler
,
2153 .link_up_handler
= scic_sds_port_reset_state_link_up_handler
,
2154 .link_down_handler
= scic_sds_port_reset_state_link_down_handler
,
2155 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2156 .complete_io_handler
= scic_sds_port_general_complete_io_handler
2158 [SCI_BASE_PORT_STATE_FAILED
] = {
2159 .destruct_handler
= scic_sds_port_default_destruct_handler
,
2160 .reset_handler
= scic_sds_port_default_reset_handler
,
2161 .add_phy_handler
= scic_sds_port_default_add_phy_handler
,
2162 .remove_phy_handler
= scic_sds_port_default_remove_phy_handler
,
2163 .frame_handler
= scic_sds_port_default_frame_handler
,
2164 .event_handler
= scic_sds_port_default_event_handler
,
2165 .link_up_handler
= scic_sds_port_default_link_up_handler
,
2166 .link_down_handler
= scic_sds_port_default_link_down_handler
,
2167 .start_io_handler
= scic_sds_port_default_start_io_handler
,
2168 .complete_io_handler
= scic_sds_port_general_complete_io_handler
2173 * ******************************************************************************
2174 * * PORT STATE PRIVATE METHODS
2175 * ****************************************************************************** */
2179 * @sci_port: This is the port object which to suspend.
2181 * This method will enable the SCU Port Task Scheduler for this port object but
2182 * will leave the port task scheduler in a suspended state. none
2185 scic_sds_port_enable_port_task_scheduler(struct scic_sds_port
*port
)
2187 u32 pts_control_value
;
2189 pts_control_value
= readl(&port
->port_task_scheduler_registers
->control
);
2190 pts_control_value
|= SCU_PTSxCR_GEN_BIT(ENABLE
) | SCU_PTSxCR_GEN_BIT(SUSPEND
);
2191 writel(pts_control_value
, &port
->port_task_scheduler_registers
->control
);
2196 * @sci_port: This is the port object which to resume.
2198 * This method will disable the SCU port task scheduler for this port object.
2202 scic_sds_port_disable_port_task_scheduler(struct scic_sds_port
*port
)
2204 u32 pts_control_value
;
2206 pts_control_value
= readl(&port
->port_task_scheduler_registers
->control
);
2207 pts_control_value
&=
2208 ~(SCU_PTSxCR_GEN_BIT(ENABLE
) | SCU_PTSxCR_GEN_BIT(SUSPEND
));
2209 writel(pts_control_value
, &port
->port_task_scheduler_registers
->control
);
2212 static void scic_sds_port_post_dummy_remote_node(struct scic_sds_port
*sci_port
)
2214 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
2215 u8 phys_index
= sci_port
->physical_port_index
;
2216 union scu_remote_node_context
*rnc
;
2217 u16 rni
= sci_port
->reserved_rni
;
2220 rnc
= &scic
->remote_node_context_table
[rni
];
2221 rnc
->ssp
.is_valid
= true;
2223 command
= SCU_CONTEXT_COMMAND_POST_RNC_32
|
2224 phys_index
<< SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT
| rni
;
2226 scic_sds_controller_post_request(scic
, command
);
2228 /* ensure hardware has seen the post rnc command and give it
2229 * ample time to act before sending the suspend
2231 readl(&scic
->smu_registers
->interrupt_status
); /* flush */
2234 command
= SCU_CONTEXT_COMMAND_POST_RNC_SUSPEND_TX_RX
|
2235 phys_index
<< SCU_CONTEXT_COMMAND_LOGICAL_PORT_SHIFT
| rni
;
2237 scic_sds_controller_post_request(scic
, command
);
2241 * ******************************************************************************
2242 * * PORT STATE METHODS
2243 * ****************************************************************************** */
2247 * @object: This is the object which is cast to a struct scic_sds_port object.
2249 * This method will perform the actions required by the struct scic_sds_port on
2250 * entering the SCI_BASE_PORT_STATE_STOPPED. This function sets the stopped
2251 * state handlers for the struct scic_sds_port object and disables the port task
2252 * scheduler in the hardware. none
2254 static void scic_sds_port_stopped_state_enter(void *object
)
2256 struct scic_sds_port
*sci_port
= object
;
2258 scic_sds_port_set_base_state_handlers(
2259 sci_port
, SCI_BASE_PORT_STATE_STOPPED
2263 SCI_BASE_PORT_STATE_STOPPING
2264 == sci_port
->state_machine
.previous_state_id
2267 * If we enter this state becasuse of a request to stop
2268 * the port then we want to disable the hardwares port
2269 * task scheduler. */
2270 scic_sds_port_disable_port_task_scheduler(sci_port
);
2276 * @object: This is the object which is cast to a struct scic_sds_port object.
2278 * This method will perform the actions required by the struct scic_sds_port on
2279 * exiting the SCI_BASE_STATE_STOPPED. This function enables the SCU hardware
2280 * port task scheduler. none
2282 static void scic_sds_port_stopped_state_exit(void *object
)
2284 struct scic_sds_port
*sci_port
= object
;
2286 /* Enable and suspend the port task scheduler */
2287 scic_sds_port_enable_port_task_scheduler(sci_port
);
2291 * scic_sds_port_ready_state_enter -
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_READY. This function sets the ready state
2296 * handlers for the struct scic_sds_port object, reports the port object as
2297 * not ready and starts the ready substate machine. none
2299 static void scic_sds_port_ready_state_enter(void *object
)
2301 struct scic_sds_port
*sci_port
= object
;
2302 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
2303 struct isci_host
*ihost
= scic_to_ihost(scic
);
2304 struct isci_port
*iport
= sci_port_to_iport(sci_port
);
2307 /* Put the ready state handlers in place though they will not be there long */
2308 scic_sds_port_set_base_state_handlers(sci_port
, SCI_BASE_PORT_STATE_READY
);
2310 prev_state
= sci_port
->state_machine
.previous_state_id
;
2311 if (prev_state
== SCI_BASE_PORT_STATE_RESETTING
)
2312 isci_port_hard_reset_complete(iport
, SCI_SUCCESS
);
2314 isci_port_not_ready(ihost
, iport
);
2316 /* Post and suspend the dummy remote node context for this port. */
2317 scic_sds_port_post_dummy_remote_node(sci_port
);
2319 /* Start the ready substate machine */
2320 port_state_machine_change(sci_port
,
2321 SCIC_SDS_PORT_READY_SUBSTATE_WAITING
);
2326 * @object: This is the object which is cast to a struct scic_sds_port object.
2328 * This method will perform the actions required by the struct scic_sds_port on
2329 * entering the SCI_BASE_PORT_STATE_RESETTING. This function sets the resetting
2330 * state handlers for the struct scic_sds_port object. none
2332 static void scic_sds_port_resetting_state_enter(void *object
)
2334 struct scic_sds_port
*sci_port
= object
;
2336 scic_sds_port_set_base_state_handlers(
2337 sci_port
, SCI_BASE_PORT_STATE_RESETTING
2343 * @object: This is the object which is cast to a struct scic_sds_port object.
2345 * This function will perform the actions required by the
2346 * struct scic_sds_port on
2347 * exiting the SCI_BASE_STATE_RESETTING. This function does nothing. none
2349 static inline void scic_sds_port_resetting_state_exit(void *object
)
2351 struct scic_sds_port
*sci_port
= object
;
2353 isci_timer_stop(sci_port
->timer_handle
);
2358 * @object: This is the void object which is cast to a
2359 * struct scic_sds_port object.
2361 * This method will perform the actions required by the struct scic_sds_port on
2362 * entering the SCI_BASE_PORT_STATE_STOPPING. This function sets the stopping
2363 * state handlers for the struct scic_sds_port object. none
2365 static void scic_sds_port_stopping_state_enter(void *object
)
2367 struct scic_sds_port
*sci_port
= object
;
2369 scic_sds_port_set_base_state_handlers(
2370 sci_port
, SCI_BASE_PORT_STATE_STOPPING
2376 * @object: This is the object which is cast to a struct scic_sds_port object.
2378 * This function will perform the actions required by the
2379 * struct scic_sds_port on
2380 * exiting the SCI_BASE_STATE_STOPPING. This function does nothing. none
2383 scic_sds_port_stopping_state_exit(void *object
)
2385 struct scic_sds_port
*sci_port
= object
;
2387 isci_timer_stop(sci_port
->timer_handle
);
2389 scic_sds_port_destroy_dummy_resources(sci_port
);
2394 * @object: This is the object which is cast to a struct scic_sds_port object.
2396 * This function will perform the actions required by the
2397 * struct scic_sds_port on
2398 * entering the SCI_BASE_PORT_STATE_STOPPING. This function sets the stopping
2399 * state handlers for the struct scic_sds_port object. none
2401 static void scic_sds_port_failed_state_enter(void *object
)
2403 struct scic_sds_port
*sci_port
= object
;
2404 struct isci_port
*iport
= sci_port_to_iport(sci_port
);
2406 scic_sds_port_set_base_state_handlers(sci_port
,
2407 SCI_BASE_PORT_STATE_FAILED
);
2409 isci_port_hard_reset_complete(iport
, SCI_FAILURE_TIMEOUT
);
2412 /* --------------------------------------------------------------------------- */
2414 static const struct sci_base_state scic_sds_port_state_table
[] = {
2415 [SCI_BASE_PORT_STATE_STOPPED
] = {
2416 .enter_state
= scic_sds_port_stopped_state_enter
,
2417 .exit_state
= scic_sds_port_stopped_state_exit
2419 [SCI_BASE_PORT_STATE_STOPPING
] = {
2420 .enter_state
= scic_sds_port_stopping_state_enter
,
2421 .exit_state
= scic_sds_port_stopping_state_exit
2423 [SCI_BASE_PORT_STATE_READY
] = {
2424 .enter_state
= scic_sds_port_ready_state_enter
,
2426 [SCIC_SDS_PORT_READY_SUBSTATE_WAITING
] = {
2427 .enter_state
= scic_sds_port_ready_substate_waiting_enter
,
2429 [SCIC_SDS_PORT_READY_SUBSTATE_OPERATIONAL
] = {
2430 .enter_state
= scic_sds_port_ready_substate_operational_enter
,
2431 .exit_state
= scic_sds_port_ready_substate_operational_exit
2433 [SCIC_SDS_PORT_READY_SUBSTATE_CONFIGURING
] = {
2434 .enter_state
= scic_sds_port_ready_substate_configuring_enter
,
2435 .exit_state
= scic_sds_port_ready_substate_configuring_exit
2437 [SCI_BASE_PORT_STATE_RESETTING
] = {
2438 .enter_state
= scic_sds_port_resetting_state_enter
,
2439 .exit_state
= scic_sds_port_resetting_state_exit
2441 [SCI_BASE_PORT_STATE_FAILED
] = {
2442 .enter_state
= scic_sds_port_failed_state_enter
,
2446 void scic_sds_port_construct(struct scic_sds_port
*sci_port
, u8 index
,
2447 struct scic_sds_controller
*scic
)
2449 sci_base_state_machine_construct(&sci_port
->state_machine
,
2451 scic_sds_port_state_table
,
2452 SCI_BASE_PORT_STATE_STOPPED
);
2454 sci_base_state_machine_start(&sci_port
->state_machine
);
2456 sci_port
->logical_port_index
= SCIC_SDS_DUMMY_PORT
;
2457 sci_port
->physical_port_index
= index
;
2458 sci_port
->active_phy_mask
= 0;
2459 sci_port
->ready_exit
= false;
2461 sci_port
->owning_controller
= scic
;
2463 sci_port
->started_request_count
= 0;
2464 sci_port
->assigned_device_count
= 0;
2466 sci_port
->reserved_rni
= SCU_DUMMY_INDEX
;
2467 sci_port
->reserved_tci
= SCU_DUMMY_INDEX
;
2469 sci_port
->timer_handle
= NULL
;
2470 sci_port
->port_task_scheduler_registers
= NULL
;
2472 for (index
= 0; index
< SCI_MAX_PHYS
; index
++)
2473 sci_port
->phy_table
[index
] = NULL
;
2476 void isci_port_init(struct isci_port
*iport
, struct isci_host
*ihost
, int index
)
2478 INIT_LIST_HEAD(&iport
->remote_dev_list
);
2479 INIT_LIST_HEAD(&iport
->domain_dev_list
);
2480 spin_lock_init(&iport
->state_lock
);
2481 init_completion(&iport
->start_complete
);
2482 iport
->isci_host
= ihost
;
2483 isci_port_change_state(iport
, isci_freed
);
2487 * isci_port_get_state() - This function gets the status of the port object.
2488 * @isci_port: This parameter points to the isci_port object
2490 * status of the object as a isci_status enum.
2492 enum isci_status
isci_port_get_state(
2493 struct isci_port
*isci_port
)
2495 return isci_port
->status
;
2498 static void isci_port_bc_change_received(struct isci_host
*ihost
,
2499 struct scic_sds_port
*sci_port
,
2500 struct scic_sds_phy
*sci_phy
)
2502 struct isci_phy
*iphy
= sci_phy_to_iphy(sci_phy
);
2504 dev_dbg(&ihost
->pdev
->dev
, "%s: iphy = %p, sas_phy = %p\n",
2505 __func__
, iphy
, &iphy
->sas_phy
);
2507 ihost
->sas_ha
.notify_port_event(&iphy
->sas_phy
, PORTE_BROADCAST_RCVD
);
2508 scic_port_enable_broadcast_change_notification(sci_port
);
2511 void scic_sds_port_broadcast_change_received(
2512 struct scic_sds_port
*sci_port
,
2513 struct scic_sds_phy
*sci_phy
)
2515 struct scic_sds_controller
*scic
= sci_port
->owning_controller
;
2516 struct isci_host
*ihost
= scic_to_ihost(scic
);
2518 /* notify the user. */
2519 isci_port_bc_change_received(ihost
, sci_port
, sci_phy
);
2522 int isci_port_perform_hard_reset(struct isci_host
*ihost
, struct isci_port
*iport
,
2523 struct isci_phy
*iphy
)
2525 unsigned long flags
;
2526 enum sci_status status
;
2527 int ret
= TMF_RESP_FUNC_COMPLETE
;
2529 dev_dbg(&ihost
->pdev
->dev
, "%s: iport = %p\n",
2532 init_completion(&iport
->hard_reset_complete
);
2534 spin_lock_irqsave(&ihost
->scic_lock
, flags
);
2536 #define ISCI_PORT_RESET_TIMEOUT SCIC_SDS_SIGNATURE_FIS_TIMEOUT
2537 status
= scic_port_hard_reset(&iport
->sci
, ISCI_PORT_RESET_TIMEOUT
);
2539 spin_unlock_irqrestore(&ihost
->scic_lock
, flags
);
2541 if (status
== SCI_SUCCESS
) {
2542 wait_for_completion(&iport
->hard_reset_complete
);
2544 dev_dbg(&ihost
->pdev
->dev
,
2545 "%s: iport = %p; hard reset completion\n",
2548 if (iport
->hard_reset_status
!= SCI_SUCCESS
)
2549 ret
= TMF_RESP_FUNC_FAILED
;
2551 ret
= TMF_RESP_FUNC_FAILED
;
2553 dev_err(&ihost
->pdev
->dev
,
2554 "%s: iport = %p; scic_port_hard_reset call"
2556 __func__
, iport
, status
);
2560 /* If the hard reset for the port has failed, consider this
2561 * the same as link failures on all phys in the port.
2563 if (ret
!= TMF_RESP_FUNC_COMPLETE
) {
2564 dev_err(&ihost
->pdev
->dev
,
2565 "%s: iport = %p; hard reset failed "
2566 "(0x%x) - sending link down to libsas for phy %p\n",
2567 __func__
, iport
, iport
->hard_reset_status
, iphy
);
2569 isci_port_link_down(ihost
, iphy
, iport
);
2576 * isci_port_deformed() - This function is called by libsas when a port becomes
2578 * @phy: This parameter specifies the libsas phy with the inactive port.
2581 void isci_port_deformed(struct asd_sas_phy
*phy
)
2583 pr_debug("%s: sas_phy = %p\n", __func__
, phy
);
2587 * isci_port_formed() - This function is called by libsas when a port becomes
2589 * @phy: This parameter specifies the libsas phy with the active port.
2592 void isci_port_formed(struct asd_sas_phy
*phy
)
2594 pr_debug("%s: sas_phy = %p, sas_port = %p\n", __func__
, phy
, phy
->port
);