source: mainline/uspace/drv/bus/usb/usbmid/usbmid.c@ 27ed734c

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 27ed734c was 27ed734c, checked in by Jan Vesely <jano.vesely@…>, 14 years ago

usb: Rename get_address ⇒ get_my_address and remove redundant handle parameter.

If you want to know what address the device uses ask the device not host controller.

  • Property mode set to 100644
File size: 4.3 KB
Line 
1/*
2 * Copyright (c) 2011 Vojtech Horky
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup drvusbmid
30 * @{
31 */
32/**
33 * @file
34 * Helper functions.
35 */
36#include <errno.h>
37#include <str_error.h>
38#include <stdlib.h>
39#include <usb_iface.h>
40#include <usb/ddfiface.h>
41#include <usb/dev/pipes.h>
42#include <usb/classes/classes.h>
43#include <usb/dev/recognise.h>
44#include "usbmid.h"
45
46/** Callback for DDF USB interface. */
47static int usb_iface_get_interface_impl(ddf_fun_t *fun, devman_handle_t handle,
48 int *iface_no)
49{
50 assert(fun);
51
52 usbmid_interface_t *iface = fun->driver_data;
53 assert(iface);
54
55 if (iface_no != NULL) {
56 *iface_no = iface->interface_no;
57 }
58
59 return EOK;
60}
61
62/** DDF interface of the child - interface function. */
63static usb_iface_t child_usb_iface = {
64 .get_hc_handle = usb_iface_get_hc_handle_device_impl,
65 .get_my_address = usb_iface_get_my_address_forward_impl,
66 .get_interface = usb_iface_get_interface_impl,
67};
68
69/** Operations for children - interface functions. */
70static ddf_dev_ops_t child_device_ops = {
71 .interfaces[USB_DEV_IFACE] = &child_usb_iface
72};
73
74int usbmid_interface_destroy(usbmid_interface_t *mid_iface)
75{
76 assert(mid_iface);
77 assert_link_not_used(&mid_iface->link);
78 const int ret = ddf_fun_unbind(mid_iface->fun);
79 if (ret != EOK) {
80 return ret;
81 }
82 /* NOTE: usbmid->interface points somewhere, but we did not
83 * allocate that space, so don't touch */
84 ddf_fun_destroy(mid_iface->fun);
85 /* NOTE: mid_iface is invalid at this point, it was assigned to
86 * mid_iface->fun->driver_data and freed in ddf_fun_destroy */
87 return EOK;
88}
89
90/** Spawn new child device from one interface.
91 *
92 * @param parent Parent MID device.
93 * @param iface Interface information.
94 * @param device_descriptor Device descriptor.
95 * @param interface_descriptor Interface descriptor.
96 * @return Error code.
97 */
98int usbmid_spawn_interface_child(usb_device_t *parent,
99 usbmid_interface_t *iface,
100 const usb_standard_device_descriptor_t *device_descriptor,
101 const usb_standard_interface_descriptor_t *interface_descriptor)
102{
103 ddf_fun_t *child = NULL;
104 char *child_name = NULL;
105 int rc;
106
107 /*
108 * Name is class name followed by interface number.
109 * The interface number shall provide uniqueness while the
110 * class name something humanly understandable.
111 */
112 rc = asprintf(&child_name, "%s%hhu",
113 usb_str_class(interface_descriptor->interface_class),
114 interface_descriptor->interface_number);
115 if (rc < 0) {
116 return ENOMEM;
117 }
118
119 /* Create the device. */
120 child = ddf_fun_create(parent->ddf_dev, fun_inner, child_name);
121 free(child_name);
122 if (child == NULL) {
123 return ENOMEM;
124 }
125
126 iface->fun = child;
127
128 child->driver_data = iface;
129 child->ops = &child_device_ops;
130
131 rc = usb_device_create_match_ids_from_interface(device_descriptor,
132 interface_descriptor, &child->match_ids);
133 if (rc != EOK) {
134 ddf_fun_destroy(child);
135 return rc;
136 }
137
138 rc = ddf_fun_bind(child);
139 if (rc != EOK) {
140 /* This takes care of match_id deallocation as well. */
141 ddf_fun_destroy(child);
142 return rc;
143 }
144
145 return EOK;
146}
147
148/**
149 * @}
150 */
Note: See TracBrowser for help on using the repository browser.