otg.c 3.8 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
/*
 * otg.c -- USB OTG utility code
 *
 * Copyright (C) 2004 Texas Instruments
 *
 * 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.
 */

#include <linux/kernel.h>
13
#include <linux/export.h>
14
#include <linux/err.h>
15 16 17 18
#include <linux/device.h>

#include <linux/usb/otg.h>

19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
static LIST_HEAD(phy_list);
static DEFINE_SPINLOCK(phy_lock);

static struct usb_phy *__usb_find_phy(struct list_head *list,
	enum usb_phy_type type)
{
	struct usb_phy  *phy = NULL;

	list_for_each_entry(phy, list, head) {
		if (phy->type != type)
			continue;

		return phy;
	}

	return ERR_PTR(-ENODEV);
}
36 37

/**
38 39
 * usb_get_phy - find the USB PHY
 * @type - the type of the phy the controller requires
40
 *
41 42 43
 * Returns the phy driver, after getting a refcount to it; or
 * null if there is no such phy.  The caller is responsible for
 * calling usb_put_phy() to release that count.
44 45 46
 *
 * For use by USB host and peripheral drivers.
 */
47
struct usb_phy *usb_get_phy(enum usb_phy_type type)
48
{
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
	struct usb_phy	*phy = NULL;
	unsigned long	flags;

	spin_lock_irqsave(&phy_lock, flags);

	phy = __usb_find_phy(&phy_list, type);
	if (IS_ERR(phy)) {
		pr_err("unable to find transceiver of type %s\n",
			usb_phy_type_string(type));
		return phy;
	}

	get_device(phy->dev);

	spin_unlock_irqrestore(&phy_lock, flags);

65
	return phy;
66
}
67
EXPORT_SYMBOL(usb_get_phy);
68 69

/**
70
 * usb_put_phy - release the USB PHY
71
 * @x: the phy returned by usb_get_phy()
72
 *
73
 * Releases a refcount the caller received from usb_get_phy().
74 75 76
 *
 * For use by USB host and peripheral drivers.
 */
77
void usb_put_phy(struct usb_phy *x)
78
{
79 80
	if (x)
		put_device(x->dev);
81
}
82
EXPORT_SYMBOL(usb_put_phy);
83 84

/**
85
 * usb_add_phy - declare the USB PHY
86
 * @x: the USB phy to be used; or NULL
87
 * @type - the type of this PHY
88
 *
89
 * This call is exclusively for use by phy drivers, which
90 91 92
 * coordinate the activities of drivers for host and peripheral
 * controllers, and in some cases for VBUS current regulation.
 */
93
int usb_add_phy(struct usb_phy *x, enum usb_phy_type type)
94
{
95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
	int		ret = 0;
	unsigned long	flags;
	struct usb_phy	*phy;

	if (x && x->type != USB_PHY_TYPE_UNDEFINED) {
		dev_err(x->dev, "not accepting initialized PHY %s\n", x->label);
		return -EINVAL;
	}

	spin_lock_irqsave(&phy_lock, flags);

	list_for_each_entry(phy, &phy_list, head) {
		if (phy->type == type) {
			ret = -EBUSY;
			dev_err(x->dev, "transceiver type %s already exists\n",
						usb_phy_type_string(type));
			goto out;
		}
	}

	x->type = type;
	list_add_tail(&x->head, &phy_list);

out:
	spin_unlock_irqrestore(&phy_lock, flags);
	return ret;
121
}
122
EXPORT_SYMBOL(usb_add_phy);
123

124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140
/**
 * usb_remove_phy - remove the OTG PHY
 * @x: the USB OTG PHY to be removed;
 *
 * This reverts the effects of usb_add_phy
 */
void usb_remove_phy(struct usb_phy *x)
{
	unsigned long	flags;

	spin_lock_irqsave(&phy_lock, flags);
	if (x)
		list_del(&x->head);
	spin_unlock_irqrestore(&phy_lock, flags);
}
EXPORT_SYMBOL(usb_remove_phy);

141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174
const char *otg_state_string(enum usb_otg_state state)
{
	switch (state) {
	case OTG_STATE_A_IDLE:
		return "a_idle";
	case OTG_STATE_A_WAIT_VRISE:
		return "a_wait_vrise";
	case OTG_STATE_A_WAIT_BCON:
		return "a_wait_bcon";
	case OTG_STATE_A_HOST:
		return "a_host";
	case OTG_STATE_A_SUSPEND:
		return "a_suspend";
	case OTG_STATE_A_PERIPHERAL:
		return "a_peripheral";
	case OTG_STATE_A_WAIT_VFALL:
		return "a_wait_vfall";
	case OTG_STATE_A_VBUS_ERR:
		return "a_vbus_err";
	case OTG_STATE_B_IDLE:
		return "b_idle";
	case OTG_STATE_B_SRP_INIT:
		return "b_srp_init";
	case OTG_STATE_B_PERIPHERAL:
		return "b_peripheral";
	case OTG_STATE_B_WAIT_ACON:
		return "b_wait_acon";
	case OTG_STATE_B_HOST:
		return "b_host";
	default:
		return "UNDEFINED";
	}
}
EXPORT_SYMBOL(otg_state_string);