root/drivers/media/radio/si470x/radio-si470x-common.c
// SPDX-License-Identifier: GPL-2.0-or-later
/*
 *  drivers/media/radio/si470x/radio-si470x-common.c
 *
 *  Driver for radios with Silicon Labs Si470x FM Radio Receivers
 *
 *  Copyright (c) 2009 Tobias Lorenz <tobias.lorenz@gmx.net>
 *  Copyright (c) 2012 Hans de Goede <hdegoede@redhat.com>
 */


/*
 * History:
 * 2008-01-12   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.0
 *              - First working version
 * 2008-01-13   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.1
 *              - Improved error handling, every function now returns errno
 *              - Improved multi user access (start/mute/stop)
 *              - Channel doesn't get lost anymore after start/mute/stop
 *              - RDS support added (polling mode via interrupt EP 1)
 *              - marked default module parameters with *value*
 *              - switched from bit structs to bit masks
 *              - header file cleaned and integrated
 * 2008-01-14   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.2
 *              - hex values are now lower case
 *              - commented USB ID for ADS/Tech moved on todo list
 *              - blacklisted si470x in hid-quirks.c
 *              - rds buffer handling functions integrated into *_work, *_read
 *              - rds_command in si470x_poll exchanged against simple retval
 *              - check for firmware version 15
 *              - code order and prototypes still remain the same
 *              - spacing and bottom of band codes remain the same
 * 2008-01-16   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.3
 *              - code reordered to avoid function prototypes
 *              - switch/case defaults are now more user-friendly
 *              - unified comment style
 *              - applied all checkpatch.pl v1.12 suggestions
 *                except the warning about the too long lines with bit comments
 *              - renamed FMRADIO to RADIO to cut line length (checkpatch.pl)
 * 2008-01-22   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.4
 *              - avoid poss. locking when doing copy_to_user which may sleep
 *              - RDS is automatically activated on read now
 *              - code cleaned of unnecessary rds_commands
 *              - USB Vendor/Product ID for ADS/Tech FM Radio Receiver verified
 *                (thanks to Guillaume RAMOUSSE)
 * 2008-01-27   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.5
 *              - number of seek_retries changed to tune_timeout
 *              - fixed problem with incomplete tune operations by own buffers
 *              - optimization of variables and printf types
 *              - improved error logging
 * 2008-01-31   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Oliver Neukum <oliver@neukum.org>
 *              Version 1.0.6
 *              - fixed coverity checker warnings in *_usb_driver_disconnect
 *              - probe()/open() race by correct ordering in probe()
 *              - DMA coherency rules by separate allocation of all buffers
 *              - use of endianness macros
 *              - abuse of spinlock, replaced by mutex
 *              - racy handling of timer in disconnect,
 *                replaced by delayed_work
 *              - racy interruptible_sleep_on(),
 *                replaced with wait_event_interruptible()
 *              - handle signals in read()
 * 2008-02-08   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Oliver Neukum <oliver@neukum.org>
 *              Version 1.0.7
 *              - usb autosuspend support
 *              - unplugging fixed
 * 2008-05-07   Tobias Lorenz <tobias.lorenz@gmx.net>
 *              Version 1.0.8
 *              - hardware frequency seek support
 *              - afc indication
 *              - more safety checks, let si470x_get_freq return errno
 *              - vidioc behavior corrected according to v4l2 spec
 * 2008-10-20   Alexey Klimov <klimov.linux@gmail.com>
 *              - add support for KWorld USB FM Radio FM700
 *              - blacklisted KWorld radio in hid-core.c and hid-ids.h
 * 2008-12-03   Mark Lord <mlord@pobox.com>
 *              - add support for DealExtreme USB Radio
 * 2009-01-31   Bob Ross <pigiron@gmx.com>
 *              - correction of stereo detection/setting
 *              - correction of signal strength indicator scaling
 * 2009-01-31   Rick Bronson <rick@efn.org>
 *              Tobias Lorenz <tobias.lorenz@gmx.net>
 *              - add LED status output
 *              - get HW/SW version from scratchpad
 * 2009-06-16   Edouard Lafargue <edouard@lafargue.name>
 *              Version 1.0.10
 *              - add support for interrupt mode for RDS endpoint,
 *                instead of polling.
 *                Improves RDS reception significantly
 */


/* kernel includes */
#include "radio-si470x.h"

/**************************************************************************
 * Module Parameters
 **************************************************************************/

/* Spacing (kHz) */
/* 0: 200 kHz (USA, Australia) */
/* 1: 100 kHz (Europe, Japan) */
/* 2:  50 kHz */
static unsigned short space = 2;
module_param(space, ushort, 0444);
MODULE_PARM_DESC(space, "Spacing: 0=200kHz 1=100kHz *2=50kHz*");

/* De-emphasis */
/* 0: 75 us (USA) */
/* 1: 50 us (Europe, Australia, Japan) */
static unsigned short de = 1;
module_param(de, ushort, 0444);
MODULE_PARM_DESC(de, "De-emphasis: 0=75us *1=50us*");

/* Tune timeout */
static unsigned int tune_timeout = 3000;
module_param(tune_timeout, uint, 0644);
MODULE_PARM_DESC(tune_timeout, "Tune timeout: *3000*");

/* Seek timeout */
static unsigned int seek_timeout = 5000;
module_param(seek_timeout, uint, 0644);
MODULE_PARM_DESC(seek_timeout, "Seek timeout: *5000*");

static const struct v4l2_frequency_band bands[] = {
        {
                .type = V4L2_TUNER_RADIO,
                .index = 0,
                .capability = V4L2_TUNER_CAP_LOW | V4L2_TUNER_CAP_STEREO |
                            V4L2_TUNER_CAP_RDS | V4L2_TUNER_CAP_RDS_BLOCK_IO |
                            V4L2_TUNER_CAP_FREQ_BANDS |
                            V4L2_TUNER_CAP_HWSEEK_BOUNDED |
                            V4L2_TUNER_CAP_HWSEEK_WRAP,
                .rangelow   =  87500 * 16,
                .rangehigh  = 108000 * 16,
                .modulation = V4L2_BAND_MODULATION_FM,
        },
        {
                .type = V4L2_TUNER_RADIO,
                .index = 1,
                .capability = V4L2_TUNER_CAP_LOW | V4L2_TUNER_CAP_STEREO |
                            V4L2_TUNER_CAP_RDS | V4L2_TUNER_CAP_RDS_BLOCK_IO |
                            V4L2_TUNER_CAP_FREQ_BANDS |
                            V4L2_TUNER_CAP_HWSEEK_BOUNDED |
                            V4L2_TUNER_CAP_HWSEEK_WRAP,
                .rangelow   =  76000 * 16,
                .rangehigh  = 108000 * 16,
                .modulation = V4L2_BAND_MODULATION_FM,
        },
        {
                .type = V4L2_TUNER_RADIO,
                .index = 2,
                .capability = V4L2_TUNER_CAP_LOW | V4L2_TUNER_CAP_STEREO |
                            V4L2_TUNER_CAP_RDS | V4L2_TUNER_CAP_RDS_BLOCK_IO |
                            V4L2_TUNER_CAP_FREQ_BANDS |
                            V4L2_TUNER_CAP_HWSEEK_BOUNDED |
                            V4L2_TUNER_CAP_HWSEEK_WRAP,
                .rangelow   =  76000 * 16,
                .rangehigh  =  90000 * 16,
                .modulation = V4L2_BAND_MODULATION_FM,
        },
};

/**************************************************************************
 * Generic Functions
 **************************************************************************/

/*
 * si470x_set_band - set the band
 */
static int si470x_set_band(struct si470x_device *radio, int band)
{
        if (radio->band == band)
                return 0;

        radio->band = band;
        radio->registers[SYSCONFIG2] &= ~SYSCONFIG2_BAND;
        radio->registers[SYSCONFIG2] |= radio->band << 6;
        return radio->set_register(radio, SYSCONFIG2);
}

/*
 * si470x_set_chan - set the channel
 */
static int si470x_set_chan(struct si470x_device *radio, unsigned short chan)
{
        int retval;
        unsigned long time_left;
        bool timed_out = false;

        retval = radio->get_register(radio, POWERCFG);
        if (retval)
                return retval;

        if ((radio->registers[POWERCFG] & (POWERCFG_ENABLE|POWERCFG_DMUTE))
                != (POWERCFG_ENABLE|POWERCFG_DMUTE)) {
                return 0;
        }

        /* start tuning */
        radio->registers[CHANNEL] &= ~CHANNEL_CHAN;
        radio->registers[CHANNEL] |= CHANNEL_TUNE | chan;
        retval = radio->set_register(radio, CHANNEL);
        if (retval < 0)
                goto done;

        /* wait till tune operation has completed */
        reinit_completion(&radio->completion);
        time_left = wait_for_completion_timeout(&radio->completion,
                                                msecs_to_jiffies(tune_timeout));
        if (time_left == 0)
                timed_out = true;

        if ((radio->registers[STATUSRSSI] & STATUSRSSI_STC) == 0)
                dev_warn(&radio->videodev.dev, "tune does not complete\n");
        if (timed_out)
                dev_warn(&radio->videodev.dev,
                        "tune timed out after %u ms\n", tune_timeout);

        /* stop tuning */
        radio->registers[CHANNEL] &= ~CHANNEL_TUNE;
        retval = radio->set_register(radio, CHANNEL);

done:
        return retval;
}

/*
 * si470x_get_step - get channel spacing
 */
static unsigned int si470x_get_step(struct si470x_device *radio)
{
        /* Spacing (kHz) */
        switch ((radio->registers[SYSCONFIG2] & SYSCONFIG2_SPACE) >> 4) {
        /* 0: 200 kHz (USA, Australia) */
        case 0:
                return 200 * 16;
        /* 1: 100 kHz (Europe, Japan) */
        case 1:
                return 100 * 16;
        /* 2:  50 kHz */
        default:
                return 50 * 16;
        }
}


/*
 * si470x_get_freq - get the frequency
 */
static int si470x_get_freq(struct si470x_device *radio, unsigned int *freq)
{
        int chan, retval;

        /* read channel */
        retval = radio->get_register(radio, READCHAN);
        chan = radio->registers[READCHAN] & READCHAN_READCHAN;

        /* Frequency (MHz) = Spacing (kHz) x Channel + Bottom of Band (MHz) */
        *freq = chan * si470x_get_step(radio) + bands[radio->band].rangelow;

        return retval;
}


/*
 * si470x_set_freq - set the frequency
 */
int si470x_set_freq(struct si470x_device *radio, unsigned int freq)
{
        unsigned short chan;

        freq = clamp(freq, bands[radio->band].rangelow,
                           bands[radio->band].rangehigh);
        /* Chan = [ Freq (Mhz) - Bottom of Band (MHz) ] / Spacing (kHz) */
        chan = (freq - bands[radio->band].rangelow) / si470x_get_step(radio);

        return si470x_set_chan(radio, chan);
}
EXPORT_SYMBOL_GPL(si470x_set_freq);


/*
 * si470x_set_seek - set seek
 */
static int si470x_set_seek(struct si470x_device *radio,
                           const struct v4l2_hw_freq_seek *seek)
{
        int band, retval;
        unsigned int freq;
        bool timed_out = false;
        unsigned long time_left;

        /* set band */
        if (seek->rangelow || seek->rangehigh) {
                for (band = 0; band < ARRAY_SIZE(bands); band++) {
                        if (bands[band].rangelow  == seek->rangelow &&
                            bands[band].rangehigh == seek->rangehigh)
                                break;
                }
                if (band == ARRAY_SIZE(bands))
                        return -EINVAL; /* No matching band found */
        } else
                band = 1; /* If nothing is specified seek 76 - 108 Mhz */

        if (radio->band != band) {
                retval = si470x_get_freq(radio, &freq);
                if (retval)
                        return retval;
                retval = si470x_set_band(radio, band);
                if (retval)
                        return retval;
                retval = si470x_set_freq(radio, freq);
                if (retval)
                        return retval;
        }

        /* start seeking */
        radio->registers[POWERCFG] |= POWERCFG_SEEK;
        if (seek->wrap_around)
                radio->registers[POWERCFG] &= ~POWERCFG_SKMODE;
        else
                radio->registers[POWERCFG] |= POWERCFG_SKMODE;
        if (seek->seek_upward)
                radio->registers[POWERCFG] |= POWERCFG_SEEKUP;
        else
                radio->registers[POWERCFG] &= ~POWERCFG_SEEKUP;
        retval = radio->set_register(radio, POWERCFG);
        if (retval < 0)
                return retval;

        /* wait till tune operation has completed */
        reinit_completion(&radio->completion);
        time_left = wait_for_completion_timeout(&radio->completion,
                                                msecs_to_jiffies(seek_timeout));
        if (time_left == 0)
                timed_out = true;

        if ((radio->registers[STATUSRSSI] & STATUSRSSI_STC) == 0)
                dev_warn(&radio->videodev.dev, "seek does not complete\n");
        if (radio->registers[STATUSRSSI] & STATUSRSSI_SF)
                dev_warn(&radio->videodev.dev,
                        "seek failed / band limit reached\n");

        /* stop seeking */
        radio->registers[POWERCFG] &= ~POWERCFG_SEEK;
        retval = radio->set_register(radio, POWERCFG);

        /* try again, if timed out */
        if (retval == 0 && timed_out)
                return -ENODATA;
        return retval;
}


/*
 * si470x_start - switch on radio
 */
int si470x_start(struct si470x_device *radio)
{
        int retval;

        /* powercfg */
        radio->registers[POWERCFG] =
                POWERCFG_DMUTE | POWERCFG_ENABLE | POWERCFG_RDSM;
        retval = radio->set_register(radio, POWERCFG);
        if (retval < 0)
                goto done;

        /* sysconfig 1 */
        radio->registers[SYSCONFIG1] |= SYSCONFIG1_RDSIEN | SYSCONFIG1_STCIEN |
                                        SYSCONFIG1_RDS;
        radio->registers[SYSCONFIG1] &= ~SYSCONFIG1_GPIO2;
        radio->registers[SYSCONFIG1] |= SYSCONFIG1_GPIO2_INT;
        if (de)
                radio->registers[SYSCONFIG1] |= SYSCONFIG1_DE;
        retval = radio->set_register(radio, SYSCONFIG1);
        if (retval < 0)
                goto done;

        /* sysconfig 2 */
        radio->registers[SYSCONFIG2] =
                (0x1f  << 8) |                          /* SEEKTH */
                ((radio->band << 6) & SYSCONFIG2_BAND) |/* BAND */
                ((space << 4) & SYSCONFIG2_SPACE) |     /* SPACE */
                15;                                     /* VOLUME (max) */
        retval = radio->set_register(radio, SYSCONFIG2);
        if (retval < 0)
                goto done;

        /* reset last channel */
        retval = si470x_set_chan(radio,
                radio->registers[CHANNEL] & CHANNEL_CHAN);

done:
        return retval;
}
EXPORT_SYMBOL_GPL(si470x_start);


/*
 * si470x_stop - switch off radio
 */
int si470x_stop(struct si470x_device *radio)
{
        int retval;

        /* sysconfig 1 */
        radio->registers[SYSCONFIG1] &= ~SYSCONFIG1_RDS;
        retval = radio->set_register(radio, SYSCONFIG1);
        if (retval < 0)
                goto done;

        /* powercfg */
        radio->registers[POWERCFG] &= ~POWERCFG_DMUTE;
        /* POWERCFG_ENABLE has to automatically go low */
        radio->registers[POWERCFG] |= POWERCFG_ENABLE | POWERCFG_DISABLE;
        retval = radio->set_register(radio, POWERCFG);

done:
        return retval;
}
EXPORT_SYMBOL_GPL(si470x_stop);


/*
 * si470x_rds_on - switch on rds reception
 */
static int si470x_rds_on(struct si470x_device *radio)
{
        int retval;

        /* sysconfig 1 */
        radio->registers[SYSCONFIG1] |= SYSCONFIG1_RDS;
        retval = radio->set_register(radio, SYSCONFIG1);
        if (retval < 0)
                radio->registers[SYSCONFIG1] &= ~SYSCONFIG1_RDS;

        return retval;
}



/**************************************************************************
 * File Operations Interface
 **************************************************************************/

/*
 * si470x_fops_read - read RDS data
 */
static ssize_t si470x_fops_read(struct file *file, char __user *buf,
                size_t count, loff_t *ppos)
{
        struct si470x_device *radio = video_drvdata(file);
        int retval = 0;
        unsigned int block_count = 0;

        /* switch on rds reception */
        if ((radio->registers[SYSCONFIG1] & SYSCONFIG1_RDS) == 0)
                si470x_rds_on(radio);

        /* block if no new data available */
        while (radio->wr_index == radio->rd_index) {
                if (file->f_flags & O_NONBLOCK) {
                        retval = -EWOULDBLOCK;
                        goto done;
                }
                if (wait_event_interruptible(radio->read_queue,
                        radio->wr_index != radio->rd_index) < 0) {
                        retval = -EINTR;
                        goto done;
                }
        }

        /* calculate block count from byte count */
        count /= 3;

        /* copy RDS block out of internal buffer and to user buffer */
        while (block_count < count) {
                if (radio->rd_index == radio->wr_index)
                        break;

                /* always transfer rds complete blocks */
                if (copy_to_user(buf, &radio->buffer[radio->rd_index], 3))
                        /* retval = -EFAULT; */
                        break;

                /* increment and wrap read pointer */
                radio->rd_index += 3;
                if (radio->rd_index >= radio->buf_size)
                        radio->rd_index = 0;

                /* increment counters */
                block_count++;
                buf += 3;
                retval += 3;
        }

done:
        return retval;
}


/*
 * si470x_fops_poll - poll RDS data
 */
static __poll_t si470x_fops_poll(struct file *file,
                struct poll_table_struct *pts)
{
        struct si470x_device *radio = video_drvdata(file);
        __poll_t req_events = poll_requested_events(pts);
        __poll_t retval = v4l2_ctrl_poll(file, pts);

        if (req_events & (EPOLLIN | EPOLLRDNORM)) {
                /* switch on rds reception */
                if ((radio->registers[SYSCONFIG1] & SYSCONFIG1_RDS) == 0)
                        si470x_rds_on(radio);

                poll_wait(file, &radio->read_queue, pts);

                if (radio->rd_index != radio->wr_index)
                        retval |= EPOLLIN | EPOLLRDNORM;
        }

        return retval;
}


static int si470x_fops_open(struct file *file)
{
        struct si470x_device *radio = video_drvdata(file);

        return radio->fops_open(file);
}


/*
 * si470x_fops_release - file release
 */
static int si470x_fops_release(struct file *file)
{
        struct si470x_device *radio = video_drvdata(file);

        return radio->fops_release(file);
}


/*
 * si470x_fops - file operations interface
 */
static const struct v4l2_file_operations si470x_fops = {
        .owner                  = THIS_MODULE,
        .read                   = si470x_fops_read,
        .poll                   = si470x_fops_poll,
        .unlocked_ioctl         = video_ioctl2,
        .open                   = si470x_fops_open,
        .release                = si470x_fops_release,
};



/**************************************************************************
 * Video4Linux Interface
 **************************************************************************/


static int si470x_s_ctrl(struct v4l2_ctrl *ctrl)
{
        struct si470x_device *radio =
                container_of(ctrl->handler, struct si470x_device, hdl);

        switch (ctrl->id) {
        case V4L2_CID_AUDIO_VOLUME:
                radio->registers[SYSCONFIG2] &= ~SYSCONFIG2_VOLUME;
                radio->registers[SYSCONFIG2] |= ctrl->val;
                return radio->set_register(radio, SYSCONFIG2);
        case V4L2_CID_AUDIO_MUTE:
                if (ctrl->val)
                        radio->registers[POWERCFG] &= ~POWERCFG_DMUTE;
                else
                        radio->registers[POWERCFG] |= POWERCFG_DMUTE;
                return radio->set_register(radio, POWERCFG);
        default:
                return -EINVAL;
        }
}


/*
 * si470x_vidioc_g_tuner - get tuner attributes
 */
static int si470x_vidioc_g_tuner(struct file *file, void *priv,
                struct v4l2_tuner *tuner)
{
        struct si470x_device *radio = video_drvdata(file);
        int retval = 0;

        if (tuner->index != 0)
                return -EINVAL;

        if (!radio->status_rssi_auto_update) {
                retval = radio->get_register(radio, STATUSRSSI);
                if (retval < 0)
                        return retval;
        }

        /* driver constants */
        strscpy(tuner->name, "FM", sizeof(tuner->name));
        tuner->type = V4L2_TUNER_RADIO;
        tuner->capability = V4L2_TUNER_CAP_LOW | V4L2_TUNER_CAP_STEREO |
                            V4L2_TUNER_CAP_RDS | V4L2_TUNER_CAP_RDS_BLOCK_IO |
                            V4L2_TUNER_CAP_HWSEEK_BOUNDED |
                            V4L2_TUNER_CAP_HWSEEK_WRAP;
        tuner->rangelow  =  76 * FREQ_MUL;
        tuner->rangehigh = 108 * FREQ_MUL;

        /* stereo indicator == stereo (instead of mono) */
        if ((radio->registers[STATUSRSSI] & STATUSRSSI_ST) == 0)
                tuner->rxsubchans = V4L2_TUNER_SUB_MONO;
        else
                tuner->rxsubchans = V4L2_TUNER_SUB_STEREO;
        /* If there is a reliable method of detecting an RDS channel,
           then this code should check for that before setting this
           RDS subchannel. */
        tuner->rxsubchans |= V4L2_TUNER_SUB_RDS;

        /* mono/stereo selector */
        if ((radio->registers[POWERCFG] & POWERCFG_MONO) == 0)
                tuner->audmode = V4L2_TUNER_MODE_STEREO;
        else
                tuner->audmode = V4L2_TUNER_MODE_MONO;

        /* min is worst, max is best; signal:0..0xffff; rssi: 0..0xff */
        /* measured in units of dbµV in 1 db increments (max at ~75 dbµV) */
        tuner->signal = (radio->registers[STATUSRSSI] & STATUSRSSI_RSSI);
        /* the ideal factor is 0xffff/75 = 873,8 */
        tuner->signal = (tuner->signal * 873) + (8 * tuner->signal / 10);
        if (tuner->signal > 0xffff)
                tuner->signal = 0xffff;

        /* automatic frequency control: -1: freq to low, 1 freq to high */
        /* AFCRL does only indicate that freq. differs, not if too low/high */
        tuner->afc = (radio->registers[STATUSRSSI] & STATUSRSSI_AFCRL) ? 1 : 0;

        return retval;
}


/*
 * si470x_vidioc_s_tuner - set tuner attributes
 */
static int si470x_vidioc_s_tuner(struct file *file, void *priv,
                const struct v4l2_tuner *tuner)
{
        struct si470x_device *radio = video_drvdata(file);

        if (tuner->index != 0)
                return -EINVAL;

        /* mono/stereo selector */
        switch (tuner->audmode) {
        case V4L2_TUNER_MODE_MONO:
                radio->registers[POWERCFG] |= POWERCFG_MONO;  /* force mono */
                break;
        case V4L2_TUNER_MODE_STEREO:
        default:
                radio->registers[POWERCFG] &= ~POWERCFG_MONO; /* try stereo */
                break;
        }

        return radio->set_register(radio, POWERCFG);
}


/*
 * si470x_vidioc_g_frequency - get tuner or modulator radio frequency
 */
static int si470x_vidioc_g_frequency(struct file *file, void *priv,
                struct v4l2_frequency *freq)
{
        struct si470x_device *radio = video_drvdata(file);

        if (freq->tuner != 0)
                return -EINVAL;

        freq->type = V4L2_TUNER_RADIO;
        return si470x_get_freq(radio, &freq->frequency);
}


/*
 * si470x_vidioc_s_frequency - set tuner or modulator radio frequency
 */
static int si470x_vidioc_s_frequency(struct file *file, void *priv,
                const struct v4l2_frequency *freq)
{
        struct si470x_device *radio = video_drvdata(file);
        int retval;

        if (freq->tuner != 0)
                return -EINVAL;

        if (freq->frequency < bands[radio->band].rangelow ||
            freq->frequency > bands[radio->band].rangehigh) {
                /* Switch to band 1 which covers everything we support */
                retval = si470x_set_band(radio, 1);
                if (retval)
                        return retval;
        }
        return si470x_set_freq(radio, freq->frequency);
}


/*
 * si470x_vidioc_s_hw_freq_seek - set hardware frequency seek
 */
static int si470x_vidioc_s_hw_freq_seek(struct file *file, void *priv,
                const struct v4l2_hw_freq_seek *seek)
{
        struct si470x_device *radio = video_drvdata(file);

        if (seek->tuner != 0)
                return -EINVAL;

        if (file->f_flags & O_NONBLOCK)
                return -EWOULDBLOCK;

        return si470x_set_seek(radio, seek);
}

/*
 * si470x_vidioc_enum_freq_bands - enumerate supported bands
 */
static int si470x_vidioc_enum_freq_bands(struct file *file, void *priv,
                                         struct v4l2_frequency_band *band)
{
        if (band->tuner != 0)
                return -EINVAL;
        if (band->index >= ARRAY_SIZE(bands))
                return -EINVAL;
        *band = bands[band->index];
        return 0;
}

const struct v4l2_ctrl_ops si470x_ctrl_ops = {
        .s_ctrl = si470x_s_ctrl,
};
EXPORT_SYMBOL_GPL(si470x_ctrl_ops);

static int si470x_vidioc_querycap(struct file *file, void *priv,
                struct v4l2_capability *capability)
{
        struct si470x_device *radio = video_drvdata(file);

        return radio->vidioc_querycap(file, priv, capability);
};

/*
 * si470x_ioctl_ops - video device ioctl operations
 */
static const struct v4l2_ioctl_ops si470x_ioctl_ops = {
        .vidioc_querycap        = si470x_vidioc_querycap,
        .vidioc_g_tuner         = si470x_vidioc_g_tuner,
        .vidioc_s_tuner         = si470x_vidioc_s_tuner,
        .vidioc_g_frequency     = si470x_vidioc_g_frequency,
        .vidioc_s_frequency     = si470x_vidioc_s_frequency,
        .vidioc_s_hw_freq_seek  = si470x_vidioc_s_hw_freq_seek,
        .vidioc_enum_freq_bands = si470x_vidioc_enum_freq_bands,
        .vidioc_subscribe_event = v4l2_ctrl_subscribe_event,
        .vidioc_unsubscribe_event = v4l2_event_unsubscribe,
};


/*
 * si470x_viddev_template - video device interface
 */
const struct video_device si470x_viddev_template = {
        .fops                   = &si470x_fops,
        .name                   = DRIVER_NAME,
        .release                = video_device_release_empty,
        .ioctl_ops              = &si470x_ioctl_ops,
};
EXPORT_SYMBOL_GPL(si470x_viddev_template);

MODULE_DESCRIPTION("Core radio driver for Si470x FM Radio Receivers");
MODULE_LICENSE("GPL");