mirror of
https://github.com/Rockbox/rockbox.git
synced 2026-10-10 08:03:04 -04:00
2291aa24f2
this commit is a combination of the following changes, which significantly refactors usb core and class drivers. 1. unify usb buffers of each class driver to reduce iram usage currently, many class drivers allocate their own buffer to receive control out data, which is a waste of iram. share one common buffer for that usage to address the issue. 2. simplify control request handling by implicitly receiving write request data packets change 1 above fixed the data destination. therefore, having the core receive the data allows us to reduce the class driver's work and simplifies the api. 3. enhance usb core's control request handling and unify the legacy driver api in order to implement change 2, both the legacy and new driver apis should be supported. so that, using the designware driver as a reference, the new driver api functionality is move into usb core. this simplifies the usb device drivers by requiring them to implement only the functionalities equivalent to the legacy api. tested with ipodvideo(arc) and erosqnative(designware) Change-Id: I3627daa90278751f599e2108ec150ec3f8f6c524
78 lines
2.4 KiB
C
78 lines
2.4 KiB
C
/***************************************************************************
|
|
* __________ __ ___.
|
|
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
|
|
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
|
|
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
|
|
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
|
|
* \/ \/ \/ \/ \/
|
|
* $Id$
|
|
*
|
|
* Copyright (C) 2007 by Björn Stenberg
|
|
*
|
|
* This program is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU General Public License
|
|
* as published by the Free Software Foundation; either version 2
|
|
* of the License, or (at your option) any later version.
|
|
*
|
|
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
|
* KIND, either express or implied.
|
|
*
|
|
****************************************************************************/
|
|
#ifndef USB_CORE_H
|
|
#define USB_CORE_H
|
|
|
|
#include "usb_ch9.h"
|
|
#include "usb.h"
|
|
|
|
/* endpoints */
|
|
#define EP_CONTROL 0
|
|
|
|
#define DIR_OUT 0
|
|
#define DIR_IN 1
|
|
|
|
/* The USB core is a device, and OUT is RX from that P.O.V */
|
|
#define DIR_RX DIR_OUT
|
|
#define DIR_TX DIR_IN
|
|
|
|
#define EP_DIR(ep) (((ep) & USB_ENDPOINT_DIR_MASK) ? DIR_IN : DIR_OUT)
|
|
#define EP_NUM(ep) ((ep) & USB_ENDPOINT_NUMBER_MASK)
|
|
|
|
extern int usb_max_pkt_size;
|
|
|
|
enum usb_control_response {
|
|
USB_CONTROL_ACK,
|
|
USB_CONTROL_STALL,
|
|
};
|
|
|
|
enum {
|
|
USB_STRING_INDEX_LANGUAGE,
|
|
USB_STRING_INDEX_MANUFACTURER,
|
|
USB_STRING_INDEX_PRODUCT,
|
|
USB_STRING_INDEX_SERIAL,
|
|
USB_STRING_INDEX_MAX,
|
|
};
|
|
|
|
struct usb_class_driver;
|
|
|
|
void usb_core_init(void);
|
|
void usb_core_exit(void);
|
|
void usb_core_setup_received(struct usb_ctrlrequest* req);
|
|
void usb_core_control_response(enum usb_control_response response, const void* data, size_t size);
|
|
void usb_core_transfer_complete(int endpoint,int dir,int status,int length);
|
|
void usb_core_bus_reset(void);
|
|
void usb_core_enable_driver(int driver,bool enabled);
|
|
bool usb_core_driver_enabled(int driver);
|
|
#ifdef HAVE_USBSTACK
|
|
void usb_core_handle_transfer_completion(
|
|
struct usb_transfer_completion_event_data* event);
|
|
#endif
|
|
void usb_core_handle_notify(long id, intptr_t data);
|
|
/* For controllers which handle SET ADDR and/or SET CONFIG in hardware */
|
|
void usb_core_notify_set_address(uint8_t addr);
|
|
void usb_core_notify_set_config(uint8_t config);
|
|
|
|
#ifdef HAVE_HOTSWAP
|
|
void usb_core_hotswap_event(int volume,bool inserted);
|
|
#endif
|
|
|
|
#endif
|