{{docname|STBService:1.4 Service Object}} {{appdate|August 2015}} Added objects for Service Monitoring of Events A non-volatile handle used to reference this instance. '''This is intended only for use in protocol-independent "common" definitions, and MUST NOT be used in protocol-specific definitions.''' A non-volatile handle used to reference this instance. Alias provides a mechanism for an ACS to label this instance for future reference. If the CPE supports the Alias-based Addressing feature as defined in {{bibref|TR-069|3.6.1}} and described in {{bibref|TR-069|Appendix II}}, the following mandatory constraints MUST be enforced: * Its value MUST NOT be empty. * Its value MUST start with a letter. * If its value is not assigned by the ACS, it MUST start with a "cpe-" prefix. * The CPE MUST NOT change the parameter value. IP address, i.e. IPv4 address (or IPv4 subnet mask) or IPv6 address. All IPv4 addresses and subnet masks MUST be represented as strings in IPv4 dotted-decimal notation. Here are some examples of valid IPv4 address textual representations: * 216.52.29.100 * 192.168.1.254 All IPv6 addresses MUST be represented using any of the 3 standard textual representations defined in {{bibref|RFC4291}} Sections 2.2.1, 2.2.2 and 2.2.3. Both lower-case and upper-case letters can be used, but use of lower-case letters is RECOMMENDED. Here are some examples of valid IPv6 address textual representations: * 1080:0:0:800:ba98:3210:11aa:12dd * 1080::800:ba98:3210:11aa:12dd * 0:0:0:0:0:0:13.1.68.3 IPv6 addresses MUST NOT include zone identifiers. Zone identifiers are discussed in {{bibref|RFC4007|Section 6}}. Unspecified or inapplicable addresses (or IPv4 subnet masks) MUST be represented as empty strings unless otherwise specified by the parameter definition. Universally Unique Identifier. See {{bibref|RFC4122}}. 3GPP TS 23.003 Numbering, addressing and identification 3GPP CT WG4 https://www.3gpp.org/ftp/Specs/html-info/23003.htm Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority Guidelines for 64-bit Global Identifier (EUI-64) Registration Authority IEEE March 1997 https://standards.ieee.org/regauth/oui/tutorials/EUI64.html IANA Uniform Resource Identifier (URI) Schemes Registry Uniform Resource Identifier (URI) Schemes IANA https://www.iana.org/assignments/uri-schemes RFC 1350 The TFTP Protocol (Revision 2) IETF RFC https://www.rfc-editor.org/rfc/rfc1350 http://www.ietf.org/rfc/rfc1350.txt RFC 2228 FTP Security Extensions IETF RFC https://www.rfc-editor.org/rfc/rfc2228 http://www.ietf.org/rfc/rfc2228.txt RFC 2326 Real Time Streaming Protocol (RTSP) IETF RFC https://www.rfc-editor.org/rfc/rfc2326 http://www.ietf.org/rfc/rfc2326.txt RFC 2960 Stream Control Transmission Protocol (SCTP) IETF RFC https://www.rfc-editor.org/rfc/rfc2960 http://www.ietf.org/rfc/rfc2960.txt RFC 3066 Tags for the Identification of Languages IETF RFC https://www.rfc-editor.org/rfc/rfc3066 RFC 3376 Internet Group Management Protocol (IGMP) Version 3 IETF RFC https://www.rfc-editor.org/rfc/rfc3376 http://www.ietf.org/rfc/rfc3376.txt RFC 3550 RTP: A Transport Protocol for Real-Time Applications IETF RFC July 2003 https://www.rfc-editor.org/rfc/rfc3550 http://www.ietf.org/rfc/rfc3550.txt RFC 3986 Uniform Resource Identifier (URI): Generic Syntax IETF RFC https://www.rfc-editor.org/rfc/rfc3986 RFC 4007 IPv6 Scoped Address Architecture IETF RFC https://www.rfc-editor.org/rfc/rfc4007 RFC 4078 The TV-Anytime Content Reference Identifier (CRID) IETF RFC https://www.rfc-editor.org/rfc/rfc4078 http://www.ietf.org/rfc/rfc4078.txt RFC 4122 A Universally Unique IDentifier (UUID) URN Namespace IETF RFC 2005 https://www.rfc-editor.org/rfc/rfc4122 RFC 4291 IP Version 6 Addressing Architecture IETF RFC 2006 https://www.rfc-editor.org/rfc/rfc4291 RFC 4340 Datagram Congestion Control Protocol (DCCP) IETF RFC https://www.rfc-editor.org/rfc/rfc4340 http://www.ietf.org/rfc/rfc4340.txt RFC 4585 Extended RTP Profile for Real-time Transport Control Protocol (RTCP)-Based Feedback (RTP/AVPF) IETF RFC https://www.rfc-editor.org/rfc/rfc4585 http://www.ietf.org/rfc/rfc4585.txt RFC 4588 RTP Retransmission Packet Format IETF RFC https://www.rfc-editor.org/rfc/rfc4588 http://www.ietf.org/rfc/rfc4588.txt RFC 4632 Classless Inter-domain Routing (CIDR): The Internet Address Assignment and Aggregation Plan IETF 2006 https://www.rfc-editor.org/rfc/rfc4632 RFC7159 The JavaScript Object Notation (JSON) Data Interchange Format IETF RFC March 2014 https://www.rfc-editor.org/rfc/rfc7159 RFC 7230 Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing IETF RFC June 2014 https://www.rfc-editor.org/rfc/rfc7230 RFC 7252 The Constrained Application Protocol (CoAP) IETF RFC June 2014 https://www.rfc-editor.org/rfc/rfc7252 RFC 8141 Uniform Resource Names (URNs) IETF RFC April 2017 https://www.rfc-editor.org/rfc/rfc8141 TR-069 Amendment 6 CPE WAN Management Protocol Broadband Forum TR April 2018 TR-106 Amendment 1 Data Model Template for TR-069-Enabled Devices Broadband Forum TR November 2006 TR-135 Amendment 3 Data Model for a TR-069 Enabled STB Broadband Forum Technical Report November 2012 TR-140 TR-069 Data Model for Storage Service Devices Broadband Forum Technical Report https://www.broadband-forum.org/download/TR-140.pdf Simple Object Access Protocol (SOAP) 1.1 W3C https://www.w3.org/TR/2000/NOTE-SOAP-20000508 SSH File Transfer Protocol https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer http://tools.ietf.org/wg/secsh/draft-ietf-secsh-filexfer ZigBee 2007 Specification ZigBee 2007 Specification ZigBee Alliance October 2007 https://csa-iot.org/all-solutions/zigbee ETSI TS 102 034 Digital Video Broadcasting (DVB); Transport of MPEG-2 Based DVB Services ETSI ISO/IEC 11172-1 (1993) Information Technology - Coding of moving pictures and associated audio for digital storage media at up to about 1.5 Mbit/s - Part 1: System ISO/IEC 1993 ISO/IEC 11172-3 (1993) Information Technology - Coding of moving pictures and associated audio for digital storage media at up to about 1.5 Mbit/s - Part 3: Audio ISO/IEC 1993 ISO/IEC 13818-1 (2nd edition, 2000) Information technology - Generic coding of moving picture and associated audio information: Systems ISO/IEC 2000 ISO/IEC 13818-3 (2nd edition, 1998) Information technology - Generic coding of moving picture and associated audio information: Audio ISO/IEC 1998 ISO/IEC 13818-6 (2nd edition, 1998) Information technology - Generic coding of moving picture and associated audio information: Extensions for DSM-CC ISO/IEC 1998 ISO/IEC 14496-3:2001 Information technology - Coding of Audio-Visual objects - Part 3: Audio ISO/IEC 2001 ISO/IEC 23003-1:2007 Information technology - MPEG audio technologies - Part 1: MPEG Surround ISO/IEC 2007 ITU-T Rec. H.264 | ISO/IEC 14496-10:2004/AM 1, Part 10 Advanced Video Coding AMENDMENT 1: AVC fidelity range extensions ISO/IEC 2004 DGTVi D-Book v1.0 Compatible receivers for the Italian market Sep 2004 SMPTE 20022-1 Application Layer Forward Error Correction E-AC-3 Digital Audio Compression (AC-3) Standard, Rev. B, document number A/52B ATSC June 2005 SMPTE VC-1 Compressed Video Bitstream Format and Decoding Process, document number 421M SMPTE, Television 2006 ETSI TS 102 323 Digital Video Broadcasting (DVB); Carriage and signalling of TV-Anytime information in DVB transport streams ETSI S/PDIF Sony/Philips Digital InterFace IEC-958 IEC HDMI High-Definition Multimedia Interface 1.4a March 2010 Number of entries in the {{object|STBService}} table. The top-level object for an STB CPE. Enables or disables this {{object}} instance. {{datatype|expand}} The overall capabilities of the STB CPE. This is a constant read-only object, meaning that only a firmware update will cause these values to be altered. Maximum number of simultaneously active AV streams supported by the STB. A value of -1 indicates no specific limit on the number of active streams. A value of 0, while not strictly illegal, would indicate an STB that doesn't support AV streams, which is extremely unlikely. Maximum number of simultaneously active AV players supported by the STB. An AV player is associated with a presentation device (such as a TV set). Note that this is the strict maximum but, depending on the AV streams to be decoded, a given STB may not always have the resources to run all of these AV players, e.g. it might be able to decode one main picture and one PIP in standard definition, but just a main picture and no PIP in high definition. A value of -1 indicates no specific limit on the number of active players. A value of 0, while not strictly illegal, would indicate an STB that doesn't support AV players, which is extremely unlikely. Front-end capabilities. Capabilities of the DVB-T receiver. Maximum number of simultaneous active AV streams supported by the DVB-T FrontEnd. A value of -1 indicates no specific limit on the number of active streams. Maximum number of logical channels that can be contained in a Service List Database. A value of -1 indicates no specific limit on the number of logical channels. IP front-end capabilities. Maximum number of simultaneous active AV streams supported by the IP FrontEnd. A value of -1 indicates no specific limit on the number of active streams. Maximum number of simultaneous active Inbound AV streams supported by the IP FrontEnd. A value of -1 indicates no specific limit on the number of active streams. Maximum number of simultaneous active Outbound AV streams supported by the IP FrontEnd. A value of -1 indicates no specific limit on the number of active streams. Supported streaming control protocols. supports RTSP {{bibref|RFC2326}} supports IGMPv1 {{bibref|RFC3376}} supports IGMPv2 and lower versions {{bibref|RFC3376}} supports IGMPv3 and lower versions {{bibref|RFC3376}} supports DSM-CC {{bibref|ISO/IEC13818-6}} Network protocols supported for AV streaming. {{bibref|RFC2960}} {{bibref|RFC4340}} {{bibref|RFC3550}} Transport control protocols supported for AV streaming in combination with RTP. supports sending RTCP receiver reports as defined in {{bibref|RFC3550}} as defined in {{bibref|RFC4585}} and {{bibref|RFC4588}} as defined in {{bibref|SMPTE20022-1}} Network protocols supported for AV download. FTP/SSL {{bibref|RFC2228}} SSH file transfer protocol {{bibref|SSH-FTP}} {{bibref|RFC1350}} AV multiplex types supported by the front end. {{bibref|ISO/IEC11172-1}} {{bibref|ISO/IEC13818-1}} {{bibref|ISO/IEC13818-1}} {{bibref|ISO/IEC13818-1}} Describes the maximum de-jittering buffer size, in {{units}}, supported by the STB. A value of -1 indicates no specific limit on the buffer size. PVR capabilities. Maximum number of AV streams that the PVR can simultaneously record and playback. For example a time shift, consisting of a record and a play back is considered as 2 streams. A value of -1 indicates no specific limit on the number of streams. Maximum number of AV streams that the PVR can simultaneously record. A value of -1 indicates no specific limit on the number of streams. Maximum number of AV streams that the PVR can simultaneously play back. A value of -1 indicates no specific limit on the number of streams. Maximum time delay, in {{units}}, that the PVR time-shift mode can support. A value of -1 indicates no specific limit on the time delay. Audio decoder capabilities. Audio standards supported by this STB. {{bibref|ISO/IEC11172-3}} {{bibref|ISO/IEC11172-3}} {{bibref|ISO/IEC13818-3}} {{bibref|ISO/IEC13818-3}} Low Complexity {{bibref|ISO/IEC13818-3}} Low Complexity {{bibref|ISO/IEC14496-3}} Main Profile {{bibref|ISO/IEC14496-3}} Scalable AAC {{bibref|ISO/IEC14496-3}} High Efficiency Profile Level 2 {{bibref|ISO/IEC14496-3}} {{bibref|ISO/IEC23003-1}} Dolby Digital (AC-3) {{bibref|AC-3}} Dolby Digital Plus {{bibref|AC-3}} Digital Theatre System Video decoder capabilities. Video standards supported by this STB. {{bibref|ISO/IEC13818-1}} {{bibref|ISO/IEC13818-6}} Same as MPEG4 AVC and H.264 {{bibref|ISO/IEC14496-10}} {{bibref|VC-1}} Object describing the set of supported MPEG2 profiles and levels for this STB. It also describes the set of audio standards supported when MPEG2 Part 2 is used as the video standard. Audio Standards supported by the Player when associated with MPEG2 Part 2 Video. Number of instances of {{object|ProfileLevel}}. Table to describe the set of profiles and levels combinations supported by the STB when MPEG2 Part 2 is used as video standard. {{keys}} The table MUST include a distinct entry for each supported combination of these parameters. {{datatype|expand}} Identifier of the MPEG2 Part 2 profile. Simple Profile Main Profile SNR Scalable Spatially Scalable High Profile Identifier of the MPEG2 part 2 level. Low Level Main Level High-1440 High Level The maximum decoding capability for this video standard in {{units}}. This strictly depends on the profile and level selected. Object describing the set of supported profiles and levels for this STB. It also describes the set of audio standards supported when MPEG4 Part 2 is used as the video standard. Audio Standards supported by the Player when associated with MPEG4 Part 2 video. Number of instances of {{object|ProfileLevel}}. Table to describe the set of profiles and levels combinations supported by the STB when MPEG4 Part 2 is used as video standard. {{keys}} The table MUST include a distinct entry for each supported combination of these parameters. {{datatype|expand}} Identifier of the MPEG4 Part 2 profile. Identifier of the MPEG4 Part 2 level. The maximum decoding capability for this video standard in {{units}}. This strictly depends on the profile and level selected. Object describing the set of supported profiles and levels for this STB. It also describes the set of audio standards supported when MPEG4 Part 10 is used as the video standard. Audio Standards supported by the Player when associated with MPEG4 Part 10 video. Number of instances of {{object|ProfileLevel}}. Table to describe the set of profiles and levels combinations supported by the STB when MPEG4 Part 10 is used as video standard. {{keys}} The table MUST include a distinct entry for each supported combination of these parameters. {{datatype|expand}} Supported MPEG4 Part 10 profiles. Supported MPEG4 Part 10 Levels. The maximum decoding capability for this video standard in {{units}}. This strictly depends on the profile and level selected. Object describing the set of supported SMPTE-VC-1 profiles and levels for this STB. It also describes the set of audio standards supported when SMPTE-VC-1 is used as the video standard. Audio Standards supported by the Player when associated with SMPTE-VC-1 video. Number of instances of {{object|ProfileLevel}}. Table to describe the set of profiles and levels combinations supported by the STB when SMPTE-VC-1 is used as video standard. {{keys}} The table MUST include a distinct entry for each supported combination of these parameters. {{datatype|expand}} Identifier of the SMPTE-VC-1 profile. Simple Profile Main Profile Advanced Profile Identifier of the SMPTE-VC-1 level. Low Level Medium Level High Level Advanced Profile only Advanced Profile only Advanced Profile only Advanced Profile only Advanced Profile only The maximum decoding capability for this video standard in {{units}}. This strictly depends on the profile and level selected. Audio output capabilities. The audio output stage may include selecting output formats, selecting output connectors, and copy protection. Supported audio output formats. {{enum}} Note that these refer to supported output formats and not to physical connectors. modulated analog signals on coax Video output capabilities. The video output stage may include selecting output formats, selecting output connectors, and copy protection. Analog composite video standards supported for video output. This applies only to CVBS video output. Supported video output formats. {{enum}} Note that these refer to supported output formats and not to physical connectors. same as Y/C RGB with Sync on Green RGB with external Sync modulated analog signals on coax Supported version of Macrovision digital content protection standard. Supported version of HDCP digital content protection standard. Each entry is a supported display format and MUST be in the form of “x:y”, such as for example “4:3, 16:9, 14:9". {{nopattern}} {{nopattern}} This object describes the characteristics of the HDMI interface, if any. Video resolutions supported for the HDMI video output. {{enum}} Indicates whether the STB is supporting HDMI-CEC features as described in {{bibref|HDMI}}. Indicates whether the STB is supporting the 3D video formats mandated by {{bibref|HDMI}}. This object describes the characteristics of the Content Download System, if any. Capability of providing a CDS Push service for the operator initiated download of content items to local storage via a broadband IP connection. Capability of providing a CDS Pull service for the user initiated download of content items to a local storage via a broadband IP connection. This object describes the characteristics of the Conditional Access, if any. Unique identifiers (e.g. commercial names) of supported CA systems. This object describes the characteristics of the Digital Rights Management, if any. Unique identifiers (e.g. commercial names) of supported DRM systems. This object describes the capabilities of the {{object|.ServiceMonitoring}} object. Supported service types, each of which relates to an AV stream source. {{enum}} Note that none of the standard service types cover LAN-sourced IP streams. WAN-sourced IPTV stream WAN-sourced VoD stream WAN-sourced IP stream (includes IPTV and VoD WAN-sourced Force monitoring IP stream from {{param|.Components.FrontEnd.{i}.IP.ForceMonitor.URI}} (either IPTV or VoD). Any WAN-sourced IP stream (includes user and force monitoring streams, IPTV and VoD). Cable, e.g. DVB-C, Front End stream DTT, e.g. DVB-T, Front End stream Satellite, e.g. DVB-S, Front End stream PVR play-out stream Maximum number of AV Main streams for which the STB can simultaneously collect statistics. A value of -1 indicates no specific limit on the number of active streams. Minimum sample interval in {{units}} that the STB MUST be able to support. A value of -1 indicates no specific minimum sample interval. Maximum number of samples of each statistic that the STB is able to store and report. A value of -1 indicates no specific maximum number of samples. The names of the supported high-level metrics. If a metric produces several different scores (e.g. an audio, a video, and an audiovisual score), then they MUST be explicitly named. Example (using "XYZ" as the name of the base metric): "XYZAudio,XYZVideo,XYZAudiovisual". Maximum number of events of each applicable statistic that the STB is able to store for each sample interval. A value of -1 indicates no specific maximum number of events. Maximum number of event log entries that the STB is able to record for a MainStream object instance. This object describes the capabilities of the {{object|.Applications.AudienceStats}} object. Maximum number of channels that the STB MUST support in the {{object|.Applications.AudienceStats}} object A value of -1 indicates no specific limit on the number of channels. Details of STB logical or physical internal components. Unlike the {{object|.Capabilities}} object, which is read-only and which doesn't describe individual instances, this object contains some writeable parameters. {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} {{numentries}} FrontEnd instance table. Each front-end instance, including vendor-specific front-end types, will normally have a sub-object that corresponds to the front-end type (e.g. DVB-T or IP). Enables or disables this front-end. The status of this front-end. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this front-end. DVB-T front-end details. This object will normally be present if and only if this front-end is a DVB-T front-end. Parameters are taken from the DGTVi D-Book {{bibref|D-Book}}. DVB-T modulation details. Indicates the current frequency in {{units}}. The value of this parameter is undefined while installing the service list (see {{object|.Components.FrontEnd.{i}.DVBT.Install}}). Indicates the channel bandwidth in use. Indicates the current constellation in use. Hierarchical parameter alpha. The higher the value of alpha, the more noise-immune the High Priority Modulation is. no hierarchy Indicates the current code rate in use. Code rate applies to HP in case of hierarchical coding. Indicates the current code rate in use. Code rate applies to LP in case of hierarchical coding. Coding is not hierarchical Indicates the current guard interval in use. Indicates the number of carriers in an OFDM frame. Signal/Noise ratio in the carrier band, measured in {{units}}. Bit Error Ratio before correction, expressed in multiples of 1e-6. Bit Error Ratio after correction, expressed in multiples of 1e-9. Indicates whether or not the tuner is locked on a frequency. DVB-T Current service details. It represents the logical channel object instance for the current service, For example: ''.Components.FrontEnd.1.DVBT.-ServiceListDatabase.LogicalChannel.12''. It represents the service object instance for the current service. For example: ''.Components.FrontEnd.1.DVBT.ServiceListDatabase.LogicalChannel.12.Service.1''. DVB-T service list database installation. Supports maintenance of the service list database by scanning frequencies in order to detect services. The service list database is in {{object|.Components.FrontEnd.{i}.DVBT.ServiceListDatabase}}. Starts (when set to {{true}}) or stops (when set to {{false}}) scanning for services. The value is not saved in device state and is always {{false}} when read. Discovered services are merged with those already present in the service list database. This supports cases where the frequency spectrum is not continuous. In order to force a re-install, the service list database needs to be reset (see {{param|.Components.FrontEnd.{i}.DVBT.ServiceListDatabase.Reset}}). Indicates the status of the scanning process. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. scanning is not in progress scanning is in progress Progression in {{units}} of the current scan. The value is undefined when a scan is not in progress. Frequency (in {{units}}) at which to start the scanning process. Frequency (in {{units}}) at which to stop the scanning process. DVB-T service list database. When set to {{true}}, resets the service list database. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. Total number of services defined in the service list database, i.e. the number of different DvbIds in the database. Number of logical channels in the service list database. DVB-T logical channel information. {{datatype|expand}} Logical channel number. Number of services associated with this logical channel. DVB-T service information. {{datatype|expand}} Human-readable name associated with this service, e.g. read from the DVB service information metadata. DVB Triplet {{bibref|TS102034}} that uniquely identifies the service in the service list database. The DVB Triplet is a 12-byte string that is a concatenation of 4 hexadecimal characters for each of the following: Original Network Id, Transport Stream Id, Service Id. For example: * OriginalNetworkId = 8442 = 0x20FA * TransportStreamId = 4 = 0x0004 * ServiceId = 257 = 0x0101 -> DvbId = ''20FA00040101'' Transmitter frequency (in {{units}}) for this service. Bit Error Ratio before correction, expressed in multiples of 1e-6 (indicates the quality of this service). Bit Error Ratio after correction, expressed in {{units}} (indicates the quality of this service). Signal/Noise ratio in the carrier band, measured in {{units}} (indicates the quality of this service). When set to {{true}}, identifies this as the preferred service for this logical channel and automatically sets {{param}} to {{false}} for other services associated with this logical channel. When set to {{false}}, cancels this service's preferred status and causes the service with the lowest {{param|BER}} (best received quality) to become the preferred service for this logical channel. Whenever frequencies are re-scanned, all {{param}} parameters are implicitly reset to {{false}}, i.e. a re-scan will always use the {{param|BER}} to determine preferred services, and will discard any past explicit overrides. Connect to a DVB-T logical channel. Logical channel number to connect to (the logical channel's preferred service will be connected to). If a {{object|.ServiceMonitoring.MainStream}} instance with ''ServiceType'' = ''DTT'' is currently enabled, the STB MUST ensure that performance data for this service is collected in that instance. The value is not saved in device state. The value when read is not specified and need not be the value that was most recently written. Connect to a DVB-T service. DvbId of the service to connect to. If a {{object|.ServiceMonitoring.MainStream}} instance with ''ServiceType'' = ''DTT'' is currently enabled, the STB MUST ensure that performance data for this service is collected in that instance. The value is not saved in device state. The value when read is not specified and need not be the value that was most recently written. IP front-end details. This object will normally be present if and only if the front-end is an IP front-end. Number of {{object|Inbound}} instances. Number of {{object|Outbound}} instances. Number of {{object|Inbound}} AV streams currently active (i.e. with ''Status'' != ''Disabled'', which means audio or AV data are being processed). Number of {{object|Outbound}} AV streams currently active (i.e. with ''Status'' != ''Disabled'', which means audio or AV data are being processed). Parameters related to RTCP receiver report generation as defined in {{bibref|RFC3550}}. Enables or disables RTCP receiver report generation. The status of RTCP receiver report generation. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Transmission repeat interval, in {{units}}. Parameters related to RTP AVPF configuration as defined in {{bibref|RFC4585}} and {{bibref|RFC4588}}. Enables or disables RTP/AVPF receiver report generation. When set to {{true}}, enables the error correction operation, immediately ({{enum|Forced|OperationMode}} mode) or automatically when necessary ({{enum|Auto|OperationMode}} mode). When set to {{false}}, disables the error correction operation. The status of RTP/AVPF receiver report generation. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Time in {{units}} the receiver shall wait for a retransmitted packet before considering it to be lost. Minimum number of lost packets the receiver shall wait for before generating a retransmission request. Maximum time in {{units}} the receiver shall wait between a lost packet and the generation of a retransmission request. Maximum number of consecutive lost packets for which the receiver shall attempt recovery. The operation mode of the Error Correction mechanism. {{enum}} In {{enum|Auto}} mode, when Error Correction is enabled, the STB decides whether or not to run the Error Correction operation (e.g. after an error analysis). In {{enum|Forced}} mode, when Error Correction is enabled the STB MUST run the Error Correction operation. The status of RTP/AVPF operation. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{enum|Auto|OperationMode}} mode and EC is running {{enum|Auto|OperationMode}} mode and EC is not running and EC data are not buffered). Note: this is equivalent of "Disabled" but this "Disabled" state is caused by STB under auto mode, not be set by operator {{enum|Auto|OperationMode}} mode and EC is not running but EC data are buffered {{enum|Forced|OperationMode}} mode and Enabled Parameters related to AL-FEC configuration as defined in {{bibref|SMPTE20022-1}}. Enables or disables FEC decoder operation. When set to {{true}}, enables the FEC decoder operation, immediately ({{enum|Forced|OperationMode}} mode) or automatically when necessary ({{enum|Auto|OperationMode}} mode). When set to {{false}}, disables the FEC decoder operation. The operation mode of the FEC decoder. {{enum}} In {{enum|Auto}} mode, when Error Correction is enabled the STB decides whether or not to run the AL_FEC decoding (e.g. after an error analysis). In {{enum|Forced}} mode, when Error Correction is enabled the STB MUST run the FEC decoding. The status of FEC decoder operation. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{enum|Auto|OperationMode}} mode and EC is running {{enum|Auto|OperationMode}} mode and EC is not running and EC data are not buffered). Note: this is equivalent of "Disabled", but this "Disabled" state is caused by STB under auto mode, not be set by operator {{enum|Auto|OperationMode}} mode and EC is not running but EC data are buffered {{enum|Forced|OperationMode}} mode and Enabled Parameters that are specific to IGMP clients when changing channels. Enables or disables all IGMP support on the receiver side of the CPE. Status of IGMP support on the receiver side of the CPE. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Maximum number of group memberships allowed simultaneously. For example, this would need to be at least 2 in order to support a Multicast-delivered main picture and a Multicast-delivered PIP. Maximum number of groups for which statistics will be tracked. This relates only to the maintenance of statistics, and does not affect the operation of the STB. Controls logging of IGMP traffic. The CPE MAY choose to throttle log entries, e.g. if joins and leaves are occurring at an excessive rate. Diffserv code point to be used for outgoing IGMP packets. VLAN ID (as defined in 802.1Q) to be used for outgoing IGMP packets. A value of -1 indicates the default value is to be used. If either the {{param}} or {{param|EthernetPriorityMark}} is greater than zero, then the outgoing frames MUST be tagged. Otherwise, the outgoing frames MAY be tagged or untagged. Ethernet priority code (as defined in 802.1D) to be used for outgoing IGMP packets. A value of -1 indicates the default value is to be used. If either the {{param|VLANIDMark}} or {{param}} are greater than zero, then the outgoing frames MUST be tagged. Otherwise, the outgoing frames MAY be tagged or untagged. The highest IGMP version supported by the IGMP Client. Robustness is a way of indicating how vulnerable the network is to lost packets. IGMP can recover from robustness minus 1 lost IGMP packets. RFC 3376 specifies a default of 2. The number of {{units}} between repetitions of a host's initial report of membership in a group. RFC 3376 specifies a default of 1s. Number of entries in the {{object|ClientGroup}} table. Number of entries in the {{object|ClientGroupStats}} table. IGMP Group table. This is the database that is maintained by the IGMP client to reflect the current group membership. The CPE MUST support at least ''MaximumNumberOfConcurrentGroups'' table entries. {{datatype|expand}} The IP multicast group address for which this entry contains information. Time elapsed in {{units}} since the multicast group has been a member on this interface. IGMP Group statistics table. This stores per-group historical statistical data. The CPE MUST support at least ''MaximumNumberOfTrackedGroups'' table entries. The CPE MAY reclaim entries based on the oldest membership reports. {{datatype|expand}} The IP multicast group address for which this entry contains information. Number of {{units}} since the beginning of the period used for collection of {{object|Total}} statistics. Statistics SHOULD continue to be accumulated across CPE reboots, though this may not always be possible. Number of {{units}} since the beginning of the period used for collection of {{object|CurrentDay}} statistics. The CPE MAY align the beginning of each {{object|CurrentDay}} interval with days in the UTC time zone, but is not required to do so. Statistics SHOULD continue to be accumulated across CPE reboots, though this may not always be possible. Number of {{units}} since the beginning of the period used for collection of {{object|QuarterHour}} statistics. The CPE MAY align the beginning of each {{object|QuarterHour}} interval with real-time quarter-hour intervals, but is not required to do so. Statistics SHOULD continue to be accumulated across CPE reboots, though this may not always be possible. Total statistics for this multicast group. Number of IGMP joins during this period. Number of IGMP leaves during this period. Maximum latency delay, in {{units}}, from the sending of a Join message for this group to the arrival of the first IP packet for this group during this period. Current day statistics for this multicast group. Number of IGMP joins during this period. Number of IGMP leaves during this period. Maximum latency delay, in {{units}}, from the sending of a Join message for this group to the arrival of the first IP packet for this group during this period. Current quarter hour statistics for this multicast group. Number of IGMP joins during this period. Number of IGMP leaves during this period. Maximum latency delay, in {{units}}, from the sending of a Join message for this group to the arrival of the first IP packet for this group during this period. Parameters related to the de-jittering buffer configuration for all inbound IP streams. De-jittering buffer size, measured in {{units}}, on the receiver side of the CPE. The STB is responsible for converting this into the actual buffer size in ''bytes''. Describes the number of {{units}} worth of data that should be in the receiver side dejittering buffer before play-out can start. Typically this would be half of the buffer size. Inbound IP streams currently entering the STB via this front-end. The status of this Inbound stream. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Unique human-readable name associated with this inbound IP instance. Network protocol currently used for controlling streaming of the source content, or {{empty}} if the content is not being streamed or is being streamed but is not being controlled. Network protocol currently used for streaming the source content, or an empty string if the content is not being streamed. Transport control protocol currently used for streaming the source content, or an empty string if the content is not being streamed. AV multiplex type currently used for the source content, or an empty string if the content is not being demultiplexed. Network protocol currently used for downloading the source content, or an empty string if the content is not being downloaded. IP address of the source of the current stream content. TCP or UDP port number of the source of the current stream content, or 0 if the content is not being delivered via IP or if not applicable. IP address of the destination of the current stream content, or {{empty}} if the content is not being delivered via IP. TCP or UDP port number of the destination of the current stream content, or 0 if the content is not being delivered via IP or if not applicable. RFC 3986 URI that indicates the current source (possibly including Multicast group and port, if relevant) of the stream content, or {{empty}} if the source is not known or cannot be represented as a URI. For example, for a WAN-delivered stream this might be a content provider's URL, or for a LAN-delivered stream it might be an UPnP AV URN. If specified, the URI MUST be consistent with the other source-related parameters. Parameters related to an outbound IP stream. The status of this Outbound stream. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Unique human-readable name associated with this outbound IP instance. AV multiplex type currently used for the destination content, or an empty string if the content is not being demultiplexed. RFC 3986 URI that indicates the current destination (possibly including Multicast group and port, if relevant) of the stream content, or an empty string if the destination is not known or cannot be represented as a URI. For example, this might be an UPnP AV URN. Parameters used to force connection to a dedicated IP stream for test purposes. RFC 3986 URI that describes the service to connect to in the form: * <trsp>://<addr>:<port>?StrCtrl=<strctrl>?StrTrspCtrl=<trspctrl>?MuxType=<muxtype> where: * '''<addr>''' is the IP address of the service source (for Unicast) or IGMP group (for Multicast). * '''<port>''' is the associated TCP/UDP port. If not specified, the STB is assumed to know and use an appropriate default port. * '''<trsp>''' is the streaming transport protocol and MUST be one of the values in {{param|.Capabilities.FrontEnd.IP.StreamingTransportProtocols}}, which SHOULD be converted to lower-case. * '''<strctrl>''' is the streaming control protocol and MUST be one of the values in {{param|.Capabilities.FrontEnd.IP.StreamingControlProtocols}}. If not specified, no streaming control protocol is to be used. * '''<trspctrl>''' is the streaming transport control protocol and MUST be one of the values in {{param|.Capabilities.FrontEnd.IP.StreamingTransportControlProtocols}}. If not specified, no streaming transport control protocol is to be used. * '''<muxtype>''' is the multiplex type and MUST be one of the values in {{param|.Capabilities.FrontEnd.IP.MultiplexTypes}}. This tells the STB which multiplex type to expect. If not specified, the STB is assumed to know, or to be able to determine, the multiplex type. Note that download protocols are not supported by the above syntax. However, the specified syntax is just a baseline, and STBs MAY support an extended syntax. Example of Multicast MPEG2-TS over RTP with no transport control: * rtp://224.112.15.18:3257?StrCtrl=IGMP?MuxType=MPEG2-TS Example of Multicast MPEG2-TS over RTP with AL-FEC transport control: * rtp://224.112.15.18:3257?StrCtrl=IGMP?StrTrspCtrl=AL-FEC?MuxType=MPEG2-TS Example of Unicast MPEG2-TS over UDP with RTSP transport control: * udp://174.146.35.12:3257?StrCtrl=RTSP?MuxType=MPEG2-TS Example of Unicast raw AV over RTP with RTCP control and RTSP transport control: * rtp://174.146.35.12:3257?StrCtrl=RTSP?StrTrspCtrl=RTCP?MuxType=None If a {{object|.ServiceMonitoring.MainStream}} instance with ''ServiceType'' = ''IP'' or ''IPTV'' (or ''VoD'' if the URI accesses a VoD service) is currently enabled, the STB MUST ensure that performance data for this service is collected in that instance. The value is not saved in device state. The value when read is not specified and need not be the value that was most recently written. Parameters used to describe the force monitoring operation. When running in the force monitoring mode, the STB MUST automatically connect to a test URI defined by the {{param|URI}} parameter whenever it detects that the IP tuner is not not receiving any data from the WAN. When running in normal mode, the STB does not perform any action when it does not receive any data from the IP tuner coming from the WAN. The force monitor mode allows to maintain an active stream coming from the network so as to keep collecting statistics. When set to {{true}}, forces the operation mode in ForceMonitor mode When set to {{false}}, forces operation mode in Normal mode. Indicates the status of the statistic mode of operation. {{enum}} describes the service to connect to for force monitoring purposes with the same syntaxt as {{param|#.ServiceConnect.URI}} If a {{object|.ServiceMonitoring.MainStream}} instance with ''ServiceType'' = ''TEST'' or ''IP-All'' is currently enabled, the STB MUST ensure that performance data for this service is collected in that instance. The value when read is not specified and need not be the value that was most recently written. PVR details. This is a read-only object that exists only to reference PVR storage objects. Number of {{object|Storage}} instances. PVR storage table. There MUST be an instance for each storage object that can be accessed by the PVR. Entries MAY be dynamically created and deleted as storage devices become available and unavailable. {{datatype|expand}} Unique human-readable name associated with this storage instance. References the corresponding ''StorageService'' {{bibref|TR-140}} instance, or an object contained within such an instance, e.g. a ''PhysicalMedium'', ''LogicalVolume'' or ''Folder'' instance. The value is the full hierarchical name of the corresponding object. Example: ''Device.Services.StorageService.1'' Audio decoder instance table. It contains data representing the current status of the Audio decoder. Enables or disables this audio decoder. The status of this audio decoder. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this audio decoder. Audio standard currently being processed by this audio decoder, or an empty string if no audio standard is currently being processed. Video decoder instance table. It contains data representing the current status of the video decoder. Enables or disables this video decoder. The status of this video decoder. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this video decoder. MPEG2 Part 2 profile and level object instance, or {{empty}} if MPEG2 Part 2 is not used. For example: ''.Capabilities.VideoDecoder.MPEG2Part2.ProfileLevel.2'' MPEG4 Part 2 profile and level object instance, or {{empty}} if MPEG4 Part 2 is not used). For example: ''.Capabilities.VideoDecoder.MPEG4Part2.ProfileLevel.2'' MPEG4 Part 10 profile and level object instance, or {{empty}} if MPEG4 Part 10 is not used. For example: ''.Capabilities.VideoDecoder.MPEG4Part10.ProfileLevel.2'' SMPTE-VC-1 profile and level object instance, or {{empty}} if SMPTE-VC-1 is not used. For example: ''.Capabilities.VideoDecoder.SMPTEVC1.ProfileLevel.2'' Indicates the native aspect ratio of the content available at this decoder. Audio output instance table. Enables or disables this audio output. The status of this audio output. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. i.e. Enabled and Muted {{datatype|expand}} Human-readable name associated with this audio output. Currently active audio output format, or {{empty}} if no audio output format is currently active. Note that this parameter refers to output formats and not to physical connectors. The audio level on this audio output in {{units}} (0 is quietest and 100 is loudest). This setting is independent of the mute status. For some audio formats, the audio level is not meaningful, in which case this parameter SHOULD have a fixed value of 0. When set to {{true}}, cancels this audio output's mute status. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. SCART object instances associated with this audio output, or {{empty}} if not associated with any SCART object instances. For example: * ''.Components.SCART.2'' * ''.Components.SCART.2,.Components.SCART.3'' S/PDIF output instance table configuration. This object, if present, is connected to the audio ouput instance currently delivering S/PDIF audio format as described in {{bibref|SPDIF}}. Enables or disables the S/PDIF output. The status of this S/PDIF output. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this output. When set to {{true}}, forces the audio format over S/PDIF to be in PCM mode. When set to {{false}}, let the compressed audio format be carried over S/PDIF (passthrough). When in Passthrough mode, the STB sends the audio stream over S/PDIF without decoding it. Audio delay value, in {{units}}, currently being applied to the audio stream on the S/PDIF interface. The audio delay is entered by the user via his local UI, when necessary for correcting the lipsync. Video output instance table. Enables or disables this video output. The status of this video output. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this Video output. The type of analog video standard currently in use or {{empty}} if no analog video standard is currently in use. Note that this parameter applies only to the CVBS output format. Currently active video output format, or {{empty}} if no video output format is currently active. Note that this parameter refers to output formats and not to physical connectors. Indicates the aspect ratio behaviour for display on monitors with an aspect ratio different from that of the content, which is specified in {{param|.Components.VideoDecoder.{i}.ContentAspectRatio}}. DEPRECATED and replaced by following values DEPRECATED and replaced by following values Indicates whether Macrovision analog protection is being used on this video output. The Macrovision version supported is indicated in {{param|.Capabilities.VideoOutput.Macrovision}}. Indicates whether HDCP is being used on this video output. The HDCP version supported is indicated in {{param|.Capabilities.VideoOutput.HDCP}}. SCART object instances associated with this video output, or {{empty}} if not associated with any SCART object instances. For example: * ''.Components.SCART.2'' * ''.Components.SCART.2,.Components.SCART.3'' Enables or disables the color bar display. When set to {{true}}, the CPE MUST suspend the running service currently using the video output (e.g. IPTV broadcast reception) and MUST display the color bar. When set to {{false}}, the CPE MUST resume the previousely running service. This parameter MUST be always initialized with the value {{false}} on STB boot. Display format being connected to this VideoOutput. This parameter is used by the STB to determine whether an aspect ratio conversion is required. SCART configuration. This object allows configuration of the STB's AV switching. Enables or disables this SCART connector. The status of this SCART connector. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this connector. Enables or disables the Presence control signal (pin 8 of the SCART connector), an output from the STB to control the display device connected to the SCART. When enabled (set to {{true}}) the STB MUST drive pin 8 to the appropriate level to indicate the output video format (SD or HD) to the connected device. When disabled (set to {{false}}) the STB MUST NOT drive pin 8. HDMI instance table. This object allows configuration of the STB’s HDMI output. Enables or disables the HDMI output. The status of HDMI output. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this output. The resolution mode of the HDMI output. In {{enum|Auto}} mode, the resolution is automatically set at the best format via HDMI protocols. In {{enum|Manual}} mode, the resolution to be applied to the HDMI output is given by the ResolutionValue parameter. When {{param|ResolutionMode}} is set to {{enum|Manual|ResolutionMode}} mode, a write action configures the resolution to be applied to the HDMI output, When {{param|ResolutionMode}} is set to {{enum|Auto|ResolutionMode}}, a write action as no effect. A read action provides the current resolution of the HDMI output. HDMI connected display device configuration. This object provides parameters from the HDMI connected device if any. The status of the connected HDMI Display device. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Human-readable name associated with this display device. Enhanced Extended Display Information Data (E-EDID) retrieved from the connected HDMI device. Each entry is a supported resolution of the connected HDMI device and MUST be one element of {{param|.Capabilities.HDMI.SupportedResolutions}}. Preferred connected HDMI device resolution format. Video latency, in {{units}}, being applied in the connected HDMI device. This parameter is extracted from the E-EDID and can be used to compensate the video latency to preserve lipsync. When set to {{true}}, indicates the connected HDMI device is supporting HDMI-CEC features. When set to {{false}}, indicates the connected HDMI device does not support HDMI CEC. When set to {{true}}, indicates the connected display device supports auto lip synchronization. This mode consists in communicating over HDMI, the delay to be applied by the STB to the audio in order to preserve the lip sync. When set to {{true}}, indicates the connected display device supports the 3D video formats mandated by {{bibref|HDMI}}. This object describes the characteristics of the Conditional Access, if any. Enables or disables this CA system. The status of this CA system. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Indicates a unique identifier (e.g. the commercial name: ''La 7 piu'', ''Mediaset Premium'') for this CA system. Path name of the smart card reader object instance containing the smart card (if any) associated with this CA system. The value MUST be {{empty}} (if not associated with a smart card) or else be the full path name of the corresponding smart card reader object. For example: ''Device.SmartCardReader.1'' This object describes the characteristics of the Digital Rights Management, if any. Enables or disables this DRM system. The status of this DRM system. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Indicates a unique identifier (e.g. the commercial name: ''La 7 piu'', ''Mediaset Premium'') for this DRM system. Path name of the smart card reader object instance containing the smart card (if any) associated with this DRM system. The value MUST be {{empty}} (if not associated with a smart card) or else be the full path name of the corresponding smart card reader object. For example: ''Device.SmartCardReader.1'' AV Streams object. If more than one AV stream can be active at a time, it may contain several {{object|AVStream}} instances. Number of AV streams currently active (i.e. with ''Status'' != ''Disabled'', which means audio or AV data are being processed). Number of {{object|AVStream}} instances. Details of each AVStream. AV streams are created statically. Each AV stream corresponds to a valid ''{FrontEnd, AudioDecoder, VideoDecoder}'' instance combination (although if the PVR is active for this stream, only ''{FrontEnd}'' or ''{AudioDecoder, VideoDecoder}'' will be in use). The status of this AV stream. {{enum}} An AV stream is disabled if any of the referenced objects are disabled. If an AV stream is disabled then the values of other AV stream parameters are not significant. The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Unspecified error {{datatype|expand}} Human-readable name associated with this stream, e.g. read from the DVB service information metadata. Indicates whether this stream is using the PVR and, if so, the PVR state. {{enum}} PVR record state can be inferred from whether the stream has an input FrontEnd: if so and {{param}} is not {{enum|Disabled}}, the PVR is recording. PVR not used by this stream PVR playback not active PVR playback active (and playing) PVR playback active (paused) PVR playback active (fast forward) PVR playback active (rewind) Input FrontEnd object instance associated with this AV stream, or {{empty}} if not associated with a FrontEnd object). For example: ''.Components.FrontEnd.2'' Inbound IP stream object instance associated with the FrontEnd for this AV stream, or {{empty}} if the inbound stream is not delivered over IP. For example: ''.Components.FrontEnd.2.IP.Inbound.3'' Outbound IP stream object instance associated with the output FrontEnd for this AV stream (which is always the IP FrontEnd), or {{empty}} if the outbound stream is not delivered over IP. For example: ''.Components.FrontEnd.2.IP.Outbound.3'' Audio Decoder object instance associated with this AV stream, or {{empty}} if not associated with an Audio Decoder object. For example: ''.Components.AudioDecoder.2'' Video Decoder object instance associated with this AV stream, or {{empty}} if not associated with a Video Decoder object. For example: ''.Components.VideoDecoder.2'' CA system object instance associated with this AV stream, or {{empty}} if not associated with a CA object. For example: ''.Components.CA.2'' DRM system object instance associated with this AV stream, or {{empty}} if not associated with a DRM object. For example: ''.Components.DRM.2'' AV Players object. If more than one AV player can be active at a time, it may contain several {{object|AVPlayer}} instances. AV players are created statically. Each AV player corresponds to a combination of several AV streams (one main screen video, several PIP, one audio) being connected to an AV presentation device (such as a TV set). There is no guarantee that the STB has the resources to enable all of its AV players at the same time. Number of AV players currently active (i.e. with ''Status'' != ''Disabled'', which means the {{object|AVPlayer}} is processing an audio or AV stream). Number of {{object|AVPlayer}} instances. Human-readable string, as specified in {{bibref|RFC3066}}, describing the audio language that SHOULD be used by the STB when receiving a multi-language audio multiplex. {{empty}} indicates that there is no preferred audio language. Human-readable string, as specified in {{bibref|RFC3066}}, describing the subtitling language that SHOULD be used by the STB when receiving multi-language subtitling. A value of ''None'' indicates that no subtitling is required. {{empty}} indicates that there is no preferred subtitling language. Aspect ratio behaviour preference for display on monitor. If non-empty, the string MUST be one of the .Components.VideoOutput.{i}. AspectRatioBehaviour values. When set to {{true}}, the master PIN code for the STB is set to 0000. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. It is not recommended that this be set to true without the user's permission. No data on the device such as PVR recordings are to be cleared as a result of resetting the PIN code. List of AV Player objects. Each item is one particular AV player being processed by the STB. Enables or disables this AV player. The status of this AV player. {{enum}} If an AV player is disabled then the values of other AV player parameters are not significant. The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Human-readable name associated with this AV player. Human-readable string, as specified in {{bibref|RFC3066}}, describing the audio language being currently processed by the AV player. The status of subtitling for this AV player. {{enum}} Subtitles are assumed to be shown only on the main screen. The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. Human-readable string, as specified in {{bibref|RFC3066}}, describing the subtitling language being currently processed by the AV player. Subtitles are assumed to be shown only on the main screen. Audio output object instances associated with this AV player, or {{empty}} if not associated with any audio output object instances. For example: ''.Components.AudioOutput.2'' Video output object instances associated with this AV player, or {{empty}} if not associated with any video output object instances. For example: ''.Components.VideoOutput.2'' AV stream object instance associated with this AV player that is being sent to the main screen, or {{empty}} if not associated with an AV stream object. For example: ''.AVStreams.AVStream.2'' AV stream object instances associated with this AV player that are being displayed as Picture In Picture (PIP), or {{empty}} if not associated with any PIP AV stream objects. For example: * ''.AVStreams.AVStream.2'' * ''.AVStreams.AVStream.2,.AVStreams.AVStream.3'' Records events and collects QoS / QoE related statistics for Main AV streams. These statistics are broken down into categories, e.g. de-jittering and RTP, and for each category there are two types of statistics: * '''Total''' statistics, which count the number of occurrences of something. * '''Sample''' statistics, which are measured over a sample interval, and are made available to the ACS as a list of the most recent n samples. Total statistics are always collected (collection cannot be disabled, but the values can be reset). For Sample statistics, an STB uses a single sample interval and number of samples (n) for all {{object|MainStream}} instances. The sample interval can be aligned with absolute time. When Sample statistics collection is enabled, statistics collection MUST proceed regardless of whether there are any active Main AV streams. For example, even when the STB is not receiving any data, sample intervals will continue to be timed as normal. Refer to {{bibref|TR-135|I.3}} for non-normative explanation of the operation of the ''ServiceMonitoring'' object. Enables or disables collection of Sample statistics. When collection of Sample statistics is enabled, any stored samples are discarded, and the first sample interval begins immediately. Indicates availability of Sample statistics. {{enum}} The {{enum|Trigger}} value is only used for triggering the ACS to fetch the collected data and can only be used when {{param|FetchSamples}} is in the range [1:{{param|ReportSamples}}]. The transition from {{enum|Enabled}} -> {{enum|Trigger}} -> {{enum|Enabled}} MUST be instantaneous and so will result in only a single value change for notification purposes. Collection is disabled Collection is enabled Collection is enabled and the ACS should now fetch the collected data The sample interval in {{units}}. Each statistic is measured over this sample interval. The STB MAY reject a request to set {{param}} to less than {{param|.Capabilities.ServiceMonitoring.MinSampleInterval}}. Sample intervals MUST begin every {{param}} seconds, with no delay between samples. If {{param}} is changed while collection of Sample statistics is enabled, any stored samples are discarded, and the first sample interval begins immediately. For example, if {{param|ReportSamples}} is 24 and {{param}} is 3600 (an hour), the STB can store up to a day's worth of samples for each statistic. The number of samples that the STB can store and report for each statistic. The STB MUST permit {{param}} to be set to any value in the range from 1 to {{param|.Capabilities.ServiceMonitoring.MaxReportSamples}}. If {{param}} is changed while collection of Sample statistics is enabled, the STB will truncate or extend its statistics buffers as appropriate, but statistics collection MUST NOT otherwise be affected. For example, if {{param}} is 24 and {{param|SampleInterval}} is 3600 (an hour), the STB can store up to a day's worth of samples for each statistic. If collection of Sample statistics is enabled and {{param}} is in the range [1:{{param|ReportSamples}}] then {{param|SampleState}} MUST transition from {{enum|Enabled|SampleState}} -> {{enum|Trigger|SampleState}} -> {{enum|Enabled|SampleState}} on completion of every {{param}} sample intervals. Otherwise, this transition MUST NOT occur. For example, if {{param|ReportSamples}} is 25 and {{param}} is 24, then the STB will store 25 values for each statistic and the above {{param|SampleState}} transition will occur every 24 sample intervals, which means that the ACS could delay for up to two sample intervals before reading the stored values and would still not miss any samples (see also {{param|ForceSample}}). An absolute time reference in UTC to determine when sample intervals will complete. Each sample interval MUST complete at this reference time plus or minus an integer multiple of {{param|SampleInterval}}. This time reference also determines when the {{param|SampleState}} {{enum|Enabled|SampleState}} -> {{enum|Trigger|SampleState}} -> {{enum|Enabled|SampleState}} transitions that are controlled by {{param|FetchSamples}} will occur. If collection of Sample statistics is enabled and {{param|FetchSamples}} is in the range [1:{{param|ReportSamples}}] then each such {{param|SampleState}} transition MUST occur at this reference time plus or minus an integer multiple of {{param|FetchSamples}} * {{param|SampleInterval}} (the fetch interval). {{param}} is used only to set the "phase" of the sample and fetch intervals. The actual value of {{param}} can be arbitrarily far into the past or future. If {{param}} is changed while collection of Sample statistics is enabled, any stored samples are discarded, and the first sample interval begins immediately. The Unknown Time value defined in {{bibref|TR-106a1}} indicates that no particular time reference is specified. That is, the STB MAY locally choose the time reference, and is required only to adhere to the specified sample and fetch intervals. If absolute time is not available to the STB, its sample and fetch interval behavior MUST be the same as if the {{param}} parameter was set to the Unknown Time value. For example, if {{param|SampleInterval}} is 3600 (an hour) and if {{param}} is set to UTC midnight on some day (in the past, present, or future) then sample intervals will complete on each UTC hour (00:00, 01:00, 02:00 etc). If, in addition, {{param|FetchSamples}} is 24, then the fetch interval is 86400 (a day) and {{param|SampleState}} {{enum|Enabled|SampleState}} -> {{enum|Trigger|SampleState}} -> {{enum|Enabled|SampleState}} transitions will occur every day at UTC midnight. Note that, if {{param}} is set to a time other than the Unknown Time, the first sample interval (which has to begin immediately) will almost certainly be shorter than {{param|SampleInterval}}). This is why {{param}} is defined in terms of when sample intervals complete rather than start. When set to {{true}}, forces statistics for the current sample to be calculated and updated in the data model. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. If this is the first time that {{param}} has been set to true during the current sample interval, this MUST cause a new value to be added to each of the Sample statistics comma-separated list parameters, and the {{param|ReportEndTime}} and all ''SampleSeconds'' parameters MUST be updated accordingly. If this is not the first time that {{param}} has been set to {{true}} during the current sample interval, then the new values that were added as described in the previous paragraph, and the {{param|ReportEndTime}} and all ''SampleSeconds'' parameters, MUST be updated accordingly. Note that {{param}} just provides a ''sneak preview'' of the current sample. It does not create a new sample and it does not interfere with the sample interval schedule. At the end of each sample interval, if {{param}} was set to {{true}} during the sample interval then the new values that were added as described above, and the {{param|ReportEndTime}} and all ''SampleSeconds'' parameters, will be updated accordingly. In other words, the partial sample data that was created when {{param}} was set to {{true}} will be updated one last time at the end of the sample interval. The absolute time at which the sample interval for the first stored sample (for each statistic) started. The absolute time at which the sample interval for the last stored sample (for each statistic) ended. If {{param|ForceSample}} has been used to force statistics for the current sample to be calculated and updated in the data model, then {{param}} MUST be updated to reflect the actual time over which stored data was collected. Number of {{object|MainStream}} instances. The number of event measurements of each applicable statistic that the STB is able to store for each sample interval. The STB MUST permit {{param}} to be set to any value in the range from 1 to {{param|.Capabilities.ServiceMonitoring.MaxEventsPerSampleInterval}}. If {{param}} is changed while collection of Sample statistic is enabled, the STB will truncate or extend its event measurement buffers as appropriate, but event measurement collection MUST NOT otherwise be affected. For example, if {{param|ReportSamples}} is 24 and {{param|SampleInterval}} is 3600 (an hour), and {{param}} is 60, the STB can store up 60 event measurements per hour, or in total 1440 event measurements per day. Enables or disables the collection of the events for all main streams. When the collection of events is enabled, any previously collected events are discarded and the collection of new events begins immediately. List of Main AV stream objects. Each instance is associated with a specified service type and will collect statistics only for the main stream that matches that service type. Note that this means that streams that do not match an instance's service type MUST NOT contribute to the instance's Total and Sample statistics. It is up to the STB to determine which AV stream should be regarded as the Main AV stream for a given service type at any given time. For example, if two active streams are associated with the same service type, the STB might prefer streams that are associated with an AV player, or if more than one stream is associated with an AV player, the STB might prefer a player that is outputting a DVI stream to a player that is outputting an RF stream. Note that some parameters, e.g. {{param|.Components.FrontEnd.{i}.IP.ServiceConnect.URI}}, include requirements that restrict the STB's freedom to determine which AV stream should be regarded as the Main AV stream for a given service. Enables or disables collection of Total and Sample statistics and events for this object instance. The collection of events requires the value of this parameter to be {{true}} and the value of the {{param|##.ServiceMonitoring.EventCollectionEnable}} to be {{true}}. Total and Sample statistics and event collection status for this object instance. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Service type associated with this main stream instance, or {{empty}} if this instance is disabled. The STB MUST reject a request that would result in a given AV stream contributing to more than one {{object|.ServiceMonitoring.MainStream}} instance, e.g. it would reject a request to enable simultaneous collection of both IPTV and IP statistics, or to collect IPTV statistics on more than one instance. Main AV stream object instance currently associated with this ''ServiceMonitoring'' main stream instance. For example: ''.AVStreams.AVStream.2'' Note that, during the period of time over which Sample statistics are stored, this ''ServiceMonitoring'' main stream instance might be associated with many different ''AVStream'' instances. This parameter just provides information about which ''AVStream'' is currently being monitored. Minimum number of consecutive received packets after the end of an RTP Loss Event. A Loss Event is defined as as a sequence of lost packets, possibly including islands of received packets. Each island consists of up to ({{param}} - 1) received packets (a sequence of {{param}} received packets terminates the Loss Event, and so is not an island). The minimum distance required between error events before an RTP Loss Event is considered severe. Used in the calculation of ''SevereLossIndexCount'' and ''SevereLossIndexCountBeforeEC''. The minimum value for the count of lost packets per RTP Loss Event before the count of lost packets is considered severe. Used in the calculation of ''SevereLossLengthCount'' and ''SevereLossLengthCountBeforeEC''. Time period, in {{units}}, between a user channel change request (defined as the instant of transmission of the relevant control protocol message (IGMP JOIN or RTSP SETUP) or a tuner command in case of DTT), and the display of the first I frame for the current AVStream, above which a channel change is considered as failed. {{list}} Definition of the histogram intervals for counting loss events according to their size (in {{units}}). Each value indicates the maximum value of the interval. For example, "1,2,4,8," defines the five intervals: 1 packet lost, 2 packets, 3 or 4 packets, 5 to 8 packets and 9 or more packets. (No value after the last comma means no upper bound.) If this parameter is set to an empty string, no PacketsLostByEvent stats will be collected. {{list}} Definition of the histogram intervals for counting loss events according to their delay (in {{units}}) after the preceding loss event. Each value indicates the maximum value of the interval. For example, "10,20,50,100,1000,60000,3600000," defines the intervals up to 10 ms, to 20 ms, to 50 ms, to 100 ms, to 1 s, to 1 mn, to 1 h and more than 1 h. (No value after the last comma means no upper bound.) If this parameter is set to an empty string, no DelayBetweenLossEvents stats will be collected. {{list}} Definition of the histogram intervals for counting severe loss events according to their duration (in {{units}}). Each value indicates the maximum value of the interval. For example, "50,100,500,1000,2000,5000,10000,120000," defines the intervals up to 50 ms, to 100 ms, to 500 ms, to 1 s, to 2 s etc. (No value after the last comma means no upper bound.) If this parameter is set to an empty string, no DurationSevereLossEvents stats will be collected. Time based UUID {{bibref|RFC4122|Section 4.2}} that is the identifier for the associated {{param|AVStream}} parameter when available to the device. Total statistics since this ''ServiceMonitoring'' main stream instance was last enabled or Total statistics were last reset. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than the {{param|ResetTime}}, for several reasons, including the STB was not receiving any data (Standby mode without force monitoring). When set to {{true}}, resets Total statistics for this ''ServiceMonitoring'' main stream instance. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. Number of seconds since the Total statistics were last enabled or reset for this ''ServiceMonitoring'' main stream instance. Total de-jittering statistics for this ''ServiceMonitoring'' main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * De-jittering data collection is not appropriate or possible for this AV stream. Total number of times the receive jitter buffer has overrun for this AV stream. Total number of times the receive jitter buffer has underrun for this AV stream. Total time, in {{units}}, for which the playout was stopped due to buffer issues (empty or too low level) for this AV stream. Total TCP statistics for this ServiceMonitoring main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * TCP data collection is not appropriate or possible for this AV stream. Total number of TCP packets correctly received for this AV stream. Total number of TCP packets being retransmitted for this AV stream. Total number of bytes received for this AV stream. Total RTP statistics for this ''ServiceMonitoring'' main stream instance. If no EC is applied the ''BeforeEC'' statistics provide the same values as the corresponding statistics, e.g. when there is no EC, {{param|PacketsReceivedBeforeEC}} = {{param|PacketsReceived}}. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * RTP data collection is not appropriate or possible for this AV stream. Total number of RTP packets expected for this AV stream as described in {{bibref|RFC3550|A.3}}. Total number of packets discarded at the RTP layer for this AV stream because they were too late for playout, regardless of their being out of sequence or not. These statistics are collected when no EC is applied or after any EC if available. Total number of packets out of sequence at the RTP level for this AV stream, regardless of their being too late for playout or not. These statistics are collected when no EC is applied or after any EC if available. Total number of RTP packets received for this AV stream. These statistics are collected when no EC is applied or after any EC if available. Total number of RTP packets received for this AV stream. These statistics are collected before any EC, if available, is applied. Total number of RTP packets lost for this stream. These statistics are collected when no EC is applied or after any EC if available. Total number of RTP packets lost for this stream. These statistics are collected before any EC, if available, is applied. {{list}} Total number of loss events counted by their length in packets (1 packet, 2 packets, etc.) according to the intervals defined by {{param|##.PacketsLostByEventHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Total number of Loss Events for this stream. These statistics are collected when no EC is applied or after any EC if available. Total number of Loss Events for this stream. These statistics are collected before any EC, if available, is applied. {{list}} Total number of times that the delay (in milliseconds) between two consecutive loss events belongs to each time interval defined by {{param|##.DelayBetweenLossEventsHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Total number of Loss Events closer than ''SevereLossMinDistance''. These statistics are collected when no EC is applied or after any EC if available. Total number of Loss Events closer than ''SevereLossMinDistance''. These statistics are collected before any EC, if available, is applied. Total number of Loss Events longer than ''SevereLossMinLength''. These statistics are collected when no EC is applied or after any EC if available. Total number of Loss Events longer than ''SevereLossMinLength''. These statistics are collected before any EC, if available, is applied. {{list}} Total number of severe loss events counted by their duration (in milliseconds) according to the intervals defined by {{param|##.DurationSevereLossEventsHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Total number of RTP/AVPF retransmission timeouts ({{bibref|RFC4585}}, {{bibref|RFC4588}}) If RTP/AVPF is not used this parameter does not increment {{list}} Total number of loss events counted by their length in packets (1 packet, 2 packets, etc.) according to the intervals defined by {{param|##.PacketsLostByEventHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. {{list}} Total number of times that the delay (in milliseconds) between two consecutive loss events belongs to each time interval defined by {{param|##.DelayBetweenLossEventsHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. {{list}} Total number of severe loss events counted by their duration (in milliseconds) according to the intervals defined by {{param|##.DurationSevereLossEventsHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. Total MPEG2-TS statistics for this ''ServiceMonitoring'' main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * MPEG2 TS data collection is not appropriate or possible for this AV stream. Total number of MPEG2-TS packets received for this AV stream. Total number of MPEG2-TS packets with an invalid transport sync byte received for this AV stream. Not meaningful when MPEG2-TS is transported over IP. Total number of MPEG2-TS Loss of Synchronization Events for this AV stream. Not meaningful when MPEG2-TS is transported over IP. Total number of MPEG2-TS Discontinuity errors that have been captured for this AV stream. This parameter accumulates all of the discontinuities observed for all currently monitored PIDs. These statistics are collected when no CA decryption scheme is in use or after any CA decryption if in use. Total number of MPEG2-TS Discontinuity errors that have been captured for this AV stream. This parameter accumulates all of the discontinuities observed for all currently monitored PIDs. These statistics are collected before any CA decryption scheme, if used, is applied. Total video decoder application layer statistics for this ''ServiceMonitoring'' main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * Video Decoder data collection is not appropriate or possible for this AV stream. The latest frame rate at which the STB played out the video content for this AV stream. Also the reported rate will be rounded off to the nearest integer. The number of video frames that were decoded completely (errorless frames) or partially (corrupted frames) for this AV stream. The number of video frames that could not be reproduced by the STB for this AV stream. The number of video frames that were reproduced by the STB for which some information was missing and loss concealment was applied for this AV stream. The number of I frames that were decoded completely (errorless frames) or partially (corrupted frames) for this AV stream. The number of I frames that could not be reproduced by the STB for this AV stream. The number of I frames that were reproduced by the STB for which some information was missing and loss concealment applied for this AV stream. The number of P frames that were decoded completely (errorless frames) or partially (corrupted frames) for this AV stream. The number of P frames that could not be reproduced by the STB for this AV stream. The number of P frames that were reproduced by the STB for which some information was missing and loss concealment applied for this AV stream. The number of B frames that were decoded completely (errorless frames) or partially (corrupted frames) for this AV stream. The number of B frames that could not be reproduced by the STB for this AV stream. The number of B frames that were reproduced by the STB for which some information was missing and loss concealment applied for this AV stream. The number of AV resynchronizations that were performed by the STB for this AV stream. Total audio decoder application layer statistics for this ''ServiceMonitoring'' main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * Audio Decoder data collection is not appropriate or possible for this AV stream. The number of audio frames that were decoded completely (errorless frames) or partially (corrupted frames) for this AV stream. The number of audio decoding errors detected for this AV stream. Total video response statistics for this ''ServiceMonitoring'' main stream instance. The number of seconds during which data was collected for this AV stream since last reset Each statistics category (Dejittering, RTP etc) has its own {{param}} parameter, which indicates the number of seconds during which data was collected for that statistics category since last reset. Individual {{param}} values can be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}, for several reasons, including: * Any of the reasons for which the {{param}} values might be less than {{param|.ServiceMonitoring.MainStream.{i}.Total.ResetTime}}. * Video response data collection is not appropriate or possible for this AV stream. Minimum time period (in {{units}}) between the instant of transmitting an IGMP JOIN command or an RTSP SETUP command, and the display of the first I frame for this AV stream. Maximum time period (in {{units}}) between the instant of transmitting an IGMP JOIN command or an RTSP SETUP command, and the display of the first I frame for this AV stream. Number of channel change failures. A channel change is considered as failed when the time period between a user channel change request and the display of the first I frame for this AVStream is above {{param|.ServiceMonitoring.MainStream.{i}.ChannelChangeFailureTimeout}}. Each entry represents a channel for which a channel change failed. Channels MAY be described as IP address, URL or Service names as appropriate. Only last 10 failures are required to be reported. Minimum time period, in {{units}}, between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I frame of unicast stream. Only measured when started from a non-play state, i.e. either idle or paused. Maximum time period, in {{units}}, between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I-frame of unicast stream. Only measured when started from a non-play state, i.e. either idle or paused. Total number of RTSP protocol requests to start a VoD program display. Only meaningful for VoD. Total number of successful VoD attempts. An attempt is considered successful when the first I-frame is displayed by the client. Only meaningful for VoD. Total number of completed VoD requests. An attempt is defined successful if it continues until a RTSP protocol request to end the session is sent by the STB. Only meaningful for VoD. Sample statistics collected since collection was last enabled or reset. Most of the parameters in this object are comma-separated lists of individual statistics values, each of which corresponds to a sample interval. The statistics values in these comma-separated lists MUST be in time order, with the oldest one first and the most recent one last. Each comma-separated list can contain up to {{param|##.ReportSamples}} statistics values. When the list is full, each new value causes the oldest one to be discarded. Some comma-separated lists contain terms that are comma-separated lists themselves and are used to store measurements on an event basis. These sub-lists can contain up to {{param|.Capabilities.ServiceMonitoring.MaxEventsPerSampleInterval}} values. If no data was collected for a statistic during a sample interval then the value for that sample interval MUST be zero unless otherwise specified in the description of the individual statistics parameter. Each entry is the number of seconds during which data was collected for this AV stream during the sample interval. Each statistics category (Dejittering, RTP etc) has its own ''SampleSeconds'' parameter, which indicates the number of seconds during which data was collected for that statistics category during the sample interval. Individual ''SampleSeconds'' values can be less than the ''SampleInterval'', for several reasons, including: * The STB was not receiving any data for the corresponding ServiceType for all or part of the sample interval. * ''TimeReference'' has been set to a time other than the Unknown Time and the current sample interval started part of the way through a scheduled sample interval. * ''ForceSample'' has been used to force statistics for the current sample to be calculated and updated in the data model. Each entry is the total number of times that a channel change (or other potentially disruptive event) occurred for this AV stream during the sample interval. Each entry is a Boolean that indicates whether the PVR, with a non-zero time-shift, was used at any time for this AV stream during the sample interval. Number of {{object|HighLevelMetricStats}} instances. De-jittering Sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which de-jittering data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * De-jittering data collection is not appropriate or possible for this AV stream. Each entry is the total number of times the receive jitter buffer has overrun for this AV stream during the sample interval. Each entry is the total number of times the receive jitter buffer has underrun for this AV stream during the sample interval. Each entry is the time period, in {{units}}, for which the playout was stopped due to buffer issues (empty or too low level) for this AV stream during the sample interval. TCP sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which de-jittering data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * TCP data collection is not appropriate or possible for this AV stream. Each entry is the total number of TCP packets received for this AV stream during the sample interval. Each entry is the total number of TCP packets being retransmitted this AV stream.during the sample interval. Each entry is the total number of bytes received for this AV stream.during the sample interval. RTP Sample statistics for this ''ServiceMonitoring'' main stream instance. If no EC is applied the ''BeforeEC'' statistics provide the same values as the corresponding statistics, e.g. when there is no EC, {{param|PacketsReceivedBeforeEC}} = {{param|PacketsReceived}}. Each entry is the number of seconds during which RTP data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * RTP data collection is not appropriate or possible for this AV stream. Each entry is the total number of RTP packets expected for this AV stream during the sample interval as described in {{bibref|RFC3550|A.3}}. Each entry is the number of packets that were discarded at the RTP layer for this AV stream during the sample interval because they were too late for playout, regardless of their being out of sequence or not. These statistics are collected when no EC is applied or after any EC if available. Each entry is the number of packets out of sequence at the RTP level for this AV stream during the sample interval, regardless of their being too late for playout or not. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of RTP packets received for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of RTP packets received for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the number of RTP/AVPF retransmission timeouts ({{bibref|RFC4585}}, {{bibref|RFC4588}}) for this AV stream during the sample interval. Each entry is the total number of RTP packets lost for this AV stream during the sample interval. Calculated by looking for missing RTP sequence headers. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of RTP packets lost for this AV stream during the sample interval. Calculated by looking for missing RTP sequence headers. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of loss events counted by their length in packets (1 packet, 2 packets, etc.) according to the intervals defined by {{param|##.PacketsLostByEventHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of Loss Events for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of Loss Events for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of the number of times that the delay (in milliseconds) between two consecutive loss events belongs to each time interval defined by {{param|##.DelayBetweenLossEventsHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of Loss Events that occurred at a distance shorter than ''SevereLossMinDistance'' from the previous Loss Event for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of Loss Events that occurred at a distance shorter than ''SevereLossMinDistance'' from the previous Loss Event for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the average distance in {{units}} between consecutive Loss Events for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the average distance in {{units}} between consecutive loss events for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the length in {{units}} of the shortest distance between consecutive Loss Events for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the length in {{units}} of the shortest distance between consecutive Loss Events for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the total number of Loss Events with length in RTP packets greater than ''SevereLossMinLength'' for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the total number of Loss Events with length in RTP packets greater than ''SevereLossMinLength'' for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of the number of severe loss events counted by their duration (in milliseconds) according to the intervals defined by {{param|##.DurationSevereLossEventsHistogramIntervals}}. These statistics are collected when no EC is applied or after any EC if available. Each entry is the length in {{units}} of the longest Loss Event for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the length in {{units}} of the longest Loss Event for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the average length in {{units}} of Loss Events for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the average length in {{units}} of Loss Events for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. Each entry is the length in {{units}} of the shortest RTP Loss Event for this AV stream during the sample interval. These statistics are collected when no EC is applied or after any EC if available. Each entry is the length in {{units}} of the shortest RTP Loss Event for this AV stream during the sample interval. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of loss events counted by their length in packets (1 packet, 2 packets, etc.) according to the intervals defined by {{param|##.PacketsLostByEventHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of the number of times that the delay (in milliseconds) between two consecutive loss events belongs to each time interval defined by {{param|##.DelayBetweenLossEventsHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. {{list}} Each list item is a comma-separated list of unsigned integers that represents, for a sample interval, a histogram of the number of severe loss events counted by their duration (in milliseconds) according to the intervals defined by {{param|##.DurationSevereLossEventsHistogramIntervals}}. These statistics are collected before any EC, if available, is applied. MPEG2-TS Sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which MPEG2-TS data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * MPEG2-TS data collection is not appropriate or possible for this AV stream. Each entry is the total number of MPEG2-TS packets received for this AV stream during the sample interval. Each entry is the total number of good MPEG2-TS packets removed from the buffer for this AV stream during the sample interval. Packets received minus packets drained provides an indication how close the buffer came to over or under running during the sample interval. Each entry is the total number of MPEG2-TS packets with an invalid transport sync byte for this AV stream during the sample interval. Not meaningful when MPEG2-TS is transported over IP. Each entry is the total number of MPEG2-TS Loss of Synchronization Events for this AV stream during the sample interval. Not meaningful when MPEG2-TS is transported over IP. Each entry is the total number of MPEG2-TS Discontinuity errors that were captured for this AV stream during the sample interval. These statistics are collected when no CA decryption scheme is in use or after any CA decryption if in use. Each entry is the total number of MPEG2-TS Discontinuity errors that were captured for this AV stream during the sample interval. These statistics are collected before any CA decryption scheme, if used, is applied. Video decoder Sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which video decoder data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * Video Decoder data collection is not appropriate or possible for this AV stream. Each entry is the last frame rate at which the STB played out the video content for this AV stream during the sample interval. . Also the reported rate will be rounded off to the nearest integer. Each entry is the number of video frames that were decoded completely (errorless frames) or partially (corrupted frames) by the STB for this AV stream during the sample interval. Each entry is the number of video frames that could not be reproduced by the STB for this AV stream during the sample interval. Each entry is the number of video frames that were reproduced by the STB for which some information was missing for this AV stream during the sample interval and loss concealment was applied. Each entry is the number of I frames that were decoded completely (errorless frames) or partially (corrupted frames) by the STB for this AV stream during the sample interval. Each entry is the number of I frames that could not be reproduced by the STB for this AV stream during the sample interval. Each entry is the number of I frames that were reproduced by the STB for which some information was missing for this AV stream during the sample interval and loss concealment applied. Each entry is the number of P frames that were decoded completely (errorless frames) or partially (corrupted frames) by the STB for this AV stream during the sample interval. Each entry is the number of P frames that could not be reproduced by the STB for this AV stream during the sample interval. Each entry is the number of P frames that were reproduced by the STB for which some information was missing for this AV stream during the sample interval and loss concealment applied. Each entry is the number of B frames that were decoded completely (errorless frames) or partially (corrupted frames) by the STB for this AV stream during the sample interval. Each entry is the number of B frames that could not be reproduced by the STB for this AV stream during the sample interval. Each entry is the number of B frames that were reproduced by the STB for which some information was missing for this AV stream during the sample interval and loss concealment applied. Each entry is the number of AV resynchronizations that were performed by the STB for this AV stream during the sample interval. Audio decoder Sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which audio decoder data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * Audio decoder data collection is not appropriate or possible for this AV stream. Each entry is the number of audio frames that were decoded completely (errorless frames) or partially (corrupted frames) by the STB for this AV stream during the sample interval. Each entry is the number of audio decoding errors detected by the STB for this AV stream during the sample interval. Video response Sample statistics for this ''ServiceMonitoring'' main stream instance. Each entry is the number of seconds during which video response data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * Video response data collection is not appropriate or possible for this AV stream. Each entry is the time period (in {{units}}) between the instant of transmitting an IGMP JOIN or an RTSP SETUP command and the display of the first I frame, computed as the average of the VideoSystemResponse events that occured for this AV stream during the sample interval. Each entry is the minimum time period (in {{units}}) between the instant of transmitting an IGMP JOIN or an RTSP SETUP command and the display of the first I frame for this AV stream during the sample interval. Each entry is the maximum time period (in {{units}}) between the instant of transmitting an IGMP JOIN or an RTSP SETUP command and the display of the first I frame for this AV stream during the sample interval. Each entry is the time period, in {{units}}, between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I-frame of unicast stream, computed as the average of the VoDControlResponse events that occured for this AV stream during the sample interval. Only measured when started from a non-play state, i.e. either idle or paused. Each entry is the minimum time period, in {{units}}, between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I-frame of unicast stream. Only measured when started from a non-play state, i.e. either idle or paused. Each entry is the maximum time period, in {{units}}, between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I-frame of unicast stream. Only measured when started from a non-play state, i.e. either idle or paused. Each entry is a colon separated list of time periods in milliseconds between the instant of transmitting a RTSP PLAY command to start playing stream, and displaying the first I-frame of unicast stream. Only measured when started from a non-play state, i.e. either idle or paused. A comma separates measurements made in different sample intervals, while a colon separates individual measurements within a specific sample interval. If no VoDControlResponse measurements were made during a specific sample interval then this MUST be represented by an empty string. Example: ,837:453:1234,759,,,923:698,,,1284 Here there were no measurements during first sample interval, three during the second, one during the third, etc. The statistics values in this list MUST be in time order, with the oldest one first and the most recent one last. This applies both to sample intervals and to individual measurements during a specific sample interval. {{nopattern}} {{nopattern}} Each entry is a colon separated list of time periods in milliseconds between the instant of transmitting an IGMP JOIN or an RTSP SETUP command and the display of the first I frame that occurred for this AV stream during the sample interval. A comma separates measurements made in different sample intervals, while a colon separates individual measurements within a specific sample interval. If no VideoSystemResponse measurements were made during a specific sample interval then this MUST be represented by an empty string. Example: ,837:453:1234,759,,,923:698,,,1284 Here there were no measurements during first sample interval, three during the second, one during the third, etc. The statistics values in this list MUST be in time order, with the oldest one first and the most recent one last. This applies both to sample intervals and to individual measurements during a specific sample interval. {{nopattern}} {{nopattern}} Each entry is the number of RTSP protocol requests to start a VoD program display during the sample interval. Only meaningful for VoD. Each entry is the number of successful VoD attempts during the sample interval. An attempt is considered successful when the first I-frame is displayed by the client. Only meaningful for VoD. Each entry is the number of completed VoD requests during the sample interval. An attempt is defined successful if it continues until a RTSP protocol request to end the session is sent by the STB. Only meaningful for VoD. Each entry is the number of channel change failures. A channel change is considered as failed when the time period between a user channel change request and the display of the first I frame for this AVStream is above {{param|.ServiceMonitoring.MainStream.{i}.ChannelChangeFailureTimeout}}. High-level metric Sample statistics for this ''ServiceMonitoring'' main stream instance. One or more different high-level metrics can be supported; this is specified by {{param|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStatsNumberOfEntries}}. Enables or disables this Metric instance. The status of this Metric instance. {{enum}} The {{enum|Error}} value MAY be used by the CPE to indicate a locally defined error condition. {{datatype|expand}} Indicates a unique identifier for this high-level metric. This parameter is DEPRECATED and replaced by the {{param|MetricThreshold}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. This parameter is DEPRECATED and replaced by the {{param|MetricThreshold}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. Each entry is the number of seconds during which this high-level metric's data was collected for this AV stream during the sample interval. Individual {{param}} values can be less than the sample interval, for several reasons, including: * Any of the reasons for which the {{param|.ServiceMonitoring.MainStream.{i}.Sample.SampleSeconds}} values might be less than the sample interval. * This high-level metric's data collection is not appropriate or possible for this AV stream. This parameter is DEPRECATED and replaced by the {{param|Metric}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. This parameter is DEPRECATED and replaced by the {{param|Metric}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. This parameter is DEPRECATED and replaced by the {{param|MetricFailures}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. This parameter is DEPRECATED and replaced by the {{param|MetricFailures}} parameter and, if needed, several instances of {{object|.ServiceMonitoring.MainStream.{i}.Sample.HighLevelMetricStats.}}. A time period measured in {{units}}. A new value for the high level metric is calculated every {{param}} seconds. The value for {{param}} MUST be less than, or equal to, {{param|.ServiceMonitoring.SampleInterval}}. {{param}} SHOULD be chosen such that {{param|.ServiceMonitoring.SampleInterval}} is an integer multiple of {{param}}. If not, the last metric sample interval in each sample interval MUST be shortened so that the last metric sample interval ends when the sample interval ends. The value for {{param}} is algorithm-specific. The threshold value that controls the calculation of the {{param|MetricFailures}} parameter. Each entry is a high-level metric calculated for this AV stream during the sample interval as the average of the high level metric values calculated on a metric sample interval basis. The length of the metric sample interval is given by {{param|MetricSampleInterval}}. The interpretation of the metric values is algorithm-specific; the only constraints are that values have to be numeric, in the range [0:65535] and that lower values indicate worse QoE than do higher values. Counts the number of times (since the last time this ''MainStream'' and Sample statistics collection were both enabled) that a newly-calculated value of high-level metric {{param|Metric}} was less than or equal to {{param|MetricThreshold}}. This parameter can be incremented at any time during a sample interval, and might be incremented more than once during a single sample interval. This object represents the log entries of events recorded by the MainStream object instance. When the number of log entries in the EventLog exceeds the value of the {{param|###.Capabilities.ServiceMonitoring.MaxMainStreamEventLogEntries}} parameter, the Entry object with the lowest SequenceNumber value is replaced by the new EventLog Entry object. Log entries are persisted across reboots of the CPE. When set to true, clears the events from the event log and the value of {{param|Entry.{i}.SequenceNumber}} parameter is reset to the parameter's minimum value. {{numentries}} This object represents an entry (e.g., start session, channel change) in the event log. The sequence number of the event within the EventLog. This parameter is incremented by one (1) for each entry within the EventLog. When the value of the parameter exceeds the maximium range, the lowest value of this parameter that is not contained in current EventLog entries is used. Type of the event. The values for this parameter are vendor specific. Timestamp of the event. {{numentries}} This object represents an instance of a parameter that is associated with the Entry object Instance. Name of the parameter (vendor-specific). Value of the parameter. Global operations statistics. Global operations total statistics. The time period in, {{units}}, between the first message (e.g. DHCP Discover) sent by the STB during boot-up and the first multicast I-frame for the default channel displayed by the STB. Minimum portal latency defined as the minimum time period, in {{units}}, between the instant of transmitting TCP SYN (the three way handshake) prior to first HTTP message, and receiving the last HTTP message carrying the information. Maximum portal latency defined as the maximum time period, in {{units}}, between the instant of transmitting TCP SYN (the three way handshake) prior to first HTTP message, and receiving the last HTTP message carrying the information. Global operations sample statistics. Each entry is the minimum portal latency defined as the minimum time period, in {{units}}, between the instant of transmitting TCP SYN (the three way handshake) prior to first HTTP message, and receiving the last HTTP message carrying the information during the sample interval. Each entry is the maximum portal latency defined as the maximum time period, in {{units}}, between the instant of transmitting TCP SYN (the three way handshake) prior to first HTTP message, and receiving the last HTTP message carrying the information during the sample interval. Each entry is a colon separated list of time periods (in milliseconds) between the instant of transmitting TCP SYN (the three way handshake) prior to first HTTP message, and receiving the last HTTP message carrying the information. A comma separates measurements made in different sample intervals, while a colon separates individual measurements within a specific sample interval. If no PortalResponse measurements were made during a specific sample interval then this MUST be represented by an empty string. Example: ,837:453:1234,759,,,923:698,,,1284 Here there were no measurements during first sample interval, three during the second, one during the third, etc. The statistics values in this list MUST be in time order, with the oldest one first and the most recent one last. This applies both to sample intervals and to individual measurements during a specific sample interval. {{nopattern}} {{nopattern}} Applications. Number of Service Provider instances. Audience viewing statistics. Enables or disables collection of viewing statistics. Enabling collection of viewing statistics also resets the viewing statistics table. When set to {{true}} resets the viewing statistics table. Setting it to {{false}} has no effect. The value is not saved in device state and is always {{false}} when read. Resetting statistics MUST reset all {{param|Channel.{i}.Duration}} parameters. Number of {{units}} since the Audience statistics were last enabled or reset. Number of instances of {{object|Channel}}. Table to record what the STB has been receiving. Time durations are recorded only for an AVPlayer's main AVStream (i.e. for TV channels being displayed in the main screen). Each entry corresponds to a given TV channel and is indexed by channel name (the instance number is chosen by the STB and is not related to the channel number). {{datatype|expand}} String describing the TV channel being displayed in the main screen. MUST be the value of the corresponding {{param|.AVStreams.AVStream.{i}.Name}} parameter. The cumulative duration of this channel in {{units}}. Details of STB CDS Push logical internal parameters. It references the object instance dedicated to the CDS Push service. Example: “Device.Services.StorageService.1.LogicalVolume.1.Folder.1”. {{numentries}} Content Item instance table. {{datatype|expand}} Unique Content Item reference as defined in {{bibref|TS102323}}, or {{bibref|RFC4078}}. Version number of the stored content item (a content item could be updated with a new version e.g. in case of errors in the video preventing the play out). When set to {{true}}, deletes this Content Item instance. The value is not saved in device state and is always {{false}} when read. Details of STB CDS Pull logical internal component. This object is present only if the user allowed (via his local STB UI) the remote management of the CDS Pull service. It references the object instance dedicated to the CDS Pull service. Example: “Device.Services.StorageService.1.LogicalVolume.1.Folder.1”. {{numentries}} Content Item instance table. {{datatype|expand}} Unique Content Item reference as defined in {{bibref|TS102323}}, or {{bibref|RFC4078}}. Version number of the stored content item (a content item could be updated with a new version e.g. in case of errors in the video preventing the play out). When set to {{true}}, deletes this Content Item instance. The value is not saved in device state and is always {{false}} when read. Service Provider instance table. {{datatype|expand}} Service Provider name. Service Provider domain URI. Service Provider’s Service Discovery Server. It MAY be configured in the format of IMS Public Service Identifier, or IP address or URL. Comma separated list of the BCG (Broadband Content Guide) server URLs the STB is currently retrieving IPTV service information from.