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 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.
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/...
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.
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...
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, ..
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.
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...
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...
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.
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.
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.
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...
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...
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 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...
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.
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 −...
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...
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...
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...
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.
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.
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.
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.
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-...
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 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.
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.
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>...
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.
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...
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.
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.
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>...
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>...
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...
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.
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.
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.
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”...
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”...
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>...
Need help?
Do you have a question about the MTM400A and is the answer not in the manual?
Questions and answers