# Property of PMA Electrical Solutions, LLC.
#
# WEG MW500 G2 with the CFW500-CETH2 dual-port Ethernet module, Modbus TCP.
# Sources:
# - WEG CFW500/MW500 G2 CETH2 Communication Manual 10011171860/01,
#   V1.2X (12/2024), pp. 4-1..4-8, 5-1 and 8-1: exact shared G2 scope,
#   P680 status, P684/P685 Ethernet control/reference and P806 timeout.
# - WEG MW500 G2 Programming Manual 10010648794, V3.0X (03/2023),
#   readings pp. 18-1..18-7 and fault table pp. 0-28..0-34.
# Drive setup: install/recognize CETH2, select network sources in P220-P228,
# configure P313 stopping action and nonzero P806 timeout. This does not claim
# the MW500 G2 RS-485/Modbus-RTU map.

name = "WEG MW500 G2 (CETH2 Modbus TCP)"
vendor = "WEG"
device_type = "vfd"
verified = false
probe_register = 680

[connection]
summary = "Install CFW500-CETH2 in the MW500 G2 and use either dual-port RJ45 socket for Modbus TCP."
warnings = ["Isolate the distributed drive before installing the module and restore its enclosure seals afterward.", "Do not connect both ports into an unmanaged loop."]
[[connection.methods]]
id = "ceth2_modbus_tcp"
title = "CFW500-CETH2 dual-port Ethernet"
transport = "tcp"
hardware = "option"
port = "CFW500-CETH2 RJ45 port 1 or 2"
connector = "Two 100BASE-TX RJ45 sockets"
adapter = "Computer Ethernet port or USB-to-Ethernet adapter"
cable = "Shielded CAT5e-or-better industrial Ethernet cable"
parts = ["CFW500-CETH2 module", "Correct enclosure cable gland", "Industrial Ethernet switch only if needed"]
steps = ["Isolate and open the MW500 G2, install CFW500-CETH2, and preserve all enclosure hardware.", "Connect a shielded CAT5e-or-better cable to either RJ45 socket.", "Reseal the unit, connect the other end to the computer or switch, and restore power.", "Place the computer on the module subnet and select the drive IP."]
setup = ["Configure IP mode/address, subnet mask, and gateway.", "Select network sources in P220-P228 and commission P313 plus nonzero P806 timeout."]
warnings = ["Maximum copper link length is 100 m.", "Powering down the MW500 disables the embedded switch and breaks downstream daisy-chain traffic."]
source = "WEG 10011171860/01, pp. 2-1 through 3-2, 4-1 through 4-8, and 8-1"

[monitor]
status_word = { address = 680, bits = { 0 = "STO", 1 = "RunCommand", 2 = "FireMode", 4 = "QuickStop", 5 = "SecondRamp", 6 = "ConfigMode", 7 = "Alarm", 8 = "MotorRunning", 9 = "GeneralEnable", 10 = "Forward", 11 = "JOG", 12 = "Remote", 13 = "Undervoltage", 14 = "PIDAuto", 15 = "Fault" } }
output_frequency = { address = 5, scale = 0.1, unit = "Hz" }
motor_current = { address = 3, scale = 0.1, unit = "A" }
dc_bus_voltage = { address = 4, unit = "V" }
output_voltage = { address = 7, unit = "V" }
motor_torque = { address = 9, signed = true, scale = 0.1, unit = "%" }
motor_speed = { address = 681, signed = true, scale = 0.01220703125, unit = "%" }
present_alarm = { address = 48 }

[control]
command_register = 684
speed_register = 685
speed_scale = 0.01220703125
speed_unit = "%"
max_ref = 100.0
step_delay = 0.05
stop = [0x0016]
run_fwd = [0x0016, 0x0017]
run_rev = [0x0012, 0x0013]
reset = [0x0016, 0x0096, 0x0016]

[control.watchdog]
interval_ms = 50
fault = "A149/F249 Modbus-TCP timeout (P313/P806 require setup)"
backstop_requires_setup = true

[running_check]
register = 680
bit = 8

[direction_check]
register = 680
bit = 10
reverse_when_set = false

[faults]
register = 49
history = [50, 60, 70, 80, 81, 82]

[faults.codes]
0 = "No fault"
21 = "F0021 DC-link undervoltage"
22 = "F0022 DC-link overvoltage"
31 = "F0031 plug-in communication fault"
33 = "F0033 VVW self-tuning fault"
48 = "F0048 IGBT overload"
51 = "F0051 IGBT overtemperature"
68 = "F0068 motor overtemperature"
70 = "F0070 overcurrent or short circuit"
72 = "F0072 motor overload"
74 = "F0074 ground fault"
76 = "F0076 input/motor phase fault"
78 = "F0078 motor overtemperature"
79 = "F0079 encoder signal fault"
80 = "F0080 CPU watchdog fault"
81 = "F0081 device firmware update failure"
83 = "F0083 PWM active-level mismatch"
84 = "F0084 auto-diagnosis fault"
85 = "F0085 plug-in initialization fault"
86 = "F0086 safety-module identification fault"
87 = "F0087 phase-U current-offset fault"
88 = "F0088 phase-V current-offset fault"
89 = "F0089 phase-W current-offset fault"
91 = "F0091 external fault"
150 = "F0150 motor overspeed"
153 = "F0153 internal-air overtemperature"
158 = "F0158 firmware/plug-in mismatch"
160 = "F0160 safety-module fault"
161 = "F0161 safety-module communication fault"
162 = "F0162 STO hardware incompatibility"
169 = "F0169 speed error too high"
179 = "F0179 internal-fan speed fault"
182 = "F0182 pulse-feedback fault"
228 = "F0228 serial timeout"
233 = "F0233 CAN interface without power"
234 = "F0234 CAN bus off"
235 = "F0235 CANopen communication fault"
236 = "F0236 DeviceNet master idle"
237 = "F0237 DeviceNet timeout"
238 = "F0238 Profibus DP clear mode"
239 = "F0239 Profibus DP offline"
240 = "F0240 Profibus DP module access fault"
248 = "F0248 Ethernet module access fault"
249 = "F0249 Ethernet/Modbus-TCP timeout"
700 = "F0700 remote-HMI communication fault"
709 = "F0709 SoftPLC application stopped"
710 = "F0710 SoftPLC application too large"
711 = "F0711 SoftPLC application fault"
761 = "F0761 internal-PID process-variable low"
763 = "F0763 internal-PID process-variable high"
767 = "F0767 dry pump detected"
769 = "F0769 broken belt detected"
771 = "F0771 filter maintenance"
787 = "F0787 external-PID process-variable low"
789 = "F0789 external-PID process-variable high"

[rating]
register = 295
scale = 0.1
unit = "A"
label = "Inverter rated current (P0295)"