X-Git-Url: http://git.linex4red.de/pub/lufa.git/blobdiff_plain/e349974aa9fdd6679a385d0da66005a27706b275..6e0a26083ad76d2cea5aa934b530fdd8d6f4e7c1:/LUFA/ManPages/MigrationInformation.txt diff --git a/LUFA/ManPages/MigrationInformation.txt b/LUFA/ManPages/MigrationInformation.txt index 796e7235a..c4517982c 100644 --- a/LUFA/ManPages/MigrationInformation.txt +++ b/LUFA/ManPages/MigrationInformation.txt @@ -10,7 +10,18 @@ * to the next version released. It does not indicate all new additions to the library in each version change, only * areas relevant to making older projects compatible with the API changes of each new release. * - * \section Sec_MigrationXXXXXX Migrating from 101122 to XXXXXX + * \section Sec_MigrationXXXXXX Migrating from 110528 to XXXXXX + * Device Mode + * - The definition of the Audio class \ref USB_Audio_Descriptor_Format_t has been altered, to remove the fixed singular + * audio sample rate in the descriptor definition, and to rename the \c SampleFrequencyType to the more appropriate + * \c TotalDiscreteSampleRates. Existing applications will need to add an array of \ref USB_Audio_SampleFreq_t elements + * immediately following any \ref USB_Audio_Descriptor_Format_t descriptors, and insert the appropriate sampling rates + * supported by the device, as well as rename the descriptor elements to match the updated element names. + * - The device mode Audio class driver now requires a new user application callback, \ref CALLBACK_Audio_GetSetEndpointProperty(). + * Existing applications must implement this new callback, however if multiple sample rates or pitch control is not used, + * this function may be hard-coded to always return false for previous behaviour to be retained. + * + * \section Sec_Migration110528 Migrating from 101122 to 110528 * Non-USB Library Components * - The TWI driver \ref TWI_StartTransmission() function return type has now changed, so that the function returns an * error code from the \ref TWI_ErrorCodes_t enum instead of a boolean success flag. Existing code must now check @@ -29,7 +40,7 @@ * * USB Core * - By default, unordered Endpoint and Pipe configuration is now allowed once again, via the previous workaround of - * reconfiguring all Endpoints/Pipes in order each time a new Endpoint/Pipe is created. To minimise the compiled program + * reconfiguring all Endpoints/Pipes in order each time a new Endpoint/Pipe is created. To minimize the compiled program * size, the new \c ORDERED_EP_CONFIG compile time option may be defined in the project makefile to restrict the ordering * in exchange for a smaller compiled binary size. * - The previous F_CLOCK symbol, required in the project makefile, has been renamed to F_USB. This is due to the previous name @@ -143,7 +154,7 @@ * * Host Mode * - The \ref CDC_Host_ReceiveByte() function has changed, and now returns a signed 16-bit integer, with -1 indicating no data was - * received. This allows for more efficient coding, as a call to \ref CDC_Device_BytesReceived() is no longer needed if the exact + * received. This allows for more efficient coding, as a call to \ref CDC_Host_BytesReceived() is no longer needed if the exact * number of queued bytes received is not needed. * - The \ref CDC_Host_USBTask() now calls \ref CDC_Host_Flush() automatically, flushing any queued data to the attached device. Manual * flushing of the interface is no longer needed if the flushes should be in sync with calls to \ref CDC_Host_USBTask(). @@ -328,7 +339,7 @@ * - The HWB driver has changed to the \c Buttons driver. See the board Buttons driver documentation for the new API. * * Dual Role Mode - * - The \c USB_PowerOnFail even has been renamed to \c USB_InitFailure. + * - The \c USB_PowerOnFail event has been renamed to \c USB_InitFailure. * - The functions in \c OTG.h have been renamed to remain more consistent with the library API. See the functions in \c OTG.h for more * details. *