Vinculum-II Toolchain Installation Guide

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