remoterf-host 0.1.3

RemoteRF host-side control package

RemoteRF Host (hostrf) — Linux Setup (Mamba Default)

This guide installs Miniconda, installs mamba, creates a conda env named hostrf, installs dependencies, and verifies the install on Ubuntu Server 24.04 LTS.

Notes

• These commands assume an APT-based distro (Ubuntu/Debian/Raspberry Pi OS 64-bit).
• For non-APT distros (Fedora/Arch), install equivalent system packages.

---

0) Raspberry Pi setup

Raspberry Pi Imager → Install Ubuntu Server 24.04 LTS → Boot Raspberry Pi from SD card.

---

1) System Prerequisites (APT)

sudo apt update
sudo apt install -y curl ca-certificates bzip2 git build-essential
sudo apt install -y libusb-1.0-0 udev

Optional: confirm architecture:

uname -m

• x86_64 → Intel/AMD
• aarch64 → ARM64 (Raspberry Pi 64-bit, some servers)

---

2) Install Miniconda

2.1 Download the installer

x86_64

cd /tmp
curl -fsSLO https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

ARM64 (aarch64)

cd /tmp
curl -fsSLO https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-aarch64.sh

2.2 Install (non-interactive, recommended)

x86_64

bash Miniconda3-latest-Linux-x86_64.sh -b -p "$HOME/miniconda3"

ARM64 (aarch64)

bash Miniconda3-latest-Linux-aarch64.sh -b -p "$HOME/miniconda3"

2.3 Enable conda in your current shell

source "$HOME/miniconda3/etc/profile.d/conda.sh"
conda --version

If you want conda available automatically in new terminals:

"$HOME/miniconda3/bin/conda" init bash
source ~/.bashrc

2.4 Install mamba (default solver)

conda install -n base -c conda-forge -y mamba
mamba --version

---

3) Create the Environment (with mamba)

3.1 Create environment.yml

In your project directory:

cat > environment.yml <<'EOF'
name: hostrf
channels:
  - conda-forge
  - defaults

dependencies:
  - python=3.10
  - pip
  - setuptools
  - wheel

  - grpcio
  - protobuf
  - python-dotenv

  - numpy
  - scipy

  - libiio
  - pylibiio
  - libusb

  - pip:
      - pyadi-iio
      - remoterf-host
EOF

3.2 Create the environment (default: mamba)

mamba env create -f environment.yml

Fallback if mamba isn’t available for some reason:

conda env create -f environment.yml

3.3 Activate it

conda activate hostrf

---

4) Verify Installation

4.1 Confirm Python version

python --version

Expected: Python 3.10.x

4.2 Verify core dependencies

python -c "import grpc, google.protobuf, dotenv, numpy, scipy; print('core deps ok')"

4.3 Verify IIO + ADI stack

python -c "import iio; import adi; print('iio + pyadi-iio ok')"

4.4 Verify remoterf-host

python -c "import remoteRF_host; print('remoterf-host ok')"

---

5) Common Operations

Activate later (new terminal)

source "$HOME/miniconda3/etc/profile.d/conda.sh"
conda activate hostrf

Update environment from environment.yml (default: mamba)

mamba env update -n hostrf -f environment.yml --prune

(Fallback)

conda env update -n hostrf -f environment.yml --prune

Remove the environment

mamba env remove -n hostrf

(Fallback)

conda env remove -n hostrf

---

6) Troubleshooting

Missing packages on ARM / install errors for libiio / pylibiio

On some ARM setups, conda-forge availability can vary. If mamba env create fails:

1. Remove libiio / pylibiio from environment.yml
2. Install system packages instead:

sudo apt install -y libiio0 libiio-dev