source: mainline/uspace/drv/bus/usb/xhci/main.c@ 1ea0bbf

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 1ea0bbf was 6832245, checked in by Ondřej Hlavatý <aearsis@…>, 8 years ago

usbhost bus: refactor the bus ops

This way, method names better represent the entity it is working with.
Their semantics was shifted a bit.

Regarding the tree of structures:

bus ← device ← endpoint ← batch

Previously, devices were kept in DDF function nodes, and endpoints had
pointer to the bus and device. Now, devices have pointer to bus,
endpoints don't.

Pointer to hcd_t in bus is WIP, and will be removed.

  • Property mode set to 100644
File size: 5.0 KB
Line 
1/*
2 * Copyright (c) 2017 Ondrej Hlavaty <aearsis@eideo.cz>
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 drvusbxhci
30 * @{
31 */
32/** @file
33 * Main routines of XHCI driver.
34 */
35
36#include <ddf/driver.h>
37#include <errno.h>
38#include <io/log.h>
39#include <io/logctl.h>
40#include <usb/debug.h>
41#include <usb/host/ddf_helpers.h>
42
43#include "hc.h"
44#include "rh.h"
45#include "endpoint.h"
46
47#define NAME "xhci"
48
49static int hc_driver_init(hcd_t *, const hw_res_list_parsed_t *, ddf_dev_t *);
50static int hcd_irq_code_gen(irq_code_t *, hcd_t *, const hw_res_list_parsed_t *);
51static int hcd_claim(hcd_t *, ddf_dev_t *);
52static int hcd_start(hcd_t *, bool);
53static int hcd_status(hcd_t *, uint32_t *);
54static void hcd_interrupt(hcd_t *, uint32_t);
55static int hcd_schedule(hcd_t *, usb_transfer_batch_t *);
56static void hc_driver_fini(hcd_t *);
57
58static const ddf_hc_driver_t xhci_ddf_hc_driver = {
59 .name = "XHCI-PCI",
60 .init = hc_driver_init,
61 .irq_code_gen = hcd_irq_code_gen,
62 .claim = hcd_claim,
63 .start = hcd_start,
64 .setup_root_hub = NULL,
65 .fini = hc_driver_fini,
66 .ops = {
67 .schedule = hcd_schedule,
68 .irq_hook = hcd_interrupt,
69 .status_hook = hcd_status,
70 }
71};
72
73static int hc_driver_init(hcd_t *hcd, const hw_res_list_parsed_t *hw_res, ddf_dev_t *device)
74{
75 int err;
76
77 xhci_hc_t *hc = malloc(sizeof(xhci_hc_t));
78 if (!hc)
79 return ENOMEM;
80
81 if ((err = hc_init_mmio(hc, hw_res)))
82 goto err;
83
84 hc->hcd = hcd;
85
86 if ((err = hc_init_memory(hc, device)))
87 goto err;
88
89 hcd_set_implementation(hcd, hc, &xhci_ddf_hc_driver.ops, &hc->bus.base);
90
91 return EOK;
92err:
93 free(hc);
94 return err;
95}
96
97static int hcd_irq_code_gen(irq_code_t *code, hcd_t *hcd, const hw_res_list_parsed_t *hw_res)
98{
99 xhci_hc_t *hc = hcd_get_driver_data(hcd);
100 assert(hc);
101
102 return hc_irq_code_gen(code, hc, hw_res);
103}
104
105static int hcd_claim(hcd_t *hcd, ddf_dev_t *dev)
106{
107 xhci_hc_t *hc = hcd_get_driver_data(hcd);
108 assert(hc);
109
110 return hc_claim(hc, dev);
111}
112
113static int hcd_start(hcd_t *hcd, bool irq)
114{
115 xhci_hc_t *hc = hcd_get_driver_data(hcd);
116 assert(hc);
117
118 return hc_start(hc, irq);
119}
120
121static int hcd_schedule(hcd_t *hcd, usb_transfer_batch_t *batch)
122{
123 xhci_hc_t *hc = hcd_get_driver_data(hcd);
124 assert(hc);
125
126 return hc_schedule(hc, batch);
127}
128
129static int hcd_status(hcd_t *hcd, uint32_t *status)
130{
131 xhci_hc_t *hc = hcd_get_driver_data(hcd);
132 assert(hc);
133 assert(status);
134
135 return hc_status(hc, status);
136}
137
138static void hcd_interrupt(hcd_t *hcd, uint32_t status)
139{
140 xhci_hc_t *hc = hcd_get_driver_data(hcd);
141 assert(hc);
142
143 hc_interrupt(hc, status);
144}
145
146static void hc_driver_fini(hcd_t *hcd)
147{
148 xhci_hc_t *hc = hcd_get_driver_data(hcd);
149 assert(hc);
150
151 hc_fini(hc);
152
153 free(hc);
154}
155
156/** Initializes a new ddf driver instance of XHCI hcd.
157 *
158 * @param[in] device DDF instance of the device to initialize.
159 * @return Error code.
160 */
161static int xhci_dev_add(ddf_dev_t *device)
162{
163 usb_log_info("Adding device %s", ddf_dev_get_name(device));
164 return hcd_ddf_add_hc(device, &xhci_ddf_hc_driver);
165}
166
167static int xhci_fun_online(ddf_fun_t *fun)
168{
169 return hcd_ddf_device_online(fun);
170}
171
172static int xhci_fun_offline(ddf_fun_t *fun)
173{
174 return hcd_ddf_device_offline(fun);
175}
176
177
178static const driver_ops_t xhci_driver_ops = {
179 .dev_add = xhci_dev_add,
180 .fun_online = xhci_fun_online,
181 .fun_offline = xhci_fun_offline
182};
183
184static const driver_t xhci_driver = {
185 .name = NAME,
186 .driver_ops = &xhci_driver_ops
187};
188
189
190/** Initializes global driver structures (NONE).
191 *
192 * @param[in] argc Nmber of arguments in argv vector (ignored).
193 * @param[in] argv Cmdline argument vector (ignored).
194 * @return Error code.
195 *
196 * Driver debug level is set here.
197 */
198int main(int argc, char *argv[])
199{
200 log_init(NAME);
201 logctl_set_log_level(NAME, LVL_DEBUG2);
202 return ddf_driver_main(&xhci_driver);
203}
204
205/**
206 * @}
207 */
Note: See TracBrowser for help on using the repository browser.