Feature: User Service Announcement Channel

[davidjwbbc]

Addition of the User Service Announcement Channel to implement the VIA_MBS_DISTRIBUTION_SESSION method of User Service Announcement.

If VIA_MBS_DISTRIBUTION_SESSION is requested as one of the service announcement modes when creating an MBS User Service, then when any of the MBS User Service's User Data Ingest Sessions are completely active then the announcement bundle is created for that User Data Ingest Session and added to the carousel provided by a special MBSTF Distribution Session which transmits the User Service Announcement Channel.

The FLUTE TSI of the User Service Announcement channel is always 1 and the FLUTE TSI of other user requested Distribution Sessions starts from 2.

The other aspects of the User Service Announcement Channel are configured via the mbsf.yaml configuration file using the following parameters:

mbsf:
    userServiceAnnouncement:
      announcementRepetitionTime: 10000
      ssmPort: 3000
      ssmSourceAddress: 127.0.0.67
      ssmDestinationAddress: 232.0.0.1
      mbr: 10 Mbps
      docRoot: <install_dir>/var/cache/mbsf/user-service-announcements
      server:
        - addr: 127.0.0.68
          port: 8888
        - addr: 169.254.10.20
          port: 8888

Key	Use
announcementRepetitionTime	The repetition time in milliseconds used for each announcement bundle in the announcement carousel
ssmPort	The port number used for the announcement carousel FLUTE session
ssmSourceAddress	The source address used for the announcement carousel FLUTE session
ssmDestinationAddress	The multicast destination address for the announcement carousel FLUTE session
mbr	The maximum bit rate of the announcement carousel FLUTE session
docRoot	A storage directory to which User Service Announcement bundle parts are published by the MBSF
server	IP address and port pairs that will be listened to for the co-located MBS AF serving User Service Announcement bundles to clients (MBS Application Provider, MBSTF, MBSF Client)
server/addr	An IP address to listen to
server/port	The port to listen to

This also includes a few bug fixes that never made it into v0.2.0

Closes #7, #28, #30 and #32

This was tested using the following PRs: 5G-MAG/open5gs#38, 5G-MAG/rt-5gc-service-consumers#27 and 5G-MAG/rt-mbs-transport-function#61

[rjb1000]

@davidjwbbc: I think the configuration options for exposure of the MBS User Service Announcement bundles should be under a separate section called mbsaf. For example:

mbsaf:
  - addr: 127.0.0.68
    port: 8888
  - addr: 169.254.10.20
    port: 8888

[davidjwbbc]

Configuration for User Service Announcement Bundle server has been moved to an mbsaf section, e.g.:

mbsaf:
  server:
    - addr: 127.0.0.67
      port: 8888

I left a server sub-level just in case we wish to add any further MBS-AF specific configuration options in future.

[rjb1000]

Thanks for the adjustment to the mbsf.yaml configuration file format. Fine to use a servers section to allow for future expansion.

I just have a couple of suggestions to improve the comments in the example configuration file.

[rjb1000]

Suggested change

	# - addr: 192.168.0.1 # MBS-1 (to AP)
	# - addr: 192.168.0.1 # MBS-1 (to MBS Application Provider)

[rjb1000]

Suggested change

	# - addr: 10.0.45.1 # MBS-5 (to UE)
	# - addr: 10.0.45.1 # MBS-5 (to MBSF Client in UE)