summaryrefslogtreecommitdiffstatshomepage
path: root/src/lib/netlist/build/man
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/netlist/build/man')
-rw-r--r--src/lib/netlist/build/man/nltool.1176
-rw-r--r--src/lib/netlist/build/man/nlwav.1116
2 files changed, 292 insertions, 0 deletions
diff --git a/src/lib/netlist/build/man/nltool.1 b/src/lib/netlist/build/man/nltool.1
new file mode 100644
index 00000000000..ac1e7006794
--- /dev/null
+++ b/src/lib/netlist/build/man/nltool.1
@@ -0,0 +1,176 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3.
+.TH NLTOOL "1" "May 2022" "nltool (netlist) 0.14" "User Commands"
+.SH NAME
+nltool \- manual page for nltool (netlist) 0.14
+.SH SYNOPSIS
+.B nltool
+[\fI\,option\/\fR]... [\fI\,files\/\fR]...
+.SH DESCRIPTION
+nltool serves as the Swiss Army knife to run, test and convert netlists.
+.PP
+Commands may accept one or more files depending on the functionality.
+If no file is provided, standard input is used.
+.SH OPTIONS
+.SS "General options:"
+.IP
+The following options apply to all commands.
+.HP
+\fB\-c\fR, \fB\-\-cmd\fR=\fI\,run\/\fR|validate|convert|listdevices|listmodels|static|header|docheader|tests
+.IP
+run|validate|convert|listdevices|listmodels|static|header|docheader|tests
+.TP
+\fB\-I\fR, \fB\-\-include\fR=\fI\,Value\/\fR
+Add the directory to the list of directories to be
+searched for header files. This option may be
+specified repeatedly.
+.TP
+\fB\-D\fR, \fB\-\-define\fR=\fI\,Value\/\fR
+predefine value as macro, e.g. \fB\-Dname\fR=\fI\,value\/\fR. If
+\&'=value' is omitted predefine it as 1. This option
+may be specified repeatedly.
+.TP
+\fB\-r\fR, \fB\-\-rom\fR=\fI\,Value\/\fR
+where to look for data files
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+be verbose \- this produces lots of output
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+be quiet \- no warnings
+.TP
+\fB\-\-prepro\fR
+output preprocessor output to stderr
+.TP
+\fB\-\-progress\fR
+show progress bar on longer operations
+.TP
+\fB\-\-version\fR
+display version and exit
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+display help and exit
+.SS "Options for run and static commands:"
+.IP
+These options apply to run and static commands.
+.TP
+\fB\-n\fR, \fB\-\-name\fR=\fI\,Value\/\fR
+the netlist in file specified by \fB\-f\fR option to run;
+default is first one
+.SS "Options for static command:"
+.IP
+These options apply to static command.
+.TP
+\fB\-d\fR, \fB\-\-dir\fR=\fI\,Value\/\fR
+output directory for the generated files.
+.TP
+\fB\-o\fR, \fB\-\-output\fR=\fI\,Value\/\fR
+single output file for the generated code.
+Either \fB\-\-dir\fR or \fB\-\-output\fR can be specificied
+.TP
+\fB\-\-static_include\fR
+write static solvers to individual files included by
+file specified with \fB\-\-output\fR. \fB\-\-dir\fR must be path to
+"generated/static" path in netlist folder.
+.SS "Options for run command:"
+.IP
+These options are only used by the run command.
+.TP
+\fB\-t\fR, \fB\-\-time_to_run\fR=\fI\,Value\/\fR
+time to run the emulation (seconds)
+.TP
+\fB\-\-boost_lib\fR=\fI\,Value\/\fR
+generic: will use generic solvers.
+builtin: Use optimized solvers compiled in.
+somelib.so: Use library with precompiled solvers.
+.TP
+\fB\-s\fR, \fB\-\-statistics\fR
+gather runtime statistics
+.TP
+\fB\-l\fR, \fB\-\-log\fR=\fI\,Value\/\fR
+define terminal to log. This option may be specified
+repeatedly.
+.TP
+\fB\-i\fR, \fB\-\-input\fR=\fI\,Value\/\fR
+input file to process (default is none)
+.TP
+\fB\-\-loadstate\fR=\fI\,Value\/\fR
+load state from file and continue from there
+.TP
+\fB\-\-savestate\fR=\fI\,Value\/\fR
+save state to file at end of run
+.TP
+\fB\-\-fperr\fR
+raise exception on floating point errors. This is
+intended to be used during debugging.
+.SS "Options for convert command:"
+.IP
+These options are only used by the convert command.
+.TP
+\fB\-y\fR, \fB\-\-type\fR=\fI\,spice\/\fR|eagle|rinf
+type of file to be converted: spice,eagle,rinf
+.SS "Options for validate command:"
+.IP
+These options are only used by the validate command.
+.SS "Options for header command:"
+.IP
+These options are only used by the header command.
+.TP
+\fB\-\-tab\-width\fR=\fI\,Value\/\fR
+Tab width for output.
+.TP
+\fB\-\-line\-width\fR=\fI\,Value\/\fR
+Line width for output.
+.TP
+\fB\-\-pattern\fR=\fI\,Value\/\fR
+Pattern to match against device names. If the device
+name contains pattern, the device will be included
+in the output. Multiple patterns can be specified,
+if none is given, all devices will be output.
+.SH EXAMPLES
+nltool \-c run \-t 3.5 \-n cap_delay nl_examples/cdelay.c
+.IP
+Run netlist "cap_delay" from file nl_examples/cdelay.c for 3.5
+seconds
+.PP
+nltool \-\-cmd=listdevices
+.IP
+List all known devices.
+.PP
+nltool \-\-cmd=header \-\-tab\-width=8 \-\-line\-width=80
+.IP
+Create the header file needed for including netlists as code.
+.PP
+nltool \-\-cmd static \-\-output
+.IP
+src/lib/netlist/generated/static_solvers.cpp
+src/mame/audio/nl_*.cpp src/mame/machine/nl_*.cpp
+.IP
+Create static solvers for the MAME project using one single source
+file.
+.PP
+nltool \-\-cmd static \-\-output
+.IP
+src/lib/netlist/generated/static_solvers.cpp \-\-dir
+src/lib/netlist/generated/static \-\-static_include
+src/mame/audio/nl_*.cpp src/mame/machine/nl_*.cpp
+.IP
+Create static solvers for the MAME project using a single source
+file which includes generated solvers written to \-\-dir folder.
+.PP
+nltool \-\-cmd tests
+.IP
+Run unit tests. In case the unit tests are not linked in, this will
+do nothing.
+.SH AUTHOR
+Written by Couriersud.
+.SH COPYRIGHT
+Copyright \(co 2021 Couriersud
+License BSD\-3\-Clause
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+More documentation for the
+.B nltool
+program is available in doxygen format.
+
diff --git a/src/lib/netlist/build/man/nlwav.1 b/src/lib/netlist/build/man/nlwav.1
new file mode 100644
index 00000000000..11c63423809
--- /dev/null
+++ b/src/lib/netlist/build/man/nlwav.1
@@ -0,0 +1,116 @@
+.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3.
+.TH NLWAV "1" "May 2022" "nlwav (netlist) 0.1" "User Commands"
+.SH NAME
+nlwav \- manual page for nlwav (netlist) 0.1
+.SH SYNOPSIS
+.B nlwav
+[\fI\,OPTION\/\fR] ... [\fI\,FILE\/\fR] ...
+.SH DESCRIPTION
+Convert netlist log files into wav files.
+.SH OPTIONS
+.TP
+\fB\-f\fR, \fB\-\-format\fR=\fI\,wav16s\/\fR|wav32s|wav32f|vcda|vcdd|tab
+output format. Available options are
+wav16s|wav32s|wav32f|vcda|vcdd|tab.
+.TP
+wav16s
+: multichannel wav output 16 bit signed
+.TP
+wav32s
+: multichannel wav output 32 bit signed
+.TP
+wav32f
+: multichannel wav output 32 bit float
+.TP
+vcda : analog VCD output
+vcdd : digital VCD output
+tab : sampled output
+Digital signals are created using the \fB\-\-high\fR and
+.IP
+\fB\-\-low\fR options
+.TP
+\fB\-o\fR, \fB\-\-output\fR=\fI\,Value\/\fR
+output file
+.SS "wav options:"
+.IP
+These options apply to wav output only
+.TP
+\fB\-r\fR, \fB\-\-rate\fR=\fI\,Value\/\fR
+sample rate of output file
+.TP
+\fB\-a\fR, \fB\-\-amp\fR=\fI\,Value\/\fR
+amplification after mean correction
+.TP
+\fB\-\-lowpass\fR=\fI\,Value\/\fR
+lowpass filter frequency.
+Default 20000 Hz.
+.TP
+\fB\-\-highpass\fR=\fI\,Value\/\fR
+highpass filter frequency.
+Default is 20 Hz.
+.TP
+\fB\-\-hpboost\fR
+enable highpass boost to filter out initial click.
+.SS "vcdd options:"
+.IP
+These options apply to vcdd output only
+.TP
+\fB\-u\fR, \fB\-\-high\fR=\fI\,Value\/\fR
+minimum input for high level
+.TP
+\fB\-l\fR, \fB\-\-low\fR=\fI\,Value\/\fR
+maximum input for low level
+.SS "tab options:"
+.IP
+These options apply to sampled output only
+.TP
+\fB\-s\fR, \fB\-\-start\fR=\fI\,Value\/\fR
+time when sampling starts
+.TP
+\fB\-i\fR, \fB\-\-increment\fR=\fI\,Value\/\fR
+time between samples
+.TP
+\fB\-n\fR, \fB\-\-samples\fR=\fI\,Value\/\fR
+number of samples
+.SS "General options:"
+.IP
+These options always apply
+.TP
+\fB\-v\fR, \fB\-\-verbose\fR
+be verbose \- this produces lots of output
+.TP
+\fB\-q\fR, \fB\-\-quiet\fR
+be quiet \- no warnings
+.TP
+\fB\-\-version\fR
+display version and exit
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+display help and exit
+.SH EXAMPLES
+\&./nlwav \-f vcdd \-o x.vcd log_V*
+.IP
+convert all files starting with "log_V" into a digital vcd file
+.PP
+\&./nlwav \-f wav16s \-o x.wav log_V*
+.IP
+convert all files starting with "log_V" into a multichannel wav file
+(16bit, signed)
+.PP
+\&./nlwav \-f tab \-o x.tab \-s 0.0000005 \-i 0.000001 \-n 256 log_BLUE.log
+.IP
+convert file log_BLUE.log to sampled output. First sample at 500ns
+followed by 255 samples every micro\-second.
+.SH AUTHOR
+Written by Couriersud.
+.SH COPYRIGHT
+Copyright \(co 2021 Couriersud
+License BSD\-3\-Clause
+.br
+This is free software: you are free to change and redistribute it.
+There is NO WARRANTY, to the extent permitted by law.
+.SH "SEE ALSO"
+More documentation for the
+.B nlwav
+program is available in doxygen format.
+