# Property of PMA Electrical Solutions, LLC.
#
# Schneider Altivar 61, embedded Modbus RTU. Exact-family sources: 1760661.07
# Communication Parameters (02/2013), CMD/LFR/ETA pp.74-87, metering pp.87-92,
# fault register/enumeration pp.99-103, history pp.107-124; 1760649.09
# Programming Manual (02/2014), Modbus defaults p.217 and SLL freewheel factory
# response pp.203-204. Logical addresses are zero-based PDU addresses.
# Keep CMI bit 9 clear so LFR/RFR remain 0.1 Hz rather than normalized.

name = "Schneider Altivar 61"
vendor = "Schneider Electric"
device_type = "vfd"
verified = false
probe_register = 3201

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

[monitor]
status_word = { address = 3201, bits = { 0 = "READY_TO_SWITCH_ON", 1 = "SWITCHED_ON", 2 = "OPERATION_ENABLED", 3 = "FAULT", 4 = "VOLTAGE_ENABLED", 5 = "QUICK_STOP_N", 6 = "SWITCH_ON_DISABLED", 7 = "WARNING", 9 = "REMOTE", 10 = "TARGET_REACHED", 11 = "INTERNAL_LIMIT", 14 = "STOP_KEY", 15 = "REVERSE" } }
output_frequency = { address = 3202, signed = true, scale = 0.1, unit = "Hz" }
motor_current = { address = 3204, scale = 0.1, unit = "A" }
motor_torque = { address = 3205, signed = true, scale = 0.001, unit = "rated torque" }
mains_voltage = { address = 3207, scale = 0.1, unit = "V" }
motor_voltage = { address = 3208, unit = "V" }
motor_power = { address = 3211, signed = true, unit = "%" }

[control]
command_register = 8501
speed_register = 8502
speed_scale = 0.1
speed_unit = "Hz"
max_ref = 500.0
step_delay = 0.05
stop = [0x0006]
run_fwd = [0x0006, 0x0007, 0x000F]
run_rev = [0x0006, 0x0007, 0x080F]
reset = [0x0000, 0x0080, 0x0006]

[[control.preconditions]]
register = 8504
mask = 0x0200
expected = 0
message = "CMI bit 9 must be clear so LFR/RFR use the documented 0.1 Hz scale"

[control.watchdog]
interval_ms = 50
fault = "SLF1 Modbus communication fault"

[running_check]
register = 3201
bit = 2

[direction_check]
register = 3201
bit = 15
reverse_when_set = true

[faults]
register = 7121
history = [7200, 7201, 7202, 7203, 7204, 7205, 7206, 7207, 7208]

[faults.codes]
0 = "nOF no fault"
2 = "EEF1 control-card memory fault"
3 = "CFF incorrect configuration"
4 = "CFI invalid configuration"
5 = "SLF1 Modbus communication interruption"
6 = "ILF option-module internal-link interruption"
7 = "CnF communication-card interruption"
8 = "EPF1 external fault"
9 = "OCF overcurrent"
10 = "CrF1 precharge fault"
11 = "SPF encoder feedback loss"
13 = "LFF2 AI2 4-20 mA loss"
14 = "PtF1 PTC1 probe open/short"
15 = "OtF1 PTC1 overtemperature"
16 = "OHF drive overtemperature"
17 = "OLF motor overload"
18 = "ObF DC bus overvoltage"
19 = "OSF mains overvoltage"
20 = "OPF1 single output phase loss"
21 = "PHF input phase loss"
22 = "USF undervoltage"
23 = "SCF1 motor short circuit"
24 = "SOF overspeed"
25 = "tnF autotuning fault"
26 = "InF1 rating error"
27 = "InF2 incompatible power board"
28 = "InF3 internal serial-link error"
29 = "InF4 manufacturing-data error"
30 = "EEF2 power-board memory fault"
31 = "SCF2 impedance short circuit"
32 = "SCF3 ground short circuit"
33 = "OPF2 three output phases lost"
34 = "COF CANopen interruption"
37 = "InF7 incomplete initialization"
38 = "EPF2 fieldbus external fault"
39 = "APF Controller Inside fault"
40 = "InF8 control supply fault"
42 = "SLF2 PC communication interruption"
44 = "SSF torque/current limitation"
45 = "SLF3 HMI communication interruption"
46 = "PrF power-removal safety fault"
47 = "PtF2 PTC2 probe open/short"
48 = "OtF2 PTC2 overtemperature"
49 = "PtFL LI6 PTC probe open/short"
50 = "OtFL LI6 PTC overtemperature"
51 = "InF9 current-measurement fault"
52 = "InFA input-stage fault"
53 = "InFb thermal-sensor fault"
54 = "tJF IGBT overtemperature"
55 = "SCF4 IGBT short circuit"
56 = "SCF5 motor short circuit"
58 = "FCF1 output contactor stuck closed"
59 = "FCF2 output contactor stuck open"
60 = "InFC time-measurement fault"
61 = "AI2F invalid AI2 signal"
62 = "EnF encoder fault"
63 = "CrF2 DC-bus thyristor charge fault"
64 = "LCF input contactor fault"
65 = "bUF braking-unit short circuit"
67 = "HdF IGBT desaturation"
68 = "InF6 unrecognized option"
69 = "InFE internal CPU fault"
70 = "bOF braking-resistor overload"
71 = "LFF3 AI3 4-20 mA loss"
72 = "LFF4 AI4 4-20 mA loss"
73 = "HCF card-pairing fault"
74 = "nFF no-flow fault"
75 = "PtrF control/power-card mismatch"
100 = "ULF process underload"
101 = "OLC process overload"
102 = "SPIF PID feedback below limit"

[connection]
summary = "Connect to the ATV61 embedded Modbus interface; no fieldbus option card is required for the documented serial path."
warnings = ["Lock out the drive/starter before opening covers or moving switches.", "Keep communications cable at least 30 cm from line and motor wiring.", "Prove read-only communication with the motor inhibited before enabling network control."]

[[connection.methods]]
id = "network_rs485"
title = "Integrated Modbus network port"
transport = "serial"
hardware = "built_in"
port = "Control-terminal Modbus network RJ45"
connector = "RJ45; exact pin assignment is not reproduced in cached exact-family publication 1760661.07"
adapter = "Isolated USB-to-RS-485 adapter"
cable = "Vendor-preterminated Modbus cable; exact conductor pinout is not reproduced in the cached exact-family source"
parts = ["Isolated USB-to-RS-485 adapter", "Shielded twisted pair plus common conductor", "End termination for a multidrop bus"]
steps = ["Lock out the equipment and verify it is de-energized.", "Locate Control-terminal Modbus network RJ45.", "Use a vendor-preterminated Modbus lead; do not invent a field pinout from another Altivar family.", "Route the communications cable at least 30 cm from power conductors and terminate only the two physical ends.", "Restore control power with the motor inhibited and verify a read before enabling control."]
setup = ["Configure Fr1/Cd1 for integrated Modbus.", "Match 19200 baud, 8-E-1.", "Keep CMI bit 9 clear and configure the integrated-port timeout."]
warnings = ["Do not connect adapter power to the vendor peripheral-power pin.", "The cached exact-family manual names the port but does not publish its RJ45 pinout; use the vendor cable."]
source = "Schneider 1760661.07 (02/2013), p. 6 and pp. 34-51; 1760649.09 p. 217."

[[connection.methods.wiring]]
adapter = "Vendor Modbus cable"
device = "Control-terminal Modbus network RJ45"
signal = "Preterminated RS-485 path; the exact pin assignment is not published in the cached exact-family source"

[[connection.methods]]
id = "hmi_rs485"
title = "Front-panel Modbus HMI port"
transport = "serial"
hardware = "built_in"
port = "Front-panel Modbus HMI RJ45"
connector = "RJ45; exact pin assignment is not reproduced in cached exact-family publication 1760661.07"
adapter = "Isolated USB-to-RS-485 adapter"
cable = "Vendor-preterminated Modbus cable; exact conductor pinout is not reproduced in the cached exact-family source"
parts = ["Isolated USB-to-RS-485 adapter", "Shielded twisted pair plus common conductor", "End termination for a multidrop bus"]
steps = ["Lock out the equipment and verify it is de-energized.", "Locate Front-panel Modbus HMI RJ45.", "Use a vendor-preterminated Modbus lead; do not invent a field pinout from another Altivar family.", "Route the communications cable at least 30 cm from power conductors and terminate only the two physical ends.", "Restore control power with the motor inhibited and verify a read before enabling control."]
setup = ["Configure Fr1/Cd1 for integrated Modbus.", "Match 19200 baud, 8-E-1.", "Keep CMI bit 9 clear and configure the integrated-port timeout."]
warnings = ["Do not connect adapter power to the vendor peripheral-power pin.", "The cached exact-family manual names the port but does not publish its RJ45 pinout; use the vendor cable."]
source = "Schneider 1760661.07 (02/2013), p. 6 and pp. 34-51; 1760649.09 p. 217."

[[connection.methods.wiring]]
adapter = "Vendor Modbus cable"
device = "Front-panel Modbus HMI RJ45"
signal = "Preterminated RS-485 path; the exact pin assignment is not published in the cached exact-family source"