Add incomplete Android Accessory Host LowLevel demo.
[pub/lufa.git] / Demos / Host / Incomplete / AndroidAccessoryHost / AndroidAccessoryHost.c
diff --git a/Demos/Host/Incomplete/AndroidAccessoryHost/AndroidAccessoryHost.c b/Demos/Host/Incomplete/AndroidAccessoryHost/AndroidAccessoryHost.c
new file mode 100644 (file)
index 0000000..0c15b8a
--- /dev/null
@@ -0,0 +1,267 @@
+/*\r
+             LUFA Library\r
+     Copyright (C) Dean Camera, 2011.\r
+\r
+  dean [at] fourwalledcubicle [dot] com\r
+           www.lufa-lib.org\r
+*/\r
+\r
+/*\r
+  Copyright 2011  Dean Camera (dean [at] fourwalledcubicle [dot] com)\r
+\r
+  Permission to use, copy, modify, distribute, and sell this\r
+  software and its documentation for any purpose is hereby granted\r
+  without fee, provided that the above copyright notice appear in\r
+  all copies and that both that the copyright notice and this\r
+  permission notice and warranty disclaimer appear in supporting\r
+  documentation, and that the name of the author not be used in\r
+  advertising or publicity pertaining to distribution of the\r
+  software without specific, written prior permission.\r
+\r
+  The author disclaim all warranties with regard to this\r
+  software, including all implied warranties of merchantability\r
+  and fitness.  In no event shall the author be liable for any\r
+  special, indirect or consequential damages or any damages\r
+  whatsoever resulting from loss of use, data or profits, whether\r
+  in an action of contract, negligence or other tortious action,\r
+  arising out of or in connection with the use or performance of\r
+  this software.\r
+*/\r
+\r
+/** \file\r
+ *\r
+ *  Main source file for the AndroidAccessoryHost demo. This file contains the main tasks\r
+ *  of the demo and is responsible for the initial application hardware configuration.\r
+ */\r
+\r
+#include "AndroidAccessoryHost.h"\r
+\r
+/** Main program entry point. This routine configures the hardware required by the application, then\r
+ *  enters a loop to run the application tasks in sequence.\r
+ */\r
+int main(void)\r
+{\r
+       SetupHardware();\r
+\r
+       puts_P(PSTR(ESC_FG_CYAN "Android Accessory Host Demo running.\r\n" ESC_FG_WHITE));\r
+\r
+       LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);\r
+       sei();\r
+\r
+       for (;;)\r
+       {\r
+               Android_Host_Task();\r
+               USB_USBTask();\r
+       }\r
+}\r
+\r
+/** Configures the board hardware and chip peripherals for the demo's functionality. */\r
+void SetupHardware(void)\r
+{\r
+       /* Disable watchdog if enabled by bootloader/fuses */\r
+       MCUSR &= ~(1 << WDRF);\r
+       wdt_disable();\r
+\r
+       /* Disable clock division */\r
+       clock_prescale_set(clock_div_1);\r
+\r
+       /* Hardware Initialization */\r
+       Serial_Init(9600, false);\r
+       LEDs_Init();\r
+       USB_Init();\r
+\r
+       /* Create a stdio stream for the serial port for stdin and stdout */\r
+       Serial_CreateStream(NULL);\r
+}\r
+\r
+/** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and\r
+ *  starts the library USB task to begin the enumeration and USB management process.\r
+ */\r
+void EVENT_USB_Host_DeviceAttached(void)\r
+{\r
+       puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));\r
+       LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);\r
+}\r
+\r
+/** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and\r
+ *  stops the library USB task management process.\r
+ */\r
+void EVENT_USB_Host_DeviceUnattached(void)\r
+{\r
+       puts_P(PSTR(ESC_FG_GREEN "\r\nDevice Unattached.\r\n" ESC_FG_WHITE));\r
+       LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);\r
+}\r
+\r
+/** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully\r
+ *  enumerated by the host and is now ready to be used by the application.\r
+ */\r
+void EVENT_USB_Host_DeviceEnumerationComplete(void)\r
+{\r
+       LEDs_SetAllLEDs(LEDMASK_USB_READY);\r
+}\r
+\r
+/** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */\r
+void EVENT_USB_Host_HostError(const uint8_t ErrorCode)\r
+{\r
+       USB_Disable();\r
+\r
+       printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"\r
+                                " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+\r
+       LEDs_SetAllLEDs(LEDMASK_USB_ERROR);\r
+       for(;;);\r
+}\r
+\r
+/** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while\r
+ *  enumerating an attached USB device.\r
+ */\r
+void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,\r
+                                            const uint8_t SubErrorCode)\r
+{\r
+       printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"\r
+                                " -- Error Code %d\r\n"\r
+                                " -- Sub Error Code %d\r\n"\r
+                                " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);\r
+\r
+       LEDs_SetAllLEDs(LEDMASK_USB_ERROR);\r
+}\r
+\r
+/** Task to set the configuration of the attached device after it has been enumerated. */\r
+void Android_Host_Task(void)\r
+{\r
+       uint8_t ErrorCode;\r
+\r
+       switch (USB_HostState)\r
+       {\r
+               case HOST_STATE_Addressed:\r
+                       puts_P(PSTR("Getting Device Data.\r\n"));\r
+\r
+                       /* Get and process the configuration descriptor data */\r
+                       ErrorCode = ProcessDeviceDescriptor();\r
+                       \r
+                       /* Save whether the Android device needs to be mode-switched later on */\r
+                       bool RequiresModeSwitch = (ErrorCode == NonAccessoryModeAndroidDevice);\r
+                       \r
+                       /* Error out if the device is not an Android device or an error ocurred */\r
+                       if ((ErrorCode != AccessoryModeAndroidDevice) && !(RequiresModeSwitch))\r
+                       {\r
+                               if (ErrorCode == DevControlError)\r
+                                 puts_P(PSTR(ESC_FG_RED "Control Error (Get Device).\r\n"));\r
+                               else\r
+                                 puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));\r
+\r
+                               printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+\r
+                               /* Indicate error via status LEDs */\r
+                               LEDs_SetAllLEDs(LEDS_LED1);\r
+\r
+                               /* Wait until USB device disconnected */\r
+                               USB_HostState = HOST_STATE_WaitForDeviceRemoval;\r
+                               break;\r
+                       }\r
+\r
+                       printf_P(PSTR("Android Device Detected - %sAccessory mode.\r\n"), (RequiresModeSwitch ? "Non-" : ""));\r
+\r
+                       /* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */\r
+                       if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)\r
+                       {\r
+                               printf_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"\r
+                                                        " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+\r
+                               /* Indicate error via status LEDs */\r
+                               LEDs_SetAllLEDs(LEDS_LED1);\r
+\r
+                               /* Wait until USB device disconnected */\r
+                               USB_HostState = HOST_STATE_WaitForDeviceRemoval;\r
+                               break;\r
+                       }\r
+                       \r
+                       /* Check if a valid Android device was attached, but it is not current in Accessory mode */\r
+                       if (RequiresModeSwitch)\r
+                       {\r
+                               USB_ControlRequest = (USB_Request_Header_t)\r
+                               {\r
+                                       .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_VENDOR | REQREC_DEVICE),\r
+                                       .bRequest      = ANDROID_Req_StartAccessoryMode,\r
+                                       .wValue        = 0,\r
+                                       .wIndex        = 0,\r
+                                       .wLength       = 0,\r
+                               };\r
+\r
+                               /* Send the control request for the Android device to switch to accessory mode */\r
+                               Pipe_SelectPipe(PIPE_CONTROLPIPE);\r
+                               USB_Host_SendControlRequest(NULL);\r
+                       \r
+                               /* Wait until USB device disconnected */\r
+                               USB_HostState = HOST_STATE_WaitForDeviceRemoval;\r
+                               break;\r
+                       }\r
+\r
+                       puts_P(PSTR("Getting Config Data.\r\n"));\r
+\r
+                       /* Get and process the configuration descriptor data */\r
+                       if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)\r
+                       {\r
+                               if (ErrorCode == ControlError)\r
+                                 puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));\r
+                               else\r
+                                 puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));\r
+\r
+                               printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);\r
+\r
+                               /* Indicate error via status LEDs */\r
+                               LEDs_SetAllLEDs(LEDS_LED1);\r
+\r
+                               /* Wait until USB device disconnected */\r
+                               USB_HostState = HOST_STATE_WaitForDeviceRemoval;\r
+                               break;\r
+                       }\r
+\r
+                       puts_P(PSTR("Accessory Mode Android Enumerated.\r\n"));\r
+\r
+                       USB_HostState = HOST_STATE_Configured;\r
+                       break;\r
+               case HOST_STATE_Configured:\r
+                       /* Select the data IN pipe */\r
+                       Pipe_SelectPipe(ANDROID_DATA_IN_PIPE);\r
+                       Pipe_Unfreeze();\r
+\r
+                       /* Check to see if a packet has been received */\r
+                       if (Pipe_IsINReceived())\r
+                       {\r
+                               /* Re-freeze IN pipe after the packet has been received */\r
+                               Pipe_Freeze();\r
+\r
+                               /* Check if data is in the pipe */\r
+                               if (Pipe_IsReadWriteAllowed())\r
+                               {\r
+                                       uint8_t NextReceivedByte = Pipe_BytesInPipe();\r
+                                       uint8_t LEDMask          = LEDS_NO_LEDS;\r
+\r
+                                       if (NextReceivedByte & 0x01)\r
+                                               LEDMask |= LEDS_LED1;\r
+\r
+                                       if (NextReceivedByte & 0x02)\r
+                                               LEDMask |= LEDS_LED2;\r
+\r
+                                       if (NextReceivedByte & 0x04)\r
+                                               LEDMask |= LEDS_LED3;\r
+\r
+                                       if (NextReceivedByte & 0x08)\r
+                                               LEDMask |= LEDS_LED4;\r
+\r
+                                       LEDs_SetAllLEDs(LEDMask);\r
+                               }\r
+                               else\r
+                               {\r
+                                       /* Clear the pipe after all data in the packet has been read, ready for the next packet */\r
+                                       Pipe_ClearIN();\r
+                               }\r
+                       }\r
+\r
+                       /* Re-freeze IN pipe after use */\r
+                       Pipe_Freeze();\r
+                       break;                  \r
+       }\r
+}\r
+\r