source: mainline/uspace/lib/usbvirt/private.h@ efedee77

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since efedee77 was aab02fb, checked in by Vojtech Horky <vojtechhorky@…>, 15 years ago

Debugging support for libusbvirt

Added methods debug and lib_debug to device structure to simplify
debugging. Each method gets as a parameter debug level describing
verbosity of the message and also message tag that allows filtering
based on message type (e.g. messages related to transactions, to
device requests etc.).

  • Property mode set to 100644
File size: 3.1 KB
RevLine 
[bc9a629]1/*
2 * Copyright (c) 2010 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
[b8100da]29/** @addtogroup libusbvirt usb
[bc9a629]30 * @{
31 */
32/** @file
[b8100da]33 * @brief Virtual USB private header.
[bc9a629]34 */
[b8100da]35#ifndef LIBUSBVIRT_PRIVATE_H_
36#define LIBUSBVIRT_PRIVATE_H_
[bc9a629]37
[b8100da]38#include "device.h"
39#include "hub.h"
[bc9a629]40
41
[4971812]42#define DEVICE_HAS_OP(dev, op) \
43 ( \
44 ( ((dev)->ops) != NULL ) \
45 && \
46 ( ((dev)->ops->op) != NULL ) \
47 )
[bc9a629]48
[b8100da]49int usbvirt_data_to_host(struct usbvirt_device *dev,
50 usb_endpoint_t endpoint, void *buffer, size_t size);
[bc9a629]51
[186d630]52int handle_incoming_data(struct usbvirt_device *dev,
53 usb_endpoint_t endpoint, void *buffer, size_t size);
[b8100da]54
[ca07cd3]55int control_pipe(usbvirt_device_t *device, usbvirt_control_transfer_t *transfer);
[bc9a629]56
[ca07cd3]57int handle_std_request(usbvirt_device_t *device, usb_device_request_setup_packet_t *request, uint8_t *data);
[4971812]58
[ca07cd3]59void device_callback_connection(usbvirt_device_t *device, ipc_callid_t iid, ipc_call_t *icall);
[954ea70]60
[7a7bfeb3]61int transaction_setup(usbvirt_device_t *device, usb_endpoint_t endpoint,
62 void *buffer, size_t size);
63int transaction_out(usbvirt_device_t *device, usb_endpoint_t endpoint,
64 void *buffer, size_t size);
65int transaction_in(usbvirt_device_t *device, usb_endpoint_t endpoint,
66 void *buffer, size_t size, size_t *data_size);
67
[aab02fb]68
69void user_debug(usbvirt_device_t *device, int level, uint8_t tag,
70 const char *format, ...);
71void lib_debug(usbvirt_device_t *device, int level, uint8_t tag,
72 const char *format, ...);
73
74static inline const char *str_device_state(usbvirt_device_state_t state)
75{
76 switch (state) {
77 case USBVIRT_STATE_DEFAULT:
78 return "default";
79 case USBVIRT_STATE_ADDRESS:
80 return "address";
81 case USBVIRT_STATE_CONFIGURED:
82 return "configured";
83 default:
84 return "unknown";
85 }
86}
87
[bc9a629]88#endif
89/**
90 * @}
91 */
Note: See TracBrowser for help on using the repository browser.