STMicroelectronics STA8088 CPU Support Package
This package contains project templates and system files for the STMicroelectronics STA8088.
CrossWorks Version 4 Installation Instructions
This package can only be installed if you have the following CrossWorks license bolt-ons:
- ARM License
- To install this support package
-
- Click the Tools > Package Manager menu option to open the package manager window.
- Right click on the STMicroelectronics STA8088 CPU Support Package entry and select Install Selected Packages.
- Click Next to take you to the summary page.
- Click Next to install the package.
- Click Finish to close the package manager window.
- Click the Tools > Show Installed Packages.
- Click on the STMicroelectronics STA8088 CPU Support Package link to view the package and its contents.
- To manually install this support package
-
- If you have not done so already, follow the CrossWorks Tasking Library Package installation instructions.
- Download the file STA8088.hzq using your web browser.
- Click the Tools > Manually Install Packages menu option.
- Select the file you have just downloaded to install the package.
- Click the Tools > Show Installed Packages.
- Click on the STMicroelectronics STA8088 CPU Support Package link to view the package and its contents.
- To install this support package using other versions
Release Notes
1.0
- Initial Release.
Documentation
Creating STA8088 Projects
The STA8008 CPU support package enables projects to be created that run in the tightly couple memories (TCM) or in the Backup RAM of the STA8088. Such projects are for development and board bring up only. For production builds you should create a board specific project that has external memory that can be used as a boot source.
To create a new STA8088 project
- Select the File > New > New Project menu item.
- Select the appropriate Generic STA8088 from the Generic categories list.
- Select the required project template type from the Templates list.
- Set the required project name and location directory.
- Click OK.
To build and debug an application running in TCM
- Select the project to work on by using the Project > Set Active Project menu option.
- Select the TCM placement by clicking on the project node in the project explorer.
- Select the configuration you require by using the Build > Set Active Build Configuration menu option.
- Build the project by using the Build > Build Project menu option.
- Connect to the appropriate target in the target window.
- Download and start debugging the current project by using Debug > Start Debugging.
To build and debug an application running in Backup RAM
- Select the project to work on by using the Project > Set Active Project menu option.
- Select the SRAM placement by clicking on the project node in the project explorer.
- Select the configuration you require by using the Build > Set Active Build Configuration menu option.
- Build the project by using the Build > Build Project menu option.
- Connect to the appropriate target in the target window.
- Download and start debugging the current project by using Debug > Start Debugging.
STA8088 Project Specifics
Memory Map File
The memory map file STA8088EX_MemoryMap.xml defines the memory segments of the STA8088EX and the peripheral registers. The sizes of the ITCM and DTCM segments and the names, sizes and access types of the external memory segments are specified using macros which can be set using the Memory Map Macros project property.
Section Placement
By default the project is built to execute in ITCM located at address zero with data in placed in DTCM located at address 0x00100000. You can right click on the project node in the project explorer and change the placement to be SRAM in this case the project will be located at address 0x11000000 which is the backup RAM.
Target Reset Script
The file STA8088_Target.js contains the Reset() reset script which resets the STA8088 using the NSRST pin and then stops it as soon as possible. This will allow the boot source code to execute before the debugger can stop so it is recommended that for development to select the ROM as the boot source. The TCMReset() reset script configures the size of the TCM's and enables them. The SRAMReset() reset script maps the backup RAM to address zero.
Target Startup Code
The startup code STA8088_Startup.s defines the exception vectors and startup code. The preprocessor defines that configure the startup code are documented in the startup file itself.
Target Support Code
The files STA8088_ctl.c and STA8088_ctl_irq_handler.s provide a simple interrupt handling framework and CTL support function.
Memory Simulator
The memory map of the STA8088EX is simulated. The memory simulation parameter supplies the sizes of the simulated external memory as follows CS0 size;CS1 size;CS2 size;SQI size.
Sample Projects
- STA8088 Shared Samples (click to load project)
- STA8088 CTL Samples (click to load project)
Known Issues
- The bkpt instruction doesn't seem work? The workaround debug project property Do Not Use bkpt Instruction introduced in CrossWorks v2.1.1 is set for STA8088 projects to avoid using this instruction.
- The ldmfd sp, {r13,r14}^ instruction doesn't appear to update the user r14 register? This make CTL unsupportable on this device.
- Builds that run in backup RAM cannot do byte or short memory access.