Skip to content

feat: add remote modbus rtu driver support, refactor ModbusRTUDriver to use SerialPort directly#1394

Open
flxzt wants to merge 1 commit into
labgrid-project:masterfrom
flxzt:remote-modbus-rtu
Open

feat: add remote modbus rtu driver support, refactor ModbusRTUDriver to use SerialPort directly#1394
flxzt wants to merge 1 commit into
labgrid-project:masterfrom
flxzt:remote-modbus-rtu

Conversation

@flxzt
Copy link
Copy Markdown
Contributor

@flxzt flxzt commented May 6, 2024

Description

This PR adds support for using Modbus RTU serial ports remotely. It does that by removing the ModbusRTU resource, and let the driver use SerialPort and NetworkSerialPort resources directly.

In order to archieve this, I moved the fields timeout and address into the driver.

My reasoning is that it makes more sense to let the resource manage the entire bus, and let the driver only control one slave (= address). Same for the timeout, this can be slave-specific.

It seems to be working fine remotely with a Waveshare RTU relay, so far I only tested it with a low baudrate 9600 so I don't know how well the remote serial connection behaves with higher rates.

as mentioned in #1370 I am unsure if it is "okay" to replace the ModbusRTU resource, because this is obviously a breaking change.
Adding a exported NetworkModbusRTU resource would be the alternative, but it would mean a lot of repetition with NetworkSerialPort. But I might have missed intentional architectural decisions here, so I can implement whatever makes the most sense!

Once this is resolved/merged, I'll follow up with an added WaveshareRTURelay driver

Checklist

  • Documentation for the feature
  • Tests for the feature
  • The arguments and description in doc/configuration.rst have been updated
  • PR has been tested

Comment thread labgrid/resource/modbusrtu.py
@flxzt flxzt force-pushed the remote-modbus-rtu branch 6 times, most recently from 3df93ca to 7c00b6c Compare June 18, 2024 07:51
Copy link
Copy Markdown
Member

@jluebbe jluebbe left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking at the minimalmodbus documentation, it seems to support communicating with multiple instruments on the same bus by sharing a pyserial object, but with the ModbusRTUDriver we can bind only one device to the serial port resource.

Wouldn't it make more sense to have drivers for each instrument bind to the SerialDriver and pass the SerialDriver.serial attribute to the minimalmodbus Instrument constructor?

To allow multiple client drivers binding to a SerialDriver instance, you'd need to override the resolve_conflicts method from the ConsoleExpectMixin and allow multiple active clients only if they are all instrument drivers (and then call super()).

Going this route would also avoid the backwards compat problem, as the new driver would be a ModbusRTUInstrumentDriver.

self.instrument = self._modbus.Instrument(
serial_if,
slaveaddress=self.address,
close_port_after_each_call=True,
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do you use close_port_after_each_call=True?

@jluebbe
Copy link
Copy Markdown
Member

jluebbe commented Jul 17, 2024

@b2vn As you contributed the original Modbus RTU support in #806, do you have an opinion regarding this refactoring and my suggested approach in #1394 (review)?

@flxzt flxzt force-pushed the remote-modbus-rtu branch from aa82ee7 to be1a228 Compare August 19, 2024 08:29
@flxzt
Copy link
Copy Markdown
Contributor Author

flxzt commented May 29, 2026

what's the resolution, I haven't heard from the original author that introduced local Modbus RTU support. @jluebbe

refactor ModbusRTUDriver to use SerialPort resource directly

Signed-off-by: Felix Zwettler <felix.zwettler@duagon.com>
@flxzt flxzt force-pushed the remote-modbus-rtu branch from be1a228 to d7e83df Compare June 1, 2026 14:07
@codecov
Copy link
Copy Markdown

codecov Bot commented Jun 1, 2026

Codecov Report

❌ Patch coverage is 48.00000% with 26 lines in your changes missing coverage. Please review.
✅ Project coverage is 45.9%. Comparing base (5818762) to head (d7e83df).
⚠️ Report is 2 commits behind head on master.
✅ All tests successful. No failed tests found.

Files with missing lines Patch % Lines
labgrid/driver/modbusrtudriver.py 46.6% 24 Missing ⚠️
labgrid/resource/modbusrtu.py 60.0% 2 Missing ⚠️
Additional details and impacted files
@@           Coverage Diff            @@
##           master   #1394     +/-   ##
========================================
- Coverage    46.0%   45.9%   -0.1%     
========================================
  Files         180     180             
  Lines       14462   14490     +28     
========================================
+ Hits         6654    6662      +8     
- Misses       7808    7828     +20     
Flag Coverage Δ
3.10 45.9% <48.0%> (-0.1%) ⬇️
3.11 45.9% <48.0%> (-0.1%) ⬇️
3.12 45.9% <48.0%> (-0.1%) ⬇️
3.13 45.9% <48.0%> (-0.1%) ⬇️
3.14 45.9% <48.0%> (-0.1%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants