Installation Guide
Total Page:16
File Type:pdf, Size:1020Kb
Solantro Semiconductor Corp. Software Development Environment – Installation Guide Solantro Software Development Environment (SDE) Installation Guide Document Number: DPD1167 rev. 2.1 The Solantro trademark is owned by Solantro Semiconductor Corp. Windows® is a registered trademark of Microsoft Corporation. Javatm is a trademark of Oracle® Corporation. Caution - Use of Controls, adjustments or performance of procedures other than those specified herein may result in injury or damage to equipment. © 2019 Solantro Semiconductor Corp. ("Solantro"). Strictly Confidential & Proprietary to Solantro. Use and disclosure of this document and its contents is subject to a Non-Disclosure Agreement between you and Solantro. Except as permitted by such agreements, no part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, electronic, mechanical, recording, or otherwise, without the written permission of Solantro Semiconductor Corp. All rights reserved. Solantro Semiconductor Corp. DPD1167 rev. 2.1 1 Solantro Semiconductor Corp. Software Development Environment – Installation Guide Table of Contents Introduction ........................................................................................................................................... 2 Quick-start .............................................................................................................................................. 3 Directory Structure ............................................................................................................................. 4 Installation ............................................................................................................................................. 4 Helios ................................................................................................................................................................... 4 USB Driver .......................................................................................................................................................... 6 Eclipse .................................................................................................................................................................. 6 Python ............................................................................................................................................................... 15 Git ....................................................................................................................................................................... 18 PuTTY ............................................................................................................................................................... 22 Import and Build project with Eclipse ........................................................................................ 23 Establish communication ................................................................................................................ 28 Connection with PuTTY for SA4041 ....................................................................................................... 30 Connection with PuTTY for SA4011 ....................................................................................................... 33 Program the board with PuTTY ............................................................................................................... 33 Connection with Helios ............................................................................................................................... 34 Program the board with Helios ................................................................................................................ 34 References: ........................................................................................................................................... 35 Revision History ................................................................................................................................. 35 Introduction This guide assists in setting up a directory structure and installing applications for running Helios and developing firmware for Solantro’s digital power processor. Helios Test and Control Tool (Helios) is a Windows application that uses a COM port to communicate with the firmware running on Solantro’s processor ICs through a UART. The primary purpose is to observe and change program variables and hardware registers as well as loading new firmware. Eclipse is used as the Integrated Development Environment; however, the toolchain has been customized to compile Solantro’s projects for the processor. Additional Python scripts transfer the program and variable definitions to Helios for interacting with the firmware. Solantro uses Git repositories so many of the projects and applications may be cloned from an internet server to provide updates and issue tracking. Solantro’s website provides access to zipped folders of the applications and files without the Git repository or links to the origin repository if you do not wish to use version control. The Appendix contains a Quick-start summary for each step in the installation process. Solantro Semiconductor Corp. DPD1167 rev. 2.1 2 Solantro Semiconductor Corp. Software Development Environment – Installation Guide Quick-start Quick-start summary for installing the Solantro Development Environment and establishing communication with Solantro’s digital power processors. Notes: 1. This Quick-start summary is created to help during the set up process of Solantro’s Development Environment. The user should always consult the manual for detailed information. The user should use this sheet only to keep track of what has already been completed and what has yet to be done. 2. The page numbers in brackets in each step reference the page of this Installation Guide that provides additional information. Step 1 Create Directory Structure (page 1) Follow the instruction of this Installation Guide to create the directory structures. Path: \ThisPC\Documents\Solantro\ Folders: Application, Firmware, Helios Build Projects, Helios Relist Projects, Workspace, etc. Step 2 Install Helios Test & Control Tool (page 4) Copy the file Helios.zip to the folder \Application, then unzip the file. Link: www.solantro.com/product_development or http://bitbucket.org/solantro/helios Step 3 Launch Helios by double clicking on the Helios icon. Step 4 Download and install the SiLabs USB driver for interfacing with UART bus. (page 6) https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers Step 5 Install the Eclipse (eSi-RISC Development Environment) software (page 6) Link: www.solantro.com/product_development Step 6 Install Python (page 15) Download file from: http://www.python.org. Step 7 Install Putty (page 22) Download file from: http://www.putty.org. Step 8 Import and Build project with Eclipse (page 23) Copy the project file provided by Solantro to the folder \Helios Build Project Step 9 Launch Eclipse in Windows (page 23) \Start\eSi_RISC Development Suite\Eclipse Step 10 Establish communication (page 28) Solantro Semiconductor Corp. DPD1167 rev. 2.1 3 Solantro Semiconductor Corp. Software Development Environment – Installation Guide Directory Structure The directory structure, shown in Figure 1, can be created anywhere on your computer. The recommended place is your Documents folder. This structure is not mandatory, but it helps to have a consistent organization of all installations and may simplify any support issues. Figure 1 Solantro Directory Structure Applications: The Helios application should be placed inside this folder. Firmware: The Firmware folder is for Eclipse projects containing the project file source code. Helios Build Projects: When the firmware is compiled, post-build scripts transfer a zipped XML file into the directory. This allows Helios to identify and access the information for the project. Helios Release Projects: Solantro may provide XML files that work with the various evaluation board designs. This folder allows them to be stored separately from your local builds. Workspace: This folder is designated as the Eclipse workspace. It maintains your settings and could contain source code for the firmware projects Installation Helios Create an Applications folder as shown in Figure 1. Download Helios.zip from the USB memory stick (if provided with the evaluation kit) or from Solantro’s web-site at www.solantro.com/product_development, or clone it from an online repository at (http://bitbucket.org/solantro/helios). Unzip the files in the Helios folder. The content in the Helios folder is shown in Figure 2: Solantro Semiconductor Corp. DPD1167 rev. 2.1 4 Solantro Semiconductor Corp. Software Development Environment – Installation Guide Figure 2 - Helios folder Launch Helios by double clicking on the Helios.exe file. When Helios is launched for the first time, licensing terms should be accepted. Figure 3 shows the Startup screen upon the first launch of Helios. Upon first launch, Helios requires that the path to either the Build or Release directories be specified. Click on the Specify Path button (Figure 4) and choose the appropriate folder using the folder browser. Once chosen, the startup screen refreshes to show the available projects within the designated folder. Solantro Semiconductor Corp. DPD1167 rev. 2.1 5 Solantro Semiconductor Corp. Software Development Environment – Installation Guide Figure 3 Startup