Dongubak
79 lines
3.3 KiB
Python
79 lines
3.3 KiB
Python
#!/usr/bin/env python3
|
|
"""Set the RS485 node ID of a ZLAC8015D driver.
|
|
|
|
Only ONE driver should be connected to the RS485 bus while running this
|
|
script (both drivers ship with default ID 1, so with two on the bus their
|
|
replies would collide). Recommended workflow to end up with IDs 1 and 2:
|
|
|
|
1. Connect ONLY the first driver. Leave it at the default ID:
|
|
python3 zltech_set_id.py --port <PORT> --old-id 1 --new-id 1
|
|
(or just skip it, it is already 1)
|
|
2. Power off, disconnect it, connect ONLY the second driver.
|
|
3. Set its ID to 2:
|
|
python3 zltech_set_id.py --port <PORT> --old-id 1 --new-id 2
|
|
4. Power-cycle that driver.
|
|
5. Now connect both drivers to the same bus; they will answer as
|
|
ID 1 and ID 2 respectively.
|
|
|
|
Requires: pip install pymodbus pyserial
|
|
"""
|
|
import argparse
|
|
import sys
|
|
import time
|
|
|
|
from zltech_modbus import REG_NODE_ID, REG_SAVE_EEPROM, make_client, read_register, write_register
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
|
|
parser.add_argument("--port", required=True, help="Serial port, e.g. /dev/tty.usbserial-XXXX or COM5")
|
|
parser.add_argument("--baud", type=int, default=115200, help="Baud rate (default 115200, the driver default)")
|
|
parser.add_argument("--old-id", type=int, required=True, help="Current node ID of the driver (1-127)")
|
|
parser.add_argument("--new-id", type=int, required=True, help="New node ID to assign (1-127)")
|
|
parser.add_argument("--timeout", type=float, default=0.3, help="Response timeout in seconds")
|
|
args = parser.parse_args()
|
|
|
|
for name, value in (("--old-id", args.old_id), ("--new-id", args.new_id)):
|
|
if not (1 <= value <= 127):
|
|
parser.error(f"{name} must be in range 1-127")
|
|
|
|
client = make_client(args.port, args.baud, args.timeout)
|
|
if not client.connect():
|
|
print(f"ERROR: could not open serial port {args.port}")
|
|
sys.exit(1)
|
|
|
|
try:
|
|
print(f"Checking driver at ID {args.old_id} ...")
|
|
values = read_register(client, args.old_id, REG_NODE_ID, 1)
|
|
if values is None:
|
|
print(f"ERROR: no response from ID {args.old_id}. Check wiring/baud rate, "
|
|
f"and that exactly one driver is on the bus.")
|
|
sys.exit(1)
|
|
print(f" driver responded, current node-id register = {values[0]}")
|
|
|
|
print(f"Writing new node ID {args.new_id} ...")
|
|
if not write_register(client, args.old_id, REG_NODE_ID, args.new_id):
|
|
print("ERROR: write did not get a valid response.")
|
|
sys.exit(1)
|
|
|
|
# The ID change can take effect immediately, so try to save under
|
|
# the new ID first, and fall back to the old ID if that fails.
|
|
time.sleep(0.05)
|
|
saved = write_register(client, args.new_id, REG_SAVE_EEPROM, 1)
|
|
if not saved:
|
|
saved = write_register(client, args.old_id, REG_SAVE_EEPROM, 1)
|
|
if saved:
|
|
print("Saved to EEPROM.")
|
|
else:
|
|
print("WARNING: could not confirm the save-to-EEPROM write; "
|
|
"the ID change may be lost on power-cycle.")
|
|
|
|
print(f"Done. Power-cycle the driver, then verify with:\n"
|
|
f" python3 zltech_scan_ids.py --port {args.port} --range {args.new_id} {args.new_id}")
|
|
finally:
|
|
client.close()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|