Home

ST40 Micro Toolset for developing ST40 applications

image

Contents

1. SZA ST40 TOOLSET ST40 Micro Toolset for developing ST40 applications Features m GNU code development tools ANSI C and C compiler for ST40 C newlib run time library and C libstdc including STL GNU archiver and other utilities Board specs defining memory area for linker Boot from Flash ROM support Extensive set of trace and profiling tools m Cross development with GDB The GNU debugger supports the ST40 simulator and development boards Includes Text User Interface TUI and the Insight GUI on all host platforms sh4xrun target loader m OS21 real time kernel provides High performance low memory footprint Tasks semaphores message queues Memory management and virtual memory API Mutexes and events Interrupt handling cache control and timers Sources supplied royalty free m instruction set simulator Programs can be run without hardware Low level execution tracing m Interface to the target through ST Micro Connect and ST TargetPack technology supplied separately m STWorkbench IDE supplied separately Bullt on the Eclipse IDE State of the art IDE for use with a range of ST toolsets Powerful editing tools and ST40 specific plug ins customize the IDE for building and debugging ST40 target applications Advanced trace and profiling tools January 2012 Data brief ST40 Micro Toolset running
2. The installation delivers the following sets of files e the source for the OS21 real time kernel library e various example applications including those using OS21 and showing the construction of Flash ROM systems Distribution media The release is distributed through the STMicroelectronics ftp site ftp st com STMicroelectronics supports its products worldwide through Sales Offices and authorized distributors Also available for download from the ftp site are e STWorkbench for ST40 Micro Toolset e ST Micro Connection package e the combined source package containing the open source components of the ST40 Micro Toolset e OSPlus base package 8124968 Rev 3 9 13 Toolset overview ST40 TOOLSET 2 6 2 7 10 13 Operating requirements The ST40 Micro Toolset has the following operating requirements e The PC package can run on an Intel compatible PC running Windows XP Vista or Windows 7 e The Linux package can run on an Intel compatible PC running Linux version Red Hat Enterprise Linux 4 5 or 6 System interface The toolset operates in conjunction with the host target interfaces listed in Table 1 Table 1 Host target interfaces ST Micro Connect 1 Description Order number None ST Micro Connect 2 with STMC I O convertor Type A to support a target debug connector type TTL IDC 20 way JTAG STMC2 40 200 1 The ST Micro Connect 1 is a legacy product that can no longer be
3. improvements to this document and the products and services described herein at any time without notice All ST products are sold pursuant to ST s terms and conditions of sale Purchasers are solely responsible for the choice selection and use of the ST products and services described herein and ST assumes no liability whatsoever relating to the choice selection or use of the ST products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein UNLESS OTHERWISE SET FORTH IN ST S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION OR INFRINGEMENT OF ANY PATENT COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT UNLESS EXPRESSLY APPROVED IN WRITING BY TWO AUTHORIZED ST REPRESENTATIVES ST PRODUCTS ARE NOT RECOMMENDED AUTHORIZED OR WARRANTED FOR
4. ordered ST Micro Connect Lite with both Type A and Type J connectors STMCLite TypeA For more information about the ST Micro Connect 2 see the ST Micro Connect 2 data brief 8161370 and for more information about the ST Micro Connect Lite see the ST Micro Connect Lite data brief 8298299 8124968 Rev 3 ST40 TOOLSET Acknowledgements Acknowledgements SuperH is a registered trademark for products originally developed by Hitachi Ltd and is owned by Renesas Technology Corporation Linux is a registered trademark of Linus Torvalds Red Hat is a registered trademark and RPM is a trademark of Red Hat Software Inc Windows is a registered trademark of Microsoft Corporation in the United States and other countries ky 8124968 Rev 3 11 15 Revision history ST40 TOOLSET Revision history Table 2 Document revision history Date Revision Changes 5 Jun 2008 A sspe This document replaces the ST40 Datasheet 27 Jan 2009 B Changes to formatting to align the document with other data briefs Added order number for STMC Lite 18 Jan 2012 3 Added information relating to OS21 that was previously in a separate data brief 12 13 8124968 Rev 3 ST40 TOOLSET Please Read Carefully Information in this document is provided solely in connection with ST products STMicroelectronics NV and its subsidiaries ST reserve the right to make changes corrections modifications or
5. overview 65 6 bb kid ru RE EE Sabon de nhs FE RR EGG REM 7 2 1 Software TOS 5 3229 rs trb Qui rado Ea eee a UR EO E eus 7 2 2 Software liIDIANOS 16 0406445hsthdoaseb ode a ides Ra NE usps 8 2 3 Documaentatlon esasa id gaa EG be WAGs RP RR eA ee ena 9 2 4 Source and example files llli 9 2 5 Distribution media 0 00 9 2 6 Operating requirements llli 10 2 7 System interface suis xo RA CEu a CKEXG RO RA SAT NE REPAS 10 Acknowledgements 2 ku xu wackx kon e RR RE ee eee RR aw iw ee ee es 11 Revision PISTON iucescaoraeos ec cmn na COR C Ox OR AR CR i a RN UC ww m ON 12 2 13 8124968 Rev 3 ky ST40 TOOLSET Introduction 1 1 Introduction The ST40 Micro Toolset is a cross development system for developing and debugging C and C embedded applications on ST40 board devices All ST40 based devices include the User Debug Interface UDI available through the JTAG port of the device which provides on chip emulation capabilities such as code and data breakpoints e watchpoints e memory peeking and poking The ST40 Micro Toolset can be enhanced by the STWorkbench IDE supplied separately STWorkbench is built on the Eclipse IDE providing a state of the art IDE for a wide range of toolsets provided by STMicroelectronics ST40 specific plug ins customize STWorkbench to support the full development cycle of ST40 target applications including program editing project workspace management
6. test coverage tool 8124968 Rev 3 7 13 Toolset overview ST40 TOOLSET 2 2 8 13 From the GNU GDB Insight package sh4gdb GNU target debugger sh4insight Graphical User Interface for the debugger sh4gdbtui Text user interface for the debugger sh4run GNU SH 4 simulator Others sh4xrun SuperH target loader censpect Statistical data viewer os21decodetrace Decodes OS21 Trace output files os21usertrace User trace tool for OS21 Trace implemented as a Perl script os21usertracegen Tool to generate definition files for os21usertrace os21prof OS21 profiler implemented as a Perl Script sh4rltool Relocatable library tool implemented as a Perl script trcview Trace data viewer Software libraries The toolset supplies libraries for each of the possible target configurations supported by sh4gcc There is one version for each permutation of the SuperH specific compiler options that affect code generation and for the Application Binary Interface ABI such as floating point and endianness Therefore for whatever permutation of target configurations a user program is compiled the compiler driver automatically selects a library with the same permutation except for optimizations Compiler run time libraries The newlib package supplies an ISO ANSI C run time library libc and libm and header files The run time libraries also provide support for low level I O and additional math functions The Data Transfer Format library libdt
7. Microsoft Windows or Linux Connection to a target development board s JTAG connector enabling the host software to start up the target download programs and debug them in the target Use of ST TargetPacks to configure a target and bring up target hardware ST TargetPacks for current evaluation boards containing ST40 parts are supplied with the ST Micro Connection Package or are available separately from STMicroelectronics For more information see the ST Micro Connect 2 data brief 8161370 The ST Micro Connect Lite is a low cost alternative to the ST Micro Connect 2 that supports only a USB connection of a target system to a PC For more information see the ST Micro Connect Lite data brief 8298299 a The ST Micro Connect 1 is still supported but can no longer be ordered 4 13 8124968 Rev 3 ky ST40 TOOLSET Introduction 1 2 OS21 real time operating system features OS21 is a real time operating system available for a range of cores including the ST4O It provides an embedded application with the features listed below e 0821 is multitasking The OS21 kernel performs real time scheduling of all the tasks in the system based upon the relative priority of each task This means that an embedded system can be designed as a collection of communicating tasks and interrupt handlers e Memory blocks can be allocated and freed from memory partitions for dynamic memory management OS21 supports three pre defi
8. USE IN MILITARY AIR CRAFT SPACE LIFE SAVING OR LIFE SUSTAINING APPLICATIONS NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY DEATH OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE ST PRODUCTS WHICH ARE NOT SPECIFIED AS AUTOMOTIVE GRADE MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER S OWN RISK Resale of ST products with provisions different from the statements and or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever any liability of ST ST and the ST logo are trademarks or registered trademarks of ST in various countries Information in this document supersedes and replaces all information previously supplied The ST logo is a registered trademark of STMicroelectronics All other names are the property of their respective owners 2012 STMicroelectronics All rights reserved STMicroelectronics group of companies Australia Belgium Brazil Canada China Czech Republic Finland France Germany Hong Kong India Israel Italy Japan Malaysia Malta Morocco Philippines Singapore Spain Sweden Switzerland United Kingdom United States of America www st com ky 8124968 Rev 3 13 13
9. f implements the low level I O The toolset also supplies an alternative I O library libgloss for building applications to run on the GNU GDB SH 4 simulator sh4run as well as a run time library libprofile to support profiling with sh4gprof From the GNU GCC package The GNU GCC package supplies compiler intrinsical libraries libgcc and variants and a run time library libgcov to support code coverage with sh4gcov From the libstdc subpackage of the GNU GCC package The libstdc subpackage of the GNU GCC package supplies an ISO ANSI C run time library libstdc and header files that support I O streams and the standard templates library the STL 8124968 Rev 3 ky ST40 TOOLSET Toolset overview 2 3 2 4 2 5 Others Other libraries include e the OS21 real time kernel library and header files and OS21 board support libraries for the various supported platforms e the relocatable loader library libri and header files e the zlib compression library libz and header files Documentation The documentation for the ST40 Micro Toolset includes ST40 Micro Toolset User Manual 7379953 ST40 Core Support Peripherals Manual 7988763 ST40 300 Core Support Peripherals Manual 8011247 ST40 Micro Toolset GDB Command Scripts 8045827 ST40 Core Architecture Manual 7182230 SH 4 Generic and C Specific ABI 7839242 OS21 User Manual 7358306 OS21 for ST40 User Manual 7358673 Source and example files
10. ion of communicating tasks and interrupt handlers 8124968 Rev 3 3 13 Introduction ST40 TOOLSET e Trace and statistical data analysis tools The toolset supports tracing of OS21 kernel activity and OS21 API function calls The user may control OS21 trace either by using GDB commands or function calls embedded in the application Trace and other statistical information can be viewed graphically in STWorkbench e Profiler support Performance data can be obtained when running an application on an ST40 simulator and used to generate statistical and trace information Performance data can also be acquired from an application running on a target board connected to an ST Micro Connect The data can be analyzed using STWorkbench e The ST40 simulator This provides an accurate software simulation of SuperH architecture cores such as the ST40 and comes in two forms Functional simulator which simulates the core accurately but ignores details such as pipelines Performance simulator which simulates the core in detail in order to model the performance e Flash ROM examples Several Flash ROM examples are provided These create applications that are able to boot from ROM on an ST40 based target e Host target interface support The ST40 Micro Toolset supports host target connection using the ST Micro Connect 2 9 or ST Micro Connect Lite The ST Micro Connect 2 supports Ethernet and USB connection of a target system to a PC running
11. ned types of memory partition heap fixed and simple in order to use limited memory resources efficiently User defined memory partitions are also permitted The standard C library functions such as malloc are available e Inter task communication is undertaken by means of message queues Tasks can send and receive messages through a simple API e Semaphores mutexes and event flags provide mechanisms for mutual exclusion and access control to a shared resource e 0821 provides several clock functions to read the current time to pause the execution of a task until a specified time and to time out an input communication OS21 uses a 64 bit signed integer to record time as a given number of clock ticks Time calculations can be carried out using simple arithmetic e The interrupt API provides a mechanism for external events such as peripherals to communicate directly with the CPU Whenever an interrupt is asserted the CPU stops executing the current task and executes the interrupt handler for that interrupt When the interrupt handler has completed the CPU resumes execution of the interrupted task e The exception API processes unexpected events that occur during the execution of an instruction by passing control to an exception handler If the exception is fatal the exception handler outputs an informative message before terminating the process For non fatal exceptions the exception handler may perform remedial actions before pa
12. on Red Hat Linux Enterprise or Windows Host target interconnect STMC2 or STMC Lite O0 al i Target system N lal ST40 cross development system Description The ST40 Micro Toolset supports application development for ST40 based systems Applications can be efficiently implemented in ANSI C or ANSI C and mapped to the target hardware In conjunction with the on chip emulation support of the ST40 the ST40 Micro Toolset supports board level debugging through the JTAG interface The tools can be used through the STWorkbench Integrated Development Environment IDE The toolset supports host target interconnection through the ST Micro Connect 2 using either Ethernet or USB connections or ST Micro Connect Lite using a USB connection only a The original ST Micro Connect product was named the ST Micro Connect This product is now known as the ST Micro Connect 1 and the term ST Micro Connect refers to the family of ST Micro Connect devices 8124968 Rev 3 1 13 For further information contact your local STMicroelectronics sales office www st com Contents ST40 TOOLSET Contents 1 lntrod ction NP rr 3 1 1 Toolset features 2 2 te ees 3 12 OS21 real time operating system features 0000 2 eee 5 1 2 1 OSPIUS iste tiv secure cm HER UR eR RR n Rd UAE UR CR am ane a ate 6 2 Toolset
13. program building program debugging advanced trace and profiling tools See the STWorkbench data brief 8063672 for more information Toolset features The ST40 Micro Toolset provides an integrated set of tools to support the development of embedded applications e Code development tools assembler linker and compiler Program development is supported by the GCC compatible C C optimizing compilers assembler linker and archiver librarian tools Assembler code can be inserted in line in C C programs The compiler and linker support mapping of application code and data objects to target memory e AC C run time system The newlib C library provides ANSI C C run time functions including support for C I O using the facilities of the host system The C run time system is provided by the GNU GCC libstdc library which includes support for the STL and iostream ISO C standard libraries e Cross development with GDB The GNU debugger GDB supports both the ST40 simulator and the hardware development boards GDB also includes a text user interface and the Insight GUI as a graphical user interface on all supported host platforms The sh4xrun tool is also available to provide a command line driven interface to simplify downloading and running applications on the ST40 based targets e 0OS21 real time kernel The OS21 real time kernel supports the design of embedded systems OS21 facilitates the decomposition of a design into a collect
14. ssing control back to the task that was running when the exception occurred It is also possible to add user defined exception handlers e Thecallback API enables user supplied hook routines to be called whenever a given OS21 event occurs e OS21 can access devices and memory over a bus using virtual addresses that map to physical addresses in the device or memory e X OS21 provides a comprehensive set of functions for handling the CPUs instruction and data caches If a level 2 cache is available OS21 can optionally drive it OS21 maintains the state of the level 2 cache from within the cache management API e 0821 provides a support framework for power management Several different power levels are defined together with a mechanism for switching between levels There is a mechanism for operations such as RAM power management and wake up interrupt validation e Board Support Packages BSPs are available for all supported platforms both as pre built binaries and as source files The BSPs declare board specific data such as a description of the interrupt system for the board and configuration options and thereby allow OS21 to be customized for any valid board chip and CPU combination OS21 is distributed in the form of source code ready to be compiled for the target SoC 8124968 Rev 3 5 3 Introduction ST40 TOOLSET 1 2 1 6 13 OSPlus OSPlus available separately is an enhancement package for OS21 that provides a n
15. umber of additional APIs for enabling device drivers such as modems printers and removable storage for example and I O infrastructure including FAT and Ext2 file systems OSPlus extensions are available to provide such additional features as a TCP IP stack anda USB stack The extension packages require the OSPlus base package to be installed as a prerequisite See OSPlus data brief 7813502 for more information 8124968 Rev 3 ky ST40 TOOLSET Toolset overview 2 2 1 Toolset overview This chapter describes the contents of the ST40 Micro Toolset Software tools The ST40 software tools include From the GNU binutils package sh4as GNU assembler sh4ld GNU linker sh4addr2line Convert addresses into file names and line numbers sh4ar Create modify and extract from archives sh4elfedit Edit the header of ELF format files sh4c filt Demangle encoded C symbols sh4gprof GNU profiler sh4nm List symbols from object files sh4objcopy Copy and translate object files sh4objdump Display information from object files sh4ranlib Generate index to archive contents sh4readelf Display contents of ELF files sh4size List file section sizes and total size sh4strings List printable strings from files sh4strip Discard symbols From the GNU make package make GNU make sh4make GNU make From the GNU GCC package sh4c GNU C compiler sh4cpp GNU C C preprocessor sh4g GNU C compiler sh4gcc GNU C compiler sh4gcov GNU

Download Pdf Manuals

image

Related Search

Related Contents

Tecumseh TA1360Y-DS1B Technical Data Sheet  Heavy Weather Pro User`s Guide  区政運営方針について  miniSATA User Manual  Catalogue vente bijoux-montres du 12 octobre  取扱説明書 インナーフォーク KIT マルチ用ローダウン ご使用前に必ず  Shure SRH550DJ User's Manual  Brodit ProClip 511606  Ryvyr M-KARA-30DE Installation Guide  60Hz - Equipos de bombeo  

Copyright © All rights reserved.
DMCA: DMCA_mwitty#outlook.com.