# Property of PMA Electrical Solutions, LLC.
#
# WEG CFW701 HVAC frequency inverter over its standard RS-485 interface.
# Sources:
# - WEG CFW701 Modbus RTU User's Manual 10001538593/00 (08/2013),
#   pp. 10-18 and 26-27: defaults, P680/P682/P683, watchdog and 0-based map.
# - WEG CFW701 Programming Manual 10001461481/02, V2.1X (01/2018),
#   pp. 0-1..0-25 and 14-1..14-11: exact-family fault table.
# Drive setup: P312 = 2 and P105/P220-P228 select Serial. P313 and P314
# default inactive, so configure both the stop action and timeout.

name = "WEG CFW701"
vendor = "WEG"
device_type = "vfd"
verified = false
probe_register = 680

[connection]
summary = "Use the standard XC1 RS-485 interface on pins 8-10."
warnings = ["Isolate and discharge the inverter before handling XC1.", "Use shielded twisted pair away from line/motor wiring."]
[[connection.methods]]
id = "xc1_rs485"
title = "Standard XC1 RS-485"
transport = "serial"
hardware = "built_in"
port = "XC1 pin 10 A-Line(-), pin 9 B-Line(+), pin 8 GND"
connector = "XC1 control terminal block"
adapter = "Isolated USB-to-RS-485 adapter"
cable = "Shielded twisted pair with optional reference"
parts = ["Small insulated screwdriver", "S2 endpoint termination"]
wiring = [{ adapter = "D- / A-", device = "XC1-10 A-Line (-)", signal = "RS-485 negative" }, { adapter = "D+ / B+", device = "XC1-9 B-Line (+)", signal = "RS-485 positive" }, { adapter = "COM/GND", device = "XC1-8 GND", signal = "0 V reference", required = false }]
steps = ["Isolate the drive and locate XC1 pins 8, 9, and 10.", "Land negative on 10, positive on 9, and optional reference on 8.", "Enable both S2 switches only at a physical bus end and route the cable separately from power wiring.", "Restore the enclosure and power, then select the computer adapter."]
setup = ["Set P312 = 2 and configure P308/P310/P311.", "Use P105/P220-P228 to select Serial and configure P313 plus nonzero P314."]
warnings = ["P313 and P314 default inactive; do not rely on a communications-loss stop until commissioned."]
source = "WEG 10001538593/00, pp. 7-8, 10-18, and 26-27"

[serial]
baudrate = 19200
parity = "N"
stopbits = 1

[monitor]
status_word = { address = 680, bits = { 4 = "FastStop", 5 = "SecondRamp", 6 = "ConfigMode", 7 = "Alarm", 8 = "MotorRunning", 9 = "GeneralEnable", 10 = "Forward", 11 = "JOG", 12 = "Remote", 13 = "Undervoltage", 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 = 682
speed_register = 683
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 = "A128/F228 serial timeout (requires P313/P314 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, 54, 58, 62, 66]

[faults.codes]
0 = "No fault"
6 = "F0006 line phase loss / supply unbalance"
21 = "F0021 DC-link undervoltage"
22 = "F0022 DC-link overvoltage"
48 = "F0048 IGBT overload"
51 = "F0051 IGBT overtemperature"
70 = "F0070 overcurrent or short circuit"
71 = "F0071 output overcurrent"
72 = "F0072 motor overload"
74 = "F0074 ground fault"
76 = "F0076 motor-current unbalance"
78 = "F0078 motor overtemperature"
80 = "F0080 CPU watchdog fault"
84 = "F0084 auto-diagnosis fault"
91 = "F0091 external fault"
99 = "F0099 invalid current offset"
150 = "F0150 motor overspeed"
151 = "F0151 flash-memory-module fault"
153 = "F0153 internal-air overtemperature"
156 = "F0156 undertemperature"
157 = "F0157 parameter-table data loss"
158 = "F0158 parameter-table fault"
160 = "F0160 safety-stop relay fault"
169 = "F0169 speed error too high"
179 = "F0179 heatsink-fan speed fault"
182 = "F0182 pulse-feedback fault"
183 = "F0183 IGBT overload/overtemperature"
185 = "F0185 pre-charge contactor fault"
228 = "F0228 serial communication timeout"
711 = "F0711 SoftPLC execution fault"
761 = "F0761 main-PID process-variable low"
763 = "F0763 main-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"
797 = "F0797 secondary-external-PID process-variable low"
799 = "F0799 secondary-external-PID process-variable high"