Add read_stb method for TCPIP HiSLIP client.

CHANGES

@@ -1,6 +1,11 @@
 PyVISA-py Changelog
 ===================
 
+0.7.3 (unreleased)
+------------------
+
+- add read_stb method for TCPIP HiSLIP client PR #429
+
 0.7.2 (07/03/2024)
 ------------------
 

pyvisa_py/tcpip.py

@@ -13,7 +13,7 @@
 import socket
 import time
 import warnings
-from typing import Any, Dict, List, Optional, Tuple, Type
+from typing import Any, Dict, List, Optional, Tuple, Type, cast
 
 from pyvisa import attributes, constants, errors, rname
 from pyvisa.constants import BufferOperation, ResourceAttribute, StatusCode
@@ -297,6 +297,27 @@ def clear(self) -> StatusCode:
 
         return StatusCode.success
 
+    def read_stb(self) -> Tuple[int, StatusCode]:
+        """Reads a status byte of the service request.
+
+        Corresponds to viReadSTB function of the VISA library.
+
+        Returns
+        -------
+        int
+            Service request status byte
+        StatusCode
+            Return value of the library call.
+
+        """
+
+        interface = cast(hislip.Instrument, self.interface)
+        # According to IVI-6.1 Rev.2 status query corresponds to viReadSTB.
+        stb = interface.async_status_query()
+        errorcode = StatusCode.success
+
+        return stb, errorcode
+
     def _get_attribute(self, attribute: ResourceAttribute) -> Tuple[Any, StatusCode]:
         """Get the value for a given VISA attribute for this session.