# Property of PMA Electrical Solutions, LLC.
#
# Schneider Electric Altistart 22 (ATS22) soft starter, embedded Modbus RTU.
# Primary source: Schneider BBV51330.04, ATS22 User Manual, 09/2015:
# communication parameters pp.62 and 78-80; command/status words pp.66-67;
# protocol/addressing pp.68-73; monitoring/register index pp.78-81; trip table
# pp.75-77. Addresses are the manual's direct, zero-based Modbus addresses.
#
# Setup: COP/CtrL=1 [Modbus], Add=1..247. LI1 remains the hardwired stop and
# must be energized. Do not assign LI2/LI3 to LIL forced-local. This is a soft
# starter: there is no speed reference or reverse command.

name = "Schneider Altistart 22"
vendor = "Schneider Electric"
device_type = "soft_starter"
verified = false
probe_register = 256

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

[monitor]
status_word = { address = 256, bits = { 0 = "READY", 1 = "ON_CONDUCTING", 2 = "TRIP", 3 = "WARNING", 5 = "LI3", 6 = "LI2", 7 = "LI1", 14 = "LOCAL_CONTROL", 15 = "RAMPING" } }
phase_1_current = { address = 257, unit = "A" }
phase_2_current = { address = 258, unit = "A" }
phase_3_current = { address = 259, unit = "A" }
last_start_max_current = { address = 277, unit = "A" }
trip_current = { address = 280, unit = "A" }

[control]
command_register = 752
step_delay = 0.05
stop = [0x0000]
run_fwd = [0x0001]
# Bit 3 resets a trip. Keep RUN clear and frame the edge explicitly.
reset = [0x0000, 0x0008, 0x0000]

[control.watchdog]
interval_ms = 50
fault = "SLF Modbus timeout"

[running_check]
register = 256
bit = 1

[rating]
register = 0
scale = 1.0
unit = "A"
label = "starter rating"

[faults]
register = 279
history = [282, 283, 284, 285, 286, 287, 288, 289, 290]

[faults.codes]
0 = "no trip"
1 = "UCF motor undercurrent"
2 = "OCF motor overcurrent"
3 = "PHbd phase unbalance"
4 = "GrdF ground leakage"
5 = "OLF motor overload"
6 = "OtF motor overtemperature"
7 = "OHF starter overheat"
8 = "PIF phase inversion"
9 = "PHF line phase loss"
10 = "USF undervoltage"
11 = "OSF overvoltage"
12 = "StF starting time exceeded"
13 = "SnbF too many starts"
14 = "SSCr shorted thyristor or wrong connection"
15 = "EtF external fault"
16 = "InF internal fault"
17 = "SLF Modbus timeout"
18 = "trAP trap code"
19 = "SCF short circuit"
20 = "bPF bypass contactor fault"
21 = "CFF invalid power-up configuration"

[connection]
summary = "Use the ATS22 built-in Modbus RJ45 port; no option card is required."
warnings = ["Lock out the starter and motor circuit before opening the enclosure.", "Keep the RS-485 cable at least 30 cm from power conductors and cross them only at right angles.", "Do not connect adapter power to RJ45 pin 7; the starter supplies 12 V there.", "LI1 remains the hardwired stop/run-permit input and must be energized before a network start can work."]

[[connection.methods]]
id = "built_in_rs485"
title = "Built-in Modbus RJ45"
transport = "serial"
hardware = "built_in"
port = "Control terminal area, Modbus RJ45"
connector = "RJ45; pin 4 D1, pin 5 D0, pin 8 Common (pin 3 is also Common), shield is SNG"
adapter = "Isolated USB-to-RS-485 adapter with D1/D0/Common terminals"
cable = "Shielded twisted-pair RS-485 cable, with an RJ45 plug wired only to the documented Modbus signals"
parts = ["Isolated USB-to-RS-485 adapter", "Shielded twisted pair plus common conductor", "RJ45 plug or Schneider Modbus lead", "120 ohm + 1 nF end terminators for a multidrop bus"]
steps = ["Lock out all power and verify the starter is de-energized.", "Open the control-terminal cover and locate the Modbus RJ45 socket.", "Wire the adapter to RJ45 pins 4, 5 and 8 using the mapping below; bond the cable shield to SNG.", "Route the cable away from line and motor wiring and terminate only the two physical ends of a multidrop bus.", "Restore control power, leave the motor unable to start, and test a read before enabling control."]
setup = ["Set COP/CtrL = 1 (Modbus).", "Set Add to a unique value from 1 to 247.", "Match the profile serial settings: 19200 baud, 8-E-1.", "Keep LI1 energized and do not assign LI2/LI3 to forced-local LIL."]
warnings = ["Pins 3 and 8 are Common; use one documented Common connection, not pin 7.", "One of R1/R2 must remain configured and wired as trIP as required by the ATS22 user manual."]
source = "Schneider BBV51330.04 (09/2015), pp. 35 and 68-73."

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

[[connection.methods.wiring]]
adapter = "Cable shield"
device = "RJ45 shield — SNG"
signal = "Shield"
required = false