#if defined(__cplusplus)\r
extern "C" {\r
#endif\r
-\r
+ \r
/* Public Interface - May be used in end-application: */\r
/* Global Variables: */\r
/** Indicates if the USB interface is currently initialized but not necessarily connected to a host\r
extern USB_Request_Header_t USB_ControlRequest;\r
\r
#if defined(USB_CAN_BE_HOST) || defined(__DOXYGEN__)\r
- /** Indicates the current host state machine state. When in host mode, this indicates the state\r
- * via one of the values of the \ref USB_Host_States_t enum values.\r
- *\r
- * This value may be altered by the user application to implement the \ref HOST_STATE_Addressed,\r
- * \ref HOST_STATE_Configured and \ref HOST_STATE_Suspended states which are not implemented by\r
- * the library.\r
- *\r
- * \note This global is only present if the user application can be a USB host.\r
- *\r
- * \see \ref USB_Host_States_t for a list of possible device states\r
- *\r
- * \ingroup Group_Host\r
- */\r
- extern volatile uint8_t USB_HostState;\r
+ #if !defined(HOST_STATE_AS_GPIOR1) || defined(__DOXYGEN__)\r
+ /** Indicates the current host state machine state. When in host mode, this indicates the state\r
+ * via one of the values of the \ref USB_Host_States_t enum values.\r
+ *\r
+ * This value may be altered by the user application to implement the \ref HOST_STATE_Addressed,\r
+ * \ref HOST_STATE_Configured and \ref HOST_STATE_Suspended states which are not implemented by\r
+ * the library.\r
+ *\r
+ * To reduce program size and speed up checks of this global, it can be placed into one of the AVR's\r
+ * GPIOR hardware registers instead of RAM by defining the HOST_STATE_AS_GPIOR token to a value \r
+ * between 0 and 2 in the project makefile and passing it to the compiler via the -D switch. When\r
+ * defined, the corresponding GPIOR register should not be used in the user application except\r
+ * implicitly via the library APIs.\r
+ *\r
+ * \note This global is only present if the user application can be a USB host.\r
+ *\r
+ * \see \ref USB_Host_States_t for a list of possible device states\r
+ *\r
+ * \ingroup Group_Host\r
+ */\r
+ extern volatile uint8_t USB_HostState;\r
+ #else\r
+ #define _GET_HOST_GPIOR_NAME2(y) GPIOR ## y\r
+ #define _GET_HOST_GPIOR_NAME(x) _GET_HOST_GPIOR_NAME2(x)\r
+ #define USB_HostState _GET_HOST_GPIOR_NAME(HOST_STATE_AS_GPIOR)\r
+ #endif\r
#endif\r
\r
#if defined(USB_CAN_BE_DEVICE) || defined(__DOXYGEN__)\r
- /** Indicates the current device state machine state. When in device mode, this indicates the state\r
- * via one of the values of the \ref USB_Device_States_t enum values.\r
- *\r
- * This value should not be altered by the user application as it is handled automatically by the\r
- * library. The only exception to this rule is if the NO_LIMITED_CONTROLLER_CONNECT token is used\r
- * (see \ref EVENT_USB_Connect() and \ref EVENT_USB_Disconnect() events).\r
- *\r
- * \note This global is only present if the user application can be a USB device.\r
- *\r
- * \note This variable should be treated as read-only in the user application, and never manually\r
- * changed in value except in the circumstances outlined above.\r
- *\r
- * \see \ref USB_Device_States_t for a list of possible device states\r
- *\r
- * \ingroup Group_Device\r
- */\r
- extern volatile uint8_t USB_DeviceState;\r
+ #if !defined(DEVICE_STATE_AS_GPIOR) || defined(__DOXYGEN__)\r
+ /** Indicates the current device state machine state. When in device mode, this indicates the state\r
+ * via one of the values of the \ref USB_Device_States_t enum values.\r
+ *\r
+ * This value should not be altered by the user application as it is handled automatically by the\r
+ * library. The only exception to this rule is if the NO_LIMITED_CONTROLLER_CONNECT token is used\r
+ * (see \ref EVENT_USB_Connect() and \ref EVENT_USB_Disconnect() events).\r
+ *\r
+ * To reduce program size and speed up checks of this global, it can be placed into one of the AVR's\r
+ * GPIOR hardware registers instead of RAM by defining the DEVICE_STATE_AS_GPIOR token to a value \r
+ * between 0 and 2 in the project makefile and passing it to the compiler via the -D switch. When\r
+ * defined, the corresponding GPIOR register should not be used in the user application except\r
+ * implicitly via the library APIs.\r
+ *\r
+ * \note This global is only present if the user application can be a USB device.\r
+ *\r
+ * \note This variable should be treated as read-only in the user application, and never manually\r
+ * changed in value except in the circumstances outlined above.\r
+ *\r
+ * \see \ref USB_Device_States_t for a list of possible device states\r
+ *\r
+ * \ingroup Group_Device\r
+ */\r
+ extern volatile uint8_t USB_DeviceState;\r
+ #else\r
+ #define _GET_DEVICE_GPIOR_NAME2(y) GPIOR ## y\r
+ #define _GET_DEVICE_GPIOR_NAME(x) _GET_DEVICE_GPIOR_NAME2(x)\r
+ #define USB_DeviceState _GET_DEVICE_GPIOR_NAME(DEVICE_STATE_AS_GPIOR)\r
+ #endif\r
#endif\r
\r
/* Function Prototypes: */\r
projects / pub / USBasp.git / blobdiff