Startup for ARM Integrator evaluation board (QNX Neutrino)
startup-integrator [-A] [-D channel[.channel_opts]]
[-j addr] [-K channel[.channel_opts]]
[-N hostname] [-R size] [-r addr,size[,flag]]
ARM Integrator evaluation board (ARM)
- Reboot the system on any abnormal termination of the kernel.
The default is to display information about the crash and halt.
- -D channel[.channel_opts]
- Specify an output channel for debugging information. See below
- -f [cpu_freq][,[cycles_freq][,timer_freq]]
- Specify CPU frequencies.
All frequencies can be followed by H for hertz,
K for kilohertz, or M for megahertz
(these suffixes aren't case-sensitive). If no
suffix is given, the library assumes megahertz if the
number is less than 1000; otherwise it assumes hertz.
If they're specified, cpu_freq, cycles_freq, and
timer_freq are used to set the corresponding variables
in the startup code:
- cpu_freq -- the CPU clock frequency. It's also used
to set the speed field in the cpuinfo section of the
- cycles_freq -- the frequency at which the
value returned by
ClockCycles() increments. It's also used to set the
cycles_per_sec field in the qtime
section of the system page.
- timer_freq -- the frequency at which the timer chip
input runs. It's also used to set the timer_rate and
timer_scale values of the qtime section of the
If a variable is zero when it comes time to set the field(s)
on the system page, the library code attempts to deduce the proper
value by using one of the other frequency variables. Which one it uses
depends on the particular CPU and hardware.
- -j addr
- For use with JTAG/hardware debuggers.
Reserve 4 bytes of RAM at the physical address
specified by addr, and copy the physical address
of the location of the system page to addr
in RAM so that it can be retrieved by a hardware debugger.
- -K channel[.channel_opts]
- Specify an output channel for kernel debugger information. See
below for details.
- -N hostname
- Specify the node name. The default is the local host.
- -R size
- Remove size memory from system use. This is useful for
testing in a restricted-memory environment.
The size is in bytes, unless followed by one of
M (megabytes), or G (gigabytes).
- -r addr,size[,flag]
- Remove size memory from system use
starting at addr.
The flag is an optional
argument used to specify if the memory should be cleared:
|If the value of the flag passed is:
||Clears to 0
||Clears to 0
||Does not clear
- -S [~]section
- Turn on (or, if you use ~section, off) output
of the specified syspage section's information. Use this
to restrict the amount of syspage information.
For more information, see the description of
in the Customizing Image Startup Programs chapter of Building Embedded Systems.
- Be verbose. More v characters cause even more
The debug channel specified with the -D and -K options
- Use a PrimeCell serial port, with:
- Specify the I/O port base address for the PrimeCell serial port,
in hexadecimal. The default for the -D option is 16000000;
for -K, it's 17000000.
- Specify the spacing between the I/O registers, in
bytes. The default is 0.
- Specify the baud rate for the debug channel. The default is
- Specify the clock rate (in Hz) input to the chip. The
default is 14745600.
- Specify the divisor used on the clock rate by the chip. The
default is 16.
You can skip options by leaving out the data associated with that part. For
example, if you want to send the debugging output to a PrimeCell serial port using
9600 baud, use:
The default -D and -K settings are:
The startup-integrator program is responsible for
initializing the ARM Integrator evaluation board.
"Startup programs (startup-*)"
in the Utilities Summary chapter
Customizing Image Startup Programs
in Building Embedded Systems