source: mainline/uspace/drv/uhci-hcd/uhci_rh.c@ 2bf8f8c

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

Doxygen

  • Property mode set to 100644
File size: 2.8 KB
Line 
1/*
2 * Copyright (c) 2011 Jan Vesely
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/** @addtogroup drvusbuhci
29 * @{
30 */
31/** @file
32 * @brief UHCI driver
33 */
34#include <assert.h>
35#include <errno.h>
36#include <str_error.h>
37#include <stdio.h>
38
39#include <usb/debug.h>
40
41#include "uhci_rh.h"
42#include "uhci_hc.h"
43
44/** Root hub initialization
45 * @param[in] instance RH structure to initialize
46 * @param[in] fun DDF function representing UHCI root hub
47 * @param[in] reg_addr Address of root hub status and control registers.
48 * @param[in] reg_size Size of accessible address space.
49 * @return Error code.
50 */
51int uhci_rh_init(
52 uhci_rh_t *instance, ddf_fun_t *fun, uintptr_t reg_addr, size_t reg_size)
53{
54 assert(fun);
55
56 char *match_str = NULL;
57 int ret = asprintf(&match_str, "usb&uhci&root-hub");
58 if (ret < 0) {
59 usb_log_error("Failed to create root hub match string.\n");
60 return ENOMEM;
61 }
62
63 ret = ddf_fun_add_match_id(fun, match_str, 100);
64 if (ret != EOK) {
65 usb_log_error("Failed(%d) to add root hub match id: %s\n",
66 ret, str_error(ret));
67 return ret;
68 }
69
70 hw_resource_list_t *resource_list = &instance->resource_list;
71 resource_list->count = 1;
72 resource_list->resources = &instance->io_regs;
73 assert(resource_list->resources);
74 instance->io_regs.type = IO_RANGE;
75 instance->io_regs.res.io_range.address = reg_addr;
76 instance->io_regs.res.io_range.size = reg_size;
77 instance->io_regs.res.io_range.endianness = LITTLE_ENDIAN;
78
79 return EOK;
80}
81/**
82 * @}
83 */
Note: See TracBrowser for help on using the repository browser.