Startup for IDT 79S465 evaluation board (QNX Neutrino)


startup-79s465 [-A] [-D channel[.channel_opts]] 
    [-F [~]value]
    [-f [cpu_freq][,[cycles_freq][,timer_freq]]] 
    [-j addr] [-K channel[.channel_opts]] 
    [-N hostname] [-r addr,size[,flag]] 
    [-R size] [-S [~]section] [-v[v]...]

Runs on:

IDT 79S465 evaluation board (MIPS)


Reboot the system on any abnormal termination of the kernel. The default is to display information about the crash, and then halt.
-D channel[.channel_opts]
Specify an output channel for debugging information. See below for details.
-F [~]value
Control the flags field in the cpuinfo section of the system page:

Note: The option was added in the QNX Neutrino Core OS 6.3.2.

For more information about the flags, see "Structure of the system page" in the Customizing Image Startup Programs chapter of the Building Embedded Systems guide.

-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:

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.
-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: Memory:
None Clears to 0
0 Clears to 0
1 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 print_syspage() in the Customizing Image Startup Programs chapter of Building Embedded Systems.
Be verbose. More v characters cause even more verbosity.

Debug channels

The debug channel specified with the -D and -K options can be:

Use a generic zscc-compatible serial chip, with:
Specify the I/O port base address for the 8250, in hexadecimal. The default port for the -D option is 1F300008; the default for the -K option is 1F300000.
Specify the spacing between the I/O registers, in 2shift bytes. The default is 2.
Specify the baud rate for the debug channel. The default is 9600.
Specify the clock rate (in Hz) input to the chip. The default is 12500000.
Specify the divisor used on the clock rate by the chip. The default is 16.
Specify a number of times to run through a busy-wait loop between register accesses. We provide a reasonable default for hardware that we've seen. The default is 1000.

You can skip options by leaving out the data associated with that part. For example, if you want to send the debugging output to an zscc chip using 9600 baud, use:

-D zscc..9600

The default -D and -K settings are:

-D zscc.1f300008^2.9600.12500000.16.1000
-K zscc.1f300000^2.9600.12500000.16.1000


The startup-79s465 program is responsible for initializing the IDT 79S465 evaluation board.


See ${QNX_TARGET}/mipsbe/build.

See also:

mkifs, procnto

"Startup programs (startup-*)" in the Utilities Summary chapter

Customizing Image Startup Programs in Building Embedded Systems