RemoteRF 2.0.4__tar.gz → 2.0.8__tar.gz

{remoterf-2.0.4/src/remoteRF.egg-info → remoterf-2.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remoterf
-Version: 2.0.4
+Version: 2.0.8
 Summary: A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts.
 Author: Ethan Ge
 Author-email: ethoGalaxy@gmail.com
@@ -53,7 +53,13 @@ source venv/bin/activate    # Activate virtual environment
 pip install remoterf        # Install remoteRF
 ```
 
-## NI USRP-2901 / B200-family
+## NI USRP-2901, Ettus B205-mini, B200-family, and USRP N210
+
+The packaged client natively includes the shared USRP schema for the qualified
+NI USRP-2901, Ettus Research USRP B205-mini, the broader USB/B200 family, and
+the Ethernet-connected N210. No custom client driver is required. The B205-mini
+uses the same native-style API and reports its live 1 RX/1 TX channel topology
+through `remoterf_capabilities`.
 
 After reserving a server-local `usrp` inventory entry, fetch or refresh its
 Dynamic v2 package with the reservation token:
@@ -112,6 +118,75 @@ generic native dispatch, but are not release-qualified as exact UHD overload
 parity until the server's UHD 4.10 target-introspection and hardware
 differential gates pass.
 
+## RTL-SDR
+
+RTL-SDR clients are generated from the server's `rtl_sdr` schema. The machine
+running client code does not need `librtlsdr` or PyRtlSdr:
+
+```python
+from remoteRF.drivers import ensure_driver
+
+token = "reservation-token"
+ensure_driver(token=token)
+
+from remoteRF.drivers.rtl_sdr import RtlSdr
+
+sdr = RtlSdr(token)
+sdr.sample_rate = 2_048_000
+sdr.center_freq = 100_000_000
+sdr.gain = "auto"
+sdr.agc_mode = True
+
+samples = sdr.read_samples(16_384)  # NumPy complex64
+raw_iq = sdr.read_bytes(4096)       # packed uint8 I/Q bytes
+```
+
+The server owns the USB handle for its lifetime, so the generated client does
+not close the physical radio. `read_samples` and `read_bytes` are bounded to a
+4 MiB response. Call them repeatedly for longer captures. Native asynchronous
+callbacks are not transported remotely.
+
+When a Tailscale address differs from the IP or DNS identity in the server
+certificate, keep TLS verification enabled and set the expected identity:
+
+```bash
+export REMOTERF_ADDR=rrf2.example.ts.net:61005
+export REMOTERF_TLS_SERVER_NAME=certificate-name.example
+```
+
+## TI mmWave radar
+
+TI radar clients are generated from the server's `ti_mmwave` schema. Only the
+machine physically connected to the radar needs `pyserial` or a CP210x driver.
+The initial parser profile supports xWR68xx mmWave SDK 3 out-of-box TLV output.
+
+```python
+from remoteRF.drivers import ensure_driver
+
+token = "reservation-token"
+ensure_driver(token=token)
+
+from remoteRF.drivers.ti_mmwave import TiMmWave, decode_frame
+
+radar = TiMmWave(token)
+print(radar.device_info)
+print(radar.query_version())
+
+radar.apply_config(open("profile.cfg").read(), start=True)
+try:
+    packet = radar.read_frame(timeout=1.0)
+    frame = decode_frame(packet)
+    print(frame.header.frame_number, frame.points, frame.side_info)
+finally:
+    radar.stop()
+```
+
+`read_frame()` returns one complete binary UART packet. Decoding is client-local
+and retains unknown TLVs as raw bytes, allowing custom firmware to be captured
+before a dedicated parser profile is added. `stream_stats` reports dropped
+frames, queued frames, resynchronization bytes, invalid headers, and reader
+health. Remote firmware flashing is deliberately unsupported.
+
 If `pip install` doesn't work, you can clone the [source](https://github.com/WirelessLabAtUCLA/RemoteRF-Client) directly from github.
 
 <!-- 1. **Clone the repository:**

{remoterf-2.0.4 → remoterf-2.0.8}/README.md

@@ -27,7 +27,13 @@ source venv/bin/activate    # Activate virtual environment
 pip install remoterf        # Install remoteRF
 ```
 
-## NI USRP-2901 / B200-family
+## NI USRP-2901, Ettus B205-mini, B200-family, and USRP N210
+
+The packaged client natively includes the shared USRP schema for the qualified
+NI USRP-2901, Ettus Research USRP B205-mini, the broader USB/B200 family, and
+the Ethernet-connected N210. No custom client driver is required. The B205-mini
+uses the same native-style API and reports its live 1 RX/1 TX channel topology
+through `remoterf_capabilities`.
 
 After reserving a server-local `usrp` inventory entry, fetch or refresh its
 Dynamic v2 package with the reservation token:
@@ -86,6 +92,75 @@ generic native dispatch, but are not release-qualified as exact UHD overload
 parity until the server's UHD 4.10 target-introspection and hardware
 differential gates pass.
 
+## RTL-SDR
+
+RTL-SDR clients are generated from the server's `rtl_sdr` schema. The machine
+running client code does not need `librtlsdr` or PyRtlSdr:
+
+```python
+from remoteRF.drivers import ensure_driver
+
+token = "reservation-token"
+ensure_driver(token=token)
+
+from remoteRF.drivers.rtl_sdr import RtlSdr
+
+sdr = RtlSdr(token)
+sdr.sample_rate = 2_048_000
+sdr.center_freq = 100_000_000
+sdr.gain = "auto"
+sdr.agc_mode = True
+
+samples = sdr.read_samples(16_384)  # NumPy complex64
+raw_iq = sdr.read_bytes(4096)       # packed uint8 I/Q bytes
+```
+
+The server owns the USB handle for its lifetime, so the generated client does
+not close the physical radio. `read_samples` and `read_bytes` are bounded to a
+4 MiB response. Call them repeatedly for longer captures. Native asynchronous
+callbacks are not transported remotely.
+
+When a Tailscale address differs from the IP or DNS identity in the server
+certificate, keep TLS verification enabled and set the expected identity:
+
+```bash
+export REMOTERF_ADDR=rrf2.example.ts.net:61005
+export REMOTERF_TLS_SERVER_NAME=certificate-name.example
+```
+
+## TI mmWave radar
+
+TI radar clients are generated from the server's `ti_mmwave` schema. Only the
+machine physically connected to the radar needs `pyserial` or a CP210x driver.
+The initial parser profile supports xWR68xx mmWave SDK 3 out-of-box TLV output.
+
+```python
+from remoteRF.drivers import ensure_driver
+
+token = "reservation-token"
+ensure_driver(token=token)
+
+from remoteRF.drivers.ti_mmwave import TiMmWave, decode_frame
+
+radar = TiMmWave(token)
+print(radar.device_info)
+print(radar.query_version())
+
+radar.apply_config(open("profile.cfg").read(), start=True)
+try:
+    packet = radar.read_frame(timeout=1.0)
+    frame = decode_frame(packet)
+    print(frame.header.frame_number, frame.points, frame.side_info)
+finally:
+    radar.stop()
+```
+
+`read_frame()` returns one complete binary UART packet. Decoding is client-local
+and retains unknown TLVs as raw bytes, allowing custom firmware to be captured
+before a dedicated parser profile is added. `stream_stats` reports dropped
+frames, queued frames, resynchronization bytes, invalid headers, and reader
+health. Remote firmware flashing is deliberately unsupported.
+
 If `pip install` doesn't work, you can clone the [source](https://github.com/WirelessLabAtUCLA/RemoteRF-Client) directly from github.
 
 <!-- 1. **Clone the repository:**

{remoterf-2.0.4 → remoterf-2.0.8}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="remoterf",
-    version="2.0.4",
+    version="2.0.8",
     author="Ethan Ge",
     author_email="ethoGalaxy@gmail.com",
     description="A python API to remotely access signal centric hardware. Client-side only! Courtesy of Wireless Lab @ UCLA & Prof. Ian Roberts.",

{remoterf-2.0.4 → remoterf-2.0.8}/src/remoteRF/common/grpc/grpc_pb2.py

@@ -24,7 +24,7 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\ngrpc.proto\x12\tremote_rf\"\xa2\x01\n\x11GenericRPCRequest\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x34\n\x04\x61rgs\x18\x02 \x03(\x0b\x32&.remote_rf.GenericRPCRequest.ArgsEntry\x1a@\n\tArgsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x96\x01\n\x12GenericRPCResponse\x12;\n\x07results\x18\x01 \x03(\x0b\x32*.remote_rf.GenericRPCResponse.ResultsEntry\x1a\x43\n\x0cResultsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x19\n\nArrayShape\x12\x0b\n\x03\x64im\x18\x01 \x03(\x05\"+\n\rComplexNumber\x12\x0c\n\x04real\x18\x01 \x01(\x02\x12\x0c\n\x04imag\x18\x02 \x01(\x02\"a\n\x11\x43omplexNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12&\n\x04\x64\x61ta\x18\x02 \x03(\x0b\x32\x18.remote_rf.ComplexNumber\"D\n\x0eRealNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12\x0c\n\x04\x64\x61ta\x18\x02 \x03(\x02\"\xed\x01\n\x08\x41rgument\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x03 \x01(\x02H\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\rcomplex_array\x18\x05 \x01(\x0b\x32\x1c.remote_rf.ComplexNumpyArrayH\x00\x12/\n\nreal_array\x18\x06 \x01(\x0b\x32\x19.remote_rf.RealNumpyArrayH\x00\x12\x14\n\njson_value\x18\x07 \x01(\tH\x00\x42\x07\n\x05value\":\n\x0cNDArrayValue\x12\r\n\x05\x64type\x18\x01 \x01(\t\x12\r\n\x05shape\x18\x02 \x03(\x03\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\"\xe9\x01\n\x0c\x44ynamicValue\x12\x14\n\nnull_value\x18\x01 \x01(\x08H\x00\x12\x14\n\nbool_value\x18\x02 \x01(\x08H\x00\x12\x15\n\x0bint64_value\x18\x03 \x01(\x12H\x00\x12\x16\n\x0c\x64ouble_value\x18\x04 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x05 \x01(\tH\x00\x12\x15\n\x0b\x62ytes_value\x18\x06 \x01(\x0cH\x00\x12\x14\n\njson_value\x18\x07 \x01(\tH\x00\x12\x30\n\rndarray_value\x18\x08 \x01(\x0b\x32\x17.remote_rf.NDArrayValueH\x00\x42\x07\n\x05value\"B\n\nNamedValue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.remote_rf.DynamicValue\"B\n\x08Mutation\x12\x0e\n\x06target\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.remote_rf.DynamicValue\"\xb0\x01\n\rErrorEnvelope\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x14\n\x0c\x64\x65tails_json\x18\x03 \x01(\t\x12\x0e\n\x06method\x18\x04 \x01(\t\x12\x18\n\x10native_exception\x18\x05 \x01(\t\x12\x13\n\x0buhd_version\x18\x06 \x01(\t\x12\x11\n\tretryable\x18\x07 \x01(\x08\x12\x18\n\x10\x66\x61tal_to_session\x18\x08 \x01(\x08\"s\n\x10NegotiateRequest\x12\x17\n\x0fschema_versions\x18\x01 \x03(\t\x12!\n\x19\x63ontrol_protocol_versions\x18\x02 \x03(\t\x12#\n\x1bstreaming_protocol_versions\x18\x03 \x03(\t\"\x9a\x01\n\x11NegotiateResponse\x12\x16\n\x0eschema_version\x18\x01 \x01(\t\x12 \n\x18\x63ontrol_protocol_version\x18\x02 \x01(\t\x12\"\n\x1astreaming_protocol_version\x18\x03 \x01(\t\x12\'\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\":\n\x10GetSchemaRequest\x12\r\n\x05token\x18\x01 \x01(\t\x12\x17\n\x0fschema_versions\x18\x02 \x03(\t\"~\n\x11GetSchemaResponse\x12\x16\n\x0eschema_version\x18\x01 \x01(\t\x12\x13\n\x0bschema_json\x18\x02 \x01(\t\x12\x13\n\x0bschema_hash\x18\x03 \x01(\t\x12\'\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"\x88\x01\n\x12OpenSessionRequest\x12\r\n\x05token\x18\x01 \x01(\t\x12\x1d\n\x15requested_schema_hash\x18\x02 \x01(\t\x12 \n\x18\x63ontrol_protocol_version\x18\x03 \x01(\t\x12\"\n\x1astreaming_protocol_version\x18\x04 \x01(\t\"\xee\x01\n\x13OpenSessionResponse\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x15\n\rdevice_handle\x18\x02 \x01(\t\x12\x13\n\x0bschema_json\x18\x03 \x01(\t\x12\x13\n\x0bschema_hash\x18\x04 \x01(\t\x12\x19\n\x11\x63\x61pabilities_json\x18\x05 \x01(\t\x12\x13\n\x0buhd_version\x18\x06 \x01(\t\x12\x0f\n\x07uhd_abi\x18\x07 \x01(\t\x12\x18\n\x10hardware_profile\x18\x08 \x01(\t\x12\'\n\x05\x65rror\x18\t \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"}\n\rInvokeRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\x12\x0e\n\x06method\x18\x03 \x01(\t\x12\x13\n\x0boverload_id\x18\x04 \x01(\t\x12#\n\x04\x61rgs\x18\x05 \x03(\x0b\x32\x15.remote_rf.NamedValue\"\x8a\x01\n\x0eInvokeResponse\x12\'\n\x06result\x18\x01 \x01(\x0b\x32\x17.remote_rf.DynamicValue\x12&\n\tmutations\x18\x02 \x03(\x0b\x32\x13.remote_rf.Mutation\x12\'\n\x05\x65rror\x18\x03 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"8\n\x12\x43loseHandleRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\")\n\x13\x43loseSessionRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\"H\n\rCloseResponse\x12\x0e\n\x06\x63losed\x18\x01 \x01(\x08\x12\'\n\x05\x65rror\x18\x02 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"\xea\x03\n\x0bSampleFrame\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\x12\x12\n\ngeneration\x18\x03 \x01(\x04\x12\x14\n\x0coperation_id\x18\x04 \x01(\t\x12\x10\n\x08sequence\x18\x05 \x01(\x04\x12-\n\tdirection\x18\x06 \x01(\x0e\x32\x1a.remote_rf.SampleDirection\x12(\n\x04kind\x18\x07 \x01(\x0e\x32\x1a.remote_rf.SampleFrameKind\x12\r\n\x05\x64type\x18\x08 \x01(\t\x12\r\n\x05shape\x18\t \x03(\x03\x12\x10\n\x08\x63hannels\x18\n \x03(\r\x12\x14\n\x0csample_count\x18\x0b \x01(\x04\x12\x0f\n\x07payload\x18\x0c \x01(\x0c\x12\x15\n\rmetadata_json\x18\r \x01(\t\x12\x18\n\x10\x64\x65vice_time_secs\x18\x0e \x01(\x01\x12\x0f\n\x07\x63redits\x18\x0f \x01(\r\x12\x13\n\x0btimeout_sec\x18\x10 \x01(\x01\x12\x12\n\none_packet\x18\x11 \x01(\x08\x12\x15\n\rend_of_stream\x18\x12 \x01(\x08\x12\x11\n\tcancelled\x18\x13 \x01(\x08\x12\'\n\x05\x65rror\x18\x14 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\x12\r\n\x05\x66lags\x18\x15 \x01(\x04*e\n\x0fSampleDirection\x12 \n\x1cSAMPLE_DIRECTION_UNSPECIFIED\x10\x00\x12\x17\n\x13SAMPLE_DIRECTION_RX\x10\x01\x12\x17\n\x13SAMPLE_DIRECTION_TX\x10\x02*\xf2\x01\n\x0fSampleFrameKind\x12\x1c\n\x18SAMPLE_FRAME_UNSPECIFIED\x10\x00\x12\x15\n\x11SAMPLE_FRAME_OPEN\x10\x01\x12\x18\n\x14SAMPLE_FRAME_REQUEST\x10\x02\x12\x15\n\x11SAMPLE_FRAME_DATA\x10\x03\x12\x17\n\x13SAMPLE_FRAME_RESULT\x10\x04\x12\x17\n\x13SAMPLE_FRAME_CREDIT\x10\x05\x12\x17\n\x13SAMPLE_FRAME_CANCEL\x10\x06\x12\x16\n\x12SAMPLE_FRAME_CLOSE\x10\x07\x12\x16\n\x12SAMPLE_FRAME_ERROR\x10\x08\x32Q\n\nGenericRPC\x12\x43\n\x04\x43\x61ll\x12\x1c.remote_rf.GenericRPCRequest\x1a\x1d.remote_rf.GenericRPCResponse2\xc1\x03\n\x10\x44ynamicControlV2\x12\x46\n\tNegotiate\x12\x1b.remote_rf.NegotiateRequest\x1a\x1c.remote_rf.NegotiateResponse\x12\x46\n\tGetSchema\x12\x1b.remote_rf.GetSchemaRequest\x1a\x1c.remote_rf.GetSchemaResponse\x12L\n\x0bOpenSession\x12\x1d.remote_rf.OpenSessionRequest\x1a\x1e.remote_rf.OpenSessionResponse\x12=\n\x06Invoke\x12\x18.remote_rf.InvokeRequest\x1a\x19.remote_rf.InvokeResponse\x12\x46\n\x0b\x43loseHandle\x12\x1d.remote_rf.CloseHandleRequest\x1a\x18.remote_rf.CloseResponse\x12H\n\x0c\x43loseSession\x12\x1e.remote_rf.CloseSessionRequest\x1a\x18.remote_rf.CloseResponse2R\n\x0cSampleDataV1\x12\x42\n\x0cSampleStream\x12\x16.remote_rf.SampleFrame\x1a\x16.remote_rf.SampleFrame(\x01\x30\x01\x42\x1e\n\x10\x63om.example.demoB\nDemoProtosb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\ngrpc.proto\x12\tremote_rf\"\xa2\x01\n\x11GenericRPCRequest\x12\x15\n\rfunction_name\x18\x01 \x01(\t\x12\x34\n\x04\x61rgs\x18\x02 \x03(\x0b\x32&.remote_rf.GenericRPCRequest.ArgsEntry\x1a@\n\tArgsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x96\x01\n\x12GenericRPCResponse\x12;\n\x07results\x18\x01 \x03(\x0b\x32*.remote_rf.GenericRPCResponse.ResultsEntry\x1a\x43\n\x0cResultsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\"\n\x05value\x18\x02 \x01(\x0b\x32\x13.remote_rf.Argument:\x02\x38\x01\"\x19\n\nArrayShape\x12\x0b\n\x03\x64im\x18\x01 \x03(\x05\"+\n\rComplexNumber\x12\x0c\n\x04real\x18\x01 \x01(\x02\x12\x0c\n\x04imag\x18\x02 \x01(\x02\"a\n\x11\x43omplexNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12&\n\x04\x64\x61ta\x18\x02 \x03(\x0b\x32\x18.remote_rf.ComplexNumber\"D\n\x0eRealNumpyArray\x12$\n\x05shape\x18\x01 \x01(\x0b\x32\x15.remote_rf.ArrayShape\x12\x0c\n\x04\x64\x61ta\x18\x02 \x03(\x02\"\xb6\x02\n\x08\x41rgument\x12\x16\n\x0cstring_value\x18\x01 \x01(\tH\x00\x12\x15\n\x0bint64_value\x18\x02 \x01(\x03H\x00\x12\x15\n\x0b\x66loat_value\x18\x03 \x01(\x02H\x00\x12\x14\n\nbool_value\x18\x04 \x01(\x08H\x00\x12\x35\n\rcomplex_array\x18\x05 \x01(\x0b\x32\x1c.remote_rf.ComplexNumpyArrayH\x00\x12/\n\nreal_array\x18\x06 \x01(\x0b\x32\x19.remote_rf.RealNumpyArrayH\x00\x12\x14\n\njson_value\x18\x07 \x01(\tH\x00\x12\x15\n\x0b\x62ytes_value\x18\x08 \x01(\x0cH\x00\x12\x30\n\rndarray_value\x18\t \x01(\x0b\x32\x17.remote_rf.NDArrayValueH\x00\x42\x07\n\x05value\":\n\x0cNDArrayValue\x12\r\n\x05\x64type\x18\x01 \x01(\t\x12\r\n\x05shape\x18\x02 \x03(\x03\x12\x0c\n\x04\x64\x61ta\x18\x03 \x01(\x0c\"\xe9\x01\n\x0c\x44ynamicValue\x12\x14\n\nnull_value\x18\x01 \x01(\x08H\x00\x12\x14\n\nbool_value\x18\x02 \x01(\x08H\x00\x12\x15\n\x0bint64_value\x18\x03 \x01(\x12H\x00\x12\x16\n\x0c\x64ouble_value\x18\x04 \x01(\x01H\x00\x12\x16\n\x0cstring_value\x18\x05 \x01(\tH\x00\x12\x15\n\x0b\x62ytes_value\x18\x06 \x01(\x0cH\x00\x12\x14\n\njson_value\x18\x07 \x01(\tH\x00\x12\x30\n\rndarray_value\x18\x08 \x01(\x0b\x32\x17.remote_rf.NDArrayValueH\x00\x42\x07\n\x05value\"B\n\nNamedValue\x12\x0c\n\x04name\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.remote_rf.DynamicValue\"B\n\x08Mutation\x12\x0e\n\x06target\x18\x01 \x01(\t\x12&\n\x05value\x18\x02 \x01(\x0b\x32\x17.remote_rf.DynamicValue\"\xb0\x01\n\rErrorEnvelope\x12\x0c\n\x04\x63ode\x18\x01 \x01(\t\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x14\n\x0c\x64\x65tails_json\x18\x03 \x01(\t\x12\x0e\n\x06method\x18\x04 \x01(\t\x12\x18\n\x10native_exception\x18\x05 \x01(\t\x12\x13\n\x0buhd_version\x18\x06 \x01(\t\x12\x11\n\tretryable\x18\x07 \x01(\x08\x12\x18\n\x10\x66\x61tal_to_session\x18\x08 \x01(\x08\"s\n\x10NegotiateRequest\x12\x17\n\x0fschema_versions\x18\x01 \x03(\t\x12!\n\x19\x63ontrol_protocol_versions\x18\x02 \x03(\t\x12#\n\x1bstreaming_protocol_versions\x18\x03 \x03(\t\"\x9a\x01\n\x11NegotiateResponse\x12\x16\n\x0eschema_version\x18\x01 \x01(\t\x12 \n\x18\x63ontrol_protocol_version\x18\x02 \x01(\t\x12\"\n\x1astreaming_protocol_version\x18\x03 \x01(\t\x12\'\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\":\n\x10GetSchemaRequest\x12\r\n\x05token\x18\x01 \x01(\t\x12\x17\n\x0fschema_versions\x18\x02 \x03(\t\"~\n\x11GetSchemaResponse\x12\x16\n\x0eschema_version\x18\x01 \x01(\t\x12\x13\n\x0bschema_json\x18\x02 \x01(\t\x12\x13\n\x0bschema_hash\x18\x03 \x01(\t\x12\'\n\x05\x65rror\x18\x04 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"\x88\x01\n\x12OpenSessionRequest\x12\r\n\x05token\x18\x01 \x01(\t\x12\x1d\n\x15requested_schema_hash\x18\x02 \x01(\t\x12 \n\x18\x63ontrol_protocol_version\x18\x03 \x01(\t\x12\"\n\x1astreaming_protocol_version\x18\x04 \x01(\t\"\xee\x01\n\x13OpenSessionResponse\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x15\n\rdevice_handle\x18\x02 \x01(\t\x12\x13\n\x0bschema_json\x18\x03 \x01(\t\x12\x13\n\x0bschema_hash\x18\x04 \x01(\t\x12\x19\n\x11\x63\x61pabilities_json\x18\x05 \x01(\t\x12\x13\n\x0buhd_version\x18\x06 \x01(\t\x12\x0f\n\x07uhd_abi\x18\x07 \x01(\t\x12\x18\n\x10hardware_profile\x18\x08 \x01(\t\x12\'\n\x05\x65rror\x18\t \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"}\n\rInvokeRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\x12\x0e\n\x06method\x18\x03 \x01(\t\x12\x13\n\x0boverload_id\x18\x04 \x01(\t\x12#\n\x04\x61rgs\x18\x05 \x03(\x0b\x32\x15.remote_rf.NamedValue\"\x8a\x01\n\x0eInvokeResponse\x12\'\n\x06result\x18\x01 \x01(\x0b\x32\x17.remote_rf.DynamicValue\x12&\n\tmutations\x18\x02 \x03(\x0b\x32\x13.remote_rf.Mutation\x12\'\n\x05\x65rror\x18\x03 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"8\n\x12\x43loseHandleRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\")\n\x13\x43loseSessionRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\"H\n\rCloseResponse\x12\x0e\n\x06\x63losed\x18\x01 \x01(\x08\x12\'\n\x05\x65rror\x18\x02 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\"\xea\x03\n\x0bSampleFrame\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0e\n\x06handle\x18\x02 \x01(\t\x12\x12\n\ngeneration\x18\x03 \x01(\x04\x12\x14\n\x0coperation_id\x18\x04 \x01(\t\x12\x10\n\x08sequence\x18\x05 \x01(\x04\x12-\n\tdirection\x18\x06 \x01(\x0e\x32\x1a.remote_rf.SampleDirection\x12(\n\x04kind\x18\x07 \x01(\x0e\x32\x1a.remote_rf.SampleFrameKind\x12\r\n\x05\x64type\x18\x08 \x01(\t\x12\r\n\x05shape\x18\t \x03(\x03\x12\x10\n\x08\x63hannels\x18\n \x03(\r\x12\x14\n\x0csample_count\x18\x0b \x01(\x04\x12\x0f\n\x07payload\x18\x0c \x01(\x0c\x12\x15\n\rmetadata_json\x18\r \x01(\t\x12\x18\n\x10\x64\x65vice_time_secs\x18\x0e \x01(\x01\x12\x0f\n\x07\x63redits\x18\x0f \x01(\r\x12\x13\n\x0btimeout_sec\x18\x10 \x01(\x01\x12\x12\n\none_packet\x18\x11 \x01(\x08\x12\x15\n\rend_of_stream\x18\x12 \x01(\x08\x12\x11\n\tcancelled\x18\x13 \x01(\x08\x12\'\n\x05\x65rror\x18\x14 \x01(\x0b\x32\x18.remote_rf.ErrorEnvelope\x12\r\n\x05\x66lags\x18\x15 \x01(\x04*e\n\x0fSampleDirection\x12 \n\x1cSAMPLE_DIRECTION_UNSPECIFIED\x10\x00\x12\x17\n\x13SAMPLE_DIRECTION_RX\x10\x01\x12\x17\n\x13SAMPLE_DIRECTION_TX\x10\x02*\xf2\x01\n\x0fSampleFrameKind\x12\x1c\n\x18SAMPLE_FRAME_UNSPECIFIED\x10\x00\x12\x15\n\x11SAMPLE_FRAME_OPEN\x10\x01\x12\x18\n\x14SAMPLE_FRAME_REQUEST\x10\x02\x12\x15\n\x11SAMPLE_FRAME_DATA\x10\x03\x12\x17\n\x13SAMPLE_FRAME_RESULT\x10\x04\x12\x17\n\x13SAMPLE_FRAME_CREDIT\x10\x05\x12\x17\n\x13SAMPLE_FRAME_CANCEL\x10\x06\x12\x16\n\x12SAMPLE_FRAME_CLOSE\x10\x07\x12\x16\n\x12SAMPLE_FRAME_ERROR\x10\x08\x32Q\n\nGenericRPC\x12\x43\n\x04\x43\x61ll\x12\x1c.remote_rf.GenericRPCRequest\x1a\x1d.remote_rf.GenericRPCResponse2\xc1\x03\n\x10\x44ynamicControlV2\x12\x46\n\tNegotiate\x12\x1b.remote_rf.NegotiateRequest\x1a\x1c.remote_rf.NegotiateResponse\x12\x46\n\tGetSchema\x12\x1b.remote_rf.GetSchemaRequest\x1a\x1c.remote_rf.GetSchemaResponse\x12L\n\x0bOpenSession\x12\x1d.remote_rf.OpenSessionRequest\x1a\x1e.remote_rf.OpenSessionResponse\x12=\n\x06Invoke\x12\x18.remote_rf.InvokeRequest\x1a\x19.remote_rf.InvokeResponse\x12\x46\n\x0b\x43loseHandle\x12\x1d.remote_rf.CloseHandleRequest\x1a\x18.remote_rf.CloseResponse\x12H\n\x0c\x43loseSession\x12\x1e.remote_rf.CloseSessionRequest\x1a\x18.remote_rf.CloseResponse2R\n\x0cSampleDataV1\x12\x42\n\x0cSampleStream\x12\x16.remote_rf.SampleFrame\x1a\x16.remote_rf.SampleFrame(\x01\x30\x01\x42\x1e\n\x10\x63om.example.demoB\nDemoProtosb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -36,10 +36,10 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_GENERICRPCREQUEST_ARGSENTRY']._serialized_options = b'8\001'
   _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._loaded_options = None
   _globals['_GENERICRPCRESPONSE_RESULTSENTRY']._serialized_options = b'8\001'
-  _globals['_SAMPLEDIRECTION']._serialized_start=3213
-  _globals['_SAMPLEDIRECTION']._serialized_end=3314
-  _globals['_SAMPLEFRAMEKIND']._serialized_start=3317
-  _globals['_SAMPLEFRAMEKIND']._serialized_end=3559
+  _globals['_SAMPLEDIRECTION']._serialized_start=3286
+  _globals['_SAMPLEDIRECTION']._serialized_end=3387
+  _globals['_SAMPLEFRAMEKIND']._serialized_start=3390
+  _globals['_SAMPLEFRAMEKIND']._serialized_end=3632
   _globals['_GENERICRPCREQUEST']._serialized_start=26
   _globals['_GENERICRPCREQUEST']._serialized_end=188
   _globals['_GENERICRPCREQUEST_ARGSENTRY']._serialized_start=124
@@ -57,45 +57,45 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_REALNUMPYARRAY']._serialized_start=514
   _globals['_REALNUMPYARRAY']._serialized_end=582
   _globals['_ARGUMENT']._serialized_start=585
-  _globals['_ARGUMENT']._serialized_end=822
-  _globals['_NDARRAYVALUE']._serialized_start=824
-  _globals['_NDARRAYVALUE']._serialized_end=882
-  _globals['_DYNAMICVALUE']._serialized_start=885
-  _globals['_DYNAMICVALUE']._serialized_end=1118
-  _globals['_NAMEDVALUE']._serialized_start=1120
-  _globals['_NAMEDVALUE']._serialized_end=1186
-  _globals['_MUTATION']._serialized_start=1188
-  _globals['_MUTATION']._serialized_end=1254
-  _globals['_ERRORENVELOPE']._serialized_start=1257
-  _globals['_ERRORENVELOPE']._serialized_end=1433
-  _globals['_NEGOTIATEREQUEST']._serialized_start=1435
-  _globals['_NEGOTIATEREQUEST']._serialized_end=1550
-  _globals['_NEGOTIATERESPONSE']._serialized_start=1553
-  _globals['_NEGOTIATERESPONSE']._serialized_end=1707
-  _globals['_GETSCHEMAREQUEST']._serialized_start=1709
-  _globals['_GETSCHEMAREQUEST']._serialized_end=1767
-  _globals['_GETSCHEMARESPONSE']._serialized_start=1769
-  _globals['_GETSCHEMARESPONSE']._serialized_end=1895
-  _globals['_OPENSESSIONREQUEST']._serialized_start=1898
-  _globals['_OPENSESSIONREQUEST']._serialized_end=2034
-  _globals['_OPENSESSIONRESPONSE']._serialized_start=2037
-  _globals['_OPENSESSIONRESPONSE']._serialized_end=2275
-  _globals['_INVOKEREQUEST']._serialized_start=2277
-  _globals['_INVOKEREQUEST']._serialized_end=2402
-  _globals['_INVOKERESPONSE']._serialized_start=2405
-  _globals['_INVOKERESPONSE']._serialized_end=2543
-  _globals['_CLOSEHANDLEREQUEST']._serialized_start=2545
-  _globals['_CLOSEHANDLEREQUEST']._serialized_end=2601
-  _globals['_CLOSESESSIONREQUEST']._serialized_start=2603
-  _globals['_CLOSESESSIONREQUEST']._serialized_end=2644
-  _globals['_CLOSERESPONSE']._serialized_start=2646
-  _globals['_CLOSERESPONSE']._serialized_end=2718
-  _globals['_SAMPLEFRAME']._serialized_start=2721
-  _globals['_SAMPLEFRAME']._serialized_end=3211
-  _globals['_GENERICRPC']._serialized_start=3561
-  _globals['_GENERICRPC']._serialized_end=3642
-  _globals['_DYNAMICCONTROLV2']._serialized_start=3645
-  _globals['_DYNAMICCONTROLV2']._serialized_end=4094
-  _globals['_SAMPLEDATAV1']._serialized_start=4096
-  _globals['_SAMPLEDATAV1']._serialized_end=4178
+  _globals['_ARGUMENT']._serialized_end=895
+  _globals['_NDARRAYVALUE']._serialized_start=897
+  _globals['_NDARRAYVALUE']._serialized_end=955
+  _globals['_DYNAMICVALUE']._serialized_start=958
+  _globals['_DYNAMICVALUE']._serialized_end=1191
+  _globals['_NAMEDVALUE']._serialized_start=1193
+  _globals['_NAMEDVALUE']._serialized_end=1259
+  _globals['_MUTATION']._serialized_start=1261
+  _globals['_MUTATION']._serialized_end=1327
+  _globals['_ERRORENVELOPE']._serialized_start=1330
+  _globals['_ERRORENVELOPE']._serialized_end=1506
+  _globals['_NEGOTIATEREQUEST']._serialized_start=1508
+  _globals['_NEGOTIATEREQUEST']._serialized_end=1623
+  _globals['_NEGOTIATERESPONSE']._serialized_start=1626
+  _globals['_NEGOTIATERESPONSE']._serialized_end=1780
+  _globals['_GETSCHEMAREQUEST']._serialized_start=1782
+  _globals['_GETSCHEMAREQUEST']._serialized_end=1840
+  _globals['_GETSCHEMARESPONSE']._serialized_start=1842
+  _globals['_GETSCHEMARESPONSE']._serialized_end=1968
+  _globals['_OPENSESSIONREQUEST']._serialized_start=1971
+  _globals['_OPENSESSIONREQUEST']._serialized_end=2107
+  _globals['_OPENSESSIONRESPONSE']._serialized_start=2110
+  _globals['_OPENSESSIONRESPONSE']._serialized_end=2348
+  _globals['_INVOKEREQUEST']._serialized_start=2350
+  _globals['_INVOKEREQUEST']._serialized_end=2475
+  _globals['_INVOKERESPONSE']._serialized_start=2478
+  _globals['_INVOKERESPONSE']._serialized_end=2616
+  _globals['_CLOSEHANDLEREQUEST']._serialized_start=2618
+  _globals['_CLOSEHANDLEREQUEST']._serialized_end=2674
+  _globals['_CLOSESESSIONREQUEST']._serialized_start=2676
+  _globals['_CLOSESESSIONREQUEST']._serialized_end=2717
+  _globals['_CLOSERESPONSE']._serialized_start=2719
+  _globals['_CLOSERESPONSE']._serialized_end=2791
+  _globals['_SAMPLEFRAME']._serialized_start=2794
+  _globals['_SAMPLEFRAME']._serialized_end=3284
+  _globals['_GENERICRPC']._serialized_start=3634
+  _globals['_GENERICRPC']._serialized_end=3715
+  _globals['_DYNAMICCONTROLV2']._serialized_start=3718
+  _globals['_DYNAMICCONTROLV2']._serialized_end=4167
+  _globals['_SAMPLEDATAV1']._serialized_start=4169
+  _globals['_SAMPLEDATAV1']._serialized_end=4251
 # @@protoc_insertion_point(module_scope)

{remoterf-2.0.4 → remoterf-2.0.8}/src/remoteRF/common/utils/process_arg.py

@@ -1,10 +1,55 @@
-from ..grpc import grpc_pb2, grpc_pb2_grpc
+"""Serialization helpers for the legacy GenericRPC protocol."""
+from __future__ import annotations
+
 import json
+import math
+from typing import Any
+
 import numpy as np
 
+from ..grpc import grpc_pb2
+
 _JSON_TYPE_KEY = "__remoterf_json_type__"
+_MAX_NDARRAY_BYTES = 64 * 1024 * 1024
+_MAX_NDARRAY_DIMENSIONS = 8
+_SUPPORTED_NDARRAY_KINDS = {"b", "i", "u", "f", "c"}
+
+
+def _validate_ndarray(dtype: np.dtype, shape) -> int:
+    """Return the expected payload length for a safe numeric ndarray."""
+    if dtype.hasobject or dtype.kind not in _SUPPORTED_NDARRAY_KINDS:
+        raise ValueError(f"unsupported ndarray dtype: {dtype}")
+
+    normalized_shape = tuple(int(item) for item in shape)
+    if (
+        len(normalized_shape) > _MAX_NDARRAY_DIMENSIONS
+        or any(item < 0 for item in normalized_shape)
+    ):
+        raise ValueError("invalid ndarray shape")
+
+    expected = math.prod(normalized_shape) * dtype.itemsize
+    if expected > _MAX_NDARRAY_BYTES:
+        raise ValueError(f"ndarray exceeds {_MAX_NDARRAY_BYTES} bytes")
+    return expected
 
-def _json_safe(value):
+
+def _decode_ndarray(descriptor: grpc_pb2.NDArrayValue) -> np.ndarray:
+    try:
+        dtype = np.dtype(descriptor.dtype)
+    except (TypeError, ValueError) as exc:
+        raise ValueError(f"invalid ndarray dtype: {descriptor.dtype!r}") from exc
+
+    shape = tuple(int(item) for item in descriptor.shape)
+    expected = _validate_ndarray(dtype, shape)
+    actual = len(descriptor.data)
+    if actual != expected:
+        raise ValueError(
+            f"ndarray byte length mismatch: expected {expected}, got {actual}"
+        )
+    return np.frombuffer(descriptor.data, dtype=dtype).reshape(shape).copy()
+
+
+def _json_safe(value: Any):
     if hasattr(value, "as_payload"):
         return _json_safe(value.as_payload())
     if isinstance(value, np.ndarray):
@@ -27,21 +72,26 @@ def _json_safe(value):
             "complex": False,
             "data": array.tolist(),
         }
-    if isinstance(value, (np.bool_,)):
+    if isinstance(value, np.bool_):
         return bool(value)
-    if isinstance(value, (np.integer,)):
+    if isinstance(value, np.integer):
         return int(value)
-    if isinstance(value, (np.floating,)):
+    if isinstance(value, np.floating):
         return float(value)
     if isinstance(value, complex):
-        return {_JSON_TYPE_KEY: "complex", "real": float(value.real), "imag": float(value.imag)}
+        return {
+            _JSON_TYPE_KEY: "complex",
+            "real": float(value.real),
+            "imag": float(value.imag),
+        }
     if isinstance(value, dict):
         return {str(key): _json_safe(item) for key, item in value.items()}
     if isinstance(value, (list, tuple)):
         return [_json_safe(item) for item in value]
     return value
 
-def _json_restore(value):
+
+def _json_restore(value: Any):
     if isinstance(value, dict):
         kind = value.get(_JSON_TYPE_KEY)
         if kind == "ndarray":
@@ -58,30 +108,36 @@ def _json_restore(value):
         return [_json_restore(item) for item in value]
     return value
 
-def unmap_arg(arg):
-    if arg.HasField('int64_value'):
+
+def unmap_arg(arg: grpc_pb2.Argument):
+    kind = arg.WhichOneof("value")
+    if kind == "int64_value":
         return arg.int64_value
-    elif arg.HasField('float_value'):
+    if kind == "float_value":
         return arg.float_value
-    elif arg.HasField('string_value'):
+    if kind == "string_value":
         return arg.string_value
-    elif arg.HasField('bool_value'):
+    if kind == "bool_value":
         return arg.bool_value
-    elif arg.HasField('real_array'):
+    if kind == "ndarray_value":
+        return _decode_ndarray(arg.ndarray_value)
+    if kind == "real_array":
         shape = tuple(arg.real_array.shape.dim)
         return np.array(arg.real_array.data, dtype=np.float64).reshape(shape)
-    elif arg.HasField('complex_array'):
+    if kind == "complex_array":
         shape = tuple(arg.complex_array.shape.dim)
-        data = [complex(c.real, c.imag) for c in arg.complex_array.data]
+        data = [complex(item.real, item.imag) for item in arg.complex_array.data]
         return np.array(data, dtype=np.complex64).reshape(shape)
-    elif arg.HasField('json_value'):
+    if kind == "json_value":
         return _json_restore(json.loads(arg.json_value))
-    else:
-        raise ValueError(f"Unknown argument type during unmapping: {arg}")
-    
-def map_arg(value):
+    if kind == "bytes_value":
+        return bytes(arg.bytes_value)
+    raise ValueError(f"Unknown argument type during unmapping: {arg}")
+
+
+def map_arg(value: Any) -> grpc_pb2.Argument:
     arg = grpc_pb2.Argument()
-    
+
     if isinstance(value, (bool, np.bool_)):
         arg.bool_value = bool(value)
     elif hasattr(value, "as_payload"):
@@ -94,6 +150,8 @@ def map_arg(value):
         arg.float_value = float(value)
     elif isinstance(value, str):
         arg.string_value = value
+    elif isinstance(value, (bytes, bytearray, memoryview)):
+        arg.bytes_value = bytes(value)
     elif isinstance(value, (list, tuple)):
         try:
             array = np.asarray(value)
@@ -110,51 +168,33 @@ def map_arg(value):
     elif isinstance(value, np.ndarray):
         if value.dtype == object:
             raise ValueError(f"Cannot map object-dtype array: {value!r}")
-        if value.dtype.kind not in {"b", "i", "u", "f", "c"}:
-            arg.json_value = json.dumps(_json_safe(value.tolist()), separators=(",", ":"))
+        if value.dtype.kind not in _SUPPORTED_NDARRAY_KINDS:
+            arg.json_value = json.dumps(
+                _json_safe(value.tolist()), separators=(",", ":")
+            )
             return arg
-        if np.iscomplexobj(value):
-            complex_array = arg.complex_array
-            complex_array.shape.dim.extend(value.shape)
-            for num in value.ravel():
-                complex_num = complex_array.data.add()
-                complex_num.real = float(num.real)
-                complex_num.imag = float(num.imag)
-        else:
-            float_array = arg.real_array
-            float_array.shape.dim.extend(value.shape)
-            float_array.data.extend(np.asarray(value, dtype=np.float32).ravel())
+
+        array = np.asarray(value)
+        _validate_ndarray(array.dtype, array.shape)
+        if not array.flags.c_contiguous:
+            array = np.ascontiguousarray(array)
+        descriptor = arg.ndarray_value
+        descriptor.dtype = array.dtype.str
+        descriptor.shape.extend(array.shape)
+        descriptor.data = array.tobytes(order="C")
     else:
         raise ValueError(f"Unknown argument type during mapping: {value}")
     return arg
-        
-def map_array_proto(np_array):
-    arg = grpc_pb2.Argument()
-    
-    # Check if the array is complex
-    if np.iscomplexobj(np_array):
-        complex_array = grpc_pb2.ComplexArray()
-        for num in np_array.flat:
-            complex_number = complex_array.data.add()
-            complex_number.real = num.real
-            complex_number.imag = num.imag
-        arg.complex_array.CopyFrom(complex_array)
-    else:
-        # Handle as a regular float array
-        float_array = grpc_pb2.FloatArray()
-        float_array.data.extend(np_array.flat)
-        arg.float_array.CopyFrom(float_array)
 
-    return arg
 
-def unmap_array_proto(arg):
-    # Check which type of array is available and convert appropriately
-    if arg.HasField('complex_array'):
-        # Convert ComplexArray to a numpy array of complex numbers
-        data = [complex(cn.real, cn.imag) for cn in arg.complex_array.data]
-        return np.array(data, dtype=np.complex64)
-    elif arg.HasField('float_array'):
-        # Convert FloatArray to a numpy array of floats
-        return np.array(arg.float_array.data, dtype=np.float32)
-    else:
+def map_array_proto(np_array) -> grpc_pb2.Argument:
+    """Backward-compatible wrapper around :func:`map_arg`."""
+    return map_arg(np.asarray(np_array))
+
+
+def unmap_array_proto(arg: grpc_pb2.Argument) -> np.ndarray:
+    """Backward-compatible array-only wrapper around :func:`unmap_arg`."""
+    value = unmap_arg(arg)
+    if not isinstance(value, np.ndarray):
         raise ValueError("Argument does not contain a recognizable array.")
+    return value

{remoterf-2.0.4 → remoterf-2.0.8}/src/remoteRF/core/grpc_client.py

@@ -49,6 +49,18 @@ options = [
       ('grpc.max_receive_message_length', 100 * 1024 * 1024),
 ]
 
+# A server reached over Tailscale may present the same certificate it uses on
+# its public or LAN address. Keep certificate verification enabled while
+# allowing the configured certificate identity to differ from REMOTERF_ADDR.
+tls_server_name = (os.getenv("REMOTERF_TLS_SERVER_NAME") or "").strip()
+if tls_server_name:
+    options.extend(
+        [
+            ("grpc.ssl_target_name_override", tls_server_name),
+            ("grpc.default_authority", tls_server_name),
+        ]
+    )
+
 # Server.crt
 certs_path = Path(ca_path).expanduser().resolve()
 with certs_path.open('rb') as f: