]>
Commit | Line | Data |
---|---|---|
b09cd163 JS |
1 | /* |
2 | * drivers/media/radio/si470x/radio-si470x.h | |
3 | * | |
4 | * Driver for radios with Silicon Labs Si470x FM Radio Receivers | |
5 | * | |
6 | * Copyright (c) 2009 Tobias Lorenz <tobias.lorenz@gmx.net> | |
7 | * | |
8 | * This program is free software; you can redistribute it and/or modify | |
9 | * it under the terms of the GNU General Public License as published by | |
10 | * the Free Software Foundation; either version 2 of the License, or | |
11 | * (at your option) any later version. | |
12 | * | |
13 | * This program is distributed in the hope that it will be useful, | |
14 | * but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | * GNU General Public License for more details. | |
17 | * | |
18 | * You should have received a copy of the GNU General Public License | |
19 | * along with this program; if not, write to the Free Software | |
20 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
21 | */ | |
22 | ||
23 | ||
24 | /* driver definitions */ | |
25 | #define DRIVER_NAME "radio-si470x" | |
26 | ||
27 | ||
28 | /* kernel includes */ | |
29 | #include <linux/kernel.h> | |
30 | #include <linux/module.h> | |
31 | #include <linux/init.h> | |
788f6feb | 32 | #include <linux/sched.h> |
b09cd163 | 33 | #include <linux/slab.h> |
b09cd163 JS |
34 | #include <linux/input.h> |
35 | #include <linux/version.h> | |
36 | #include <linux/videodev2.h> | |
37 | #include <linux/mutex.h> | |
38 | #include <media/v4l2-common.h> | |
39 | #include <media/v4l2-ioctl.h> | |
40 | #include <media/rds.h> | |
41 | #include <asm/unaligned.h> | |
42 | ||
43 | ||
9dcb79c2 | 44 | |
b09cd163 JS |
45 | /************************************************************************** |
46 | * Register Definitions | |
47 | **************************************************************************/ | |
48 | #define RADIO_REGISTER_SIZE 2 /* 16 register bit width */ | |
49 | #define RADIO_REGISTER_NUM 16 /* DEVICEID ... RDSD */ | |
50 | #define RDS_REGISTER_NUM 6 /* STATUSRSSI ... RDSD */ | |
51 | ||
52 | #define DEVICEID 0 /* Device ID */ | |
53 | #define DEVICEID_PN 0xf000 /* bits 15..12: Part Number */ | |
54 | #define DEVICEID_MFGID 0x0fff /* bits 11..00: Manufacturer ID */ | |
55 | ||
56 | #define CHIPID 1 /* Chip ID */ | |
57 | #define CHIPID_REV 0xfc00 /* bits 15..10: Chip Version */ | |
58 | #define CHIPID_DEV 0x0200 /* bits 09..09: Device */ | |
59 | #define CHIPID_FIRMWARE 0x01ff /* bits 08..00: Firmware Version */ | |
60 | ||
61 | #define POWERCFG 2 /* Power Configuration */ | |
62 | #define POWERCFG_DSMUTE 0x8000 /* bits 15..15: Softmute Disable */ | |
63 | #define POWERCFG_DMUTE 0x4000 /* bits 14..14: Mute Disable */ | |
64 | #define POWERCFG_MONO 0x2000 /* bits 13..13: Mono Select */ | |
65 | #define POWERCFG_RDSM 0x0800 /* bits 11..11: RDS Mode (Si4701 only) */ | |
66 | #define POWERCFG_SKMODE 0x0400 /* bits 10..10: Seek Mode */ | |
67 | #define POWERCFG_SEEKUP 0x0200 /* bits 09..09: Seek Direction */ | |
68 | #define POWERCFG_SEEK 0x0100 /* bits 08..08: Seek */ | |
69 | #define POWERCFG_DISABLE 0x0040 /* bits 06..06: Powerup Disable */ | |
70 | #define POWERCFG_ENABLE 0x0001 /* bits 00..00: Powerup Enable */ | |
71 | ||
72 | #define CHANNEL 3 /* Channel */ | |
73 | #define CHANNEL_TUNE 0x8000 /* bits 15..15: Tune */ | |
74 | #define CHANNEL_CHAN 0x03ff /* bits 09..00: Channel Select */ | |
75 | ||
76 | #define SYSCONFIG1 4 /* System Configuration 1 */ | |
77 | #define SYSCONFIG1_RDSIEN 0x8000 /* bits 15..15: RDS Interrupt Enable (Si4701 only) */ | |
78 | #define SYSCONFIG1_STCIEN 0x4000 /* bits 14..14: Seek/Tune Complete Interrupt Enable */ | |
79 | #define SYSCONFIG1_RDS 0x1000 /* bits 12..12: RDS Enable (Si4701 only) */ | |
80 | #define SYSCONFIG1_DE 0x0800 /* bits 11..11: De-emphasis (0=75us 1=50us) */ | |
81 | #define SYSCONFIG1_AGCD 0x0400 /* bits 10..10: AGC Disable */ | |
82 | #define SYSCONFIG1_BLNDADJ 0x00c0 /* bits 07..06: Stereo/Mono Blend Level Adjustment */ | |
83 | #define SYSCONFIG1_GPIO3 0x0030 /* bits 05..04: General Purpose I/O 3 */ | |
84 | #define SYSCONFIG1_GPIO2 0x000c /* bits 03..02: General Purpose I/O 2 */ | |
85 | #define SYSCONFIG1_GPIO1 0x0003 /* bits 01..00: General Purpose I/O 1 */ | |
86 | ||
87 | #define SYSCONFIG2 5 /* System Configuration 2 */ | |
88 | #define SYSCONFIG2_SEEKTH 0xff00 /* bits 15..08: RSSI Seek Threshold */ | |
89 | #define SYSCONFIG2_BAND 0x0080 /* bits 07..06: Band Select */ | |
90 | #define SYSCONFIG2_SPACE 0x0030 /* bits 05..04: Channel Spacing */ | |
91 | #define SYSCONFIG2_VOLUME 0x000f /* bits 03..00: Volume */ | |
92 | ||
93 | #define SYSCONFIG3 6 /* System Configuration 3 */ | |
94 | #define SYSCONFIG3_SMUTER 0xc000 /* bits 15..14: Softmute Attack/Recover Rate */ | |
95 | #define SYSCONFIG3_SMUTEA 0x3000 /* bits 13..12: Softmute Attenuation */ | |
96 | #define SYSCONFIG3_SKSNR 0x00f0 /* bits 07..04: Seek SNR Threshold */ | |
97 | #define SYSCONFIG3_SKCNT 0x000f /* bits 03..00: Seek FM Impulse Detection Threshold */ | |
98 | ||
99 | #define TEST1 7 /* Test 1 */ | |
100 | #define TEST1_AHIZEN 0x4000 /* bits 14..14: Audio High-Z Enable */ | |
101 | ||
102 | #define TEST2 8 /* Test 2 */ | |
103 | /* TEST2 only contains reserved bits */ | |
104 | ||
105 | #define BOOTCONFIG 9 /* Boot Configuration */ | |
106 | /* BOOTCONFIG only contains reserved bits */ | |
107 | ||
108 | #define STATUSRSSI 10 /* Status RSSI */ | |
109 | #define STATUSRSSI_RDSR 0x8000 /* bits 15..15: RDS Ready (Si4701 only) */ | |
110 | #define STATUSRSSI_STC 0x4000 /* bits 14..14: Seek/Tune Complete */ | |
111 | #define STATUSRSSI_SF 0x2000 /* bits 13..13: Seek Fail/Band Limit */ | |
112 | #define STATUSRSSI_AFCRL 0x1000 /* bits 12..12: AFC Rail */ | |
113 | #define STATUSRSSI_RDSS 0x0800 /* bits 11..11: RDS Synchronized (Si4701 only) */ | |
114 | #define STATUSRSSI_BLERA 0x0600 /* bits 10..09: RDS Block A Errors (Si4701 only) */ | |
115 | #define STATUSRSSI_ST 0x0100 /* bits 08..08: Stereo Indicator */ | |
116 | #define STATUSRSSI_RSSI 0x00ff /* bits 07..00: RSSI (Received Signal Strength Indicator) */ | |
117 | ||
118 | #define READCHAN 11 /* Read Channel */ | |
119 | #define READCHAN_BLERB 0xc000 /* bits 15..14: RDS Block D Errors (Si4701 only) */ | |
120 | #define READCHAN_BLERC 0x3000 /* bits 13..12: RDS Block C Errors (Si4701 only) */ | |
121 | #define READCHAN_BLERD 0x0c00 /* bits 11..10: RDS Block B Errors (Si4701 only) */ | |
122 | #define READCHAN_READCHAN 0x03ff /* bits 09..00: Read Channel */ | |
123 | ||
124 | #define RDSA 12 /* RDSA */ | |
125 | #define RDSA_RDSA 0xffff /* bits 15..00: RDS Block A Data (Si4701 only) */ | |
126 | ||
127 | #define RDSB 13 /* RDSB */ | |
128 | #define RDSB_RDSB 0xffff /* bits 15..00: RDS Block B Data (Si4701 only) */ | |
129 | ||
130 | #define RDSC 14 /* RDSC */ | |
131 | #define RDSC_RDSC 0xffff /* bits 15..00: RDS Block C Data (Si4701 only) */ | |
132 | ||
133 | #define RDSD 15 /* RDSD */ | |
134 | #define RDSD_RDSD 0xffff /* bits 15..00: RDS Block D Data (Si4701 only) */ | |
135 | ||
136 | ||
9dcb79c2 | 137 | |
b09cd163 JS |
138 | /************************************************************************** |
139 | * General Driver Definitions | |
140 | **************************************************************************/ | |
141 | ||
142 | /* | |
143 | * si470x_device - private data | |
144 | */ | |
145 | struct si470x_device { | |
146 | struct video_device *videodev; | |
147 | ||
9dcb79c2 TL |
148 | /* driver management */ |
149 | unsigned int users; | |
150 | ||
151 | /* Silabs internal registers (0..15) */ | |
152 | unsigned short registers[RADIO_REGISTER_NUM]; | |
153 | ||
154 | /* RDS receive buffer */ | |
155 | wait_queue_head_t read_queue; | |
156 | struct mutex lock; /* buffer locking */ | |
157 | unsigned char *buffer; /* size is always multiple of three */ | |
158 | unsigned int buf_size; | |
159 | unsigned int rd_index; | |
160 | unsigned int wr_index; | |
cc35bbdd JS |
161 | |
162 | #if defined(CONFIG_USB_SI470X) || defined(CONFIG_USB_SI470X_MODULE) | |
b09cd163 JS |
163 | /* reference to USB and video device */ |
164 | struct usb_device *usbdev; | |
165 | struct usb_interface *intf; | |
166 | ||
167 | /* Interrupt endpoint handling */ | |
168 | char *int_in_buffer; | |
169 | struct usb_endpoint_descriptor *int_in_endpoint; | |
170 | struct urb *int_in_urb; | |
171 | int int_in_running; | |
172 | ||
173 | /* scratch page */ | |
174 | unsigned char software_version; | |
175 | unsigned char hardware_version; | |
176 | ||
177 | /* driver management */ | |
178 | unsigned char disconnected; | |
cc35bbdd | 179 | #endif |
b09cd163 | 180 | |
9dcb79c2 TL |
181 | #if defined(CONFIG_I2C_SI470X) || defined(CONFIG_I2C_SI470X_MODULE) |
182 | struct i2c_client *client; | |
fe2137dd | 183 | struct work_struct radio_work; |
9dcb79c2 | 184 | #endif |
b09cd163 JS |
185 | }; |
186 | ||
187 | ||
9dcb79c2 TL |
188 | |
189 | /************************************************************************** | |
190 | * Firmware Versions | |
191 | **************************************************************************/ | |
192 | ||
193 | #define RADIO_FW_VERSION 15 | |
194 | ||
195 | ||
196 | ||
197 | /************************************************************************** | |
198 | * Frequency Multiplicator | |
199 | **************************************************************************/ | |
200 | ||
b09cd163 JS |
201 | /* |
202 | * The frequency is set in units of 62.5 Hz when using V4L2_TUNER_CAP_LOW, | |
203 | * 62.5 kHz otherwise. | |
204 | * The tuner is able to have a channel spacing of 50, 100 or 200 kHz. | |
205 | * tuner->capability is therefore set to V4L2_TUNER_CAP_LOW | |
206 | * The FREQ_MUL is then: 1 MHz / 62.5 Hz = 16000 | |
207 | */ | |
208 | #define FREQ_MUL (1000000 / 62.5) | |
209 | ||
210 | ||
211 | ||
212 | /************************************************************************** | |
213 | * Common Functions | |
214 | **************************************************************************/ | |
b09cd163 JS |
215 | extern struct video_device si470x_viddev_template; |
216 | int si470x_get_register(struct si470x_device *radio, int regnr); | |
217 | int si470x_set_register(struct si470x_device *radio, int regnr); | |
3c7cc8d5 | 218 | int si470x_disconnect_check(struct si470x_device *radio); |
b09cd163 JS |
219 | int si470x_set_freq(struct si470x_device *radio, unsigned int freq); |
220 | int si470x_start(struct si470x_device *radio); | |
221 | int si470x_stop(struct si470x_device *radio); | |
1aa925c9 JS |
222 | int si470x_fops_open(struct file *file); |
223 | int si470x_fops_release(struct file *file); | |
b09cd163 JS |
224 | int si470x_vidioc_querycap(struct file *file, void *priv, |
225 | struct v4l2_capability *capability); |