245 lines
8.2 KiB
C
245 lines
8.2 KiB
C
|
/*****************************************************************************
|
||
|
|
|
||
|
|
USB-Template: User defined USB device
|
||
|
|
V1.1.0
|
||
|
|
|
||
|
|
(c) 2010-2011 Reusch Elektronik, Dipl.-Ing. (FH) Rainer Reusch
|
||
|
|
Homepage: http://products.reworld.eu/index.htm
|
||
|
|
|
||
|
|
Supported devices:
|
||
|
|
- AT90USB82, AT90USB162
|
||
|
|
- ATMEGA8U2, ATMEGA16U2, ATMEGA32U2
|
||
|
|
- ATMEGA8U4, ATMEGA16U4, ATMEGA32U4
|
||
|
|
- AT90USB646, AT90USB647, AT90USB1286, AT90USB1287
|
||
|
|
|
||
|
|
Supported modules:
|
||
|
|
- U2DIL-AT90USB162
|
||
|
|
- U2DIL-ATMEGA32U2
|
||
|
|
- U4DIL-ATMEGA32U4
|
||
|
|
- U6DIL-AT90USB1286
|
||
|
|
|
||
|
|
USB Configuration
|
||
|
|
|
||
|
|
Created: 2010-01-07
|
||
|
|
Changed: 2011-03-12
|
||
|
|
|
||
|
|
*****************************************************************************/
|
||
|
|
|
||
|
|
// in this file you will make changes for your purposes
|
||
|
|
|
||
|
|
#ifndef usbconfig_h__
|
||
|
|
#define usbconfig_h__
|
||
|
|
|
||
|
|
#if defined (__AVR_AT90USB82__) || (__AVR_AT90USB162__) || (__AVR_ATmega8U2__) || (__AVR_ATmega32U2__)
|
||
|
|
#define MEGA2 // AT90USB82/162, ATMEGAxxU2
|
||
|
|
#endif
|
||
|
|
#if defined (__AVR_ATmega16U4__) || (__AVR_ATmega32U4__)
|
||
|
|
#define MEGA4 // ATMEGAxxU4
|
||
|
|
#define MEGA4_6
|
||
|
|
#endif
|
||
|
|
#if defined (__AVR_AT90USB646__) || (__AVR_AT90USB647__) || (__AVR_AT90USB1286__) || (__AVR_AT90USB1287__)
|
||
|
|
#define MEGA6 // AT90USB646, -647, -1286, -1287
|
||
|
|
#define MEGA4_6
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include <stdint.h>
|
||
|
|
#include <stdbool.h>
|
||
|
|
#include "config.h"
|
||
|
|
|
||
|
|
#if (F_CPU==8000000)
|
||
|
|
#define FREQ_OK
|
||
|
|
#endif
|
||
|
|
#if (F_CPU==16000000)
|
||
|
|
#define FREQ_OK
|
||
|
|
#endif
|
||
|
|
#ifndef FREQ_OK
|
||
|
|
#error "Invalid clock frequency (only 8 or 16MHz)!"
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// General USB commitments
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// Vendor Name
|
||
|
|
// will be a part of the descriptor and can be requested by the host
|
||
|
|
#define STR_MANUFACTURER L"BlubbFish"
|
||
|
|
|
||
|
|
// Product Name
|
||
|
|
// will be a part of the descriptor and can be requested by the host
|
||
|
|
#define STR_PRODUCT L"Hacker-Jeopardy"
|
||
|
|
|
||
|
|
// USB Serial Number (optional)
|
||
|
|
// will be a part of the descriptor and can be requested by the host
|
||
|
|
#define USESN 1 // Options: 0= no S/N; 1= S/N inside the flash memory; 2= S/N inside RAM
|
||
|
|
#if (USESN==1)
|
||
|
|
#define STR_SERIAL_NUMBER L"000001" // your serial number, stored in flash memory
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// Vendor ID
|
||
|
|
// set your vendor ID here
|
||
|
|
#define VENDOR_ID 0xDEAD // !!! THIS ID IS NOT FOR OFFICIAL USE, FOR YOUR PERSONAL TESTING PURPOSES ONLY !!!
|
||
|
|
|
||
|
|
// Product ID
|
||
|
|
// set your product ID here
|
||
|
|
#define PRODUCT_ID 0xBEEE // !!! THIS ID IS NOT FOR OFFICIAL USE, FOR YOUR PERSONAL TESTING PURPOSES ONLY !!!
|
||
|
|
|
||
|
|
// USB device class
|
||
|
|
// possible settings:
|
||
|
|
#define USBDEVICECLASS_USER 0xFF // user defined class
|
||
|
|
// set the class for your purposes
|
||
|
|
#define USBDEVICECLASS USBDEVICECLASS_USER
|
||
|
|
|
||
|
|
// power supply
|
||
|
|
#define SELFPOWERED 0x40
|
||
|
|
#define BUSPOWERED 0x80
|
||
|
|
#define POWERING SELFPOWERED | BUSPOWERED // Alternatives: SELFPOWERED or SELFPOWERED | BUSPOWERED
|
||
|
|
|
||
|
|
// current consumption
|
||
|
|
// in mA (milliamperes), uses only even values between 2 and 500
|
||
|
|
#define MAXPOWER 500
|
||
|
|
|
||
|
|
#ifdef MEGA2
|
||
|
|
// The controllers AT90USB82/162 and ATMEGAxxU2 are not able, to detect a
|
||
|
|
// plugged USB connector (presence of VBUS voltage). As alternative an input
|
||
|
|
// port, which is connected with the 5V line of the USB connector, can be
|
||
|
|
// used. A pull down resistor at the input port is recommended.
|
||
|
|
// Uncomment the following line, if a port pin is used for this purpose.
|
||
|
|
//#define VBUSDETECT
|
||
|
|
#define VBUSDIR DDRC // Data Direction Register of the used port
|
||
|
|
#define VBUSPORT PINC // used port
|
||
|
|
#define VBUSPIN PC4 // used pin (PC4 as example)
|
||
|
|
#endif
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Data Set for a USB Control Request
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// Nothing to change here!
|
||
|
|
|
||
|
|
struct usb_control_request {
|
||
|
|
uint8_t bmRequestType;
|
||
|
|
uint8_t bRequest;
|
||
|
|
uint16_t wValue;
|
||
|
|
uint16_t wIndex;
|
||
|
|
uint16_t wLength;
|
||
|
|
};
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Endpoints
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// maximum number of endpoints (don't change!)
|
||
|
|
#ifdef MEGA4_6
|
||
|
|
#define MAX_ENDPOINT 6
|
||
|
|
#else
|
||
|
|
#define MAX_ENDPOINT 4
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// Constants for endpoint configuration (don't change!)
|
||
|
|
#define EP_TYPE_DISABLED 0xFF // endpoint not used
|
||
|
|
#define EP_TYPE_CONTROL 0x00
|
||
|
|
#define EP_TYPE_BULK_IN 0x81
|
||
|
|
#define EP_TYPE_BULK_OUT 0x80
|
||
|
|
#define EP_TYPE_INTERRUPT_IN 0xC1
|
||
|
|
#define EP_TYPE_INTERRUPT_OUT 0xC0
|
||
|
|
#define EP_TYPE_ISOCHRONOUS_IN 0x41
|
||
|
|
#define EP_TYPE_ISOCHRONOUS_OUT 0x40
|
||
|
|
#define EP_SINGLE_BUFFER 0x02
|
||
|
|
#define EP_DOUBLE_BUFFER 0x06
|
||
|
|
|
||
|
|
// Endpoint 0
|
||
|
|
// (for Control Transfers, must be defined always)
|
||
|
|
#define ENDPOINT0_SIZE 16 // control endpoint
|
||
|
|
// uncomment the following line to handle user defined control request
|
||
|
|
// of endpoint 0 in the main program
|
||
|
|
#define USERDEFCONTROLS // we will use self defined control transfers in this example
|
||
|
|
#ifdef USERDEFCONTROLS
|
||
|
|
// function prototype to handle user defined control requests.
|
||
|
|
// Function has to return "true", if request is handled.
|
||
|
|
// If result is "false", a "stall" will be returned to host.
|
||
|
|
bool usb_controlrequest(struct usb_control_request *ucr);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
typedef struct {
|
||
|
|
uint8_t ep_type; // transfer
|
||
|
|
uint8_t ep_size; // buffer size
|
||
|
|
uint8_t ep_buffer; // buffer configuration
|
||
|
|
} ep_config;
|
||
|
|
|
||
|
|
// configuration of the endpoints
|
||
|
|
// EP_TYPE constant, buffer size (8, 16, 32 or 64 byte), single or double buffer
|
||
|
|
|
||
|
|
// Hint: Use only two endpoints, if buffer size is 64 byte!
|
||
|
|
|
||
|
|
// Additional hints, if more than one USB interfaces are defined:
|
||
|
|
// - after configuration change (only configuration 1 is possible),
|
||
|
|
// interface 0 will be selected
|
||
|
|
// - to chose another interface, the control request command SET_INTERFACE
|
||
|
|
// with the request type 0x20 has to be executed
|
||
|
|
|
||
|
|
#define NUMINTERFACES 2 // number of supported interfaces (1...3) (Endpoint configurations)
|
||
|
|
|
||
|
|
#if (NUMINTERFACES>1)
|
||
|
|
static const ep_config EP_CONFIG[NUMINTERFACES][MAX_ENDPOINT] = {{
|
||
|
|
#else
|
||
|
|
static const ep_config EP_CONFIG[MAX_ENDPOINT] = {
|
||
|
|
#endif
|
||
|
|
// modify the following lines for your purposes
|
||
|
|
{EP_TYPE_BULK_OUT, 32, EP_SINGLE_BUFFER}, // one OUT and one IN endpoint with bulk transfer in this example
|
||
|
|
{EP_TYPE_BULK_IN, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#ifdef MEGA4_6 // the following endpoints are only available on ATMEGAxxU4 and AT90USB64x/128x controllers
|
||
|
|
,
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#endif
|
||
|
|
#if (NUMINTERFACES>1)
|
||
|
|
},{
|
||
|
|
// modify the following lines for your purposes
|
||
|
|
{EP_TYPE_INTERRUPT_IN, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#ifdef MEGA4_6 // the following endpoints are only available on ATMEGAxxU4 and AT90USB64x/128x controllers
|
||
|
|
,
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#endif
|
||
|
|
}
|
||
|
|
// more interfaces...
|
||
|
|
#if (NUMINTERFACES==3)
|
||
|
|
,{
|
||
|
|
// modify the following lines for your purposes
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#ifdef MEGA4_6 // the following endpoints are only available on ATMEGAxxU4 and AT90USB64x/128x controllers
|
||
|
|
,
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER},
|
||
|
|
{EP_TYPE_DISABLED, 32, EP_SINGLE_BUFFER}
|
||
|
|
#endif
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
#endif
|
||
|
|
};
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Endpoint Interrupt
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Function prototype to handle endpoint interrupts for incoming data
|
||
|
|
// The routine will be a part of the main program
|
||
|
|
|
||
|
|
void usb_ep(uint8_t endpoint, uint16_t datasize);
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Functional Purposes
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
|
||
|
|
// "Endpoint Halt" option
|
||
|
|
// Comment the following to save code memory. But USB conformity is lost.
|
||
|
|
#define SUPPORT_ENDPOINT_HALT
|
||
|
|
|
||
|
|
#endif
|