| ... | ... | @@ -24,21 +24,17 @@ The main environment we will be using is an Ubuntu Linux virtual machine (VM) th |
|
|
|
On the FEIT GPU Desktop, the Ubuntu Linux VM can be accessed as follows.
|
|
|
|
|
|
|
|
1. Start VirtualBox: *Start Menu > Oracle VM VitualBox > Oracle VM VirtualBox*
|
|
|
|
2. Doubleclick `Ubuntu20.04_ELEN90089_R02.vbox` open VirtualBox
|
|
|
|
3. Click the start button in VirtualBox to launch the Ubuntu Linux VM.
|
|
|
|
4. Login to Ubuntu using the following credentials
|
|
|
|
username: cdc
|
|
|
|
2. Select the *ELEN90089_Ubuntu20.04_v2* virtual machine
|
|
|
|
3. Click the start button to launch the virtual machine
|
|
|
|
4. Login to Ubuntu using the following credentials\
|
|
|
|
username: cdc\
|
|
|
|
password: unimelb
|
|
|
|
5. To open Python or GRC, first open a bash shell by clicking on the Terminal icon in the dock: 
|
|
|
|
|
|
|
|
The Python interpreter can be launched at the command line.
|
|
|
|
|
|
|
|
To open Python or GRC, first open a bash shell by clicking on the Terminal icon in the dock: . The Python interpreter can then be launched at the command line.
|
|
|
|
```
|
|
|
|
$ python3
|
|
|
|
```
|
|
|
|
|
|
|
|
GRC can be similarly launched from the command line.
|
|
|
|
|
|
|
|
Similarly, GRC can also be launched from the command line.
|
|
|
|
```
|
|
|
|
$ gnuradio-companion
|
|
|
|
```
|
| ... | ... | @@ -47,7 +43,7 @@ $ gnuradio-companion |
|
|
|
|
|
|
|
Anaconda is a distribution of the Python and R programming languages available for Windows, macOS, and Linux. Both Python and GNU Radio can be accessed on the Windows FEIT GPU Desktop through an Anaconda environment configured for CDC.
|
|
|
|
|
|
|
|
1. Navigate to Start Menu > Ananconda3 (64-bit) > Anaconda Powershell Prompt
|
|
|
|
1. Navigate to *Start Menu > Ananconda3 (64-bit) > Anaconda Prompt (Anaconda3)*
|
|
|
|
2. At the resulting command prompt, activate the ELEN90089 conda environment
|
|
|
|
```
|
|
|
|
> conda activate elen90089_2021_03_14
|
| ... | ... | @@ -56,35 +52,36 @@ Anaconda is a distribution of the Python and R programming languages available f |
|
|
|
```
|
|
|
|
> python
|
|
|
|
```
|
|
|
|
or GNU Radio Companion
|
|
|
|
or GRC
|
|
|
|
```
|
|
|
|
> gnuradio-companion
|
|
|
|
```
|
|
|
|
|
|
|
|
### MATLAB / Simulink
|
|
|
|
|
|
|
|
Support packages for accessing Both the Ettus USRP and
|
|
|
|
Support packages for accessing both the Nuand bladeRF and the Ettus USRP have been installed should you want to access these devices in MATLAB and/or Simulink. Make sure to launch **MATLAB R2018b** and not Matlab R2020b. See the following pages for documentation on how to use these SDR devices in MATLAB/Simulink.
|
|
|
|
|
|
|
|
**MATLAB R2018b** (not R2020b)
|
|
|
|
- [Communications Toolbox Support Package for BladeRF 2.0](https://www.mathworks.com/matlabcentral/fileexchange/74591-communications-toolbox-support-package-for-bladerf-2-0)
|
|
|
|
- [Communications Toolbox Support Package for USRP Radio](https://www.mathworks.com/help/supportpkg/usrpradio/)
|
|
|
|
|
|
|
|
## Installation on Your Personal Computer
|
|
|
|
|
|
|
|
The following details how to install on your personal computer the environments supporting GNU Radio.
|
|
|
|
The following details how to install these environments supporting GNU Radio on your personal computer .
|
|
|
|
|
|
|
|
> Please be advised installation on a personal computer is optional and you install at your own risk. I may not be able to help resolve any issues you encounter.
|
|
|
|
> **Important Note:** Please be advised installation on a personal computer is optional and you install at your own risk. I may not be able to help resolve any issues you encounter!
|
|
|
|
|
|
|
|
### Ubuntu VM
|
|
|
|
|
|
|
|
The Ubuntu VM used in workshop can be run on your personal computer by installing VirtualBox. VirtualBox is a free and open-source virtualisation tool supported on Windows, macOS, or Linux. To set up your computer to run the ELEN90089 Ubuntu VM:
|
|
|
|
The Ubuntu VM used in workshop can be run on your personal computer by installing VirtualBox. VirtualBox is a free and open-source virtualization tool supported on Windows, macOS, and Linux. To set up your computer to run the ELEN90089 Ubuntu VM:
|
|
|
|
|
|
|
|
- Download and install the latest version of [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
|
|
|
|
- To use the SDR hardware (USRP B210 or bladeRF 2.0) with your personal computer, add USB 3.0 support by installing the [VirtualBox Extension Pack](https://www.virtualbox.org/wiki/Downloads)
|
|
|
|
- Download the ELEN90089 environment files (Version X - uploaded X XXX 2022):\
|
|
|
|
1. Download and install the latest version of [VirtualBox](https://www.virtualbox.org/wiki/Downloads)
|
|
|
|
2. To use the SDR hardware (bladeRF 2.0 or USRP B210) with your personal computer, add USB 3.0 support by installing the [VirtualBox Extensions Pack](https://www.virtualbox.org/wiki/Downloads)
|
|
|
|
- Download the ELEN90089 environment files (Version X - uploaded DD MMM YYYY):\
|
|
|
|
[TBD]() (X KB)\
|
|
|
|
[TBD]() (X GB)
|
|
|
|
- Doubleclick on the `.vbox` file to import the VM into VirtualBox.
|
|
|
|
- Doubleclick on the `.vbox` configuration file to import the VM into VirtualBox.
|
|
|
|
|
|
|
|
> **Note:** The `.vdi` file is large (12.4 GB!!!). Make sure you are on a good, unmetered internet connection before downloading.
|
|
|
|
> **Note:** The `.vdi` file is large (X GB!!!). Make sure you are on a good, unmetered internet connection before downloading.
|
|
|
|
|
|
|
|
The `.vbox` configuration file provided has minimal system settings. Depending on the resources available on your personal computer you may want to increase these for better performance.
|
|
|
|
|
| ... | ... | @@ -94,14 +91,14 @@ The `.vbox` configuration file provided has minimal system settings. Depending o |
|
|
|
|
|
|
|
### Conda
|
|
|
|
|
|
|
|
Another option for using GNU Radio in the workshops is through the conda environment on the FEIT GPU Desktop image. Should you wish to install the same environment on your Windows, macOS, or Linux personal computer, you can follow these instructions. First decide whether you want to install Anaconda or its lightweight version Miniconda. Anaconda has a graphical environment management tool and automatically downloads 250+ packages. Miniconda is command line only and will download packages as needed for your created environments.
|
|
|
|
Another option for using GNU Radio in the workshops is through the Anaconda environment on the FEIT GPU Desktop image. Should you wish to install the same environment on your Windows, macOS, or Linux personal computer, you can follow these instructions. First decide whether you want to install Anaconda or its lightweight version Miniconda. Anaconda has a graphical environment management tool and automatically downloads 250+ packages. Miniconda is command line only and will download packages as needed for your environments.
|
|
|
|
|
|
|
|
- [Installing Anaconda](https://docs.anaconda.com/anaconda/install/index.html#)
|
|
|
|
- [Installing Miniconda](https://docs.conda.io/projects/continuumio-conda/en/latest/user-guide/install/index.html)
|
|
|
|
|
|
|
|
Next, download the following YAML environment file specifying the packages in the ELEN90089 conda environment:
|
|
|
|
|
|
|
|
- [elen90089_2021_03_14.yml]() (*uploaded DD MMM YYYY*)
|
|
|
|
- [elen90089_2021_03_14.yml](files/elen90089_2021_03_14.yml) (*uploaded 26 Feb 2022*)
|
|
|
|
|
|
|
|
> **Note:** This configuration file may be updated over the semester as new package requirements are identified.
|
|
|
|
|
| ... | ... | |
