This tutorial teaches how to assemble an Open Radio Station, and package it if necessary (to sell it on shop.rapid.space).
ORS Assembly Parts Introduction
Check you have one "AMARI NR Small Cell" and one "AMARI 4G 5G CORE D" before assembling the ORS. If not, please refer to rapidspace-ORS.Assembly.Process.Amarisoft.License
While assembling the ORS, use the USB to M2 SATA adaptor to flash the SSD.
Check you have the correct image (this will take a minute or two to generate):
laptop:~# md5sum ors-ssd.img
WARNING: be very careful to put the correct ssd device argument for the dd command or you might erase your whole PC.
laptop:~# sudo dd if=ors-ssd.img of=/dev/<SSD-DEVICE> status=progress bs=1M && sync
SSD device should be the whole device, not just a partition (not /dev/sda1 but /dev/sda for instance)
Warning: Please do not plug or unplug the POE RJ45 cable from the ORS while injector is powered on.
Doing otherwise might break some electrical components inside the ORS. Even if the ORS has been manually powered off through SSH (for those having root access) you still need to follow this procedure to unplug it.
Use a hexagonal screwdriver to remove the 8 screws from the enclosure.
Apply thermal interfaces
Install the SDR main board with M2.5 screws * 17. Start by very lightly screwing all screws, then once all screws are placed tighten them all. Write down the PCB board number.
Take out the LED wires and close the ORS lid while cutting excess metal wire, as small metal bits landing on PCB could break it. Cut a red and black wire of 23cm for the PC supply, and strip and tin around 4mm at each side.
Connect the LED wires and the PC supply cables in a PTSM connector. The metal wires should not stick out of the PTSM, cut them if necessary. Use a SIM pin to open the PTSM connector in order to insert the cable into it as shown on the image.
Twist the power supply wires
Plug the PTSM connector from the LED wires in the SDR main board. Plug an armored RJ45 cable between the ORS power input and the PCB power input. If the RJ45 cable is too long, use an insulated cord to hold it in place.
Please remove the plastic films before you plug the coax cables.
Twist the 3 RF coaxial cables by first twisting them in the vertical plane, then the horizontal plane. Don't use pliers or tools that could break the cables, they are fragile.
Plug the 3 RF coax cables. Remove the black cable sleeve on the Radio 2 as shown on the image. First put Radio 2 cable, then Radio 1, then GPS. The connector on the boards are fragile, please be careful.
On the other part of the enclosure, install the Single Board Computer with the M3 screws. Please remove the plastic from the bottom of SBC before you paste. Fix it with 4 screws (14cm)
Install the DDR4 SODIMM, the MSATA SSD and the PCI Express adaptor board.
Set the jumpers on the SBC.
Please put the enclosure with SBC and the other side on the same plane like the figure shown. Connect the power cable to the SBC.
Connect the power cable in a PTSM connector and plug this connector in the SDR main board.
Connect the ribbon FFC between the PCI Express adaptor board and the SDR main board.
Connect the second RJ45 cable between the SBC and the SDR main board.
Before closing the ORS, write down the PC serial number. Close the enclosure and connect the PoE cable to start the system.
Place a "ORSXX" label on the interior of the case of the PC, and on the exterior of the case as shown on the images
Power on the ORS. If you are making multiple ORS, power only one at a time and set the hostname before powering the others, otherwise you won't know which ORS is which.
Set hostname and password:
root@orsXX:~# scripts/ors/0-setup-hostname-passwd ORSNUMBER
Log out then log back in again to check hostname is correct. Please also test the password by logging in without your SSH key:
laptop:~# ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no root@ORSIP
Usually this is not needed as we flash PCB as soon as we receive them, before assembling them.
Make sure the FPGA is not yet visible, if the FPGA is already there no need for this procedure
Patch the FPGA:
Hard reset the box (totally power off, then power on)
Check the FPGA is visible to make sure everything is OK
As for the previous step, this is not normally needed during ORS assembly.
Add the licence
Get the Host ID of the ORS:
Then, get the corresponding licenses: rapidspace-ORS.Assembly.Process.Amarisoft.License, and copy them to the ORS:
user:~# ssh ORS31 mkdir -p .amarisoft && scp lteenb.key ltemme.key root@ORS31:.amarisoft/
Test the licences by launching lte
Install Re6st (on new production network, don't use re6st deploy script) and SlapOS
Install ORS playbook
Make sure slapos has been properly installed. Run the script to install the ORS playbook:
root@orsXX:~# wget https://deploy.erp5.net/ors && bash ors
Use the script in amarisoft-private repository to do all the necessary supplies and requests.
If ORS is for root access, run the corresponding script:
Clone the ors-util repository:
root@orsXX:~# git clone https://lab.nexedi.com/nexedi/ors-utils.git
root@orsXX:~# cd ors-utils/uicc-v2.4
Execute this command:
root@orsXX:~# ./write-sim-card ORS_NUMBER
Once the first SIM card is plugged, type "y" then press the Enter key
Wait until all the transfer is done, then unplug the SIM card, put the next one, and press "y" then the Enter key again. Do this for all 5 SIM cards.
Once you are done, remove the SIM card and press "q" then Enter key.
If you need to write a specific SIM card, you can pass the SIM card number as second argument (1, 2, 3, 4 or 5):
root@orsXX:~# ./write-sim-card ORS_NUMBER SIM_CARD_NUMBER
To read a SIM card data use:
root@orsXX:~# sudo ./program_uicc
To perform the same, with trace: all data exchange with the UICC are printed
root@orsXX:~# sudo DEBUG=y ./program_uicc
Show the parameter help to set values in the UICC.
root@orsXX:~# sudo ./program_uicc --help
Test that each SIM card can connect to the ORS by putting it in a UE. Please also test the UE can connect to the ORS from a distance with a good enough bandwidth, to make sure the connection between SDR board and ORS box is fine.
Before powering off the ORS, add "interface" option in re6stnet.conf.
Warning: This step should be done last. If you have to reboot the ORS after this step, please keep re6st turned off by stopping it to avoid re6st networks merging in Lille office (only stop re6st, never disable it)
Run this script:
Delete bash history and poweroff the ORS
rm -rf .bash_history scripts
Please put labels saying "Do not hot plug/unplug" on the POE connectors before packaging the ORS.
Write down the enclosure serial number. Then put the ORS back in the enclosure box, and fill it with package fillers to protect it during transport.
Arrange the ORS box, RJ45 POE cable, Antennas, N to SMA adaptors and sim cards in the box as shown on the image.
Box dimensions: 370 x 320 x 180 mm , 3.5 kg
Before filling the package with package fillers, please be 100% sure you did all this correctly:
Create the Rapid.Space project with the client name, and transfer all the services and servers in it.
Use the script to send the welcome mail, and include the sale packing list