188 lines
6.7 KiB
Text
188 lines
6.7 KiB
Text
ifdef::website[]
|
|
Hardware compatibility list
|
|
===========================
|
|
endif::website[]
|
|
|
|
[NOTE]
|
|
================================================================================
|
|
|
|
Before you buy, take a look at the link:acknowledgements.html[Acknowledgements]
|
|
for information about which drivers are developed with the support of the manufacturer.
|
|
|
|
Be sure to also read the <<footnotes,footnotes>>.
|
|
|
|
================================================================================
|
|
|
|
ifdef::website[]
|
|
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
<fieldset id="support-level-legend">
|
|
<legend>Support level legend</legend>
|
|
<dl style="list-style: none; padding: 0;">
|
|
<dt><span class="red hcl-legend-level">1</span></dt><dd>protocol based on reverse engineering</dd>
|
|
<dt><span class="orange hcl-legend-level">2</span></dt><dd>based on fragments of publicly available protocol</dd>
|
|
<dt><span class="yellow hcl-legend-level">3</span></dt><dd>based on publicly available protocol</dd>
|
|
<dt><span class="blue hcl-legend-level">4</span></dt><dd>vendor provided protocol</dd>
|
|
<dt><span class="green hcl-legend-level">5</span></dt><dd>vendor provided protocol and hardware</dd>
|
|
</dl>
|
|
</fieldset>
|
|
<fieldset id="filters-set">
|
|
<legend>Filters</legend>
|
|
<table>
|
|
<tbody>
|
|
<tr>
|
|
<td>
|
|
<label for="support-level">Support Level</label>
|
|
</td>
|
|
<td>
|
|
<select id="support-level" class="filter">
|
|
<option value="-1">----</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<label for="device-type">Device type</label>
|
|
</td>
|
|
<td>
|
|
<select id="device-type" class="filter">
|
|
<option value="-1">----</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<label for="manufacturer">Manufacturer</label>
|
|
</td>
|
|
<td>
|
|
<select id="manufacturer" class="filter">
|
|
<option value="-1">----</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<label for="model">Model</label>
|
|
</td>
|
|
<td>
|
|
<select id="model" class="filter">
|
|
<option value="-1">----</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
<label for="connection">Connection</label>
|
|
</td>
|
|
<td>
|
|
<select id="connection" class="filter">
|
|
<option value="-1">----</option>
|
|
</select>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td colspan="2"><input type="button" value="Reset" onclick="NUT.resetCombos.call(NUT);" /></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</fieldset>
|
|
|
|
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
include::ups-html.txt[]
|
|
|
|
endif::website[]
|
|
|
|
[[footnotes]]
|
|
[NOTE]
|
|
================================================================================
|
|
|
|
|
|
*If your device isn't listed*
|
|
|
|
First, if there are other models by the same manufacturer, try their drivers.
|
|
You may find that it "just works" or mostly works.
|
|
|
|
In either case, send in a report so this list and the driver can be improved.
|
|
|
|
Next, if you don't find any match, there are a few drivers that have a good
|
|
chance of working on random hardware. These are indicated in the
|
|
link:stable-hcl.html?manufacturer=Various[Various] entries above.
|
|
|
|
After doing that, if those aren't working, you might try running other ones
|
|
from the set to see if anything works. Sometimes you get lucky. Finally, if
|
|
absolutely nothing works and your cabling is OK, try contacting the list and
|
|
we will see what we can do for you.
|
|
|
|
In general, if a driver does not exist, that's due to the lack of overlap
|
|
between the set of developers and the set of owners of that hardware.
|
|
|
|
The way to fix it is to turn a developer into an owner, or an owner into a
|
|
developer.
|
|
|
|
|
|
*Report new devices, omissions or errors*
|
|
|
|
There are a lot of power devices hardware for sale, and it's possible
|
|
that we have missed listing some that are supported, or made an error.
|
|
|
|
So that this list can be as accurate as possible, please report any
|
|
omissions to the
|
|
link:http://lists.alioth.debian.org/mailman/listinfo/nut-upsdev[NUT Developers] mailing list
|
|
or the NUT link:https://github.com/networkupstools/nut/issues/new[issue tracker on GitHub],
|
|
including the following information:
|
|
|
|
- mail subject: [HCL] <Manufacturer> <Device> supported by <driver>
|
|
- or tag the issue "HCL" and title it: <Manufacturer> <Device> supported by <driver>
|
|
replacing Manufacturer, Device and driver by your specific values,
|
|
- mail or issue body:
|
|
- Device manufacturer and name,
|
|
- upsc output (upsrw and upscmd outputs are also welcome),
|
|
- link:docs/user-manual.chunked/ar01s06.html#Shutdown_design[shutdown sequence]
|
|
testing results: a statement that you have actually tested it successfully is
|
|
enough for now,
|
|
- a link to the manufacturer's online description of the device is also appreciated.
|
|
|
|
|
|
*Linking to the HCL*
|
|
|
|
You can create a direct link to the HCL, specifying some filters within the URL
|
|
(JavaScript must be enabled in the browser for this to work). This allows you
|
|
to select devices that matches some specific criteria, like a connection type
|
|
or a manufacturer. All filters available on the page itself are also available
|
|
for use in the URL.
|
|
|
|
The form of the URL is the following:
|
|
|
|
http://www.networkupstools.org/stable-hcl.html?<filter-name>=<filter-value>
|
|
|
|
.Possible values
|
|
[options="header,autowidth",style="asciidoc",cols="<,<"]
|
|
|===================================================================
|
|
|<filter-name> |<filter-value>
|
|
|support-level |a number from '1' to '5'
|
|
|device-type |- 'ups' for uninterruptible power supply
|
|
- 'pdu' for power distribution unit
|
|
- 'psu' for power supply unit
|
|
- 'scd' for solar controller device
|
|
|manufacturer |a manufacturer name from the selection list
|
|
|model |a model name from the selection list
|
|
|connection |- 'USB'
|
|
- 'Serial'
|
|
- 'Network'
|
|
|===================================================================
|
|
|
|
You can combine multiple filters, using ampersand (*&*).
|
|
|
|
For example, if you only want to select USB units from Eaton, use:
|
|
|
|
http://www.networkupstools.org/stable-hcl.html?manufacturer=Eaton&connection=USB
|
|
|
|
|
|
|
|
================================================================================
|
|
|
|
////////////////////////////////////////////////////////////////////////////////
|
|
FIXME:
|
|
- point and complete the "user manual -> support" section for success report
|
|
link:user-manual.html#Support_Request[Support instructions] in the user manual.
|
|
////////////////////////////////////////////////////////////////////////////////
|