EM MICROELECTRONIC - MARIN SA EM6819 TOOLS DEVELOPMENT QUICK START TABLE OF CONTENTS 1 INTRODUCTION... 2 1.1 DOWNLOADING THE SOFTWARE... 2 1.2 INSTALLING THE SOFTWARE... 2 2 SETTING UP THE RAISONANCE TOOLS FOR C816... 3 2.1 DOWNLOADING THE SOFTWARE... 3 2.2 INSTALLING THE SOFTWARE... 5 2.3 REGISTERING THE SOFTWARE... 5 3 EM6819 QUICK START FAQ... 7 3.1 INSTALLATION... 7 3.1.1 What are the main software available?... 7 3.1.2 Do I need to install Ride7 and Rkit-C816?... 7 3.1.3 How to install an Rkit-C816 new release?... 7 3.1.4 How to install a Ride7 new release?... 7 3.1.5 Which GNU version and operating system are supported?... 7 3.1.6 What is Rflasher7 tool?... 8 3.1.7 Which tool should be used as a stand-alone programmer SW?... 8 3.1.8 What are the main Getting started documents useful to provide general information?... 8 3.1.9 How to start with REva Board (EMRSK6819)?... 8 3.2 ADAPTERS... 9 EM Microelectronic-Marin SA 1 www.emmicroelectronic.com
1 INTRODUCTION This document will guide you through the installation of the EM6819 database and the Raisonance tools for C816 (Integrated Development Environment Ride for C816 MCU and EM6819 Low Power 8-bit Microcontroller). This document will also give you some general INFORMATION about the software and documentation available. These documents also contain some information about the hardware adapters available. 2. INSTALL EM6819 DOCUMENTATION AND SUPPORT DATABASE This installation will provide you an easy way to find in few clicks all technical documentation, user manuals, application notes, software examples, C macros etc... that you may used during your EM6819 firmware development 1.1 DOWNLOADING THE SOFTWARE Download EM6819 documentation and support database from EM FTP: ftp://emm-ftpmcuuser:4em2see@194.209.66.206/kit6819/setupdatabaseem6819.exe (Note: The database can be updated frequently, please check for updates) 1.2 INSTALLING THE SOFTWARE Run the setup file SetupDatabaseEM6819.exe and follow the steps to complete the database installation. All the available resources can be easily selected in the html page provided along the Program shortcut Database for EM6819 Microcontroller. EM Microelectronic-Marin SA 2 www.emmicroelectronic.com
2 SETTING UP THE RAISONANCE TOOLS FOR C816 Before using any of the Raisonance tools for C816, the Ride7 and RKit-C816 software must be installed and registered. 2.1 DOWNLOADING THE SOFTWARE The most recent Ride7 and RKit-C816 can be downloaded from the Raisonance extranet website: http://support-raisonance.com/extranet/home/ First you have to create an account, which is free and only requires a valid email. Then go to the Download / Download pages and Rkit-C816. EM Microelectronic-Marin SA 3 www.emmicroelectronic.com
Download the two files Ride7 and Rkit-C816 under the Last release section. Generates a Serial Key. Use the Rkit-C816 serial key generator to create a serial number which will be emailed to you. Save the key for later. Now you must install and register the software as explained in the following sections. EM Microelectronic-Marin SA 4 www.emmicroelectronic.com
2.2 INSTALLING THE SOFTWARE Perform these steps to install your new software: 1. Remove old versions of Ride7 and RKits (if any). 2. Install the new Ride7 software, then the RKit-C816 software, then validate its operation (test compilation, connection to RLink and to target CPU, etc.). Note: Some components of RKit-C816 (GCC,...) will not work correctly if installed in a path containing spaces or other complex characters. Be careful when using Windows Vista and Windows 7, especially the 64-bit versions. These versions use a default install directory named "Program Files (x86)", which contains parentheses and will make the tools fail. To be sure that your tools work correctly we recommend you install the tools in a directory with a short and simple name, such as "c:\raisonance". In the rest of this document, the installation directory of Ride7 will be referenced as "<RideInstallDir>". 3. Launch Ride7 and select Help > License. Register the software as explained in the following section. 2.3 REGISTERING THE SOFTWARE The Ride7 and RKit-C816 software must be registered to operate correctly. To activate the software you must register your RKit-C816 using your RKit-C816 Serial Key. Unregistered software functions for a 7-day evaluation period with full features. After 7 days the software can no longer be used. If this occurs, contact info@raisonance.com. 1. Log on as admin, ensure you have internet access, a working default browser and a working email address. 2. Open Ride7. If it does not open automatically, click Help->About Ride7. 3. Click the Change License button. Select the Serial Activation method, click Next. 4. Enter the Serial Key provided to you (see 3.1 Downloading the software). Click Next. EM Microelectronic-Marin SA 5 www.emmicroelectronic.com
5. Connect to the internet and click Get Activation code online to open your browser on the Raisonance server. 6. Fill in the form and click Generate and Send Activation code. 7. Check your server for an email from Raisonance Support team with the Activation Code. 8. Copy the Activation Code from the email to the Ride7 window. Click Finish. 9. Close Ride7 and open it again. Check in the About Ride7 window that you are in "Lite Suite" for RKit-C816 and "Standard version" for Ride7. Otherwise please contact the technical support (support@raisonance.com). This is what the About Ride7 window should look like: EM Microelectronic-Marin SA 6 www.emmicroelectronic.com
3 EM6819 QUICK START FAQ 3.1 INSTALLATION 3.1.1 What are the main software available? Software Description Installation This is the Software environment to write and Tools Development debug your application. For C816 and EM6819 It is based on Ride7 and Rkit- C816 EM6819 Database It contains all technical documentation, user manuals, application notes, software examples, C macros needed Instructions can be found in the Software installation Note sheet inside your tools development box. The corresponding file is SoftwareInstallationNotes.pdf. This file is available in the EM6819 Database and can be downloaded from EM web site (Microcontrollers / Download section) 3.1.2 Do I need to install Ride7 and Rkit-C816? To use Ride7 you need to install the two setup. Ride7 is the generic new IDE (Integrated Development Environment). Rkit- C816 contains all resources mandatory to use CoolRISC C816 processors. Rkit-C816 provide the GNU compilation toolchain, debugger, Debug-On-Chip driver for RLink, MCU templates and projects examples. 3.1.3 How to install an Rkit-C816 new release? A new Rkit-C816 release can be installed independently of Ride7 (assuming that Ride7 is already installed). Uninstall first the previous Rkit-C816 build (control panel -> Add/Remove program) then install the new one. 3.1.4 How to install a Ride7 new release? A new Ride7 release cannot be installed independently of RKit-C816. Uninstall first the previous Rkit-C816 and Ride7 build (control panel -> Add/Remove program) then install the new ones. 3.1.5 Which GNU version and operating system are supported? Operating system GNU Version Remark Win XP 3.2 (*) Win XP no more supported Win 7 Win 8, Win 8.1 Win 10 3.2 (*) 4.x 3.2 (*) 4.x 3.2 (*) 4.x GNU Version 3.2 cannot be used under windows 10! (*) Note: The compiler GNU compiier / Linker exists in Version 3.2 and Version 4.4 (or later Version). GNU Version 3.2 cannot be used under windows 10. There are two alternatives: - Using version 3.2: supported up to windows 8.1 - Using version 4.4: supported by Windows 7, 8 and 10. Originally the GCC toolchain was available on a Version 3.2. The Version 4.4 is also available. For different reasons it might be useful to use Version 4.4 instead of Version 3.2. 1. Version 3.2 is not supported by Windows 10 and next coming Windows operation system 2. Version 3.2 maintenance is frozen. 3. All bug fixes and new features will only appear in upgrades of Version 4.4 (4.x, 5.x, etc.). 4. Version 4.4 offers some better optimization results (typically from 10 to 15% less code footprint produced) Thanks to only few modifications in your project you can easily port your firmware from Version 3.2 to 4.4. Most aspects of the modifications are explained in this attached document Raisonance tools for C816 family Getting Started document [GettingStartedC816_Ride7.pdf file] in chapter 4.4. This file is also located under <RideInstallDir>\Raisonance \Ride\Doc\C816 folder. In case you start a new project, it is strongly recommended to directly use Version 4.4. EM Microelectronic-Marin SA 7 www.emmicroelectronic.com
3.1.6 What is Rflasher7 tool? RFlasher7 is not available for C816 derivates. 3.1.7 Which tool should be used as a stand-alone programmer SW? A dedicated tools (EM6819_PGM) must be used. An application note in the EM6819 Database describes all the options available. 3.1.8 What are the main Getting started documents useful to provide general information? The Getting started C816 introduces the first time user to the Raisonance development kit and guides you through many of the features. With the aid of this manual you should be able to quickly understand the tools, how they interact with each other and how to start developing your own projects. The Getting started EM6819 describes using an RLink and a REva board for an EM6819 with Ride7 and the monitor. If you are not using this type of hardware this document is not relevant to you. This document assumes that you have already read and understood the C816 Getting Started for Ride7, that you know how to create and use projects for making applications, and how to use the Ride7 Both Getting started can be found in the EM6819 Database - section TOOLS DEVELOPMENT. They can also be found in the C816 documentation folder of your Ride7 installation. 3.1.9 How to start with REva Board (EMRSK6819)? The documentation describing the REva board and daughter board is based on REva user manual, EM6819 Daughter board user Manual, Main devices datasheets and schematics. Documentation can be found in the EM6819 Database - section TOOLS DEVELOPMENT. Additionally, a starter-kit Getting started sheet can be found in the EM6819 Database - section TOOLS DEVELOPMENT. It will help you to start running your hardware in few steps. The starter-kit can also run a demo (demo limited version in case of starter-kit or demo Pro version in case you also have an RLink-Pro). Demo software and Quick start can be found in the EM6819 Database - section TOOLS DEVELOPMENT. EM Microelectronic-Marin SA 8 www.emmicroelectronic.com
3.2 ADAPTERS EM6819 family devices NO MORE AVAILABLE The low voltage adapter [ADP-LV] is needed. It contains level shifter and requires the target supply voltage (the adapter is not supplying the target) EM6819 family devices SEE DETAILS BELOW THIS TABLE EM6869 and EM4x7x family devices The low voltage adapter [ADP- PWR 1.0] now replace the [ADP- LV]. It contains level shifter and is able to supply the target (the adapter is supplying the target with +3V) or use the target supply voltage (the adapter is not supplying the target) The standard adapter [ADP-EM] is needed. It does not contains any level shifter and requires the target supply voltage (the adapter is not supplying the target). EM Microelectronic-Marin SA 9 www.emmicroelectronic.com
ADAPTER ADP PWR 1.0 Short Description +5V +3V LDO Jumper OFF +V APP USB RLINK +V APP Level Shifter Adapter Supplied by the H5 Application Connector USB RLINK +5V +3V LDO Jumper ON +3V Level Shifter Adapter +V APP = +3V Supply the H5 application Connector 3 Different options +V APP = +3V USB RLINK +5V +3V LDO +3V Level Shifter Adapter Supply the application H3 (Dedicated for Connector Beacon programming cable or others...) Jumper 2 1 10 9 2 6 1 5 H5 Connector H3 Connector Pin Number H3 H5 1 Vapp Vapp 2 Data /PB7 n.c. 3 n.c. n.c. 4 Clk/PB6 TM 5 Gnd n.c. 6 TM Data/PB7 7 n.c. Gnd 8 n.c. Clk/PB6 9 n.c. Gnd 10 n.c. n.c. Pinout EM Microelectronic-Marin SA ( EM ) makes no warranties for the use of EM products, other than those expressly contained in EM's applicable General Terms of Sale, located at http://www.emmicroelectronic.com. EM assumes no responsibility for any errors which may have crept into this document, reserves the right to change devices or specifications detailed herein at any time without notice, and does not make any commitment to update the information contained herein. No licenses to patents or other intellectual property rights of EM are granted in connection with the sale of EM products, neither expressly nor implicitly. In respect of the intended use of EM products by customer, customer is solely responsible for observing existing patents and other intellectual property rights of third parties and for obtaining, as the case may be, the necessary licenses. Important note: The use of EM products as components in medical devices and/or medical applications, including but not limited to, safety and life supporting systems, where malfunction of such EM products might result in damage to and/or injury or death of persons is expressly prohibited, as EM products are neither destined nor qualified for use as components in such medical devices and/or medical applications. The prohibited use of EM products in such medical devices and/or medical applications is exclusively at the risk of the customer EM Microelectronic-Marin SA 10 www.emmicroelectronic.com