Download DirecTV Receivers Serial Control Module
Transcript
DirecTV Receivers Serial Control Module Application Guide Description This module allows you to control supported DirecTV receivers, including the D10, D11, D12, H10, R15, R16, H20, H21, HR20, HR21 and HR21P via serial control, including limited feedback. Note that not all receivers implement the protocol in the same manner, so some functions may not work the same way on all models (for example, DVR controls on receivers without the DVR feature). Also, some models may require a special cable or USB adaptor to access the serial port. Additional information can be found in the “Hardware Configuration and Serial Pinout” section of this document. Supported Processors This module is supported on any 2-series processor with RS-232 serial ports. This module includes limited SystemBuilder compatibility; however ControlWorks does not support the use of our modules in the SystemBuilder environment. Compatibility Processor Requirements (Limited) DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com Hardware Configuration and Serial Pinout RJ-22 Serial connection If your receiver is a D10 or H10 then you should build your serial cable as indicated below. Note that the modular connector required is a RJ-22. This is the smaller modular connector that is used on telephone handset cords. This connector requires a special die in your crimper. A RJ11/14 crimper will not work if you attempt to crimp a RJ-22 plug with it. USB connection The module supports serial control via a USB port for all other receivers. This module was tested with an IOGEAR GUC232A. DirecTV has also listed the ATEN UC-232A and the BAFO BF-810 as being compatible with the USB port on the receiver. Please note that you must power cycle the HR20, HR21 and HR21P after plugging in the USB dongle in order for the USB driver to work correctly. Using the red reboot switch will not load the driver. Also note that the LED on the dongle will not illuminate. When using a USB dongle you must pin your serial cable pin 2 to pin 3, pin 3 to pin 2 and pin 5 to pin 5. Pins 1,4,6,7,8 and 9 should not be connected in your cable. DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com Module Application The module does not support IP connectivity for receivers equipped with Ethernet. This module allows bi-directional RS232 serial communication only. You can emulate the controls available from the remote control as well as view the current signal strength, channel number and rapidly tune to pre-set channels by using either an analog value or serial string. Other functions are available such as discreet power and user lockout controls. At this time we do not have support for discreet aspect ratios. DirecTV has reported to us that this functionality may be included in a future release. Channel Presets This module provides two mechanisms for tuning to preset channels via an analog and serial input to the module. Either the analog or serial input may be used to tune to standard channels, while the serial input may also be used to tune to channels with a sub-channel such as off the air high definition channels (example: 8-1),. The demonstration program includes samples of both methods. If using an analog value, simply initialize the analog to the desired channel number, for example to tune to channel 202 initialize the analog to 202d. If using a serial value, send the serial string in the format of xxxx-y where “xxxx” is the channel number, and “y” is the sub-channel number (if no sub-channel, use 0). This string must always be exactly 6 characters, padded with zeros. For example, to tune to channel 202 use the serial string 0202-0; to tune to channel 8-1 use the serial string 0008-1. DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com Signal And Parameter Descriptions Bracketed signals such as “[signal_name]” are optional signals DIGITAL INPUTS [power_on].............................................................. Pulse to turn the receiver on [standby] ................................................................ Pulse to put the receiver into the “standby” mode [reboot] .................................................................. Pulse to reboot the receiver, same as red reboot button on the receiver [get_tuner_channel] ................................................. Pulse to poll for the current channel number (Note: The module will attempt to automatically poll for the current channel when enter, previous channel, or channel up or down is pressed) [get_tuner_signal_quality] ......................................... Pulse to poll for the current signal quality reported by the tuner [poll_for_status]....................................................... Pulse to poll for the current transponder number, primary type, audio type, and CAM (access card) ID. [enable_user_controls].............................................. Pulse to enable user controls via the remote control or front panel buttons [disable_user_controls] ............................................. Pulse to disable user control from the remote control or front panel buttons [key_(x)] ................................................................ Performs the same function as the corresponding button on the DirecTV handheld remote control ANALOG INPUTS [tuner_tune_to_channel] ........................................... Analog input to tune to a channel number (for example 202d = tune to channel 202). Does not support subchannels. Note that certain receivers such as the HR20 will not display the channel banner when direct tuning. SERIAL INPUTS directv_rx$ .............................................................. Tie to RX$ line of serial port that the DirecTV receiver is connected to [tuner1_tune_to_channel$]........................................ Serial input to tune to a channel number. Must be 6 characters including one dash padded with 0s, for example 0008-1 = tune to channel 8-1. Note that certain receivers such as the HR20 will not display the channel banner when direct tuning. DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com DIGITAL OUTPUTS [tuner_no_channel_minor_fb] .................................... High when the current channel number does not include a minor channel component. See the demo program for an example of driving subpages based on this feedback. ANALOG OUTPUTS [tuner_channel_major].............................................. Indicates the current channel number that the receiver is tuned to [tuner_channel_minor].............................................. Indicates the subchannel number of the channel that the receiver is currently tuned to, if any [tuner_signal_quality] ............................................... Full range (0-100%) value representing the quality of the signal as reported by the tuner [transponder_number] .............................................. The transponder number of the currently tuned channel SERIAL OUTPUTS directv_tx$ .............................................................. Tie to TX$ line of serial port that the DirectTV receiver is connected to [primary_type]......................................................... The type of the primary (video) stream of the current channel; one of Data, Audio, Retired, Video-SDTV, Video-HDTV, or None. [audio_type] ............................................................ The type of the audio stream of the current channel [cam_id$] ............................................................... The ID of the smart card inserted in the receiver PARAMETERS Receiver Model ......................................................... Select the model of receiver that you are controlling from the drop-down list DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com Support This module is supported by ControlWorks Consulting, LLC. Should you need support for this module please email [email protected] or call us at 440-729-4640. ControlWorks normal office hours are 9 AM to 5 PM Eastern, Monday through Friday, excluding holidays. Before calling for support, please ensure that you have loaded and tested operation using the included demonstration program and touchpanel(s) to ensure that you understand the correct operation of the module. It may be difficult for ControlWorks to provide support until the demonstration program is loaded. Updates, when available, are automatically distributed via Email notification to the address entered when the module was purchased. In addition, updates may be obtained using your username and password at http://www.thecontrolworks.com/customerlogin.aspx. Distribution Package Contents The distribution package for this module should include: DirecTV_Receivers_V1.umc ........................................ Crestron User Module for control of DirecTV receivers DirecTV_Receivers_Xpanel_v1.vtp............................... Demonstration XPanel DirecTV_Receivers_v1_Demo.smw .............................. Demo program for PRO2 processor DirecTV_cam_id_parser_v1.usp .................................. SIMPL+ File used within the module DirecTV_cam_id_parser_v1.ush .................................. SIMPL+ Header used within the module DirecTV_Receivers_control_v1.pdf .............................. This Help File DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com Revision History V1 [email protected], [email protected] 2008.05.30 -Initial release Development Environment This version the module was developed on the following hardware and software. Different versions of hardware or software may or may not operate properly. If you have questions, please contact us. DirecTV Receivers HR20-700 H20-600 D10-100 Software Version 0x4062 0x4062 0x1069 Crestron Hardware Crestron PRO2 Processor Firmware Version 3.155.1243 Software Crestron SIMPL Windows Crestron Vision Tools Pro-e Crestron Database Crestron Symbol Library Crestron Device Library Software Version 2.08.38 3.7.2.8 19.06.003 531 531 DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com ControlWorks Consulting, LLC Module License Agreement Definitions: ControlWorks, We, and Us refer to ControlWorks Consulting, LLC, with headquarters located at 701 Beta Drive, Suite 22 Mayfield Village, Ohio 44143-2330. You and Dealer refer to the entity purchasing the module. Client and End User refer to the person or entity for whom the Crestron hardware is being installed and/or will utilize the installed system. System refers to all components described herein as well as other components, services, or utilities required to achieve the functionality described herein. Module refers to files required to implement the functionality provided by the module and may include source files with extensions such as UMC, USP, SMW and VTP. Demo Program refers to a group of files used to demonstrate the capabilities of the Module, for example a SIMPL Windows program and VisionTools Touchpanel file(s) illustrating the use of the Module but not including the Module. Software refers to the Module and the Demo Program. Disclaimer of Warranties ControlWorks Consulting, LLC software is licensed to You as is. You, the consumer, bear the entire risk relating to the quality and performance of the Software. In no event will ControlWorks Consulting, LLC be liable for direct, indirect, incidental or consequential damages resulting from any defect in the Software, even if ControlWorks Consulting, LLC had reason to know of the possibility of such damage. If the Software proves to have defects, You and not Us must assume the cost of any necessary service or repair resulting from such defects. Provision of Support We provide limited levels of technical support only for the most recent version of the Module as determined by Us. We do not provide support for previous version of the module, modifications to the module not made by Us, to persons who have not purchased the module from Us. In addition, we may decline to provide support if the Demo Program has not been utilized. We may withdraw a module from sale and discontinue providing support at any time and for any reason, including, for example, if the equipment for which the Module is written is discontinued or substantially modified. The remainder of your rights and obligations pursuant to this license will not be affected should ControlWorks discontinue support for a module. Modification of Software You may not decrypt (if encrypted), reverse engineer, modify, translate, disassemble, or de-compile the Module in whole or part. You may modify the Demo Program. In no event will ControlWorks Consulting, LLC be liable for direct, indirect, incidental or consequential damages resulting from You modifying the Software in any manner. Indemnification/Hold Harmless ControlWorks, in its sole and absolute discretion may refuse to provide support for the application of the Module in such a manner that We feel has the potential for property damage, or physical injury to any person. Dealer shall indemnify and hold harmless ControlWorks Consulting LLC, its employees, agents, and owners from any and all liability, including direct, indirect, and consequential damages, including but not limited to personal injury, property damage, or lost profits which may result from the operation of a program containing a ControlWorks Consulting, LLC Module or any component thereof. License Grant Software authored by ControlWorks remains the property of ControlWorks. ControlWorks grants You the nonexclusive, non-transferable, perpetual license to use the Software authored by ControlWorks as a component of Systems programmed by You. This Software is the intellectual property of ControlWorks Consulting, LLC and is protected by law, including United States and International copyright laws. This Software and the accompanying license may not be transferred, resold, or assigned to other persons, organizations or other Crestron Dealers via any means. The use of this software indicates acceptance of the terms of this agreement. Copyright (C) 2009 ControlWorks Consulting, LLC All Rights Reserved – Use Subject to License. US Government Restricted Rights. Use, duplication or disclosure by the Government is subject to restrictions set forth in subparagraphs (a)-(d) of FAR 52.227-19. DirecTV Receivers v1 Telephone: (+1)440-449-1100 [email protected] ControlWorks Consulting, LLC http://www.controlworks.com