isci: unify isci_host and scic_sds_controller
[pandora-kernel.git] / drivers / scsi / isci / port_config.c
1 /*
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.
4  *
5  * GPL LICENSE SUMMARY
6  *
7  * Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
8  *
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.
12  *
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.
17  *
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.
23  *
24  * BSD LICENSE
25  *
26  * Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
27  * All rights reserved.
28  *
29  * Redistribution and use in source and binary forms, with or without
30  * modification, are permitted provided that the following conditions
31  * are met:
32  *
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
38  *     distribution.
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.
42  *
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.
54  */
55
56 #include "host.h"
57
58 #define SCIC_SDS_MPC_RECONFIGURATION_TIMEOUT    (10)
59 #define SCIC_SDS_APC_RECONFIGURATION_TIMEOUT    (10)
60 #define SCIC_SDS_APC_WAIT_LINK_UP_NOTIFICATION  (100)
61
62 enum SCIC_SDS_APC_ACTIVITY {
63         SCIC_SDS_APC_SKIP_PHY,
64         SCIC_SDS_APC_ADD_PHY,
65         SCIC_SDS_APC_START_TIMER,
66
67         SCIC_SDS_APC_ACTIVITY_MAX
68 };
69
70 /*
71  * ******************************************************************************
72  * General port configuration agent routines
73  * ****************************************************************************** */
74
75 /**
76  *
77  * @address_one: A SAS Address to be compared.
78  * @address_two: A SAS Address to be compared.
79  *
80  * Compare the two SAS Address and if SAS Address One is greater than SAS
81  * Address Two then return > 0 else if SAS Address One is less than SAS Address
82  * Two return < 0 Otherwise they are the same return 0 A signed value of x > 0
83  * > y where x is returned for Address One > Address Two y is returned for
84  * Address One < Address Two 0 is returned ofr Address One = Address Two
85  */
86 static s32 sci_sas_address_compare(
87         struct sci_sas_address address_one,
88         struct sci_sas_address address_two)
89 {
90         if (address_one.high > address_two.high) {
91                 return 1;
92         } else if (address_one.high < address_two.high) {
93                 return -1;
94         } else if (address_one.low > address_two.low) {
95                 return 1;
96         } else if (address_one.low < address_two.low) {
97                 return -1;
98         }
99
100         /* The two SAS Address must be identical */
101         return 0;
102 }
103
104 /**
105  *
106  * @controller: The controller object used for the port search.
107  * @phy: The phy object to match.
108  *
109  * This routine will find a matching port for the phy.  This means that the
110  * port and phy both have the same broadcast sas address and same received sas
111  * address. The port address or the NULL if there is no matching
112  * port. port address if the port can be found to match the phy.
113  * NULL if there is no matching port for the phy.
114  */
115 static struct isci_port *scic_sds_port_configuration_agent_find_port(
116         struct isci_host *ihost,
117         struct isci_phy *iphy)
118 {
119         u8 i;
120         struct sci_sas_address port_sas_address;
121         struct sci_sas_address port_attached_device_address;
122         struct sci_sas_address phy_sas_address;
123         struct sci_sas_address phy_attached_device_address;
124
125         /*
126          * Since this phy can be a member of a wide port check to see if one or
127          * more phys match the sent and received SAS address as this phy in which
128          * case it should participate in the same port.
129          */
130         scic_sds_phy_get_sas_address(iphy, &phy_sas_address);
131         scic_sds_phy_get_attached_sas_address(iphy, &phy_attached_device_address);
132
133         for (i = 0; i < ihost->logical_port_entries; i++) {
134                 struct isci_port *iport = &ihost->ports[i];
135
136                 scic_sds_port_get_sas_address(iport, &port_sas_address);
137                 scic_sds_port_get_attached_sas_address(iport, &port_attached_device_address);
138
139                 if (sci_sas_address_compare(port_sas_address, phy_sas_address) == 0 &&
140                     sci_sas_address_compare(port_attached_device_address, phy_attached_device_address) == 0)
141                         return iport;
142         }
143
144         return NULL;
145 }
146
147 /**
148  *
149  * @controller: This is the controller object that contains the port agent
150  * @port_agent: This is the port configruation agent for the controller.
151  *
152  * This routine will validate the port configuration is correct for the SCU
153  * hardware.  The SCU hardware allows for port configurations as follows. LP0
154  * -> (PE0), (PE0, PE1), (PE0, PE1, PE2, PE3) LP1 -> (PE1) LP2 -> (PE2), (PE2,
155  * PE3) LP3 -> (PE3) enum sci_status SCI_SUCCESS the port configuration is valid for
156  * this port configuration agent. SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION
157  * the port configuration is not valid for this port configuration agent.
158  */
159 static enum sci_status scic_sds_port_configuration_agent_validate_ports(
160         struct isci_host *ihost,
161         struct scic_sds_port_configuration_agent *port_agent)
162 {
163         struct sci_sas_address first_address;
164         struct sci_sas_address second_address;
165
166         /*
167          * Sanity check the max ranges for all the phys the max index
168          * is always equal to the port range index */
169         if (port_agent->phy_valid_port_range[0].max_index != 0 ||
170             port_agent->phy_valid_port_range[1].max_index != 1 ||
171             port_agent->phy_valid_port_range[2].max_index != 2 ||
172             port_agent->phy_valid_port_range[3].max_index != 3)
173                 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
174
175         /*
176          * This is a request to configure a single x4 port or at least attempt
177          * to make all the phys into a single port */
178         if (port_agent->phy_valid_port_range[0].min_index == 0 &&
179             port_agent->phy_valid_port_range[1].min_index == 0 &&
180             port_agent->phy_valid_port_range[2].min_index == 0 &&
181             port_agent->phy_valid_port_range[3].min_index == 0)
182                 return SCI_SUCCESS;
183
184         /*
185          * This is a degenerate case where phy 1 and phy 2 are assigned
186          * to the same port this is explicitly disallowed by the hardware
187          * unless they are part of the same x4 port and this condition was
188          * already checked above. */
189         if (port_agent->phy_valid_port_range[2].min_index == 1) {
190                 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
191         }
192
193         /*
194          * PE0 and PE3 can never have the same SAS Address unless they
195          * are part of the same x4 wide port and we have already checked
196          * for this condition. */
197         scic_sds_phy_get_sas_address(&ihost->phys[0], &first_address);
198         scic_sds_phy_get_sas_address(&ihost->phys[3], &second_address);
199
200         if (sci_sas_address_compare(first_address, second_address) == 0) {
201                 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
202         }
203
204         /*
205          * PE0 and PE1 are configured into a 2x1 ports make sure that the
206          * SAS Address for PE0 and PE2 are different since they can not be
207          * part of the same port. */
208         if (port_agent->phy_valid_port_range[0].min_index == 0 &&
209             port_agent->phy_valid_port_range[1].min_index == 1) {
210                 scic_sds_phy_get_sas_address(&ihost->phys[0], &first_address);
211                 scic_sds_phy_get_sas_address(&ihost->phys[2], &second_address);
212
213                 if (sci_sas_address_compare(first_address, second_address) == 0) {
214                         return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
215                 }
216         }
217
218         /*
219          * PE2 and PE3 are configured into a 2x1 ports make sure that the
220          * SAS Address for PE1 and PE3 are different since they can not be
221          * part of the same port. */
222         if (port_agent->phy_valid_port_range[2].min_index == 2 &&
223             port_agent->phy_valid_port_range[3].min_index == 3) {
224                 scic_sds_phy_get_sas_address(&ihost->phys[1], &first_address);
225                 scic_sds_phy_get_sas_address(&ihost->phys[3], &second_address);
226
227                 if (sci_sas_address_compare(first_address, second_address) == 0) {
228                         return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
229                 }
230         }
231
232         return SCI_SUCCESS;
233 }
234
235 /*
236  * ******************************************************************************
237  * Manual port configuration agent routines
238  * ****************************************************************************** */
239
240 /* verify all of the phys in the same port are using the same SAS address */
241 static enum sci_status
242 scic_sds_mpc_agent_validate_phy_configuration(struct isci_host *ihost,
243                                               struct scic_sds_port_configuration_agent *port_agent)
244 {
245         u32 phy_mask;
246         u32 assigned_phy_mask;
247         struct sci_sas_address sas_address;
248         struct sci_sas_address phy_assigned_address;
249         u8 port_index;
250         u8 phy_index;
251
252         assigned_phy_mask = 0;
253         sas_address.high = 0;
254         sas_address.low = 0;
255
256         for (port_index = 0; port_index < SCI_MAX_PORTS; port_index++) {
257                 phy_mask = ihost->oem_parameters.sds1.ports[port_index].phy_mask;
258
259                 if (!phy_mask)
260                         continue;
261                 /*
262                  * Make sure that one or more of the phys were not already assinged to
263                  * a different port. */
264                 if ((phy_mask & ~assigned_phy_mask) == 0) {
265                         return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
266                 }
267
268                 /* Find the starting phy index for this round through the loop */
269                 for (phy_index = 0; phy_index < SCI_MAX_PHYS; phy_index++) {
270                         if ((phy_mask & (1 << phy_index)) == 0)
271                                 continue;
272                         scic_sds_phy_get_sas_address(&ihost->phys[phy_index],
273                                                      &sas_address);
274
275                         /*
276                          * The phy_index can be used as the starting point for the
277                          * port range since the hardware starts all logical ports
278                          * the same as the PE index. */
279                         port_agent->phy_valid_port_range[phy_index].min_index = port_index;
280                         port_agent->phy_valid_port_range[phy_index].max_index = phy_index;
281
282                         if (phy_index != port_index) {
283                                 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
284                         }
285
286                         break;
287                 }
288
289                 /*
290                  * See how many additional phys are being added to this logical port.
291                  * Note: We have not moved the current phy_index so we will actually
292                  *       compare the startting phy with itself.
293                  *       This is expected and required to add the phy to the port. */
294                 while (phy_index < SCI_MAX_PHYS) {
295                         if ((phy_mask & (1 << phy_index)) == 0)
296                                 continue;
297                         scic_sds_phy_get_sas_address(&ihost->phys[phy_index],
298                                                      &phy_assigned_address);
299
300                         if (sci_sas_address_compare(sas_address, phy_assigned_address) != 0) {
301                                 /*
302                                  * The phy mask specified that this phy is part of the same port
303                                  * as the starting phy and it is not so fail this configuration */
304                                 return SCI_FAILURE_UNSUPPORTED_PORT_CONFIGURATION;
305                         }
306
307                         port_agent->phy_valid_port_range[phy_index].min_index = port_index;
308                         port_agent->phy_valid_port_range[phy_index].max_index = phy_index;
309
310                         scic_sds_port_add_phy(&ihost->ports[port_index],
311                                               &ihost->phys[phy_index]);
312
313                         assigned_phy_mask |= (1 << phy_index);
314                 }
315
316                 phy_index++;
317         }
318
319         return scic_sds_port_configuration_agent_validate_ports(ihost, port_agent);
320 }
321
322 static void mpc_agent_timeout(unsigned long data)
323 {
324         u8 index;
325         struct sci_timer *tmr = (struct sci_timer *)data;
326         struct scic_sds_port_configuration_agent *port_agent;
327         struct isci_host *ihost;
328         unsigned long flags;
329         u16 configure_phy_mask;
330
331         port_agent = container_of(tmr, typeof(*port_agent), timer);
332         ihost = container_of(port_agent, typeof(*ihost), port_agent);
333
334         spin_lock_irqsave(&ihost->scic_lock, flags);
335
336         if (tmr->cancel)
337                 goto done;
338
339         port_agent->timer_pending = false;
340
341         /* Find the mask of phys that are reported read but as yet unconfigured into a port */
342         configure_phy_mask = ~port_agent->phy_configured_mask & port_agent->phy_ready_mask;
343
344         for (index = 0; index < SCI_MAX_PHYS; index++) {
345                 struct isci_phy *iphy = &ihost->phys[index];
346
347                 if (configure_phy_mask & (1 << index)) {
348                         port_agent->link_up_handler(ihost, port_agent,
349                                                     phy_get_non_dummy_port(iphy),
350                                                     iphy);
351                 }
352         }
353
354 done:
355         spin_unlock_irqrestore(&ihost->scic_lock, flags);
356 }
357
358 static void scic_sds_mpc_agent_link_up(struct isci_host *ihost,
359                                        struct scic_sds_port_configuration_agent *port_agent,
360                                        struct isci_port *iport,
361                                        struct isci_phy *iphy)
362 {
363         /* If the port is NULL then the phy was not assigned to a port.
364          * This is because the phy was not given the same SAS Address as
365          * the other PHYs in the port.
366          */
367         if (!iport)
368                 return;
369
370         port_agent->phy_ready_mask |= (1 << scic_sds_phy_get_index(iphy));
371         scic_sds_port_link_up(iport, iphy);
372         if ((iport->active_phy_mask & (1 << scic_sds_phy_get_index(iphy))))
373                 port_agent->phy_configured_mask |= (1 << scic_sds_phy_get_index(iphy));
374 }
375
376 /**
377  *
378  * @controller: This is the controller object that receives the link down
379  *    notification.
380  * @port: This is the port object associated with the phy.  If the is no
381  *    associated port this is an NULL.  The port is an invalid
382  *    handle only if the phy was never port of this port.  This happens when
383  *    the phy is not broadcasting the same SAS address as the other phys in the
384  *    assigned port.
385  * @phy: This is the phy object which has gone link down.
386  *
387  * This function handles the manual port configuration link down notifications.
388  * Since all ports and phys are associated at initialization time we just turn
389  * around and notifiy the port object of the link down event.  If this PHY is
390  * not associated with a port there is no action taken. Is it possible to get a
391  * link down notification from a phy that has no assocoated port?
392  */
393 static void scic_sds_mpc_agent_link_down(
394         struct isci_host *ihost,
395         struct scic_sds_port_configuration_agent *port_agent,
396         struct isci_port *iport,
397         struct isci_phy *iphy)
398 {
399         if (iport != NULL) {
400                 /*
401                  * If we can form a new port from the remainder of the phys
402                  * then we want to start the timer to allow the SCI User to
403                  * cleanup old devices and rediscover the port before
404                  * rebuilding the port with the phys that remain in the ready
405                  * state.
406                  */
407                 port_agent->phy_ready_mask &=
408                         ~(1 << scic_sds_phy_get_index(iphy));
409                 port_agent->phy_configured_mask &=
410                         ~(1 << scic_sds_phy_get_index(iphy));
411
412                 /*
413                  * Check to see if there are more phys waiting to be
414                  * configured into a port. If there are allow the SCI User
415                  * to tear down this port, if necessary, and then reconstruct
416                  * the port after the timeout.
417                  */
418                 if ((port_agent->phy_configured_mask == 0x0000) &&
419                     (port_agent->phy_ready_mask != 0x0000) &&
420                     !port_agent->timer_pending) {
421                         port_agent->timer_pending = true;
422
423                         sci_mod_timer(&port_agent->timer,
424                                       SCIC_SDS_MPC_RECONFIGURATION_TIMEOUT);
425                 }
426
427                 scic_sds_port_link_down(iport, iphy);
428         }
429 }
430
431 /* verify phys are assigned a valid SAS address for automatic port
432  * configuration mode.
433  */
434 static enum sci_status
435 scic_sds_apc_agent_validate_phy_configuration(struct isci_host *ihost,
436                                               struct scic_sds_port_configuration_agent *port_agent)
437 {
438         u8 phy_index;
439         u8 port_index;
440         struct sci_sas_address sas_address;
441         struct sci_sas_address phy_assigned_address;
442
443         phy_index = 0;
444
445         while (phy_index < SCI_MAX_PHYS) {
446                 port_index = phy_index;
447
448                 /* Get the assigned SAS Address for the first PHY on the controller. */
449                 scic_sds_phy_get_sas_address(&ihost->phys[phy_index],
450                                             &sas_address);
451
452                 while (++phy_index < SCI_MAX_PHYS) {
453                         scic_sds_phy_get_sas_address(&ihost->phys[phy_index],
454                                                      &phy_assigned_address);
455
456                         /* Verify each of the SAS address are all the same for every PHY */
457                         if (sci_sas_address_compare(sas_address, phy_assigned_address) == 0) {
458                                 port_agent->phy_valid_port_range[phy_index].min_index = port_index;
459                                 port_agent->phy_valid_port_range[phy_index].max_index = phy_index;
460                         } else {
461                                 port_agent->phy_valid_port_range[phy_index].min_index = phy_index;
462                                 port_agent->phy_valid_port_range[phy_index].max_index = phy_index;
463                                 break;
464                         }
465                 }
466         }
467
468         return scic_sds_port_configuration_agent_validate_ports(ihost, port_agent);
469 }
470
471 static void scic_sds_apc_agent_configure_ports(struct isci_host *ihost,
472                                                struct scic_sds_port_configuration_agent *port_agent,
473                                                struct isci_phy *iphy,
474                                                bool start_timer)
475 {
476         u8 port_index;
477         enum sci_status status;
478         struct isci_port *iport;
479         enum SCIC_SDS_APC_ACTIVITY apc_activity = SCIC_SDS_APC_SKIP_PHY;
480
481         iport = scic_sds_port_configuration_agent_find_port(ihost, iphy);
482
483         if (iport) {
484                 if (scic_sds_port_is_valid_phy_assignment(iport, iphy->phy_index))
485                         apc_activity = SCIC_SDS_APC_ADD_PHY;
486                 else
487                         apc_activity = SCIC_SDS_APC_SKIP_PHY;
488         } else {
489                 /*
490                  * There is no matching Port for this PHY so lets search through the
491                  * Ports and see if we can add the PHY to its own port or maybe start
492                  * the timer and wait to see if a wider port can be made.
493                  *
494                  * Note the break when we reach the condition of the port id == phy id */
495                 for (port_index = port_agent->phy_valid_port_range[iphy->phy_index].min_index;
496                      port_index <= port_agent->phy_valid_port_range[iphy->phy_index].max_index;
497                      port_index++) {
498
499                         iport = &ihost->ports[port_index];
500
501                         /* First we must make sure that this PHY can be added to this Port. */
502                         if (scic_sds_port_is_valid_phy_assignment(iport, iphy->phy_index)) {
503                                 /*
504                                  * Port contains a PHY with a greater PHY ID than the current
505                                  * PHY that has gone link up.  This phy can not be part of any
506                                  * port so skip it and move on. */
507                                 if (iport->active_phy_mask > (1 << iphy->phy_index)) {
508                                         apc_activity = SCIC_SDS_APC_SKIP_PHY;
509                                         break;
510                                 }
511
512                                 /*
513                                  * We have reached the end of our Port list and have not found
514                                  * any reason why we should not either add the PHY to the port
515                                  * or wait for more phys to become active. */
516                                 if (iport->physical_port_index == iphy->phy_index) {
517                                         /*
518                                          * The Port either has no active PHYs.
519                                          * Consider that if the port had any active PHYs we would have
520                                          * or active PHYs with
521                                          * a lower PHY Id than this PHY. */
522                                         if (apc_activity != SCIC_SDS_APC_START_TIMER) {
523                                                 apc_activity = SCIC_SDS_APC_ADD_PHY;
524                                         }
525
526                                         break;
527                                 }
528
529                                 /*
530                                  * The current Port has no active PHYs and this PHY could be part
531                                  * of this Port.  Since we dont know as yet setup to start the
532                                  * timer and see if there is a better configuration. */
533                                 if (iport->active_phy_mask == 0) {
534                                         apc_activity = SCIC_SDS_APC_START_TIMER;
535                                 }
536                         } else if (iport->active_phy_mask != 0) {
537                                 /*
538                                  * The Port has an active phy and the current Phy can not
539                                  * participate in this port so skip the PHY and see if
540                                  * there is a better configuration. */
541                                 apc_activity = SCIC_SDS_APC_SKIP_PHY;
542                         }
543                 }
544         }
545
546         /*
547          * Check to see if the start timer operations should instead map to an
548          * add phy operation.  This is caused because we have been waiting to
549          * add a phy to a port but could not becuase the automatic port
550          * configuration engine had a choice of possible ports for the phy.
551          * Since we have gone through a timeout we are going to restrict the
552          * choice to the smallest possible port. */
553         if (
554                 (start_timer == false)
555                 && (apc_activity == SCIC_SDS_APC_START_TIMER)
556                 ) {
557                 apc_activity = SCIC_SDS_APC_ADD_PHY;
558         }
559
560         switch (apc_activity) {
561         case SCIC_SDS_APC_ADD_PHY:
562                 status = scic_sds_port_add_phy(iport, iphy);
563
564                 if (status == SCI_SUCCESS) {
565                         port_agent->phy_configured_mask |= (1 << iphy->phy_index);
566                 }
567                 break;
568
569         case SCIC_SDS_APC_START_TIMER:
570                 /*
571                  * This can occur for either a link down event, or a link
572                  * up event where we cannot yet tell the port to which a
573                  * phy belongs.
574                  */
575                 if (port_agent->timer_pending)
576                         sci_del_timer(&port_agent->timer);
577
578                 port_agent->timer_pending = true;
579                 sci_mod_timer(&port_agent->timer,
580                               SCIC_SDS_APC_WAIT_LINK_UP_NOTIFICATION);
581                 break;
582
583         case SCIC_SDS_APC_SKIP_PHY:
584         default:
585                 /* do nothing the PHY can not be made part of a port at this time. */
586                 break;
587         }
588 }
589
590 /**
591  * scic_sds_apc_agent_link_up - handle apc link up events
592  * @scic: This is the controller object that receives the link up
593  *    notification.
594  * @sci_port: This is the port object associated with the phy.  If the is no
595  *    associated port this is an NULL.
596  * @sci_phy: This is the phy object which has gone link up.
597  *
598  * This method handles the automatic port configuration for link up
599  * notifications. Is it possible to get a link down notification from a phy
600  * that has no assocoated port?
601  */
602 static void scic_sds_apc_agent_link_up(struct isci_host *ihost,
603                                        struct scic_sds_port_configuration_agent *port_agent,
604                                        struct isci_port *iport,
605                                        struct isci_phy *iphy)
606 {
607         u8 phy_index  = iphy->phy_index;
608
609         if (!iport) {
610                 /* the phy is not the part of this port */
611                 port_agent->phy_ready_mask |= 1 << phy_index;
612                 scic_sds_apc_agent_configure_ports(ihost, port_agent, iphy, true);
613         } else {
614                 /* the phy is already the part of the port */
615                 u32 port_state = iport->sm.current_state_id;
616
617                 /* if the PORT'S state is resetting then the link up is from
618                  * port hard reset in this case, we need to tell the port
619                  * that link up is recieved
620                  */
621                 BUG_ON(port_state != SCI_PORT_RESETTING);
622                 port_agent->phy_ready_mask |= 1 << phy_index;
623                 scic_sds_port_link_up(iport, iphy);
624         }
625 }
626
627 /**
628  *
629  * @controller: This is the controller object that receives the link down
630  *    notification.
631  * @iport: This is the port object associated with the phy.  If the is no
632  *    associated port this is an NULL.
633  * @iphy: This is the phy object which has gone link down.
634  *
635  * This method handles the automatic port configuration link down
636  * notifications. not associated with a port there is no action taken. Is it
637  * possible to get a link down notification from a phy that has no assocoated
638  * port?
639  */
640 static void scic_sds_apc_agent_link_down(
641         struct isci_host *ihost,
642         struct scic_sds_port_configuration_agent *port_agent,
643         struct isci_port *iport,
644         struct isci_phy *iphy)
645 {
646         port_agent->phy_ready_mask &= ~(1 << scic_sds_phy_get_index(iphy));
647
648         if (!iport)
649                 return;
650         if (port_agent->phy_configured_mask & (1 << iphy->phy_index)) {
651                 enum sci_status status;
652
653                 status = scic_sds_port_remove_phy(iport, iphy);
654
655                 if (status == SCI_SUCCESS)
656                         port_agent->phy_configured_mask &= ~(1 << iphy->phy_index);
657         }
658 }
659
660 /* configure the phys into ports when the timer fires */
661 static void apc_agent_timeout(unsigned long data)
662 {
663         u32 index;
664         struct sci_timer *tmr = (struct sci_timer *)data;
665         struct scic_sds_port_configuration_agent *port_agent;
666         struct isci_host *ihost;
667         unsigned long flags;
668         u16 configure_phy_mask;
669
670         port_agent = container_of(tmr, typeof(*port_agent), timer);
671         ihost = container_of(port_agent, typeof(*ihost), port_agent);
672
673         spin_lock_irqsave(&ihost->scic_lock, flags);
674
675         if (tmr->cancel)
676                 goto done;
677
678         port_agent->timer_pending = false;
679
680         configure_phy_mask = ~port_agent->phy_configured_mask & port_agent->phy_ready_mask;
681
682         if (!configure_phy_mask)
683                 return;
684
685         for (index = 0; index < SCI_MAX_PHYS; index++) {
686                 if ((configure_phy_mask & (1 << index)) == 0)
687                         continue;
688
689                 scic_sds_apc_agent_configure_ports(ihost, port_agent,
690                                                    &ihost->phys[index], false);
691         }
692
693 done:
694         spin_unlock_irqrestore(&ihost->scic_lock, flags);
695 }
696
697 /*
698  * ******************************************************************************
699  * Public port configuration agent routines
700  * ****************************************************************************** */
701
702 /**
703  *
704  *
705  * This method will construct the port configuration agent for operation. This
706  * call is universal for both manual port configuration and automatic port
707  * configuration modes.
708  */
709 void scic_sds_port_configuration_agent_construct(
710         struct scic_sds_port_configuration_agent *port_agent)
711 {
712         u32 index;
713
714         port_agent->phy_configured_mask = 0x00;
715         port_agent->phy_ready_mask = 0x00;
716
717         port_agent->link_up_handler = NULL;
718         port_agent->link_down_handler = NULL;
719
720         port_agent->timer_pending = false;
721
722         for (index = 0; index < SCI_MAX_PORTS; index++) {
723                 port_agent->phy_valid_port_range[index].min_index = 0;
724                 port_agent->phy_valid_port_range[index].max_index = 0;
725         }
726 }
727
728 enum sci_status scic_sds_port_configuration_agent_initialize(
729         struct isci_host *ihost,
730         struct scic_sds_port_configuration_agent *port_agent)
731 {
732         enum sci_status status;
733         enum scic_port_configuration_mode mode;
734
735         mode = ihost->oem_parameters.sds1.controller.mode_type;
736
737         if (mode == SCIC_PORT_MANUAL_CONFIGURATION_MODE) {
738                 status = scic_sds_mpc_agent_validate_phy_configuration(
739                                 ihost, port_agent);
740
741                 port_agent->link_up_handler = scic_sds_mpc_agent_link_up;
742                 port_agent->link_down_handler = scic_sds_mpc_agent_link_down;
743
744                 sci_init_timer(&port_agent->timer, mpc_agent_timeout);
745         } else {
746                 status = scic_sds_apc_agent_validate_phy_configuration(
747                                 ihost, port_agent);
748
749                 port_agent->link_up_handler = scic_sds_apc_agent_link_up;
750                 port_agent->link_down_handler = scic_sds_apc_agent_link_down;
751
752                 sci_init_timer(&port_agent->timer, apc_agent_timeout);
753         }
754
755         return status;
756 }