Version: es-1.0.0

GNU Radio

Introducci贸n#

Este tutorial muestra c贸mo ejecutar la herramienta GNU Radio para controlar el equipos USRP de la infraestructura del laboratorio, para ello realice lo siguiente:

  • Haber cargado las claves SSH a la plataforma y haber creado el experimento con los nodos del laboratorio. Si no sabe c贸mo realizar este paso dir铆jase a la gu铆a de inicio r谩pido AQU脥

Para este ejemplo vamos a crear un experimento con los nodos USRP wirid-lab-node-60 y wirid-lab-node-65

Puertos utilizados en esta aplicaci贸n:#

Si desea controlar el nodo mediante el acceso avanzado tenga en cuenta la siguiente lista de puertos que se exponen en cada nodo.

  • 2022 para ingresar mediante SSH a cada nodo (Usuario: root y contrase帽a utilizar token de reserva)
  • 8080 para ingresar al notebook Jupyter
  • 4200 para ingresar por SSH Web
  • 6901 para ingresar por VNC Web
  • 5901 para ingresar por aplicaci贸n VNC

Direcciones IP USRP#

Todos los radios USRP tienen la direcci贸n IP 192.168.0.2 Al realizar el despliegue de la aplicaci贸n autom谩ticamente se clona en la ruta /headless/root de cada nodo el repositorio https://github.com/wirid-lab/gnuradio-examples con ejemplos que pueda utilizar.

Acceso mediante interfaz WEB#

  • Al iniciar el experimento ver谩 que la aplicaci贸n se encuentra en estado Provisioning esto indica que la aplicaci贸n se est谩 desplegando en cada uno de los nodos e iniciando cada uno de los puertos, el tiempo de aprovisionamiento es de 1 a 2 minutos. Una vez el estado se encuentre en Running puede ingresar a la aplicaci贸n Jupyter, SSH Web y VNC Web

  • Para acceder a cada una de estas aplicaciones le ser谩 solicitada una contrase帽a, esta se encuentra al hacer clic sobre el icono de llave en My Experiments . El token es una cadena alfanum茅rica 煤nica e irrepetible que identifica los nodos con la reserva.

Escritorio Remoto (VNC)#

  • Seleccione la opci贸n VNC en My Experiments

  • Una vez ingresa al escritorio remoto, abra un terminal ejecutando el comando gnuradio-companion, inmediatamente se abrir谩 una ventana con la aplicaci贸n.

  • Cree sus programas o utilice los programas de ejemplo.

  • Si desea utilizar los notebooks jupyter dentro del escritorio remoto, abra una pesta帽a de cualquier navegador e ingrese http://localhost:8080

  • Si quiere verificar la informaci贸n del radio, abra un terminal dentro de la interfaz y utilice el comando uhd_usrp_probe --args="addr=192.168.0.2" , este dar谩 informaci贸n completa del equipo.

  • Si desea transmitir o recibir se帽ales de la USRP, configure el par谩metro Device Addres: "addr=192.168.0.2" en los bloques UHD.

  • Guarde el espacio de trabajo y ejecute el programa. Si recibe una advertencia de xtem omitala.

SSH Web#

  • Seleccione la opci贸n SSH en My Experiments
  • Indique el usuario root
  • Ingrese el token de la reserva como contrase帽a haciendo click derecho y seleccionar la opci贸n Paste from browser
  • Oprimir la tecla 芦Enter禄

Jupyter#

  • Seleccione la opci贸n Jupyter en My Experiments
  • Ingrese el token de la reserva como contrase帽a

Acceso avanzado#

Cuando el estado cambia a running, una direcci贸n IP ser谩 asignada a cada nodo, para este ejemplo tenemos 10.98.17.192 para el nodo 60 y 10.109.205.35 para el nodo 65.

Preparar Conexi贸n al laboratorio#

Para realizar la conexi贸n avanzada al laboratorio es posible mediante la configuraci贸n del archivo config ubicado en la carpeta .ssh o mediante alg煤n programa externo como PUTTY. A continuaci贸n se mencionan las dos opciones.

Archivo Config#

Elimine el archivo known_hosts y modifique su archivo config con la siguiente informaci贸n

Host wirid-lab
HostName wirid-lab.umng.edu.co
User guestuser
Port 2222
IdentityFile ~/.ssh/id_rsa
#Configuracion para el nodo 60
LocalForward 5901 10.98.17.192:5901
LocalForward 6901 10.98.17.192:6901
LocalForward 2022 10.98.17.192:2022
LocalForward 81 10.98.17.192:8080
LocalForward 4200 10.98.17.192:4200
#Configuracion para el nodo 65
LocalForward 5902 10.109.205.35:5901
LocalForward 6902 10.109.205.35:6901
LocalForward 2023 10.109.205.35:2022
LocalForward 82 10.109.205.35:8080
LocalForward 4201 10.109.205.35:4200

Tenga en cuenta que para cada nodo debe asignar puertos locales diferentes.

Conectarse por el terminal o powershell mediante el comando ssh wirid-lab

Putty#

Realizar las siguientes configuraciones en la opci贸n Tunneling

  • Puerto local 5901 para 10.98.17.192:5901
  • Puerto local 6901 para 10.98.17.192:6901
  • Puerto local 2022 para 10.98.17.192:2022
  • Puerto local 81 para 10.98.17.192:8080

Conexion a los nodos#

Escritorio Remoto (VNC)#

  • Descargar un cliente VNC, se recomienda utilizar VNC VIWER
  • Una vez descargado e instalado ingresar la direcci贸n ip 127.0.0.1:5901 para conectarse al nodo 60 y 127.0.0.1:5902 para conectarse al nodo 65

  • Si desea conectarse mediante el navegador de internet, ingrese http://127.0.0.1:6901 para el nodo 60 y http://127.0.0.1:6902 para el nodo 65.
  • Una vez ingresa a la interfaz remota del nodo ya puede iniciar con el control del radio USRP.
  • Si quiere verificar la informaci贸n del radio, abra un terminal Xfce dentro de la interfaz y utilice el comando uhd_usrp_probe --args="addr=192.168.0.2" , este dar谩 informaci贸n completa del equipo.

  • Para utilizar gnuradio ingrese el comando gnuradio-compainion
  • Si desea transmitir o recibir se帽ales de la USRP, configure el par谩metro Device Addres: "addr=192.168.0.2" en los bloques UHD.

Guarde el espacio de trabajo y ejecute el programa. Si recibe una advertencia de xtem omitala.

SSH Web#

  • Ingrese desde su navegador a http://127.0.0.1:4200 para el nodo 60 o http://127.0.0.1:4201 para el nodo 65
  • Indique el usuario root
  • Ingrese el token de la reserva como contrase帽a haciendo click derecho y seleccionar la opci贸n Paste from browser

SSH#

  • Abra un terminal e ingrese ssh -p 2022 root@127.0.0.1 -o StrictHostKeyChecking=no para el nodo 60
  • Abra un terminal e ingrese ssh -p 2023 root@127.0.0.1 -o StrictHostKeyChecking=no para el nodo 65
  • Ingrese el token de la reserva como contrase帽a

Jupyter#

caution

Tenga en cuenta el tiempo de la reserva para guardar sus archivos ya que una vez finalizada la reserva el sistema cierra todas las conexiones y los datos trabajados se perder谩n.

info

Los puertos locales pueden se configurados a su gusto, no se exige la misma configuraci贸n.