Requirements
This tutorial will show you how to configure Handover On Your ORS. Please read all the tutorials above in the requirements before reading this one, you need a good understanding of the ORS, the process of testing and configuring radio before you attempt a Handover configuration.
What Handover cases are supported ?
This tutorial focuses on ORS, therefore it will only cover inter-eNB / inter-gNB handover, intra-eNB / intra-gNB handover will not be covered in this tutorial as ORS only has one cell, but it is also supported by Amarisoft (please refer to https://tech-academy.amarisoft.com/appnote_handover.doc )
For inter-eNB and inter-gNB handover, all eNBs / gNBs need to be connected to the same core network.
Case 1: External Core Network
Please refer to How To Connect Your ORS To Third Party's Core Network On Panel
Case 2: Core Network On ORS also running eNB / gNB
In this case, you need to use IPv6 addresses because this will require the ORS running both core network and eNB / gNB to have two addresses, which we do not support with IPv4.
If all ORS are on the same LAN then all the ORS will be able to access each other directly using their IPv6 through re6st. If they are on different LAN they you need IPv6 connectivity.
Case 3: Core Network On ORS not running any eNB / gNB
This is the same as Case 1.
Handover between 4G and 5G, and Xn Handover
Handover between 4G and 5G and Xn Handover is supported by Amarisoft and we have tested it on the ORS, but it is not yet possible to configure it on the simpleran software release on the Rapid.Space Panel.
We are currently implementing it and it will be available in the next software release, please contact us if you need it soon.
Configure your core network
Configure your core network to listen on the IP so that your ORS will be able to connect to it.
If you are using an Amarisoft core network managed by the panel, go to your core network service and configure the following parameters:
- External eNB / gNB: true
- iperf3 UDP server: true (recommended)
- Use IPv4: true or false depending on if you are using IPv6 or IPv4 between the eNB / gNB and core network
Then, you can get the core network address in the connection parameters, look for "core-network-ipv4" and "core-network-ipv6".
Connect all ORS to the same core network
Please follow https://handbook.rapid.space/ors/rapidspace-HowTo.Connect.Your.ORS.To.Third.Partys.Core.Network.On.Panel in order to connect each of your ORS to the same core network.
Make sure to set the "use_ipv4" parameter to true or false depending on your case. Remember that if you are running a core network and eNB / gNB on the same ORS you will need to use IPv6.
Once you have configured the ORS to connect to the external core network, you may check that it connected correctly by checking the eNB or gNB log and making sure you see a "NG Setup Response" or "S1 Setup Response".
Please follow How To Monitor And Access Logs On ORS to see how to check the logs.
Configure each ORS individually with GPS
The first step is to configure each ORS individually and to make sure you have the best radio conditions on each of them.
Power on each ORS one at a time and adjust the configuration to make sure your UE does not get disconnected when walking around the antenna, and that the radio quality is good enough.
Your ORS needs to be synchronized with GPS for the Handover to work properly, so make sure you enable the "GPS Sync" option on your eNB / gNB service while testing the ORS individually.
You should refer to these tutorials to adjust the radio settings and test the radio quality:
Configure the cell identities
The following values must be configured to be different on each ORS:
- Physical Cell ID
- eNB ID / gNB ID
- Root Sequence Index
- Cell ID: If you are using the same band then the Cell ID modulo 3 should be different on the neighbour cells (Example: 100, 101, and 102 is OK, but 100, 103 and 104 is not for 3 neighbour cells)
Please refer to the screenshot above to see where to configure these values.
We recommend that you do a drawing of all your cells to plan the cell identities correctly.
Configure the neighbour cells
For each neighbour ORS or ORS, you need to click "Object Properties" on the "Neighbour Cell Info" parameter, enter whatever name you want to identify your cell and click Add.
Then, you need to fill in all the values.
4G Cell:
- DL EARFCN: The one you configure on the neighbour cell
- Physical Cell ID: The one you configure on the neighbour cell
- E-EUTRAN Cell ID: Concatenation of the eNB ID and cell ID of the neighbour cell. For instance if the eNB ID is 0x12345 and Cell ID is 0x01 then the E-EUTRAN Cell ID will be 0x1234501
- Tracking Area Code: The one you configure on the neighbour cell, by default 1
5G Cell:
- DL NR ARFCN: The one you configure on the neighbour cell
- SSB NR ARFCN: You can get this value by checking the eNB log of your neighbour cell and searching at the beginning of the log for "ssb_nr_arfcn"
- Physical Cell ID: The one you configure on the neighbour cell
- NR Cell ID: Concatenation of the gNB ID and cell ID of the neighbour cell. For instance if the gNB ID is 0x12345 and Cell ID is 0x01 then the NR Cell ID will be 0x1234501
- gNB ID bits: The one you configure on the neighbour cell, by default 28
- NR Band: The one you configure on the neighbour cell
- Tracking Area Code: The one you configure on the neighbour cell, by default 1
Handover test
We recommend that you first start testing with only two cells, otherwise identifying the potential issues will be harder.
Please make sure you have a way to show serving and available cells on your UE, please refer to: How To Test 4G 5G Signal With Android
Power on your UE and start a continuous data stream between the UE and the core network during the whole test, we recommend doing either a ping test, an iperf3 test or a local video call (refer to the Android tutorial and / or How To Do Local Messaging And Video Calls With ORS )
If you do not have a continuous data stream between UE and core network then your UE will go in idle mode and this will make debugging harder.
First stay near the first cell and check that your UE is connected to the nearest cell (using for example the special dial menu on Android or Network Cell Info app, you can see the PCI of the cell you are connected to on these apps).
Then, move from one cell to another and check that you do not experience too much disruption in your data stream, and check that your serving cell switches to the nearest cell.
Then, search for "Handover" in the gNB logs of your two cells, you should see the following messages:
- Handover request
- Handover request acknowledge
Please refer to this Amarisoft app note for a more detailed analysis of the logs: https://tech-academy.amarisoft.com/appnote_handover.doc