Projects/Webserver/USBHostMode.c

   1 /*
   2              LUFA Library
   3      Copyright (C) Dean Camera, 2011.
   4
   5   dean [at] fourwalledcubicle [dot] com
   6            www.lufa-lib.org
   7 */
   8
   9 /*
  10   Copyright 2011  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  *
  33  *  USB Host Mode management functions and variables. This file contains the LUFA code required to
  34  *  manage the USB RNDIS host mode.
  35  */
  36
  37 #include "USBHostMode.h"
  38
  39 /** LUFA RNDIS Class driver interface configuration and state information. This structure is
  40  *  passed to all RNDIS Class driver functions, so that multiple instances of the same class
  41  *  within a device can be differentiated from one another.
  42  */
  43 USB_ClassInfo_RNDIS_Host_t Ethernet_RNDIS_Interface =
  44         {
  45                 .Config =
  46                         {
  47                                 .DataINPipeNumber           = 1,
  48                                 .DataINPipeDoubleBank       = false,
  49
  50                                 .DataOUTPipeNumber          = 2,
  51                                 .DataOUTPipeDoubleBank      = false,
  52
  53                                 .NotificationPipeNumber     = 3,
  54                                 .NotificationPipeDoubleBank = false,
  55
  56                                 .HostMaxPacketSize          = UIP_CONF_BUFFER_SIZE,
  57                         },
  58         };
  59
  60
  61 /** USB host mode management task. This function manages the RNDIS Host class driver and uIP stack when the device is
  62  *  initialized in USB host mode.
  63  */
  64 void USBHostMode_USBTask(void)
  65 {
  66         if (USB_CurrentMode != USB_MODE_Host)
  67           return;
  68
  69         switch (USB_HostState)
  70         {
  71                 case HOST_STATE_Addressed:
  72                         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
  73
  74                         uint16_t ConfigDescriptorSize;
  75                         uint8_t  ConfigDescriptorData[512];
  76
  77                         if (USB_Host_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData,
  78                                                                                                    sizeof(ConfigDescriptorData)) != HOST_GETCONFIG_Successful)
  79                         {
  80                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
  81                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
  82                                 break;
  83                         }
  84
  85                         if (RNDIS_Host_ConfigurePipes(&Ethernet_RNDIS_Interface,
  86                                                                                   ConfigDescriptorSize, ConfigDescriptorData) != RNDIS_ENUMERROR_NoError)
  87                         {
  88                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
  89                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
  90                                 break;
  91                         }
  92
  93                         if (USB_Host_SetDeviceConfiguration(1) != HOST_SENDCONTROL_Successful)
  94                         {
  95                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
  96                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
  97                                 break;
  98                         }
  99
 100                         if (RNDIS_Host_InitializeDevice(&Ethernet_RNDIS_Interface) != HOST_SENDCONTROL_Successful)
 101                         {
 102                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 103                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 104                                 break;
 105                         }
 106
 107                         uint32_t PacketFilter = (REMOTE_NDIS_PACKET_DIRECTED | REMOTE_NDIS_PACKET_BROADCAST);
 108                         if (RNDIS_Host_SetRNDISProperty(&Ethernet_RNDIS_Interface, OID_GEN_CURRENT_PACKET_FILTER,
 109                                                                                         &PacketFilter, sizeof(PacketFilter)) != HOST_SENDCONTROL_Successful)
 110                         {
 111                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 112                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 113                                 break;
 114                         }
 115
 116                         if (RNDIS_Host_QueryRNDISProperty(&Ethernet_RNDIS_Interface, OID_802_3_CURRENT_ADDRESS,
 117                                                                                           &MACAddress, sizeof(MACAddress)) != HOST_SENDCONTROL_Successful)
 118                         {
 119                                 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 120                                 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
 121                                 break;
 122                         }
 123
 124                         /* Initialize uIP stack */
 125                         uIPManagement_Init();
 126
 127                         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 128                         USB_HostState = HOST_STATE_Configured;
 129                         break;
 130                 case HOST_STATE_Configured:
 131                         uIPManagement_ManageNetwork();
 132
 133                         break;
 134         }
 135
 136         RNDIS_Host_USBTask(&Ethernet_RNDIS_Interface);
 137 }
 138
 139 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
 140  *  starts the library USB task to begin the enumeration and USB management process.
 141  */
 142 void EVENT_USB_Host_DeviceAttached(void)
 143 {
 144         LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
 145 }
 146
 147 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
 148  *  stops the library USB task management process.
 149  */
 150 void EVENT_USB_Host_DeviceUnattached(void)
 151 {
 152         LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
 153 }
 154
 155 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
 156  *  enumerated by the host and is now ready to be used by the application.
 157  */
 158 void EVENT_USB_Host_DeviceEnumerationComplete(void)
 159 {
 160         LEDs_SetAllLEDs(LEDMASK_USB_READY);
 161 }
 162
 163 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
 164 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
 165 {
 166         USB_Disable();
 167
 168         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 169         for(;;);
 170 }
 171
 172 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
 173  *  enumerating an attached USB device.
 174  */
 175 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode, const uint8_t SubErrorCode)
 176 {
 177         LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
 178 }
 179