RDK Documentation (Open Sourced RDK Components)
Tuner Reservation Manager (TRM)

Description

Tuner Reservation Manager (TRM) coordinates the usage of tuners on the device for the connected clients on Gateway device and it is specific to Gateway devices only. TRM uses messages for communicating between Gateway and Client device to reserve, cancel, status retrieval, etc.

How TRM works
Client requests a tuner through URL(http, dvr, live), TRM server receives the request and checks for the valid reservation and reserves the tuner so that the client is provided with the service requested. Client also can extend or delete the reservation. It is also possible for a client to request a list of the active reservations.

Usually Xg1 boxes have multiple tuners (in Xg1v3 box has 6 tuners (configurable)) & each tuners can have following states:

State Meaning
Free The Tuner is available for allocation.
Live Currently tuned to a service and in use for viewing the live TV channel.
Record Currently tuned to a service and recording a program.
Hybrid Live view of recording in progress.
EAS Emergency Alert Service.
TRM Consumer
This diagram depicts the different element interact with TRM.
  • The Guide server represent the primary user interface for end user.
  • The user agent and the browser agents represents the local application acts as a client to the guide server.
  • In case of html 5 application, the Browser/Agent would be web browser.
  • The Recorder is an RDK component, it maintain a list of Active, Completed and Schedule of recording.
  • The Scheduler is responsible for communicating with TRM for scheduling the recording (start, stop, pause).
TRM Communication and WebSockets
TRM uses WebSockets to communicate with other components. This diagram represent the running state of the Tuner Reservation Manager(TRM)
The above diagram depicts that how IP client device sends the request to gateway device for TRM service.
  • TRM Server is a process, which starts and listen on a perticular port.
  • TRM Server receives the Tuner reservation request from client device through websocket.
TRM Sequence Diagram

Modules

 TRM Messages
 
 Tuner Activity
 
 Tuner Reservation
 
 Tuner States