Programm Modbus RTU Reader - readme
===================================

Programm Modbus RTU Reader - actual version 28
= = = = = = = = = = = = = = = = = = = = = = = =
Date of last finalising : 2023-08-26

Preface :
=========

I have created twoo programms for solar inverters and two black boxes,
at firts programm Modbus RTU reader for grid-tie inverter SUN1000G
and second  Modbus Ansi Reader-controler for inverter/charger PS3KVA
(from the PS1-5KVA series like predecestors of Axpert Max from Voltronic)

I have inform about actual version for Modbus30 Ansi on Github and on MyPower.

This readme is for Modbus RTU Reader - actual version is Modbus28 .

At 26.8. 2023 					Pavel Oupicky

Short description of programm Modbus28 RTU Reader :
= = = = = = = = = = = = = = = = = = = = = = = = = =

Actual version of programm : 28
Date of last updating  : 26. 8. 2023

Programm was created in Delphi XE Starter 
and it is working under operating system Windows W7 till W10 32 bit .

Programm was created by Pavel Oupicky, rentier and home worker.

Programm in full version is distributed as licensed for user.

Programm in shareware version is distributed as shareware.
  There is limited the number of recorded data for 50 ones
    and by my mistake there is limited number of outputs 
    in Display window to 4 ones

Demo version of programm is distributed as freeware.
    There is blocked the comunication between PC and device.
    This version is now not public distributed, only shareware one.

Author takes no liability towards of any use of his programm.

Contact  on author : pavel.oupicky@seznam.cz

Default known problems in this program Modbus28 :
= = = = = = = = = = = = = = = = = = = = = = = = =
- the program is the compilation of many of previous programs created by author,
- so some functions programs are or not ready or are out of functions
- Window OS can open many of windows, but when is program running, it os impossible use the mini- or maximalization of ones, 
  as the OS and Deplphi program cannot right open or closed them .. so if my program is running do not use 
  these button symbols for windows or program and data will be lost.

Basic description of program :
= = = = = = = = = = = = = = = = 

Program was created for devices with communication protocol Modbus RTU
 and for communication between personal computers
with connectors RS232 or USB converters to RS232 or RS485
 and devices like inverters SUN1000G or wattmeter SDM120M.

Description of basic buttons on home page in upper line:
= = = = = = = = = = = = = = = = = = = = = = = = = = = = =

About
- basic description of program

Memo
- memory for notes on PC

Help
- reads this similar file

Graphs
- first visualisation of parameters  for graphs

Menu
- when there are a data from measuremet, it is possible to see them 
  or get them into table or graph

Data
- reads recorded datas from pevious measurements

Hex counts
- some transfers between bits, bytes and hexbytes

End
- ends programm

Description ob basic buttons on home page in bottom line:
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = 

Parameters
- primary basic parameters for measurements, data, graph etc.

Drivers
- parameters for communication via com ports and MODBUS RTU commands

Measure
- start for measurement process

Inputs
- list of   commands for measurement and suiteable inputs

Rtu Test
- basic test of communication between PC and device in Modbus RTU


Parameters for tests and measurement :
= = = = = = = = = = = = = = = = = = = =

- basic and driver parameters must be set before then the programm is started

- basic parameters must be set in file with extension .par in Par folder
- driver parameters must be set in file with extension .rtu in Driver folder
- parameters for graphs are in the filr wizh extension .grp in  Grp folder
- help file for Modbus28 must have name Modbus28-help.txt and must be in the Help folder

Example of initialization file (.ini)
= = = = = = = = = = = = = = = = = = =

Modbus/28/Inicialisation
Inicial file for program Modbus28
06.07.2023/17:12:14
User: shareware
Path:Par
File:Modbus28-SUN1000G-rtu-9600-5+8+9+10.par
end

Example of basic parameters (.par file):
= = = = = = = = = = = = = = = = = = = = = 

Modbus/28/params
Test:Inverter SUN1000G
Description:Inverter Grid-Tie SUN1000G GWL
Date:2023-07-07*12:22
Device:SUN1000G,USB-RS232
Protocol:Rtu/Basic like Deye V117
Driver:Modbus28-SUN1000G-com-RS232-9600.rtu
Inputs:10/5,8,9,10,end
Measured interval:0
Outputs:4
Data:Data
Help:Help\Modbus28-help.txt
Graf-par:Grp\Grf-Modbus-SUN1000G.grp
end

Parameters for driver (.rtu file) example :
= = = = = = = = = = = = = = = = = = = = = = = = =

Modbus/28/params/Modbus28-SUN1000G-Com-RS232-9600.rtu
Parameters for Grid free inverter SUN1000G
06.07.2023*8:47:45
Protocol:Rtu
Description:Protocol for SUN1000G Modbus RTU like Deye V117
Device:SUN1000G,USB-RS232
Port:Com,3,9600,8,1,0
Timing:Timer=10,Sleep=10,Wait=200,Timeout=300
Device Address:01
Commands:10
1:0x03,0x00,0x00,0x00,0x01/3,1,999.0,1.0/nr,type of device BCD
2:0x03,0x00,0x01,0x00,0x01/3,1,999.0,1.0/nr,address of device BCD
3:0x03,0x00,0x02,0x00,0x01/3,1,999.0,1.0/nr,version of protocol BCD
4:0x03,0x00,0x03,0x00,0x05/2,0,Ansi,1.0/nr,SN Number in ASCII
5:0x03,0x00,0x2B,0x00,0x01/1,0,999.0,0.1/V?,DC Internal Volts ??
6:0x03,0x00,0x3F,0x00,0x01/1,0,999.0,1.0/nr,??
7:0x03,0x00,0x45,0x00,0x02/1,0,999.0,1.0/nr,??
8:0x03,0x00,0x46,0x00,0x01/1,0,999.0,0.1/V,Grid Volts
9:0x03,0x00,0x56,0x00,0x01/1,0,999.0,1.0/W,Average Power
10:0x03,0x00,0x6D,0x00,0x01/1,0,999.0,0.1/V,PV Voltage
end



