As of Nov. 2016, the following pieces are made available to R2lab users
- a commercial phone is deployed inside the room; it can be controlled through a dedicated MAC box, to which it is linked with a USB cable;
- we offer 2 ready-to-use images, tuned for the R2lab nodes, and with the OpenAiInterface software installed; they target, on the one hand, the infrastructure side of a LTE network, and on the other hand radio-oriented functions, like base stations and UEs.
These pieces are described in more detail in this section of the tutorial
Here's the generic setup regarding the commercial phones available
faraday to controlling MAC
- controlling MAC is known from
- however you need a private key to login; this is located in
- so for convenience on
faradayyou can use the
macphonealias that calls
sshwith the right options
So for example to run the
macphone-status command on the MAC, you can do this
inria_r2lab.tutorial@faraday:~$ macphone phone-status && echo OK phone is turned ON OK
Or more simply if you just want to login into the MAC box, you can do this
inria_r2lab.tutorial@faraday:~$ macphone Last login: Fri May 12 14:50:13 2017 from rhubarbe-switches macphone:~ tester$
macphone, just like on faraday, there are some convenience tools available in this shell environment
macphone:~ tester$ help #################### Native bash help <snip> #################### R2lab: tools for managing R2lab phone from macphone refresh retrieve latest git repo, and source it in this shell phone-start-app start an app from its package name phone-wifi-on turn on wifi (tested on nexus 5) phone-wifi-off turn off wifi (tested on nexus 5) phone-on turn off airplane mode phone-off turn off airplane mode - does not touch wifi settings phone-status shows wheter airplane mode is on or off phone-reboot reboot phone with abd reboot
You can also of course use
adb, and thus eventually enter the phone itself
macphone:~ tester$ adb devices List of devices attached 062337da0051af9f device macphone:~ tester$ adb shell shell@hammerhead:/ $
Another way to control the phone is through VNC, or equivalently the Screen Sharing application if your own computer is a MAC. This way you can obtain a video session in
macphone, as illustrated below, and from that point you can run the Vysor application and see the phone screen, and interact with it as if it were in your hand.
For this you will need the following information:
- VNC endpoint :
faraday.inria.fron port 5900 - this port is forwarded to
macphoneon same port
- login credentials in
SIM cards and other details
- There is no reason why you would need this, but if only for the record:
- the Android phone's SIM card PIN is
- the iphone's SIM card PIN is
0000; its IMEI is
The following images are available for uploading on R2lab:
oai-gwcomes with primarily
openair-cn(from this git repo)
oai-enbcomes with primarily
openairinterface5g(from this git repo)
Please note that the latter one only makes sense on nodes that have a USRP attached. The former on the other hand can run on any node.
This script leverages these 2 images in order to create a setup where
- one (any) R2lab node is used to run a 5g HSS,
- one (any) R2lab node is used to run a 5g EPC and a 5g SPGW,
- one (USRP) node is used to run as a 5g Base Station,
- the commercial phone is used to connect to the 5G network;
Both images come with their own set of convenience shell functions,
and these are leveraged in
oai-scenario.py in order to keep that
python script's size reasonable. Of course you do not have to use these convenience tools, you can use lower level tools to perform the configurations that you'd like.
For the sake of completeness, the convenience tools available on these 2 images are defined here:
nodes.shis what all regular nodes already have (source code)
oai-common.shis relevant on both images (source code)
oai-gw.shis exposed in the
oai-gwimage (source code)
oai-enb.shis exposed in the
oai-enbimage (source code)
There is room for quite some improvement in these tools; if of interest, feel free to discuss this topic on the users mailing list.
The software and hardware featured at R2lab allow to setup an experimental 5G network inside the anechoic chamber.
As of now, the simplest option is to use a commercial phone to act as the tip of the iceberg in this setup.
It is in principle doable to run a UE inside a R2lab as well, but we have no working implementation of that as of yet.
Again, feel free to discuss this topic on the users mailing list.