- Web Site: https://www.irisbroadcast.org
- Github: https://github.com/irisbroadcast
This is the code for the IRIS Codec Call Manager and Discovery service developed by Sveriges Radio AB in Sweden. This code has been in production for many years and we're proud to share it with a larger community!
Finally the code base is converted to .NET Core. Now we can run it fully containerised and on any OS. This is a big change and improvement. There is still some work to be done in the "testing" part, Tests and UnitTests project.
The code is licensed using the BSD 3-clause license.
If you like to contribute documentation, local translations or code you are more than welcome with a pull request on github.com.
The application might work on anything higher than these versions, but it's not tested yet.
- Minimum support and tested MySQL 8
- Visual Studio 2022
(If you want codec control, set up that project separetely.)
- Open the Visual Studio solution and get the nuget packages required.
- The application is built as follows:
- CCM.Core: The core of the IRIS CCM platform.
- CCM.Data: Module for data storage.
- CCM.Web: The web user interface (Base application)
- CCM.Frontpage: Frontend JavaScript/Typescript components.
- CCM.DiscoveryApi: The IRIS discovery service (Discovery application)
- CCM.Tests/Tests: Unit and integration tests, Note: The unit tests are in working shape.
- Set up the database of choice, instructions here database setup
- Run the application
- Set up messages from your SIP-registrar (e.g Kamailio) to start recieving data at your endpoint. Check out the IRIS Connect for Kamailio settings.
IRIS CCM and Discovery Service is (C) Sveriges Radio AB, Stockholm, Sweden 2017-2022 The code is licensed under the BSD 3-clause license.
The license for CCM is in the LICENSE.txt file
The repository contains 3rd party javascript libraries that are included for convience. In a future release, these will not be included but downloaded by scripts. These libraries have their own copyright and licenses.
CCM is a platform for administration and management of an ACIP-compliant SIP codec infrastructure for live radio broadcast.
CCM consists of a web application, a web service and a windows service built with Microsoft .NET framework in C# storing data in a MySQL or MariaDB database. Authentication for SIP is stored in a database. The CCM interacts and manages accounts in the database.
In production use, the CCM is by default running on two separate servers in different data centers. Data is replicated using MySQL replication. Kamailio updates both CCM servers with current registration and call states. At the moment these two columns are not replicated, this should be added.
Load balancing between the two CCM servers can be done with external HTTP load balancers, using DNS or virtual IP failover.
The web interface provides an overview of available (and registered) devices as well as current broadcast sessions. A user can view registration IP addresses, device types and for some devies, manage the device in the CCM. When searching, filters based on region, type of device or other criteria may be applied.
When logging in as an administrator, account management is available - both CCM web log ins as well as SIP accounts.
The IRIS discovery services, also known by the name "Active Phonebook", is used by the connected devices to find other available devices to set up a live session. The service has three main functions:
- Profiles: List available call profiles (Profiles is SDP's)
- Filters: List available pre-defined search filters (Based on location filters on IP-ranges)
- Devices: List available devices based on applied filters and profiles
All functions require a valid authentication.
The main power is the abstraction layer it provides. Users doesn't need to know what an SDP (Session Description Protocol) is. They don't need to choose what algorithm to use for the call. The system provides what it thinks is the best selection for the current situation/call. Users can filter registered callees, in a similar way as a simplified "GraphQL" type of query. The simplicity of the protocol, xml based with JSON response if so needed. It can be implemented in most devices or in online applications för making calls and simplifying the process for those less technical.
Combine this Active Phonebook with Codec Control and you can create a unified graphical user interfsce.
For IRIS CCM to start recieving information, you need to set up a SIP-Registrar. Today there is a configuration available for Kamailio. Please see the separate IRIS project for Kamailio configuration Github.com/irisbroadcast/Connect
The codec control has become a powerful addition to CCM. Enabling the same user interface regardless of what codec the user controls. This was formerly integrated into CCM. But now it's a separate project. It uses CCM for discovery and management of devices. Codec control is written in dotnet core. So this should enable you to run it on a linux platform as well. Github.com/irisbroadcast/CodecControl
- Please open an issue on Github