summaryrefslogtreecommitdiff
path: root/drivers/staging/greybus/es2.c
diff options
context:
space:
mode:
authorAlexandre Bailon <abailon@baylibre.com>2015-09-14 18:20:44 +0200
committerGreg Kroah-Hartman <gregkh@google.com>2015-09-14 22:09:32 -0700
commite5acf736caac014de39f618f7725164b75176fea (patch)
tree63659e8ad6714634946bd88a6209044798bd13a4 /drivers/staging/greybus/es2.c
parent64c9cabcac57904b8a6d6ae9e8a90c258762c86b (diff)
greybus: es2: add some documentation about endpoints mapping
Signed-off-by: Alexandre Bailon <abailon@baylibre.com> Reviewed-by: Viresh Kumar <viresh.kumar@linaro.org> Signed-off-by: Greg Kroah-Hartman <gregkh@google.com>
Diffstat (limited to 'drivers/staging/greybus/es2.c')
-rw-r--r--drivers/staging/greybus/es2.c10
1 files changed, 10 insertions, 0 deletions
diff --git a/drivers/staging/greybus/es2.c b/drivers/staging/greybus/es2.c
index ec06dc65f98d..834ccd4e23b8 100644
--- a/drivers/staging/greybus/es2.c
+++ b/drivers/staging/greybus/es2.c
@@ -108,6 +108,12 @@ struct es1_ap_dev {
int *cport_to_ep;
};
+/**
+ * cport_to_ep - information about cport to endpoints mapping
+ * @cport_id: the id of cport to map to endpoints
+ * @endpoint_in: the endpoint number to use for in transfer
+ * @endpoint_out: he endpoint number to use for out transfer
+ */
struct cport_to_ep {
__le16 cport_id;
__u8 endpoint_in;
@@ -123,6 +129,7 @@ static void cport_out_callback(struct urb *urb);
static void usb_log_enable(struct es1_ap_dev *es1);
static void usb_log_disable(struct es1_ap_dev *es1);
+/* Get the endpoints pair mapped to the cport */
static int cport_to_ep_pair(struct es1_ap_dev *es1, u16 cport_id)
{
if (cport_id >= es1->hd->num_cports)
@@ -132,6 +139,7 @@ static int cport_to_ep_pair(struct es1_ap_dev *es1, u16 cport_id)
#define ES1_TIMEOUT 500 /* 500 ms for the SVC to do something */
+/* Test if the endpoints pair is already mapped to a cport */
static int ep_pair_in_use(struct es1_ap_dev *es1, int ep_pair)
{
int i;
@@ -143,6 +151,7 @@ static int ep_pair_in_use(struct es1_ap_dev *es1, int ep_pair)
return 0;
}
+/* Configure the endpoint mapping and send the request to APBridge */
static int map_cport_to_ep(struct es1_ap_dev *es1,
u16 cport_id, int ep_pair)
{
@@ -180,6 +189,7 @@ static int map_cport_to_ep(struct es1_ap_dev *es1,
return retval;
}
+/* Unmap a cport: use the muxed endpoints pair */
static int unmap_cport(struct es1_ap_dev *es1, u16 cport_id)
{
return map_cport_to_ep(es1, cport_id, 0);