Tektronix MTM400A Manual

Tektronix MTM400A Manual

Dtv monitors
Hide thumbs Also See for MTM400A:
Table of Contents

Advertisement

Quick Links

Programmer Manual
MTM400A, IPM400A, and RFM300
DTV Monitors
077-0178-00
This document applies to firmware version 4.0
and above.
www.tektronix.com

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MTM400A and is the answer not in the manual?

Questions and answers

Summary of Contents for Tektronix MTM400A

  • Page 1 Programmer Manual MTM400A, IPM400A, and RFM300 DTV Monitors 077-0178-00 This document applies to firmware version 4.0 and above. www.tektronix.com...
  • Page 2 Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes that in all previously published material.
  • Page 3 Warranty 2 Tektronix warrants that this product will be free from defects in materials and workmanship for a period of one (1) year from the date of shipment. If any such product proves defective during this warranty period, Tektronix, at its option, either will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the defective product.
  • Page 4 In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the warranty period. If Tektronix is unable to provide a replacement that is free from defects in materials and workmanship within a reasonable time thereafter, Customer may terminate the license for this software product and return this software product and any associated materials for credit or refund.
  • Page 5: Table Of Contents

    1−1 MTM400A SNMP Community ........
  • Page 6 Table of Contents Service Logs ........... . 6−4 TMCC Information .
  • Page 7 ........3−2 Figure 3−4: MTM400A structure ......
  • Page 8: Table Of Contents

    Table of Contents DTV Monitors MPEG Transport Stream Monitor Programmer Manual...
  • Page 9: Model Numbers

    MTM400 have reduced functionality. References to the either “DTV Monitor” or “MTM400A” in this manual should be taken to refer to all of the DTV Monitors, that is the MTM400A, the IPM400A and the RFM300, unless otherwise specified.
  • Page 10 Preface Related Material The following documents are available on the Tektronix Web site (www.tektronix.com) and the docuemntation disk supplied with the instruments. Additional documentation, such as Read Me files, may also be included on the documentation disk. Item (Tektronix Part Number)
  • Page 11 Preface The following standards documents are available from the ISO (International Video Standards Standards Organization), www.iso.org: H STD-15 (RFC1157) Simple Network Management Protocol H STD-16 (RFC1155 and RFC1212) Structure and Identification of Management Information for TCP/IP-based Internets The following URLs access the Web sites for the standards organizations listed (the URLs listed were valid at the time of writing): H MPEG−2 standards (International Organization for Standards) www.iso.org/...
  • Page 12 Preface DTV Monitors MPEG Transport Stream Monitor Programmer Manual viii...
  • Page 13 Introduction...
  • Page 15: Snmp And Mibs

    Introduction This document specifies the DTV Monitor remote control and status monitoring interfaces available to a Management application. Two interfaces are provided; SNMP and an HTTP Web-based interface. NOTE. The DTV Monitor Programmer Interface MIB file accompanying this document contains entries not described in the manual. These entries should not be used.
  • Page 16 Introduction H DisplayString. Represents printable strings. H Object Identifier (OID). References other objects within SNMP. There are essentially three types of operations that can be performed on each object: H Get. Retrieves the value of an object. H GetNext. Retrieves the value of an object along with the OID of the next object available.
  • Page 17 Introduction A MIB Module is defined in a text file using ASN.1 (Abstract Syntax Notation One). For more detailed explanations of network management using SNMP, you can refer to The Simple Book: An Introduction to Internet Management (Marshall T. Rose, Prentice Hall, ISBN 0-13-451659-1). DTV Monitor SNMP Community SNMP provides a simple mechanism for security, there are community strings to govern read and write to the MIB;...
  • Page 18 Introduction resource, steps are taken to ensure that any management system subscribed for trap messages still requires these messages. So when a management system subscribes to trap messages, this is only for a few minutes. The management system must repeatedly subscribe in order to continue to receive trap messages. This provides protection in the case of a management system exiting improperly.
  • Page 19 DTV Monitor MIB...
  • Page 21: Mib Types

    DTV Monitor MIB Tektronix has been assigned the following root OID: iso.org.dod.internet.private.enterprises.128 Under this OID Tektronix can define its own MIB for various products. The MIB subtree for DTV Monitors is under the following OID: iso.org.dod.internet.private.enterprises.tek(128).tvt(5).tvtproducts(1). The tree is specified in the two ASN.1 text files: ADSYS.MIB defines the structure of device specific elements and ADMPEG.MIB defines the structure of...
  • Page 22: Figure 2−1: Time Stamp Storage

    DTV Monitor MIB This specifies which alarms are activated when an event occurs. It is an integer AlmValue type and can take combinations of the following values: 0x00000001 = Audible Alarm 0x00000100, 0x00000200, .. , 0x00001000= Relay1, Relay2, .., Relay 5 0x00010000, 0x00020000, ..
  • Page 23: Accessing Mib Objects

    DTV Monitor MIB Accessing MIB Objects This section describes how to access objects within the DTV Monitor MIB. SNMP Access The DTV Monitor SNMP agent fully supports the standard SNMP GetRequest, GetNextRequest, and SetRequest PDU operations. This document specifies the Operations access permissions for each object within the DTV Monitor MIB using the following conventions:...
  • Page 24 DTV Monitor MIB When a table is defined within the MIB, each table leaf object is represented by the following OID: ‘…<table_oid>.<table_entry_oid>.<table_leaf_object_oid>’. The ‘table_entry_oid’s within the DTV Monitor MIB are always given the value 1, and are not shown on the structure charts within this document because it would complicate the diagrams.
  • Page 25 MIB Group Overview...
  • Page 27: Figure 3−1: Overall Mib Structure

    MIB Group Overview The following sections define the groups of the MIB modules that make up the DTV Monitor SNMP interface. There is a split between MPEG-related and non-MPEG-related objects, and so the groups have been separated into two MIB modules.
  • Page 28 MIB Group Overview The system OID is: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).tek(128).tvt(5). tvtproducts(1).adSystem(16) Figure 3−2: System structure For a complete description of the system structure, refer to the System Structure section of this manual. The MPEG OID is: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).tek(128).tvt(5). tvtproducts(1).adMpeg(17) Figure 3−3: MPEG structure For a complete description of the MPEG structure, refer to the MPEG Structure section of this manual (page 5−1).
  • Page 29 MIB Group Overview The DTV Monitor (MTM400) OID is: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).tek(128).tvt(5).tvtmi bs(2).mtm400(16) Figure 3−4: DTV Monitor (MTM400) structure This area has one entry: product. Reading this entry returns the value “MTM400”. This section of the MIB is used to identify the product name. The standard mib-2 sysObjectID leaf (iso(1).org(3).dod(6).internet(1).mgmt(2).mib−2(1).system(1).sysObjectID(2)) returns the OID of this section (1.3.6.1.4.1.128.5.2.16) for identification.
  • Page 30 MIB Group Overview DTV Monitors MPEG Transport Stream Monitor Programmer Manual 3−4...
  • Page 31 System Structure...
  • Page 33: Figure 4−1: System Structure

    System Structure Figure 4−1: System structure System Information Group Figure 4−2 shows the structure of the System Information Group, which provides access to attributes of the most general nature, such as the product name and the installed software . Figure 4−2: System information group structure DTV Monitors MPEG Transport Stream Monitor Programmer Manual 4−1...
  • Page 34 System Structure For the DTV Monitors, this is fixed as “MTM400”. This can be used to Product Name positively identify a DTV Monitor instrument. The format of this item is defined as: Name: adsysProductName OID: 1.3.6.1.4.1.128.5.1.16.1.1 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adSystem(16).adsysInfo(1).adsysProductNa me(1) Module: AD-SYSTEM-MIB...
  • Page 35 System Structure The format of this item is defined as: Global Maintenance Mode Name: adsysGlobalMaintenanceMode OID: 1.3.6.1.4.1.128.5.1.16.1.5 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adSystem(16).adsysInfo(1).adsysGlobalMai ntenanceMode(5) Module: AD-SYSTEM-MIB Parent: adsysInfo Numerical syntax: Integer (32 bit) Base syntax: INTEGER Composed syntax: SimpleBoolean Status: mandatory Max access: read-write Description: Setting this variable to true sets the whole box into global maintenance...
  • Page 36: Figure 3−2: System Structure

    System Structure The UTC time of the box; that is, the number of seconds since midnight 1st UTC Time January 1970. Variable Type Access adsysUTCTime (12) Integer The UTC time of the box. Get/Set Number of minutes to add to UTC time to get to local time frame - this may be UTC Offset negative.
  • Page 37: Box Event Group

    Each event also has an alarm value associated with it, which indicates the type of alarm that will be triggered (such as audible or relay), if the event goes into error. The full list of box events is specified in the MTM400A, IPM400A, and RFM300 Test Parameter and Configuration File Technical Reference.
  • Page 38: Figure 4−3: Box Event Group Structure

    The following table describes the objects within the Box Events Group. The Box Alarm table contains the state and alarm value for each box-wide event Box Events as specified in the MTM400A, IPM400A, and RFM300 Test Parameter and Configuration File Technical Reference. Variable...
  • Page 39 System Structure textual MIB variables would typically be downloaded once when the manage- ment application starts, or not at all if you only want to display some particular fixed set of events. Unsupported Events. Box events that are not supported for the DTV Monitors will have an event state of 0x0000.
  • Page 40: Figure 4−4: Box Log Group Structure

    System Structure Box Log Group Figure 4−4 shows the structure of the Box Log Group, which provides access to the box specific log items. Figure 4−4: Box log group structure The following table describes the single leaf objects within the Box Log Group. It should be noted that some of these values also apply to the stream logs.
  • Page 41 System Structure The first and last entry indices can be used to access the required elements from the Log Table, which is shown in the following table. The log entry table contains information on the event log generated by the DTV Log Table Monitor, and is defined as: Variable...
  • Page 42: Network Settings

    System Structure Network Settings The network settings table provides information on the device’s network settings. The information available is defined as: Variable Type Access aNetIpAddress(1) The IP address of the device. Get/Set address aNetGatewayAddress(2) The IP address of the gateway Get/Set address for the device.
  • Page 43 System Structure Structure View Reserved Repetition Graphs Reserved Bitrate Limits Reserved Pid Groups Templates Reserved Template Tree View RF Tests Recording RF Trends PCR Graphs 31 − 37 Reserved Auto Learn Service Log 39 − 40 Reserved Pid Variability Wide IP Tests Scheduling PES Thumbnails Reserved...
  • Page 44 System Structure DTV Monitors MPEG Transport Stream Monitor Programmer Manual 4−12...
  • Page 45 MPEG Structure...
  • Page 47: Mpeg Interfaces Group

    MPEG Structure Figure 5−1: MPEG structure MPEG Interfaces Group Figure 5−2 shows the structure of the MPEG Interfaces Group, which contains information on each of the MPEG Interfaces connected to the DTV Monitor. The terms ‘Stream’ and ‘Interface’ are used interchangeably. Figure 5−2: MPEG interfaces group structure DTV Monitors MPEG Transport Stream Monitor Programmer Manual 5−1...
  • Page 48: Figure 5−3: Mpeg Interfaces Table Structure

    MPEG Structure MPEG Interfaces Table Figure 5−3: MPEG interfaces table structure DTV Monitors MPEG Transport Stream Monitor Programmer Manual 5−2...
  • Page 49 MPEG Structure The MPEG Interfaces table is similar in concept to the Interfaces Group (ifTable) defined in MIB-II (RFC1213), which provides a list of all network interfaces that are installed in a device supporting network management. As with the ifTable, it allows a common network management mechanism to be used to describe and control MPEG interfaces regardless of the application.
  • Page 50 MPEG Structure Variable Type Access mifChosenInterface- Integer Interface type to use for this stream. Get/Set Type(13) If more than one interface of this type is available, the first one will be chosen. To select an interface other than the first one, use ‘mifChosenIn- terfaceIndex’...
  • Page 51 MPEG Structure Variable Type Access mifSchedulerEnabled(21) Integer Specifies whether scheduler is Get/Set enabled. 0 = disabled 1 = enabled mifLogScramble- Changes(22) mifScheduleName (23) Octet String The name of the schedule file currently loaded. mifIIPPid(25) Integer The pid on which the ISDB-T Get/Set Information Packets (IIP) are trans- mitted.
  • Page 52 MPEG Structure Variable Type Access mifNetworkLoad(39) Integer A measure of unit load, 0...100%, if this figure is high, reduce requests mifUserPermissions(40) Integer Used to enable streaming video [bit Get/Set 1], audio [bit 2] or configuration slot loading [bit 0] for the standard user login mifNonNullTSBitRate(41) Integer...
  • Page 53: Figure 3−3: Mpeg Structure

    MPEG Structure Standard Region DigiCipher® II Hybrid (6) ATSC (3) Standard (0) A78 (1) SCTE142 (2) ISDB (3) ISDB-S (0) (Japanese standard) ISDB-T (1) (Japanese standard) ISDB-T (2) (Japanese single segment standard) Chinese (4) GY/Z 174-2001 (0) (DVB with explicit GB2312 content) GB2312 (1) (DVB with implicit GB2312 content) DigiCipher®...
  • Page 54 MPEG Structure Default Channels Table. The Default Channels table contains the name of the stored LBand Settings to use for each interface, and is defined as: Variable Type Access LbDefaultChannelmifIndex(1) Integer The MPEG interface for which this default channel applies. LbDefaultChannelName(2) Octet The name of the selected...
  • Page 55 MPEG Structure The table is indexed by MPEG Interface followed by Channel Index. The stored LBand settings are persistent across all interfaces, so the Channel Index is used to reference which settings should be used from this global list. This has the consequence that if any of these values are changed on one interface, it will be changed across all interfaces.
  • Page 56 MPEG Structure Variable Type Access lbCardTEFCount(17) Integer TEF count. lbCardSignal(18) Integer Signal Strength % * 10 The table is indexed on MPEG Interface. As an example, in order to reference the Viterbi Rate for interface 1, use the following OID: ‘….lbCardViterbiRate.1’.
  • Page 57 MPEG Structure Variable Type Access tmccmifIndex(1) Integer Index tmccAcquisition(2) Integer Specifies whether to extract Get/Set TMCC information. tmccBufferReset(3) Integer Determines whether the buffer is reset. tmccEmergencySignal(4) Integer Determines whether the emer- gency signal is on. tmccChangeIndication(5) Integer Determines whether the change indication is set.
  • Page 58: Figure 5−5: Qam Information Group Structure

    MPEG Structure QAM Information Group. Figure 5−5 shows the structure of the QAM Information Group, which contains information on the QAM Settings where appropriate. Figure 5−5: QAM information group structure Status Table. The Status table contains the name of the selected channel settings and the status of the QAM card.
  • Page 59 MPEG Structure Variable Type Access qamBER (5) Integer The BER (0 to 255). (See BER values below for specific values.) qamCardMER(6) Integer MER db * 10 qamCardActualBER(7) Integer BER Ratio * 10 qamCardEVM(8) Integer EVM % * 10 qamCardTEFCount(9) Integer TEF count.
  • Page 60 MPEG Structure QAM Channel Settings Table. The QAM Channel Settings table contains the stored QAM settings that can be used for each interface, and is defined as: Variable Type Access qamChannelSettingsmifIndex Integer The MPEG interface for which these channel settings apply. qamChannelIndex (2) Integer Index to the stored channel...
  • Page 61 MPEG Structure Variable Type Access qamChannelCarrier Integer 0 = Normal, 1 = Wide. Get/Set AcquisitionRange(14) qamChannelTroubleShoot(15) Integer 0 = off, 1 = on. Get/Set The table is indexed by the MPEG Interface followed by the Channel Index. The QAM channel settings are persistent across all interfaces, so the Channel Index is used to reference which settings should be used from this global list.
  • Page 62 MPEG Structure This table allows a card to be reset, and the input to be selected, and contains the Control Table following elements: Variable Type Access MifIndex (0) Table index cardIndex Table index resetCard Integer Setting this to any value resets the card.
  • Page 63 MPEG Structure This table allows settings to be added and deleted, and contains the following Input Settings Control elements. Table Variable Type Access MifIndex (0) Table index cardIndex Table index inputIndex Table index addSettings Octet Set this value to add settings String with the specified name to the list of settings for the input.
  • Page 64 MPEG Structure This contains the parameter values for the input of a card, and consists of the Parameters Table following elements Variable Type Access MifIndex (0) Table index cardIndex Table index inputIndex Table index settingsIndex Table index parameterIndex Table index parameterValue Octet String The value of the parameter.
  • Page 65 MPEG Structure This section returns the metrics from CIP cards. The cards vary, so not all Measurements measurements are appropriate to all cards. The following metrics apply to various interface cards, see the section on retrieving the card details to determine which applies to which. Index Name: rfmIndex...
  • Page 66 MPEG Structure Lock Name: rfmLock OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.2 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmLock(2) Module: AD-MPEG-MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: Lock status of the interface, 0=unlocked 1=locked Power Name: rfmPower OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.3 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1).
  • Page 67 MPEG Structure Name: rfmSNR OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.5 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmSNR(5) Module: AD-MPEG-MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: SNR in dBm * 100 BER Pre RS error correction Name: rfmBERPRERS OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.6 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).
  • Page 68 MPEG Structure BER Post RS error correction Name: rfmBERPOSTRS OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.8 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmBERPOSTRS(8) Module: AD-MPEG-MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: BER post reed-solomon correction * 1e9 Name: rfmCNR OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.9 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).
  • Page 69 MPEG Structure Name: rfmMER OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.11 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmMER(1 1) Module: AD-MPEG-MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: MER in dBm * 100 Name: rfmEVM OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.12 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmEVM(12) Module: AD-MPEG-MIB Parent: mifMetric...
  • Page 70 MPEG Structure Dropped Packet Rate (DPR) Name: rfmDPR OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.14 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1). tek(128).tvt(5).tvtproducts(1).adMpeg(17).mpegInterfaces(1). mifMeasurements(14).mifMetric(1).rfmDPR(14) Module: AD-MPEG-MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: Dropped packets per second Packet Interarrival Time (PIT) Name: rfmPIT OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.15 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).
  • Page 71 MPEG Structure Selected Session Bitrate Name: rfmBRS OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.19 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).tek(128).tvt(5).tvtp roducts(1).adMpeg(17).mpegInterfaces(1).mifMeasurements(14).mifMetri c(1).rfmBRS(19) Module: AD−MPEG−MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: IP bit rate in the selected session in bits per second All Sessions Bitrate Name: rfmBRA OID:...
  • Page 72 MPEG Structure COFDM Cell ID Name: RFMCellID OID: 1.3.6.1.4.1.128.5.1.17.1.14.1.22 Full path: iso(1).org(3).dod(6).internet(1).private(4).enterprises(1).tek(128).tvt(5).tvtp roducts(1).adMpeg(17).mpegInterfaces(1).mifMeasurements(14).mifMetri c(1).rfmCellID(22) Module: AD−MPEG−MIB Parent: mifMetric Numerical syntax: Integer (32 bit) Max access: read-only Description: OFDM Cell ID . Reserved. Network Information IP Sessions. IPSessionTable. SNMP access to the IP traffic table. sessionIndex INTEGER 2 −...
  • Page 73: Mpeg Events Group

    Each event also has an alarm value associated with it, which indicates the type of alarm that will be triggered (for example, audible or relay), if an error occurs. The full list of box events is specified in the MTM400A, IPM400A, and RFM300 Test Parameters and Configuration File Technical Reference.
  • Page 74 MPEG Structure Variable Type Access mifevtMifIndex (1) Integer The MPEG interface for which these events apply. mifevtEventIndex (2) EvId An index uniquely identifying the event. mifevtEventName (3) Octet A short textual title for this String event. mifevtEventDescription (4) Octet A brief description of this event. Get String mifevtEventState (5) EvState...
  • Page 75 MPEG Structure Alarms Available Variable Type Access mevtAlarmsAvailable (14) AlmValue Indicates the types of alarms that can be triggered for stream events. The value returned is a bitfield that shows which alarm action can be enabled/ disabled. Buzzer = 0x00000001 Recorder = 0x00000020 Relay1 = 0x00000100 Relay2 = 0x00000200...
  • Page 76: Mpeg Pids Group

    MPEG Structure Variable Type Access mevtPidEventState (4) Evstate Reading this returns the cur- Get/Set rent event status for the PID as described for the EvState type. Writing any value will reset the event. The effect of resetting is to change a ‘yel- low’...
  • Page 77 MPEG Structure The PID Status table contains PID and Program status information for each PID Status Table interface, and is defined as: Variable Type Access pidstMifIndex (1) Integer MPEG interface for which these elements apply. pidstClearLimits (2) Integer Setting this clears all the PID Get/Set rate limits for this interface.
  • Page 78 MPEG Structure The PID table contains information for each PID on each interface, and is PID Table defined as: Variable Type Access pidsMifIndex (1) Integer The MPEG interface for which these readings apply. pidsPidIndex (2) Integer The PID index - this is the PID number + 1 to avoid a 0 index.
  • Page 79 MPEG Structure that subsequent requests for PID elements may result in values for a different set of PIDs. Consequently, if a client application requests all of the pidsMin- Rates followed by pidsMaxRates, it is not guaranteed that the values obtained will be for exactly the same set of PIDs. Therefore, in order to force the agent to include a PID in its list, the management application should set the corresponding Min and Max limits.
  • Page 80 MPEG Structure Variable Type Access progsPMTTestEnabled (9) Simple Determines whether PMT Test Get/Set boolean is enabled for this program. 0 = disabled, 1 = enabled. progsPMTTestState (11) Evstate Reading this returns the current Get/Set state of the PMT Test for the program.
  • Page 81 MPEG Structure The SFN table contains the Single Frequency Network Information for each SFN Table interface, and is defined as: Variable Type Access sfnMifIndex (1) Integer MPEG interface for which these elements apply. sfnSynchronisation (2) Integer The SFN Synchronization Scheme (usually 0). sfnSectionLength (3) Integer Number of bytes following the...
  • Page 82 MPEG Structure The table is indexed by MPEG Interface. As an example, in order to reference sfnTPSMip for interface 1, use the following OID: ‘…sfnTPSMip.1’. The PID Group table provides access to PID group related information for each PID Group Table interface, and is defined as: Variable Type...
  • Page 83: Mpeg Structure Group 2

    MPEG Structure The PID Group PIDs table provides access to the lists of PIDS defined for each PID Group PIDs Table group. It is defined as follows: Variable Type Access pidGroupPidsMifIndex (1) Integer MPEG interface for which these PID group PIDs apply. pidGroupPidsGroupIndex (2) Integer The index of the group of...
  • Page 84: Figure 5−8: Structure Group 2 Structure

    MPEG Structure of 0x00. The use of these MPEG Table identifiers within the Structure Group is consistent with this standard. Figure 5−8: Structure group 2 structure The SNMP Serial Number table contains the serial numbers that should be used Serial Number Table to index the SNMP Size and Data tables in order to obtain the most up-to-date information for each MPEG Table.
  • Page 85 MPEG Structure As an example, the OID ‘…strctserNumber2.1.67.1081.54’ would return the most recent serial number for the DVB table id 66 (Service Description Table) where: .1. = Stream 1 (default) .67. = table id + 1 .1081.54 = unique identifier of the subtable This contains the total number of bytes stored for a specified version (referenced Info Table by serial number) of each MPEG Table on each interface.
  • Page 86 MPEG Structure This table contains the data from each version (referenced by serial number) of Data Table each MPEG Table on each interface split which has been split into ‘chunks’. Variable Type Access strctMifIndex (1) Integer The MPEG interface for which these readings apply.
  • Page 87: Mpeg Log Group

    MPEG Structure The complete MPEG structure table for interface i, table number t, serial number s is formed by concatenating all of the instances of this object of the form: strctTableData.i.t+1.s.* where ‘*’ indicates all values of strctChunkIndex. The chunks should be reassembled with these final index values in ascending order.
  • Page 88 MPEG Structure Variable Type Access mlogOldestIndex (3) LogIndex The index of the most oldest log entry on this interface. mlogClear (4) Integer Writing any value to this vari- Get/Set able will clear the stream log. Reading this field has no mean- ing.
  • Page 89: Mpeg Trap Control

    MPEG Structure MPEG Trap Control The trap control group provides the variables to support the traps sent and the configuration items to control trap generation. Clients subscribe to traps by writing their IP address into trapSink; they are automatically deleted from the notification list after trapSinkTimeout minutes. So a client should subscribe every few minutes.
  • Page 90 MPEG Structure Name Type Access Comment TrapActualValue String TrapDuration Integer TrapStream Integer Stream number, set to 1 in DTV Monitor. TrapSinkTimeout Integer Minutes before unsubscribing trap client, 0 is infinite. trapRemoveSink IpAddress Removes IP Address of Client to be sent traps.
  • Page 91: Mpeg Configuration Group

    MPEG Structure MPEG Configuration Group Table 5−10 shows the structure of the MPEG Configuration Group that manages the stream configuration slots. Figure 5−10: MPEG configuration group The Configuration Slot table contains items for copying and storing stream Configuration Slot Table configuration slots, and is defined as: Variable Type...
  • Page 92 MPEG Structure Variable Type Access currentConfigurationSlotName Octet string This returns the name of the configuration last copied to the active slot. clearStoredSlot (6) Integer Setting this clears the contents Get/Set of the specified stored configu- ration slot. Reading this value has no meaning.
  • Page 93: Mpeg Parameters Group

    MPEG Structure If you are using windows and have the cygwin utilities [http://www.net- snmp.org/] this can be done from the command line: snmpset -v 1 -c public DTVMonitorAddress 1.3.6.1.4.1.128.5.1.17.8.1.1.2.1 i 2 Uploading the configuration slots to begin with requires an HTTP post com- mand, which is not so easy from the command line and would require a utility program.
  • Page 94 MPEG Structure The PID Parameter table provides access to the default PID parameter values, PID Parameter Table and is defined as: Variable Type Access pidParameterMifIndex (1) Integer The MPEG interface asso- ciated with these parame- ters. pidParameterIndex (2) Integer The unique Id of the re- quired PID parameter.
  • Page 95 MPEG Structure The Program Parameter table provides access to the default Program parameter Program Parameter Table values, and is defined as: Variable Type Access programParameterMifIndex (1) Integer The MPEG interface asso- ciated with these parame- ters. programParameterIndex (2) Integer The unique Id of the re- quired Program parameter.
  • Page 96 MPEG Structure The PID Group Parameter table provides access to the default PID group PID Group Parameter parameter values, and is defined as: Table Variable Type Access pidGroupParameterMifIndex (1) Integer The MPEG interface asso- ciated with these parame- ters. pidGroupParameterIndex (2) Integer The unique Id of the re- quired PID Group parame-...
  • Page 97: Mpeg Record Group

    MPEG Structure MPEG Record Group The MPEG Record table provides the control and monitoring interface for the DTV Monitor triggered recording function, and is defined as follows: Variable Type Access mpegRecordMifIndex (1) Integer The MPEG interface. mpegRecordState (2) Integer State of recording: 0 = Idle 1 = Waiting for Trigger 2 = Recording in Progress...
  • Page 98 MPEG Structure Variable Type Access mpegRecordDesiredSize (13) Integer Desired size of recording in Get/Set packets. mpegRecordTriggerTime (14) Octet string This returns the time at which the trigger for the current recording occurred, or zero if not currently meaningful. DTV Monitors MPEG Transport Stream Monitor Programmer Manual 5−52...
  • Page 99 Web Server URLs...
  • Page 101 Web Server URLs The following sections define the URLs supported by the DTV Monitor Web Server. Note that using the Web interface will not enable access to option dependent data, for example schedules or service logging. Configuration http:://<DTV Monitor IP Address>/cgi-bin/uploadconfigura- Upload Configuration tion?stream=x&slot=y The ‘stream’...
  • Page 102 Web Server URLs Status http:://<DTV Monitor IP Address>/cgi−bin/eventstates?start=x&end=y Stream Events http:://<DTV Monitor IP Address>/cgi−bin/boxeventstates?start=x&end=y Box Events These URLs have optional start and end event identities; if not specified, the DTV Monitor will return the status of all events. The optimal solution is controlled status polling through SNMP. If this cannot be implemented, then collecting all statuses through HTTP is more efficient than polling all the events through SNMP.
  • Page 103 Web Server URLs Recording http:://<DTV Monitor IP Address>/data/recording.mpg?start=x&end=y Download Recording This URL is used to download a stream recording. The ‘start’ and ‘end’ parameters define the range of packets of interest. http:://<DTV Monitor IP Address>/recording/status.xml Contolling Recording Returns the current status of recording in XML format. http:://<DTV Monitor IP Address>/control?arm=1&clear=1 This URL allows you to clear and/or initiate a recording.
  • Page 104: Service Logs

    Web Server URLs The Stream and Device Log downloads can also take a language parameter. For example, http://<DTV Monitor IP Address>/cgi-bin/devicelog?start=x&end=y&lang=x where x=24 (English), 52 (Japanese) or 134 (Chinese). http:://<DTV Monitor IP Address>/cgi−bin/eventlogindices Log Indices http:://<DTV Monitor IP Address>/cgi−bin/devicelogindices Where it is not convenient to use SNMP to get the current indices, it is possible to get this information via HTTP.
  • Page 105: Tmcc Information

    Web Server URLs TMCC Information http:://<DTV Monitor IP Address>/cgi-bin/tmcciipinfo Download TMCC IIP Information This URL is used to download TMCC and IIP information for ISDB-T streams. The page is in the following format: <TMCCIIPInfo> <TMCCIdentifier>2</TMCCIdentifier> <BufferResetControlFlag>1</Buf ferResetControlFlag> <SwitchOnControlFlag>0</SwitchOnControlFlag> <InitialisationTimingHeadPacketFlag>0</InitialisationT imingHeadPacketFlag> <FrameHeadPacketFlag>0</FrameHeadPacketFlag>...
  • Page 106: Templates

    Web Server URLs Templates http:://<DTV Monitor IP Address>/maketemplate.xml General Template Information This command will generate a standard format DTV Monitor configuration file. It will contain a strict template for the current stream, except for the rating information which is set a lax as possible. This information can be used with the template testing in the DTV Monitor, or as a general inventory of a stream that can be used for comparison at a later date.
  • Page 107 Web Server URLs <DVBAcceptableValues> <DVBRatingValue>0</DVBRatingValue> </DVBAcceptableValues> </DVBRatingTemplate> </DVBRatingList> </RatingList> </Service> </ServiceList> </PS56> </Stream> </Streams> </MTM400Configuration> http:://<DTV Monitor IP Address>/cgi-bin/templateresults Template Results This page is used to drive the DTV Monitor template test UI; it consists of a labels section used for localization, followed by a structure showing the expected and actual values of items specified in the template.
  • Page 108: Licensing 6−8

    Web Server URLs </Labels> <TransportStreamId State= Green" ActualValue= 419">419</TransportStreamId> <NetworkId State= Green" ActualValue= 1220">1220</NetworkId> <OriginalNetworkId State= Green" ActualValue= 901">901</OriginalNetworkId> <OtherServicesAllowed State= Green" ActualValue= 0">0</OtherServicesAllowed> <ServiceList State= Red"> <Service Number= 4173" State= Red"> <Constraint State= Red" ActualValue= Present">Present</Constraint> <ServiceType State= Green" ActualValue= 1">1</ServiceType> <ServiceName State= Green"...
  • Page 109: Debug Information

    Web Server URLs Debug Information http:://<DTV Monitor IP Address>/cgi−bin/getavailableinterfaces Interfaces Found This URL will let you double check the fitted interface cards. http:://<DTV Monitor IP Address>/info Data Logging This page is used internally during testing the output can be logged to give an indication of various items over time.
  • Page 110 Web Server URLs <PCRMSG>21678263</PCRMSG> <SBYTEMSG>40</SBYTEMSG> <SECTMSG>37607724</SECTMSG> <FREETAB>9316401</FREETAB> <PEAKTAB>10485760</PEAKTAB> <FREENET>452224</FREENET> <PEAKNET>1048576</PEAKNET> <RAWQP>29</RAWQP> <APPQP>29</APPQP> <SYSQP>29</SYSQP> <RAWQPMAX>29</RAWQPMAX> <APPQPMAX>29</APPQPMAX> <SYSQPMAX>29</SYSQPMAX> <lastcmd>none</lastcmd> <lastval>0.000000</lastval> </DespinaStatus> A secondary use is to control the RF interface cards during the validation. Most controls are possible, a selection of which is shown below: http:://<DTV Monitor IP Address>/info?UUT_FREQ=1234 http:://<DTV Monitor IP Address>/info?UUT_QAM =64 http:://<DTV Monitor IP Address>/info?UUT_SYM =20000...
  • Page 111: Controls

    Web Server URLs These commands can be used for items like scanning channels or even as a rudimentary spectrum analyzer. http:://<DTV Monitor IP Address>/idon Box Identification http:://<DTV Monitor IP Address>/idoff In a large system it can be hard to identify units for service in a rack. This command will cause the network LED on the front panel to flash.
  • Page 112: Table Information

    Web Server URLs Table Information http:://<DTV Monitor IP Address>/cgi-bin/tableserialnumbers Table Version Information <TableSerialNumbers> <Tables Update= Incremental"> <Table ID= 0" SerialNumber= 21" /> <Table ID= 1" SerialNumber= 8" /> <Table ID= 2" SerialNumber= 455" /> <Table ID= 3" SerialNumber= 7" /> </Tables>...
  • Page 113: Pcr/Pts Information

    Web Server URLs For each table type, this information is used to break down each available instance of the required table. In the example above, there are two PMT tables that can be downloaded. The ID is passed to the subtabledata URL to specify the required data.
  • Page 114: Repetition Information

    Web Server URLs Using PTS values are much simpler than using PCR values, but only returns a timestamp each time a PTS is received. http:://<DTV Monitor IP Address>/cgi-bin/ptsvalues?stream=1&pid=600 <PTSValues Stream= 1" PID= 600" UTCOffset= 60"> <PP5>700</PP5> <PTSResults> <PTSResult UTCTime= 1122851546098"></PTSResult> <PTSResult UTCTime= 1122851546038"></PTSResult>...
  • Page 115 Web Server URLs http:://<DTV Monitor IP Address>/cgi-bin/intersection- Download Inter-Section gap?stream=x&pid=p&tableext=a.b Timing Information Using details for the actual NIT: http://<DTV Monitor IP Address>/cgi-bin/intersection- gap?stream=1&pid=16&tableext=64.12290 results in the data: <InterSectionGaps UTCOffset=“60” Parameter=“PS14” Limit=“25”> <Interval UTCTime=“1122883737581832”>9984</Interval> <Interval UTCTime=“1122883747581355”>9985</Interval> <Interval UTCTime=“1122883757583120”>9987</Interval> ... more ... </InterSectionGaps>...
  • Page 116: Rf Card Information

    Web Server URLs http:://<DTV Monitor IP Address>/cgi-bin/cycgroupreptninterval?stream=x&ta- Download Cycle Group bleext=a.b Repetition Information This is for ISDB-T mode only; it is to graph the particular variant of EITs in use in Japan. UTC Offsets for this data is DST independent. RF Card Information There are 2 classes of RF interface card in use for the DTV Monitor, known as SZ or CIP cards.
  • Page 117 Web Server URLs H MetricID - This number is used to inform the RF testing code which item corresponds to tested metrics And for graphs H Type - the type of the graph. Valid values are B, S, H, T, which represent Bitmap, Scatter, Histogram or Trend graphs H XTitle - the title of the x axis H YTitle - the title of the y axis...
  • Page 118 Web Server URLs <Units>KHz</Units> −− A numeric setting −− <Image>text</Image> <EnumerationID>0</EnumerationID> −− All items are returned in a single poll, this is this items position −− <PollIndex>1</PollIndex> <MetricID>0</MetricID> </ParameterDescription> </ParameterDescriptions> <IndicatorDescriptions> <IndicatorDescription ID= 0"> <Name>Overall RF lock</Name> <CMDString>LOK</CMDString> <High>1</High> <Low>0</Low> <Nominal>0</Nominal>...
  • Page 119 Web Server URLs <EnumerationID>0</EnumerationID> <PollIndex>4</PollIndex> −− This is a cross reference to a standard metric −− <MetricID>7</MetricID> </IndicatorDescription> </IndicatorDescriptions> <Graphs> <Graph ID= 0"> −− A scatter graph, trend and sweep are also possible −− <Type>S</Type> <Name>RF constellation (data carriers)</Name> <CMDString>CST</CMDString> <XTitle>I</XTitle>...
  • Page 120 Web Server URLs A simplified version of the above is available when RF Testing has been enabled. Those indicators that have a metric ID set are used to drive these values. http:://<DTV Monitor IP Address>/cgi-bin/metrics <Metrics> <LOCK>1.00000</LOCK> <MER>25.8000</MER> <MER_DRIFT>0.626917</MER_DRIFT> <EVM>3.90000</EVM> <EVM_DRIFT>−0.372383</EVM_DRIFT>...
  • Page 121: Thumbnail Data Interface

    Web Server URLs http:://<DTV Monitor IP Address>/cgi-bin/ updateprm?stream=1&card=0&in- Updating Parameters put=0&prm=TLA&value=y The TLA is taken from the card description commands; the value must be in range. The DTV Monitor will respond with a success or failure message. For example, this command would set the frequency of the card in the examples above to 641.833 MHz.
  • Page 122 Web Server URLs The following URL will return an XML page listing the thumbnail data available Available Thumbnail for collection: http://<DTV Monitor IP Address>/cgi-bin/availablethumbnails. Information The data is returned in the following structure: <?xml version=”1.0” encoding=”UTF−8” standalone=”yes” ?> <AvailableThumbnails> <PID pid=”1” streamtype=”2” status=”ok” width=”1440”...
  • Page 123 Web Server URLs [Version 4.1 onward] The following field has been added: Name Description Active format descriptor for this PID The following URL will return an XML page with details of the video stream Video Attribute Data attributes: http://<DTV Monitor IP Address>/cgi-bin/videoattributes?PID=xxx&serial=yyy. The serial number (yyy) is optional, if it is left out, the latest data will be returned.
  • Page 124 Web Server URLs tails are designed to ensure that the video data may be correctly associated with a service during polling.−−> <SettingID>140160081</SettingID> <SettingName>100MHZ</SettingName> </StreamAttributes> [Version 4.1 onward] The following field has been added: Name Description Active format descriptor for this PID The following URL will return binary data: Available Thumbnail Data http://<DTV Monitor IP Address>/cgi-bin/getthumbnail?pid=xxx&serial=yyy...
  • Page 125: Polling Interface

    Web Server URLs Polling Interface The polling process can be controlled and monitored through SNMP when the process has been configured. Configuring polling is achieved by uploading XML files. These files can be complex, so the DTV Monitor has a URL that can be accessed to retrieve a preconfigured XML file.
  • Page 126 Web Server URLs if your DTV Monitor is set with a dwell time of 30 s and an acquisition time of 6 H In the normal case, the unit will spend 6 s letting the interface card change settings and settle, then 24 s (that is, 30 s minus 6 s) doing the testing. Testing isi- tion...
  • Page 127 Web Server URLs A simple configuration file is shown below. This file causes a QAMB card to Configuration File step between three presets. It spends two minutes on one preset and one minute on each of the other two before repeating. <?xml version="1.0"...
  • Page 128 Web Server URLs There are a number of points to note: <PF1> - Optional; if not specified here, the stream can be stopped and started through SNMP (see MPEG Interfaces Group on page 5−1). <PollChannels> - AcquireTime and Dwell are optional here; if they are omitted, they must be specified for every script item.
  • Page 129 Web Server URLs <StopOnPriority1> - Optional; Set to 1 to stop polling on priority 1 error. <StopOnPriority2> - Optional; Set to 1 to stop polling on priority 2 error. The DTV Monitor accumulates the status of each preset as it is visited over Polling Status Overview time.
  • Page 130: Pid Retransmission

    Web Server URLs In the preceding XML code, the attributes are as follows: Attribute Description Sequence If this does not increment, nothing has changed since the last time the data was collected. Datasize Reserved. Index The display order. 0 is the header. Fixed for that preset, it is the value that can be passed back to stop polling and select a preset in a single operation.
  • Page 131: Multicast Subscriptions

    Web Server URLs A typical URL may look as follows: http://192.168.204.196/stream/retransmit?stop=true&start=true&des - taddr=224.1.2.6&dest- port=4354&pid1=2328&pid2=0&pid3=258&pid4=2329&pid5=0&time=0&svc=694 0&pmt=258&pri=9 This URL routes part of an MPTS to an IGMP group address until stopped. It also modifies the service information to create an SPTS so that a simple IPTV STB can decode and display the service.
  • Page 132: Session Aliases

    Web Server URLs Session Aliases The GbE interface card can maintain meaningful aliases for each IP session. These may be uploaded to the unit via this URL: cgi−bin/uploadaliases And an associated download function: cgi−bin/dnloadaliases The file format is XML: <?xml version=”1.0” encoding=”UTF−8”?> <SessionAliasDB xmlns:xsi=”http://www.w3.org/2001/XMLSchema−instance”...
  • Page 133: Daylight Savings Time

    Web Server URLs and one for IPv6: /ping6?addr=<pinged>&prefixlen=<prefix>&gate=<gateway> For both URLs the results are retrieved with the same URL: /pingres?seq=<number> The ping URLs return a sequence number to be used when picking up the result. The result file format is XML: <?xml version=”1.0”...
  • Page 134: Upgrade Notes − Version 3.0 To Version 3.1

    The format is chosen to be easy to change should the DST rules change, the file is available from Tektronix, but may easily be created, the only complicated figure is the day of the year In Microsoft Excel the following formulae will calculate this figure from a date: =[R][C]−DATE(YEAR([R][C]),1,0)
  • Page 135 Web Server URLs Should there be a problem programming the interface card, the user will need to upload the same DTV Monitor firmware file again to retry programming. The GbE card configuration has had to change to accommodate new features and to rationalize some features which did not fit properly into the preset model.
  • Page 136 Web Server URLs Version 3.0 Format <Setting Name = ”PresetName”> <!−− used in the UI and polling script −−> <Gating>2</Gating> <!−− Fixed for Gbe card −−> <Parameters Update=”Absolute”> <!−− Overwrite not merge −−> <Parm Cmd = ”ASI”>0</Parm> <!−− ASI Smoothing −−> <Parm Cmd = ”BIP”>0i192.168.205.114</Parm>...
  • Page 137: Table 6−1: Summary Of Gbe Interface Card Parameters

    Web Server URLs <Parm Cmd = ”QIS”>0p2099::999</Parm> <!−− − IPv6 Address −−> <Parm Cmd = ”QMA”>0i0</Parm> <!−− − Multicast Address −−> <Parm Cmd = ”QME”>2</Parm> <!−− Multicast −−> <Parm Cmd = ”QMK”>0</Parm> <!−− Multicast Keep−alive −−> <Parm Cmd = ”QMS”>0i0</Parm> <!−− − Source Address −−> <Parm Cmd = ”QPM”>3</Parm>...
  • Page 138 Web Server URLs Table 6−1: Summary of GbE interface card parameters (Cont.) Parameter V3.0 V3.1+ Description Remove IGMP subscription, >= v3.1 see Multicast Subscriptions, page 6−31 Session IP filter, none, source, destination or both. Session MAC filter, none, source, destination or both. Ping address, >= v3.1 see Ping Commands, page 6−32 Ping control, >= v3.1 see Ping Commands, page 6−32 IPv6 addressing, stateless, manual or DHCPv6...

This manual is also suitable for:

Ipm400aRfm300

Table of Contents