Nios II Classic Software Developer’s Handbook

Download PDF
ID 683282
Date 5/14/2015
Public
Document Table of Contents
Document Table of Contents x
1. Overview of Nios II Embedded Development 2. Getting Started with the Graphical User Interface 3. Getting Started from the Command Line 4. Nios II Software Build Tools 5. Overview of the Hardware Abstraction Layer 6. Developing Programs Using the Hardware Abstraction Layer 7. Developing Device Drivers for the Hardware Abstraction Layer 8. Exception Handling 9. Cache and Tightly-Coupled Memory 10. MicroC/OS-II Real-Time Operating System 11. Ethernet and the NicheStack TCP/IP Stack 12. Read-Only Zip File System 13. Publishing Component Information to Embedded Software 14. HAL API Reference 15. Nios II Software Build Tools Reference
1. Overview of Nios II Embedded Development x
1.1. Prerequisites for Understanding the Nios II Embedded Design Suite 1.2. Finding Nios II EDS Files 1.3. Nios II Software Development Environment 1.4. Nios II EDS Development Flows 1.5. Nios II Programs 1.6. Intel FPGA Software Packages for Embedded Systems 1.7. Nios II Embedded Design Examples 1.8. Third-Party Embedded Tools Support 1.9. Additional Nios II Information 1.10. Overview of Nios II Embedded Development Revision History
1.4. Nios II EDS Development Flows x
1.4.1. Nios II SBT Development Flow
1.4.1. Nios II SBT Development Flow x
1.4.1.1. Nios II SBT for Eclipse 1.4.1.2. Nios II SBT Command Line
1.5. Nios II Programs x
1.5.1. Makefiles and the SBT 1.5.2. Nios II Software Project Types
1.5.2. Nios II Software Project Types x
1.5.2.1. Application Project 1.5.2.2. User Library Project 1.5.2.3. BSP Project
1.7. Nios II Embedded Design Examples x
1.7.1. Hardware Examples 1.7.2. Software Examples
2. Getting Started with the Graphical User Interface x
2.1. Getting Started with Nios II Software in Eclipse 2.2. Makefiles and the Nios II SBT for Eclipse 2.3. Using the BSP Editor 2.4. Run Configurations in the SBT for Eclipse 2.5. Nios II Hardware v2 (beta) 2.6. Optimizing Project Build Time 2.7. Importing a Command-Line Project 2.8. Packaging a Library for Reuse 2.9. Creating a Software Package 2.10. Programming Flash in Intel FPGA Embedded Systems 2.11. Creating Memory Initialization Files 2.12. Running a Nios II System with ModelSim 2.13. Eclipse Usage Notes 2.14. Getting Started with the Graphical User Interface Revision History
2.1. Getting Started with Nios II Software in Eclipse x
2.1.1. The Nios II SBT for Eclipse Workbench 2.1.2. Creating a Project 2.1.3. Navigating the Project 2.1.4. Building the Project 2.1.5. Configuring the FPGA 2.1.6. Running the Project on Nios II Hardware 2.1.7. Debugging the Project on Nios II Hardware 2.1.8. Creating a Simple BSP
2.1.1. The Nios II SBT for Eclipse Workbench x
2.1.1.1. Perspectives, Editors, and Views 2.1.1.2. The Intel FPGA Bytestream Console
2.1.2. Creating a Project x
2.1.2.1. Specifying the Application 2.1.2.2. Specifying the BSP 2.1.2.3. Creating the Projects
2.1.2.1. Specifying the Application x
2.1.2.1.1. Specifying the Hardware Platform 2.1.2.1.2. Specifying the Project Name 2.1.2.1.3. Specifying the Project Template 2.1.2.1.4. Specifying the Project Location 2.1.2.1.5. Specifying the Processor
2.1.2.2. Specifying the BSP x
2.1.2.2.1. Specifying the BSP Project Name 2.1.2.2.2. Specifying the BSP Project Location 2.1.2.2.3. Selecting an Existing BSP
2.1.7. Debugging the Project on Nios II Hardware x
2.1.7.1. List of Debugging Tasks with the Nios II SBT for Eclipse 2.1.7.2. Using the Intel FPGA Bytestream Console 2.1.7.3. Run Time Stack Checking And Exception Debugging
2.1.7.1. List of Debugging Tasks with the Nios II SBT for Eclipse x
2.1.7.1.1. Console View 2.1.7.1.2. Disconnecting the Terminal from the Target
2.1.7.3. Run Time Stack Checking And Exception Debugging x
2.1.7.3.1. Nios II Exception Debugging 2.1.7.3.2. Stack Overflow
2.2. Makefiles and the Nios II SBT for Eclipse x
2.2.1. Eclipse Source Management 2.2.2. User Source Management 2.2.3. BSP Source Management
2.2.1. Eclipse Source Management x
2.2.1.1. Modifying a Makefile with Eclipse Source Management 2.2.1.2. Absolute Source Paths and Linked Resources
2.2.2. User Source Management x
2.2.2.1. Modifying a Makefile with User Source Management
2.3. Using the BSP Editor x
2.3.1. Tcl Scripting and the Nios II BSP Editor 2.3.2. Starting the Nios II BSP Editor 2.3.3. The Nios II BSP Editor Screen Layout 2.3.4. The Command Area 2.3.5. The Console Area 2.3.6. Exporting a Tcl Script 2.3.7. Creating a New BSP 2.3.8. BSP Validation Errors
2.3.4. The Command Area x
2.3.4.1. The Main Tab 2.3.4.2. The Software Packages Tab 2.3.4.3. The Drivers Tab 2.3.4.4. The Linker Script Tab 2.3.4.5. Enable File Generation Tab 2.3.4.6. Target BSP Directory Tab
2.3.4.4. The Linker Script Tab x
2.3.4.4.1. Linker Section Mappings 2.3.4.4.2. Linker Regions
2.3.5. The Console Area x
2.3.5.1. The Information Tab 2.3.5.2. The Problems Tab 2.3.5.3. The Processing Tab
2.3.7. Creating a New BSP x
2.3.7.1. Using a Tcl Script in BSP Creation
2.4. Run Configurations in the SBT for Eclipse x
2.4.1. Opening the Run Configuration Dialog Box 2.4.2. The Project Tab 2.4.3. The Target Connection Tab 2.4.4. The Debugger Tab
2.5. Nios II Hardware v2 (beta) x
2.5.1. Main Tab 2.5.2. Debugger Tab 2.5.3. Multi-Core Launches
2.7. Importing a Command-Line Project x
2.7.1. Nios II Command-Line Projects 2.7.2. Importing through the Import Wizard 2.7.3. Road Map 2.7.4. Import a Command-Line C/C++ Application 2.7.5. Import a Supporting Project 2.7.6. User-Managed Source Files
2.7.4. Import a Command-Line C/C++ Application x
2.7.4.1. Importing a Project with Absolute Source Paths
2.8. Packaging a Library for Reuse x
2.8.1. Creating the User Library 2.8.2. Using the Library
2.10. Programming Flash in Intel FPGA Embedded Systems x
2.10.1. Starting the Flash Programmer 2.10.2. Creating a Flash Programmer Settings File 2.10.3. The Flash Programmer Screen Layout 2.10.4. The Command Area 2.10.5. The Console Area 2.10.6. Saving a Flash Programmer Settings File 2.10.7. Flash Programmer Options
2.10.2. Creating a Flash Programmer Settings File x
2.10.2.1. Specifying the Hardware Configuration
2.10.5. The Console Area x
2.10.5.1. The Information Tab 2.10.5.2. The Problems Tab 2.10.5.3. The Processing Tab
2.10.7. Flash Programmer Options x
2.10.7.1. Staging Directories 2.10.7.2. Generate Files 2.10.7.3. Program Files 2.10.7.4. Erase Flash Before Programming 2.10.7.5. Run From Reset After Programming
2.11. Creating Memory Initialization Files x
2.11.1. Generate Memory Initialization Files 2.11.2. Generate Memory Initialization Files by the Legacy Method 2.11.3. Memory Initialization Files for User-Defined Memories
2.11.3. Memory Initialization Files for User-Defined Memories x
2.11.3.1. Specifying the Memory Device Information in the Advanced Tab
2.12. Running a Nios II System with ModelSim x
2.12.1. Using ModelSim with an SOPC Builder-Generated System 2.12.2. Using ModelSim with a Qsys-Generated System
2.12.2. Using ModelSim with a Qsys-Generated System x
2.12.2.1. Preparing your Software for ModelSim 2.12.2.2. Potential Error Message 2.12.2.3. Nios II GCC Tool Chain
2.12.2.3. Nios II GCC Tool Chain x
2.12.2.3.1. Nios II Specific Changes 2.12.2.3.2. GCC Changes and Enhancements
2.13. Eclipse Usage Notes x
2.13.1. Configuring Application and Library Properties 2.13.2. Configuring BSP Properties 2.13.3. Exclude from Build Not Supported 2.13.4. Selecting the Correct Launch Configuration Type 2.13.5. Target Connection Options 2.13.6. Renaming Nios II Projects 2.13.7. Running Shell Scripts from the SBT for Eclipse 2.13.8. Must Use Nios II Build Configuration 2.13.9. CDT Limitations 2.13.10. Enhancements for Build Configurations in SBT and SBT for Eclipse
2.13.1. Configuring Application and Library Properties x
2.13.1.1. Comparing the Nios II Application Properties and Nios II Library Properties tabs
2.13.10. Enhancements for Build Configurations in SBT and SBT for Eclipse x
2.13.10.1. Build Configurations in SBT 2.13.10.2. Build Configurations in SBT for Eclipse
3. Getting Started from the Command Line x
3.1. Advantages of Command-Line Software Development 3.2. Outline of the Nios II SBT Command-Line Interface 3.3. Getting Started in the SBT Command Line 3.4. Software Build Tools Scripting Basics 3.5. Running make 3.6. Getting Started from the Command Line Revision History
3.2. Outline of the Nios II SBT Command-Line Interface x
3.2.1. Utilities 3.2.2. Scripts 3.2.3. Tcl Commands 3.2.4. Tcl Scripts 3.2.5. The Nios II Command Shell
3.2.2. Scripts x
3.2.2.1. nios2-bsp 3.2.2.2. create-this-app 3.2.2.3. create-this-bsp
3.2.5. The Nios II Command Shell x
3.2.5.1. Starting the Nios II Command Shell 3.2.5.2. Auto-Executing a Command in the Nios II Command Shell
3.3. Getting Started in the SBT Command Line x
3.3.1. Prerequisites 3.3.2. Creating Hello_World for an Intel FPGA Development Board 3.3.3. Running Hello_World on an Intel FPGA Development Board 3.3.4. Debugging hello_world
3.3.4. Debugging hello_world x
3.3.4.1. Import the hello_world Application 3.3.4.2. Download Executable Code and Start the Debugger
3.4. Software Build Tools Scripting Basics x
3.4.1. Creating a BSP with a Script 3.4.2. Creating an Application Project with a Script
3.5. Running make x
3.5.1. Creating Memory Initialization Files
4. Nios II Software Build Tools x
4.1. Road Map for the SBT 4.2. Makefiles 4.3. Nios II Embedded Software Projects 4.4. Common BSP Tasks 4.5. Details of BSP Creation 4.6. Tcl Scripts for BSP Settings 4.7. Revising Your BSP 4.8. Specifying BSP Defaults 4.9. Device Drivers and Software Packages 4.10. Boot Configurations for Altera Embedded Software 4.11. Intel FPGA-Provided Embedded Development Tools 4.12. Restrictions 4.13. Nios II Software Build Tools Revision History
4.1. Road Map for the SBT x
4.1.1. What the Build Tools Create 4.1.2. Comparing the Command Line with Eclipse
4.2. Makefiles x
4.2.1. Modifying Makefiles 4.2.2. Makefile Targets
4.3. Nios II Embedded Software Projects x
4.3.1. Applications and Libraries 4.3.2. Board Support Packages 4.3.3. Software Build Process
4.3.1. Applications and Libraries x
4.3.1.1. Supported Source File Types
4.3.2. Board Support Packages x
4.3.2.1. Overview of BSP Creation 4.3.2.2. Parts of a Nios II BSP
4.3.2.2. Parts of a Nios II BSP x
4.3.2.2.1. Hardware Abstraction Layer 4.3.2.2.2. newlib C Standard Library 4.3.2.2.3. Device Drivers 4.3.2.2.4. Optional Software Packages 4.3.2.2.5. Optional Real-Time Operating System
4.4. Common BSP Tasks x
4.4.1. Adding the Nios II SBT to Your Tool Flow 4.4.2. Linking and Locating 4.4.3. Other BSP Tasks
4.4.1. Adding the Nios II SBT to Your Tool Flow x
4.4.1.1. Using Version Control 4.4.1.2. Copying, Moving, or Renaming a BSP 4.4.1.3. Handing Off a BSP
4.4.1.1. Using Version Control x
4.4.1.1.1. Creating BSP by Running a User Defined Script to Call nios2-bsp 4.4.1.1.2. Creating BSP by Manually Running nios2-bsp 4.4.1.1.3. Creating BSP before Running Make 4.4.1.1.4. Creating a Script that Uses the Command-Line Tools
4.4.2. Linking and Locating x
4.4.2.1. Creating Memory Initialization Files 4.4.2.2. Modifying Linker Memory Regions 4.4.2.3. Creating a Custom Linker Section 4.4.2.4. Changing the Default Linker Memory Region 4.4.2.5. Changing a Linker Section Mapping
4.4.2.3. Creating a Custom Linker Section x
4.4.2.3.1. Creating a Linker Section for an Existing Region 4.4.2.3.2. Dividing a Linker Region to Create a New Region and Section 4.4.2.3.3. Excerpts from Object Dump Files 4.4.2.3.4. Excerpt from Linker.x
4.4.3. Other BSP Tasks x
4.4.3.1. Creating a BSP for an Intel FPGA Development Board 4.4.3.2. Querying Settings 4.4.3.3. Managing Device Drivers 4.4.3.4. Creating a Custom Version of newlib 4.4.3.5. Controlling the stdio Device 4.4.3.6. Configuring Optimization and Debugger Options
4.4.3.6. Configuring Optimization and Debugger Options x
4.4.3.6.1. Configuring a BSP for Debugging
4.5. Details of BSP Creation x
4.5.1. BSP Settings File Creation 4.5.2. Generated and Copied Files 4.5.3. HAL BSP Files and Folders 4.5.4. Linker Map Validation
4.5.3. HAL BSP Files and Folders x
4.5.3.1. HAL BSP After Generating Files 4.5.3.2. Copied BSP Files 4.5.3.3. HAL BSP After Build
4.6. Tcl Scripts for BSP Settings x
4.6.1. Calling a Custom BSP Tcl Script
4.6.1. Calling a Custom BSP Tcl Script x
4.6.1.1. Simple Tcl Script 4.6.1.2. Tcl Script to Examine Hardware and Choose Settings
4.7. Revising Your BSP x
4.7.1. Rebuilding Your BSP 4.7.2. Regenerating Your BSP 4.7.3. Updating Your BSP 4.7.4. Recreating Your BSP
4.7.1. Rebuilding Your BSP x
4.7.1.1. What Happens 4.7.1.2. How to Rebuild Your BSP
4.7.2. Regenerating Your BSP x
4.7.2.1. What Happens 4.7.2.2. When to Regenerate Your BSP 4.7.2.3. How to Regenerate Your BSP
4.7.2.3. How to Regenerate Your BSP x
4.7.2.3.1. Regenerating Your BSP in Eclipse 4.7.2.3.2. Regenerating Your BSP from the Command Line
4.7.3. Updating Your BSP x
4.7.3.1. What Happens 4.7.3.2. When to Update Your BSP 4.7.3.3. How to Update Your BSP
4.7.4. Recreating Your BSP x
4.7.4.1. What Happens 4.7.4.2. When to Recreate Your BSP 4.7.4.3. How to Recreate Your BSP
4.7.4.3. How to Recreate Your BSP x
4.7.4.3.1. Using Tcl Scripts When Recreating Your BSP 4.7.4.3.2. Recreating Your BSP in Eclipse 4.7.4.3.3. Recreating Your BSP at the Command Line
4.8. Specifying BSP Defaults x
4.8.1. Top Level Tcl Script for BSP Defaults 4.8.2. Specifying the Default stdio Device 4.8.3. Specifying the Default System Timer 4.8.4. Specifying the Default Memory Map 4.8.5. Specifying Default Bootloader Parameters 4.8.6. Using Individual Default Tcl Procedures
4.8.5. Specifying Default Bootloader Parameters x
4.8.5.1. Boot Loader Dependent Settings
4.10. Boot Configurations for Altera Embedded Software x
4.10.1. Memory Types 4.10.2. Boot from Flash Configuration 4.10.3. Boot from Monitor Configuration 4.10.4. Run from Initialized Memory Configuration 4.10.5. Run-time Configurable Reset Configuration
4.11. Intel FPGA-Provided Embedded Development Tools x
4.11.1. Nios II Software Build Tool GUIs 4.11.2. The Nios II Command Shell 4.11.3. The Nios II Command-Line Commands
4.11.1. Nios II Software Build Tool GUIs x
4.11.1.1. The Nios II SBT for Eclipse 4.11.1.2. The Nios II BSP Editor 4.11.1.3. The Nios II Flash Programmer
4.11.3. The Nios II Command-Line Commands x
4.11.3.1. GNU Compiler Tool Chain 4.11.3.2. Nios II Software Build Tools 4.11.3.3. File Format Conversion Tools 4.11.3.4. Other Command-Line Tools
4.11.3.3. File Format Conversion Tools x
4.11.3.3.1. alt-file-convert (BETA) 4.11.3.3.2. bin2flash 4.11.3.3.3. elf2dat 4.11.3.3.4. elf2flash 4.11.3.3.5. elf2hex 4.11.3.3.6. elf2mif 4.11.3.3.7. flash2dat 4.11.3.3.8. sof2flash
4.11.3.4. Other Command-Line Tools x
4.11.3.4.1. nios2-download 4.11.3.4.2. nios2-flash-programmer-generate 4.11.3.4.3. nios2-flash-programmer 4.11.3.4.4. nios2-gdb-server 4.11.3.4.5. nios2-terminal 4.11.3.4.6. validate_zip 4.11.3.4.7. nios2-configure-sof 4.11.3.4.8. jtagconfig
5. Overview of the Hardware Abstraction Layer x
5.1. Getting Started with the Hardware Abstraction Layer 5.2. HAL Architecture for Embedded Software Systems 5.3. Embedded Hardware Supported by the HAL 5.4. Overview of the Hardware Abstraction Layer Revision History
5.2. HAL Architecture for Embedded Software Systems x
5.2.1. Services 5.2.2. Layers of a HAL-Based System 5.2.3. Applications versus Drivers 5.2.4. Generic Device Models 5.2.5. C Standard Library—newlib
5.2.4. Generic Device Models x
5.2.4.1. Device Model Classes 5.2.4.2. Benefits to Application Developers 5.2.4.3. Benefits to Device Driver Developers
5.3. Embedded Hardware Supported by the HAL x
5.3.1. Nios II Processor Core Support 5.3.2. Supported Peripherals 5.3.3. MPU Support 5.3.4. MMU Support
5.3.2. Supported Peripherals x
5.3.2.1. Provide Full HAL Support 5.3.2.2. Provide Partial HAL Support
6. Developing Programs Using the Hardware Abstraction Layer x
6.1. HAL BSP Settings 6.2. The Nios II Embedded Project Structure 6.3. The system.h System Description File 6.4. Data Widths and the HAL Type Definitions 6.5. UNIX-Style Interface 6.6. File System 6.7. Using Character-Mode Devices 6.8. Using File Subsystems 6.9. Using Timer Devices 6.10. Using Flash Devices 6.11. Using DMA Devices 6.12. Using Interrupt Controllers 6.13. Reducing Code Footprint in Embedded Systems 6.14. Boot Sequence and Entry Point 6.15. Memory Usage 6.16. Working with HAL Source Files 6.17. Developing Programs Using the Hardware Abstraction Layer Revision History
6.7. Using Character-Mode Devices x
6.7.1. Standard Input, Standard Output and Standard Error 6.7.2. General Access to Character Mode Devices 6.7.3. C++ Streams 6.7.4. /dev/null 6.7.5. Lightweight Character-Mode I/O 6.7.6. Intel FPGA Logging Functions
6.7.6. Intel FPGA Logging Functions x
6.7.6.1. Enabling Logging 6.7.6.2. Extra Logging Options 6.7.6.3. Logging Levels 6.7.6.4. Example: Creating a BSP with Logging 6.7.6.5. Custom Logging Messages 6.7.6.6. Altera Logging Files
6.8. Using File Subsystems x
6.8.1. Host-Based File System
6.9. Using Timer Devices x
6.9.1. System Clock Driver 6.9.2. Alarms 6.9.3. Timestamp Driver
6.10. Using Flash Devices x
6.10.1. Simple Flash Access 6.10.2. Block Erasure or Corruption 6.10.3. Fine-Grained Flash Access
6.10.3. Fine-Grained Flash Access x
6.10.3.1. alt_get_flash_info() 6.10.3.2. alt_erase_flash() 6.10.3.3. alt_write_flash_block() 6.10.3.4. alt_lock_flash()
6.11. Using DMA Devices x
6.11.1. DMA Transmit Channels 6.11.2. DMA Receive Channels
6.11.2. DMA Receive Channels x
6.11.2.1. Memory-to-Memory DMA Transactions
6.13. Reducing Code Footprint in Embedded Systems x
6.13.1. Enable Compiler Optimizations 6.13.2. Use Reduced Device Drivers 6.13.3. Reduce the File Descriptor Pool 6.13.4. Use /dev/null 6.13.5. Use a Smaller File I/O Library 6.13.6. Use the Lightweight Device Driver API 6.13.7. Use the Minimal Character-Mode API 6.13.8. Eliminate Unused Device Drivers 6.13.9. Eliminate Unneeded Exit Code 6.13.10. Turn off C++ Support
6.13.5. Use a Smaller File I/O Library x
6.13.5.1. Definition of 'asnprintf()' 6.13.5.2. Use the Small newlib C Library 6.13.5.3. Use UNIX-Style File I/O 6.13.5.4. Emulate ANSI C Functions
6.13.7. Use the Minimal Character-Mode API x
6.13.7.1. alt_printf() 6.13.7.2. alt_putchar() 6.13.7.3. alt_putstr() 6.13.7.4. alt_getchar()
6.13.9. Eliminate Unneeded Exit Code x
6.13.9.1. Eliminate Clean Exit 6.13.9.2. Eliminate All Exit Code
6.14. Boot Sequence and Entry Point x
6.14.1. Hosted Versus Free-Standing Applications 6.14.2. Boot Sequence for HAL-Based Programs 6.14.3. Customizing the Boot Sequence
6.14.2. Boot Sequence for HAL-Based Programs x
6.14.2.1. System Initialization Code Boot Sequence 6.14.2.2. Default Implementation Steps
6.15. Memory Usage x
6.15.1. Memory Sections 6.15.2. Assigning Code and Data to Memory Partitions 6.15.3. Placement of the Heap and Stack 6.15.4. Global Pointer Register 6.15.5. Boot Modes
6.15.2. Assigning Code and Data to Memory Partitions x
6.15.2.1. Simple Placement Options 6.15.2.2. Advanced Placement Options
6.16. Working with HAL Source Files x
6.16.1. Finding HAL Files 6.16.2. Overriding HAL Functions
7. Developing Device Drivers for the Hardware Abstraction Layer x
7.1. Driver Integration in the HAL API 7.2. The HAL Peripheral-Specific API 7.3. Preparing for HAL Driver Development 7.4. Development Flow for Creating Device Drivers 7.5. Nios II Hardware Design Concepts 7.6. Accessing Hardware 7.7. Creating Embedded Drivers for HAL Device Classes 7.8. Integrating a Device Driver in the HAL 7.9. Creating a Custom Device Driver for the HAL 7.10. Reducing Code Footprint in HAL Embedded Drivers 7.11. HAL Namespace Allocation 7.12. Overriding the HAL Default Device Drivers 7.13. Developing Device Drivers for the Hardware Abstraction Layer Revision History
7.5. Nios II Hardware Design Concepts x
7.5.1. The Relationship Between the .sopcinfo File and system.h 7.5.2. Using the System Generation Tool to Optimize Hardware 7.5.3. Components, Devices, and Peripherals
7.7. Creating Embedded Drivers for HAL Device Classes x
7.7.1. Character-Mode Device Drivers 7.7.2. File Subsystem Drivers 7.7.3. Timer Device Drivers 7.7.4. Flash Device Drivers 7.7.5. DMA Device Drivers 7.7.6. Ethernet Device Drivers
7.7.1. Character-Mode Device Drivers x
7.7.1.1. Create a Device Instance 7.7.1.2. Register a Character Device
7.7.1.1. Create a Device Instance x
7.7.1.1.1. Modifying the Global Error Status, errno 7.7.1.1.2. Default Behavior for Functions Defined in alt_dev
7.7.2. File Subsystem Drivers x
7.7.2.1. Create a Device Instance 7.7.2.2. Register a File Subsystem Device
7.7.3. Timer Device Drivers x
7.7.3.1. System Clock Driver 7.7.3.2. Timestamp Driver
7.7.4. Flash Device Drivers x
7.7.4.1. Create a Flash Driver 7.7.4.2. Register a Flash Device
7.7.5. DMA Device Drivers x
7.7.5.1. DMA Transmit Channel 7.7.5.2. DMA Receive Channel
7.7.6. Ethernet Device Drivers x
7.7.6.1. Layered Software Model 7.7.6.2. Writing a New Ethernet Device Driver 7.7.6.3. Provide the NicheStack Hardware Interface Routines 7.7.6.4. Provide *INSTANCE and *INIT Macros 7.7.6.5. Provide a Software Initialization Function
7.8. Integrating a Device Driver in the HAL x
7.8.1. Overview 7.8.2. Assumptions and Requirements 7.8.3. The Nios II BSP Generator 7.8.4. File Names and Locations 7.8.5. Driver and Software Package Tcl Script Creation
7.8.3. The Nios II BSP Generator x
7.8.3.1. Component Discovery 7.8.3.2. Device Driver Versions 7.8.3.3. Device Driver and Software Package Inclusion
7.8.3.3. Device Driver and Software Package Inclusion x
7.8.3.3.1. Specific Requests 7.8.3.3.2. No Specific Requests
7.8.4. File Names and Locations x
7.8.4.1. Source Code Discovery
7.8.5. Driver and Software Package Tcl Script Creation x
7.8.5.1. Example Device Driver File Hierarchy and Naming 7.8.5.2. Tcl Command Walkthrough for a Typical Driver or Software Package 7.8.5.3. Creating Settings for Device Drivers and Software Packages
7.8.5.2. Tcl Command Walkthrough for a Typical Driver or Software Package x
7.8.5.2.1. Creating and Naming the Driver or Package 7.8.5.2.2. Identifying the Hardware Component Class 7.8.5.2.3. Setting the BSP Type 7.8.5.2.4. Specifying an Operating System 7.8.5.2.5. Specifying Source Files 7.8.5.2.6. Specifying a Subdirectory 7.8.5.2.7. Enabling Software Initialization 7.8.5.2.8. Adding Include Paths 7.8.5.2.9. Version Compatibility
7.8.5.3. Creating Settings for Device Drivers and Software Packages x
7.8.5.3.1. How Settings Affect the Generated BSP 7.8.5.3.2. Data Types 7.8.5.3.3. Setting Destination Files 7.8.5.3.4. Setting Display Name 7.8.5.3.5. Setting Generation Name 7.8.5.3.6. Setting Default Value 7.8.5.3.7. Setting Description 7.8.5.3.8. Setting Creation Example
7.9. Creating a Custom Device Driver for the HAL x
7.9.1. Header Files and alt_sys_init.c 7.9.2. Device Driver Source Code
7.9.1. Header Files and alt_sys_init.c x
7.9.1.1. Creating alt_sys_init.c Based on Associated Header Files 7.9.1.2. altera_avalon_jtag_uart.h Defining Macros
7.10. Reducing Code Footprint in HAL Embedded Drivers x
7.10.1. Provide Reduced Footprint Drivers 7.10.2. Support the Lightweight Device Driver API
7.10.2. Support the Lightweight Device Driver API x
7.10.2.1. Using Character-Mode Functions 7.10.2.2. Using Macros 7.10.2.3. Invoking Macros in Your Application Software 7.10.2.4. Calling Direct Without Macros
8. Exception Handling x
8.1. Nios II Exception Handling Overview 8.2. Nios II Interrupt Service Routines 8.3. Improving Nios II ISR Performance 8.4. Debugging Nios II ISRs 8.5. HAL Exception Handling System Implementation 8.6. The Nios II Instruction-Related Exception Handler 8.7. Exception Handling Revision History
8.1. Nios II Exception Handling Overview x
8.1.1. Exception Handling Terminology 8.1.2. Interrupt Controllers 8.1.3. Latency and Response Time
8.1.2. Interrupt Controllers x
8.1.2.1. Internal Interrupt Concepts 8.1.2.2. External Interrupt Concepts
8.1.2.2. External Interrupt Concepts x
8.1.2.2.1. Requested Handler Address 8.1.2.2.2. Requested Interrupt Level 8.1.2.2.3. Requested Register Set 8.1.2.2.4. Requested NMI Mode 8.1.2.2.5. Shadow Register Sets
8.1.3. Latency and Response Time x
8.1.3.1. Internal or External Interrupt Controller 8.1.3.2. Shadow Register Sets 8.1.3.3. How the Internal Interrupt Controller Works 8.1.3.4. How an External Interrupt Controller Works
8.1.3.2. Shadow Register Sets x
8.1.3.2.1. How the Hardware Works
8.2. Nios II Interrupt Service Routines x
8.2.1. HAL APIs for Hardware Interrupts 8.2.2. HAL ISR Restrictions 8.2.3. Writing an ISR 8.2.4. Registering an ISR with the Enhanced Interrupt API 8.2.5. Enabling and Disabling Interrupts 8.2.6. Configuring an External Interrupt Controller 8.2.7. C Example 8.2.8. Upgrading to the Enhanced HAL Interrupt API
8.2.1. HAL APIs for Hardware Interrupts x
8.2.1.1. Selecting an Interrupt API 8.2.1.2. The Enhanced HAL Interrupt API 8.2.1.3. Using the Enhanced HAL Interrupt API to Implement ISRs 8.2.1.4. The Legacy HAL Interrupt API 8.2.1.5. Supporting Multiple Interrupt APIs
8.2.1.3. Using the Enhanced HAL Interrupt API to Implement ISRs x
8.2.1.3.1. The External Interrupt Controller Driver 8.2.1.3.2. Using the HAL Interrupt API with the VIC
8.2.1.4. The Legacy HAL Interrupt API x
8.2.1.4.1. Using the Legacy HAL API to Implement ISRs
8.2.3. Writing an ISR x
8.2.3.1. Using Interrupt Funnels 8.2.3.2. Running in a Restricted Environment 8.2.3.3. Managing Pre-Emption
8.2.4. Registering an ISR with the Enhanced Interrupt API x
8.2.4.1. Methods the HAL Uses to Register the ISR
8.2.7. C Example x
8.2.7.1. An ISR to Service a Button PIO Interrupt 8.2.7.2. Registering the Button PIO ISR with the HAL
8.3. Improving Nios II ISR Performance x
8.3.1. Software Performance Improvements 8.3.2. Hardware Performance Improvements
8.3.1. Software Performance Improvements x
8.3.1.1. Execute Time-Intensive Algorithms in the Application Context 8.3.1.2. Implement Time-Intensive Algorithms in Hardware 8.3.1.3. Increase Buffer Size 8.3.1.4. Use Double Buffering 8.3.1.5. Keep Interrupts Enabled 8.3.1.6. Use Fast Memory 8.3.1.7. Use a Separate Exception Stack 8.3.1.8. Use Nested Hardware Interrupts 8.3.1.9. Locate ISR Body in Vector Table 8.3.1.10. Use Compiler Optimization
8.3.1.7. Use a Separate Exception Stack x
8.3.1.7.1. Separate General Exception Stack 8.3.1.7.2. Separate Hardware Interrupt Stack
8.3.1.8. Use Nested Hardware Interrupts x
8.3.1.8.1. Nested Hardware Interrupts with the Internal Interrupt Controller 8.3.1.8.2. Nested Hardware Interrupts with an External Interrupt Controller
8.3.2. Hardware Performance Improvements x
8.3.2.1. Use Vectored Hardware Interrupts 8.3.2.2. Add Fast Memory 8.3.2.3. Add a DMA Controller 8.3.2.4. Place the Handler in Fast Memory 8.3.2.5. Use a Fast Nios II Core 8.3.2.6. Select Hardware Interrupt Priorities
8.3.2.1. Use Vectored Hardware Interrupts x
8.3.2.1.1. Using the Interrupt Vector Custom Instruction 8.3.2.1.2. Using an External Interrupt Controller
8.3.2.6. Select Hardware Interrupt Priorities x
8.3.2.6.1. Hardware Interrupt Priorities with the Internal Interrupt Controller 8.3.2.6.2. Hardware Interrupt Priorities with an External Interrupt Controller
8.5. HAL Exception Handling System Implementation x
8.5.1. Exception Handling System Structure 8.5.2. General Exception Funnel 8.5.3. Hardware Interrupt Funnel 8.5.4. Software Exception Funnel 8.5.5. Invalid Instructions
8.5.2. General Exception Funnel x
8.5.2.1. Hardware Interrupt Dispatch with the Internal Interrupt Controller 8.5.2.2. Returning from Exceptions
8.5.3. Hardware Interrupt Funnel x
8.5.3.1. Interrupt Funnel for the Internal Interrupt Controller 8.5.3.2. Interrupt Funnels for External Interrupt Controllers 8.5.3.3. Interrupt Funnels for Internal Interrupt Controllers
8.5.4. Software Exception Funnel x
8.5.4.1. Unimplemented Instructions 8.5.4.2. Instruction-Related Exceptions 8.5.4.3. Software Trap Handling 8.5.4.4. Miscellaneous Exceptions
8.5.4.1. Unimplemented Instructions x
8.5.4.1.1. When to Use the Unimplemented Instruction Handler 8.5.4.1.2. Using the Unimplemented Instruction Handler
8.6. The Nios II Instruction-Related Exception Handler x
8.6.1. Writing an Instruction-Related Exception Handler 8.6.2. Registering an Instruction-Related Exception Handler 8.6.3. Removing an Instruction-Related Exception Handler
8.6.1. Writing an Instruction-Related Exception Handler x
8.6.1.1. Exception Cause Codes
9. Cache and Tightly-Coupled Memory x
9.1. Nios II Cache Implementation 9.2. HAL API Functions for Managing Cache 9.3. Initializing the Nios II Cache after Reset 9.4. Nios II Device Driver Cache Considerations 9.5. Cache Considerations for Writing Program Loaders 9.6. Managing Cache in Multi-Master and Multi-Processor Systems 9.7. Nios II Tightly-Coupled Memory 9.8. Cache and Tightly-Coupled Memory Revision History
9.1. Nios II Cache Implementation x
9.1.1. Defining Cache Properties
9.3. Initializing the Nios II Cache after Reset x
9.3.1. Assembly Code to Initialize the Instruction Cache 9.3.2. Assembly Code to Initialize the Data Cache 9.3.3. HAL Behavior for Initializing the Nios II Cache after Reset
9.4. Nios II Device Driver Cache Considerations x
9.4.1. HAL Behavior for Nios II Device Driver Cache Considerations
9.5. Cache Considerations for Writing Program Loaders x
9.5.1. HAL Behavior for Cache Considerations for Writing Program Loaders
9.6. Managing Cache in Multi-Master and Multi-Processor Systems x
9.6.1. Bit-31 Cache Bypass 9.6.2. HAL Behavior for Managing Cache in Multi-Master and Multi-Processor Systems
10. MicroC/OS-II Real-Time Operating System x
10.1. Overview of the MicroC/OS-II RTOS 10.2. Other RTOS Providers 10.3. The Nios II Implementation of MicroC/OS-II 10.4. Implementing MicroC/OS-II Projects for the Nios II Processor 10.5. MicroC/OS-II Real-Time Operating System Revision History
10.1. Overview of the MicroC/OS-II RTOS x
10.1.1. Licensing
10.3. The Nios II Implementation of MicroC/OS-II x
10.3.1. MicroC/OS-II Architecture 10.3.2. MicroC/OS-II Device Drivers 10.3.3. Thread-Safe HAL Drivers 10.3.4. The newlib ANSI C Standard Library 10.3.5. Interrupt Service Routines for MicroC/OS-II
11. Ethernet and the NicheStack TCP/IP Stack x
11.1. Prerequisites for Understanding the NicheStack TCP/IP Stack 11.2. Introduction to the NicheStack TCP/IP Stack - Nios II Edition 11.3. Other TCP/IP Stack Providers for the Nios II Processor 11.4. Using the NicheStack TCP/IP Stack - Nios II Edition 11.5. Configuring the NicheStack TCP/IP Stack in a Nios II Program 11.6. Further Information 11.7. Known Limitations 11.8. Ethernet and the NicheStack TCP/IP Stack - Nios II Edition Revision History
11.2. Introduction to the NicheStack TCP/IP Stack - Nios II Edition x
11.2.1. The NicheStack TCP/IP Stack Files and Directories 11.2.2. Support and Licensing
11.4. Using the NicheStack TCP/IP Stack - Nios II Edition x
11.4.1. Nios II System Requirements 11.4.2. The NicheStack TCP/IP Stack Tasks 11.4.3. Initializing the Stack 11.4.4. Calling the Sockets Interface
11.4.3. Initializing the Stack x
11.4.3.1. alt_iniche_init() 11.4.3.2. netmain() 11.4.3.3. iniche_net_ready 11.4.3.4. get_mac_addr() and get_ip_addr()
11.4.3.4. get_mac_addr() and get_ip_addr() x
11.4.3.4.1. Prototype for get_mac_addr() 11.4.3.4.2. Prototype for get_ip_addr()
11.5. Configuring the NicheStack TCP/IP Stack in a Nios II Program x
11.5.1. NicheStack TCP/IP Stack General Settings 11.5.2. IP Options 11.5.3. TCP Options
12. Read-Only Zip File System x
12.1. Using the Read-Only Zip File System in a Project 12.2. Read-Only Zip File System Revision History
12.1. Using the Read-Only Zip File System in a Project x
12.1.1. Preparing the Zip File 12.1.2. Programming the Zip File to Flash
13. Publishing Component Information to Embedded Software x
13.1. Embedded Component Information Flow 13.2. Embedded Software Assignments 13.3. Publishing Component Information to Embedded Software Revision History
13.1. Embedded Component Information Flow x
13.1.1. Embedded Component Information Flow Diagram 13.1.2. Tcl Assignment Statements
13.2. Embedded Software Assignments x
13.2.1. C Macro Namespace 13.2.2. Configuration Namespace 13.2.3. Memory Initialization Namespace
13.2.1. C Macro Namespace x
13.2.1.1. Generated Macro in system.h 13.2.1.2. GCC C/C++ 32-bit Processor Constants
13.2.2. Configuration Namespace x
13.2.2.1. Configuration Data Types 13.2.2.2. Component Configuration Information 13.2.2.3. Memory-Mapped Slave Information 13.2.2.4. Streaming Source Information 13.2.2.5. Streaming Sink Information
14. HAL API Reference x
14.1. HAL API Functions 14.2. HAL Standard Types 14.3. ADC HAL Device Driver 14.4. HAL API Reference Revision History
14.1. HAL API Functions x
14.1.1. _exit() 14.1.2. _rename() 14.1.3. alt_dcache_flush() 14.1.4. alt_dcache_flush_all() 14.1.5. alt_dcache_flush_no_writeback() 14.1.6. alt_uncached_malloc() 14.1.7. alt_uncached_free() 14.1.8. alt_remap_uncached() 14.1.9. alt_remap_cached() 14.1.10. alt_icache_flush_all() 14.1.11. alt_icache_flush() 14.1.12. alt_alarm_start() 14.1.13. alt_alarm_stop() 14.1.14. alt_dma_rxchan_depth() 14.1.15. alt_dma_rxchan_close() 14.1.16. alt_dev_reg() 14.1.17. alt_dma_rxchan_open() 14.1.18. alt_dma_rxchan_prepare() 14.1.19. alt_dma_rxchan_reg() 14.1.20. alt_dma_txchan_close() 14.1.21. alt_dma_txchan_ioctl() 14.1.22. alt_dma_txchan_open() 14.1.23. alt_dma_txchan_reg() 14.1.24. alt_flash_close_dev() 14.1.25. alt_exception_cause_generated_bad_addr() 14.1.26. alt_erase_flash_block() 14.1.27. alt_dma_rxchan_ioctl() 14.1.28. alt_dma_txchan_space() 14.1.29. alt_dma_txchan_send() 14.1.30. alt_flash_open_dev() 14.1.31. alt_fs_reg() 14.1.32. alt_get_flash_info() 14.1.33. alt_ic_irq_disable() 14.1.34. alt_ic_irq_enabled() 14.1.35. alt_ic_isr_register() 14.1.36. alt_ic_irq_enable() 14.1.37. alt_instruction_exception_register() 14.1.38. alt_irq_disable() 14.1.39. alt_irq_cpu_enable_interrupts () 14.1.40. alt_irq_disable_all() 14.1.41. alt_irq_enable() 14.1.42. alt_irq_enable_all() 14.1.43. alt_irq_enabled() 14.1.44. alt_irq_init() 14.1.45. alt_irq_pending () 14.1.46. alt_irq_register() 14.1.47. alt_llist_insert() 14.1.48. alt_llist_remove() 14.1.49. alt_load_section() 14.1.50. alt_nticks() 14.1.51. alt_read_flash() 14.1.52. alt_tick() 14.1.53. alt_ticks_per_second() 14.1.54. alt_timestamp() 14.1.55. alt_timestamp_freq() 14.1.56. alt_timestamp_start() 14.1.57. alt_write_flash() 14.1.58. alt_write_flash_block() 14.1.59. close() 14.1.60. fstat() 14.1.61. fork() 14.1.62. fcntl() 14.1.63. execve() 14.1.64. getpid() 14.1.65. kill() 14.1.66. stat() 14.1.67. settimeofday() 14.1.68. wait() 14.1.69. unlink() 14.1.70. sbrk() 14.1.71. link() 14.1.72. lseek() 14.1.73. alt_sysclk_init() 14.1.74. open() 14.1.75. times() 14.1.76. read() 14.1.77. write() 14.1.78. usleep() 14.1.79. alt_lock_flash() 14.1.80. gettimeofday() 14.1.81. ioctl() 14.1.82. isatty()
14.2. HAL Standard Types x
14.2.1. alt_getchar() 14.2.2. alt_putstr() 14.2.3. alt_putchar() 14.2.4. alt_printf()
14.3. ADC HAL Device Driver x
14.3.1. adc_stop 14.3.2. adc_start 14.3.3. adc_set_mode_run_once 14.3.4. adc_set_mode_run_continuously 14.3.5. adc_recalibrate 14.3.6. adc_interrupt_enable 14.3.7. adc_interrupt_disable 14.3.8. adc_clear_interrupt_status 14.3.9. adc_wait_for_interrupt - ADC Sample Storage Status Register 14.3.10. adc_interrupt_asserted 14.3.11. adc_wait_for interrupt - IRQ Status Register 14.3.12. alt_adc_word_read
15. Nios II Software Build Tools Reference x
15.1. Nios II Software Build Tools Utilities 15.2. Nios II Design Example Scripts 15.3. Settings Managed by the Software Build Tools 15.4. Application and User Library Makefile Variables 15.5. Software Build Tools Tcl Commands 15.6. Software Build Tools Path Names 15.7. Nios II Software Build Tools Reference Revision History
15.1. Nios II Software Build Tools Utilities x
15.1.1. Logging Levels 15.1.2. Setting Values 15.1.3. Utility and Script Summary 15.1.4. nios2-app-generate-makefile 15.1.5. nios2-bsp-create-settings 15.1.6. nios2-bsp-generate-files 15.1.7. nios2-bsp-query-settings 15.1.8. nios2-bsp-update-settings 15.1.9. nios2-lib-generate-makefile 15.1.10. nios2-bsp-editor 15.1.11. nios2-app-update-makefile 15.1.12. nios2-lib-update-makefile 15.1.13. nios2-swexample-create 15.1.14. nios2-elf-insert 15.1.15. nios2-elf-query 15.1.16. nios2-flash-programmer-generate 15.1.17. nios2-bsp 15.1.18. nios2-bsp-console 15.1.19. alt-file-convert (BETA)
15.2. Nios II Design Example Scripts x
15.2.1. create-this-bsp 15.2.2. create-this-app 15.2.3. Finding create-this-app and create-this-bsp
15.3. Settings Managed by the Software Build Tools x
15.3.1. Overview of BSP Settings 15.3.2. Overview of Component and Driver Settings 15.3.3. Settings Reference hal.enable_instruction_related_exceptions_api hal.max_file_descriptors hal.disable_startup_thread_sync hal.enable_small_stack hal.exclude_default_exception hal.sys_clk_timer hal.timestamp_timer ucosii.os_max_tasks ucosii.os_lowest_prio ucosii.os_thread_safe_newlib ucosii.miscellaneous.os_arg_chk_en ucosii.miscellaneous.os_cpu_hooks_en ucosii.miscellaneous.os_debug_en ucosii.miscellaneous.os_sched_lock_en ucosii.miscellaneous.os_task_stat_en ucosii.miscellaneous.os_task_stat_stk_chk_en ucosii.miscellaneous.os_tick_step_en ucosii.miscellaneous.os_event_name_size ucosii.miscellaneous.os_max_events ucosii.miscellaneous.os_task_idle_stk_size ucosii.miscellaneous.os_task_stat_stk_size ucosii.task.os_task_change_prio_en ucosii.task.os_task_create_en ucosii.task.os_task_create_ext_en ucosii.task.os_task_del_en ucosii.task.os_task_name_size ucosii.task.os_task_profile_en ucosii.task.os_task_query_en ucosii.task.os_task_suspend_en ucosii.task.os_task_sw_hook_en ucosii.time.os_time_tick_hook_en ucosii.time.os_time_dly_resume_en ucosii.time.os_time_dly_hmsm_en ucosii.time.os_time_get_set_en ucosii.os_flag_en ucosii.event_flag.os_flag_wait_clr_en ucosii.event_flag.os_flag_accept_en ucosii.event_flag.os_flag_del_en ucosii.event_flag.os_flag_query_en ucosii.event_flag.os_flag_name_size ucosii.event_flag.os_flags_nbits ucosii.event_flag.os_max_flags ucosii.os_mutex_en ucosii.mutex.os_mutex_accept_en ucosii.mutex.os_mutex_del_en ucosii.mutex.os_mutex_query_en ucosii.os_sem_en ucosii.semaphore.os_sem_accept_en ucosii.semaphore.os_sem_set_en ucosii.semaphore.os_sem_del_en ucosii.semaphore.os_sem_query_en ucosii.os_mbox_en ucosii.mailbox.os_mbox_accept_en ucosii.mailbox.os_mbox_del_en ucosii.mailbox.os_mbox_post_en ucosii.mailbox.os_mbox_post_opt_en ucosii.mailbox.os_mbox_query_en ucosii.os_q_en ucosii.queue.os_q_accept_en ucosii.queue.os_q_del_en ucosii.queue.os_q_flush_en ucosii.queue.os_q_post_en ucosii.queue.os_q_post_front_en ucosii.queue.os_q_post_opt_en ucosii.queue.os_q_query_en ucosii.queue.os_max_qs ucosii.os_mem_en ucosii.memory.os_mem_query_en ucosii.memory.os_mem_name_size ucosii.memory.os_max_mem_part ucosii.os_tmr_en ucosii.timer.os_task_tmr_stk_size ucosii.timer.os_task_tmr_prio ucosii.timer.os_tmr_cfg_max ucosii.timer.os_tmr_cfg_name_size ucosii.timer.os_tmr_cfg_ticks_per_sec ucosii.timer.os_tmr_cfg_wheel_size altera_avalon_uart_driver.enable_small_driver altera_avalon_uart_driver.enable_ioctl altera_avalon_jtag_uart_driver.enable_small_driver altera_hostfs.hostfs_name altera_iniche.iniche_default_if altera_iniche.enable_dhcp_client altera_iniche.enable_ip_fragments altera_iniche.enable_include_tcp altera_iniche.enable_tcp_zerocopy altera_iniche.enable_net_stats altera_ro_zipfs.ro_zipfs_name altera_ro_zipfs.ro_zipfs_offset altera_ro_zipfs.ro_zipfs_base hal.linker.allow_code_at_reset hal.linker.enable_alt_load hal.linker.enable_alt_load_copy_exceptions hal.linker.enable_alt_load_copy_rodata hal.linker.enable_alt_load_copy_rwdata hal.linker.enable_exception_stack hal.linker.exception_stack_memory_region_name hal.linker.exception_stack_size hal.linker.enable_interrupt_stack .linker.interrupt_stack_memory_region_name hal.linker.interrupt_stack_size hal.make.ar hal.make.ar_post_process hal.make.ar_pre_process hal.make.as hal.make.as_post_process hal.make.as_pre_process hal.make.bsp_arflags hal.make.bsp_asflags hal.make.bsp_cflags_debug hal.make.bsp_cflags_defined_symbols hal.make.bsp_cflags_optimization hal.make.bsp_cflags_undefined_symbols hal.make.bsp_cflags_user_flags hal.make.bsp_cflags_warnings hal.make.bsp_cxx_flags hal.make.bsp_inc_dirs hal.make.build_post_process hal.make.build_pre_process hal.make.cc hal.make.cc_post_process hal.make.cc_pre_process hal.make.cxx hal.make.cxx_post_process hal.make.cxx_pre_process hal.make.ignore_system_derived.big_endian hal.make.ignore_system_derived.fpu_present hal.make.ignore_system_derived.hardware_divide_present hal.make.ignore_system_derived.hardware_fp_cust_inst_divider_present hal.make.ignore_system_derived.hardware_fp_cust_inst_no_divider_present hal.make.ignore_system_derived.sopc_simulation_enabled hal.make.ignore_system_derived.debug_core_present hal.make.ignore_system_derived.hardware_multiplier_present hal.make.ignore_system_derived.hardware_mulx_present hal.make.ignore_system_derived.sopc_system_base_address hal.make.ignore_system_derived.sopc_system_id hal.make.ignore_system_derived.sopc_system_timestamp hal.make.rm hal.custom_newlib_flags hal.enable_c_plus_plus hal.enable_clean_exit hal.enable_exit hal.enable_gprof hal.enable_lightweight_device_driver_api hal.enable_mul_div_emulation hal.enable_reduced_device_drivers hal.enable_runtime_stack_checking hal.enable_sim_optimize hal.enable_small_c_library hal.enable_sopc_sysid_check hal.log_port hal.log_flags hal.stderr hal.stdin hal.stdout hal.thread_stack_size
15.3.2. Overview of Component and Driver Settings x
15.3.2.1. Altera Host-Based File System Settings 15.3.2.2. Altera Read-Only Zip File System Settings 15.3.2.3. Altera NicheStack TCP/IP - Nios II Edition Stack Settings 15.3.2.4. Altera Avalon-MM JTAG UART Driver Settings 15.3.2.5. Intel FPGA Avalon-MM UART Driver Settings
15.4. Application and User Library Makefile Variables x
15.4.1. Application Makefile Variables 15.4.2. User Library Makefile Variables 15.4.3. Standard Build Flag Variables
15.5. Software Build Tools Tcl Commands x
15.5.1. Tcl Command Environments 15.5.2. Tcl Commands for BSP Settings 15.5.3. Tcl Commands for BSP Generation Callbacks 15.5.4. Tcl Commands for Drivers and Packages
15.5.2. Tcl Commands for BSP Settings x
15.5.2.1. add_memory_device 15.5.2.2. add_memory_region 15.5.2.3. add_section_mapping 15.5.2.4. are_same_resource 15.5.2.5. delete_memory_region 15.5.2.6. delete_section_mapping 15.5.2.7. disable_sw_package 15.5.2.8. enable_sw_package 15.5.2.9. get_addr_span 15.5.2.10. get_assignment 15.5.2.11. get_available_drivers 15.5.2.12. get_available_sw_packages 15.5.2.13. get_base_addr 15.5.2.14. get_break_offset 15.5.2.15. get_break_slave_desc 15.5.2.16. get_cpu_name 15.5.2.17. get_current_memory_regions 15.5.2.18. get_current_section_mappings 15.5.2.19. get_default_memory_regions 15.5.2.20. get_driver 15.5.2.21. get_enabled_sw_packages 15.5.2.22. get_exception_offset 15.5.2.23. get_exception_slave_desc 15.5.2.24. get_fast_tlb_miss_exception_offset 15.5.2.25. get_fast_tlb_miss_exception_slave_desc 15.5.2.26. get_interrupt_controller_id 15.5.2.27. get_irq_interrupt_controller_id 15.5.2.28. get_irq_number 15.5.2.29. get_memory_region 15.5.2.30. get_module_class_name 15.5.2.31. get_module_name 15.5.2.32. get_reset_offset 15.5.2.33. get_reset_slave_desc 15.5.2.34. get_section_mapping 15.5.2.35. get_setting 15.5.2.36. get_setting_desc 15.5.2.37. get_slave_descs 15.5.2.38. is_char_device 15.5.2.39. is_connected_interrupt_controller_device 15.5.2.40. is_connected_to_data_master 15.5.2.41. is_connected_to_instruction_master 15.5.2.42. is_ethernet_mac_device 15.5.2.43. is_flash 15.5.2.44. is_memory_device 15.5.2.45. is_non_volatile_storage 15.5.2.46. is_timer_device 15.5.2.47. log_debug 15.5.2.48. log_default 15.5.2.49. log_error 15.5.2.50. log_verbose 15.5.2.51. set_driver 15.5.2.52. set_ignore_file 15.5.2.53. set_setting 15.5.2.54. update_memory_region 15.5.2.55. update_section_mapping 15.5.2.56. add_default_memory_regions 15.5.2.57. create_bsp 15.5.2.58. generate_bsp 15.5.2.59. get_available_bsp_type_versions 15.5.2.60. get_available_bsp_types 15.5.2.61. get_available_cpu_architectures 15.5.2.62. get_available_cpu_names 15.5.2.63. get_available_software 15.5.2.64. get_available_software_setting_properties 15.5.2.65. get_available_software_settings 15.5.2.66. get_bsp_version 15.5.2.67. get_cpu_architecture 15.5.2.68. get_nios2_dpx_thread_num 15.5.2.69. get_sopcinfo_file 15.5.2.70. get_supported_bsp_types 15.5.2.71. is_bsp_hal_extension 15.5.2.72. is_bsp_lwhal_extension 15.5.2.73. open_bsp 15.5.2.74. save_bsp 15.5.2.75. set_bsp_version 15.5.2.76. set_logging_mode
15.5.3. Tcl Commands for BSP Generation Callbacks x
15.5.3.1. add_class_sw_setting 15.5.3.2. add_class_systemh_line 15.5.3.3. add_module_sw_property 15.5.3.4. add_module_sw_setting 15.5.3.5. add_module_systemh_line 15.5.3.6. add_systemh_line 15.5.3.7. get_class_peripheral 15.5.3.8. get_module_assignment 15.5.3.9. get_module_name 15.5.3.10. get_module_peripheral 15.5.3.11. get_module_sw_setting_value 15.5.3.12. get_peripheral_property 15.5.3.13. remove_class_systemh_line 15.5.3.14. remove_module_systemh_line 15.5.3.15. set_class_sw_setting_property 15.5.3.16. set_module_sw_setting_property
15.5.4. Tcl Commands for Drivers and Packages x
15.5.4.1. add_sw_property 15.5.4.2. add_sw_setting 15.5.4.3. add_sw_setting2 15.5.4.4. create_driver 15.5.4.5. create_os 15.5.4.6. create_sw_package 15.5.4.7. set_sw_property 15.5.4.8. set_sw_setting_property
15.6. Software Build Tools Path Names x
15.6.1. Command Arguments 15.6.2. Object File Directory Tree
1. Overview of Nios II Embedded Development
2. Getting Started with the Graphical User Interface
3. Getting Started from the Command Line
4. Nios II Software Build Tools
5. Overview of the Hardware Abstraction Layer
6. Developing Programs Using the Hardware Abstraction Layer
7. Developing Device Drivers for the Hardware Abstraction Layer
8. Exception Handling
9. Cache and Tightly-Coupled Memory
10. MicroC/OS-II Real-Time Operating System
11. Ethernet and the NicheStack TCP/IP Stack
12. Read-Only Zip File System
13. Publishing Component Information to Embedded Software
14. HAL API Reference
15. Nios II Software Build Tools Reference

15.3.3. Settings Reference

This section lists all settings for BSPs, software packages, and device drivers.

hal.enable_instruction_related_exceptions_api

  • Identifier: none
  • Type: Boolean definition
  • Default Value: false
  • Destination File: none
  • Description: Enables application program interface (API) for registering handlers to service instruction-related exceptions. These exception types can be generated if various processor options are enabled, such as the memory management unit (MMU), memory protection unit (MPU), or other advanced exception types. Enabling this setting increases the size of the exception entry code.
  • Restrictions: none

hal.max_file_descriptors

  • Identifier: none
  • Type: Decimal number
  • Default Value: 32
  • Destination File: none
  • Description: Determines the number of file descriptors statically allocated.
  • Restriction: If hal.enable_lightweight_device_driver_api is true, there are no file descriptors so this setting is ignored. If hal.enable_lightweight_device_driver_api is false, this setting must be at least 4 because HAL needs a file descriptor for /dev/null, /dev/stdin, /dev/stdout, and /dev/stderr. This setting defines the value of ALT_MAX_FD in system.h.

hal.disable_startup_thread_sync

  • Identifier: ALT_DISABLE_STARTUP_THREAD_SYNC
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Disables thread synchronization checking on startup. By default, startup code in crt0.S assumes that the .rwdata section must be reloaded every time the system is reset. Thread 0 waits until the .rwdata section is reloaded before executing initialization code.
  • The hal.disable_startup_thread_sync setting allows you to disable this restriction in your BSP, if your software is written without initialized global or static variables. This setting might be useful if you develop assembly language, and want to take advantage of initialization code in crt0.S.
  • Restriction: Do not disable startup thread synchronization under the following circumstances:
    • Your code uses initialized global or static variables
    • Your application uses memory management functions such as alt_malloc(), alt_free() and alt_calloc()

hal.enable_small_stack

  • Identifier: none
  • Type:Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: lwhal.enable_small_stack turns off a build warning that indicates the setting 'lwhal.thread_stack_size' might be too small (< 384 for printf) for your application.
  • Restriction: none

hal.exclude_default_exception

  • Identifier: ALT_EXCLUDE_DEFAULT_EXCEPTION
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Excludes default exception vector. If true, this setting defines the macro ALT_EXCLUDE_DEFAULT_EXCEPTION in system.h.
  • Restriction: none

hal.sys_clk_timer

  • Identifier: none
  • Type: Unquoted string
  • Default Value: none
  • Destination File: none
  • Description: Slave descriptor of the system clock timer device. This device provides a periodic interrupt ("tick") and is typically required for RTOS use. This setting defines the value of ALT_SYS_CLK in system.h.
  • Restriction: none

hal.timestamp_timer

  • iIdentifier: none
  • Type: Unquoted string
  • Default Value: none
  • Destination File: none
  • Description: Slave descriptor of timestamp timer device. This device is used by Intel FPGA HAL timestamp drivers for high-resolution time measurement. This setting defines the value of ALT_TIMESTAMP_CLK in system.h.
  • Restriction: none

ucosii.os_max_tasks

  • Identifier: OS_MAX_TASKS
  • Type: Decimal number
  • Default Value: 10
  • Destination File: system.h
  • Description: Maximum number of tasks
  • Restriction: none

ucosii.os_lowest_prio

  • Identifier: OS_LOWEST_PRIO
  • Type: Decimal number
  • Default Value: 20
  • Destination File: system.h
  • Description: Lowest assignable priority
  • Restriction: none

ucosii.os_thread_safe_newlib

  • Identifier: OS_THREAD_SAFE_NEWLIB
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Thread safe C library
  • Restriction: none

ucosii.miscellaneous.os_arg_chk_en

  • Identifier: OS_ARG_CHK_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable argument checking
  • Restriction: none

ucosii.miscellaneous.os_cpu_hooks_en

  • Identifier: OS_CPU_HOOKS_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable MicroC/OS-II hooks
  • Restriction: none

ucosii.miscellaneous.os_debug_en

  • Identifier: OS_DEBUG_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable debug variables
  • Restriction: none

ucosii.miscellaneous.os_sched_lock_en

  • Identifier: OS_SCHED_LOCK_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSSchedLock() and OSSchedUnlock()
  • Restriction: none

ucosii.miscellaneous.os_task_stat_en

  • Identifier: OS_TASK_STAT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable statistics task
  • Restriction: none

ucosii.miscellaneous.os_task_stat_stk_chk_en

  • Identifier: OS_TASK_STAT_STK_CHK_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Check task stacks from statistics task
  • Restriction: none

ucosii.miscellaneous.os_tick_step_en

  • Identifier: OS_TICK_STEP_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable tick stepping feature for uCOS-View
  • Restriction: none

ucosii.miscellaneous.os_event_name_size

  • Identifier: OS_EVENT_NAME_SIZE
  • Type: Decimal number
  • Default Value: 32
  • Destination File: system.h
  • Description: Size of name of Event Control Block groups
  • Restriction: none

ucosii.miscellaneous.os_max_events

  • Identifier: OS_MAX_EVENTS
  • Type: Decimal number
  • Default Value: 60
  • Destination File: system.h
  • Description: Maximum number of event control blocks
  • Restriction: none

ucosii.miscellaneous.os_task_idle_stk_size

  • Identifier: OS_TASK_IDLE_STK_SIZE
  • Type: Decimal number
  • Default Value: 512
  • Destination File: system.h
  • Description: Idle task stack size
  • Restriction: none

ucosii.miscellaneous.os_task_stat_stk_size

  • Identifier: OS_TASK_STAT_STK_SIZE
  • Type: Decimal number
  • Default Value: 512
  • Destination File: system.h
  • Description: Statistics task stack size
  • Restriction: none

ucosii.task.os_task_change_prio_en

  • Identifier: OS_TASK_CHANGE_PRIO_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskChangePrio()
  • Restriction: none

ucosii.task.os_task_create_en

  • Identifier: OS_TASK_CREATE_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskCreate()
  • Restriction: none

ucosii.task.os_task_create_ext_en

  • Identifier: OS_TASK_CREATE_EXT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskCreateExt()
  • Restriction: none

ucosii.task.os_task_del_en

  • Identifier: OS_TASK_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskDel()
  • Restriction: none

ucosii.task.os_task_name_size

  • Identifier: OS_TASK_NAME_SIZE
  • Type: Decimal number
  • Default Value: 32
  • Destination File: system.h
  • Description: Size of task name
  • Restriction: none

ucosii.task.os_task_profile_en

  • Identifier: OS_TASK_PROFILE_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include data structure for run-time task profiling
  • Restriction: none

ucosii.task.os_task_query_en

  • Identifier: OS_TASK_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskQuery
  • Restriction: none

ucosii.task.os_task_suspend_en

  • Identifier: OS_TASK_SUSPEND_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskSuspend() and OSTaskResume()
  • Restriction: none

ucosii.task.os_task_sw_hook_en

  • Identifier: OS_TASK_SW_HOOK_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTaskSwHook()
  • Restriction: none

ucosii.time.os_time_tick_hook_en

  • Identifier: OS_TIME_TICK_HOOK_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTimeTickHook()
  • Restriction: none

ucosii.time.os_time_dly_resume_en

  • Identifier: OS_TIME_DLY_RESUME_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTimeDlyResume()
  • Restriction: none

ucosii.time.os_time_dly_hmsm_en

  • Identifier: OS_TIME_DLY_HMSM_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTimeDlyHMSM()
  • Restriction: none

ucosii.time.os_time_get_set_en

  • Identifier: OS_TIME_GET_SET_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSTimeGet and OSTimeSet()
  • Restriction: none

ucosii.os_flag_en

  • Identifier: OS_FLAG_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for Event Flags. This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.event_flag.os_flag_wait_clr_en

  • Identifier: OS_FLAG_WAIT_CLR_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for Wait on Clear Event Flags. This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.event_flag.os_flag_accept_en

  • Identifier: OS_FLAG_ACCEPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSFlagAccept(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.event_flag.os_flag_del_en

  • Identifier: OS_FLAG_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSFlagDel(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.event_flag.os_flag_query_en

  • Identifier: OS_FLAG_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSFlagQuery(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.event_flag.os_flag_name_size

  • Identifier: OS_FLAG_NAME_SIZE
  • Type: Decimal number
  • Default Value: 32
  • Destination File: system.h
  • Description: Size of name of Event Flags group. CAUTION: This is required by the HAL and many Intel FPGA device drivers; use caution in reducing this value.
  • Restriction: none

ucosii.event_flag.os_flags_nbits

  • Identifier: OS_FLAGS_NBITS
  • Type: Decimal number
  • Default Value: 16
  • Destination File: system.h
  • Description: Event Flag bits (8,16,32). CAUTION: This is required by the HAL and many Intel FPGA device drivers; use caution in changing this value.
  • Restriction: none

ucosii.event_flag.os_max_flags

  • Identifier: OS_MAX_FLAGS
  • Type: Decimal number
  • Default Value: 20
  • Destination File: system.h
  • Description: Maximum number of Event Flags groups. CAUTION: This is required by the HAL and many Intel FPGA device drivers; use caution in reducing this value.
  • Restriction: none

ucosii.os_mutex_en

  • Identifier: OS_MUTEX_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for Mutex Semaphores
  • Restriction: none

ucosii.mutex.os_mutex_accept_en

  • Identifier: OS_MUTEX_ACCEPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMutexAccept()
  • Restriction: none

ucosii.mutex.os_mutex_del_en

  • Identifier: OS_MUTEX_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMutexDel()
  • Restriction: none

ucosii.mutex.os_mutex_query_en

  • Identifier: OS_MUTEX_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMutexQuery
  • Restriction: none

ucosii.os_sem_en

  • Identifier: OS_SEM_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for semaphores. This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.semaphore.os_sem_accept_en

  • Identifier: OS_SEM_ACCEPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSSemAccept(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.semaphore.os_sem_set_en

  • Identifier: OS_SEM_SET_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSSemSet(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.semaphore.os_sem_del_en

  • Identifier: OS_SEM_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSSemDel(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.semaphore.os_sem_query_en

  • Identifier: OS_SEM_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSSemQuery(). This setting is enabled by default in MicroC-OS/II BSPs, because it is required for correct functioning of Intel FPGA device drivers and the HAL in a multithreaded environment. Avoid disabling it.
  • Restriction: none

ucosii.os_mbox_en

  • Identifier: OS_MBOX_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for mailboxes
  • Restriction: none

ucosii.mailbox.os_mbox_accept_en

  • Identifier: OS_MBOX_ACCEPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMboxAccept()
  • Restriction: none

ucosii.mailbox.os_mbox_del_en

  • Identifier: OS_MBOX_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMboxDel()
  • Restriction: none

ucosii.mailbox.os_mbox_post_en

  • Identifier: OS_MBOX_POST_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMboxPost()
  • Restriction: none

ucosii.mailbox.os_mbox_post_opt_en

  • Identifier: OS_MBOX_POST_OPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMboxPostOpt()
  • Restriction: none

ucosii.mailbox.os_mbox_query_en

  • Identifier: OS_MBOX_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMboxQuery()
  • Restriction: none

ucosii.os_q_en

  • Identifier: OS_Q_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for Queues
  • Restriction: none

ucosii.queue.os_q_accept_en

  • Identifier: OS_Q_ACCEPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQAccept()
  • Restriction: none

ucosii.queue.os_q_del_en

  • Identifier: OS_Q_DEL_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQDel()
  • Restriction: none

ucosii.queue.os_q_flush_en

  • Identifier: OS_Q_FLUSH_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQFlush()
  • Restriction: none

ucosii.queue.os_q_post_en

  • Identifier: OS_Q_POST_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code of OSQFlush()
  • Restriction: none

ucosii.queue.os_q_post_front_en

  • Identifier: OS_Q_POST_FRONT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQPostFront()
  • Restriction: none

ucosii.queue.os_q_post_opt_en

  • Identifier: OS_Q_POST_OPT_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQPostOpt()
  • Restriction: none

ucosii.queue.os_q_query_en

  • Identifier: OS_Q_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSQQuery()
  • Restriction: none

ucosii.queue.os_max_qs

  • Identifier: OS_MAX_QS
  • Type: Decimal number
  • Default Value: 20
  • Destination File: system.h
  • Description: Maximum number of Queue Control Blocks
  • Restriction: none

ucosii.os_mem_en

  • Identifier: OS_MEM_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Enable code for memory management
  • Restriction: none

ucosii.memory.os_mem_query_en

  • Identifier: OS_MEM_QUERY_EN
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: system.h
  • Description: Include code for OSMemQuery()
  • Restriction: none

ucosii.memory.os_mem_name_size

  • Identifier: OS_MEM_NAME_SIZE
  • Type: Decimal number
  • Default Value: 32
  • Destination File: system.h
  • Description: Size of memory partition name
  • Restriction: none

ucosii.memory.os_max_mem_part

  • Identifier: OS_MAX_MEM_PART
  • Type: Decimal number
  • Default Value: 60
  • Destination File: system.h
  • Description: Maximum number of memory partitions
  • Restriction: none

ucosii.os_tmr_en

  • Identifier: OS_TMR_EN
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: system.h
  • Description: Enable code for timers
  • Restriction: none

ucosii.timer.os_task_tmr_stk_size

  • Identifier: OS_TASK_TMR_STK_SIZE
  • Type: Decimal number
  • Default Value: 512
  • Destination File: system.h
  • Description: Stack size for timer task
  • Restriction: none

ucosii.timer.os_task_tmr_prio

  • Identifier: OS_TASK_TMR_PRIO
  • Type: Decimal number
  • Default Value: 2
  • Destination File: system.h
  • Description: Priority of timer task (0=highest)
  • Restriction: none

ucosii.timer.os_tmr_cfg_max

  • Identifier: OS_TMR_CFG_MAX
  • Type: Decimal number
  • Default Value: 16
  • Destination File: system.h
  • Description: Maximum number of timers
  • Restriction: none

ucosii.timer.os_tmr_cfg_name_size

  • Identifier: OS_TMR_CFG_NAME_SIZE
  • Type: Decimal number
  • Default Value: 16
  • Destination File: system.h
  • Description: Size of timer name
  • Restriction: none

ucosii.timer.os_tmr_cfg_ticks_per_sec

  • Identifier: OS_TMR_CFG_TICKS_PER_SEC
  • Type: Decimal number
  • Default Value: 10
  • Destination File: system.h
  • Description: Rate at which timer management task runs (Hz)
  • Restriction: none

ucosii.timer.os_tmr_cfg_wheel_size

  • Identifier: OS_TMR_CFG_WHEEL_SIZE
  • Type: Decimal number
  • Default Value: 2
  • Destination File: system.h
  • Description: Size of timer wheel (number of spokes)
  • Restriction: none

altera_avalon_uart_driver.enable_small_driver

  • Identifier: ALTERA_AVALON_UART_SMALL
  • Type: Boolean definition
  • Default Value: false
  • Destination File: public.mk
  • Description: Small-footprint (polled mode) driver
  • Restriction: none

altera_avalon_uart_driver.enable_ioctl

  • Identifier: ALTERA_AVALON_UART_USE_IOCTL
  • Type: Boolean definition
  • Default Value: false
  • Destination File: public.mk
  • Description: Enable driver ioctl() support. This feature is not compatible with the small driver; ioctl() support is not compiled if either the UART enable_small_driver or the HAL enable_reduced_device_drivers setting is enabled.
  • Restriction: none

altera_avalon_jtag_uart_driver.enable_small_driver

  • Identifier: ALTERA_AVALON_JTAG_UART_SMALL
  • Type: Boolean definition
  • Default Value: false
  • Destination File: public.mk
  • Description: Small-footprint (polled mode) driver
  • Restriction: none

altera_hostfs.hostfs_name

  • Identifier: ALTERA_HOSTFS_NAME
  • Type: Quoted string
  • Default Value: /mnt/host
  • Destination File: system.h
  • Description: Mount point
  • Restriction: none

altera_iniche.iniche_default_if

  • Identifier: INICHE_DEFAULT_IF
  • Type: Quoted string
  • Default Value: NOT_USED
  • Destination File: system.h
  • Description: Deprecated setting: Default media access control (MAC) interface. This setting is used in some legacy Intel FPGA networking examples. It is not needed in new projects. If this setting appears in an existing project, Intel FPGA recommends that you make any necessary changes to remove it. This setting might be removed in a future release.
  • Restriction: none

altera_iniche.enable_dhcp_client

  • Identifier: DHCP_CLIENT
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Use dynamic host configuration protocol (DHCP) to automatically assign Internet protocol (IP) address
  • Restriction: none

altera_iniche.enable_ip_fragments

  • Identifier: IP_FRAGMENTS
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Reassemble IP packet fragments
  • Restriction: none

altera_iniche.enable_include_tcp

  • Identifier: INCLUDE_TCP
  • Type: Boolean definition
  • Default Value: true
  • Destination File: system.h
  • Description: Enable Transmission Control Protocol (TCP)
  • Restriction: none

altera_iniche.enable_tcp_zerocopy

  • Identifier: TCP_ZEROCOPY
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Use TCP zero-copy
  • Restriction: none

altera_iniche.enable_net_stats

  • Identifier: NET_STATS
  • Type: Boolean definition
  • Default Value: false
  • Destination File: system.h
  • Description: Enable statistics
  • Restriction: none

altera_ro_zipfs.ro_zipfs_name

  • Identifier: ALTERA_RO_ZIPFS_NAME
  • Type: Quoted string
  • Default Value: /mnt/rozipfs
  • Destination File: system.h
  • Description: Mount point
  • Restriction: none

altera_ro_zipfs.ro_zipfs_offset

  • Identifier: ALTERA_RO_ZIPFS_OFFSET
  • Type: Hexadecimal number
  • Default Value: 0x100000
  • Destination File: system.h
  • Description: Offset of file system from base of flash
  • Restriction: none

altera_ro_zipfs.ro_zipfs_base

  • Identifier: ALTERA_RO_ZIPFS_BASE
  • Type: Hexadecimal number
  • Default Value: 0x0
  • Destination File: system.h
  • Description: Base address of flash memory device
  • Restriction: none

hal.linker.allow_code_at_reset

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Indicates if initialization code is allowed at the reset address. If true, defines the macro ALT_ALLOW_CODE_AT_RESET in linker.h.
  • Restriction: This setting is typically false if an external bootloader (e.g. flash bootloader) is present.

hal.linker.enable_alt_load

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: none
  • Description: Enables the alt_load() facility. The alt_load() facility copies sections from the .text memory into RAM. If true, this setting sets up the VMA/LMA (virtual memory address/low memory address) of sections in linker.x to allow them to be loaded into the .text memory.
  • Restriction: This setting is typically false if an external bootloader (e.g. flash bootloader) is present.

hal.linker.enable_alt_load_copy_exceptions

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Causes the alt_load() facility to copy the .exceptions section. If true, this setting defines the macro ALT_LOAD_COPY_EXCEPTIONS in linker.h.
  • Restriction: none

hal.linker.enable_alt_load_copy_rodata

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Causes the alt_load() facility to copy the .rodata section. If true, this setting defines the macro ALT_LOAD_COPY_RODATA in linker.h.
  • Restriction: none

hal.linker.enable_alt_load_copy_rwdata

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Causes the initialization code to copy the .rwdata section. If true, this setting defines the macro ALT_LOAD_COPY_RWDATA in linker.h.
  • Restriction: none

hal.linker.enable_exception_stack

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Enables use of a separate exception stack. If true, defines the macro ALT_EXCEPTION_STACK in linker.h, adds a memory region called exception_stack to linker.x, and provides the symbols __alt_exception_stack_pointer and __alt_exception_stack_limit in linker.x.
  • Restriction: The hal.linker.exception_stack_size and hal.linker.exception_stack_memory_region_name settings must also be valid. This setting must be false for MicroC/OS-II BSPs. The exception stack can be used to improve interrupt and other exception performance if an EIC is not implemented.

hal.linker.exception_stack_memory_region_name

  • Identifier: none
  • Type: Unquoted string
  • Default Value: none
  • Destination File: none
  • Description: Name of the existing memory region to be divided up to create the exception_stack memory region. The selected region name is adjusted automatically when the BSP is generated to create the exception_stack memory region.
  • Restriction: Only used if hal.linker.enable_exception_stack is true.

hal.linker.exception_stack_size

  • Identifier: none
  • Type: Decimal number
  • Default Value: 1024
  • Destination File: none
  • Description: Size of the exception stack in bytes.
  • Restriction: Only used if hal.linker.enable_exception_stack is true. none

hal.linker.enable_interrupt_stack

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: none
  • Description: Enables use of a separate interrupt stack. If true, defines the macro ALT_INTERRUPT_STACK in linker.h, adds a memory region called interrupt_stack to linker.x, and provides the symbols __alt_interrupt_stack_pointer and __alt_interrupt_stack_limit in linker.x.
  • Restriction: The hal.linker.interrupt_stack_size and hal.linker.interrupt_stack_memory_region_name settings must also be valid. This setting must be false for MicroC/OS-II BSPs. Only enable this setting for systems with an EIC. If an EIC is not implemented, use the separate exception stack to improve interrupt and other exception performance.

.linker.interrupt_stack_memory_region_name

  • Identifier: none
  • Type: Unquoted String
  • Default Value: none
  • Destination File: none
  • Description: Name of the existing memory region that is divided up to create the interrupt_stack memory region. The selected region name is adjusted automatically when the BSP is generated to create the interrupt_stack memory region.
  • Restriction: Only used if hal.linker.enable_interrupt_stack is true. none

hal.linker.interrupt_stack_size

  • Identifier: none
  • Type: Decimal Number
  • Default Value: 1024
  • Destination File: none
  • Description: Size of the interrupt stack in bytes.
  • Restriction: Only used if hal.linker.enable_interrupt_stack is true.

hal.make.ar

  • Identifier: AR
  • Type: Unquoted string
  • Default Value: nios2-elf-ar
  • Destination File: BSP makefile
  • Description: Archiver command. Creates library files.
  • Restriction: none

hal.make.ar_post_process

  • Identifier: AR_POST_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed after archiver execution.
  • Restriction: none

hal.make.ar_pre_process

  • Identifier: AR_PRE_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before archiver execution.
  • Restriction: none

hal.make.as

  • Identifier: AS
  • Type: Unquoted string
  • Default Value: nios2-elf-gcc
  • Destination File: BSP makefile
  • Description: Assembler command. Note that CC is used for Nios II assembly language source files (.S).
  • Restriction: none

hal.make.as_post_process

  • Identifier: AS_POST_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed after each assembly file is compiled.
  • Restriction: none

hal.make.as_pre_process

  • Identifier: AS_PRE_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before each assembly file is compiled.
  • Restriction: none

hal.make.bsp_arflags

  • Identifier: BSP_ARFLAGS
  • Type: Unquoted string
  • Default Value: -src
  • Destination File: BSP makefile
  • Description: Custom flags only passed to the archiver. This content of this variable is directly passed to the archiver rather than the more standard ARFLAGS. The reason for this is that GNU Make assumes some default content in ARFLAGS.This setting defines the value of BSP_ARFLAGS in Makefile.
  • Restriction: none

hal.make.bsp_asflags

  • Identifier: BSP_ASFLAGS
  • Type: Unquoted string
  • Default Value: -Wa,-gdwarf2
  • Destination File: BSP makefile
  • Description: Custom flags only passed to the assembler. This setting defines the value of BSP_ASFLAGS in Makefile.
  • Restriction: none

hal.make.bsp_cflags_debug

  • Identifier: BSP_CFLAGS_DEBUG
  • Type: Unquoted string
  • Default Value: -g
  • Destination File: BSP makefile
  • Description: C/C++ compiler debug level. -g provides the default set of debug symbols typically required to debug a typical application. Omitting -g removes debug symbols from the .elf file. This setting defines the value of BSP_CFLAGS_DEBUG in Makefile.
  • Restriction: none

hal.make.bsp_cflags_defined_symbols

  • Identifier: BSP_CFLAGS_DEFINED_SYMBOLS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Preprocessor macros to define. A macro definition in this setting has the same effect as a #define in source code. Adding -DALT_DEBUG to this setting has the same effect as #define ALT_DEBUG in a source file. Adding -DFOO=1 to this setting is equivalent to the macro #define FOO 1 in a source file. Macros defined with this setting are applied to all . S , C source ( .c ), and C++ files in the BSP. This setting defines the value of BSP_CFLAGS_DEFINED_SYMBOLS in the BSP makefile.
  • Restriction: none

hal.make.bsp_cflags_optimization

  • Identifier: BSP_CFLAGS_OPTIMIZATION
  • Type: Unquoted string
  • Default Value: -O0
  • Destination File: BSP makefile
  • Description: C/C++ compiler optimization level. -O0 = no optimization, -O2 = normal optimization, etc. -O0 is recommended for code that you want to debug since compiler optimization can remove variables and produce nonsequential execution of code while debugging. This setting defines the value of BSP_CFLAGS_OPTIMIZATION in Makefile.
  • Restriction: none

hal.make.bsp_cflags_undefined_symbols

  • Identifier: BSP_CFLAGS_UNDEFINED_SYMBOLS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Preprocessor macros to undefine. Undefined macros are similar to defined macros, but replicate the #undef directive in source code. To undefine the macro FOO use the syntax -u FOO in this setting. This is equivalent to #undef FOO in a source file. Note: the syntax differs from macro definition (there is a space, i.e. -u FOO versus -DFOO). Macros defined with this setting are applied to all . S , . c , and C++ files in the BSP. This setting defines the value of BSP_CFLAGS_UNDEFINED_SYMBOLS in the BSP Makefile.
  • Restriction: none

hal.make.bsp_cflags_user_flags

  • Identifier: BSP_CFLAGS_USER_FLAGS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Custom flags passed to the compiler when compiling C, C++, and . S files . This setting defines the value of BSP_CFLAGS_USER_FLAGS in Makefile.
  • Restriction: none

hal.make.bsp_cflags_warnings

  • Identifier: BSP_CFLAGS_WARNINGS
  • Type: Unquoted string
  • Default Value: -Wall
  • Destination File: BSP makefile
  • Description: C/C++ compiler warning level. -Wall is commonly used.This setting defines the value of BSP_CFLAGS_WARNINGS in Makefile.
  • Restriction: none

hal.make.bsp_cxx_flags

  • Identifier: BSP_CXXFLAGS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Custom flags only passed to the C++ compiler. This setting defines the value of BSP_CXXFLAGS in Makefile.
  • Restriction: none

hal.make.bsp_inc_dirs

  • Identifier: BSP_INC_DIRS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Space separated list of extra include directories to scan for header files. Directories are relative to the top-level BSP directory. The -I prefix is added by the makefile, therefore you must not include it in the setting value. This setting defines the value of BSP_INC_DIRS in the makefile.
  • Restriction: none

hal.make.build_post_process

  • Identifier: BUILD_POST_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed after BSP built.
  • Restriction: none

hal.make.build_pre_process

  • Identifier: BUILD_PRE_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before BSP built.
  • Restriction: none

hal.make.cc

  • Identifier: CC
  • Type: Unquoted string
  • Default Value: nios2-elf-gcc -xc
  • Destination File: BSP makefile
  • Description: C compiler command
  • Restriction: none

hal.make.cc_post_process

  • Identifier: CC_POST_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed after each .c or .S file is compiled.
  • Restriction: none

hal.make.cc_pre_process

  • Identifier: CC_PRE_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before each .c or .S file is compiled.
  • Restriction: none

hal.make.cxx

  • Identifier: CXX
  • Type: Unquoted string
  • Default Value: nios2-elf-gcc -xc++
  • Destination File: BSP makefile
  • Description: C++ compiler command
  • Restriction: none

hal.make.cxx_post_process

  • Identifier: CXX_POST_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before each C++ file is compiled.
  • Restriction: none

hal.make.cxx_pre_process

  • Identifier: CXX_PRE_PROCESS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: BSP makefile
  • Description: Command executed before each C++ file is compiled.
  • Restriction: none

hal.make.ignore_system_derived.big_endian

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system is big endian. If true ignores export of 'ALT_CFLAGS += -meb' to public.mk if big endian system. If true ignores export of 'ALT_CFLAGS += -mel' if little endian system.
  • Restriction: none

hal.make.ignore_system_derived.fpu_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has FPU present. If true ignores export of 'ALT_CFLAGS += -mhard-float' to public.mk if FPU is found in the system. If true ignores export of 'ALT_CFLAGS += -mhard-soft' if FPU is not found in the system.
  • Restriction: none

hal.make.ignore_system_derived.hardware_divide_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has hardware divide present. If true ignores export of 'ALT_CFLAGS += -mno-hw-div' to public.mk if no division is found in system. If true ignores export of 'ALT_CFLAGS += -mhw-div' if division is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.hardware_fp_cust_inst_divider_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system floating point custom instruction with a divider is present. If true ignores export of 'ALT_CFLAGS += -mcustom-fpu-cfg=60-2' and 'ALT_LDFLAGS += -mcustom-fpu-cfg=60-2' to public.mk if the custom instruction is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.hardware_fp_cust_inst_no_divider_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system floating point custom instruction without a divider is present. If true ignores export of 'ALT_CFLAGS += -mcustom-fpu-cfg=60-1' and 'ALT_LDFLAGS += -mcustom-fpu-cfg=60-1' to public.mk if the custom instruction is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.sopc_simulation_enabled

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has simulation enabled. If true ignores export of 'ELF_PATCH_FLAG += --simulation_enabled' to public.mk.
  • Restriction: none

hal.make.ignore_system_derived.debug_core_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has a debug core present. If true ignores export of 'CPU_HAS_DEBUG_CORE = 1' to public.mk if a debug core is found in the system. If true ignores export of 'CPU_HAS_DEBUG_CORE = 0' if no debug core is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.hardware_multiplier_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has multiplier present. If true ignores export of 'ALT_CFLAGS += -mno-hw-mul' to public.mk if no multiplier is found in the system. If true ignores export of 'ALT_CFLAGS += -mhw-mul' if multiplier is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.hardware_mulx_present

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query if SOPC system has hardware mulx present. If true ignores export of 'ALT_CFLAGS += -mno-hw-mulx' to public.mk if no mulx is found in the system. If true ignores export of 'ALT_CFLAGS += -mhw-mulx' if mulx is found in the system.
  • Restriction: none

hal.make.ignore_system_derived.sopc_system_base_address

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query SOPC system for system ID base address. If true ignores export of 'SOPC_SYSID_FLAG += --sidp=<address>' and 'ELF_PATCH_FLAG += --sidp=<address>' to public.mk.
  • Restriction: none

hal.make.ignore_system_derived.sopc_system_id

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query SOPC system for system ID. If true ignores export of 'SOPC_SYSID_FLAG += --id=<sysid>' and 'ELF_PATCH_FLAG += --id=<sysid>' to public.mk.
  • Restriction: none

hal.make.ignore_system_derived.sopc_system_timestamp

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enable BSP generation to query SOPC system for system timestamp. If true ignores export of 'SOPC_SYSID_FLAG += --timestamp=<timestamp>' and 'ELF_PATCH_FLAG += --timestamp=<timestamp>' to public.mk.
  • Restriction: none

hal.make.rm

  • Identifier: RM
  • Type: Unquoted string
  • Default Value: rm -f
  • Destination File: BSP makefile
  • Description: Command used to remove files when building the clean target.
  • Restriction: none

hal.custom_newlib_flags

  • Identifier: CUSTOM_NEWLIB_FLAGS
  • Type: Unquoted string
  • Default Value: none
  • Destination File: public.mk
  • Description: Build a custom version of newlib with the specified space-separated compiler flags.
  • Restriction: The custom newlib build is placed in the <bsp root>/newlib directory, and is used only for applications that utilize this BSP.

hal.enable_c_plus_plus

  • Identifier: ALT_NO_C_PLUS_PLUS
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: public.mk
  • Description: Enable support for a subset of the C++ language. This option increases code footprint by adding support for C++ constructors. Certain features, such as multiple inheritance and exceptions are not supported. If false, adds -DALT_NO_C_PLUS_PLUS to ALT_CPPFLAGS in public.mk, and reduces code footprint.
  • Restriction: none

hal.enable_clean_exit

  • Identifier: ALT_NO_CLEAN_EXIT
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: public.mk
  • Description: When your application exits, close file descriptors, call C++ destructors, etc. Code footprint can be reduced by disabling clean exit. If disabled, adds -DALT_NO_CLEAN_EXIT to ALT_CPPFLAGS and -Wl, --defsym, exit=_exit to ALT_LDFLAGS in public.mk.
  • Restriction: none

hal.enable_exit

  • Identifier: ALT_NO_EXIT
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: public.mk
  • Description: Add exit() support. This option increases code footprint if your main() routine returns or calls exit(). If false, adds -DALT_NO_EXIT to ALT_CPPFLAGS in public.mk, and reduces footprint.
  • Restriction: none

hal.enable_gprof

  • Identifier: ALT_PROVIDE_GMON
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Causes code to be compiled with gprof profiling enabled and the application .elf file to be linked with the GPROF library. If true, adds -DALT_PROVIDE_GMON to ALT_CPPFLAGS and -pg to ALT_CFLAGS in public.mk.
  • Restriction: none

hal.enable_lightweight_device_driver_api

  • Identifier: ALT_USE_DIRECT_DRIVERS
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Enables lightweight device driver API. This reduces code and data footprint by removing the HAL layer that maps device names (e.g. /dev/uart0) to file descriptors. Instead, driver routines are called directly. The open(), close(), and lseek() routines always fail if called. The read(), write(), fstat(), ioctl(), and isatty() routines only work for the stdio devices. If true, adds -DALT_USE_DIRECT_DRIVERS to ALT_CPPFLAGS in public.mk.
  • Restriction: The Intel FPGA Host and read-only ZIP file systems cannot be used if hal.enable_lightweight_device_driver_api is true.

hal.enable_mul_div_emulation

  • Identifier: ALT_NO_INSTRUCTION_EMULATION
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Adds code to the BSP to emulate multiply and divide instructions. This code is independent of any emulation code added by the C/C++ compiler. If false, adds -DALT_NO_INSTRUCTION_EMULATION to ALT_CPPFLAGS in public.mk. You do not normally need to enable this option, because the C/C++ compiler detects whether the target Nios II processor core supports the multiply and divide instructions directly. If you compile for a core that lacks support for the instructions, the HAL includes the required software emulation in its run-time libraries. However, you might need to enable hal.enable_mul_div_emulation under the following circumstances:
    • You expect to run the Nios II software on an implementation of the Nios II processor other than the one you compiled for. The best solution is to build your program for the correct Nios II processor implementation. Resort to the hal.enable_mul_div_emulation if it is not possible to determine the processor implementation at compile time.
    • You have assembly language code that uses an implementation-dependent instruction.
  • Restriction: none

hal.enable_reduced_device_drivers

  • Identifier: ALT_USE_SMALL_DRIVERS
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Certain drivers are compiled with reduced functionality to reduce code footprint. Not all drivers observe this setting. If true, adds -DALT_USE_SMALL_DRIVERS to ALT_CPPFLAGS in public.mk. Typically, drivers support this setting with a polled mode. For example, the altera_avalon_uart and altera_avalon_jtag_uart reduced drivers operate in polled mode. Several device drivers are disabled entirely in reduced drivers mode. These include the altera_avalon_cfi_flash, altera_avalon_epcs_flash_controller, and altera_avalon_lcd_16207 drivers. As a result, certain API routines fail (HAL flash access routines). You can define a symbol provided by each driver to prevent it from being removed.
  • Restriction: none

hal.enable_runtime_stack_checking

  • Identifier: ALT_STACK_CHECK
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Turns on HAL runtime stack checking feature. Enabling this setting causes additional code to be placed into each subroutine call to generate an exception if a stack collision occurs with the heap or statically allocated data. If true, adds -DALT_STACK_CHECK and -fstack-check to ALT_CPPFLAGS in public.mk.
  • Restriction: none

hal.enable_sim_optimize

  • Identifier: ALT_SIM_OPTIMIZE
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: The BSP is compiled with optimizations to speedup HDL simulation such as initializing the cache, clearing the .bss section, and skipping long delay loops. If true, adds -DALT_SIM_OPTIMIZE to ALT_CPPFLAGS in public.mk.
  • Restriction: When this setting is true, the BSP cannot run on hardware.

hal.enable_small_c_library

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 0
  • Destination File: public.mk
  • Description: Causes the small newlib (C library) to be used. This reduces code and data footprint at the expense of reduced functionality. Several newlib features are removed such as floating-point support in printf(), stdin input routines, and buffered I/O. The small C library is not compatible with Micrium 
MicroC/OS-II. If true, adds -msmallc to ALT_LDFLAGS and adds -DSMALL_C_LIB to ALT_CPPFLAGS in public.mk.
  • Restriction: none

hal.enable_sopc_sysid_check

  • Identifier: none
  • Type: Boolean assignment
  • Default Value: 1
  • Destination File: public.mk
  • Description: Enables system ID check. If a System ID component is connected to the processor associated with this BSP, the system ID check is enabled in the creation of command-line arguments to download an .elf file to the target. Otherwise, system ID and timestamp values are left out of public.mk for the application makefile download-elf target definition. With the system ID check disabled, the Nios II EDS tools do not automatically ensure that the application ..elf file (and BSP it is linked against) corresponds to the hardware design on the target. If false, adds --accept-bad-sysid to SOPC_SYSID_FLAG in public.mk. Intel FPGA strongly recommends leaving hal.enable_sopc_sysid_check enabled. This setting is exposed to support rare cases in which FPGA logic resources are in extremely short supply. When the system ID check is disabled, the software is unable to detect whether the software is running on the correct hardware version. This situation can lead to subtle errors that are difficult to diagnose.
  • Restriction: none

hal.log_port

  • Identifier: LOG_PORT
  • Type: Unquoted string
  • Default Value: none
  • Destination File: system.h
  • Description: Slave descriptor of debug logging character-mode device. If defined, it enables extra debug messages in the HAL source. This setting is used by the Intel FPGA logging functions.

hal.log_flags

  • Identifier: ALT_LOG_FLAGS
  • Type: Decimal Number
  • Default Value: 0
  • Destination File: public.mk
  • Description: The value is assigned to ALT_LOG_FLAGS in the generated public.mk. Refer to hal.log_port for further details. The valid range of this setting is -1 through 3.

hal.stderr

  • Identifier: STDERR
  • Type: Unquoted string
  • Default Value: none
  • Destination File: public.mk
  • Description: Slave descriptor of STDERR character-mode device. This setting is used by the ALT_STDERR family of defines in system.h.

hal.stdin

  • Identifier: STDIN
  • Type: Unquoted string
  • Default Value: none
  • Destination File: system.h
  • Description: Slave descriptor of STDIN character-mode device. This setting is used by the ALT_STDIN family of defines in system.h.

hal.stdout

  • Identifier: STDOUT
  • Type: Unquoted string
  • Default Value: none
  • Destination File: system.h
  • Description: Slave descriptor of STDOUT character-mode device. This setting is used by the ALT_STDOUT family of defines in system.h.

hal.thread_stack_size

  • Identifier: ALT_THREAD_STACK_SIZE
  • Type: Decimal number
  • Default Value: The default value of lwhal.thread_stack_size is selected by the default Tcl script launched when a LWHAL BSP is created. lwhal.thread_stack_size is set to 3/4 of the size of the memory region to which the .stack section is assigned, if the region is shared with other sections (the default case).
  • Destination File: system.h
  • Description: Defines stack size for a thread (in bytes). This setting defines the value of ALT_THREAD_STACK_SIZE in system.h.
  • Restriction: none
Level Two Title