remoterf 0.0.7.41__py3-none-any.whl

remoteRF/drivers/adalm_pluto/pluto_remote.py

@@ -0,0 +1,249 @@
+from ...core.grpc_client import rpc_client
+from ...common.utils import *
+from ...common.grpc import grpc_pb2
+from ...core.grpc_client import get_tcp_calls
+
+def try_get(function_name, token):
+    try:
+        return unmap_arg(rpc_client(function_name=f"Pluto:{function_name}:GET", args={'a':map_arg(token)}).results[function_name])
+    except Exception as e:
+        input(f"Error: {e}\nHit enter to continue...")
+    return None
+
+def try_set(function_name, value, token):
+    try:
+        rpc_client(function_name=f"Pluto:{function_name}:SET", args={function_name: map_arg(value), 'a':map_arg(token)})
+    except Exception as e:
+        input(f"Error: {e}\nHit enter to continue...")
+        
+def try_call_0_arg(function_name, token):   # 0 argument call
+    try:
+        response = rpc_client(
+            function_name=f"Pluto:{function_name}:CALL0", 
+            args={
+                'a': map_arg(token)
+            }
+        )
+        return unmap_arg(response.results[function_name])
+    except Exception as e:
+        input(f"RPC_0_call Error: {e}\nHit enter to continue...")
+    return None
+        
+def try_call_1_arg(function_name, arg, token):  # 1 argument call
+    try:
+        response = rpc_client(
+            function_name=f"Pluto:{function_name}:CALL1", 
+            args={
+                'a': map_arg(token),
+                'arg1': map_arg(arg)
+            }
+        )
+        # The server should return something like {function_name: <something>}
+        return unmap_arg(response.results[function_name])
+    except Exception as e:
+        input(f"RPC_1_call Error: {e}\nHit enter to continue...")
+    return None
+
+class rx_def:
+    pass
+
+class tx_def:
+    pass
+
+class rx_tx_def(rx_def, tx_def):
+    pass
+
+class ad9364(rx_tx_def):
+    pass
+
+class Pluto: # client
+    
+    def __init__(self, token:str, debug=False):
+        self.token = token
+        response = try_call_0_arg(function_name="ip", token=token)
+        
+        
+    def api_token(self, token:str) -> None:
+        self.token = token
+        try_call_0_arg(function_name="ip", token=token)
+    
+    # PlutoSDR
+    
+    _device_name = "PlutoSDR"
+    _uri_auto = "ip:pluto.local"
+
+    def __repr__(self): # ! UNTESTED !
+        return try_get("__repr__", self.token)
+    
+    #region ad9364
+    """AD9364 Transceiver"""
+
+    @property
+    def filter(self):
+        return try_get("filter", self.token)
+
+    @filter.setter
+    def filter(self, value):
+        try_set("filter", value, self.token)
+
+    @property
+    def loopback(self):
+        """loopback: Set loopback mode. Options are:
+        0 (Disable), 1 (Digital), 2 (RF)"""
+        return try_get("loopback", self.token)
+
+    @loopback.setter
+    def loopback(self, value):
+        try_set("loopback", value, self.token)
+
+    @property
+    def gain_control_mode_chan0(self):
+        """gain_control_mode_chan0: Mode of receive path AGC. Options are:
+        slow_attack, fast_attack, manual"""
+        return try_get("gain_control_mode_chan0", self.token)
+
+    @gain_control_mode_chan0.setter
+    def gain_control_mode_chan0(self, value):
+        try_set("gain_control_mode_chan0", value, self.token)
+
+    @property
+    def rx_hardwaregain_chan0(self):
+        """rx_hardwaregain_chan0: Gain applied to RX path. Only applicable when
+        gain_control_mode is set to 'manual'"""
+        return try_get("rx_hardwaregain_chan0", self.token)
+
+    @rx_hardwaregain_chan0.setter
+    def rx_hardwaregain_chan0(self, value):
+        try_set("rx_hardwaregain_chan0", value, self.token)
+
+    @property
+    def tx_hardwaregain_chan0(self):
+        """tx_hardwaregain_chan0: Attenuation applied to TX path"""
+        return try_get("tx_hardwaregain_chan0", self.token)
+
+    @tx_hardwaregain_chan0.setter
+    def tx_hardwaregain_chan0(self, value):
+        try_set("tx_hardwaregain_chan0", value, self.token)
+
+    @property
+    def rx_rf_bandwidth(self):
+        """rx_rf_bandwidth: Bandwidth of front-end analog filter of RX path"""
+        return try_get("rx_rf_bandwidth", self.token)
+
+    @rx_rf_bandwidth.setter
+    def rx_rf_bandwidth(self, value):
+        try_set("rx_rf_bandwidth", value, self.token)
+
+    @property
+    def tx_rf_bandwidth(self):
+        """tx_rf_bandwidth: Bandwidth of front-end analog filter of TX path"""
+        return try_get("tx_rf_bandwidth", self.token)
+
+    @tx_rf_bandwidth.setter
+    def tx_rf_bandwidth(self, value):
+        try_set("tx_rf_bandwidth", value, self.token)
+
+    @property
+    def sample_rate(self):                # ! UNTESTED !
+        """sample_rate: Sample rate RX and TX paths in samples per second"""
+        return try_get("sample_rate", self.token)
+
+    @sample_rate.setter
+    def sample_rate(self, rate):          # ! UNTESTED !
+        try_set("sample_rate", rate, self.token)
+
+    @property
+    def rx_lo(self):
+        """rx_lo: Carrier frequency of RX path"""
+        return try_get("rx_lo", self.token)
+
+    @rx_lo.setter
+    def rx_lo(self, value):
+        try_set("rx_lo", value, self.token)
+
+    @property
+    def tx_lo(self):
+        """tx_lo: Carrier frequency of TX path"""
+        return try_get("tx_lo", self.token)
+
+    @tx_lo.setter
+    def tx_lo(self, value):
+        try_set("tx_lo", value, self.token)
+        
+    @property
+    def tx_cyclic_buffer(self):
+        """tx_cyclic_buffer: Size of cyclic buffer"""
+        return try_get("tx_cyclic_buffer", self.token)
+    
+    @tx_cyclic_buffer.setter
+    def tx_cyclic_buffer(self, value):
+        try_set("tx_cyclic_buffer", value, self.token)
+        
+    def tx_destroy_buffer(self):
+        try_call_0_arg("tx_destroy_buffer", self.token)
+
+    def rx_destroy_buffer(self):
+        try_call_0_arg("rx_destroy_buffer", self.token)
+
+    #endregion
+    
+    #region rx_def
+    
+    def rx(self):
+        return try_get("rx", self.token)
+    
+    @property
+    def rx_buffer_size(self):
+        return try_get("rx_buffer_size", self.token)
+    
+    @rx_buffer_size.setter
+    def rx_buffer_size(self, value):
+        try_set("rx_buffer_size", value, self.token)
+    
+    #endregion
+    
+    #region tx_def
+    
+    def tx(self, value):
+        return try_call_1_arg("tx", value, self.token)
+    
+    # @tx.setter
+    # def tx(self, value):
+    #     try_set("tx", value, self.token)
+    
+    #endregion
+    
+    #region tx
+    
+    #endregion
+    
+    #region _dec_int_fpga_filter
+    
+    """Decimator and interpolator fpga filter controls"""
+
+    def _get_rates(self, dev, output):           # ! UNTESTED !
+        """Get the decimation and interpolation rates"""
+        return try_get("rates", self.token)
+
+    @property
+    def rx_dec8_filter_en(self) -> bool:         # ! UNTESTED !
+        """rx_dec8_filter_en: Enable decimate by 8 filter in FPGA"""
+        return try_get("rx_dec8_filter_en", self.token)
+
+    @rx_dec8_filter_en.setter
+    def rx_dec8_filter_en(self, value: bool):    # ! UNTESTED !
+        """rx_dec8_filter_en: Enable decimate by 8 filter in FPGA"""
+        return try_set("rx_dec8_filter_en", value, self.token)
+
+    @property
+    def tx_int8_filter_en(self) -> bool:         # ! UNTESTED !
+        """tx_int8_filter_en: Enable interpolate by 8 filter in FPGA"""
+        return try_get("tx_int8_filter_en", self.token)
+
+    @tx_int8_filter_en.setter
+    def tx_int8_filter_en(self, value: bool):    # ! UNTESTED !
+        """tx_int8_filter_en: Enable interpolate by 8 filter in FPGA"""
+        return try_set("tx_int8_filter_en", value, self.token)
+    
+    #endregion
+ 

remoterf-0.0.7.41.dist-info/METADATA

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: remoterf
+Version: 0.0.7.41
+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
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio==1.71.0
+Requires-Dist: protobuf<6.0.0,>=5.0.0
+Requires-Dist: numpy
+Requires-Dist: prompt_toolkit
+Requires-Dist: python-dotenv
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Remote RF
+
+A python API to remotely access signal centric hardware. 
+
+Courtesy of Wireless Lab @ UCLA. - Ethan Ge
+
+## Prerequisites
+
+- **Python 3.10**: This package works in Python 3.10+. If you don’t have Python installed, you can download it from the [official Python website](https://www.python.org/downloads/).
+
+To check your current Python version, open a terminal and run:
+
+```bash
+python --version
+```
+
+- **UCLA VPN**: Please ensure that you are connected to the UCLA VPN. You can download and configure the VPN client from the following link: [UCLA VPN Client Download](https://www.it.ucla.edu/it-support-center/services/virtual-private-network-vpn-clients). If you’re not connected to the VPN, you will not have access to the lab servers.
+
+## Installation
+
+Use the package manager [pip](https://pip.pypa.io/en/stable/) to install remoteRF. It is recommended that you install this package within a [virtual environment](https://docs.python.org/3/library/venv.html).
+
+```bash
+python3 -m venv venv        # Create virtual environment
+source venv/bin/activate    # Activate virtual environment
+
+pip install remoteRF        # Install remoteRF
+```
+
+If `pip install` doesn't work, you can clone the [source](https://github.com/WirelessLabAtUCLA/RemoteRF-Client) directly from github.
+
+<!-- 1. **Clone the repository:**
+```bash
+git clone https://github.com/WirelessLabAtUCLA/RemoteRF-Client
+cd repository-name
+```
+2. **Install the package using** `pip` **in editable mode:**
+```bash
+pip install -e .
+```
+This command installs the package in "editable" mode, allowing for modifications to the local code without reinstalling. For more details on installing packages from local directories, refer to Python Packaging: [Installing from Local Archives](https://packaging.python.org/en/latest/tutorials/installing-packages/#installing-packages-from-local-archives). -->
+
+## Reservation
+
+Usage of the platform requires you to register a account and reserve a device in order to run scripts remotely. 
+
+### 1. **Start UCLA VPN**
+
+- Start the CISCO Secure client, login and connect to any of the options.
+
+### 2. **Register a account**:
+```bash
+remoterf-login  
+# Run in the terminal 
+# where the Python library is installed
+
+# Typically, this will be the terminal where you’ve activated the virtual environment if you’re using one
+```
+
+- Input `r` to register a account, or `l` to login to a existing one.
+
+<!-- 2. **You will be prompted with this**: -->
+```bash
+Welcome to Remote RF Account System.
+Please login or register to continue. (l/r):
+```
+
+- Once in, input `help` to see all avaliable commands.
+
+### 3. **Reserve Device**:
+```bash
+getdev  # To view all avaliable devices
+
+# Note the device ID. You will need this later to reserve said device
+```
+
+```bash
+getres  # To view times not avaliable
+
+# Optionally, you can also view all reservations, and determine a time slot you want a specific device reserved
+```
+```bash
+perms   # To view your permissions
+
+# Depending on your permission levels, you will be given different restrictions 
+```
+
+```bash
+resdev # To reserve a device
+
+# Input the number of days you want to view, and it will display available reservations in that time span.
+
+Reservation successful. Thy Token -> example_token
+
+# Take note of this token. You will need it to actually access the device.
+```
+
+## Remote Access
+
+With this token, you can now run scripts remotely. Please keep in mind that you MUST be connected to the UCLA VPN for this to work.
+Here is a explained sample script to get you going!
+
+#### Python Script:
+
+```python
+from remoteRF.drivers.adalm_pluto import *  # Imports device Pluto SDR remote drivers. Change depending on desired device.
+
+sdr = adi.Pluto(    # Device initialization.
+    token = 'example_token'     # Place the prior token here.
+)
+
+# You can now use this 'sdr' as you normally would with the default Pluto drivers.
+```
+
+If converting a existing `non-remoteRF` compatible script:
+
+```diff
+- import existing_device_drivers 
+
++ from remoteRF.drivers.device_drivers import *
+
+- device = device(init)
+
++ device = device(token = 'sample_token')
+```
+
+Nothing else needs changing! 
+
+## Closing
+
+This is fundamentally a experimental platform, and there will be many unknown bugs and issues. Some devices do not have universal support for all its functions at the moment, I am working on that aspect. 
+
+**So please submit feedback!**

remoterf-0.0.7.41.dist-info/RECORD

@@ -0,0 +1,33 @@
+remoteRF/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+remoteRF/common/__init__.py,sha256=8naT0ZphJxv_6uz7RRGvqfNB-UEznkzipJSVPD5n6iM,40
+remoteRF/common/grpc/__init__.py,sha256=GYLHC7riDbjdx2cNOhWymt0GLZ4mtGhuzZAXVRfNynw,37
+remoteRF/common/grpc/grpc_pb2.py,sha256=iMdLw3xly_2WjirEmVaxf7I8iiUmk-3YRqqIiRdNkPs,4082
+remoteRF/common/grpc/grpc_pb2_grpc.py,sha256=NofKaB3t0nAm_uxDgA5WXhWcsRWqsyfuMEEdBrosVKk,3368
+remoteRF/common/utils/__init__.py,sha256=JTP8gH-340HZI4F8oagPW-kxRCoVUnQB-_acmgXPaK4,204
+remoteRF/common/utils/ansi_codes.py,sha256=knGLOJK-lyDjfQHL0Upq5UPTg6J_6WYldga-ZOaerSs,3052
+remoteRF/common/utils/api_token.py,sha256=CdgnAIcKqhkJB_XqrshgJVZzfQIO-xeR8hVMi5bYPSI,1260
+remoteRF/common/utils/list_string.py,sha256=qsch666vX2e3CZ2W5EdYi62dOk37k1v2yPpHHm47a7A,156
+remoteRF/common/utils/process_arg.py,sha256=J1REqgjm-1daqTBdVASgDd-16y-KneOJpCZXPEOklVk,2971
+remoteRF/core/__init__.py,sha256=XQiCe8kyzM7XLxA883-uDndBmbr-NXo1uvtMJT2h6oA,73
+remoteRF/core/acc_login.py,sha256=UcY3rDLAwHoJ9lYXRfm26z_6yJX0JSoKv-u1mF6n0Gs,49
+remoteRF/core/app.py,sha256=xNWRweioFqxX2IjRcvUTBguDmbPDSdn0xzfluBsJwYw,22545
+remoteRF/core/cert_fetcher.py,sha256=blKLtvTA2r1WRRbwNjMHF_FxEalYD3aVQC9XCdyoO7A,4326
+remoteRF/core/config.py,sha256=JoL9NIzSf79dDL5JHaJI2TjUF5JQovse7dFDfLVXDCU,4251
+remoteRF/core/grpc_acc.py,sha256=bspLTzblhqYVVEFPwdvXrDZjREBWJVvD_SaT_cja6kU,2441
+remoteRF/core/grpc_client.py,sha256=540JkGsJ8_poN_aRn3FJmuGN4078or06ke00T6A7qEo,3143
+remoteRF/core/version.py,sha256=iMcmRB5ZxCliJZgPU6utwCia5M9HJ-J8E-LpPmcEgS8,182
+remoteRF/core/certs/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+remoteRF/core/certs/ca.crt,sha256=Rp8V8Mi413an0rO_dy7sH32j77ppVP1POZ-g7_eVtDU,2004
+remoteRF/core/certs/ca.key,sha256=h5UQDlCcf7munMLTROYk6TGt9Guf0ar9aHoRPlsR2sk,3272
+remoteRF/core/certs/cert.pem,sha256=d90GwpyubEcyp1WUcyMCpn93HI8RUY96sMg5ynHrIMM,1127
+remoteRF/core/certs/key.pem,sha256=cWJ4BYX47boqXBcPmN5r_9KqYS4gLyGXnHGPMwwrNMo,1704
+remoteRF/core/certs/server.crt,sha256=iBGe9iepYA0bBK1NV4lUrnp64qbLOcCq07hmO8-2aK8,1151
+remoteRF/core/certs/server.key,sha256=aUbQk7TKZJyhp-l5noj4nnfmtLDendTiR_sGq4amX6U,1704
+remoteRF/drivers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+remoteRF/drivers/adalm_pluto/__init__.py,sha256=_IOOeQXR6paCP7Eciw2aeKBUNvZs-jeBTwW8QqUlFyU,33
+remoteRF/drivers/adalm_pluto/pluto_remote.py,sha256=6TTp6v6HCXnULHFh90GVbLDWk7RXY2oZo7iiCl8EZdI,7460
+remoterf-0.0.7.41.dist-info/METADATA,sha256=hbNUv9q9L75X0Htp34UopOR88A_UYXuRQcJv5fbHM90,5173
+remoterf-0.0.7.41.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+remoterf-0.0.7.41.dist-info/entry_points.txt,sha256=A4FjVWS1Q0s0Yyv6tApbZcI6ZUzwe-KyppVfp4seA-w,148
+remoterf-0.0.7.41.dist-info/top_level.txt,sha256=XQJoVTmAOsHV9qtPSP_QSh0ma4jKxsDkxn4IjM_ZuZk,9
+remoterf-0.0.7.41.dist-info/RECORD,,

remoterf-0.0.7.41.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

remoterf-0.0.7.41.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+remoterf-config = remoteRF.core.config:main
+remoterf-login = remoteRF.core.acc_login:main
+remoterf-v = remoteRF.core.version:main

remoterf-0.0.7.41.dist-info/top_level.txt

@@ -0,0 +1 @@
+remoteRF