osd-contiki/cpu/arm/common/usb/usb-api.h

146 lines
3.9 KiB
C

#ifndef USB_API_H_SYN81IFYBN__
#define USB_API_H_SYN81IFYBN__
#include <sys/process.h>
typedef struct _USBBuffer USBBuffer;
struct _USBBuffer
{
USBBuffer *next; /* Pointer to next buffer in chain */
uint8_t *data; /* Where to read/write data next */
uint16_t left; /* Remaining length of buffer. */
uint16_t flags;
uint32_t id; /* User data */
};
/* Buffer owned by the USB code, cleared when done */
#define USB_BUFFER_SUBMITTED 0x01
/* Write a short packet at end of buffer or release buffer when a
short packet is received. */
#define USB_BUFFER_SHORT_END 0x02
/* Release buffer as soon as any received data has been written in it. */
#define USB_BUFFER_PACKET_END 0x04
/* Notify the user when the buffer is released */
#define USB_BUFFER_NOTIFY 0x08
/* Packet should be sent to host. */
#define USB_BUFFER_IN 0x40
/* Used for receiving SETUP packets. If a SETUP packet is received and
the next buffers doesn't have this flag set, they will be skipped
until one is found. The associated buffer must be at least 8 bytes */
#define USB_BUFFER_SETUP 0x20
/* HALT the endpoint at this point. Only valid for bulk and interrupt
endpoints */
#define USB_BUFFER_HALT 0x100
/* Flags set by system */
/* The last packet written to this buffer was short. */
#define USB_BUFFER_SHORT_PACKET 0x10
/* The operation associated with this buffer failed. I.e. it was discarded since it didn't match the received SETUP packet. */
#define USB_BUFFER_FAILED 0x80
/* Architecture specific flags */
#define USB_BUFFER_ARCH_FLAG_1 0x1000
#define USB_BUFFER_ARCH_FLAG_2 0x2000
#define USB_BUFFER_ARCH_FLAG_3 0x4000
#define USB_BUFFER_ARCH_FLAG_4 0x8000
void
usb_setup(void);
/* Read only */
struct USBRequestHandler
{
uint8_t request_type;
uint8_t request_type_mask;
uint8_t request;
uint8_t request_mask;
/* Returns true if it handled the request, if false let another handler try*/
unsigned int (*handler_func)();
};
/* Must be writeable */
struct USBRequestHandlerHook
{
struct USBRequestHandlerHook *next;
const struct USBRequestHandler * const handler;
};
void
usb_register_request_handler(struct USBRequestHandlerHook *hook);
void
usb_prepend_request_handler(struct USBRequestHandlerHook *hook);
void
usb_setup_bulk_endpoint(uint8_t addr);
void
usb_setup_interrupt_endpoint(uint8_t addr);
/* Submit a chain of buffers to be filled with received data. Last
buffer must have next set to NULL. */
void
usb_submit_recv_buffer(uint8_t ep_addr, USBBuffer *buffer);
/* Submit a chain of buffers to be sent. Last buffer must have next
set to NULL. When submitting packets to receive or send data in on
a control enpoint, all packets in the data stage must be submitted
at the same time. */
void
usb_submit_xmit_buffer(uint8_t ep_addr, USBBuffer *buffer);
/* Return true if not all data has been sent to the host */
int
usb_send_pending(uint8_t ep_addr);
/* Release all buffers submitted to the endpoint and discard any
buffered data. */
void
usb_discard_all_buffers(uint8_t ep_addr);
void
usb_disable_endpoint(uint8_t addr);
/* Set or remove a HALT condition on an endpoint */
void
usb_halt_endpoint(uint8_t addr, int halt);
/* Select what process should be polled when buffers with the
USB_BUFFER_NOTIFY flag set is released from the endpoint */
void
usb_set_ep_event_process(uint8_t addr, struct process *p);
/* Select what process should be polled when a global event occurs */
void
usb_set_global_event_process(struct process *p);
/* Global events */
#define USB_EVENT_CONFIG 0x01
#define USB_EVENT_SUSPEND 0x02
#define USB_EVENT_RESUME 0x04
#define USB_EVENT_RESET 0x08
/* Returns global events that has occured since last time this
function was called */
unsigned int
usb_get_global_events(void);
#define USB_EP_EVENT_NOTIFICATION 0x01
unsigned int
usb_get_ep_events(uint8_t addr);
unsigned int
usb_get_current_configuration(void);
#endif /* USB_API_H_SYN81IFYBN__ */