Added new USB_Device_GetFrameNumber() and USB_Host_GetFrameNumber() functions to...

[pub/lufa.git] / LUFA / Drivers / USB / LowLevel / Host.h

diff --git a/LUFA/Drivers/USB/LowLevel/Host.h b/LUFA/Drivers/USB/LowLevel/Host.h
index 8623c4e..40f630e 100644 (file)
--- a/LUFA/Drivers/USB/LowLevel/Host.h
+++ b/LUFA/Drivers/USB/LowLevel/Host.h
@@ -245,6 +245,33 @@
                        };
 
                /* Inline Functions: */
+                       /** Returns the current USB frame number, when in host mode. Every millisecond the USB bus is active (i.e. not suspended)
+                        *  the frame number is incremented by one.
+                        */
+                       static inline uint16_t USB_Host_GetFrameNumber(void)
+                       {
+                               return UHFNUM;
+                       }
+                       
+                       /** Enables the host mode Start Of Frame events. When enabled, this causes the
+                        *  \ref EVENT_USB_Host_StartOfFrame() event to fire once per millisecond, synchronized to the USB bus,
+                        *  at the start of each USB frame when a device is enumerated while in host mode.
+                        */
+                       static inline void USB_Host_EnableSOFEvents(void) ATTR_ALWAYS_INLINE;
+                       static inline void USB_Host_EnableSOFEvents(void)
+                       {
+                               USB_INT_Enable(USB_INT_HSOFI);
+                       }
+                               
+                       /** Disables the host mode Start Of Frame events. When disabled, this stops the firing of the
+                        *  \ref EVENT_USB_Host_StartOfFrame() event when enumerated in host mode.
+                        */
+                       static inline void USB_Host_DisableSOFEvents(void) ATTR_ALWAYS_INLINE;
+                       static inline void USB_Host_DisableSOFEvents(void)
+                       {
+                               USB_INT_Disable(USB_INT_HSOFI);
+                       }
+
                        /** Resets the USB bus, including the endpoints in any attached device and pipes on the AVR host.
                         *  USB bus resets leave the default control pipe configured (if already configured).
                         *