Future Technology Devices International Ltd. Application Note AN_145 Vinculum-II Toolchain Installation Guide Document Reference No. FT_000285 Version 1.0 Issue Date: 2010-05-26 The purpose of this application note is to provide users of Vinculum-II (VNC2) device with a procedure for installing the Vinculum-II software development toolchain Future Technology Devices International Limited (FTDI) Unit 1,2 Seaward Place, Glasgow G41 1HH, United Kingdom Tel.: +44 (0) 141 429 2777 Fax: + 44 (0) 141 429 2758 E-Mail (Support): [email protected] Web: http://www.ftdichip.com Copyright © 2010 Future Technology Devices International Limited Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Table of Contents 1 Introduction............................................................................................ 2 2 Getting Vinculum-II Toolchain Installer ............................................... 3 3 Installing Vinculum-II Toolchain ........................................................... 4 4 Uninstalling Vinculum-II Toolchain .................................................... 10 5 Troubleshooting .................................................................................. 14 5.1 6 Cannot Find Vinculum-II Firmware Samples ................................................... 14 Contact Information............................................................................. 15 Appendix A - References .......................................................................... 17 Appendix B - Revision History.................................................................. 18 Copyright © 2010 Future Technology Devices International Limited 1 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 1 Introduction This document is intended to guide the reader through the process of installing the Vinculum-II software development toolchain. The Vinculum-II toolchain is designed to support the development of user firmware applications for the FTDI Vinculum-II (VNC2) programmable dual USB Host / Slave controller devices. The tool suite is provided as a royalty-free, „C‟ based Integrated Development Environment (IDE), which comes complete with compiler, linker and hardware debug tools. The tool suite also contains an RTOS kernel, device drivers and a range of example applications to enable designers to easily migrate to and to quickly develop applications based on the FTDI VNC2. Copyright © 2010 Future Technology Devices International Limited 2 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 2 Getting Vinculum-II Toolchain Installer The latest available Vinculum-II toolchain installer can be downloaded from the FTDI website and this can be saved to a location on your PC. The Vinculum-II toolchain runs on Windows 7, Vista and Windows XP. The instructions in this installation guide are based on the current version at the time of writing (version 1.0.4). The same instructions can be used for any future updates. Copyright © 2010 Future Technology Devices International Limited 3 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 3 Installing Vinculum-II Toolchain Run the executable file obtained from the web download by double clicking on “Vinculum-II toolchain Installer 1.0.4.exe” icon. The installer icon is located on the PC wherever the user installed it when the toolchain was downloaded from the web. It is recommended to uninstall any previous installations of the toolchain before installing a new version.If a previous toolchain is not uninstalled before the installer is run then it will prompt whether to overwrite the existing installation or remove it first (see screenshot below): Select “Yes”, to uninstall the previous installation. When this has been completed the following screen will appear: Click “Next” which will display the License Agreement screen as shown in the following screenshot: Copyright © 2010 Future Technology Devices International Limited 4 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Review the license terms and Click “I Agree” to proceed and the following screen will appear. Copyright © 2010 Future Technology Devices International Limited 5 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 By default, all components of the toolchain are installed. This guide, and FTDI's user documentation, assumes that all components are installed on a system. Click “Next” to proceed and the following screen will appear. Click “Browse” to select the folder where the Vinculum-II toolchain will be installed. The default installation location is C:\Program Files\FTDI\Vinculum II toolchain It is not essential to use the default location as shown in the above screenshot. Users can change the installation location if required. The installer will automatically activate User Account Control to request elevated privileges while installing. This allows the installer to store files in the "Program Files" area of the PC and access the registry as required. Copyright © 2010 Future Technology Devices International Limited 6 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Click “Next” to proceed and the following screen will appear Click “Browse” to browse to the required directory where the firmware samples are to be installed. The default path is (the 1.0.4 is the revision of toolchain being installed here): C:\Documents and Settings\”your name”\My Documents\FTDI\Firmware\Samples\1.0.4 For subsequent releases and installation of the toolchain, the installer will, by default, store the samples in a unique folder to avoid overwriting samples from previous installations. If, however, a path is chosen where previous samples are stored then the installer checks that the user wishes to overwrite this area before doing so (see message box below). Copyright © 2010 Future Technology Devices International Limited 7 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Once the path has been entered in the box, click “Next” to proceed and the next screen will appear Click “Install” and the next screen will appear. Copyright © 2010 Future Technology Devices International Limited 8 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 When the installation has completed a completion screen will appear as shown in the following screenshot. Click "Finish" to close the wizard and the installer displays a Readme file (Readme.txt) It is recommended that users read this file. Following installation it is recommended that the user refer to the following application note: Vinculum-II Tool Chain Getting Started Guide Copyright © 2010 Future Technology Devices International Limited 9 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 4 Uninstalling Vinculum-II Toolchain Navigate to the directory where the Vinculum-II toolchain has been installed and double click “uninstall.exe icon” The Uninstaller can also be accessed from the START menu : Start->AllPrograms->FTDI Vinculum II Toolchain->Uninstall on the Windows Toolbar. If the user has followed the installation wizard illustrated in this application note then the Vinculum-II toolchain will have been saved within the Program Files/FTDI/Vinculum II Tool Chain directory on local hard disc of the PC. The screen will appear as shown below. Copyright © 2010 Future Technology Devices International Limited 10 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Click “Next” and the following screen will appear. Copyright © 2010 Future Technology Devices International Limited 11 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Click “Uninstall” and the following screen will appear. Copyright © 2010 Future Technology Devices International Limited 12 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 When Vinculum-II toolchain has been successfully uninstalled, the screen below will automatically appear. Click “Finish” to close the wizard. Copyright © 2010 Future Technology Devices International Limited 13 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 5 Troubleshooting 5.1 Cannot Find Vinculum-II Firmware Samples Following the installation wizard of this document, the Vinculum-II Firmware Samples are by default located within the My Documents folder of your PC. Copyright © 2010 Future Technology Devices International Limited 14 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 6 Contact Information Head Office – Glasgow, UK Future Technology Devices International Limited Unit 1,2 Seaward Place, Centurion Business Park Glasgow G41 1HH United Kingdom Tel: +44 (0) 141 429 2777 Fax: +44 (0) 141 429 2758 E-mail (Sales) [email protected] E-mail (Support) [email protected] E-mail (General Enquiries) [email protected] Web Site URL http://www.ftdichip.com Web Shop URL http://www.ftdichip.com Branch Office – Taipei, Taiwan Future Technology Devices International Limited (Taiwan) 2F, No. 516, Sec. 1, NeiHu Road Taipei 114 Taiwan , R.O.C. Tel: +886 (0) 2 8791 3570 Fax: +886 (0) 2 8791 3576 E-mail (Sales) [email protected] E-mail (Support) [email protected] E-mail (General Enquiries) [email protected] Web Site URL http://www.ftdichip.com Branch Office – Hillsboro, Oregon, USA Future Technology Devices International Limited (USA) 7235 NW Evergreen Parkway, Suite 600 Hillsboro, OR 97123-5803 USA Tel: +1 (503) 547 0988 Fax: +1 (503) 547 0987 E-Mail (Sales) [email protected] E-Mail (Support) [email protected] Web Site URL http://www.ftdichip.com Branch Office – Shanghai, China Future Technology Devices International Limited (China) Room 408, 317 Xianxia Road, Shanghai, 200051 China Tel: +86 21 62351596 Fax: +86 21 62351595 E-mail (Sales) [email protected] E-mail (Support) [email protected] E-mail (General Enquiries) [email protected] Web Site URL http://www.ftdichip.com Copyright © 2010 Future Technology Devices International Limited 15 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Distributor and Sales Representatives Please visit the Sales Network page of the FTDI Web site for the contact details of our distributor(s) and sales representative(s) in your country. Vinculum is part of Future Technology Devices International Ltd. Neither the whole nor any part of the information contained in, or the product described in this manual, may be adapted or reproduced in any material or electronic form without the prior written consent of the copyright holder. This product and its documentation are supplied on an as-is basis and no warranty as to their suitability for any particular purpose is either made or implied. Future Technology Devices International Ltd will not accept any claim for damages howsoever arising as a result of use or failure of this product. Your statutory rights are not affected. This product or any variant of it is not intended for use in any medical appliance, device or system in which the failure of the product might reasonably be expected to result in personal injury. This document provides preliminary information that may be subject to change without notice. No freedom to use patents or other intellectual property rights is implied by the publication of this document. Future Technology Devices International Ltd, Unit 1, 2 Seaward Place, Centurion Business Park, Glasgow G41 1HH United Kingdom. Scotland Registered Number: SC136640 Copyright © 2010 Future Technology Devices International Limited 16 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Appendix A - References Vinculum-II (VNC2) Application and Technical Notes Vinculum-II IO Cell Description Vinculum-II Debug Interface Description Vinculum-II IO Mux Explained Vinculum-II PWM Example Migrating Vinculum Designs From VNC1L to VNC2-48L1A Vinculum-II Errata Technical Note Vinculum-II Tool Chain Getting Started Guide VINCULUM-II IO_Mux Configuration Utility User Guide Copyright © 2010 Future Technology Devices International Limited 17 Document Reference No.: FT_000285 Vinculum-II Toolchain Installation Guide Application Note AN_145 Version 1.0 Clearance No.: FTDI# 159 Appendix B - Revision History Version draft First Draft 13/05/2010 Version 1.0 First Release 26/05/2010 Copyright © 2010 Future Technology Devices International Limited 18