# Property of PMA Electrical Solutions, LLC.
#
# Schneider Easy Altivar ATV305, ATV310 and ATV310S: EAV94279's Instructions
# sheet explicitly says these three models share the Common Modbus Address
# sheet. EAV94278.04 (04/2026) supplies serial/timeout pp.10-11, scanner map
# pp.12-14, and exact CMD/ETA state machine pp.20-23. Addresses below are
# direct zero-based logical addresses. Setup control/reference for Modbus per
# EAV94277; Add @6001 ships OFF. Factory serial is 19200 8E1.



name = "Schneider Easy Altivar ATV305 / ATV310 / ATV310S"
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_ALWAYS", 5 = "QUICK_STOP_N", 6 = "SWITCH_ON_DISABLED", 9 = "LOCAL_N", 10 = "TARGET_REACHED", 11 = "REFERENCE_EXCEEDED", 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.1, unit = "%" }
drive_thermal_state = { address = 3209, unit = "%" }

[control]
command_register = 8501
speed_register = 8502
speed_scale = 0.1
speed_unit = "Hz"
max_ref = 400.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 = "F022 Modbus interruption"

[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]

[faults.codes]
0 = "(nOF)"
1 = "(InF)"
3 = "(CFF)"
4 = "(CFI)"
5 = "(SLF1)"
9 = "(OCF)"
10 = "(CrF1)"
16 = "(OHF)"
17 = "(OLF)"
18 = "(ObF)"
19 = "(OSF)"
20 = "(OPF1)"
21 = "(PHF)"
22 = "(USF)"
23 = "(SCF1)"
24 = "(SOF)"
25 = "(tnF)"
26 = "(InF1)"
27 = "(InF2)"
28 = "(InF3)"
29 = "(InF4)"
32 = "(SCF3)"
33 = "(OPF2)"
42 = "(SLF2)"
45 = "(SLF3)"
51 = "(InF9)"
53 = "(InFb)"
54 = "(tJF)"
55 = "(SCF4)"
56 = "(SCF5)"
69 = "(InFE)"
77 = "(CFI2)"
100 = "(ULF)"
101 = "(OLC)"
102 = "(SPIF)"
105 = "(ASF)"
106 = "(LFF1)"
107 = "(PPF)"
253 = "(XXXX)"

[connection]
summary = "Connect to the ATV305 / ATV310 / ATV310S 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 = "built_in_rs485"
title = "Built-in Modbus RJ45"
transport = "serial"
hardware = "built_in"
port = "Built-in Modbus RJ45"
connector = "RJ45; pin 4 D1, pin 5 D0, pin 8 Common; pin 7 is vendor peripheral power"
adapter = "Isolated USB-to-RS-485 adapter"
cable = "VW3A8306D30 RJ45-to-stripped Modbus lead or equivalently pinned shielded twisted-pair cable"
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 Built-in Modbus RJ45.", "Wire D1, D0 and Common exactly as shown below; leave the peripheral-power pin unused.", "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 = ["Set Add @6001 to a unique 1..247 address.", "Route command and reference to Modbus as specified by the exact drive commissioning manual.", "Match 19200 baud and 8-E-1."]
warnings = ["Do not connect adapter power to the vendor peripheral-power pin.", "Connect only the documented data and Common conductors."]
source = "Schneider EAV94278.04 (04/2026), pp. 9-14 and 20-23."

[[connection.methods.wiring]]
adapter = "D1 / B / +"
device = "RJ45 pin 4 — D1"
signal = "RS-485 D1"

[[connection.methods.wiring]]
adapter = "D0 / A / -"
device = "RJ45 pin 5 — D0"
signal = "RS-485 D0"

[[connection.methods.wiring]]
adapter = "COM / signal common"
device = "RJ45 pin 8 — Common"
signal = "Signal reference"