# Property of PMA Electrical Solutions, LLC.
#
# Yaskawa GA500 over MEMOBUS.
#
# Corrected against Yaskawa SIEPC71061752 (GA500 Technical Reference).
# Cross-family claims (V1000 / A1000) REMOVED: the output-current scale
# demonstrably differs between GA500 and V1000.
#
# Original header follows.
# Yaskawa GA500 over MEMOBUS, which is Modbus RTU with Yaskawa
# naming. The 0x0020-0x003F block is the fixed monitor area and is stable
# across the 1000-series and GA-series.
#
# Drive-side setup: b1-01 Frequency reference source = 2 (MEMOBUS),
# b1-02 Run command source = 2, H5-01 node address, H5-02 baud, H5-03 parity.
# Cycle power after changing H5-xx.
#
# Parameter addressing: each parameter has its own MEMOBUS address printed in
# the manual's parameter list (b1-01 is 0x0180, not something you can compute).

name = "Yaskawa GA500"
vendor = "Yaskawa"
verified = false
device_type = "vfd"
probe_register = 0x0020

[connection]
summary = "The GA500 supports built-in two-wire MEMOBUS/Modbus RTU on its D+/D-/AC screw terminals and optional Modbus TCP/IP through a Yaskawa SI-EM3 card. The TCP option also requires the separately sold JOHB-GA50 mounting kit."
warnings = []

[[connection.methods]]
id = "built_in_memobus_rtu"
title = "Built-in D+/D-/AC MEMOBUS/Modbus RTU"
transport = "serial"
hardware = "built_in"
port = "Serial communication screw terminals D+, D-, and AC. Table 3.11 places these terminals on TB1-3; the network chapter calls the serial terminal TB4. Use the printed D+/D-/AC markings, not a guessed block number."
connector = "Three control-circuit screw terminals marked D+, D-, and AC"
adapter = "Isolated USB-to-RS-485 adapter, two-wire half-duplex"
cable = "Shielded twisted-pair RS-485 cable"
parts = ["Isolated two-wire RS-485 adapter", "Shielded twisted-pair RS-485 cable", "Crimp ferrules suitable for the installed wire gauge"]
steps = ["Lock out line and control power, wait the drive's specified discharge time, verify the DC bus is de-energized, and remove the cover only as instructed by Yaskawa.", "Locate the control-circuit terminals by their D+, D-, and AC markings. Land the positive and negative data pair exactly as shown below; do not rely on an adapter's A/B letters alone.", "Route the communications cable separately from main-circuit and other high-power wiring. Connect and ground the shield as required for the installation; for long or multi-floor trunks Yaskawa recommends grounding the shield at only one device, preferably the PLC.", "Set DIP switch S2 ON only when this drive is the last physical slave on the RS-485 trunk; leave S2 OFF on every other drive.", "Restore control power with the motor area clear, configure the communication parameters, then verify identity and read-only monitors before enabling remote control."]
setup = ["Set H5-01 to a unique nonzero node address, H5-02 to the adapter baud rate, H5-03 to matching parity, and H5-12=0 for the FWD/Stop and REV/Stop command-bit meaning used by this profile.", "For remote frequency and run control, set b1-01=2 and b1-02=2. Power-cycle the drive after communication-setting changes, or set H5-20=1 to reload H5-01/H5-02/H5-03/H5-06 immediately."]
warnings = ["The same Yaskawa manual inconsistently identifies the D+/D-/AC terminal group as TB1-3 in Table 3.11 and TB4 in the network chapter. The conductor markings are consistent; use D+, D-, and AC rather than selecting a terminal by block number alone.", "RS-485 A/B naming is not consistent between manufacturers. Follow the + and - mapping below.", "AC is the documented shield ground/common 0 V for this interface, not protective earth and not a third data conductor.", "H5-04 defaults to Alarm Only, so a communications error can allow the drive to continue running. Select and validate a communications-loss response appropriate to the machine before remote operation."]
source = "Yaskawa SIEPC71061752C<2> GA500 Technical Reference, printed pp. 96-97 (D+/D-/AC terminals and TB1-3 placement), pp. 103 and 223-226 (two-wire RTU, S2 termination, TB4 wording, cabling and drive-control setup), pp. 700-704 (H5 settings)"

[[connection.methods.wiring]]
adapter = "Adapter D+ / +"
device = "D+"
signal = "RS-485 data positive"
required = true

[[connection.methods.wiring]]
adapter = "Adapter D- / -"
device = "D-"
signal = "RS-485 data negative"
required = true

[[connection.methods.wiring]]
adapter = "Cable shield/drain"
device = "AC"
signal = "Shield ground/common 0 V"
required = false

[[connection.methods]]
id = "si_em3_modbus_tcp"
title = "SI-EM3 Modbus TCP/IP option"
transport = "tcp"
hardware = "option"
port = "SI-EM3 communication connector CN1, RJ45 port 1 or port 2"
connector = "Dual RJ45 female Ethernet connectors"
adapter = "10/100BASE-T Ethernet interface or industrial Ethernet switch"
cable = "Shielded Cat5e Ethernet patch cable"
parts = ["Yaskawa SI-EM3 Modbus TCP/IP option, option firmware PRG 8103 or later", "Yaskawa JOHB-GA50 communication option mounting kit", "Shielded Cat5e Ethernet cable"]
steps = ["Confirm the drive nameplate software is PRG 1010 or later and the SI-EM3 option software is PRG 8103 or later.", "Lock out line and control power, wait the drive's specified discharge time, verify the DC bus is de-energized, and follow Yaskawa's ESD precautions.", "Install the separately sold JOHB-GA50 option mounting kit, install the SI-EM3 in the kit, and connect the option's included ground wire to the JOHB-GA50 as instructed by Yaskawa.", "Connect the shielded Cat5e cable to SI-EM3 CN1 port 1 or port 2 and to the control network.", "Restore control power with the motor area clear, configure a unique network address, and verify the MS/NS and Link/Act LEDs before read-only polling.", "Verify identity and monitor registers before setting b1-01/b1-02 for remote control."]
setup = ["Set F7-13=0 and F7-01 through F7-12 for a static IP address, subnet mask, and gateway, or select F7-13=1 for BOOTP or 2 for DHCP. Power-cycle after address changes, or set F6-15=1 to reload option parameters.", "For remote frequency and run control through the option, set b1-01=3 and b1-02=3. Review F6-01 and F7-16 so loss of the Ethernet control connection has the intended machine-safe result."]
warnings = ["The SI-EM3 is not a built-in GA500 port: both the SI-EM3 option and JOHB-GA50 mounting kit are required.", "Do not connect the SI-EM3 to the GA500 keypad RJ45 connection; use either RJ45 jack on SI-EM3 connector CN1.", "The option manual supports drive command, monitor, and parameter registers directly, but remote control must use b1-01=3 and b1-02=3 (Option PCB), not the built-in-serial value 2.", "F7-16 defaults to 0.0 seconds, which disables connection-timeout detection. Configure and validate the loss-of-communications behavior before operating a motor over Ethernet."]
source = "Yaskawa SIEPC71061752C<2> GA500 Technical Reference, printed pp. 223 and 368 (SI-EM3 support); Yaskawa TOEP C730600 91B SI-EM3 Installation Manual, printed pp. 8-13 (compatibility, JOHB-GA50 and CN1), pp. 42-52 (Cat5e, b1/F6/F7 settings and register access)"

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

[monitor]
drive_status = { address = 0x0020, bits = { 0 = "Running", 1 = "Reverse", 2 = "DriveReady", 3 = "Fault", 4 = "DataSettingError", 5 = "MFO_1", 6 = "MFO_2", 7 = "MFO_3" } }
fault_contents = { address = 0x0021 }
data_link_status = { address = 0x0022 }
frequency_reference = { address = 0x0023, scale = 0.01, unit = "Hz" }
output_frequency = { address = 0x0024, scale = 0.01, unit = "Hz" }
output_voltage_ref = { address = 0x0025, scale = 0.1, unit = "V" }
output_current = { address = 0x0026, scale = 0.1, unit = "A" }   # 0.1 A on GA500 (V1000 differs)
# 0x0027 output power scale is CAPACITY-DEPENDENT (0.01 kW over much of
# the GA500 range). Confirm against U1-08 on the actual drive.
output_power = { address = 0x0027, scale = 0.1, unit = "kW" }

[control]
command_register = 0x0001
speed_register = 0x0002
speed_scale = 0.01
speed_unit = "Hz"
max_ref = 400.0
step_delay = 0.05
stop = [0x0000]
run_fwd = [0x0001]
# 0x0003 asserts BOTH bit 0 and bit 1. At the default H5-12 = 0 that is
# FWD+REV simultaneously -> EF "FWD/REV Run Command Input Error" and a
# ramp stop, not reverse.
run_rev = [0x0002]
reset = [0x0008, 0x0000]

[running_check]
register = 0x0020
bit = 0

# 0x0021 is a bit-mapped summary, not an enum, so it is left undecoded here.
# The precise code is U2-01 (Current Fault); read it and match it against the
# fault list in the programming manual.
[faults]
register = 0x0021
history = [0x0081, 0x0082]   # U2-02/U2-03 previous faults (0x0080 is the ACTIVE fault)