Create TCPInterface class as base class for TCP based interfaces to devices

[BrianJKoopman]

Description

This PR introduces the TCPInterface class, extracted from the Cryomech agent's PTC class, mostly unmodified. I did rename a bit of the API to more closely match the socket API, which developers might already be familiar with.

While extracting this I wrote a docstring for the PTC class, which was missing that.

Motivation and Context

Good error handling for any interface is tricky. This class should allow all TCP based agents to use the same error handling logic. I plan to use this next on the Lakeshore 372 agent, so this is one step towards that, and ultimately a step towards #721.

How Has This Been Tested?

This has been tested within the Cryomech agent, testing unplugging the network connection between the agent and compressor. I also tested a power cycle, which triggers the reset path that 72f5a00 modifies. Here are the logs from testing. The first "Connection re-established" was after unplugging and replugging. The second is from the power cycle:

2024-10-04T18:08:10-0400 startup-op: launching init
2024-10-04T18:08:10-0400 start called for init
2024-10-04T18:08:10-0400 init:0 Status is now "starting".
2024-10-04T18:08:10-0400 init:0 Status is now "running".
2024-10-04T18:08:10-0400 PTC Model: 4_19
2024-10-04T18:08:10-0400 PTC Serial Number: 10444
2024-10-04T18:08:10-0400 Software Revision is: 2.155
2024-10-04T18:08:10-0400 start called for acq
2024-10-04T18:08:10-0400 acq:1 Status is now "starting".
2024-10-04T18:08:10-0400 Response from acq.start(): Started process "acq".
2024-10-04T18:08:10-0400 init:0 PTC agent initialized
2024-10-04T18:08:10-0400 init:0 Status is now "done".
2024-10-04T18:08:10-0400 acq:1 Status is now "running".
2024-10-04T18:08:25-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:08:36-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:08:43-0400 Connection re-established.
2024-10-04T18:09:02-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:13-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:24-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:35-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:46-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:50-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:51-0400 Connection error: [Errno 32] Broken pipe
2024-10-04T18:09:51-0400 Resetting the connection to the device.
2024-10-04T18:09:51-0400 Unable to connect. [Errno 111] Connection refused
2024-10-04T18:09:51-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:52-0400 Connection not established.
2024-10-04T18:09:52-0400 Resetting the connection to the device.
2024-10-04T18:09:52-0400 Unable to connect. [Errno 111] Connection refused
2024-10-04T18:09:52-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:53-0400 Connection not established.
2024-10-04T18:09:53-0400 Resetting the connection to the device.
2024-10-04T18:09:53-0400 Unable to connect. [Errno 111] Connection refused
2024-10-04T18:09:53-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:54-0400 Connection not established.
2024-10-04T18:09:54-0400 Resetting the connection to the device.
2024-10-04T18:09:54-0400 Unable to connect. [Errno 111] Connection refused
2024-10-04T18:09:54-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:55-0400 Connection not established.
2024-10-04T18:09:55-0400 Resetting the connection to the device.
2024-10-04T18:09:55-0400 Unable to connect. [Errno 111] Connection refused
2024-10-04T18:09:55-0400 Failed to get data from compressor. Check network connection.
2024-10-04T18:09:56-0400 Connection not established.
2024-10-04T18:09:56-0400 Resetting the connection to the device.
2024-10-04T18:09:56-0400 Connection re-established.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.

[BrianJKoopman]

I'm going to go ahead and merge this (after a rebase.) I thought I'd have a chance to test its use in the context of applying it to the 372 agent, but that's been slow, and I'd like to use it on another agent that I can more readily test.