'\" t
.\" Title: nhs_ser
.\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 05/29/2025
.\" Manual: NUT Manual
.\" Source: Network UPS Tools 2.8.3
.\" Language: English
.\"
.TH "NHS_SER" "8" "05/29/2025" "Network UPS Tools 2\&.8\&.3" "NUT Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
nhs_ser \- Driver for NHS Nobreaks, senoidal line, with serial port
.SH "SYNOPSIS"
.sp
\fBnhs_ser\fR \-h
.sp
\fBnhs_ser\fR \-a \fIUPS_NAME\fR [\fIOPTIONS\fR]
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.sp
This man page only documents the hardware\-specific features of the \fBnhs_ser\fR driver\&. For information about the core driver, see \fBnutupsdrv\fR(8)\&.
.sp .5v
.RE
.SH "SUPPORTED HARDWARE"
.sp
\fBnhs_ser\fR supports numerous UPS models made by NHS Sistemas Eletronicos LTDA and marketed in Brazil\&. They feature a serial port and a binary wire protocol\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.sp
Currently this driver only builds on Linux\&. This is expected to change in future revisions of the code\&.
.sp .5v
.RE
.SH "EXTRA ARGUMENTS"
.sp
This driver also supports the following optional settings:
.PP
\fBbaud\fR=\fInum\fR
.RS 4
Set the value of serial port baud rate (default: 2400)
.RE
.PP
\fBah\fR=\fInum\fR
.RS 4
Battery discharge capacity in Ampere/hour\&.
.RE
.PP
\fBva\fR=\fInum\fR
.RS 4
Nobreak NOMINAL POWER in VA\&.
.RE
.PP
\fBpf\fR=\fInum\fR
.RS 4
Power Factor to use in calculations of battery time (default: 0\&.90)\&.
.RE
.PP
\fBvin_low_warn_perc\fR=\fInum\fR
.RS 4
Voltage In Percentage to calculate warning low level (default: 2\&.00)\&.
.RE
.PP
\fBvin_low_crit_perc\fR=\fInum\fR
.RS 4
Voltage In Percentage to calculate critical low level (default: 2\&.00)\&.
.RE
.PP
\fBvin_high_warn_perc\fR=\fInum\fR
.RS 4
Voltage In Percentage to calculate warning high level (default: 2\&.00)\&.
.RE
.PP
\fBvin_high_crit_perc\fR=\fInum\fR
.RS 4
Voltage In Percentage to calculate critical high level (default: 2\&.00)\&.
.RE
.PP
\fBnumbatteries\fR=\fInum\fR
.RS 4
Num Batteries (override value from nobreak)\&.
.RE
.PP
\fBvbat\fR=\fInum\fR
.RS 4
Battery Voltage (default: 12\&.00)\&.
.RE
.PP
\fBdebug_pkt_raw\fR
.RS 4
Optional flag to enable debug logging of packet bytes\&.
.RE
.PP
\fBdebug_pkt_data\fR
.RS 4
Optional flag to enable debug logging of data packet decoding\&.
.RE
.PP
\fBdebug_pkt_hwinfo\fR
.RS 4
Optional flag to enable debug logging of hwinfo packet decoding\&.
.RE
.SH "AUTHORS"
.sp
Lucas Willian Bocchi
.SH "SEE ALSO"
.SS "The core driver:"
.sp
\fBnutupsdrv\fR(8)
.SS "Internet resources:"
.sp
The NUT (Network UPS Tools) home page: https://www\&.networkupstools\&.org/historic/v2\&.8\&.3/