|  | <title>Examples</title> | 
|  | <para>In this section we would like to present some examples for using the DVB API. | 
|  | </para> | 
|  | <para>Maintainer note: This section is out of date. Please refer to the sample programs packaged | 
|  | with the driver distribution from <ulink url="http://linuxtv.org/hg/dvb-apps" />. | 
|  | </para> | 
|  |  | 
|  | <section id="tuning"> | 
|  | <title>Tuning</title> | 
|  | <para>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. | 
|  | </para> | 
|  | <programlisting> | 
|  | #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 <linux/dvb/dmx.h> | 
|  | #include <linux/dvb/frontend.h> | 
|  | #include <linux/dvb/sec.h> | 
|  | #include <sys/poll.h> | 
|  |  | 
|  | #define DMX "/dev/dvb/adapter0/demux1" | 
|  | #define FRONT "/dev/dvb/adapter0/frontend1" | 
|  | #define SEC "/dev/dvb/adapter0/sec1" | 
|  |  | 
|  | /⋆ routine for checking if we have a signal and other status information⋆/ | 
|  | int FEReadStatus(int fd, fe_status_t ⋆stat) | 
|  | { | 
|  | int ans; | 
|  |  | 
|  | if ( (ans = ioctl(fd,FE_READ_STATUS,stat) < 0)){ | 
|  | perror("FE READ STATUS: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | if (⋆stat & FE_HAS_POWER) | 
|  | printf("FE HAS POWER\n"); | 
|  |  | 
|  | if (⋆stat & FE_HAS_SIGNAL) | 
|  | printf("FE HAS SIGNAL\n"); | 
|  |  | 
|  | if (⋆stat & FE_SPECTRUM_INV) | 
|  | printf("SPEKTRUM INV\n"); | 
|  |  | 
|  | return 0; | 
|  | } | 
|  |  | 
|  |  | 
|  | /⋆ 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 dmx_pes_filter_params pesFilterParams; | 
|  | FrontendParameters frp; | 
|  | struct pollfd pfd[1]; | 
|  | FrontendEvent event; | 
|  | int demux1, demux2, demux3, front; | 
|  |  | 
|  | frequency = (uint32_t) freq; | 
|  | symbolrate = (uint32_t) srate; | 
|  |  | 
|  | if((front = open(FRONT,O_RDWR)) < 0){ | 
|  | perror("FRONTEND DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | if((sec = open(SEC,O_RDWR)) < 0){ | 
|  | perror("SEC DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | if (demux1 < 0){ | 
|  | if ((demux1=open(DMX, O_RDWR|O_NONBLOCK)) | 
|  | < 0){ | 
|  | perror("DEMUX DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  | } | 
|  |  | 
|  | if (demux2 < 0){ | 
|  | if ((demux2=open(DMX, O_RDWR|O_NONBLOCK)) | 
|  | < 0){ | 
|  | perror("DEMUX DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  | } | 
|  |  | 
|  | if (demux3 < 0){ | 
|  | if ((demux3=open(DMX, O_RDWR|O_NONBLOCK)) | 
|  | < 0){ | 
|  | perror("DEMUX DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  | } | 
|  |  | 
|  | if (freq < lnb_slof) { | 
|  | frp.Frequency = (freq - lnb_lof1); | 
|  | scmds.continuousTone = SEC_TONE_OFF; | 
|  | } else { | 
|  | frp.Frequency = (freq - lnb_lof2); | 
|  | scmds.continuousTone = SEC_TONE_ON; | 
|  | } | 
|  | frp.Inversion = INVERSION_AUTO; | 
|  | if (pol) scmds.voltage = SEC_VOLTAGE_18; | 
|  | else scmds.voltage = SEC_VOLTAGE_13; | 
|  |  | 
|  | 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; | 
|  | if (ioctl(sec, SEC_SEND_SEQUENCE, &scmds) < 0){ | 
|  | perror("SEC SEND: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | if (ioctl(sec, SEC_SEND_SEQUENCE, &scmds) < 0){ | 
|  | perror("SEC SEND: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | frp.u.qpsk.SymbolRate = srate; | 
|  | frp.u.qpsk.FEC_inner = fec; | 
|  |  | 
|  | if (ioctl(front, FE_SET_FRONTEND, &frp) < 0){ | 
|  | perror("QPSK TUNE: "); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | 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, FE_GET_EVENT, &event) | 
|  |  | 
|  | == -EOVERFLOW){ | 
|  | 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"); | 
|  | } | 
|  | } | 
|  | } | 
|  |  | 
|  |  | 
|  | pesFilterParams.pid     = vpid; | 
|  | pesFilterParams.input   = DMX_IN_FRONTEND; | 
|  | pesFilterParams.output  = DMX_OUT_DECODER; | 
|  | pesFilterParams.pes_type = 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.pes_type = 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.pes_type = DMX_PES_TELETEXT; | 
|  | pesFilterParams.flags   = DMX_IMMEDIATE_START; | 
|  | if (ioctl(demux3, DMX_SET_PES_FILTER, &pesFilterParams) < 0){ | 
|  | perror("set_tpid"); | 
|  | return -1; | 
|  | } | 
|  |  | 
|  | return has_signal(fds); | 
|  | } | 
|  |  | 
|  | </programlisting> | 
|  | <para>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. | 
|  | </para> | 
|  | </section> | 
|  |  | 
|  | <section id="the_dvr_device"> | 
|  | <title>The DVR device</title> | 
|  | <para>The following program code shows how to use the DVR device for recording. | 
|  | </para> | 
|  | <programlisting> | 
|  | #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 <linux/dvb/dmx.h> | 
|  | #include <linux/dvb/video.h> | 
|  | #include <sys/poll.h> | 
|  | #define DVR "/dev/dvb/adapter0/dvr1" | 
|  | #define AUDIO "/dev/dvb/adapter0/audio1" | 
|  | #define VIDEO "/dev/dvb/adapter0/video1" | 
|  |  | 
|  | #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 dmx_pes_filter_params pesFilterParams; | 
|  |  | 
|  | if (demux1 < 0){ | 
|  | if ((demux1=open(DMX, O_RDWR|O_NONBLOCK)) | 
|  | < 0){ | 
|  | perror("DEMUX DEVICE: "); | 
|  | return -1; | 
|  | } | 
|  | } | 
|  |  | 
|  | if (demux2 < 0){ | 
|  | if ((demux2=open(DMX, 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.pes_type = 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.pes_type = 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; | 
|  | } | 
|  |  | 
|  | </programlisting> | 
|  |  | 
|  | </section> |