ModBusClient
Retrieve real time information for
an Atmoce battery system
or other '60000' Modbus systems
(standalone Windows program, no installation required)
See Battery view tool from the SoC file
 Compact view |
 Configuration view |
The program retrieves data from the Gateway by reading
it's registers and creates a "Battery" file
of the most important values for monitoring
and automation by reading the file from any other process.
It can optionally write a file of all the values read from the Gateway
should other information be required
And optionally track changes to the Battery level over time.
At midnight it keeps a log of the current values in 2 files.
An on going log and a nightly log.
Supported systems
This ModBus client will generally work with any system that uses the 60000 register system.
It automatically retrieves all registers in the following ranges.
60000 - 60095
60166 - 60189
and can provide manually via the Controls button
60200 - 60203
60300 - 60317
The optional battery details file [off by default] contains the contents of each of the registers.
By reading this file, updated on each poll, any register can be monitored
This avoids needing a program tailored to a specific system
Once connected retrieve it's IP address, then choose a startup method for this program.
Mode 1
Start the program and complete the IP and first or both file parameters
Mode 2
Create a "ModbusClient.ini" file consisting of 1 to 4 lines:
IP address [required]
Battery file [required]
optional battery details file [off by default]
optional battery level log file [on by default]
Note:
If only 1 line is provided that will be taken as the IP address
if 2 lines are present, the 1st is the IP address and the 2nd the Battery file name
If the 3rd line has data the text will be taken as the file name
if the 4th line is absent the battery level log file remains active
if the 4th line is blank it is removed and turned off
if the 4th line is present the text will be taken as the new file name
Mode 3
Start the program, passing the IP address as a parameter, via a shortcut
This IP address will overwrite any specified in any ini file
Mode 4
With the program started, before connecting,
the IP address can be modified
Double click the form background to expand the mode to Configuration view
Modify any of the 3 file parameters.
Double click the form background again to make to show Compact view or
wait for the next minute cycle to do it automatically
NB. The battery file and optional battery details file can be modified frequently and it
can be a good idea to store them in a ram disk or SSD disk, to reduce wear on a hard disk.
Running
Once startup and parameters have been set,
Click on the "Connect" button to start the program running,
by default it will collect data once a minute.
The light bulb will turn green if the connection is established.
If not, check the IP address is correct and that ModBus is enabled on the gateway.
If you need to collect data faster check the Poll tick box.
By default the Rate is every 10 seconds
but it can be reduced to 1 second for absolute real time processing.
To change the rate click the Poll tick box to disable it, change the value and click the Poll tick box to enable the new rate.
At midnight it saves the 2 files, the on going log and the night log, used for calculating changes during the day and keeping History.
The "Stop/Start" button:
The program can be stopped and started any time by using the button.
It adapts to show the function that will be performed if clicked.
The "Controls" button:
Provides access to certain Atmoce specific registers that are updatable.
The program does not currently provide any update ability.
This may be added at a later date.
File Access
Double click the form background to expand the view to configuration mode
Double click any of the blue labels to view the current content of the file, if one is present.
The file will open in Notepad, positioned at the bottom.
Automation concept
Any other program can read the files created and automate processes or simply display information.
See Battery view tool from the SoC file
This ModBus client will generally work with any system that uses the 60000 register system.
It automatically retrieves all registers in the following ranges.
60000 - 60095
60166 - 60189
and can provide manually via the Controls button
60200 - 60203
60300 - 60317
The optional battery details file [off by default] contains the contents of each of the registers.
By reading this file, updated on each poll, any register can be monitored
This avoids needing a program tailored to a specific system
Configuration and Setup [Atmoce]
Make sure the [MG100] battery system has Modbus enabled.Once connected retrieve it's IP address, then choose a startup method for this program.
Mode 1
Start the program and complete the IP and first or both file parameters
Mode 2
Create a "ModbusClient.ini" file consisting of 1 to 4 lines:
IP address [required]
Battery file [required]
optional battery details file [off by default]
optional battery level log file [on by default]
Note:
If only 1 line is provided that will be taken as the IP address
if 2 lines are present, the 1st is the IP address and the 2nd the Battery file name
If the 3rd line has data the text will be taken as the file name
if the 4th line is absent the battery level log file remains active
if the 4th line is blank it is removed and turned off
if the 4th line is present the text will be taken as the new file name
Mode 3
Start the program, passing the IP address as a parameter, via a shortcut
This IP address will overwrite any specified in any ini file
Mode 4
With the program started, before connecting,
the IP address can be modified
Double click the form background to expand the mode to Configuration view
Modify any of the 3 file parameters.
Double click the form background again to make to show Compact view or
wait for the next minute cycle to do it automatically
NB. The battery file and optional battery details file can be modified frequently and it
can be a good idea to store them in a ram disk or SSD disk, to reduce wear on a hard disk.
Running
Once startup and parameters have been set,
Click on the "Connect" button to start the program running,
by default it will collect data once a minute.
The light bulb will turn green if the connection is established.
If not, check the IP address is correct and that ModBus is enabled on the gateway.
If you need to collect data faster check the Poll tick box.
By default the Rate is every 10 seconds
but it can be reduced to 1 second for absolute real time processing.
To change the rate click the Poll tick box to disable it, change the value and click the Poll tick box to enable the new rate.
At midnight it saves the 2 files, the on going log and the night log, used for calculating changes during the day and keeping History.
The "Stop/Start" button:
The program can be stopped and started any time by using the button.
It adapts to show the function that will be performed if clicked.
The "Controls" button:
Provides access to certain Atmoce specific registers that are updatable.
The program does not currently provide any update ability.
This may be added at a later date.
File Access
Double click the form background to expand the view to configuration mode
Double click any of the blue labels to view the current content of the file, if one is present.
The file will open in Notepad, positioned at the bottom.
Automation concept
Any other program can read the files created and automate processes or simply display information.
|
Sample Battery file BatterySize = 14 PVCharge = 1400 GridCharge = 0 PVChargeToday = 27 GridChargeToday = 0 PVChargeLife = 50 GridChargeLife = 150 PVDischarge = 0 GridDischarge = 0 PVDischargeToday = 0 GridDischargeToday = 0 PVDischargeLife = 50 GridDischargeLife = 2010 BatteryPercent = 46 CurrentLevelKWh = 6.44 Date = 2025-11-21 07:23:00 |
Sample Registers file 60069 0 60070 0 60071 0 60072 0 60073 0 60074 5020 60075 0 60076 402 |
Sample SoC file 2026-01-23 07:26:45 30 2026-01-23 11:46:14 31 2026-01-23 11:49:44 30 2026-01-24 10:34:44 29 2026-01-24 10:36:29 28 2026-01-24 10:37:53 27 2026-01-24 10:39:13 26 2026-01-24 10:41:37 25 2026-01-24 10:46:51 24 2026-01-24 10:49:23 23 2026-01-24 10:52:01 22 |
See Battery view tool from the SoC file
Releases for Windows
V1.1.12 - 2026-02-20
+ Added error log and recovery
V1.1.11 - 2026-02-06
+ Added optional register file and SOC file for monitoring and automation
V1.1.03 - 2026-01-14
+ Initial release
Latest Download version
After download, right click properties and unblock the file [and optionally scan it for good measure] before opening and running the program to avoid unwanted error messages.
+ Initial release
Latest Download version
After download, right click properties and unblock the file [and optionally scan it for good measure] before opening and running the program to avoid unwanted error messages.