@@ -83,6 +83,46 @@ Set the Modbus slave id. The default slave id is 1.
8383Set the Modbus response timeout. The default timeout is set by libmodbus. It can
8484be good to set a higher timeout on TCP connections with high latency.
8585
86+ BUGS
87+ ----
88+
89+ This driver relies on advanced features of `libmodbus` to talk Modbus protocol
90+ over USB specifically (Serial and TCP are part of common library codebase).
91+ At the time of this writing, the common library project is just expecting a
92+ merge of the pull request with this ability.
93+
94+ For the time being, if your OS distribution does not ship the required feature
95+ set, you may have to build your own `libmodbus` and subsequently (re-)build NUT
96+ against this library, as detailed in the NUT GitHub Wiki at
97+ https://github.com/networkupstools/nut/wiki/APC-UPS-with-Modbus-protocol
98+
99+ The short sequence may be like follows:
100+ ------
101+ cd ~/
102+ git clone -b rtu_usb https://github.com/networkupstools/libmodbus
103+ cd libmodbus
104+ ./autogen.sh
105+ ./configure --with-libusb --prefix=/path/to/prefix
106+ make install
107+
108+ cd ~/
109+ git clone https://github.com/networkupstools/nut
110+ cd nut
111+ ./autogen.sh
112+ ./configure --with-drivers=apc_modbus --with-usb --with-modbus \
113+ --with-modbus-includes=-I/path/to/prefix/include/modbus \
114+ --with-modbus-libs="-L/path/to/prefix/lib -lmodbus"
115+ make
116+ ------
117+
118+ NOTE: Other `configure` options may be needed for proper behavior, such as
119+ `--prefix`, `--with-sysconfdir`, `--with-user` and `--with-group` to match
120+ your packaged or otherwise preceding NUT installation.
121+
122+ The `./configure --enable-inplace-runtime` may be a good start to inherit
123+ build configuration from an existing NUT deployment, as further detailed at
124+ https://github.com/networkupstools/nut/wiki/Building-NUT-for-in%E2%80%90place-upgrades-or-non%E2%80%90disruptive-tests
125+
86126AUTHORS
87127-------
88128
0 commit comments