mbusd/doc/mbusd.8.in
Victor Antonovich 858931306f mbusd 0.2.3
2016-04-25 19:10:31 +03:00

81 lines
2.4 KiB
Groff

.TH "mbusd" 8 "25 Apr 2016" "mbusd @VERSION@"
.SH NAME
mbusd \- MODBUS/TCP to MODBUS/RTU gateway.
.SH SYNOPSIS
.B mbusd
.RB [ -h ]
.RB [ -d ]
.RB [ -t ]
.RB [ -v
.IR level ]
.RB [ -L
.IR logfile ]
.RB [ -p
.IR device ]
.RB [ -s
.IR speed ]
.RB [ -m
.IR mode ]
.RB [ -P
.IR port ]
.RB [ -C
.IR maxconn ]
.RB [ -N
.IR retries ]
.RB [ -R
.IR pause ]
.RB [ -W
.IR wait ]
.RB [ -T
.IR timeout ]
.SH DESCRIPTION
\fImbusd\fR is MODBUS/TCP to MODBUS/RTU gateway.
.SH OPTIONS
.IP \fB-h\fR
Usage help.
.IP \fB-d\fR
Instruct \fImbusd\fR not to fork itself (non-daemonize).
.IP \fB-t\fR
Enable RTS RS-485 data direction control (if not disabled while compile).
.IP "\fB-v \fIlevel\fR"
Specifies log verbosity level. 0 enables logging of errors only,
1 also enables warnings and 2 enables information messages.
If \fImbusd\fR was compiled in debug mode, valid log levels are up to 9,
where log levels above 2 forces logging of information about additional
internal events.
.IP "\fB-L \fIlogfile\fR"
Specifies log file name ('-' for logging to STDOUT only, default is /var/log/mbusd.log).
.IP "\fB-p \fIdevice\fR"
Specifies serial port device name.
.IP "\fB-s \fIspeed\fR"
Specifies serial port speed.
.IP "\fB-m \fImode\fR"
Specifies serial port mode (like 8N1).
.IP "\fB-P \fIport\fR"
Specifies TCP port number.
.IP "\fB-C \fImaxconn\fR"
Specifies maximum number of simultaneous TCP connections.
.IP "\fB-N \fIretries\fR"
Specifies maximum number of request retries (0 - disable retries).
.IP "\fB-R \fIpause\fR"
Specifies pause between requests in milliseconds.
.IP "\fB-W \fIwait\fR"
Specifies response wait time in milliseconds.
.IP "\fB-T \fItimeout\fR"
Specifies connection timeout value in seconds (0 - disable timeout).
.SH NOTES
In case of situation when \fImbusd\fR received response with invalid CRC and can't correct
error by re-request, it return MODBUS/TCP packet with exception code 04. In case of situation
when \fImbusd\fR can't receive response from MODBUS RTU device (e.g. addressed controller
is not present on the network), it return MODBUS/TCP packet with exception code 0x0B.
.SH BUGS
Broadcast messaging on MODBUS network isn't supported.
Please send bug reports to author.
.SH AUTHORS
Victor Antonovich <v.antonovich@gmail.com>
Andrew Denysenko <nitr0@seti.kr.ua>
.SH LICENSE
This program is distributed under BSD license. See LICENSE file in the installation directory for the full license text.