.\" -*- nroff -*-
|
.\" -*- nroff -*-
|
.\" $Id: ti_w11.1 550 2014-02-03 08:16:57Z mueller $
|
.\" $Id: ti_w11.1 550 2014-02-03 08:16:57Z mueller $
|
.\"
|
.\"
|
.\" Copyright 2013- by Walter F.J. Mueller
|
.\" Copyright 2013- by Walter F.J. Mueller
|
.\"
|
.\"
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.
|
.
|
.TH TI_W11 1 2013-05-20 "Retro Project" "Retro Project Manual"
|
.TH TI_W11 1 2013-05-20 "Retro Project" "Retro Project Manual"
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH NAME
|
.SH NAME
|
ti_w11 \- Quick starter for \fBti_rri\fP with \fBw11\fP CPU designs
|
ti_w11 \- Quick starter for \fBti_rri\fP with \fBw11\fP CPU designs
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH SYNOPSIS
|
.SH SYNOPSIS
|
.
|
.
|
.SY ti_w11
|
.SY ti_w11
|
.OP OPTIONS
|
.OP OPTIONS
|
.OP "ti_rri options and commands"
|
.OP "ti_rri options and commands"
|
.YS
|
.YS
|
.
|
.
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH DESCRIPTION
|
.SH DESCRIPTION
|
Generates the \fBti_rri\fP(1) commands for starting the \fBrri\fP backend
|
Generates the \fBti_rri\fP(1) commands for starting the \fBrri\fP backend
|
in standard configurations with \fBw11\fP CPU designs. Connections to
|
in standard configurations with \fBw11\fP CPU designs. Connections to
|
FPGA boards as well as to \fPghdl\fP based simulations are supported.
|
FPGA boards as well as to \fPghdl\fP based simulations are supported.
|
|
|
Since \fBti_w11\fP is only a quick starter for \fBti_rri\fP(1) this man page
|
Since \fBti_w11\fP is only a quick starter for \fBti_rri\fP(1) this man page
|
will only describe briefly the \fBti_w11\fP specific options, for any further
|
will only describe briefly the \fBti_w11\fP specific options, for any further
|
detail consult the \fBti_rri\fP(1) man page.
|
detail consult the \fBti_rri\fP(1) man page.
|
|
|
\fBti_w11\fP will print the generated \fBti_rri\fP(1) command to stdout before
|
\fBti_w11\fP will print the generated \fBti_rri\fP(1) command to stdout before
|
executing it.
|
executing it.
|
.
|
.
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH OPTIONS
|
.SH OPTIONS
|
.SS "setup options for FPGA connects"
|
.SS "setup options for FPGA connects"
|
.IP \fB-u\fP
|
.IP \fB-u\fP
|
use \fB\-\-cuff\fP connect (USB via Cypress FX2)
|
use \fB\-\-cuff\fP connect (USB via Cypress FX2)
|
.IP \fB-t\fIDN\fR[,\fIopts\fP]
|
.IP \fB-t\fIDN\fR[,\fIopts\fP]
|
use \fB\-\-term\fP connect, \fID\fP specifies device name, \fIN\fP
|
use \fB\-\-term\fP connect, \fID\fP specifies device name, \fIN\fP
|
specified the device number, and \fIopts\fP the addtional options
|
specified the device number, and \fIopts\fP the addtional options
|
a \fB\-\-term\fP can hold (e.g. break or xon). \fID\fP is mapped as
|
a \fB\-\-term\fP can hold (e.g. break or xon). \fID\fP is mapped as
|
.RS
|
.RS
|
.PD 0
|
.PD 0
|
.IP \fBs\fP 4
|
.IP \fBs\fP 4
|
use /dev/ttyS* (* is device number \fIN\fP)
|
use /dev/ttyS* (* is device number \fIN\fP)
|
.IP \fBu\fP 4
|
.IP \fBu\fP 4
|
use /dev/ttyUSB* (* is device number \fIN\fP)
|
use /dev/ttyUSB* (* is device number \fIN\fP)
|
.PD
|
.PD
|
.RE
|
.RE
|
.
|
.
|
.SS "setup options for ghdl simulation runs"
|
.SS "setup options for ghdl simulation runs"
|
.IP \fB-s3\fP
|
.IP \fB-s3\fP
|
start \fItb_w11a_s3\fP simulation (w11a on S3BOARD)
|
start \fItb_w11a_s3\fP simulation (w11a on S3BOARD)
|
.IP \fB-n2\fP
|
.IP \fB-n2\fP
|
start \fItb_w11a_n2\fP simulation (w11a on Nexys2 board)
|
start \fItb_w11a_n2\fP simulation (w11a on Nexys2 board)
|
.IP \fB-n3\fP
|
.IP \fB-n3\fP
|
start \fItb_w11a_n3\fP simulation (w11a on Nexys3 board)
|
start \fItb_w11a_n3\fP simulation (w11a on Nexys3 board)
|
.
|
.
|
.SS "common options"
|
.SS "common options"
|
.IP \fB-e "\fR=\fIfile"\fR
|
.IP \fB-e "\fR=\fIfile"\fR
|
load and execute \fIfile\fP. If the file type is '.mac' the file will
|
load and execute \fIfile\fP. If the file type is '.mac' the file will
|
be on the fly compiled with \fBasm-11\fP(1), for all other file types
|
be on the fly compiled with \fBasm-11\fP(1), for all other file types
|
it is assumed that the are in \fBlda\fP(5) format.
|
it is assumed that the are in \fBlda\fP(5) format.
|
.
|
.
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH EXAMPLES
|
.SH EXAMPLES
|
.IP "\fBti_w11 -u @211bsd_rk_boot.tcl\fR" 4
|
.IP "\fBti_w11 -u @211bsd_rk_boot.tcl\fR" 4
|
Assumes a FPGA board, with a \fBw11\fP CPU design already configured,
|
Assumes a FPGA board, with a \fBw11\fP CPU design already configured,
|
is connected via USB. \fBti_rri\fP(1) will be started and the given
|
is connected via USB. \fBti_rri\fP(1) will be started and the given
|
boot script executed.
|
boot script executed.
|
|
|
.IP "\fBti_w11 -n3 -e $RETROBASE/tools/asm-11/w11/sys/dl11/simple_out.mac\fR"
|
.IP "\fBti_w11 -n3 -e $RETROBASE/tools/asm-11/w11/sys/dl11/simple_out.mac\fR"
|
Will start the \fItb_w11a_n3 test\fP bench in \fBghdl\fP(1), on the fly
|
Will start the \fItb_w11a_n3 test\fP bench in \fBghdl\fP(1), on the fly
|
compile the \fIsimple_out.mac\fP test program with \fBasm-11\fP(1), load
|
compile the \fIsimple_out.mac\fP test program with \fBasm-11\fP(1), load
|
and execute it. This little test code just produces
|
and execute it. This little test code just produces
|
.EX
|
.EX
|
Hello world!
|
Hello world!
|
Hello world!
|
Hello world!
|
.EE
|
.EE
|
forever, just abort with ^C if you have seen enough.
|
forever, just abort with ^C if you have seen enough.
|
.
|
.
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
.BR ti_rri (1),
|
.BR ti_rri (1),
|
.BR asm-11 (1)
|
.BR asm-11 (1)
|
|
|
.\" ------------------------------------------------------------------
|
.\" ------------------------------------------------------------------
|
.SH AUTHOR
|
.SH AUTHOR
|
Walter F.J. Mueller
|
Walter F.J. Mueller
|
|
|
