Fujitsu DTV/STB solution driver (FAPex driver) Documentation [V01L00R00]


TSD Driver

Table of Contents

Introduction
Configuration

Public Interface

Driver Usage
Driver Relationship
References

Back to top

Introduction

This driver controls the TS configuration, input and output. It is used to start/stop TS streams and to filter its context. The TSD driver also uses the SYNC driver to automatically adjust the STC according to received PCRs if this feature is enabled.

Back to top

Configuration

Internal Descrambler function


You can select by "make menuconfig" as follows whether you use internal Descrambler function or not.

---- menu config
  Device Drivers  --->
    Multimedia devices  --->
     <M> Fujitsu DTV/STB solution
           Fujitsu DTV/STB extension module configuration  --->
             Fujitsu DTV/STB extension module functional configuration  --->
              <M> Function Driver of WFE : TS Demux
              [*]   Use the internal Descrambler function

Section data buffer configuration


At first, the section data buffer is statically mapped to the area from FAPEX_SYS_MMAP_BM_SECTION_START to (FAPEX_SYS_MMAP_BM_SECTION_END - 1).
FAPEX_SYS_MMAP_BM_SECTION_START and FAPEX_SYS_MMAP_BM_SECTION_END are defined with the board configuration header file.

In case of Fujitsu MB86H61 Development Kit board, this board configuration header file is "${KERNEL_TOP}/drivers/media/fapex/wfe/include/fapex/sys_config_mb86h61_devkit.h", these are defined as follows.
    #define FAPEX_SYS_MMAP_BM_SECTION_START       (PROGRAM_MEMORY_START+0x01590000UL)
    #define FAPEX_SYS_MMAP_BM_SECTION_BYTES       0x00100000UL // 1 MB
    #define FAPEX_SYS_MMAP_BM_SECTION_END         (FAPEX_SYS_MMAP_BM_SECTION_START+FAPEX_SYS_MMAP_BM_SECTION_BYTES)

When the TSD driver cannot allocate from above area for section data, the TSD driver try to allocate from the OS heap area.


PES/ES buffer configuration


The PES/ES buffers are statically mapped by using the FAPI_BM_SetGlobalOffset() and the FAPI_BM_SetBufferPurpose() at initialization of TSD driver.
These setup sequence are defined with the board configuration header file.

In case of Fujitsu MB86H61 Development Kit board, this board configuration header file is "${KERNEL_TOP}/drivers/media/fapex/wfe/include/fapex/sys_config_mb86h61_devkit.h", these are defined as follows.

Note:
Please refer to "MB86H61 SDK documentation" about the initial setup functions for ES buffers.
Back to top

Public Interface

System Driver Interface

Driver initialization function

  • Linux:
    The TSD driver module is initialized by following command on target board.
     # modprobe fapex_fdltsd
  • RTOS:
    The TSD driver module is initialized by calling FAPEX_common_init().

Driver exit function

  • Linux:
    The TSD driver module is unregistered by following command on target board.
     # modprobe -rq fapex_fdltsd
  • RTOS:
    The TSD driver module is unregistered by calling FAPEX_common_exit().

Application Programming Interface

Functions and Macros

The driver provides the functions and macros listed below. For more information please follow the links to their detailed documentation.

Open Driver
FAPEX_TSD_Open()
Close Driver
FAPEX_TSD_Close()
Read Data
FAPEX_TSD_Read()
Write Data
FAPEX_TSD_Write()
I/O control of Driver
FAPEX_TSD_Ioctl()
Memory Mapping
FAPEX_TSD_Mmap()
FAPEX_TSD_Munmap()
Back to top

Driver Usage

The TSD module have the common descriptor and the sub descriptor.
The common descriptor is connected to functions of entire TSD channel on a TSD block. The sub descriptor is connected to functions for PID channel.
Please refer to following sequence diagram for the usage of this driver.

inline_dotgraph_15.dot
Back to top

Driver Relationship

The TSD driver is related with the following drivers:

Back to top

References

  • MB86H61 SDK documentation
    Fujitsu API / Core Driver Layer / BM Driver

  • MB86H61 Device Manual
    Chapter 16.Transport Stream Interfaces
    Chapter 17.Buffer Manager


Copyright © 2006-2010 by Fujitsu Semiconductor Europe GmbH
Copyright © 2008-2010 by Fujitsu Semiconductor Limited

Disclaimer:
Please note that the use of this has been based on the terms and conditions of "DK Consent Letter (For Linux)" agreement between you and Fujitsu Semiconductor Limited.
The contents of this document may be revised without prior notice. Contact our sales department for confirmation. The information in this document are presented as is, no license is granted by implication or otherwise.
More...

FUJITSU sales representatives