"""" ModBus control routines Copyright (C) 2023-2025 M.T. Konstapel This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . """ import minimalmodbus import serial class ModBusController(minimalmodbus.Instrument): """Instrument class for Epever Charge Controllers. Args: * portname (str): port name * slaveaddress (int): slave address in the range 1 to 247 """ def __init__(self, portname, slaveaddress): minimalmodbus.Instrument.__init__(self, portname, slaveaddress) self.serial.baudrate = 9600 self.serial.bytesize = 8 self.serial.parity = serial.PARITY_NONE self.serial.stopbits = 1 self.serial.timeout = 0.3 self.mode = minimalmodbus.MODE_RTU self.clear_buffers_before_each_transaction = True self.close_port_after_each_call = False self.watchdog_toggle_bit = 1 # Read the device ID def get_id(self): device_id = [None]*4 device_id[0] = self.read_register(1000, 0, 4, False) device_id[1] = self.read_register(1001, 0, 4, False) device_id[2] = self.read_register(1002, 0, 4, False) device_id[3] = self.read_register(1003, 0, 4, False) return device_id # Read the device type def get_type(self): device_type = self.read_register(1004, 0, 4, False) return device_type # Get the 40 character long description string from ModBus device def get_type_string(self): register_offset = 1006 # ModBus register for text string starts at 1006 device_type_register = [None]*20 # ModBus register for text string is 20 integers long device_type_string = "" # Store the decoded string here for index, entry in enumerate(device_type_register): # Read Type string registers device_type_register[index] = self.read_register(index + register_offset, 0, 4, False) # Convert to ASCII string device_type_string += chr((device_type_register[index] & 0xFF00) >> 8) device_type_string += chr(device_type_register[index] & 0xFF) return device_type_string.strip() # Ask the device how many input registers it has def get_number_of_input_registers(self): device_number_of_input_registers = self.read_register(1026, 0, 4, False) return device_number_of_input_registers # Read all the input registers def read_all_input_registers(self): number_of_input_registers = self.get_number_of_input_registers() input_register = [None]*number_of_input_registers for index in range(number_of_input_registers): input_register[index] = self.read_register(index, 0, 4, False) return input_register def set_watchdog(self): self.write_bit(0, 1, 5) def reset_watchdog(self): self.write_bit(0, 0, 5) # Toggle the devices watchdog def toggle_watchdog(self): if self.watchdog_toggle_bit: self.set_watchdog() self.watchdog_toggle_bit = 0 else: self.reset_watchdog() self.watchdog_toggle_bit = 1