RemoteRF 2.0.4__tar.gz → 2.0.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: remoterf
-Version: 2.0.4
+Version: 2.0.7
 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
@@ -55,7 +55,7 @@ pip install remoterf        # Install remoteRF
 
 ## NI USRP-2901 / B200-family
 
-After reserving a server-local `usrp` inventory entry, fetch or refresh its
+After reserving a server-local or HostRF-owned `usrp` inventory entry, fetch or refresh its
 Dynamic v2 package with the reservation token:
 
 ```python

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

@@ -29,7 +29,7 @@ pip install remoterf        # Install remoteRF
 
 ## NI USRP-2901 / B200-family
 
-After reserving a server-local `usrp` inventory entry, fetch or refresh its
+After reserving a server-local or HostRF-owned `usrp` inventory entry, fetch or refresh its
 Dynamic v2 package with the reservation token:
 
 ```python

{remoterf-2.0.4 → remoterf-2.0.7}/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.7",
     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.7}/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.7}/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.7}/src/remoteRF/drivers/dynamic_v2.py

@@ -14,7 +14,16 @@ import numpy as np
 
 from ..core.dynamic_v2_transport import DynamicV2Transport
 from ..core.v2_errors import RemoteRFProtocolError
-from .support import uhd_v2
+from .support import uhd_dsp, uhd_v2
+
+_REMOTE_STREAM_BATCH_SAMPS = 64 * 1024
+_CPU_FORMAT_DTYPES = {
+    "fc32": np.dtype(np.complex64),
+    "fc64": np.dtype(np.complex128),
+    "f32": np.dtype(np.float32),
+    "f64": np.dtype(np.float64),
+    "s16": np.dtype(np.int16),
+}
 
 _SUPPORTED_SAMPLE_DTYPES = {
     np.dtype(np.complex64),
@@ -295,6 +304,7 @@ class RemoteHandleProxy:
         self._generation = int(generation)
         self._closed = False
         self._channels = []
+        self._cpu_format = "fc32"
         self._sequence = 1
         self._finalizer = weakref.finalize(
             self,
@@ -358,6 +368,20 @@ class RemoteHandleProxy:
 class RXStreamer(RemoteHandleProxy):
     _type_id = "uhd.usrp.RXStreamer"
 
+    def get_max_num_samps(self):
+        """Return the efficient RemoteRF batch size, bounded by wire limits."""
+        self._ensure_open()
+        maximum_bytes = int(
+            self._owner._capabilities.get("remote_resource_limits", {}).get(
+                "maximum_sample_payload_bytes",
+                4 * 1024 * 1024,
+            )
+        )
+        dtype = _CPU_FORMAT_DTYPES.get(self._cpu_format, np.dtype(np.complex64))
+        channels = max(1, len(self._channels))
+        payload_samps = maximum_bytes // (dtype.itemsize * channels)
+        return max(1, min(_REMOTE_STREAM_BATCH_SAMPS, payload_samps))
+
     def recv(self, buffs, *args, **kwargs):
         self._ensure_open()
         buffer = np.asarray(buffs)
@@ -436,6 +460,20 @@ class RXStreamer(RemoteHandleProxy):
 class TXStreamer(RemoteHandleProxy):
     _type_id = "uhd.usrp.TXStreamer"
 
+    def get_max_num_samps(self):
+        """Return the efficient RemoteRF batch size, bounded by wire limits."""
+        self._ensure_open()
+        maximum_bytes = int(
+            self._owner._capabilities.get("remote_resource_limits", {}).get(
+                "maximum_sample_payload_bytes",
+                4 * 1024 * 1024,
+            )
+        )
+        dtype = _CPU_FORMAT_DTYPES.get(self._cpu_format, np.dtype(np.complex64))
+        channels = max(1, len(self._channels))
+        payload_samps = maximum_bytes // (dtype.itemsize * channels)
+        return max(1, min(_REMOTE_STREAM_BATCH_SAMPS, payload_samps))
+
     def send(self, buffs, *args, **kwargs):
         self._ensure_open()
         samples = np.asarray(buffs)
@@ -684,6 +722,9 @@ def build_uhd_bindings(schema: dict, *, transport_factory=DynamicV2Transport):
                     stream_args = bound["__args__"][0]
                 if stream_args is not None:
                     proxy._channels = list(getattr(stream_args, "channels", ()) or ())
+                    proxy._cpu_format = str(
+                        getattr(stream_args, "cpu_format", "fc32") or "fc32"
+                    ).lower()
                 return proxy
             return uhd_v2.decode_snapshot(result)
 
@@ -770,6 +811,13 @@ def build_uhd_bindings(schema: dict, *, transport_factory=DynamicV2Transport):
         TXMetadataEventCode=uhd_v2.TXMetadataEventCode,
         SensorValue=uhd_v2.SensorValue,
     )
+    uhd.dsp = types.SimpleNamespace(
+        signals=types.SimpleNamespace(
+            get_continuous_tone=uhd_dsp.get_continuous_tone,
+            get_power_dbfs=uhd_dsp.get_power_dbfs,
+            get_usrp_power=uhd_dsp.make_get_usrp_power(uhd),
+        )
+    )
     uhd.filters = types.SimpleNamespace(
         FilterType=uhd_v2.FilterType,
         FilterInfoBase=uhd_v2.FilterInfoBase,

remoterf-2.0.7/src/remoteRF/drivers/support/uhd_dsp.py

@@ -0,0 +1,76 @@
+"""Client-local signal helpers compatible with :mod:`uhd.dsp.signals`."""
+from __future__ import annotations
+
+import math
+
+import numpy as np
+
+
+def get_continuous_tone(
+    rate,
+    freq,
+    ampl,
+    desired_size=None,
+    max_size=None,
+    waveform="sine",
+):
+    """Generate a repeatable complex waveform using UHD's public semantics."""
+    desired_size = desired_size or float(rate)
+    max_size = max_size or 100e6
+    assert rate > freq
+
+    common = math.gcd(int(rate), int(freq))
+    reduced_rate = int(rate) / common
+    reduced_freq = int(freq) / common
+    length = int(max(reduced_freq * reduced_rate, 1))
+    normalized_freq = freq / rate
+
+    if waveform in {"sine", "square"}:
+        phase = 2j * np.pi * normalized_freq * np.arange(length)
+        tone = np.exp(phase).astype(np.complex64, copy=False)
+        tone = np.sign(tone) * ampl if waveform == "square" else tone * ampl
+    elif waveform == "ramp":
+        indexes = np.arange(length)
+        tone = np.asarray(
+            2 * (indexes * normalized_freq - np.floor(0.5 + indexes * normalized_freq)),
+            dtype=np.complex64,
+        )
+    elif waveform == "const":
+        tone = np.ones(length, dtype=np.complex64) * ampl
+    else:
+        raise KeyError(f"Invalid waveform type: `{waveform}'")
+
+    if length < desired_size:
+        tone = np.tile(tone, int(desired_size // length))
+    if length > max_size:
+        raise ValueError("Cannot create a TX buffer! Rate/Freq ratio is too odd.")
+    return tone
+
+
+def get_power_dbfs(signal):
+    """Return variance power in dB relative to digital full scale."""
+    return 10 * np.log10(np.var(signal))
+
+
+def make_get_usrp_power(uhd_module):
+    """Bind the receive-power helper to a generated UHD compatibility module."""
+
+    def get_usrp_power(streamer, num_samps=1e6, chan=0):
+        sample_count = int(num_samps)
+        receive_buffer = np.zeros(
+            (streamer.get_num_channels(), sample_count),
+            dtype=np.complex64,
+        )
+        metadata = uhd_module.types.RXMetadata()
+        command = uhd_module.types.StreamCMD(uhd_module.types.StreamMode.num_done)
+        command.num_samps = sample_count
+        command.stream_now = True
+        streamer.issue_stream_cmd(command)
+        received = streamer.recv(receive_buffer, metadata, 5.0)
+        if received != sample_count:
+            raise RuntimeError(
+                "ERROR! get_usrp_power(): Did not receive the correct number of samples!"
+            )
+        return get_power_dbfs(receive_buffer[chan])
+
+    return get_usrp_power