Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
Erik Strand
lufa
Commits
e277ff0c
Commit
e277ff0c
authored
May 12, 2010
by
Dean Camera
Browse files
Removed TeensyHID bootloader, per request from Paul at PJRC.
parent
dd92de39
Changes
12
Expand all
Hide whitespace changes
Inline
Side-by-side
Bootloaders/TeensyHID/Descriptors.c
deleted
100644 → 0
View file @
dd92de39
/*
LUFA Library
Copyright (C) Dean Camera, 2010.
dean [at] fourwalledcubicle [dot] com
www.fourwalledcubicle.com
*/
/*
Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com)
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
without fee, provided that the above copyright notice appear in
all copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness. In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
*/
/** \file
*
* USB Device Descriptors, for library use when in USB device mode. Descriptors are special
* computer-readable structures which the host requests upon device enumeration, to determine
* the device's capabilities and functions.
*/
#include "Descriptors.h"
/** HID class report descriptor. This is a special descriptor constructed with values from the
* USBIF HID class specification to describe the reports and capabilities of the HID device. This
* descriptor is parsed by the host and its contents used to determine what data (and in what encoding)
* the device will send, and what it may be sent back from the host. Refer to the HID specification for
* more details on HID report descriptors.
*/
USB_Descriptor_HIDReport_Datatype_t
HIDReport
[]
=
{
0x06
,
0x9c
,
0xff
,
/* Usage Page (Vendor Defined) */
0x09
,
TEENSY_USAGEPAGE
,
/* Usage (Vendor Defined) */
0xa1
,
0x01
,
/* Collection (Vendor Defined) */
0x0a
,
0x19
,
0x00
,
/* Usage (Vendor Defined) */
0x75
,
0x08
,
/* Report Size (8) */
#if (SPM_PAGESIZE == 128)
/* Report Count (SPM_PAGESIZE + 2) */
0x95
,
(
SPM_PAGESIZE
+
2
),
#else
0x96
,
((
SPM_PAGESIZE
+
2
)
&
0xFF
),
((
SPM_PAGESIZE
+
2
)
>>
8
),
#endif
0x15
,
0x00
,
/* Logical Minimum (0) */
0x25
,
0xff
,
/* Logical Maximum (255) */
0x91
,
0x02
,
/* Output (Data, Variable, Absolute) */
0xc0
/* End Collection */
};
/** Device descriptor structure. This descriptor, located in FLASH memory, describes the overall
* device characteristics, including the supported USB version, control endpoint size and the
* number of device configurations. The descriptor is read out by the USB host when the enumeration
* process begins.
*/
USB_Descriptor_Device_t
DeviceDescriptor
=
{
.
Header
=
{.
Size
=
sizeof
(
USB_Descriptor_Device_t
),
.
Type
=
DTYPE_Device
},
.
USBSpecification
=
VERSION_BCD
(
01
.
10
),
.
Class
=
0x00
,
.
SubClass
=
0x00
,
.
Protocol
=
0x00
,
.
Endpoint0Size
=
FIXED_CONTROL_ENDPOINT_SIZE
,
.
VendorID
=
0x16C0
,
.
ProductID
=
0x0478
,
.
ReleaseNumber
=
0x0120
,
.
ManufacturerStrIndex
=
NO_DESCRIPTOR
,
.
ProductStrIndex
=
NO_DESCRIPTOR
,
.
SerialNumStrIndex
=
NO_DESCRIPTOR
,
.
NumberOfConfigurations
=
FIXED_NUM_CONFIGURATIONS
};
/** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage
* of the device in one of its supported configurations, including information about any device interfaces
* and endpoints. The descriptor is read out by the USB host during the enumeration process when selecting
* a configuration so that the host may correctly communicate with the USB device.
*/
USB_Descriptor_Configuration_t
ConfigurationDescriptor
=
{
.
Config
=
{
.
Header
=
{.
Size
=
sizeof
(
USB_Descriptor_Configuration_Header_t
),
.
Type
=
DTYPE_Configuration
},
.
TotalConfigurationSize
=
sizeof
(
USB_Descriptor_Configuration_t
),
.
TotalInterfaces
=
1
,
.
ConfigurationNumber
=
1
,
.
ConfigurationStrIndex
=
NO_DESCRIPTOR
,
.
ConfigAttributes
=
USB_CONFIG_ATTR_BUSPOWERED
,
.
MaxPowerConsumption
=
USB_CONFIG_POWER_MA
(
100
)
},
.
HID_Interface
=
{
.
Header
=
{.
Size
=
sizeof
(
USB_Descriptor_Interface_t
),
.
Type
=
DTYPE_Interface
},
.
InterfaceNumber
=
0x00
,
.
AlternateSetting
=
0x00
,
.
TotalEndpoints
=
1
,
.
Class
=
0x03
,
.
SubClass
=
0x00
,
.
Protocol
=
0x00
,
.
InterfaceStrIndex
=
NO_DESCRIPTOR
},
.
HID_VendorHID
=
{
.
Header
=
{.
Size
=
sizeof
(
USB_Descriptor_HID_t
),
.
Type
=
DTYPE_HID
},
.
HIDSpec
=
VERSION_BCD
(
01
.
11
),
.
CountryCode
=
0x00
,
.
TotalHIDDescriptors
=
1
,
.
HIDReportType
=
DTYPE_Report
,
.
HIDReportLength
=
sizeof
(
HIDReport
)
},
.
HID_ReportINEndpoint
=
{
.
Header
=
{.
Size
=
sizeof
(
USB_Descriptor_Endpoint_t
),
.
Type
=
DTYPE_Endpoint
},
.
EndpointAddress
=
(
ENDPOINT_DESCRIPTOR_DIR_IN
|
HID_EPNUM
),
.
Attributes
=
(
EP_TYPE_INTERRUPT
|
ENDPOINT_ATTR_NO_SYNC
|
ENDPOINT_USAGE_DATA
),
.
EndpointSize
=
HID_EPSIZE
,
.
PollingIntervalMS
=
0x40
},
};
/** This function is called by the library when in device mode, and must be overridden (see library "USB Descriptors"
* documentation) by the application code so that the address and size of a requested descriptor can be given
* to the USB library. When the device receives a Get Descriptor request on the control endpoint, this function
* is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the
* USB host.
*/
uint16_t
CALLBACK_USB_GetDescriptor
(
const
uint16_t
wValue
,
const
uint8_t
wIndex
,
void
**
const
DescriptorAddress
)
{
const
uint8_t
DescriptorType
=
(
wValue
>>
8
);
void
*
Address
=
NULL
;
uint16_t
Size
=
NO_DESCRIPTOR
;
/* If/Else If chain compiles slightly smaller than a switch case */
if
(
DescriptorType
==
DTYPE_Device
)
{
Address
=
(
void
*
)
&
DeviceDescriptor
;
Size
=
sizeof
(
USB_Descriptor_Device_t
);
}
else
if
(
DescriptorType
==
DTYPE_Configuration
)
{
Address
=
(
void
*
)
&
ConfigurationDescriptor
;
Size
=
sizeof
(
USB_Descriptor_Configuration_t
);
}
else
if
(
DescriptorType
==
DTYPE_HID
)
{
Address
=
(
void
*
)
&
ConfigurationDescriptor
.
HID_VendorHID
;
Size
=
sizeof
(
USB_Descriptor_HID_t
);
}
else
{
Address
=
(
void
*
)
&
HIDReport
;
Size
=
sizeof
(
HIDReport
);
}
*
DescriptorAddress
=
Address
;
return
Size
;
}
Bootloaders/TeensyHID/Descriptors.h
deleted
100644 → 0
View file @
dd92de39
/*
LUFA Library
Copyright (C) Dean Camera, 2010.
dean [at] fourwalledcubicle [dot] com
www.fourwalledcubicle.com
*/
/*
Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com)
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
without fee, provided that the above copyright notice appear in
all copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness. In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
*/
/** \file
*
* Header file for Descriptors.c.
*/
#ifndef _DESCRIPTORS_H_
#define _DESCRIPTORS_H_
/* Includes: */
#include <LUFA/Drivers/USB/USB.h>
/* Type Defines: */
/** Type define for the HID class specific HID descriptor, to describe the HID device's specifications. Refer to the HID
* specification for details on the structure elements.
*/
typedef
struct
{
USB_Descriptor_Header_t
Header
;
uint16_t
HIDSpec
;
uint8_t
CountryCode
;
uint8_t
TotalHIDDescriptors
;
uint8_t
HIDReportType
;
uint16_t
HIDReportLength
;
}
USB_Descriptor_HID_t
;
/** Type define for the data type used to store HID report descriptor elements. */
typedef
uint8_t
USB_Descriptor_HIDReport_Datatype_t
;
/** Type define for the device configuration descriptor structure. This must be defined in the
* application code, as the configuration descriptor contains several sub-descriptors which
* vary between devices, and which describe the device's usage to the host.
*/
typedef
struct
{
USB_Descriptor_Configuration_Header_t
Config
;
USB_Descriptor_Interface_t
HID_Interface
;
USB_Descriptor_HID_t
HID_VendorHID
;
USB_Descriptor_Endpoint_t
HID_ReportINEndpoint
;
}
USB_Descriptor_Configuration_t
;
/* Macros: */
/** Endpoint number of the HID data IN endpoint. */
#define HID_EPNUM 1
/** Size in bytes of the HID reporting IN endpoint. */
#define HID_EPSIZE 64
/** Descriptor header type value, to indicate a HID class HID descriptor. */
#define DTYPE_HID 0x21
/** Descriptor header type value, to indicate a HID class HID report descriptor. */
#define DTYPE_Report 0x22
/** Vendor usage page for the Teensy 1.0 board */
#define TEENSY_USAGEPAGE_10 0x19
/** Vendor usage page for the Teensy++ 1.0 board */
#define TEENSY_USAGEPAGE_10PP 0x1A
/** Vendor usage page for the Teensy 2.0 board */
#define TEENSY_USAGEPAGE_20 0x1B
/** Vendor usage page for the Teensy++ 2.0 board */
#define TEENSY_USAGEPAGE_20PP 0x1C
#if (defined(__AVR_AT90USB162__) || defined(__AVR_ATmega16U2__))
#define TEENSY_USAGEPAGE TEENSY_USAGEPAGE_10
#elif defined(__AVR_ATmega32U4__)
#define TEENSY_USAGEPAGE TEENSY_USAGEPAGE_20
#elif (defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB647__))
#define TEENSY_USAGEPAGE TEENSY_USAGEPAGE_10PP
#elif (defined(__AVR_AT90USB1286__) || defined(__AVR_AT90USB1287__))
#define TEENSY_USAGEPAGE TEENSY_USAGEPAGE_20PP
#else
#error The selected AVR model is not currently supported by the TeensyHID bootloader.
#endif
/* Function Prototypes: */
uint16_t
CALLBACK_USB_GetDescriptor
(
const
uint16_t
wValue
,
const
uint8_t
wIndex
,
void
**
const
DescriptorAddress
)
ATTR_WARN_UNUSED_RESULT
ATTR_NON_NULL_PTR_ARG
(
3
);
#endif
Bootloaders/TeensyHID/Doxygen.conf
deleted
100644 → 0
View file @
dd92de39
This diff is collapsed.
Click to expand it.
Bootloaders/TeensyHID/TeensyHID.c
deleted
100644 → 0
View file @
dd92de39
/*
LUFA Library
Copyright (C) Dean Camera, 2010.
dean [at] fourwalledcubicle [dot] com
www.fourwalledcubicle.com
*/
/*
Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com)
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
without fee, provided that the above copyright notice appear in
all copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness. In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
*/
/** \file
*
* Main source file for the TeensyHID bootloader. This file contains the complete bootloader logic.
*/
#include "TeensyHID.h"
/** Flag to indicate if the bootloader should be running, or should exit and allow the application code to run
* via a soft reset. When cleared, the bootloader will abort, the USB interface will shut down and the application
* started via a forced watchdog reset.
*/
bool
RunBootloader
=
true
;
/** Main program entry point. This routine configures the hardware required by the bootloader, then continuously
* runs the bootloader processing routine until instructed to soft-exit.
*/
int
main
(
void
)
{
/* Setup hardware required for the bootloader */
SetupHardware
();
/* Enable global interrupts so that the USB stack can function */
sei
();
while
(
RunBootloader
)
USB_USBTask
();
/* Disconnect from the host - USB interface will be reset later along with the AVR */
USB_Detach
();
/* Enable the watchdog and force a timeout to reset the AVR */
wdt_enable
(
WDTO_250MS
);
for
(;;);
}
/** Configures all hardware required for the bootloader. */
void
SetupHardware
(
void
)
{
/* Disable watchdog if enabled by bootloader/fuses */
MCUSR
&=
~
(
1
<<
WDRF
);
wdt_disable
();
/* Relocate the interrupt vector table to the bootloader section */
MCUCR
=
(
1
<<
IVCE
);
MCUCR
=
(
1
<<
IVSEL
);
/* Initialize USB subsystem */
USB_Init
();
}
/** Event handler for the USB_ConfigurationChanged event. This configures the device's endpoints ready
* to relay data to and from the attached USB host.
*/
void
EVENT_USB_Device_ConfigurationChanged
(
void
)
{
/* Setup HID Report Endpoint */
Endpoint_ConfigureEndpoint
(
HID_EPNUM
,
EP_TYPE_INTERRUPT
,
ENDPOINT_DIR_IN
,
HID_EPSIZE
,
ENDPOINT_BANK_SINGLE
);
}
/** Event handler for the USB_UnhandledControlRequest event. This is used to catch standard and class specific
* control requests that are not handled internally by the USB library (including the HID commands, which are
* all issued via the control endpoint), so that they can be handled appropriately for the application.
*/
void
EVENT_USB_Device_UnhandledControlRequest
(
void
)
{
/* Handle HID Class specific requests */
switch
(
USB_ControlRequest
.
bRequest
)
{
case
REQ_SetReport
:
Endpoint_ClearSETUP
();
/* Wait until the command has been sent by the host */
while
(
!
(
Endpoint_IsOUTReceived
()));
/* Read in the write destination index */
uint16_t
PageIndex
=
Endpoint_Read_Word_LE
();
/* Check if the command is a program page command, or a start application command */
if
(
PageIndex
==
TEENSY_STARTAPPLICATION
)
{
RunBootloader
=
false
;
}
else
{
#if (FLASHEND > 0xFFFF)
uint32_t
PageByteAddress
=
((
uint32_t
)
PageIndex
<<
8
);
#else
uint16_t
PageByteAddress
=
PageIndex
;
#endif
/* Erase the given FLASH page, ready to be programmed */
boot_page_erase
(
PageByteAddress
);
boot_spm_busy_wait
();
/* Write each of the FLASH page's bytes in sequence */
#if (SPM_PAGESIZE == 128)
for
(
uint8_t
PageByte
=
0
;
PageByte
<
SPM_PAGESIZE
;
PageByte
+=
2
)
#else
for
(
uint16_t
PageByte
=
0
;
PageByte
<
SPM_PAGESIZE
;
PageByte
+=
2
)
#endif
{
/* Check if endpoint is empty - if so clear it and wait until ready for next packet */
if
(
!
(
Endpoint_BytesInEndpoint
()))
{
Endpoint_ClearOUT
();
while
(
!
(
Endpoint_IsOUTReceived
()));
}
/* Write the next data word to the FLASH page */
boot_page_fill
(
PageByteAddress
+
PageByte
,
Endpoint_Read_Word_LE
());
}
/* Write the filled FLASH page to memory */
boot_page_write
(
PageByteAddress
);
boot_spm_busy_wait
();
}
Endpoint_ClearOUT
();
Endpoint_ClearStatusStage
();
break
;
}
}
Bootloaders/TeensyHID/TeensyHID.h
deleted
100644 → 0
View file @
dd92de39
/*
LUFA Library
Copyright (C) Dean Camera, 2010.
dean [at] fourwalledcubicle [dot] com
www.fourwalledcubicle.com
*/
/*
Copyright 2010 Dean Camera (dean [at] fourwalledcubicle [dot] com)
Permission to use, copy, modify, distribute, and sell this
software and its documentation for any purpose is hereby granted
without fee, provided that the above copyright notice appear in
all copies and that both that the copyright notice and this
permission notice and warranty disclaimer appear in supporting
documentation, and that the name of the author not be used in
advertising or publicity pertaining to distribution of the
software without specific, written prior permission.
The author disclaim all warranties with regard to this
software, including all implied warranties of merchantability
and fitness. In no event shall the author be liable for any
special, indirect or consequential damages or any damages
whatsoever resulting from loss of use, data or profits, whether
in an action of contract, negligence or other tortious action,
arising out of or in connection with the use or performance of
this software.
*/
/** \file
*
* Header file for TeensyHID.c.
*/
#ifndef _TEENSYHID_H_
#define _TEENSYHID_H_
/* Includes: */
#include <avr/io.h>
#include <avr/wdt.h>
#include <avr/boot.h>
#include <avr/power.h>
#include <avr/interrupt.h>
#include <stdbool.h>
#include "Descriptors.h"
#include <LUFA/Drivers/USB/USB.h>
/* Macros: */
/** HID Class specific request to send the next HID report to the device. */
#define REQ_SetReport 0x09
/** Teensy Bootloader special address to start the user application */
#define TEENSY_STARTAPPLICATION 0xFFFF
/* Function Prototypes: */
void
SetupHardware
(
void
);
void
EVENT_USB_Device_ConfigurationChanged
(
void
);
void
EVENT_USB_Device_UnhandledControlRequest
(
void
);
#endif
Bootloaders/TeensyHID/TeensyHID.txt
deleted
100644 → 0
View file @
dd92de39
/** \file
*
* This file contains special DoxyGen information for the generation of the main page and other special
* documentation pages. It is not a project source file.
*/
/** \mainpage Teensy HID Class USB AVR Bootloader
*
* \section SSec_Compat Demo Compatibility:
*
* The following list indicates what microcontrollers are compatible with this demo.
*
* - AT90USB162 (Teensy 1.0)
* - AT90USB646 (Teensy++ 1.0)
* - ATMEGA32U4 (Teensy 2.0)
* - AT90USB1286 (Teensy++ 2.0)
*
* \section SSec_Info USB Information:
*
* The following table gives a rundown of the USB utilization of this demo.
*
* <table>
* <tr>
* <td><b>USB Mode:</b></td>
* <td>Device</td>
* </tr>
* <tr>
* <td><b>USB Class:</b></td>
* <td>Human Interface Device Class (HID)</td>
* </tr>
* <tr>
* <td><b>USB Subclass:</b></td>
* <td>N/A</td>
* </tr>
* <tr>
* <td><b>Relevant Standards:</b></td>
* <td>USBIF HID Class Standard \n
* Teensy Programming Protocol Specification</td>
* </tr>
* <tr>
* <td><b>Usable Speeds:</b></td>
* <td>Low Speed Mode \n
* Full Speed Mode</td>
* </tr>
* </table>
*
* \section SSec_Description Project Description:
*
* This bootloader enumerates to the host as a HID Class device, allowing for Teensy compatible programming
* software to load firmware onto the AVR, such as the official software at <a>http://www.pjrc.com/teensy/</a>.
*
* Out of the box this bootloader builds for the ATMEGA32U4, and will fit into 2-4KB of bootloader space. For other
* devices, the makefile will need to be updated to reflect the altered MCU model and bootloader start address. When
* calculating the bootloader start address, use (TARGET_FLASH_SIZE_BYTES - 4096) for targets where the bootloader
* compiles larger than 2KB, or (TARGET_FLASH_SIZE_BYTES - 2048) for smaller targets where the bootloader compiles
* under 2KB.
*
* This spoofs (with permission) the official Teensy bootloader's VID and PID, so that the software remains
* compatible with no changes.
*
* \section SSec_Options Project Options
*
* The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
*
* <table>
* <tr>
* <td>
* None
* </td>
* </tr>
* </table>
*/
Bootloaders/TeensyHID/makefile
deleted
100644 → 0
View file @
dd92de39
This diff is collapsed.
Click to expand it.
Bootloaders/makefile
View file @
e277ff0c
...
...
@@ -19,11 +19,7 @@ all:
$(MAKE)
-C
CDC
clean
$(MAKE)
-C
CDC
all
$(MAKE)
-C
TeensyHID
clean
$(MAKE)
-C
TeensyHID
all
%
:
$(MAKE)
-C
DFU
$@
$(MAKE)
-C
CDC
$@
$(MAKE)
-C
TeensyHID
$@
LUFA.pnproj
View file @
e277ff0c
This diff is collapsed.
Click to expand it.
LUFA/ManPages/ChangeLog.txt
View file @
e277ff0c
...
...
@@ -7,6 +7,12 @@
/** \page Page_ChangeLog Project Changelog
*
* \section Sec_ChangeLogXXXXXX Version XXXXXX
* <b>New:</b>
*
* <b>Changed:</b>
* - The TeensyHID bootloader has been removed, per request from Paul at PJRC
*
* <b>Fixed:</b>