###########################################################################################
### ###
## ##
# ST7 USB LOW SPEED FIRMWARE LIBRARY V4.XX #
## ##
### ###
###########################################################################################
============
Version 4.21
============
* This version supports now the DFU for both Cosmic and Metrowerks (Hiware) compilers.
* All modifications only concern the DFU :
- Minor modifications concerning the placement in Cosmic of the DFU shared variables.
- Files USB_JumpTable_Cosmic/Hiware.asm created for DFU only. They contain a jump
table for all Library functions called by the application.
- Function Test_EP_Ready_NP created used for parameter passing between Library and
application (same as Set_EP_Ready_NP, etc...).
- Files USB_Rwu.c/.h created. They contain the 3 RemoteWakeUp functions. These
functions are called only by the application. These functions are now separated in another
file to simplify the compilation of the Sectors 1 and 2.
============
Version 4.20
============
* Main modification is the compatibility with the DFU class :
- The decoding of all DFU requests is added in the 'USB.c' file.
- Some variables have been created in 'Usb_Var.c' and 'USB_Def.h' files.
- The files 'USB_DFUD.c' and 'USB_DFUD.h' have been removed from Library. They have
been replaced by 'DFUDescript.c/.h' files in the appli directory of the
EvaluationKit project.
- Two workspaces have been created in Metrowerks to compile the Library alone. These
projects are only usefull for the DFU. If you don't use the DFU ignore them and use
only the 'USB', 'Macro' and 'Micro' directories.
- 2 more functions are now called by the Library depending of compilation variables :
- User_Status_In : if ENABLE_USER_STATUS_IN is defined
- User_Status_Out : if ENABLE_USER_STATUS_OUT is defined
These functions are used during DFU process but you can also decide to use them even
without the DFU. The compilation variables are defined in the USB_Opts.h file inside
the Appli directory.
* The call-back function 'Init_App_HW' has been renamed in 'User_MCU_Init' for
coherency with the above functions. Furthermore, this function is called only if one
or both conditional variables INIT_APP_ON_USB_RESET or INIT_APP_ON_END_SUSP are
defined in the 'USB_Opts.h' file.
Recommendations to switch from Library V4.11 to V4.20 :
-----------------------------------------------------
- Remove the call to the USB_DFUD files inside the MAK, PRM and LKF files.
- Rename the function 'Init_App_HW' into 'User_MCU_Init', and
- Enable the compilation variable INIT_APP_ON_USB_RESET or INIT_APP_ON_END_SUSP if
you want to use it in respectively USB_RESET or USB_ENDSUSP events.
============
Version 4.11
============
Modification of USB_Rc.c file
-----------------------------
* Call to the CallBack function 'MCU_Init' added in INT_EndSusp. This function
is used to initialize the MCU after an EndSuspend or a Remote Wakeup.
============
Version 4.10
============
Note: In this version the names "Hiware" and "MetroWerks" refers to the same toolchain
manufacturer.
General Modifications
---------------------
* The Library content has been slightly changed. It is now composed of the following
directories :
Lib
|
|-Docs : All documents related to the Library only
|
|-Macro : Files containing macro definitions
|
|-Micro : Files containing the microcontrollers registers mapping
|
|-Usb_yc : ST7 USB Low Speed Library sources crypted for Cosmic.
|
|-Usb_yh : ST7 USB Low Speed Library sources crypted for Hiware.
or
|-Usb : ST7 USB Low Speed Library sources uncrypted for Cosmic and Hiware.
Note: To obtain the uncrypted files contact your STM sales representative.
All the files placed in these directories are common for all projects and for both
Hiware and Cosmic compilers.
All the other directories and files are placed inside each project.
This new organization has been created in order to be shared easily between different
projects.
* Conditional keywords HIWARE and COSMIC have been added in many files for Library
merging between Hiware and Cosmic compilers.
WARNING: You must define one of these keywords in your MAK files depending of the
compiler you are using. See example in the MAK files of the EvalKit project.
* The USB DMA buffers definitions are now defined in the Map_72XX.c files for both
Hiware and Cosmic compilers. In the previous version these buffers were defined
differently depending of the compiler used (USB_Var.c for Hiware and map_XXXX.h for
Cosmic).
WARNING: To avoid any problem when using this Library version, replace your map files
by those presents in the Micro directory.
* The C files of the Library are now encrypted. Depending of the compiler used, these
files as well as the H files are placed either in Usb_yc (Cosmic) or in
Usb_yh (Hiware) directory.
Modification of USB.c file
--------------------------
* Include section
- "My_Init.h" is included if new condition "INIT_APP_ON_USB_RESET"
is defined. To be set in "USB_opts.h".
- "DFULayer.h" is included if existing condition "USE_DEVICE_FIRMWARE_UPGRADE" is defined.
* Function "GetInterface"
- Function compiled if new condition "USE_GET_INTERFACE" is true. To be set in"USB_opts.h".
* Function "SetInterface"
- Function created.
- Function compiled if condition "USE_SET_INTERFACE" is true. To be set in "USB_opts.h".
* Function "USBBusReset"
- Function "Init_App_HW" called if condition "INIT_APP_ON_USB_RESET" is true.
- Initialization of the "USBDataXferStatus" variable.
* Function "GetStatus"
- Modification of Interface request process to be compliant with spec (§9.4.5).
* Function "ClearFeatureStall"
- Improve robustness of "Clear Feature Remote Wakeup".
- Only "Clear Feature Halt" is allowed for EndPoints (spec).
- Add support for "Clear Feature" on EP0 IN and EP0 OUT if new
condition "USE_EP0_CLEAR_FEATURE" is true. To be set in "USB_Opts.h".
* Function "SetFeatureStall"
- Improve robustness of "Set Feature Remote Wakeup".
- Only "Set Feature Halt" is allowed for EndPoints (spec).
* Function "SetupStage"
- Add call to "SetInterface" function.
- Maximum number of bytes returned added for GET_CONFIGURATION (1), GET_STATUS (2) and GET_INTERFACE (1).
- Functions GetInterface and SetInterface are compiled if condition flags
"USE_USB_GET_INTERFACE" and "USE_USB_SET_INTERFACE" are true. To be set in "USB_Opts.h".
- Initialization of the "USBDataXferStatus" variable.
Modification of USB_Lib.c file
------------------------------
* Function "Init_USB_HW" modified : "ConfigValue=0" added, USB interrupts are masked
before switching the USB voltage regulator ON.
* Function "Disable_USB_HW" modified : USB interrupts are masked before switching the
USB voltage regulator OFF.
Modification of USB_Rc.c file
-----------------------------
* Function "SetAddress" has been modified : if the device is in the Configured state,
the address is changed and the state is not changed (even if the new address is 0).
The USB specification says that the device behaviour is not specified when this request
arrives.
* Functions "SetEP0RxStatus_IT" and "SetEP0TxStatus_IT" created to solve re-entrancy
problem. These functions are called by the INT_Usb Interrupt routine only. This solution
works for Hiware and Cosmic.
* The "@stack" keyword (for Cosmic) has been removed because re-entrancy problem is solved
by adding two new functions (SetEP0RxStatus_IT and SetEP0TxStatus_IT). This keyword
was now useless.
Modification of USB_Var.c/h files
---------------------------------
* Variable "USBDataXferStatus" created. This variable is used to send or receive more
than 8 data for HID requests (SetFeature, GetFeature, etc...). This variable is
initialized each time a SETUP token is encountered.
Modification of Map_XXXX files
------------------------------
* These files are now common for Hiware and Cosmic.
* The EPXOutBuffer/EPXInBuffer variables are now declared here for both Hiware and
Cosmic.
* The prefix "TIM" has been inserted in the Timer register names for coherency with
other registers.
========================================================
PROCEDURE TO INCLUDE THIS LIBRARY IN AN EXISTING PROJECT
========================================================
- Replace all files present in your USB directory with the files present in the directory
Usb_yc (Crypted for Cosmic) or Usb_yh (Crypted for Hiware) or Usb (Uncrypted for
Cosmic and Hiware).
- Replace all your existing "Map_XXXX.h" files with the "Map_XXXX.c" and "Map_XXXX.h"
files presents in the Micro directory.
- Add in your MAK files a new compilation variable (-DHIWARE or -DCOSMIC) depending of
the toolchain you are using.
- In the Cosmic MAK files replace "-hMap_XXXX.h" with "-hMap_XXXX.c".
============
Version 4.03
============
1) The "@stack" keyword is placed in front of re-entrant functions detected during compilation
with Cosmic compiler V4.3a.
Functions modified : SetEPnRxStatus and SetEPnTxStatus (n=0,1,2)
Files modified : Usb_Rc.c and Usb_Rc.h
IMPORTANT: The "@stack" keyword is compatibled with the Cosmic compiler version 4.3a only (or later).
2) The SOF (Start Of Frame) feature has been removed from the Library.
Files modified : Main.c, Usb_App.c, Usb_App.h, Usb_Opts.h, Usb.c, Usb_Lib.c, Usb_Rc.c,
Usb_Var.c, Usb_Lib.h, Usb_Var.h
3) S19 file automatic generation added in MAK file.
4) INT_Flash interrupt routine added for ST7263 device.
Files modified : Vect_7263.c and Int_7263.c
5) EndPoint buffer addresses changed from 0140-016F to 0180-01AF for ST7263 device.
Files modified : Map_7263.h
============
Version 4.02
============
Answer one byte (=0) to a GET_INTERFACE request for a no alternate
setting interface.
V 4.01 used to STALL this request -> not in spec.
NOTE:
* SET_INTERFACE for a no alternate setting interface is always
STALLED.
* The ST7 low speed lib does not support alternate settings, because
it is irrelevant for low speed devices (only interrupt transfer).
============
Version 4.01
============
Please refer to the document "ST7 USB Low Speed Firmware Library - V4 versus V3" for
a complete description of the changes between the versions 3.x and 4.x.
#*** END OF FILE ***
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.