LUFA/Drivers/USB/Core/USBMode.h

   1 /*
   2              LUFA Library
   3      Copyright (C) Dean Camera, 2012.
   4
   5   dean [at] fourwalledcubicle [dot] com
   6            www.lufa-lib.org
   7 */
   8
   9 /*
  10   Copyright 2012  Dean Camera (dean [at] fourwalledcubicle [dot] com)
  11
  12   Permission to use, copy, modify, distribute, and sell this
  13   software and its documentation for any purpose is hereby granted
  14   without fee, provided that the above copyright notice appear in
  15   all copies and that both that the copyright notice and this
  16   permission notice and warranty disclaimer appear in supporting
  17   documentation, and that the name of the author not be used in
  18   advertising or publicity pertaining to distribution of the
  19   software without specific, written prior permission.
  20
  21   The author disclaim all warranties with regard to this
  22   software, including all implied warranties of merchantability
  23   and fitness.  In no event shall the author be liable for any
  24   special, indirect or consequential damages or any damages
  25   whatsoever resulting from loss of use, data or profits, whether
  26   in an action of contract, negligence or other tortious action,
  27   arising out of or in connection with the use or performance of
  28   this software.
  29 */
  30
  31 /** \file
  32  *  \brief USB mode and feature support definitions.
  33  *  \copydetails Group_USBMode
  34  *
  35  *  \note This file should not be included directly. It is automatically included as needed by the USB driver
  36  *        dispatch header located in LUFA/Drivers/USB/USB.h.
  37  */
  38
  39 /** \ingroup Group_USB
  40  *  \defgroup Group_USBMode USB Mode Tokens
  41  *  \brief USB mode and feature support definitions.
  42  *
  43  *  This file defines macros indicating the type of USB controller the library is being compiled for, and its
  44  *  capabilities. These macros may then be referenced in the user application to selectively enable or disable
  45  *  code sections depending on if they are defined or not.
  46  *
  47  *  After the inclusion of the master USB driver header, one or more of the following tokens may be defined, to
  48  *  allow the user code to conditionally enable or disable code based on the USB controller family and allowable
  49  *  USB modes. These tokens may be tested against to eliminate code relating to a USB mode which is not enabled for
  50  *  the given compilation.
  51  *
  52  *  @{
  53  */
  54
  55 #ifndef __USBMODE_H__
  56 #define __USBMODE_H__
  57
  58         /* Enable C linkage for C++ Compilers: */
  59                 #if defined(__cplusplus)
  60                         extern "C" {
  61                 #endif
  62
  63         /* Preprocessor Checks: */
  64                 #if !defined(__INCLUDE_FROM_USB_DRIVER)
  65                         #error Do not include this file directly. Include LUFA/Drivers/USB/USB.h instead.
  66                 #endif
  67
  68         /* Public Interface - May be used in end-application: */
  69         #if defined(__DOXYGEN__)
  70                 /** Indicates that the target AVR microcontroller belongs to the Series 2 AVR8 USB controller
  71                  *  (i.e. AT90USBxxx2 or ATMEGAxxU2) when defined.
  72                  */
  73                 #define USB_SERIES_2_AVR
  74
  75                 /** Indicates that the target AVR microcontroller belongs to the Series 4 AVR8 USB controller
  76                  *  (i.e. ATMEGAxxU4) when defined.
  77                  */
  78                 #define USB_SERIES_4_AVR
  79
  80                 /** Indicates that the target AVR microcontroller belongs to the Series 6 AVR8 USB controller
  81                  *  (i.e. AT90USBxxx6) when defined.
  82                  */
  83                 #define USB_SERIES_6_AVR
  84
  85                 /** Indicates that the target AVR microcontroller belongs to the Series 7 AVR8 USB controller
  86                  *  (i.e. AT90USBxxx7) when defined.
  87                  */
  88                 #define USB_SERIES_7_AVR
  89
  90                 /** Indicates that the target AVR microcontroller belongs to the AVR32 UC3A0 Series USB controller
  91                  *  (i.e. AT32UC3A0*) when defined.
  92                  */
  93                 #define USB_SERIES_UC3A0_AVR
  94
  95                 /** Indicates that the target AVR microcontroller belongs to the AVR32 UC3A1 Series USB controller
  96                  *  (i.e. AT32UC3A1*) when defined.
  97                  */
  98                 #define USB_SERIES_UC3A1_AVR
  99
 100                 /** Indicates that the target AVR microcontroller belongs to the AVR32 UC3A3 Series USB controller
 101                  *  (i.e. AT32UC3A3*) when defined.
 102                  */
 103                 #define USB_SERIES_UC3A3_AVR
 104
 105                 /** Indicates that the target AVR microcontroller belongs to the AVR32 UC3B0 Series USB controller
 106                  *  (i.e. AT32UC3B0*) when defined.
 107                  */
 108                 #define USB_SERIES_UC3B0_AVR
 109
 110                 /** Indicates that the target AVR microcontroller belongs to the AVR32 UC3B1 Series USB controller
 111                  *  (i.e. AT32UC3B1*) when defined.
 112                  */
 113                 #define USB_SERIES_UC3B1_AVR
 114
 115                 /** Indicates that the target AVR microcontroller belongs to the XMEGA A1U Series USB controller
 116                  *  (i.e. ATXMEGA*A1U) when defined.
 117                  */
 118                 #define USB_SERIES_A1U_XMEGA
 119
 120                 /** Indicates that the target AVR microcontroller belongs to the XMEGA A3U Series USB controller
 121                  *  (i.e. ATXMEGA*A3U) when defined.
 122                  */
 123                 #define USB_SERIES_A3U_XMEGA
 124
 125                 /** Indicates that the target AVR microcontroller belongs to the XMEGA A4U Series USB controller
 126                  *  (i.e. ATXMEGA*A4U) when defined.
 127                  */
 128                 #define USB_SERIES_A4U_XMEGA
 129
 130                 /** Indicates that the target AVR microcontroller belongs to the XMEGA B1 Series USB controller
 131                  *  (i.e. ATXMEGA*B1) when defined.
 132                  */
 133                 #define USB_SERIES_B1_XMEGA
 134
 135                 /** Indicates that the target AVR microcontroller belongs to the XMEGA B3 Series USB controller
 136                  *  (i.e. ATXMEGA*B3) when defined.
 137                  */
 138                 #define USB_SERIES_B3_XMEGA
 139
 140                 /** Indicates that the target microcontroller and compilation settings allow for the
 141                  *  target to be configured in USB Device mode when defined.
 142                  */
 143                 #define USB_CAN_BE_DEVICE
 144
 145                 /** Indicates that the target microcontroller and compilation settings allow for the
 146                  *  target to be configured in USB Host mode when defined.
 147                  */
 148                 #define USB_CAN_BE_HOST
 149
 150                 /** Indicates that the target microcontroller and compilation settings allow for the
 151                  *  target to be configured in either USB Device or Host mode when defined.
 152                  */
 153                 #define USB_CAN_BE_BOTH
 154         #else
 155                 /* Macros: */
 156                         #if (defined(__AVR_AT90USB162__) || defined(__AVR_AT90USB82__)  || \
 157                              defined(__AVR_ATmega32U2__) || defined(__AVR_ATmega16U2__) || defined(__AVR_ATmega8U2__))
 158                                 #define USB_SERIES_2_AVR
 159                                 #define USB_CAN_BE_DEVICE
 160                         #elif (defined(__AVR_ATmega32U4__) || defined(__AVR_ATmega16U4__))
 161                                 #define USB_SERIES_4_AVR
 162                                 #define USB_CAN_BE_DEVICE
 163                         #elif (defined(__AVR_ATmega32U6__) || defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__))
 164                                 #define USB_SERIES_6_AVR
 165                                 #define USB_CAN_BE_DEVICE
 166                         #elif (defined(__AVR_AT90USB647__) || defined(__AVR_AT90USB1287__))
 167                                 #define USB_SERIES_7_AVR
 168                                 #define USB_CAN_BE_DEVICE
 169                                 #define USB_CAN_BE_HOST
 170                         #elif (defined(__AVR32_UC3A0512__) || defined(__AVR32_UC3A0256__) || \
 171                                defined(__AVR32_UC3A0128__) || defined(__AVR32_UC3A064__))
 172                                 #define USB_SERIES_UC3A0_AVR32
 173                                 #define USB_CAN_BE_DEVICE
 174                                 #define USB_CAN_BE_HOST
 175                         #elif (defined(__AVR32_UC3A1512__) || defined(__AVR32_UC3A1256__) || \
 176                                defined(__AVR32_UC3A1128__) || defined(__AVR32_UC3A164__))
 177                                 #define USB_SERIES_UC3A1_AVR32
 178                                 #define USB_CAN_BE_DEVICE
 179                                 #define USB_CAN_BE_HOST
 180                         #elif (defined(__AVR32_UC3A3256__) || defined(__AVR32_UC3A3256S__) || \
 181                                defined(__AVR32_UC3A3128__) || defined(__AVR32_UC3A3128S__) || \
 182                                defined(__AVR32_UC3A364__)  || defined(__AVR32_UC3A364S__))
 183                                 #define USB_SERIES_UC3A3_AVR32
 184                                 #define USB_CAN_BE_DEVICE
 185                                 #define USB_CAN_BE_HOST
 186                         #elif (defined(__AVR32_UC3A4256__) || defined(__AVR32_UC3A4256S__) || \
 187                                defined(__AVR32_UC3A4128__) || defined(__AVR32_UC3A4128S__) || \
 188                                defined(__AVR32_UC3A464__)  || defined(__AVR32_UC3A464S__))
 189                                 #define USB_SERIES_UC3A4_AVR32
 190                                 #define USB_CAN_BE_DEVICE
 191                                 #define USB_CAN_BE_HOST
 192                         #elif (defined(__AVR32_UC3B0512__) || defined(__AVR32_UC3B0256__) || \
 193                                defined(__AVR32_UC3B0128__) || defined(__AVR32_UC3B064__))
 194                                 #define USB_SERIES_UC3B0_AVR32
 195                                 #define USB_CAN_BE_DEVICE
 196                                 #define USB_CAN_BE_HOST
 197                         #elif (defined(__AVR32_UC3B1512__) || defined(__AVR32_UC3B1256__) || \
 198                                defined(__AVR32_UC3B1128__) || defined(__AVR32_UC3B164__))
 199                                 #define USB_SERIES_UC3B1_AVR32
 200                                 #define USB_CAN_BE_DEVICE
 201                                 #define USB_CAN_BE_HOST
 202                         #elif (defined(__AVR_ATxmega128A1U__) || defined(__AVR_ATxmega64A1U__))
 203                                 #define USB_SERIES_A1U_XMEGA
 204                                 #define USB_CAN_BE_DEVICE
 205                         #elif (defined(__AVR_ATxmega64A3U__) || defined(__AVR_ATxmega128A3U__) || \
 206                                defined(__AVR_ATxmega192A3U__) || defined(__AVR_ATxmega256A3U__))
 207                                 #define USB_SERIES_A3U_XMEGA
 208                                 #define USB_CAN_BE_DEVICE
 209                         #elif (defined(__AVR_ATxmega256A3BU__))
 210                                 #define USB_SERIES_A3BU_XMEGA
 211                                 #define USB_CAN_BE_DEVICE
 212                         #elif (defined(__AVR_ATxmega16A4U__) || defined(__AVR_ATxmega32A4U__) || \
 213                                defined(__AVR_ATxmega64A4U__) || defined(__AVR_ATxmega128A4U__))
 214                                 #define USB_SERIES_A4U_XMEGA
 215                                 #define USB_CAN_BE_DEVICE
 216                         #elif (defined(__AVR_ATxmega128B1__) || defined(__AVR_ATxmega64B1__))
 217                                 #define USB_SERIES_B1_XMEGA
 218                                 #define USB_CAN_BE_DEVICE
 219                         #elif (defined(__AVR_ATxmega128B3__) || defined(__AVR_ATxmega64B3__))
 220                                 #define USB_SERIES_B3_XMEGA
 221                                 #define USB_CAN_BE_DEVICE
 222                         #endif
 223
 224                         #if (defined(USB_CAN_BE_DEVICE) && defined(USB_CAN_BE_HOST))
 225                                 #define USB_CAN_BE_BOTH
 226                         #endif
 227
 228                         #if defined(USB_HOST_ONLY)
 229                                 #if !defined(USB_CAN_BE_HOST)
 230                                         #error USB_HOST_ONLY is not available for the currently selected microcontroller model.
 231                                 #else
 232                                         #undef USB_CAN_BE_DEVICE
 233                                         #undef USB_CAN_BE_BOTH
 234                                 #endif
 235                         #endif
 236
 237                         #if defined(USB_DEVICE_ONLY)
 238                                 #if !defined(USB_CAN_BE_DEVICE)
 239                                         #error USB_DEVICE_ONLY is not available for the currently selected microcontroller model.
 240                                 #else
 241                                         #undef USB_CAN_BE_HOST
 242                                         #undef USB_CAN_BE_BOTH
 243                                 #endif
 244                         #endif
 245
 246                         #if (defined(USB_HOST_ONLY) && defined(USB_DEVICE_ONLY))
 247                                 #error USB_HOST_ONLY and USB_DEVICE_ONLY are mutually exclusive.
 248                         #endif
 249
 250                         #if (!defined(USB_CAN_BE_DEVICE) && !defined(USB_CAN_BE_HOST))
 251                                 #error The currently selected device or architecture is not supported under the USB component of the library.
 252                         #endif
 253         #endif
 254
 255         /* Disable C linkage for C++ Compilers: */
 256                 #if defined(__cplusplus)
 257                         }
 258                 #endif
 259
 260 #endif
 261
 262 /** @} */
 263