Nios® II Software Developer Handbook

ID 683525
Date 8/28/2023
Public
Document Table of Contents

16.1.14. nios2-elf-insert

Usage

Simple ELF 'fattening' tool used to inject additional sections into an ELF intended for the Nios® II soft-core processor. The main purpose of this tool is to insert extra information into ELF files sothat downstream tools can extract that information. The main motivation for this tool is to makethe ELF file the single handoff file that all downstream embedded tools can agree on.

For example, the Nios® II SBT build flow uses nios-elf-insert to insert the cpu name and the sysid information into the ELF file at build time. Later on downstream, the eclipse debugger can use nios2-elf-query to extract this information to auto-populate all the various GUI settings with the correct default values.

The first argument is the ELF filename: (nios2-elf-insert <filename>).

Valid Additional Arguments

--qsys <qsysFabricModeEnabled>
--cpu_name <cpuName> 
--stderr_dev <stderrDev> 
--stdin_dev <stdinDev> 
--stdout_dev <stdoutDev> 
--sidp <sysidBase> 
--id <sysidHash> 
--timestamp <sysidTime> 
--sof <sofFile> 
--sopcinfo <sopcinfoFile> 
--jar <jarFile> 
--jdi <jdiFile> 
--quartus_project_dir <quartusProjectDir> 
--sopc_system_name <sopcSystemName> 
--profiling_enabled <profilingEnabled> 
--simulation_enabled <simulationEnabled>
--thread_model <threadModel>

Advanced Options

--jvm-max-heap-size=<value>—Optional. The maximum memory size to be used for allocations when running this tool. This value is specified as <size><unit> where unit can be m (or M) for multiples of megabytes or g (or G) for multiples of gigabytes. The default value is 512m.