\chapter{Examples}
In this section we would like to present some examples for using the DVB API.

\section{Tuning}
We will start with a generic tuning subroutine that uses the frontend
and SEC, as well as the demux devices. The example is given for QPSK
tuners, but can easily be adjusted for QAM.

{\small
\begin{verbatim}
#include <sys/ioctl.h>
#include <stdio.h>
#include <stdint.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <time.h>
#include <unistd.h>

#include <ost/dmx.h>
#include <ost/frontend.h>
#include <ost/sec.h>
#include <sys/poll.h>

#define DMX "/dev/ost/demux"
#define QPSK "/dev/ost/qpskfe"
#define SEC "/dev/ost/sec"

/* routine for checking if we have a signal */
int has_signal(int front)
{
        feStatus stat;
        
        if ( front < 0 ){
                if((front = open(QPSK,O_RDWR)) < 0){
                        perror("FRONTEND DEVICE: ");
                        return -1;
                }
        }

        FEReadStatus(front, &stat);
        if (stat & FE_HAS_SIGNAL)
                return 0;
        else {
                printf("Tuning failed\n");
                return -1;
        }
}

/* tune qpsk */
/* freq:             frequency of transponder                      */
/* vpid, apid, tpid: PIDs of video, audio and teletext TS packets  */
/* diseqc:           DiSEqC address of the used LNB                */
/* pol:              Polarisation                                  */
/* srate:            Symbol Rate                                   */
/* fec.              FEC                                           */
/* lnb_lof1:         local frequency of lower LNB band             */
/* lnb_lof2:         local frequency of upper LNB band             */
/* lnb_slof:         switch frequency of LNB                       */

int set_qpsk_channel(int freq, int vpid, int apid, int tpid,
                int diseqc, int pol, int srate, int fec, int lnb_lof1, 
                int lnb_lof2, int lnb_slof)
{
        struct secCommand scmd;
        struct secCmdSequence scmds;
        struct dmxPesFilterParams pesFilterParams; 
        struct qpskParameters qpsk;
        struct pollfd pfd[1];
        struct qpskEvent event;
        int front, sec, demux1, demux2, demux3;

        /* Open all the necessary the devices */

        if((front = open(QPSK,O_RDWR)) < 0){
                perror("FRONTEND DEVICE: ");
                return -1;
        }

        if((sec = open(SEC,O_RDWR)) < 0){
                perror("SEC DEVICE: ");
                return -1;
        }

        if ((demux1 = open(DMX, O_RDWR|O_NONBLOCK))  < 0){
                perror("DEMUX DEVICE: ");
                return -1;
        }

        if ((demux2 = open(DMX, O_RDWR|O_NONBLOCK))  < 0){
                perror("DEMUX DEVICE: ");
                return -1;
        }

        if ((demux3 = open(DMX, O_RDWR|O_NONBLOCK))  < 0){
                perror("DEMUX DEVICE: ");
                return -1;
        }

      /* Set the frequency of the transponder, taking into account the
         local frequencies of the LNB */

        if (freq < lnb_slof) {
                qpsk.iFrequency = (freq - lnb_lof1);
                scmds.continuousTone = SEC_TONE_OFF;
        } else {
                qpsk.iFrequency = (freq - lnb_lof2);
                scmds.continuousTone = SEC_TONE_ON;
        }

      /* Set the polarity of the transponder by setting the correct
         voltage on the universal LNB */

        if (pol) scmds.voltage = SEC_VOLTAGE_18;
        else scmds.voltage = SEC_VOLTAGE_13;

      /* In case we have a DiSEqC, set it to the correct address */

        scmd.type=0;
        scmd.u.diseqc.addr=0x10;
        scmd.u.diseqc.cmd=0x38;
        scmd.u.diseqc.numParams=1;
        scmd.u.diseqc.params[0] = 0xF0 | ((diseqc * 4) & 0x0F) | 
                (scmds.continuousTone == SEC_TONE_ON ? 1 : 0) |
                (scmds.voltage==SEC_VOLTAGE_18 ? 2 : 0);

        scmds.miniCommand=SEC_MINI_NONE;
        scmds.numCommands=1;
        scmds.commands=&scmd;

      /* Send the data to the SEC device to prepare the LNB for tuning  */
        if (ioctl(sec, SEC_SEND_SEQUENCE, &scmds) < 0){
                perror("SEC SEND: ");
                return -1;
        }

      /* Set symbol rate and FEC */

        qpsk.SymbolRate = srate;
        qpsk.FEC_inner = fec;

      /* Now send it all to the frontend device */
        if (ioctl(front, QPSK_TUNE, &qpsk) < 0){
                perror("QPSK TUNE: ");
                return -1;
        }
 
      /* poll for QPSK event to check if tuning worked */
        pfd[0].fd = front;
        pfd[0].events = POLLIN;

        if (poll(pfd,1,3000)){
                if (pfd[0].revents & POLLIN){
                        printf("Getting QPSK event\n");
                        if ( ioctl(front, QPSK_GET_EVENT, &event)  

                             == -EBUFFEROVERFLOW){
                                perror("qpsk get event");
                                return -1;
                        }
                        printf("Received ");
                        switch(event.type){
                        case FE_UNEXPECTED_EV:
                                printf("unexpected event\n");
                                return -1;
                        case FE_FAILURE_EV:
                                printf("failure event\n");
                                return -1;
                       case FE_COMPLETION_EV:
                                printf("completion event\n");
                        }
                }
        }
      

      /* Set the filters for video, audio and teletext demuxing */

        pesFilterParams.pid     = vpid;
        pesFilterParams.input   = DMX_IN_FRONTEND; 
        pesFilterParams.output  = DMX_OUT_DECODER; 
        pesFilterParams.pesType = DMX_PES_VIDEO; 
        pesFilterParams.flags   = DMX_IMMEDIATE_START;
        if (ioctl(demux1, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
                perror("set_vpid");
                return -1;
        }

        pesFilterParams.pid     = apid;
        pesFilterParams.input   = DMX_IN_FRONTEND; 
        pesFilterParams.output  = DMX_OUT_DECODER; 
        pesFilterParams.pesType = DMX_PES_AUDIO; 
        pesFilterParams.flags   = DMX_IMMEDIATE_START;
        if (ioctl(demux2, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
                perror("set_apid");
                return -1;
        }

        pesFilterParams.pid     = tpid;
        pesFilterParams.input   = DMX_IN_FRONTEND; 
        pesFilterParams.output  = DMX_OUT_DECODER; 
        pesFilterParams.pesType = DMX_PES_TELETEXT; 
        pesFilterParams.flags   = DMX_IMMEDIATE_START;
        if (ioctl(demux3, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
                perror("set_tpid");
                return -1;
        }

        /* check if we have a signal */
        return has_signal(front);
}

\end{verbatim}
}
The program assumes that you are using a universal LNB and a standard
DiSEqC switch with up to 4 addresses. Of course, you could build in
some more checking if tuning was successful and maybe try to repeat
the tuning process. Depending on the external hardware, i.e. LNB and
DiSEqC switch, and weather conditions this may be necessary. 


\section{The DVR device}
The following program code shows how to use the DVR device for
recording.

{\small
\begin{verbatim}
#include <sys/ioctl.h>
#include <stdio.h>
#include <stdint.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <time.h>
#include <unistd.h>

#include <ost/dmx.h>
#include <ost/video.h>
#include <sys/poll.h>
#define DVR "/dev/ost/dvr"
#define AUDIO "/dev/ost/audio"
#define VIDEO "/dev/ost/video"

#define BUFFY (188*20)
#define MAX_LENGTH (1024*1024*5) /* record 5MB */


/* switch the demuxes to recording, assuming the transponder is tuned */

/* demux1, demux2: file descriptor of video and audio filters */
/* vpid, apid:     PIDs of video and audio channels           */

int switch_to_record(int demux1, int demux2, uint16_t vpid, uint16_t apid)
{
        struct dmxPesFilterParams pesFilterParams; 

        if (demux1 < 0){
                if ((demux1=open(DMX, O_RDWR|O_NONBLOCK)) 
                    < 0){
                        perror("DEMUX DEVICE: ");
                        return -1;
                }
        }

        if (demux2 < 0){
                if ((demux2=open(DMXdemuxs, O_RDWR|O_NONBLOCK)) 
                    < 0){
                        perror("DEMUX DEVICE: ");
                        return -1;
                }
        }

        pesFilterParams.pid = vpid;
        pesFilterParams.input = DMX_IN_FRONTEND; 
        pesFilterParams.output = DMX_OUT_TS_TAP; 
        pesFilterParams.pesType = DMX_PES_VIDEO; 
        pesFilterParams.flags = DMX_IMMEDIATE_START;
        if (ioctl(demux1, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
                perror("DEMUX DEVICE");
                return -1; 
        }
        pesFilterParams.pid = apid; 
        pesFilterParams.input = DMX_IN_FRONTEND; 
        pesFilterParams.output = DMX_OUT_TS_TAP; 
        pesFilterParams.pesType = DMX_PES_AUDIO; 
        pesFilterParams.flags = DMX_IMMEDIATE_START;
        if (ioctl(demux2, DMX_SET_PES_FILTER, &pesFilterParams) < 0){
                perror("DEMUX DEVICE");
                return -1; 
        }
        return 0;
}

/* start recording MAX_LENGTH , assuming the transponder is tuned */

/* demux1, demux2: file descriptor of video and audio filters */
/* vpid, apid:     PIDs of video and audio channels           */
int record_dvr(int demux1, int demux2, uint16_t vpid, uint16_t apid)
{
        int i;
        int len;
        int written;
        uint8_t buf[BUFFY];
        uint64_t length;
        struct pollfd pfd[1];
        int dvr, dvr_out;

        /* open dvr device */
        if ((dvr = open(DVR, O_RDONLY|O_NONBLOCK)) < 0){
                        perror("DVR DEVICE");
                        return -1;
        }
        
        /* switch video and audio demuxes to dvr */
        printf ("Switching dvr on\n");
        i = switch_to_record(demux1, demux2, vpid, apid);
        printf("finished: ");
        
        printf("Recording %2.0f MB of test file in TS format\n",
               MAX_LENGTH/(1024.0*1024.0));
        length = 0;

        /* open output file */
        if ((dvr_out = open(DVR_FILE,O_WRONLY|O_CREAT
                                 |O_TRUNC, S_IRUSR|S_IWUSR
                                 |S_IRGRP|S_IWGRP|S_IROTH|
                                 S_IWOTH)) < 0){
                perror("Can't open file for dvr test");
                return -1;
        }

        pfd[0].fd = dvr;
        pfd[0].events = POLLIN;

        /* poll for dvr data and write to file */
        while (length < MAX_LENGTH ) {
                if (poll(pfd,1,1)){
                        if (pfd[0].revents & POLLIN){
                                len = read(dvr, buf, BUFFY);
                                if (len < 0){
                                        perror("recording");
                                        return -1;
                                }
                                if (len > 0){
                                        written = 0;
                                        while (written < len) 
                                                written += 
                                                        write (dvr_out, 
                                                               buf, len);
                                        length += len;
                                        printf("written %2.0f MB\r",
                                               length/1024./1024.);
                                }
                        }
                }
        }
        return 0;
}

\end{verbatim}
}
%%% Local Variables: 
%%% mode: latex
%%% TeX-master: "dvbapi"
%%% TeX-master: t
%%% End: