Montage Technology M88RS2000 User manual

DVB-S Satellite Receiver
M88RS2000
Driver User’s Manual
Revision Number: 0.0
Revision Date: November 23, 2009

Disclaimer
INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH MONTAGE PRODUCTS. NO
LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY
RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN MONTAGE'S TERMS AND CONDITIONS
OF SALE FOR SUCH PRODUCTS, MONTAGE ASSUMES NO LIABILITY WHATSOEVER, AND MONTAGE
DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF MONTAGE
PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE,
MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL
PROPERTY RIGHT.
Montage may make changes to specifications and product descriptions at any time, without notice.
Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or
"undefined." Montage reserves these for future definition and shall have no responsibility whatsoever for conflicts or
incompatibilities arising from future changes to them.
Other names and brands may be claimed as the property of others.
Do not disclose or distribute to any third party without written permission of Montage.
Copyright © Montage Technology 2009.
M88RS2000M88DS3001M88DS3002
Driver User’s Manual
Montage Technology Confidential and Proprietary ii

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary iii
Revision History
Revision
Number Revision Date
Changes
Page Number Description
0.0 11/23/2009 - Initial release

Revision Number: 0.0
Revision Date: November 23, 2009
Document Number: SW-0060-D 1
1Introduction
Montage provides a primary reference for the driver of M88RS2000 DVB-S satellite receiver. The driver includes
demodulator and tuner APIs. It can be integrated into user’s own applications easily. The user can use it as a reference,
and then write their own code according to their specific hardware, operating system and compiler.
This user’s manual introduces variables and functions of the driver, and demonstrates how to use the driver in an STB
(Set-Top Box) application.
We assume that the user have a basic familiarity with the M88RS2000 and C program. If you have difficulties
understanding this user’s manual, please refer to the M88RS2000 data sheet.
2 Software Overview
This manual describes how to control M88RS2000 by software on the manufacturer’s platform, such as ST or LSI etc.
Montage provides a set of fully developed software functions with their definitions. The driver is OS-independent so that
the user can use the M88RS2000 with a variety of embedded processors and embedded operating systems appropriate
for their platform.
2.1 Files Of The Driver
The M88RS2000 driver is written in standard ANSI C. It consists of source files and header files. For more details,
please refer to Table 1.
Table 1. Driver’s Files List
Name Type Description
mt_fe_rs2k.c C source file Provides APIs to operate the receiver.
mt_fe_i2c.c C source file Includes 2-wire bus API to read/write the receiver’s register
and download firmware through 2-wire bus.
mt_fe_example.c C source file Provides an example for using the APIs to search satellite TP
and DiSEqC applications.
mt_fe_def.h C header file Declares variables and functions. Defines variable types used
in the driver.
mt_fe_i2c.h C header file Declares the APIs of 2-wire bus and 2-wire bus repeater.
M88RS2000
Driver User’s Manual

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 2
2.2 How To Use The Driver
Please use the driver as follow steps.
Figure 1. Following Steps To Use The Driver
3 Driver Main APIs
3.1 Realize 2-wire Bus APIs
Corresponding files:
−mt_fe_i2c.c -- Source codes of the 2-wire bus operation.
−mt_fe_i2c.h -- Declaration of corresponding 2-wire bus APIs.
−mt_fe_def.h -- Define the 2-wire bus’s slave address.
Applications can access and control the M88RS2000 through a 2-wire bus. The bus speed is up to 400KHz. Users
should realize the belowing functions of 2-wire bus interface based on the users' OS 2-wire bus drivers.
3.1.1 About The 2-wire Bus Chip Address
3.1.1.1 Demodulator Part’s Address
The M88RS2000 chip address is selected by the ADDR_SEL pin and 2-wire bus operations. Currently, the chip’s default
address is D0H. Table 2. 2-wire Bus’s Slave Address Selection
ADDR_SEL
Pin
Demodulator Part’s Address
Write Operation Read Operation
0D0H D1H
1D2H D3H
Realize 2-wire Bus
APIs
Initialize M88RS2000
LNB & DiSEqC
Blind Scan
Manual Search
Get TP & Signal
Information

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 3
3.1.1.2 Tuner Part’s Address
The M88RS2000 operates tuner part’s registers through C0H for write operation and C1H for read operation.
3.1.2 Functions Need To Be Finished By Users
3.1.2.1 2-wire Bus
3.1.2.1.1 Write Operation With a Stop Signal
S32 _mt_i2c_tx_with_stop (U8 chip_addr, U8 *p_data, U16 byte_nb, U32 time_out)
Description:
This function contains 2-wire bus write operation with a stop signal.
Arguments:
U8 chip_addr -- 2-wire bus chip address;
U8 *p_data -- Data to be written;
U16 byte_nb -- Length of data to be written;
U32 time_out -- 2-wire bus time out.
Return:
S32
3.1.2.1.2 Read Operation With a Stop Signal
S32 _mt_i2c_rx_with_stop (U8 chip_addr, U8 *p_buf, U16 byte_nb, U32 time_out)
Description:
This function contains 2-wire bus read operation with a stop signal.
Arguments:
U8 chip_addr -- 2-wire bus chip address;
U8 *p_data -- Store the read data;
U16 byte_nb -- Length of read data;
U32 time_out -- 2-wire bus time out.
Return:
S32
3.1.2.1.3 Write Operation Without Stop Signal
S32 _mt_i2c_tx_without_stop (U8 chip_addr, U8 *p_data, U16 byte_nb, U32 time_out)
Description:
This function contains 2-wire bus write operation without stop signal.
Arguments:
U8 chip_addr -- 2-wire bus chip address;
U8 *p_data -- Data to be written;
U16 byte_nb -- Length of data to be written;
U32 time_out -- 2-wire bus time out.

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 4
Return:
S32
3.1.2.1.4 Read Operation Without Stop Signal
S32 _mt_i2c_rx_without_stop (U8 chip_addr, U8 *p_buf, U16 byte_nb, U32 time_out)
Description:
This function contains 2-wire bus read operation without stop signal.
Arguments:
U8 chip_addr -- 2-wire bus chip address;
U8 *p_data -- Store the read data;
U16 byte_nb -- Length of the read data;
U32 time_out -- 2-wire bus time out.
Return:
S32
3.1.2.1.5 Time Delay
void _mt_i2c_delay (U32 time)
Description:
This function sets the time delay of 2-wire bus.
Arguments:
U32 time -- The delay time. Unit is micro-second (ms).
Note: In multi-task embedded OS, we strongly recommended that users should use mutex or semaphore to
protect and synchronize 2-wire bus operations in multi-threads. Otherwise some unexpected 2-wire bus errors
may be occurred.
3.1.3 Read/Write Demodulator Part’s Registers
3.1.3.1 Write Operation
MT_FE_RET mt_fe_dmd_set_reg (U8 addr, U8 data)
Description:
This function writes demodulator register.
Arguments:
U8 addr -- Sub-address of demodulator register;
U8 data -- Data to be written.
Return:
MT_FE_RET
3.1.3.2 Read Operation
MT_FE_RET mt_fe_dmd_get_reg (U8 addr, U8 *p_buf)
Description:

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 5
This function reads demodulator register.
Arguments:
U8 addr -- Sub-address of demodulator register;
U8 *p_buf -- Store the read data.
Return:
MT_FE_RET
3.1.4 Read/Write Tuner Part’s Registers
3.1.4.1 Write Operation
MT_FE_RET mt_fe_tn_set_reg (U8 addr, U8 data)
Description:
This function writes tuner register.
Arguments:
U8 addr -- Sub-address of tuner register;
U8 data -- Data to be written.
Return:
MT_FE_RET
3.1.4.2 Read Operation
MT_FE_RET mt_fe_tn_get_reg (U8 addr, U8 *p_buf)
Description:
This function reads tuner register.
Arguments:
U8 addr -- Sub-address of tuner register;
U8 *p_buf -- Store the read data.
Return:
MT_FE_RET
Note:
In the function source codes, you'll find a sentence:
val |= 0x05;
The operation opens the 2-wire bus repeater twice. This means that below operations need two stop signals. If
there's only one stop signal, the sentence should change to:
val |= 0x04;
3.2 Macro Definitions
Corresponding file:
−mt_fe_def.h -- Include macro definitions, variable type defines and APIs.

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 6
Belowing lists all the macro definitions which are important or can be modified, and with their corresponding information.
3.2.1 MT_FE_DEBUG
This variable switches on/off some debug information print.
1 -- Enable the debug information printing;
0 -- Disable the debug information printing.
3.2.2 MT_FE_TS_OUTPUT_MODE
This variable defines the MPEG TS output mode.
MtFeTsOutputMode_Serial -- Serial mode output;
MtFeTsOutputMode_Parallel -- Parallel mode output (Default mode);
MtFeTsOutputMode_Common -- DVB common interface mode output.
3.2.3 LIMIT_TP_CARRIER_OFFSET_6MHZ
This variable determines whether to limit the carrier offset range or not. The range is from -6MHz to +6MHz.
0 -- Disable to limit the carrier offset range;
1 -- Enable to limit the carrier offset range.
3.2.4 Level Defines Of LNB Corresponding Pins
Please define these levels according to the circuit design.
3.2.4.1 Pin Level
•MT_FE_PIN_LEVEL_LOW -- Define as 0. Pin level is LOW;
•MT_FE_PIN_LEVEL_HIGH -- Define as 1. Pin level is HIGH.
3.2.4.2 LNB Enable
MT_FE_PIN_LNB_EN_LEVEL_WHEN_LNB_ENABLE
This macro definition defines which level of pin LNB_EN means LNB enable.
•MT_FE_PIN_LEVEL_LOW -- Enable LNB when pin LNB_EN is LOW;
•MT_FE_PIN_LEVEL_HIGH -- Enable LNB when pin LNB_EN is HIGH.
3.2.4.3 LNB Voltage Selection
MT_FE_PIN_VSEL_LEVEL_WHEN_LNB_13V
This macro definition defines which level of pin VSEL means LNB voltage is 13V.
•MT_FE_PIN_LEVEL_LOW -- LNB voltage is 13V when the level is LOW, and LNB voltage is 18V when
the level is HIGH;
•MT_FE_PIN_LEVEL_HIGH -- LNB voltage is 13V when the level is HIGH, and LNB voltage is 18V when
the level is LOW.
3.2.4.4 The Level Of Pin VSEL When LNB Standby
MT_FE_PIN_VSEL_LEVEL_WHEN_LNB_STANDBY

M88RS2000
Driver User’s Manual
Montage Technology Confidential and Proprietary 7
This macro definition defines level of pin VSEL when LNB stands by.
•MT_FE_PIN_LEVEL_LOW -- The level is LOW when LNB stands by;
•MT_FE_PIN_LEVEL_HIGH -- The level is HIGH when LNB stands by.
3.2.4.5 The Level Of Pin DISEQC_OUT When LNB Standby
MT_FE_PIN_DISEQC_OUT_LEVEL_WHEN_LNB_STANDBY
This macro definition defines level of pin DISEQC_OUT when LNB standby.
•MT_FE_PIN_LEVEL_LOW -- The level is LOW when LNB stands by;
•MT_FE_PIN_LEVEL_HIGH -- The level is HIGH when LNB stands by.
3.2.5 Macro Definitions Of Reference Signal Strength
3.2.5.1 AVG_NUM
This variable defines the length of an array to store the last few signal strength data. The final data will be the average
value. Default value is 1.
3.2.5.2 SIGNAL_STENGTH_RATIO
This variable the ratio of the signal strength. Default value is 100.
3.3 M88RS2000 Initialization
MT_FE_RET mt_fe_rs2k_init (void)
Descriptions:
This function initializes the receiver (includes tuner part and demodulator part) and configure the MPEG TS output
format.
Note: After the system boots up, users should call this function to initialize the M88RS2000.
3.4 LNB & DiSEqC
After M88RS2000 is initialized, users should connect cables and set the correct LNB status. If there's more than one
cable, users should set up LNB and DiSEqC controlling devices to select the specific cable.
3.4.1 Set LNB
MT_FE_RET mt_fe_rs2k_set_LNB (BOOL is_LNB_enable, BOOL is_22k_enable, MT_FE_LNB_VOLTAGE
voltage_type)
Descriptions:
This function sets the LNB.
Arguments:
BOOL is_LNB_enable -- Enable or disable LNB;
BOOL is_22k_enable -- Enable or disable a 22KHz tone signal;
MT_FE_LNB_VOLTAGE voltage_type -- Select 13V or 18V.
Return:
MT_FE_RET