usb-api.h

#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__ */