ehci-hub.c 30.2 KB
Newer Older
L
Linus Torvalds 已提交
1
/*
D
David Brownell 已提交
2
 * Copyright (C) 2001-2004 by David Brownell
3
 *
L
Linus Torvalds 已提交
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published by the
 * Free Software Foundation; either version 2 of the License, or (at your
 * option) any later version.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

/* this file is part of ehci-hcd.c */

/*-------------------------------------------------------------------------*/

/*
 * EHCI Root Hub ... the nonsharable stuff
 *
 * Registers don't need cpu_to_le32, that happens transparently
 */

/*-------------------------------------------------------------------------*/
30
#include <linux/usb/otg.h>
L
Linus Torvalds 已提交
31

32 33
#define	PORT_WAKE_BITS	(PORT_WKOC_E|PORT_WKDISC_E|PORT_WKCONN_E)

34 35
#ifdef	CONFIG_PM

A
Alan Stern 已提交
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
static int ehci_hub_control(
	struct usb_hcd	*hcd,
	u16		typeReq,
	u16		wValue,
	u16		wIndex,
	char		*buf,
	u16		wLength
);

/* After a power loss, ports that were owned by the companion must be
 * reset so that the companion can still own them.
 */
static void ehci_handover_companion_ports(struct ehci_hcd *ehci)
{
	u32 __iomem	*reg;
	u32		status;
	int		port;
	__le32		buf;
	struct usb_hcd	*hcd = ehci_to_hcd(ehci);

	if (!ehci->owned_ports)
		return;

59 60 61 62 63 64 65 66 67 68 69 70 71
	/* Make sure the ports are powered */
	port = HCS_N_PORTS(ehci->hcs_params);
	while (port--) {
		if (test_bit(port, &ehci->owned_ports)) {
			reg = &ehci->regs->port_status[port];
			status = ehci_readl(ehci, reg) & ~PORT_RWC_BITS;
			if (!(status & PORT_POWER)) {
				status |= PORT_POWER;
				ehci_writel(ehci, status, reg);
			}
		}
	}

A
Alan Stern 已提交
72 73 74
	/* Give the connections some time to appear */
	msleep(20);

A
Alan Stern 已提交
75
	spin_lock_irq(&ehci->lock);
A
Alan Stern 已提交
76 77 78 79
	port = HCS_N_PORTS(ehci->hcs_params);
	while (port--) {
		if (test_bit(port, &ehci->owned_ports)) {
			reg = &ehci->regs->port_status[port];
80
			status = ehci_readl(ehci, reg) & ~PORT_RWC_BITS;
A
Alan Stern 已提交
81 82 83 84

			/* Port already owned by companion? */
			if (status & PORT_OWNER)
				clear_bit(port, &ehci->owned_ports);
85 86
			else if (test_bit(port, &ehci->companion_ports))
				ehci_writel(ehci, status & ~PORT_PE, reg);
A
Alan Stern 已提交
87 88
			else {
				spin_unlock_irq(&ehci->lock);
A
Alan Stern 已提交
89 90 91
				ehci_hub_control(hcd, SetPortFeature,
						USB_PORT_FEAT_RESET, port + 1,
						NULL, 0);
A
Alan Stern 已提交
92 93
				spin_lock_irq(&ehci->lock);
			}
A
Alan Stern 已提交
94 95
		}
	}
A
Alan Stern 已提交
96
	spin_unlock_irq(&ehci->lock);
A
Alan Stern 已提交
97 98 99 100 101

	if (!ehci->owned_ports)
		return;
	msleep(90);		/* Wait for resets to complete */

A
Alan Stern 已提交
102
	spin_lock_irq(&ehci->lock);
A
Alan Stern 已提交
103 104 105
	port = HCS_N_PORTS(ehci->hcs_params);
	while (port--) {
		if (test_bit(port, &ehci->owned_ports)) {
A
Alan Stern 已提交
106
			spin_unlock_irq(&ehci->lock);
A
Alan Stern 已提交
107 108 109
			ehci_hub_control(hcd, GetPortStatus,
					0, port + 1,
					(char *) &buf, sizeof(buf));
A
Alan Stern 已提交
110
			spin_lock_irq(&ehci->lock);
A
Alan Stern 已提交
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128

			/* The companion should now own the port,
			 * but if something went wrong the port must not
			 * remain enabled.
			 */
			reg = &ehci->regs->port_status[port];
			status = ehci_readl(ehci, reg) & ~PORT_RWC_BITS;
			if (status & PORT_OWNER)
				ehci_writel(ehci, status | PORT_CSC, reg);
			else {
				ehci_dbg(ehci, "failed handover port %d: %x\n",
						port + 1, status);
				ehci_writel(ehci, status & ~PORT_PE, reg);
			}
		}
	}

	ehci->owned_ports = 0;
A
Alan Stern 已提交
129
	spin_unlock_irq(&ehci->lock);
A
Alan Stern 已提交
130 131
}

132
static int ehci_port_change(struct ehci_hcd *ehci)
133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152
{
	int i = HCS_N_PORTS(ehci->hcs_params);

	/* First check if the controller indicates a change event */

	if (ehci_readl(ehci, &ehci->regs->status) & STS_PCD)
		return 1;

	/*
	 * Not all controllers appear to update this while going from D3 to D0,
	 * so check the individual port status registers as well
	 */

	while (i--)
		if (ehci_readl(ehci, &ehci->regs->port_status[i]) & PORT_CSC)
			return 1;

	return 0;
}

153
static void ehci_adjust_port_wakeup_flags(struct ehci_hcd *ehci,
154
		bool suspending, bool do_wakeup)
155 156 157 158 159 160 161 162 163
{
	int		port;
	u32		temp;

	/* If remote wakeup is enabled for the root hub but disabled
	 * for the controller, we must adjust all the port wakeup flags
	 * when the controller is suspended or resumed.  In all other
	 * cases they don't need to be changed.
	 */
164
	if (!ehci_to_hcd(ehci)->self.root_hub->do_remote_wakeup || do_wakeup)
165 166
		return;

A
Alan Stern 已提交
167
	spin_lock_irq(&ehci->lock);
168

169 170 171 172
	/* clear phy low-power mode before changing wakeup flags */
	if (ehci->has_hostpc) {
		port = HCS_N_PORTS(ehci->hcs_params);
		while (port--) {
173
			u32 __iomem	*hostpc_reg = &ehci->regs->hostpc[port];
174 175 176 177

			temp = ehci_readl(ehci, hostpc_reg);
			ehci_writel(ehci, temp & ~HOSTPC_PHCD, hostpc_reg);
		}
A
Alan Stern 已提交
178
		spin_unlock_irq(&ehci->lock);
179
		msleep(5);
A
Alan Stern 已提交
180
		spin_lock_irq(&ehci->lock);
181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206
	}

	port = HCS_N_PORTS(ehci->hcs_params);
	while (port--) {
		u32 __iomem	*reg = &ehci->regs->port_status[port];
		u32		t1 = ehci_readl(ehci, reg) & ~PORT_RWC_BITS;
		u32		t2 = t1 & ~PORT_WAKE_BITS;

		/* If we are suspending the controller, clear the flags.
		 * If we are resuming the controller, set the wakeup flags.
		 */
		if (!suspending) {
			if (t1 & PORT_CONNECT)
				t2 |= PORT_WKOC_E | PORT_WKDISC_E;
			else
				t2 |= PORT_WKOC_E | PORT_WKCONN_E;
		}
		ehci_vdbg(ehci, "port %d, %08x -> %08x\n",
				port + 1, t1, t2);
		ehci_writel(ehci, t2, reg);
	}

	/* enter phy low-power mode again */
	if (ehci->has_hostpc) {
		port = HCS_N_PORTS(ehci->hcs_params);
		while (port--) {
207
			u32 __iomem	*hostpc_reg = &ehci->regs->hostpc[port];
208 209 210 211 212

			temp = ehci_readl(ehci, hostpc_reg);
			ehci_writel(ehci, temp | HOSTPC_PHCD, hostpc_reg);
		}
	}
213 214

	/* Does the root hub have a port wakeup pending? */
215
	if (!suspending && ehci_port_change(ehci))
216
		usb_hcd_resume_root_hub(ehci_to_hcd(ehci));
217

A
Alan Stern 已提交
218
	spin_unlock_irq(&ehci->lock);
219 220
}

221
static int ehci_bus_suspend (struct usb_hcd *hcd)
L
Linus Torvalds 已提交
222 223 224
{
	struct ehci_hcd		*ehci = hcd_to_ehci (hcd);
	int			port;
225
	int			mask;
226
	int			changed;
L
Linus Torvalds 已提交
227

228 229
	ehci_dbg(ehci, "suspend root hub\n");

L
Linus Torvalds 已提交
230 231 232
	if (time_before (jiffies, ehci->next_statechange))
		msleep(5);

A
Alan Stern 已提交
233 234 235
	/* stop the schedules */
	ehci_quiesce(ehci);

L
Linus Torvalds 已提交
236
	spin_lock_irq (&ehci->lock);
237 238
	if (ehci->rh_state < EHCI_RH_RUNNING)
		goto done;
L
Linus Torvalds 已提交
239

240 241 242 243 244 245
	/* Once the controller is stopped, port resumes that are already
	 * in progress won't complete.  Hence if remote wakeup is enabled
	 * for the root hub and any ports are in the middle of a resume or
	 * remote wakeup, we must fail the suspend.
	 */
	if (hcd->self.root_hub->do_remote_wakeup) {
246 247 248 249
		if (ehci->resuming_ports) {
			spin_unlock_irq(&ehci->lock);
			ehci_dbg(ehci, "suspend failed because a port is resuming\n");
			return -EBUSY;
250 251 252
		}
	}

253 254 255 256 257 258
	/* Unlike other USB host controller types, EHCI doesn't have
	 * any notion of "global" or bus-wide suspend.  The driver has
	 * to manually suspend all the active unsuspended ports, and
	 * then manually resume them in the bus_resume() routine.
	 */
	ehci->bus_suspended = 0;
A
Alan Stern 已提交
259
	ehci->owned_ports = 0;
260
	changed = 0;
261
	port = HCS_N_PORTS(ehci->hcs_params);
L
Linus Torvalds 已提交
262 263
	while (port--) {
		u32 __iomem	*reg = &ehci->regs->port_status [port];
264
		u32		t1 = ehci_readl(ehci, reg) & ~PORT_RWC_BITS;
265
		u32		t2 = t1 & ~PORT_WAKE_BITS;
L
Linus Torvalds 已提交
266

267
		/* keep track of which ports we suspend */
A
Alan Stern 已提交
268 269 270
		if (t1 & PORT_OWNER)
			set_bit(port, &ehci->owned_ports);
		else if ((t1 & PORT_PE) && !(t1 & PORT_SUSPEND)) {
L
Linus Torvalds 已提交
271
			t2 |= PORT_SUSPEND;
272 273 274
			set_bit(port, &ehci->bus_suspended);
		}

275
		/* enable remote wakeup on all ports, if told to do so */
276 277 278 279 280 281
		if (hcd->self.root_hub->do_remote_wakeup) {
			/* only enable appropriate wake bits, otherwise the
			 * hardware can not go phy low power mode. If a race
			 * condition happens here(connection change during bits
			 * set), the port change detection will finally fix it.
			 */
282
			if (t1 & PORT_CONNECT)
283
				t2 |= PORT_WKOC_E | PORT_WKDISC_E;
284
			else
285
				t2 |= PORT_WKOC_E | PORT_WKCONN_E;
286
		}
L
Linus Torvalds 已提交
287 288 289 290

		if (t1 != t2) {
			ehci_vdbg (ehci, "port %d, %08x -> %08x\n",
				port + 1, t1, t2);
291
			ehci_writel(ehci, t2, reg);
292 293 294
			changed = 1;
		}
	}
295

296 297 298 299 300 301 302
	if (changed && ehci->has_hostpc) {
		spin_unlock_irq(&ehci->lock);
		msleep(5);	/* 5 ms for HCD to enter low-power mode */
		spin_lock_irq(&ehci->lock);

		port = HCS_N_PORTS(ehci->hcs_params);
		while (port--) {
303
			u32 __iomem	*hostpc_reg = &ehci->regs->hostpc[port];
304 305 306 307 308 309
			u32		t3;

			t3 = ehci_readl(ehci, hostpc_reg);
			ehci_writel(ehci, t3 | HOSTPC_PHCD, hostpc_reg);
			t3 = ehci_readl(ehci, hostpc_reg);
			ehci_dbg(ehci, "Port %d phy low-power mode %s\n",
310 311
					port, (t3 & HOSTPC_PHCD) ?
					"succeeded" : "failed");
L
Linus Torvalds 已提交
312 313
		}
	}
A
Alan Stern 已提交
314
	spin_unlock_irq(&ehci->lock);
L
Linus Torvalds 已提交
315

316 317 318 319
	/* Apparently some devices need a >= 1-uframe delay here */
	if (ehci->bus_suspended)
		udelay(150);

L
Linus Torvalds 已提交
320 321
	/* turn off now-idle HC */
	ehci_halt (ehci);
A
Alan Stern 已提交
322 323

	spin_lock_irq(&ehci->lock);
324 325 326 327
	if (ehci->enabled_hrtimer_events & BIT(EHCI_HRTIMER_POLL_DEAD))
		ehci_handle_controller_death(ehci);
	if (ehci->rh_state != EHCI_RH_RUNNING)
		goto done;
328
	ehci->rh_state = EHCI_RH_SUSPENDED;
L
Linus Torvalds 已提交
329

330
	end_unlink_async(ehci);
331
	unlink_empty_async(ehci);
332
	ehci_handle_intr_unlinks(ehci);
333
	end_free_itds(ehci);
334

335 336
	/* allow remote wakeup */
	mask = INTR_MASK;
337
	if (!hcd->self.root_hub->do_remote_wakeup)
338
		mask &= ~STS_PCD;
339 340
	ehci_writel(ehci, mask, &ehci->regs->intr_enable);
	ehci_readl(ehci, &ehci->regs->intr_enable);
341

342
 done:
L
Linus Torvalds 已提交
343
	ehci->next_statechange = jiffies + msecs_to_jiffies(10);
A
Alan Stern 已提交
344 345
	ehci->enabled_hrtimer_events = 0;
	ehci->next_hrtimer_event = EHCI_HRTIMER_NO_EVENT;
L
Linus Torvalds 已提交
346
	spin_unlock_irq (&ehci->lock);
347

A
Alan Stern 已提交
348
	hrtimer_cancel(&ehci->hrtimer);
L
Linus Torvalds 已提交
349 350 351 352 353
	return 0;
}


/* caller has locked the root hub, and should reset/reinit on error */
354
static int ehci_bus_resume (struct usb_hcd *hcd)
L
Linus Torvalds 已提交
355 356 357
{
	struct ehci_hcd		*ehci = hcd_to_ehci (hcd);
	u32			temp;
A
Alan Stern 已提交
358
	u32			power_okay;
L
Linus Torvalds 已提交
359
	int			i;
360
	unsigned long		resume_needed = 0;
L
Linus Torvalds 已提交
361 362 363 364

	if (time_before (jiffies, ehci->next_statechange))
		msleep(5);
	spin_lock_irq (&ehci->lock);
365 366
	if (!HCD_HW_ACCESSIBLE(hcd) || ehci->shutdown)
		goto shutdown;
L
Linus Torvalds 已提交
367

368
	if (unlikely(ehci->debug)) {
369
		if (!dbgp_reset_prep(hcd))
370 371
			ehci->debug = NULL;
		else
372
			dbgp_external_startup(hcd);
373 374
	}

D
David Brownell 已提交
375 376 377 378 379 380
	/* Ideally and we've got a real resume here, and no port's power
	 * was lost.  (For PCI, that means Vaux was maintained.)  But we
	 * could instead be restoring a swsusp snapshot -- so that BIOS was
	 * the last user of the controller, not reset/pm hardware keeping
	 * state we gave to it.
	 */
A
Alan Stern 已提交
381 382 383
	power_okay = ehci_readl(ehci, &ehci->regs->intr_enable);
	ehci_dbg(ehci, "resume root hub%s\n",
			power_okay ? "" : " after power loss");
D
David Brownell 已提交
384

385 386 387
	/* at least some APM implementations will try to deliver
	 * IRQs right away, so delay them until we're ready.
	 */
388
	ehci_writel(ehci, 0, &ehci->regs->intr_enable);
389 390

	/* re-init operational registers */
391 392 393
	ehci_writel(ehci, 0, &ehci->regs->segment);
	ehci_writel(ehci, ehci->periodic_dma, &ehci->regs->frame_list);
	ehci_writel(ehci, (u32) ehci->async->qh_dma, &ehci->regs->async_next);
L
Linus Torvalds 已提交
394 395

	/* restore CMD_RUN, framelist size, and irq threshold */
396
	ehci->command |= CMD_RUN;
397
	ehci_writel(ehci, ehci->command, &ehci->regs->command);
398
	ehci->rh_state = EHCI_RH_RUNNING;
L
Linus Torvalds 已提交
399

400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417
	/*
	 * According to Bugzilla #8190, the port status for some controllers
	 * will be wrong without a delay. At their wrong status, the port
	 * is enabled, but not suspended neither resumed.
	 */
	i = HCS_N_PORTS(ehci->hcs_params);
	while (i--) {
		temp = ehci_readl(ehci, &ehci->regs->port_status[i]);
		if ((temp & PORT_PE) &&
				!(temp & (PORT_SUSPEND | PORT_RESUME))) {
			ehci_dbg(ehci, "Port status(0x%x) is wrong\n", temp);
			spin_unlock_irq(&ehci->lock);
			msleep(8);
			spin_lock_irq(&ehci->lock);
			break;
		}
	}

418 419
	if (ehci->shutdown)
		goto shutdown;
420

421 422 423 424 425
	/* clear phy low-power mode before resume */
	if (ehci->bus_suspended && ehci->has_hostpc) {
		i = HCS_N_PORTS(ehci->hcs_params);
		while (i--) {
			if (test_bit(i, &ehci->bus_suspended)) {
426 427
				u32 __iomem	*hostpc_reg =
							&ehci->regs->hostpc[i];
428 429 430 431 432 433 434 435 436

				temp = ehci_readl(ehci, hostpc_reg);
				ehci_writel(ehci, temp & ~HOSTPC_PHCD,
						hostpc_reg);
			}
		}
		spin_unlock_irq(&ehci->lock);
		msleep(5);
		spin_lock_irq(&ehci->lock);
437 438
		if (ehci->shutdown)
			goto shutdown;
439 440
	}

441
	/* manually resume the ports we suspended during bus_suspend() */
L
Linus Torvalds 已提交
442 443
	i = HCS_N_PORTS (ehci->hcs_params);
	while (i--) {
444
		temp = ehci_readl(ehci, &ehci->regs->port_status [i]);
445
		temp &= ~(PORT_RWC_BITS | PORT_WAKE_BITS);
446
		if (test_bit(i, &ehci->bus_suspended) &&
447
				(temp & PORT_SUSPEND)) {
L
Linus Torvalds 已提交
448
			temp |= PORT_RESUME;
449
			set_bit(i, &resume_needed);
450
		}
451
		ehci_writel(ehci, temp, &ehci->regs->port_status [i]);
L
Linus Torvalds 已提交
452
	}
453 454 455 456 457 458

	/* msleep for 20ms only if code is trying to resume port */
	if (resume_needed) {
		spin_unlock_irq(&ehci->lock);
		msleep(20);
		spin_lock_irq(&ehci->lock);
459 460
		if (ehci->shutdown)
			goto shutdown;
461 462
	}

L
Linus Torvalds 已提交
463 464
	i = HCS_N_PORTS (ehci->hcs_params);
	while (i--) {
465
		temp = ehci_readl(ehci, &ehci->regs->port_status [i]);
466
		if (test_bit(i, &resume_needed)) {
467
			temp &= ~(PORT_RWC_BITS | PORT_RESUME);
468
			ehci_writel(ehci, temp, &ehci->regs->port_status [i]);
469 470
			ehci_vdbg (ehci, "resumed port %d\n", i + 1);
		}
L
Linus Torvalds 已提交
471 472 473
	}

	ehci->next_statechange = jiffies + msecs_to_jiffies(5);
A
Alan Stern 已提交
474 475 476
	spin_unlock_irq(&ehci->lock);

	ehci_handover_companion_ports(ehci);
L
Linus Torvalds 已提交
477 478

	/* Now we can safely re-enable irqs */
479 480 481
	spin_lock_irq(&ehci->lock);
	if (ehci->shutdown)
		goto shutdown;
482
	ehci_writel(ehci, INTR_MASK, &ehci->regs->intr_enable);
483
	(void) ehci_readl(ehci, &ehci->regs->intr_enable);
484
	spin_unlock_irq(&ehci->lock);
L
Linus Torvalds 已提交
485 486

	return 0;
487 488 489 490

 shutdown:
	spin_unlock_irq(&ehci->lock);
	return -ESHUTDOWN;
L
Linus Torvalds 已提交
491 492 493 494
}

#else

495 496
#define ehci_bus_suspend	NULL
#define ehci_bus_resume		NULL
L
Linus Torvalds 已提交
497 498 499

#endif	/* CONFIG_PM */

500 501 502
/*-------------------------------------------------------------------------*/

/*
503
 * Sets the owner of a port
504
 */
505
static void set_owner(struct ehci_hcd *ehci, int portnum, int new_owner)
506 507 508
{
	u32 __iomem		*status_reg;
	u32			port_status;
509
	int 			try;
510

511
	status_reg = &ehci->regs->port_status[portnum];
512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533

	/*
	 * The controller won't set the OWNER bit if the port is
	 * enabled, so this loop will sometimes require at least two
	 * iterations: one to disable the port and one to set OWNER.
	 */
	for (try = 4; try > 0; --try) {
		spin_lock_irq(&ehci->lock);
		port_status = ehci_readl(ehci, status_reg);
		if ((port_status & PORT_OWNER) == new_owner
				|| (port_status & (PORT_OWNER | PORT_CONNECT))
					== 0)
			try = 0;
		else {
			port_status ^= PORT_OWNER;
			port_status &= ~(PORT_PE | PORT_RWC_BITS);
			ehci_writel(ehci, port_status, status_reg);
		}
		spin_unlock_irq(&ehci->lock);
		if (try > 1)
			msleep(5);
	}
534 535
}

L
Linus Torvalds 已提交
536 537 538 539 540
/*-------------------------------------------------------------------------*/

static int check_reset_complete (
	struct ehci_hcd	*ehci,
	int		index,
541
	u32 __iomem	*status_reg,
L
Linus Torvalds 已提交
542 543
	int		port_status
) {
544
	if (!(port_status & PORT_CONNECT))
L
Linus Torvalds 已提交
545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562
		return port_status;

	/* if reset finished and it's still not enabled -- handoff */
	if (!(port_status & PORT_PE)) {

		/* with integrated TT, there's nobody to hand it to! */
		if (ehci_is_TDI(ehci)) {
			ehci_dbg (ehci,
				"Failed to enable port %d on root hub TT\n",
				index+1);
			return port_status;
		}

		ehci_dbg (ehci, "port %d full speed --> companion\n",
			index + 1);

		// what happens if HCS_N_CC(params) == 0 ?
		port_status |= PORT_OWNER;
D
David Brownell 已提交
563
		port_status &= ~PORT_RWC_BITS;
564
		ehci_writel(ehci, port_status, status_reg);
L
Linus Torvalds 已提交
565

566 567 568 569
		/* ensure 440EPX ohci controller state is operational */
		if (ehci->has_amcc_usb23)
			set_ohci_hcfs(ehci, 1);
	} else {
570 571
		ehci_dbg(ehci, "port %d reset complete, port enabled\n",
			index + 1);
572 573 574 575
		/* ensure 440EPx ohci controller state is suspended */
		if (ehci->has_amcc_usb23)
			set_ohci_hcfs(ehci, 0);
	}
L
Linus Torvalds 已提交
576 577 578 579 580 581 582 583 584 585 586 587 588

	return port_status;
}

/*-------------------------------------------------------------------------*/


/* build "status change" packet (one or two bytes) from HC registers */

static int
ehci_hub_status_data (struct usb_hcd *hcd, char *buf)
{
	struct ehci_hcd	*ehci = hcd_to_ehci (hcd);
589
	u32		temp, status;
590
	u32		mask;
L
Linus Torvalds 已提交
591 592
	int		ports, i, retval = 1;
	unsigned long	flags;
593
	u32		ppcd = 0;
L
Linus Torvalds 已提交
594 595 596 597 598 599 600 601

	/* init status to no-changes */
	buf [0] = 0;
	ports = HCS_N_PORTS (ehci->hcs_params);
	if (ports > 7) {
		buf [1] = 0;
		retval++;
	}
602

603 604 605 606 607
	/* Inform the core about resumes-in-progress by returning
	 * a non-zero value even if there are no status changes.
	 */
	status = ehci->resuming_ports;

608 609
	/* Some boards (mostly VIA?) report bogus overcurrent indications,
	 * causing massive log spam unless we completely ignore them.  It
610
	 * may be relevant that VIA VT8235 controllers, where PORT_POWER is
611 612 613 614 615 616 617 618 619
	 * always set, seem to clear PORT_OCC and PORT_CSC when writing to
	 * PORT_POWER; that's surprising, but maybe within-spec.
	 */
	if (!ignore_oc)
		mask = PORT_CSC | PORT_PEC | PORT_OCC;
	else
		mask = PORT_CSC | PORT_PEC;
	// PORT_RESUME from hardware ~= PORT_STAT_C_SUSPEND

L
Linus Torvalds 已提交
620 621 622 623
	/* no hub change reports (bit 0) for now (power, ...) */

	/* port N changes (bit N)? */
	spin_lock_irqsave (&ehci->lock, flags);
624 625 626 627 628

	/* get per-port change detect bits */
	if (ehci->has_ppcd)
		ppcd = ehci_readl(ehci, &ehci->regs->status) >> 16;

L
Linus Torvalds 已提交
629
	for (i = 0; i < ports; i++) {
630 631 632
		/* leverage per-port change bits feature */
		if (ehci->has_ppcd && !(ppcd & (1 << i)))
			continue;
633
		temp = ehci_readl(ehci, &ehci->regs->port_status [i]);
634 635 636 637 638 639 640 641

		/*
		 * Return status information even for ports with OWNER set.
		 * Otherwise khubd wouldn't see the disconnect event when a
		 * high-speed device is switched over to the companion
		 * controller by the user.
		 */

642 643 644
		if ((temp & mask) != 0 || test_bit(i, &ehci->port_c_suspend)
				|| (ehci->reset_done[i] && time_after_eq(
					jiffies, ehci->reset_done[i]))) {
L
Linus Torvalds 已提交
645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675
			if (i < 7)
			    buf [0] |= 1 << (i + 1);
			else
			    buf [1] |= 1 << (i - 7);
			status = STS_PCD;
		}
	}
	/* FIXME autosuspend idle root hubs */
	spin_unlock_irqrestore (&ehci->lock, flags);
	return status ? retval : 0;
}

/*-------------------------------------------------------------------------*/

static void
ehci_hub_descriptor (
	struct ehci_hcd			*ehci,
	struct usb_hub_descriptor	*desc
) {
	int		ports = HCS_N_PORTS (ehci->hcs_params);
	u16		temp;

	desc->bDescriptorType = 0x29;
	desc->bPwrOn2PwrGood = 10;	/* ehci 1.0, 2.3.9 says 20ms max */
	desc->bHubContrCurrent = 0;

	desc->bNbrPorts = ports;
	temp = 1 + (ports / 8);
	desc->bDescLength = 7 + 2 * temp;

	/* two bitmaps:  ports removable, and usb 1.0 legacy PortPwrCtrlMask */
J
John Youn 已提交
676 677
	memset(&desc->u.hs.DeviceRemovable[0], 0, temp);
	memset(&desc->u.hs.DeviceRemovable[temp], 0xff, temp);
L
Linus Torvalds 已提交
678 679 680 681

	temp = 0x0008;			/* per-port overcurrent reporting */
	if (HCS_PPC (ehci->hcs_params))
		temp |= 0x0001;		/* per-port power control */
D
David Brownell 已提交
682 683
	else
		temp |= 0x0002;		/* no power switching */
L
Linus Torvalds 已提交
684 685 686 687 688
#if 0
// re-enable when we support USB_PORT_FEAT_INDICATOR below.
	if (HCS_INDICATOR (ehci->hcs_params))
		temp |= 0x0080;		/* per-port indicators (LEDs) */
#endif
A
Al Viro 已提交
689
	desc->wHubCharacteristics = cpu_to_le16(temp);
L
Linus Torvalds 已提交
690 691 692 693 694 695 696 697 698 699 700 701 702 703
}

/*-------------------------------------------------------------------------*/

static int ehci_hub_control (
	struct usb_hcd	*hcd,
	u16		typeReq,
	u16		wValue,
	u16		wIndex,
	char		*buf,
	u16		wLength
) {
	struct ehci_hcd	*ehci = hcd_to_ehci (hcd);
	int		ports = HCS_N_PORTS (ehci->hcs_params);
A
Alan Stern 已提交
704 705
	u32 __iomem	*status_reg = &ehci->regs->port_status[
				(wIndex & 0xff) - 1];
706
	u32 __iomem	*hostpc_reg = &ehci->regs->hostpc[(wIndex & 0xff) - 1];
707
	u32		temp, temp1, status;
L
Linus Torvalds 已提交
708 709
	unsigned long	flags;
	int		retval = 0;
710
	unsigned	selector;
L
Linus Torvalds 已提交
711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734

	/*
	 * FIXME:  support SetPortFeatures USB_PORT_FEAT_INDICATOR.
	 * HCS_INDICATOR may say we can change LEDs to off/amber/green.
	 * (track current state ourselves) ... blink for diagnostics,
	 * power, "this is the one", etc.  EHCI spec supports this.
	 */

	spin_lock_irqsave (&ehci->lock, flags);
	switch (typeReq) {
	case ClearHubFeature:
		switch (wValue) {
		case C_HUB_LOCAL_POWER:
		case C_HUB_OVER_CURRENT:
			/* no hub-wide feature/status flags */
			break;
		default:
			goto error;
		}
		break;
	case ClearPortFeature:
		if (!wIndex || wIndex > ports)
			goto error;
		wIndex--;
735
		temp = ehci_readl(ehci, status_reg);
736
		temp &= ~PORT_RWC_BITS;
737 738 739 740 741

		/*
		 * Even if OWNER is set, so the port is owned by the
		 * companion controller, khubd needs to be able to clear
		 * the port-change status bits (especially
742
		 * USB_PORT_STAT_C_CONNECTION).
743
		 */
L
Linus Torvalds 已提交
744 745 746

		switch (wValue) {
		case USB_PORT_FEAT_ENABLE:
747
			ehci_writel(ehci, temp & ~PORT_PE, status_reg);
L
Linus Torvalds 已提交
748 749
			break;
		case USB_PORT_FEAT_C_ENABLE:
750
			ehci_writel(ehci, temp | PORT_PEC, status_reg);
L
Linus Torvalds 已提交
751 752 753 754
			break;
		case USB_PORT_FEAT_SUSPEND:
			if (temp & PORT_RESET)
				goto error;
D
David Brownell 已提交
755 756
			if (ehci->no_selective_suspend)
				break;
757 758 759
#ifdef CONFIG_USB_OTG
			if ((hcd->self.otg_port == (wIndex + 1))
			    && hcd->self.b_hnp_enable) {
760
				otg_start_hnp(hcd->phy->otg);
761 762 763
				break;
			}
#endif
764 765 766 767 768 769
			if (!(temp & PORT_SUSPEND))
				break;
			if ((temp & PORT_PE) == 0)
				goto error;

			/* clear phy low-power mode before resume */
770
			if (ehci->has_hostpc) {
771 772
				temp1 = ehci_readl(ehci, hostpc_reg);
				ehci_writel(ehci, temp1 & ~HOSTPC_PHCD,
A
Alek Du 已提交
773
						hostpc_reg);
774 775 776
				spin_unlock_irqrestore(&ehci->lock, flags);
				msleep(5);/* wait to leave low-power mode */
				spin_lock_irqsave(&ehci->lock, flags);
L
Linus Torvalds 已提交
777
			}
778
			/* resume signaling for 20 msec */
779
			temp &= ~PORT_WAKE_BITS;
780 781 782
			ehci_writel(ehci, temp | PORT_RESUME, status_reg);
			ehci->reset_done[wIndex] = jiffies
					+ msecs_to_jiffies(20);
L
Linus Torvalds 已提交
783 784
			break;
		case USB_PORT_FEAT_C_SUSPEND:
785
			clear_bit(wIndex, &ehci->port_c_suspend);
L
Linus Torvalds 已提交
786 787 788
			break;
		case USB_PORT_FEAT_POWER:
			if (HCS_PPC (ehci->hcs_params))
789 790
				ehci_writel(ehci, temp & ~PORT_POWER,
						status_reg);
L
Linus Torvalds 已提交
791 792
			break;
		case USB_PORT_FEAT_C_CONNECTION:
793
			ehci_writel(ehci, temp | PORT_CSC, status_reg);
L
Linus Torvalds 已提交
794 795
			break;
		case USB_PORT_FEAT_C_OVER_CURRENT:
796
			ehci_writel(ehci, temp | PORT_OCC, status_reg);
L
Linus Torvalds 已提交
797 798 799 800 801 802 803
			break;
		case USB_PORT_FEAT_C_RESET:
			/* GetPortStatus clears reset */
			break;
		default:
			goto error;
		}
804
		ehci_readl(ehci, &ehci->regs->command);	/* unblock posted write */
L
Linus Torvalds 已提交
805 806 807 808 809 810 811 812 813 814 815 816 817 818 819
		break;
	case GetHubDescriptor:
		ehci_hub_descriptor (ehci, (struct usb_hub_descriptor *)
			buf);
		break;
	case GetHubStatus:
		/* no hub-wide feature/status flags */
		memset (buf, 0, 4);
		//cpu_to_le32s ((u32 *) buf);
		break;
	case GetPortStatus:
		if (!wIndex || wIndex > ports)
			goto error;
		wIndex--;
		status = 0;
820
		temp = ehci_readl(ehci, status_reg);
L
Linus Torvalds 已提交
821 822 823

		// wPortChange bits
		if (temp & PORT_CSC)
824
			status |= USB_PORT_STAT_C_CONNECTION << 16;
L
Linus Torvalds 已提交
825
		if (temp & PORT_PEC)
826
			status |= USB_PORT_STAT_C_ENABLE << 16;
827 828

		if ((temp & PORT_OCC) && !ignore_oc){
829
			status |= USB_PORT_STAT_C_OVERCURRENT << 16;
L
Linus Torvalds 已提交
830

831 832 833 834 835 836 837
			/*
			 * Hubs should disable port power on over-current.
			 * However, not all EHCI implementations do this
			 * automatically, even if they _do_ support per-port
			 * power switching; they're allowed to just limit the
			 * current.  khubd will turn the power back on.
			 */
838
			if ((temp & PORT_OC) && HCS_PPC(ehci->hcs_params)) {
839 840 841
				ehci_writel(ehci,
					temp & ~(PORT_RWC_BITS | PORT_POWER),
					status_reg);
842
				temp = ehci_readl(ehci, status_reg);
843 844 845
			}
		}

L
Linus Torvalds 已提交
846
		/* whoever resumes must GetPortStatus to complete it!! */
847 848 849 850 851 852 853 854 855 856 857
		if (temp & PORT_RESUME) {

			/* Remote Wakeup received? */
			if (!ehci->reset_done[wIndex]) {
				/* resume signaling for 20 msec */
				ehci->reset_done[wIndex] = jiffies
						+ msecs_to_jiffies(20);
				/* check the port again */
				mod_timer(&ehci_to_hcd(ehci)->rh_timer,
						ehci->reset_done[wIndex]);
			}
L
Linus Torvalds 已提交
858

859 860 861
			/* resume completed? */
			else if (time_after_eq(jiffies,
					ehci->reset_done[wIndex])) {
862
				clear_bit(wIndex, &ehci->suspended_ports);
863
				set_bit(wIndex, &ehci->port_c_suspend);
864 865 866 867 868
				ehci->reset_done[wIndex] = 0;

				/* stop resume signaling */
				temp = ehci_readl(ehci, status_reg);
				ehci_writel(ehci,
869 870
					temp & ~(PORT_RWC_BITS | PORT_RESUME),
					status_reg);
871
				clear_bit(wIndex, &ehci->resuming_ports);
872
				retval = handshake(ehci, status_reg,
873
					   PORT_RESUME, 0, 2000 /* 2msec */);
874 875 876 877 878 879 880
				if (retval != 0) {
					ehci_err(ehci,
						"port %d resume error %d\n",
						wIndex + 1, retval);
					goto error;
				}
				temp &= ~(PORT_SUSPEND|PORT_RESUME|(3<<10));
L
Linus Torvalds 已提交
881 882 883 884 885
			}
		}

		/* whoever resets must GetPortStatus to complete it!! */
		if ((temp & PORT_RESET)
886 887
				&& time_after_eq(jiffies,
					ehci->reset_done[wIndex])) {
888
			status |= USB_PORT_STAT_C_RESET << 16;
L
Linus Torvalds 已提交
889
			ehci->reset_done [wIndex] = 0;
890
			clear_bit(wIndex, &ehci->resuming_ports);
L
Linus Torvalds 已提交
891 892

			/* force reset to complete */
893
			ehci_writel(ehci, temp & ~(PORT_RWC_BITS | PORT_RESET),
894
					status_reg);
895 896 897
			/* REVISIT:  some hardware needs 550+ usec to clear
			 * this bit; seems too long to spin routinely...
			 */
898
			retval = handshake(ehci, status_reg,
899
					PORT_RESET, 0, 1000);
L
Linus Torvalds 已提交
900 901 902 903 904 905 906
			if (retval != 0) {
				ehci_err (ehci, "port %d reset error %d\n",
					wIndex + 1, retval);
				goto error;
			}

			/* see what we found out */
907 908
			temp = check_reset_complete (ehci, wIndex, status_reg,
					ehci_readl(ehci, status_reg));
L
Linus Torvalds 已提交
909 910
		}

911
		if (!(temp & (PORT_RESUME|PORT_RESET))) {
912
			ehci->reset_done[wIndex] = 0;
913 914
			clear_bit(wIndex, &ehci->resuming_ports);
		}
915

916 917 918 919 920 921 922 923 924 925
		/* transfer dedicated ports to the companion hc */
		if ((temp & PORT_CONNECT) &&
				test_bit(wIndex, &ehci->companion_ports)) {
			temp &= ~PORT_RWC_BITS;
			temp |= PORT_OWNER;
			ehci_writel(ehci, temp, status_reg);
			ehci_dbg(ehci, "port %d --> companion\n", wIndex + 1);
			temp = ehci_readl(ehci, status_reg);
		}

926 927 928 929 930 931 932
		/*
		 * Even if OWNER is set, there's no harm letting khubd
		 * see the wPortStatus values (they should all be 0 except
		 * for PORT_POWER anyway).
		 */

		if (temp & PORT_CONNECT) {
933
			status |= USB_PORT_STAT_CONNECTION;
934
			// status may be from integrated TT
935 936 937 938 939
			if (ehci->has_hostpc) {
				temp1 = ehci_readl(ehci, hostpc_reg);
				status |= ehci_port_speed(ehci, temp1);
			} else
				status |= ehci_port_speed(ehci, temp);
L
Linus Torvalds 已提交
940
		}
941
		if (temp & PORT_PE)
942
			status |= USB_PORT_STAT_ENABLE;
943 944 945

		/* maybe the port was unsuspended without our knowledge */
		if (temp & (PORT_SUSPEND|PORT_RESUME)) {
946
			status |= USB_PORT_STAT_SUSPEND;
947 948
		} else if (test_bit(wIndex, &ehci->suspended_ports)) {
			clear_bit(wIndex, &ehci->suspended_ports);
949
			clear_bit(wIndex, &ehci->resuming_ports);
950 951 952 953 954
			ehci->reset_done[wIndex] = 0;
			if (temp & PORT_PE)
				set_bit(wIndex, &ehci->port_c_suspend);
		}

955
		if (temp & PORT_OC)
956
			status |= USB_PORT_STAT_OVERCURRENT;
957
		if (temp & PORT_RESET)
958
			status |= USB_PORT_STAT_RESET;
959
		if (temp & PORT_POWER)
960
			status |= USB_PORT_STAT_POWER;
961
		if (test_bit(wIndex, &ehci->port_c_suspend))
962
			status |= USB_PORT_STAT_C_SUSPEND << 16;
L
Linus Torvalds 已提交
963

D
David Brownell 已提交
964
#ifndef	VERBOSE_DEBUG
L
Linus Torvalds 已提交
965 966 967
	if (status & ~0xffff)	/* only if wPortChange is interesting */
#endif
		dbg_port (ehci, "GetStatus", wIndex + 1, temp);
968
		put_unaligned_le32(status, buf);
L
Linus Torvalds 已提交
969 970 971 972 973 974 975 976 977 978 979 980
		break;
	case SetHubFeature:
		switch (wValue) {
		case C_HUB_LOCAL_POWER:
		case C_HUB_OVER_CURRENT:
			/* no hub-wide feature/status flags */
			break;
		default:
			goto error;
		}
		break;
	case SetPortFeature:
981 982
		selector = wIndex >> 8;
		wIndex &= 0xff;
983 984 985 986 987 988 989 990 991
		if (unlikely(ehci->debug)) {
			/* If the debug port is active any port
			 * feature requests should get denied */
			if (wIndex == HCS_DEBUG_PORT(ehci->hcs_params) &&
			    (readl(&ehci->debug->control) & DBGP_ENABLED)) {
				retval = -ENODEV;
				goto error_exit;
			}
		}
L
Linus Torvalds 已提交
992 993 994
		if (!wIndex || wIndex > ports)
			goto error;
		wIndex--;
995
		temp = ehci_readl(ehci, status_reg);
L
Linus Torvalds 已提交
996 997 998
		if (temp & PORT_OWNER)
			break;

D
David Brownell 已提交
999
		temp &= ~PORT_RWC_BITS;
L
Linus Torvalds 已提交
1000 1001
		switch (wValue) {
		case USB_PORT_FEAT_SUSPEND:
D
David Brownell 已提交
1002 1003
			if (ehci->no_selective_suspend)
				break;
L
Linus Torvalds 已提交
1004 1005 1006
			if ((temp & PORT_PE) == 0
					|| (temp & PORT_RESET) != 0)
				goto error;
1007

1008 1009 1010 1011
			/* After above check the port must be connected.
			 * Set appropriate bit thus could put phy into low power
			 * mode if we have hostpc feature
			 */
1012 1013 1014
			temp &= ~PORT_WKCONN_E;
			temp |= PORT_WKDISC_E | PORT_WKOC_E;
			ehci_writel(ehci, temp | PORT_SUSPEND, status_reg);
1015
			if (ehci->has_hostpc) {
1016
				spin_unlock_irqrestore(&ehci->lock, flags);
1017
				msleep(5);/* 5ms for HCD enter low pwr mode */
1018
				spin_lock_irqsave(&ehci->lock, flags);
1019 1020 1021 1022 1023 1024 1025 1026
				temp1 = ehci_readl(ehci, hostpc_reg);
				ehci_writel(ehci, temp1 | HOSTPC_PHCD,
					hostpc_reg);
				temp1 = ehci_readl(ehci, hostpc_reg);
				ehci_dbg(ehci, "Port%d phy low pwr mode %s\n",
					wIndex, (temp1 & HOSTPC_PHCD) ?
					"succeeded" : "failed");
			}
1027
			set_bit(wIndex, &ehci->suspended_ports);
L
Linus Torvalds 已提交
1028 1029 1030
			break;
		case USB_PORT_FEAT_POWER:
			if (HCS_PPC (ehci->hcs_params))
1031
				ehci_writel(ehci, temp | PORT_POWER,
1032
						status_reg);
L
Linus Torvalds 已提交
1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059
			break;
		case USB_PORT_FEAT_RESET:
			if (temp & PORT_RESUME)
				goto error;
			/* line status bits may report this as low speed,
			 * which can be fine if this root hub has a
			 * transaction translator built in.
			 */
			if ((temp & (PORT_PE|PORT_CONNECT)) == PORT_CONNECT
					&& !ehci_is_TDI(ehci)
					&& PORT_USB11 (temp)) {
				ehci_dbg (ehci,
					"port %d low speed --> companion\n",
					wIndex + 1);
				temp |= PORT_OWNER;
			} else {
				ehci_vdbg (ehci, "port %d reset\n", wIndex + 1);
				temp |= PORT_RESET;
				temp &= ~PORT_PE;

				/*
				 * caller must wait, then call GetPortStatus
				 * usb 2.0 spec says 50 ms resets on root
				 */
				ehci->reset_done [wIndex] = jiffies
						+ msecs_to_jiffies (50);
			}
1060
			ehci_writel(ehci, temp, status_reg);
L
Linus Torvalds 已提交
1061
			break;
1062 1063 1064 1065 1066 1067 1068 1069 1070 1071

		/* For downstream facing ports (these):  one hub port is put
		 * into test mode according to USB2 11.24.2.13, then the hub
		 * must be reset (which for root hub now means rmmod+modprobe,
		 * or else system reboot).  See EHCI 2.3.9 and 4.14 for info
		 * about the EHCI-specific stuff.
		 */
		case USB_PORT_FEAT_TEST:
			if (!selector || selector > 5)
				goto error;
A
Alan Stern 已提交
1072
			spin_unlock_irqrestore(&ehci->lock, flags);
1073
			ehci_quiesce(ehci);
A
Alan Stern 已提交
1074
			spin_lock_irqsave(&ehci->lock, flags);
1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085

			/* Put all enabled ports into suspend */
			while (ports--) {
				u32 __iomem *sreg =
						&ehci->regs->port_status[ports];

				temp = ehci_readl(ehci, sreg) & ~PORT_RWC_BITS;
				if (temp & PORT_PE)
					ehci_writel(ehci, temp | PORT_SUSPEND,
							sreg);
			}
A
Alan Stern 已提交
1086 1087

			spin_unlock_irqrestore(&ehci->lock, flags);
1088
			ehci_halt(ehci);
A
Alan Stern 已提交
1089 1090
			spin_lock_irqsave(&ehci->lock, flags);

1091
			temp = ehci_readl(ehci, status_reg);
1092
			temp |= selector << 16;
1093
			ehci_writel(ehci, temp, status_reg);
1094 1095
			break;

L
Linus Torvalds 已提交
1096 1097 1098
		default:
			goto error;
		}
1099
		ehci_readl(ehci, &ehci->regs->command);	/* unblock posted writes */
L
Linus Torvalds 已提交
1100 1101 1102 1103 1104 1105 1106
		break;

	default:
error:
		/* "stall" on error */
		retval = -EPIPE;
	}
1107
error_exit:
L
Linus Torvalds 已提交
1108 1109 1110
	spin_unlock_irqrestore (&ehci->lock, flags);
	return retval;
}
1111

1112
static void ehci_relinquish_port(struct usb_hcd *hcd, int portnum)
1113 1114 1115 1116 1117 1118 1119 1120
{
	struct ehci_hcd		*ehci = hcd_to_ehci(hcd);

	if (ehci_is_TDI(ehci))
		return;
	set_owner(ehci, --portnum, PORT_OWNER);
}

1121
static int ehci_port_handed_over(struct usb_hcd *hcd, int portnum)
1122 1123 1124 1125 1126 1127 1128 1129 1130
{
	struct ehci_hcd		*ehci = hcd_to_ehci(hcd);
	u32 __iomem		*reg;

	if (ehci_is_TDI(ehci))
		return 0;
	reg = &ehci->regs->port_status[portnum - 1];
	return ehci_readl(ehci, reg) & PORT_OWNER;
}