= Connecting User Equipment to GENI LTE = 

== 1. Introduction ==

This document aims to outline how GENI sites can connect their own User Equipment (UE) to the GENI LTE network. It will outline the types of hardware supported, and the configuration aspects that need to be met in order to be compatible with the network. 

== 2. Phone Requirements == 

 * LTE Enabled
 * Capable of Accessing LTE Band 41 (TD 2500), Operating Frequency of 2496-2690 MHz
 
 To determine if your phone meets these criteria, you may use the following tool, which allows you to enter the phone model and see which LTE bands it may access: https://willmyphonework.net/

== 3. SIM Cards ==

The phone that is to be used must be supplied with programmable SIM cards. The International Mobile Subscriber Identity (IMSI) must be recorded in the Rutgers Central EPC Home Subscriber System (HSS). If this step is not met, your phone will never be authorized to operate on GENI LTE. To have your SIM card registered in the Rutgers EPC HSS, there are two options:

 * Contact Rutgers Winlab directly and request they ship the SIMs to your site. 
 * Purchase porgrammable SIM cards (Such as these: https://www.sysmocom.de/products/sysmousim-sjs1-sim-usim/) and program the IMSI number yourself. Once done, you must send the IMSI numbers to Rutgers Winlab so it is correctly added to the HSS and your phone may access GENI LTE. 


== 4. Base Station Details ==

In order to access GENI LTE, you must have a fully configured Base Station at your site that can speak to the central EPC at Rutgers. The steps to do that shall be outlined below.

 1. Acquire a !AirSpan Base Station. Here are several in use by GENI LTE sites currently:
    a. http://www.airspan.com/airsynergy-2000/
    b. https://www.amarisoft.com/products-lte-ue-ots-sdr-pcie/#software (Software only, still need a radio peripheral)
 2. Modify the default configuration profile in !NetSpan in order to correctly set values for the following fields.  This is the minimum set needing to be configured in order to have a working eNB:
    a. Network Profile - Modify the PLMN and MME IP to site specific values.
    b. Cell Properties - Only important if your site has more than one base station.
    c. Radio Profile - Modify the settings for EARFCN and Bandwidth to match FCC spectrum allocation. 

More detailed specifics of the configuration aspects of Amarisoft Hardware and !NetSpan Software may be found at the following wiki: [wiki:GENILTE/LTEDeploymentRutgers GENI LTE Deployment at Rutgers]

== 5. Access Point Names ==

The UEs APN list must be edited in order to correctly access GENI LTE. Instructions to accomplish this for both Unlocked Android and iPhones are given below. 

 1. '''Android'''
    a. Navigate to Settings -> Mobile Networks -> Access Point Names 
    b. On the upper-right corner select "New APN"
    c. Enter the following fields: 

      '''Name''' = orbit
      '''APN''' = internet
      '''MCC''' = 001
      '''MNC''' = 01
      '''APN Protocol''' = IPv4
      '''APN Roaming Protocol''' = IPv4
      '''APN Enable / Disable''' = Enable
      ''' All other configuration variables should be left at their default values'''
 2. '''iPhones'''
    a. Navigate to Settings -> Cellular -> APN (iPhone must be unlocked for this option to appear)
    b. Enter the same exact data configuration variables as presented above for Android phones. 

Next, ensure that the newly configured APN is set to '''Enabled''' and that all other APNs are set '''Disabled'''.

== 6. Establishing Connection ==

Once all SIM cards are programmed and registered, and the APN enabled, the UE at this point ''should'' be able to establish connection to GENI LTE. To test, disable WiFi, enable the correct APN, reboot the phone. If all is well, the network identifier of ''GENI LTE'' will be listed next to the signal strength indicator.