fembms.md

@@ -292,6 +292,99 @@ $ ffmpeg -re -i jellyfish-5-mbps-hd-h264.mkv -f rtp_mpegts rtp://10.0.2.2:5000
 $ ffplay rtp://10.0.2.2:5000
 ```
 
+# Use precompiled Docker images
+## eNB/UE/MCE centos.7.6.1810 with UHD v1.15.0
+```bash
+$ sudo docker pull jmorgade/lte-softmodem:1.0.0_centos.7.6.1810
+$ sudo docker pull jmorgade/lte-uesoftmodem:1.0.0_centos.7.6.1810
+$ sudo docker pull jmorgade/mce-softmodem:1.0.0_centos.7.6.1810
+``` 
+## eNB/UE/MCE ubuntu.16.04 with UHD v1.15.0
+```bash
+$ sudo docker pull jmorgade/lte-softmodem:1.0.0_ubuntu.16.04
+$ sudo docker pull jmorgade/lte-uesoftmodem:1.0.0_ubuntu.16.04
+$ sudo docker pull jmorgade/mce-softmodem:1.0.0_ubuntu.16.04
+``` 
+
+## eNB/UE/MCE ubuntu.18.04 with UHD v1.15.0
+```bash
+$ sudo docker pull jmorgade/lte-softmodem:1.0.0_ubuntu.18.04
+$ sudo docker pull jmorgade/lte-uesoftmodem:1.0.0_ubuntu.18.04
+$ sudo docker pull jmorgade/mce-softmodem:1.0.0_ubuntu.18.04
+``` 
+
+## Docker: Run eMBMS mixed UC/MC with RFSIM
+Run following targets. 
+Be aware that two additional `TUN` interfaces will be created: `oaitun_enm1` and `oaitun_uem1`
+Take care you configure the suitable IP addres in <enb-ip> flag. 
+### eNB 
+```bash
+$ sudo docker run --rm --net=host  --cap-add=NET_ADMIN --name fembms-enb
+ --device /dev/net/tun:/dev/net/tun --device /dev/bus/usb/:/dev/bus/usb/ -it --privileged
+ --env RFSIMULATOR=enb 
+jmorgade/lte-softmodem:1.0.0_ubuntu.16.04 ran_build/build/lte-softmodem
+-O ../ci-scripts/conf_files/enb.band17.tm1.mbms.25PRB.usrpb210.conf --noS1 --nokrnmod 1 
+--eNBs.[0].component_carriers.[0].eutra_band 7
+--eNBs.[0].component_carriers.[0].downlink_frequency 2680000000
+--eNBs.[0].component_carriers.[0].uplink_frequency_offset -120000000
+ --eNBs.[0].component_carriers.[0].N_RB_DL 25 
+--eNBs.[0].component_carriers.[0].mbms_dedicated_serving_cell ENABLE
+ --eNBs.[0].enable_enb_m2 yes
+--MCEs.[0].enable_mce_m2 yes
+ --MCEs.[0].enable_mce_m3 yes
+--MMEs.[0].enable_mme_m3 yes
+--eNBs.[0].NETWORK_INTERFACES.ENB_IPV4_ADDRESS_FOR_M2C "127.0.0.2/24"
+--eNBs.[0].target_mce_m2_ip_address.[0].ipv4 "127.0.0.7"
+--MCEs.[0].mbms_sched_info.mbms_area_config_list.[0].pmch_config_list.[0].allocated_sf_end 1024
+--rfsim
+```
+### UE 
+```bash
+$ sudo docker run --rm --net=host  --cap-add=NET_ADMIN --name fembms-ue
+ --device /dev/net/tun:/dev/net/tun 
+--device /dev/bus/usb/:/dev/bus/usb/
+ -it --privileged --env RFSIMULATOR=ip_enb 
+jmorgade/lte-uesoftmodem:1.0.0_ubuntu.16.04 ran_build/build/lte-uesoftmodem
+ -C 2680000000 -r 25 --ue-rxgain 120 --ue-txgain 0 --ue-max-power 0 --ue-scan-carrier
+ --nokrnmod 1 
+--noS1 –rfsim 
+```
+## Docker: Run FeMBMS eNB dedicated BC with USRP Band7
+Run following targets. 
+Be aware that two additional `TUN` interfaces will be created: `oaitun_enm1` and `oaitun_uem1`
+
+### eNB 
+```bash
+$ sudo docker run --rm --net=host  --cap-add=NET_ADMIN --name fembms-enb
+ --device /dev/net/tun:/dev/net/tun --device /dev/bus/usb/:/dev/bus/usb/
+ -it --privileged
+jmorgade/lte-softmodem:1.0.0_ubuntu.16.04 ran_build/build/lte-softmodem
+-O ../ci-scripts/conf_files/enb.band17.tm1.mbms.25PRB.usrpb210.conf 
+--noS1 --nokrnmod 1
+--eNBs.[0].component_carriers.[0].eutra_band 7
+--eNBs.[0].component_carriers.[0].downlink_frequency 2680000000
+--eNBs.[0].component_carriers.[0].uplink_frequency_offset -120000000
+--eNBs.[0].component_carriers.[0].N_RB_DL 25 
+--eNBs.[0].component_carriers.[0].mbms_dedicated_serving_cell ENABLE
+--eNBs.[0].enable_enb_m2 yes
+--MCEs.[0].enable_mce_m2 yes
+--MCEs.[0].enable_mce_m3 yes
+--MMEs.[0].enable_mme_m3 yes
+--eNBs.[0].NETWORK_INTERFACES.ENB_IPV4_ADDRESS_FOR_M2C "127.0.0.2/24"
+--eNBs.[0].target_mce_m2_ip_address.[0].ipv4 "127.0.0.7"
+--MCEs.[0].mbms_sched_info.mbms_area_config_list.[0].pmch_config_list.[0].allocated_sf_end 512
+```
+### UE 
+```bash
+$ sudo docker run --rm --net=host  --cap-add=NET_ADMIN --name fembms-ue
+--device /dev/net/tun:/dev/net/tun 
+--device /dev/bus/usb/:/dev/bus/usb/  
+-it --privileged 
+jmorgade/lte-uesoftmodem:1.0.0_ubuntu.16.04 ran_build/build/lte-uesoftmodem
+-C 2680000000 -r 25 --ue-rxgain 120 --ue-txgain 0 --ue-max-power 0 --ue-scan-carrier
+--nokrnmod 1 --noS1 
+```
+
 # Known issues
 
 1.  UE FeMBMS requires further work to make the initial PSS sync and PBCH detection much more reliable. This is mainly relevant for UE working with USRP.