-
Notifications
You must be signed in to change notification settings - Fork 14
/
ups-protocols.txt
236 lines (154 loc) · 9.42 KB
/
ups-protocols.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
UPS Protocols
=============
All protocol information on this site is provided in the hope that it will be useful.
Some are officially provided by the manufacturers, while others are the result of reverse engineering work.
However, UPS hardware is plentiful and varied.
Test your software thoroughly, as these documents may not always reflect the reality within your equipment!
APC
---
- link:protocols/apcsmart.html[APC's smart protocol] - unofficial decoding work
- cross-check with
link:https://kirbah.github.io/apc-ups/Smart-protocol/[APC Smart UPS protocol]
rendition of the
link:https://github.com/kirbah/apc-ups[apc-ups protocol documentation project]
Belkin
------
- link:protocols/belkin.html[Belkin's smart protocol] - unofficial decoding work on the Regulator Pro
- link:protocols/belkin-protocol.html[Belkin UPS Protocol] - protocol specifications
- link:protocols/belkin-universal.html[Belkin Universal UPS] - courtesy of Peter Selinger
CyberPower
----------
- https://www.cyberpowersystems.com/products/software/mib-files/
- link:protocols/snmp/CyberPower_MIB_v2.3.mib[CyberPower UPS MIB v2.3] (TXT, 330 KB)
- link:protocols/snmp/CyberPower_MIB_v2.9.mib[CyberPower UPS MIB v2.9] (TXT, 341 KB)
- link:protocols/snmp/CyberPower_MIB_v2.11.mib[CyberPower UPS MIB v2.11] (TXT, 420 KB)
Delta
-----
- link:protocols/snmp/DeltaUPSv4.mib[Delta UPS v4 SNMP definitions] (TXT, 46 KB)
Eaton
-----
Documents in this section are provided courtesy of Eaton.
- link:protocols/eaton/UC2concept-1002889j.odt[UPScode II Concept Description] (ODT, 50 KB)
- <<mge,MGE Office Protection Systems protocol library>> (serial SHUT, USB and SNMP protocols)
- EATON (prev. Powerware) XCP protocol:
* link:protocols/eaton/XCP_Rev_C1_Public_021309.pdf[X-format Communications Protocol (XCP) Specification] (PDF, 996 KB)
* link:protocols/eaton/XCP_Alarm_Map_021309.pdf[XCP Alarm Map] (PDF, 54 KB)
* link:protocols/eaton/XCP_Meter_Map_021309.pdf[XCP Meter Map] (PDF, 21 KB)
- EATON SNMP Management Information Base:
* link:protocols/snmp/eaton-oids.mib[EATON general SNMP definitions] (TXT, 6.7 KB)
* link:protocols/snmp/Xups.mib[EATON PowerMIB (XUPS-MIB)] (TXT, 71 KB)
* link:protocols/snmp/eaton-epdu.mib[EATON ePDU G2/G3 (EPDU-MIB)] (TXT, 83 KB)
* link:protocols/snmp/eaton-ats.mib[EATON ATS (ATS-MIB)] (TXT, 19 KB)
* link:protocols/snmp/EATON-ATS2-MIB.mib[The MIB module for Eaton ATS (Automatic Transfer Switch)] (TXT, 23 KB)
* link:protocols/snmp/EATON-EMP-MIB.mib[The MIB module for Eaton Environment Monitoring Probes (EMP)] (TXT, 9.2 KB)
* link:protocols/snmp/EATON-EPDU-PU-MI-MIB-ePDU_MIB_Monitored_Blue_Display.mib[The MIB module for "pulizzi" Eaton Monitored ePDUs (Enclosed Power Distribution Units) with blue local display] (TXT, 44 KB)
* link:protocols/snmp/EATON-EPDU-PU-SW-MIB_ePDU_MIB_Switched_Blue_Display.mib[The MIB module for "pulizzi" Eaton Switched ePDUs (Enclosed Power Distribution Units)] (TXT, 114 KB)
* link:protocols/snmp/EATON-GENESIS-II_ePDU_MIB_Monitored_Red.mib[The MIB module for "genesis2" Eaton Monitored ePDUs (Enclosed Power Distribution Units)] (TXT, 4.5 KB)
* link:protocols/snmp/EATON-PXG-MIB.mib[The MIB module for objects and notifications supported by Eaton's Toolkit-enabled Power Xpert Gateways] (TXT, 18 KB)
* link:protocols/snmp/EATON_PULSAR_MIB17_AE.mib[MGE Pulsar, version 1.7 AE] (TXT, 91 KB)
* link:protocols/snmp/IPC36xx_Pulizzi_ePDU_MIB_Switched_Without_Display.mib[The MIB module for "pulizzi" Eaton Switched ePDUs (Enclosed Power Distribution Units)] (TXT, 14 KB)
* link:protocols/snmp/aphel-MA-ePDU_MIB_Managed_Red.mib[The MIB module for Power Distribution Unit by Aphel Ltd.] (TXT, 21 KB)
- link:protocols/fortress.html[Best Fortress protocol] - for LI 520, 720, 1020, and 1420 models
- link:protocols/sola.html[SOLA/Best Power protocol (Phoenixtec)] - courtesy of Invensys Energy Systems
Huawei
------
- link:protocols/huawei-ups2000-modbus.html[Support of Huawei UPS2000 1/2/3KRT (Modbus RTU)] --
based on link:https://support.huawei.com/enterprise/en/doc/EDOC1000110696[Huawei UPS2000 (1 kVA-3 kVA) Modbus Protocol Development Guide]
Legrand
-------
Documents officially provided by Legrand.
- link:protocols/legrand/UPS_MetaSystem_PUBLIC_Protocol_1.20b.pdf[Meta System UPS protocol v1.20b] (PDF, 420 KB) --
for ECO, HF, ALLY HF, MEGALINE and DHEA series
- link:protocols/legrand/Legrand_WHAD_DHEA_MEGALINE_PUBLIC_Protocol_1.21.pdf[Legrand (prev. Meta System) UPS protocol v1.21] (PDF, 264 KB) --
for MEGALINE, WHAD, DHEA and ALLY HF series
MicroDowell
-----------
- link:protocols/microdowell/MicroDowell_UPS_serial_protocol_v3.3.1.pdf[MicroDowell UPS Serial Protocol v3.3.1] (PDF, 225KB)
[[mge]]
MGE
---
Documents in this section are provided courtesy of MGE Office Protection Systems, and formerly MGE UPS SYSTEMS.
These have been mirrored from their their web server.
The Utalk (legacy ASCII protocol) documents only applies to MGE UPS SYSTEMS.
- link:protocols/mge/MGE-mibs.pdf[MGE UPS SYSTEMS SNMP MIBS descriptions] (PDF, 78 KB)
- link:protocols/mge/NUT_MGE_USB_Devices_Draft_AA.pdf[MGE USB Devices Draft AA] - official MGE HID UPS data (PDF, 310 KB)
- link:protocols/mge/51029473zaac.pdf[Simplified SHUT protocol] (PDF, 63 KB)
- link:protocols/mge/9260zw_g.pdf[U-Talk protocol general specifications] (PDF, 104 KB)
- link:protocols/mge/9261zwfa.pdf[U-Talk command set specifications] (PDF, 288 KB)
- link:protocols/mge/minutalk.pdf[U-Talk basic command set for UPS single monitoring communication] (PDF, 7 KB)
ONEAC
-----
- link:protocols/oneac.html[ONEAC serial information] - protocol specification
Opti-UPS
--------
- link:protocols/optiups.html[Opti-UPS protocol] - more guesswork
Powercom (PCM)
--------------
All these document are officially provided by Powercom
- link:protocols/powercom/Software_USB_communication_controller_BNT_series.doc[USB information for BNT series]
- link:protocols/powercom/Software_USB_communication_controller_IMPERIAL_series_R21.doc[USB information for IMPERIAL series]
- link:protocols/powercom/Software_USB_communication_controller_SKP_series.doc[USB information for SKP series]
- link:protocols/powercom/Software_USB_communication_controller_WOW_series.doc[USB information for WOW series]
Some information is also available on their site and mirrored with NUT:
- link:https://www.upspowercom.com/pcm-download/USB-Protocol1.pdf[USB HID
protocol implementation]
(link:protocols/powercom/USB-Protocol1.pdf[mirror])
- link:https://www.upspowercom.com/pcm-download/UPS-Protocol.pdf[Serial
Megatec Qx variant protocol implementation]
(link:protocols/powercom/UPS-Protocol.pdf[mirror])
PowerKinetics
-------------
- link:protocols/minicol.html[PowerKinetics MiniCOL protocol] - courtesy of PowerKinetics technical support
Riello
------
All these document are officially provided by Riello
- link:protocols/riello/PSGPSER-0104.pdf[GPSER protocol]
- link:protocols/riello/PSSENTR-0100.pdf[Sentry HPS / HTS protocol]
- link:protocols/riello/Riello_UPS_protocol_list.pdf[UPS protocol list]
Standard protocols
------------------
SEC
~~~
- link:protocols/sec.html[SEC protocol] - superset of the US9003, below
- link:protocols/sec-protocol.html[SEC UPS Standard Protocol] - protocol specification
- link:protocols/sec-standard.html[SEC Standard UPS Communication interface] - details of SEC communication interface
- link:protocols/us9003.html[US9003 UPS Communication Interface]
SNMP
~~~~
Documents in this section are provided courtesy of various manufacturers.
- IETF Management Information Base:
* link:protocols/snmp/rfc1628.mib[UPS MIB (RFC 1628)] (TXT, 64 KB)
* link:protocols/snmp/stdupsv1.mib[fixed UPS MIB (RFC 1628)] (TXT, 45 KB)
- APC Management Information Base:
* link:protocols/snmp/powernet344.mib[UPS MIB (PowerNet)] (TXT, 484 KB)
* link:protocols/snmp/APC-Powernet.pdf[MIB description] (PDF, 998 KB)
- Delta Management Information Base:
* link:protocols/snmp/DeltaUPSv4.mib[Delta UPS v4 SNMP definitions] (TXT, 46 KB)
- MGE Management Information Base:
* link:protocols/snmp/mgeups.mib[UPS MIB (MGE-MIB)] (TXT, 76 KB)
* link:protocols/mge/MGE-mibs.pdf[MIB description] (PDF, 78 KB)
- EATON Management Information Base:
* link:protocols/snmp/eaton-oids.mib[EATON general SNMP definitions] (TXT, 6.7 KB)
* link:protocols/snmp/Xups.mib[EATON PowerMIB (XUPS-MIB)] (TXT, 71 KB
* link:protocols/snmp/eaton-epdu.mib[EATON ePDU G2/G3 (EPDU-MIB)] (TXT, 79 KB)
* link:protocols/snmp/eaton-ats.mib[EATON ATS (ATS-MIB)] (TXT, 19 KB)
- HP/Compaq Management Information Base:
* link:protocols/snmp/CPQPOWER-MIB.mib[HP/Compaq Power MIB] (TXT, 68 KB)
* link:protocols/snmp/CPQUPS-MIB.mib[HP/Compaq UPS MIB] (TXT, 24 KB)
- Offsite links
* http://www.liebert.com/downloads/[Liebert MIBs]
* link:http://powerquality.eaton.com/Support/Software-Drivers/Downloads/connectivity-firmware/bestpwr2.mib[Best Power MIB]
USB/HID Power Devices Class
~~~~~~~~~~~~~~~~~~~~~~~~~~~
- link:https://www.usb.org/document-library/power-device-class-document-10[Power Device Class Document 1.0] library page
* link:https://www.usb.org/sites/default/files/pdcv10_0.pdf[Currently published revision of USB Usage Tables for HID Power Devices] (offsite PDF, 981 KB)
Various
-------
- link:protocols/megatec.html[Megatec] UPS Protocol
Voltronic Power
---------------
- link:protocols/voltronic.html[Voltronic Power UPS Protocol] - unofficial decoding work
- link:protocols/voltronic-qs.html[Voltronic Power - `QS' Protocols]
External SNMP MIB collections
-----------------------------
- https://github.com/librenms/librenms/tree/master/mibs