Minor code cleanups for clarity.
[pub/USBasp.git] / Bootloaders / DFU / Descriptors.c
index 3a1c69c..eb5c580 100644 (file)
  */\r
 USB_Descriptor_Device_t DeviceDescriptor =\r
 {\r
-       Header:                 {Size: sizeof(USB_Descriptor_Device_t), Type: DTYPE_Device},\r
+       .Header                 = {.Size = sizeof(USB_Descriptor_Device_t), .Type = DTYPE_Device},\r
                \r
-       USBSpecification:       VERSION_BCD(01.10),\r
-       Class:                  0x00,\r
-       SubClass:               0x00,\r
-       Protocol:               0x00,\r
+       .USBSpecification       = VERSION_BCD(01.10),\r
+       .Class                  = 0x00,\r
+       .SubClass               = 0x00,\r
+       .Protocol               = 0x00,\r
                                \r
-       Endpoint0Size:          FIXED_CONTROL_ENDPOINT_SIZE,\r
+       .Endpoint0Size          = FIXED_CONTROL_ENDPOINT_SIZE,\r
                \r
-       VendorID:               0x03EB,\r
-       ProductID:              PRODUCT_ID_CODE,\r
-       ReleaseNumber:          0x0000,\r
+       .VendorID               = 0x03EB,\r
+       .ProductID              = PRODUCT_ID_CODE,\r
+       .ReleaseNumber          = 0x0000,\r
                \r
-       ManufacturerStrIndex:   NO_DESCRIPTOR,\r
-       ProductStrIndex:        0x01,\r
-       SerialNumStrIndex:      NO_DESCRIPTOR,\r
+       .ManufacturerStrIndex   = NO_DESCRIPTOR,\r
+       .ProductStrIndex        = 0x01,\r
+       .SerialNumStrIndex      = NO_DESCRIPTOR,\r
                \r
-       NumberOfConfigurations: 1\r
+       .NumberOfConfigurations = FIXED_NUM_CONFIGURATIONS\r
 };\r
 \r
 /** Configuration descriptor structure. This descriptor, located in FLASH memory, describes the usage\r
@@ -71,47 +71,47 @@ USB_Descriptor_Device_t DeviceDescriptor =
  */\r
 USB_Descriptor_Configuration_t ConfigurationDescriptor =\r
 {\r
-       Config:\r
+       .Config = \r
                {\r
-                       Header:                   {Size: sizeof(USB_Descriptor_Configuration_Header_t), Type: DTYPE_Configuration},\r
+                       .Header                   = {.Size = sizeof(USB_Descriptor_Configuration_Header_t), .Type = DTYPE_Configuration},\r
 \r
-                       TotalConfigurationSize:   sizeof(USB_Descriptor_Configuration_t),\r
-                       TotalInterfaces:          1,\r
+                       .TotalConfigurationSize   = sizeof(USB_Descriptor_Configuration_t),\r
+                       .TotalInterfaces          = 1,\r
 \r
-                       ConfigurationNumber:      1,\r
-                       ConfigurationStrIndex:    NO_DESCRIPTOR,\r
+                       .ConfigurationNumber      = 1,\r
+                       .ConfigurationStrIndex    = NO_DESCRIPTOR,\r
                                \r
-                       ConfigAttributes:         (USB_CONFIG_ATTR_BUSPOWERED | USB_CONFIG_ATTR_SELFPOWERED),\r
+                       .ConfigAttributes         = (USB_CONFIG_ATTR_BUSPOWERED | USB_CONFIG_ATTR_SELFPOWERED),\r
                        \r
-                       MaxPowerConsumption:      USB_CONFIG_POWER_MA(100)\r
+                       .MaxPowerConsumption      = USB_CONFIG_POWER_MA(100)\r
                },\r
                \r
-       DFUInterface:\r
+       .DFUInterface = \r
                {\r
-                       Header:                 {Size: sizeof(USB_Descriptor_Interface_t), Type: DTYPE_Interface},\r
+                       .Header                 = {.Size = sizeof(USB_Descriptor_Interface_t), .Type = DTYPE_Interface},\r
 \r
-                       InterfaceNumber:        0,\r
-                       AlternateSetting:       0,\r
+                       .InterfaceNumber        = 0,\r
+                       .AlternateSetting       = 0,\r
                        \r
-                       TotalEndpoints:         0,\r
+                       .TotalEndpoints         = 0,\r
                                \r
-                       Class:                  0xFE,\r
-                       SubClass:               0x01,\r
-                       Protocol:               0x02,\r
+                       .Class                  = 0xFE,\r
+                       .SubClass               = 0x01,\r
+                       .Protocol               = 0x02,\r
 \r
-                       InterfaceStrIndex:      NO_DESCRIPTOR\r
+                       .InterfaceStrIndex      = NO_DESCRIPTOR\r
                },\r
                \r
-       DFUFunctional:\r
+       .DFUFunctional = \r
                {\r
-                       Header:                 {Size: sizeof(USB_DFU_Functional_Descriptor_t), Type: DTYPE_DFUFunctional},\r
+                       .Header                 = {.Size = sizeof(USB_DFU_Functional_Descriptor_t), .Type = DTYPE_DFUFunctional},\r
                        \r
-                       Attributes:             (ATTR_CAN_UPLOAD | ATTR_CAN_DOWNLOAD),\r
+                       .Attributes             = (ATTR_CAN_UPLOAD | ATTR_CAN_DOWNLOAD),\r
 \r
-                       DetatchTimeout:         0x0000,\r
-                       TransferSize:           0x0c00,\r
+                       .DetachTimeout          = 0x0000,\r
+                       .TransferSize           = 0x0c00,\r
                \r
-                       DFUSpecification:       VERSION_BCD(01.01)\r
+                       .DFUSpecification       = VERSION_BCD(01.01)\r
                }\r
 };\r
 \r
@@ -121,9 +121,9 @@ USB_Descriptor_Configuration_t ConfigurationDescriptor =
  */ \r
 USB_Descriptor_String_t LanguageString =\r
 {\r
-       Header:                 {Size: USB_STRING_LEN(1), Type: DTYPE_String},\r
+       .Header                 = {.Size = USB_STRING_LEN(1), .Type = DTYPE_String},\r
                \r
-       UnicodeString:          {LANGUAGE_ID_ENG}\r
+       .UnicodeString          = {LANGUAGE_ID_ENG}\r
 };\r
 \r
 /** Product descriptor string. This is a Unicode string containing the product's details in human readable form,\r
@@ -132,18 +132,18 @@ USB_Descriptor_String_t LanguageString =
  */\r
 USB_Descriptor_String_t ProductString =\r
 {\r
-       Header:                 {Size: USB_STRING_LEN(18), Type: DTYPE_String},\r
+       .Header                 = {.Size = USB_STRING_LEN(18), .Type = DTYPE_String},\r
                \r
-       UnicodeString:          L"AVR DFU Bootloader"\r
+       .UnicodeString          = L"AVR DFU Bootloader"\r
 };\r
 \r
-/** This function is called by the library when in device mode, and must be overridden (see StdDescriptors.h\r
+/** This function is called by the library when in device mode, and must be overridden (see library "USB Descriptors"\r
  *  documentation) by the application code so that the address and size of a requested descriptor can be given\r
- *  to the USB library. When the device recieves a Get Descriptor request on the control endpoint, this function\r
+ *  to the USB library. When the device receives a Get Descriptor request on the control endpoint, this function\r
  *  is called so that the descriptor details can be passed back and the appropriate descriptor sent back to the\r
  *  USB host.\r
  */\r
-uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)\r
+uint16_t CALLBACK_USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** const DescriptorAddress)\r
 {\r
        const uint8_t  DescriptorType   = (wValue >> 8);\r
        const uint8_t  DescriptorNumber = (wValue & 0xFF);\r
@@ -154,22 +154,22 @@ uint16_t USB_GetDescriptor(const uint16_t wValue, const uint8_t wIndex, void** c
        switch (DescriptorType)\r
        {\r
                case DTYPE_Device:\r
-                       Address = DESCRIPTOR_ADDRESS(DeviceDescriptor);\r
+                       Address = &DeviceDescriptor;\r
                        Size    = sizeof(USB_Descriptor_Device_t);\r
                        break;\r
-               case DTYPE_Configuration:\r
-                       Address = DESCRIPTOR_ADDRESS(ConfigurationDescriptor);\r
+               case DTYPE_Configuration: \r
+                       Address = &ConfigurationDescriptor;\r
                        Size    = sizeof(USB_Descriptor_Configuration_t);\r
                        break;\r
-               case DTYPE_String:\r
+               case DTYPE_String: \r
                        if (!(DescriptorNumber))\r
                        {\r
-                               Address = DESCRIPTOR_ADDRESS(LanguageString);\r
+                               Address = &LanguageString;\r
                                Size    = LanguageString.Header.Size;\r
                        }\r
                        else\r
                        {\r
-                               Address = DESCRIPTOR_ADDRESS(ProductString);\r
+                               Address = &ProductString;\r
                                Size    = ProductString.Header.Size;\r
                        }\r
                        \r