RemoteRF 0.0.4__tar.gz → 0.0.6__tar.gz

{remoterf-0.0.4/src/remoteRF.egg-info → remoterf-0.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: remoteRF
-Version: 0.0.4
+Version: 0.0.6
 Summary: A python API to remotely access signal centric hardware. Client-side only!
 Author: Ethan Ge
 Author-email: ethoGalaxy@gmail.com

remoterf-0.0.6/README.md

@@ -0,0 +1,130 @@
+# Remote RF
+
+A python API to remotely access signal centric hardware. Courtesy of Wireless Lab @ UCLA.
+
+## Prerequisites
+
+- **Python 3.12 or later**: This package requires Python 3.12+. 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
+pip 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
+
+Enter the device ID you would like to reserve: 0
+Reserve Start Time (YYYY-MM-DD HH:MM): 2024-11-20 10:20
+Reserve End Time (YYYY-MM-DD HH:MM): 2024-11-20 11:20
+
+# Time is military time. You can also use arrow keys to cycle between previous commands.
+
+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 = 'sample_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.4 → remoterf-0.0.6}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="remoteRF",
-    version="0.0.4",
+    version="0.0.6",
     author="Ethan Ge",
     author_email="ethoGalaxy@gmail.com",
     description="A python API to remotely access signal centric hardware. Client-side only!",

{remoterf-0.0.4 → remoterf-0.0.6}/src/remoteRF/drivers/adalm_pluto/pluto_remote.py

@@ -1,6 +1,7 @@
 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
 
 class rx_def:
     pass
@@ -16,14 +17,18 @@ class ad9364(rx_tx_def):
 
 class Pluto: # client
     
-    def __init__(self, token=''):
+    def __init__(self, token='', debug=False):
         self.token = token
         # self.try_set(function_name="ip", value=grpc_pb2.Argument(string_value=ip))
         
+        if debug:
+            print("Pluto Remote Client Initialized.")
+        
     def api_token(self, token:str) -> None:
         self.token = token
         
     def try_get(self, *, function_name):
+        self.test_print()   # For debugging purposes
         try:
             return rpc_client(function_name=f"Pluto:{function_name}:GET", args={'a':map_arg(self.token)}).results[function_name]
         except Exception as e:
@@ -31,10 +36,15 @@ class Pluto: # client
             return None
 
     def try_set(self, *, function_name, value):
+        self.test_print()   # For debugging purposes
         try:
             rpc_client(function_name=f"Pluto:{function_name}:SET", args={function_name: value, 'a':map_arg(self.token)})
         except Exception as e:
             input(f"Error: {e}\nHit enter to continue...")
+            
+    def test_print(self):
+        if get_tcp_calls() % 50 == 0:
+            print(f'TCP Call Number: {get_tcp_calls()}')
 
     #region ad9364
 

{remoterf-0.0.4 → remoterf-0.0.6/src/remoteRF.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: remoteRF
-Version: 0.0.4
+Version: 0.0.6
 Summary: A python API to remotely access signal centric hardware. Client-side only!
 Author: Ethan Ge
 Author-email: ethoGalaxy@gmail.com