Demos/Host/ClassDriver/AndroidAccessoryHost/AndroidAccessoryHost.c

   1 /*
   2              LUFA Library
   3      Copyright (C) Dean Camera, 2016.
   4
   5   dean [at] fourwalledcubicle [dot] com
   6            www.lufa-lib.org
   7 */
   8
   9 /*
  10   Copyright 2016  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 disclaims 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  *
  33  *  Main source file for the AndroidAccessoryHost demo. This file contains the main tasks of
  34  *  the demo and is responsible for the initial application hardware configuration.
  35  */
  36
  37 #include "AndroidAccessoryHost.h"
  38
  39 /** LUFA Android Open Accessory Class driver interface configuration and state information. This
  40  *  structure is passed to all Android Open Accessory Class driver functions, so that multiple
  41  *  instances of the same class within a device can be differentiated from one another.
  42  */
  43 USB_ClassInfo_AOA_Host_t AndroidDevice_AOA_Interface =
  44         {
  45                 .Config =
  46                         {
  47                                 .DataINPipe             =
  48                                         {
  49                                                 .Address        = (PIPE_DIR_IN  | 1),
  50                                                 .Banks          = 1,
  51                                         },
  52                                 .DataOUTPipe            =
  53                                         {
  54                                                 .Address        = (PIPE_DIR_OUT | 2),
  55                                                 .Banks          = 1,
  56                                         },
  57                                 .PropertyStrings =
  58                                         {
  59                                                 [AOA_STRING_Manufacturer] = "Dean Camera",
  60                                                 [AOA_STRING_Model]        = "LUFA Android Demo",
  61                                                 [AOA_STRING_Description]  = "LUFA Android Demo",
  62                                                 [AOA_STRING_Version]      = "1.0",
  63                                                 [AOA_STRING_URI]          = "http://www.lufa-lib.org",
  64                                                 [AOA_STRING_Serial]       = "0000000012345678",
  65                                         },
  66                         },
  67         };
  68
  69
  70 /** Main program entry point. This routine configures the hardware required by the application, then
  71  *  enters a loop to run the application tasks in sequence.
  72  */
  73 int main(void)
  74 {
  75         SetupHardware();
  76
  77         puts_P(PSTR(ESC_FG_CYAN "Android Accessory Host Demo running.\r\n" ESC_FG_WHITE));
  78
  79         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
  80         GlobalInterruptEnable();
  81
  82         for (;;)
  83         {
  84                 AOAHost_Task();
  85
  86                 AOA_Host_USBTask(&AndroidDevice_AOA_Interface);
  87                 USB_USBTask();
  88         }
  89 }
  90
  91 /** Configures the board hardware and chip peripherals for the demo's functionality. */
  92 void SetupHardware(void)
  93 {
  94 #if (ARCH == ARCH_AVR8)
  95         /* Disable watchdog if enabled by bootloader/fuses */
  96         MCUSR &= ~(1 << WDRF);
  97         wdt_disable();
  98
  99         /* Disable clock division */
 100         clock_prescale_set(clock_div_1);
 101 #endif
 102
 103         /* Hardware Initialization */
 104         Serial_Init(9600, false);
 105         LEDs_Init();
 106         USB_Init();
 107
 108         /* Create a stdio stream for the serial port for stdin and stdout */
 109         Serial_CreateStream(NULL);
 110 }
 111
 112 /** Task to manage an enumerated USB Android Accessory device once connected, to print received data
 113  *  from the device to the serial port.
 114  */
 115 void AOAHost_Task(void)
 116 {
 117         if (USB_HostState != HOST_STATE_Configured)
 118           return;
 119
 120         if (AOA_Host_BytesReceived(&AndroidDevice_AOA_Interface))
 121         {
 122                 /* Echo received bytes from the attached device through the USART */
 123                 int16_t ReceivedByte = AOA_Host_ReceiveByte(&AndroidDevice_AOA_Interface);
 124                 if (!(ReceivedByte < 0))
 125                 {
 126                         /* Turn on and off LED1 based on the bytes received */
 127                         LEDs_ChangeLEDs(LEDS_LED1, ReceivedByte ? LEDS_LED1 : LEDS_NO_LEDS);
 128
 129                         putchar(ReceivedByte);
 130                 }
 131         }
 132 }
 133
 134 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
 135  *  starts the library USB task to begin the enumeration and USB management process.
 136  */
 137 void EVENT_USB_Host_DeviceAttached(void)
 138 {
 139         puts_P(PSTR("Device Attached.\r\n"));
 140         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
 141 }
 142
 143 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
 144  *  stops the library USB task management process.
 145  */
 146 void EVENT_USB_Host_DeviceUnattached(void)
 147 {
 148         puts_P(PSTR("\r\nDevice Unattached.\r\n"));
 149         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 150 }
 151
 152 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
 153  *  enumerated by the host and is now ready to be used by the application.
 154  */
 155 void EVENT_USB_Host_DeviceEnumerationComplete(void)
 156 {
 157         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
 158
 159         USB_Descriptor_Device_t DeviceDescriptor;
 160
 161         if (USB_Host_GetDeviceDescriptor(&DeviceDescriptor) != HOST_SENDCONTROL_Successful)
 162         {
 163                 puts_P(PSTR("Error Retrieving Device Descriptor.\r\n"));
 164                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 165                 return;
 166         }
 167
 168         bool NeedModeSwitch;
 169         if (!(AOA_Host_ValidateAccessoryDevice(&AndroidDevice_AOA_Interface, &DeviceDescriptor, &NeedModeSwitch)))
 170         {
 171                 puts_P(PSTR("Not an Android device.\r\n"));
 172                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 173                 return;
 174         }
 175
 176         if (NeedModeSwitch)
 177         {
 178                 puts_P(PSTR("Not in Accessory mode, switching...\r\n"));
 179                 AOA_Host_StartAccessoryMode(&AndroidDevice_AOA_Interface);
 180                 return;
 181         }
 182
 183         uint16_t ConfigDescriptorSize;
 184         uint8_t  ConfigDescriptorData[512];
 185
 186         if (USB_Host_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData,
 187                                                sizeof(ConfigDescriptorData)) != HOST_GETCONFIG_Successful)
 188         {
 189                 puts_P(PSTR("Error Retrieving Configuration Descriptor.\r\n"));
 190                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 191                 return;
 192         }
 193
 194         if (AOA_Host_ConfigurePipes(&AndroidDevice_AOA_Interface,
 195                                     ConfigDescriptorSize, ConfigDescriptorData) != AOA_ENUMERROR_NoError)
 196         {
 197                 puts_P(PSTR("Attached Device Not a Valid Android Accessory Class Device.\r\n"));
 198                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 199                 return;
 200         }
 201
 202         if (USB_Host_SetDeviceConfiguration(1) != HOST_SENDCONTROL_Successful)
 203         {
 204                 puts_P(PSTR("Error Setting Device Configuration.\r\n"));
 205                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 206                 return;
 207         }
 208
 209         puts_P(PSTR("Android Device Enumerated.\r\n"));
 210         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 211 }
 212
 213 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
 214 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
 215 {
 216         USB_Disable();
 217
 218         printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
 219                                  " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
 220
 221         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 222         for(;;);
 223 }
 224
 225 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
 226  *  enumerating an attached USB device.
 227  */
 228 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
 229                                             const uint8_t SubErrorCode)
 230 {
 231         printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
 232                                  " -- Error Code %d\r\n"
 233                                  " -- Sub Error Code %d\r\n"
 234                                  " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
 235
 236         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 237 }
 238
 239