All comments in the library, bootloaders, demos and projects have now been spell-checked and spelling mistakes/typos corrected.
This commit is contained in:
parent
fb3fcb968e
commit
6933f2e1a5
95 changed files with 274 additions and 273 deletions
|
|
@ -58,7 +58,7 @@
|
|||
/* Macros: */
|
||||
/** Raises a given event name, with the specified parameters. For events with no parameters the
|
||||
* only argument to the macro is the event name, events with parameters list the parameter values
|
||||
* after the name as a comma seperated list.
|
||||
* after the name as a comma separated list.
|
||||
*
|
||||
* When a given event is fired, its corresponding event handler code is executed.
|
||||
*
|
||||
|
|
@ -75,7 +75,7 @@
|
|||
*/
|
||||
#define RAISE_EVENT(e, ...) Event_ ## e (__VA_ARGS__)
|
||||
|
||||
/** Indicates that a given module can raise a given event. This is the equivelent of putting the
|
||||
/** Indicates that a given module can raise a given event. This is the equivalent of putting the
|
||||
* event function's prototype into the module, but in a cleaner way. Each event which may be
|
||||
* fired via the RAISE_EVENT macro in the module should have an accompanying RAISES_EVENT
|
||||
* prototype in the module's header file.
|
||||
|
|
@ -100,7 +100,7 @@
|
|||
*
|
||||
* Only one event handler may be defined in any user project for each individual event. Events may
|
||||
* or may not have parameters - for each event, refer to its documentation elsewhere in this module
|
||||
* to determine the presense and purpose of any event parameters.
|
||||
* to determine the presence and purpose of any event parameters.
|
||||
*
|
||||
* Usage Example:
|
||||
* \code
|
||||
|
|
@ -115,7 +115,7 @@
|
|||
*/
|
||||
#define EVENT_HANDLER(e) void Event_ ## e e ## _P
|
||||
|
||||
/** Indicates that a given module handles an event. This is the equivelent of putting the
|
||||
/** Indicates that a given module handles an event. This is the equivalent of putting the
|
||||
* event function's prototype into the module, but in a cleaner way. Each event which may be
|
||||
* handled via the EVENT_HANDLER macro in the module should have an accompanying HANDLES_EVENT
|
||||
* prototype in the module's header file.
|
||||
|
|
@ -136,7 +136,7 @@
|
|||
*/
|
||||
#define HANDLES_EVENT(e) EVENT_HANDLER(e)
|
||||
|
||||
/* Psudo-Functions for Doxygen: */
|
||||
/* Pseudo-Functions for Doxygen: */
|
||||
#if defined(__DOXYGEN__)
|
||||
/** Event for VBUS level change. This event fires when the VBUS line of the USB AVR changes from
|
||||
* high to low or vice-versa.
|
||||
|
|
@ -165,7 +165,7 @@
|
|||
* has been attached (but not yet fully enumerated), or when in device mode and the device is connected
|
||||
* to a host, beginning the enumeration process.
|
||||
*
|
||||
* When in device mode, this can be used to progmatically start the USB management task to reduce
|
||||
* When in device mode, this can be used to programmatically start the USB management task to reduce
|
||||
* CPU usage.
|
||||
*
|
||||
* \note For the smaller USB AVRs (AT90USBXX2) with limited USB controllers, VBUS is not available to the USB controller.
|
||||
|
|
@ -183,7 +183,7 @@
|
|||
* attached and enumerated device has been disconnected, or when in device mode and the device is
|
||||
* disconnected from the host.
|
||||
*
|
||||
* When in device mode, this can be used to progmatically stop the USB management task to reduce
|
||||
* When in device mode, this can be used to programmatically stop the USB management task to reduce
|
||||
* CPU usage.
|
||||
*
|
||||
* \note For the smaller USB AVRs (AT90USBXX2) with limited USB controllers, VBUS is not available to the USB controller.
|
||||
|
|
@ -231,7 +231,7 @@
|
|||
|
||||
/** Event for USB device attachment. This event fires when a the USB interface is in host mode, and
|
||||
* a USB device has been connected to the USB interface. This is interrupt driven, thus fires before
|
||||
* the standard USB_DeviceConnect event and so can be used to programatically start the USB management
|
||||
* the standard USB_DeviceConnect event and so can be used to programmatically start the USB management
|
||||
* task to reduce CPU consumption.
|
||||
*
|
||||
* \note This event only exists on USB AVR models which supports host mode.
|
||||
|
|
@ -245,7 +245,7 @@
|
|||
|
||||
/** Event for USB device removal. This event fires when a the USB interface is in host mode, and
|
||||
* a USB device has been removed the USB interface whether or not it has been enumerated. This
|
||||
* can be used to programatically stop the USB management task to reduce CPU consumption.
|
||||
* can be used to programmatically stop the USB management task to reduce CPU consumption.
|
||||
*
|
||||
* \note This event only exists on USB AVR models which supports host mode.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@
|
|||
/** \file
|
||||
*
|
||||
* Standard USB device descriptor defines and retrieval routines, for USB devices. This module contains
|
||||
* strucutures and macros for the easy creation of standard USB descriptors in USB device projects.
|
||||
* structures and macros for the easy creation of standard USB descriptors in USB device projects.
|
||||
*
|
||||
* All standard descriptors have their elements named in an identical manner to the official USB specification,
|
||||
* however slightly more verbose alternate (non-standard) names are also supplied if the macro
|
||||
|
|
@ -245,7 +245,7 @@
|
|||
uint16_t ReleaseNumber; /**< Product release (version) number. */
|
||||
|
||||
uint8_t ManufacturerStrIndex; /**< String index for the manufacturer's name. The
|
||||
* host will request this string via a seperate
|
||||
* host will request this string via a separate
|
||||
* control request for the string descriptor.
|
||||
*
|
||||
* \note If no string supplied, use NO_DESCRIPTOR.
|
||||
|
|
@ -255,7 +255,7 @@
|
|||
* \see ManufacturerStrIndex structure entry.
|
||||
*/
|
||||
uint8_t SerialNumStrIndex; /**< String index for the product's globally unique hexadecimal
|
||||
* serial number, in uppercase Unicoded ASCII.
|
||||
* serial number, in uppercase Unicode ASCII.
|
||||
*
|
||||
* \see ManufacturerStrIndex structure entry.
|
||||
*/
|
||||
|
|
@ -363,7 +363,7 @@
|
|||
|
||||
/** Type define for a standard interface association descriptor.
|
||||
*
|
||||
* This descriptor has been added as a suppliment to the USB2.0 standard, in the ECN located at
|
||||
* This descriptor has been added as a supplement to the USB2.0 standard, in the ECN located at
|
||||
* <a>http://www.usb.org/developers/docs/InterfaceAssociationDescriptor_ecn.pdf</a>. It allows compound
|
||||
* devices with multiple interfaces related to the same function to have the multiple interfaces bound
|
||||
* together at the point of enumeration, loading one generic driver for all the interfaces in the single
|
||||
|
|
@ -425,7 +425,7 @@
|
|||
* maximum packet size that the endpoint can receive at a time.
|
||||
*/
|
||||
|
||||
uint8_t PollingIntervalMS; /**< Polling interval in milliseconds for the endpont
|
||||
uint8_t PollingIntervalMS; /**< Polling interval in milliseconds for the endpoint
|
||||
* if it is an INTERRUPT or ISOCHRONOUS type.
|
||||
*/
|
||||
#else
|
||||
|
|
|
|||
|
|
@ -79,7 +79,7 @@
|
|||
#define USB_INT_IsEnabled(int) ((USB_INT_GET_EN_REG(int) & USB_INT_GET_EN_MASK(int)) ? true : false)
|
||||
|
||||
/** Returns boolean true if the given interrupt flag is set (i.e. the condition for the interrupt has occurred,
|
||||
* but the interrupt vector is not neccesarily enabled), otherwise returns false.
|
||||
* but the interrupt vector is not necessarily enabled), otherwise returns false.
|
||||
*/
|
||||
#define USB_INT_HasOccurred(int) ((USB_INT_GET_INT_REG(int) & USB_INT_GET_INT_MASK(int)) ? true : false)
|
||||
|
||||
|
|
|
|||
|
|
@ -76,7 +76,7 @@
|
|||
*/
|
||||
extern volatile bool USB_IsConnected;
|
||||
|
||||
/** Indicates if the USB interface is currently initialized but not neccesarily connected to a host
|
||||
/** Indicates if the USB interface is currently initialized but not necessarily connected to a host
|
||||
* or device (i.e. if USB_Init() has been run). If this is false, all other library globals are invalid.
|
||||
*
|
||||
* \note This variable should be treated as read-only in the user application, and never manually
|
||||
|
|
@ -166,10 +166,10 @@
|
|||
* The USB task must be serviced within 50mS in all modes, when needed. The task may be serviced
|
||||
* at all times, or (for minimum CPU consumption):
|
||||
*
|
||||
* - In device mode, it may be disabled at startup, enabled on the firing of the USB_Connect event
|
||||
* - In device mode, it may be disabled at start-up, enabled on the firing of the USB_Connect event
|
||||
* and disabled again on the firing of the USB_Disconnect event.
|
||||
*
|
||||
* - In host mode, it may be disabled at startup, enabled on the firing of the USB_DeviceAttached
|
||||
* - In host mode, it may be disabled at start-up, enabled on the firing of the USB_DeviceAttached
|
||||
* event and disabled again on the firing of the USB_DeviceUnattached event.
|
||||
*
|
||||
* \see Events.h for more information on the USB events.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue