# Property of PMA Electrical Solutions, LLC.
#
# WEG CFW500 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, 0-based Net IDs and
#   P806 Modbus-TCP timeout. The generic list on p. 5-1 says P682/P683, but
#   the Ethernet definitions and startup procedure consistently require P684/P685.
# - WEG CFW500 Programming Manual 10006739425, V4.1X (08/2025),
#   readings pp. 19-1..19-6 and fault table pp. 0-28..0-32; CFW500 G2
#   addendum 10009591988 directs G2 users to this programming manual.
# Drive setup: install/recognize CETH2, select network sources in P220-P228,
# configure P313 stopping action and nonzero P806 timeout. This does not claim
# the CFW500 G2 RS-485/Modbus-RTU map.

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

[connection]
summary = "Install CFW500-CETH2 and connect either of its two Fast-Ethernet RJ45 ports for Modbus TCP."
warnings = ["Isolate and discharge the drive before installing the module.", "Both RJ45 sockets are one embedded switch; do not create an unmanaged network 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", "Industrial Ethernet switch only if needed"]
steps = ["Isolate the drive and install CFW500-CETH2 in the supported G2 inverter.", "Connect a shielded CAT5e-or-better cable to either RJ45 port.", "Connect the other end directly to the computer or the same industrial switch and restore the drive.", "Put the computer on the same subnet and select the drive IP in PMA-VFD."]
setup = ["Configure the module's IP mode/address, mask, and gateway as required.", "Select network command/reference sources in P220-P228 and configure P313 plus nonzero P806 timeout."]
warnings = ["Maximum copper segment is 100 m.", "The embedded switch goes down with drive power and interrupts downstream daisy-chain devices."]
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"
6 = "F0006 line phase loss / supply unbalance"
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"
73 = "F0073 HSRM overcurrent"
74 = "F0074 ground fault"
76 = "F0076 motor connection / phase-loss fault"
78 = "F0078 motor overtemperature"
79 = "F0079 encoder signal fault"
80 = "F0080 CPU watchdog fault"
81 = "F0081 firmware update failure"
83 = "F0083 hardware identification fault"
84 = "F0084 power-hardware identification 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"
100 = "F0100 EEPROM fault"
101 = "F0101 DataFlash fault"
150 = "F0150 motor overspeed"
151 = "F0151 incompatible parameter version"
153 = "F0153 internal 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"
247 = "F0247 EtherNet/IP offline"
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"
712 = "F0712 SoftPLC illegal download"
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)"