Hyper Open Edge Cloud

ORS Assembly Process

  • Last Update:2022-01-07
  • Version:002
  • Language:en

Agenda

  • SDR main board installation
  • PC installation
  • PC to SDR main board connections
  • OS and software installation
  • Install Services
  • ORS packaging

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

Take out BJT Case 

Tack out the BJT case from the cardboard 

Open the enclosure 

Use a hexagonal screwdriver to remove the 8 screws from the cover of BJT case to open it.

 

Apply thermal interfaces

Apply thermal interfaces

Install the SDR main board

Install the SDR main board with M2.5 screws * 17.  Please do not set the screws tightly at the beginning, until all the screws are placed, and then tighten them all.

Connect the LED wires

Connect the LED wires in a PTSM connector and plug this connector in the SDR main board.

Strip and tin around 4mm of the red and black cable. Be careful to close the ORS lid while cutting excess metal wire, as small metal bits landing on PCB could break it. Use a sim card ejector or tweezers to insert the connector into the smaller port to allow the LED wire to be inserted into the port below. After inserting the LED wire tightly, pull out the tweezers and verify that the LED wire is inserted tightly.

Make sure that the red and black wires of the LED are plugged in as shown.

Plug the first RJ45 cable

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.

Remove the plastic films

Please remove the plastic films before you plug the coax cables. 

Plug 3 RF coax cables

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.

Paste SBC(PC) on the enclosure

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 PC

Install the DDR4 SODIMM, the MSATA SSD and the PCI Express adaptor board.

Set the jumpers on the SBC

Set the jumpers on the SBC.

Connect power cable to the SBC

Cut a red and black wire of 23cm, and strip and tin around 4mm at each side. Again, be careful to do this away from the PCB or PC to avoid metal bits creating short-circuits.

Please put the enclosure with SBC and the other side on the same plane like the figure shown. Connect the 2192Y power cable to the SBC.

Connect the power cable between PTSM and SDR

Connect the power cable in a PTSM connector and plug this connector in the SDR main board. 

Connect ribbon FFC

Connect the ribbon FFC between the PCI Express adaptor board and the SDR main board.

Connect the second RJ45 cable

Connect the second RJ45 cable between the SBC and the SDR main board.

Prepare to install OS and software

Connect a USB flash drive, an HDMI monitor, a keyboard and a PoE cable connected to the power supply (minimum 50 W, any voltage from 24 to 54 VDC) to install the OS and software

Install OS

Install Ubuntu 20.04 by downloading the "64-bit PC (AMD64) server install image" iso image here, and then copying it to an USB disk. You can use dd to copy the iso:

dd if=iso_image_path of=/dev/usb_device bs=1M status=progress;sync

During the installation, you should choose these options:

  • language: English
  • keyboard: chose depending on your keyboard
  • Use entire disk
  • No LVM
  • hostname : orsXXX # replace XXX with the number
  • username, password: slapos
  • Install OpenSSH server
  • No snap to install

Connect through SSH

Once the installation is complete and you have rebooted after removing the USB key, the next steps can be done through SSH. To find the IP of the ORS computer, you can use the following command:

sudo nmap -T4 -sP network_ip/prefix_length |grep -B2 Taiwan

Once you have the ip, you can connect to the ORS computer through SSH:

ssh slapos@ors_ip
Password: slapos

Setup SSH

Copy ORS team SSH keys in root/.ssh/authorized_keys and /home/slapos/.ssh/authorized_keys:

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQDzN0Ii+ZU3aaBZE74o7jWC22BuT0AFW0zwbYITv5boMcn+Rl1jR2tQ20oHv9+ikP1+AuJ2rUJ0Zpp3kclKOv8Ay3IE1VdVGNqiAakCS2l3DsNYBFkZx7ofMRMBP9ZLfpgQQS8r9ULMFvcgE4QoJwZE238l7RtcvZEddpCQpFD0ZAKzE3Na43cdrdr2An7jY0TgGNkqpiunu5IB6a/v+F0f34Z3d83EUlUbB9xJpMs6X/ssgzeN+8+7FpscnajnZoRPKnhP2ds+OzTirXj3qlpPoRUneDwU1ys7BHqQvpXw9cEZnr4UGc1oWuxR3dgZ5bSQW4Jn8lt8T2fGw2FflXTTeI0u5+hvpzfRwASB9x+voowVYS3FaiV2GdfmZ7NgU5uDdeRt5V7zEY3I6Uti0q3z9VddMqSZIjlX7BTlvU25ZTrjOn+5pXIcEjpTlJeCLjHMKbL42/demQ3PImnClEu3mQlfQ1r2u7cz5BYlKZ9DELUMCavqeZ2ZixfYn7tO/CWgcAdKT7JsssHSECFv+6tJpJzbW6yaoXKUzPiQmwiO1V75zZ8Pic6OT16VFQ4qnHP94p3wa6ZtdoDPujlKXHAyf0RmvrXm6uhuSCrwjzwpTnvW7Vh12UqumEBO0fFGi47XazKH1FEd0dCIttsgIZtI7WZLWf2bcUJbLuUqIcQ/Lw== lu.xu@nexedi.com
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC5MAMmMmojqNRoOnGc7xGoJWWAzYo2f2zO2K4elsZhHfG6l2SQJTmna0DuUi8qEtBbA9+TN1HAOeEXQKMsQyydG8dAE9vT41Lj5y8kXQDDquQxcpTIrqjmSqxjG42Olk+sT+XvcdyqA//29OHhhrKdhIf9LAOsIPHDYW06hRMf7kXIgt3MNi8ayPpA9coTHIscvV8MzwbF2q8Owrkj5UpPmSd/cjmFTcijT3rXmN0E1d3lrCvIuqxFBsFB47o0q53rFZMc5HoHQjJbg6dB4E0GNT0Ujl9ZaIDEzQbe1/T5BVWXrwDfYXbj8UlqtXeFQlo2dB+au2tHw56s4boqDxIl thomas.gambier@nexedi.com
ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQC9Q65j4/VhrU+bCLbQVclROocQuVfH7cvb1347ELV6PTO9tqN6avYSIRuY+OyHpbLSs073uAGavpn2fEobkPK8IRj2ja6idlXSJrVnxpvqLqICkxOc9iCn2BrQkma2elgjIW+UG/cU1HMoWJZj3xQieohswJ+1LhAdUNaeNQsFupROWXMOH1KMWgbJYGuFY9huNXusCemSAfpGWvIWkujWk/Zt23t9C9sPzUjX2PQk2pr6LqCcvqTbwV85KAbQsMlF5x4hj+MuWIFK/FYJofK4qUYOdJNBiXyuxkvBqwozpW+FEDOacLbHQs03OTufBmygbWIwnYa8OqPKYJMS9YlTgqjECBfXBueL/MpVX+0bHXU2tNCSg63I6R8FgIALeqGbiB171rjRHMqO2ihZlbhvLDxEZoSUZubeejMw7pJHH3rWtpW78+iY/RmB6nSOGK7tFNs33sNLx6idpekd4Vehjnkf8CHdoRhvsVAAK6dZJRukpNoAW1fd7RErxqviqJOQPkc0l1O2IYXhMzB65a89QYhrggWpuvVj1txUpalryvxOeFaAJP42ejDY1VYR/fz259Pp/JZopFNIne5xbH1I8CpXQu0QKwLTe/amitlXD3O6aXaldT4QF+6rNVrSBZuUEycKmIC0bOYi+qJoNtk0FUmIlq1NZo6IRLpzQ9K52Q== johan.huge@nexedi.com

Put correct permissions on .ssh and .ssh/authorized_keys:

chmod 700 .ssh && chmod 644 .ssh/authorized_keys

Configure network with ifupdown

apt install ifupdown

Place the following script inside /etc/network/interfaces

auto lo
iface lo inet loopback

auto enp0s31f6
iface enp0s31f6 inet dhcp
        post-up echo 1 > /proc/sys/net/ipv4/conf/all/forwarding
        post-up iptables -t nat -A POSTROUTING -o enp0s31f6 -j MASQUERADE


auto enp2s0
iface enp2s0 inet dhcp
        post-up echo 1 > /proc/sys/net/ipv4/conf/all/forwarding
        post-up iptables -t nat -A POSTROUTING -o enp2s0 -j MASQUERADE

 

If you need to add another re6st IPv6 on lo:

auto lo lo:0
iface lo inet loopback
iface lo:0 inet6 static
        address <re6st-ip>
        netmask <re6st-netmask>

 

apt remove --purge netplan.io
apt remove --purge networkd-dispatcher

Edit /etc/dhcp/dhclient.conf and set timeout to 15 instead of 300

Close the ORS

Disconnect the USB flash drive, the HDMI monitor, the keyboard and the PoE cable. Close the enclosure and reconnect the PoE cable to start the system.

Place Labels on the ORS

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

Upgrade And fix Ubuntu 

apt update
eatmydata apt dist-upgrade
apt remove snapd irqbalance
apt install net-tools


Fix kernel parameter

edit the file /etc/default/grub to put the line

GRUB_CMDLINE_LINUX_DEFAULT="idle=halt"

Then, you should update grub with:

update-grub

Patch the FPGA so that it is visible by the PC

Make sure the FPGA is not yet visible

lspci | grep Xilin

if the FPGA is already there no need for this procedure
Put flash-trxsdr.tgz on the ORS computer:

wget https://www.erp5.com/rapidspace-ORS.Assembly.Process.Flash.TRXSDR/Base_download

Patch the FPGA:

tar -xzvf flash-trxsdr.tgz
cd flash-trxsdr/
rm -rf openocd.tar.gz
apt-get install git libtool automake pkg-config libusb-dev libftdi-dev libusb-1.0-0-dev build-essential
git clone
https://github.com/openocd-org/openocd openocd
cd openocd
git checkout v0.11.0
./bootstrap
./configure --enable-ftdi
make -j 4
cd ..
./openocd/src/openocd -s ./openocd/tcl -f pcie_radio.cfg

Hard reset the box (totally power off, then power on)
Check the FPGA is visible to make sure everything is OK

Install Amarisoft licences

To install the licenses, the host ID of the ORS is needed. To get the host ID, you can install and lauch lte amarisoft software (TODO: find a faster way)

Remove all previous software if any:

rm -rf lteenb* trx_sdr* mme ots mbms enb

tar -xzvf amarisoft.2021-09-18.tar.gz
cd 2021-09-18/ 

./install.sh --default

Wait (very long, no output)
Hard reboot

Get the Host ID of the ORS by launching lte and going in the screen.

Then, get the corresponding licenses: rapidspace-ORS.Assembly.Process.Amarisoft.License

On the board as root:

mkdir ~/.amarisoft
copy lteenb.key and ltemme.key in ~/.amarisoft

Test the licences by launching again lte.

Install Amarisoft stack

To install amarisoft stack using the ors-amarisoft slapos software release, please follow this tutorial:

ORS Assembly Process - Install software release

To install amarisoft stack for a root access installation, please follow this tutorial:

ORS Assembly Process - Install Amarisoft with root access

 

Package the ORS

/mme/config# less ue_db-ims.cfg


Take the polystyren board on which the case handle is placed, and cut the top half in order to make it thin, in order to fit everything. Place the ORS in the box, with the polystyren separation you just cut above. Unscrew the antenna's base, otherwise it won't fit. Place evertyhing as shown on the image. (TODO: take picture with N to SMA adaptors and SIM cards)