1 /*
2  * drivers/media/radio/si4713-i2c.h
3  *
4  * Property and commands definitions for Si4713 radio transmitter chip.
5  *
6  * Copyright (c) 2008 Instituto Nokia de Tecnologia - INdT
7  * Contact: Eduardo Valentin <eduardo.valentin@nokia.com>
8  *
9  * This file is licensed under the terms of the GNU General Public License
10  * version 2. This program is licensed "as is" without any warranty of any
11  * kind, whether express or implied.
12  *
13  */
14 
15 #ifndef SI4713_I2C_H
16 #define SI4713_I2C_H
17 
18 #include <linux/platform_device.h>
19 #include <linux/regulator/consumer.h>
20 #include <linux/gpio/consumer.h>
21 #include <media/v4l2-subdev.h>
22 #include <media/v4l2-ctrls.h>
23 #include <linux/platform_data/media/si4713.h>
24 
25 #define SI4713_PRODUCT_NUMBER		0x0D
26 
27 /* Command Timeouts */
28 #define DEFAULT_TIMEOUT			500
29 #define TIMEOUT_SET_PROPERTY		20
30 #define TIMEOUT_TX_TUNE_POWER		30000
31 #define TIMEOUT_TX_TUNE			110000
32 #define TIMEOUT_POWER_UP		200000
33 
34 /*
35  * Command and its arguments definitions
36  */
37 #define SI4713_PWUP_CTSIEN		(1<<7)
38 #define SI4713_PWUP_GPO2OEN		(1<<6)
39 #define SI4713_PWUP_PATCH		(1<<5)
40 #define SI4713_PWUP_XOSCEN		(1<<4)
41 #define SI4713_PWUP_FUNC_TX		0x02
42 #define SI4713_PWUP_FUNC_PATCH		0x0F
43 #define SI4713_PWUP_OPMOD_ANALOG	0x50
44 #define SI4713_PWUP_OPMOD_DIGITAL	0x0F
45 #define SI4713_PWUP_NARGS		2
46 #define SI4713_PWUP_NRESP		1
47 #define SI4713_CMD_POWER_UP		0x01
48 
49 #define SI4713_GETREV_NRESP		9
50 #define SI4713_CMD_GET_REV		0x10
51 
52 #define SI4713_PWDN_NRESP		1
53 #define SI4713_CMD_POWER_DOWN		0x11
54 
55 #define SI4713_SET_PROP_NARGS		5
56 #define SI4713_SET_PROP_NRESP		1
57 #define SI4713_CMD_SET_PROPERTY		0x12
58 
59 #define SI4713_GET_PROP_NARGS		3
60 #define SI4713_GET_PROP_NRESP		4
61 #define SI4713_CMD_GET_PROPERTY		0x13
62 
63 #define SI4713_GET_STATUS_NRESP		1
64 #define SI4713_CMD_GET_INT_STATUS	0x14
65 
66 #define SI4713_CMD_PATCH_ARGS		0x15
67 #define SI4713_CMD_PATCH_DATA		0x16
68 
69 #define SI4713_MAX_FREQ			10800
70 #define SI4713_MIN_FREQ			7600
71 #define SI4713_TXFREQ_NARGS		3
72 #define SI4713_TXFREQ_NRESP		1
73 #define SI4713_CMD_TX_TUNE_FREQ		0x30
74 
75 #define SI4713_MAX_POWER		120
76 #define SI4713_MIN_POWER		88
77 #define SI4713_MAX_ANTCAP		191
78 #define SI4713_MIN_ANTCAP		0
79 #define SI4713_TXPWR_NARGS		4
80 #define SI4713_TXPWR_NRESP		1
81 #define SI4713_CMD_TX_TUNE_POWER	0x31
82 
83 #define SI4713_TXMEA_NARGS		4
84 #define SI4713_TXMEA_NRESP		1
85 #define SI4713_CMD_TX_TUNE_MEASURE	0x32
86 
87 #define SI4713_INTACK_MASK		0x01
88 #define SI4713_TXSTATUS_NARGS		1
89 #define SI4713_TXSTATUS_NRESP		8
90 #define SI4713_CMD_TX_TUNE_STATUS	0x33
91 
92 #define SI4713_OVERMOD_BIT		(1 << 2)
93 #define SI4713_IALH_BIT			(1 << 1)
94 #define SI4713_IALL_BIT			(1 << 0)
95 #define SI4713_ASQSTATUS_NARGS		1
96 #define SI4713_ASQSTATUS_NRESP		5
97 #define SI4713_CMD_TX_ASQ_STATUS	0x34
98 
99 #define SI4713_RDSBUFF_MODE_MASK	0x87
100 #define SI4713_RDSBUFF_NARGS		7
101 #define SI4713_RDSBUFF_NRESP		6
102 #define SI4713_CMD_TX_RDS_BUFF		0x35
103 
104 #define SI4713_RDSPS_PSID_MASK		0x1F
105 #define SI4713_RDSPS_NARGS		5
106 #define SI4713_RDSPS_NRESP		1
107 #define SI4713_CMD_TX_RDS_PS		0x36
108 
109 #define SI4713_CMD_GPO_CTL		0x80
110 #define SI4713_CMD_GPO_SET		0x81
111 
112 /*
113  * Bits from status response
114  */
115 #define SI4713_CTS			(1<<7)
116 #define SI4713_ERR			(1<<6)
117 #define SI4713_RDS_INT			(1<<2)
118 #define SI4713_ASQ_INT			(1<<1)
119 #define SI4713_STC_INT			(1<<0)
120 
121 /*
122  * Property definitions
123  */
124 #define SI4713_GPO_IEN			0x0001
125 #define SI4713_DIG_INPUT_FORMAT		0x0101
126 #define SI4713_DIG_INPUT_SAMPLE_RATE	0x0103
127 #define SI4713_REFCLK_FREQ		0x0201
128 #define SI4713_REFCLK_PRESCALE		0x0202
129 #define SI4713_TX_COMPONENT_ENABLE	0x2100
130 #define SI4713_TX_AUDIO_DEVIATION	0x2101
131 #define SI4713_TX_PILOT_DEVIATION	0x2102
132 #define SI4713_TX_RDS_DEVIATION		0x2103
133 #define SI4713_TX_LINE_INPUT_LEVEL	0x2104
134 #define SI4713_TX_LINE_INPUT_MUTE	0x2105
135 #define SI4713_TX_PREEMPHASIS		0x2106
136 #define SI4713_TX_PILOT_FREQUENCY	0x2107
137 #define SI4713_TX_ACOMP_ENABLE		0x2200
138 #define SI4713_TX_ACOMP_THRESHOLD	0x2201
139 #define SI4713_TX_ACOMP_ATTACK_TIME	0x2202
140 #define SI4713_TX_ACOMP_RELEASE_TIME	0x2203
141 #define SI4713_TX_ACOMP_GAIN		0x2204
142 #define SI4713_TX_LIMITER_RELEASE_TIME	0x2205
143 #define SI4713_TX_ASQ_INTERRUPT_SOURCE	0x2300
144 #define SI4713_TX_ASQ_LEVEL_LOW		0x2301
145 #define SI4713_TX_ASQ_DURATION_LOW	0x2302
146 #define SI4713_TX_ASQ_LEVEL_HIGH	0x2303
147 #define SI4713_TX_ASQ_DURATION_HIGH	0x2304
148 #define SI4713_TX_RDS_INTERRUPT_SOURCE	0x2C00
149 #define SI4713_TX_RDS_PI		0x2C01
150 #define SI4713_TX_RDS_PS_MIX		0x2C02
151 #define SI4713_TX_RDS_PS_MISC		0x2C03
152 #define SI4713_TX_RDS_PS_REPEAT_COUNT	0x2C04
153 #define SI4713_TX_RDS_PS_MESSAGE_COUNT	0x2C05
154 #define SI4713_TX_RDS_PS_AF		0x2C06
155 #define SI4713_TX_RDS_FIFO_SIZE		0x2C07
156 
157 #define PREEMPHASIS_USA			75
158 #define PREEMPHASIS_EU			50
159 #define PREEMPHASIS_DISABLED		0
160 #define FMPE_USA			0x00
161 #define FMPE_EU				0x01
162 #define FMPE_DISABLED			0x02
163 
164 #define POWER_UP			0x01
165 #define POWER_DOWN			0x00
166 
167 #define MAX_RDS_PTY			31
168 #define MAX_RDS_DEVIATION		90000
169 
170 /*
171  * PSNAME is known to be defined as 8 character sized (RDS Spec).
172  * However, there is receivers which scroll PSNAME 8xN sized.
173  */
174 #define MAX_RDS_PS_NAME			96
175 
176 /*
177  * MAX_RDS_RADIO_TEXT is known to be defined as 32 (2A group) or 64 (2B group)
178  * character sized (RDS Spec).
179  * However, there is receivers which scroll them as well.
180  */
181 #define MAX_RDS_RADIO_TEXT		384
182 
183 #define MAX_LIMITER_RELEASE_TIME	102390
184 #define MAX_LIMITER_DEVIATION		90000
185 
186 #define MAX_PILOT_DEVIATION		90000
187 #define MAX_PILOT_FREQUENCY		19000
188 
189 #define MAX_ACOMP_RELEASE_TIME		1000000
190 #define MAX_ACOMP_ATTACK_TIME		5000
191 #define MAX_ACOMP_THRESHOLD		0
192 #define MIN_ACOMP_THRESHOLD		(-40)
193 #define MAX_ACOMP_GAIN			20
194 
195 /*
196  * si4713_device - private data
197  */
198 struct si4713_device {
199 	/* v4l2_subdev and i2c reference (v4l2_subdev priv data) */
200 	struct v4l2_subdev sd;
201 	struct v4l2_ctrl_handler ctrl_handler;
202 	/* private data structures */
203 	struct { /* si4713 control cluster */
204 		/* This is one big cluster since the mute control
205 		 * powers off the device and after unmuting again all
206 		 * controls need to be set at once. The only way of doing
207 		 * that is by making it one big cluster. */
208 		struct v4l2_ctrl *mute;
209 		struct v4l2_ctrl *rds_ps_name;
210 		struct v4l2_ctrl *rds_radio_text;
211 		struct v4l2_ctrl *rds_pi;
212 		struct v4l2_ctrl *rds_deviation;
213 		struct v4l2_ctrl *rds_pty;
214 		struct v4l2_ctrl *rds_compressed;
215 		struct v4l2_ctrl *rds_art_head;
216 		struct v4l2_ctrl *rds_stereo;
217 		struct v4l2_ctrl *rds_ta;
218 		struct v4l2_ctrl *rds_tp;
219 		struct v4l2_ctrl *rds_ms;
220 		struct v4l2_ctrl *rds_dyn_pty;
221 		struct v4l2_ctrl *rds_alt_freqs_enable;
222 		struct v4l2_ctrl *rds_alt_freqs;
223 		struct v4l2_ctrl *compression_enabled;
224 		struct v4l2_ctrl *compression_threshold;
225 		struct v4l2_ctrl *compression_gain;
226 		struct v4l2_ctrl *compression_attack_time;
227 		struct v4l2_ctrl *compression_release_time;
228 		struct v4l2_ctrl *pilot_tone_enabled;
229 		struct v4l2_ctrl *pilot_tone_freq;
230 		struct v4l2_ctrl *pilot_tone_deviation;
231 		struct v4l2_ctrl *limiter_enabled;
232 		struct v4l2_ctrl *limiter_deviation;
233 		struct v4l2_ctrl *limiter_release_time;
234 		struct v4l2_ctrl *tune_preemphasis;
235 		struct v4l2_ctrl *tune_pwr_level;
236 		struct v4l2_ctrl *tune_ant_cap;
237 	};
238 	struct completion work;
239 	struct regulator *vdd;
240 	struct regulator *vio;
241 	struct gpio_desc *gpio_reset;
242 	struct platform_device *pd;
243 	u32 power_state;
244 	u32 rds_enabled;
245 	u32 frequency;
246 	u32 preemphasis;
247 	u32 stereo;
248 	u32 tune_rnl;
249 };
250 
251 struct radio_si4713_platform_data {
252 	struct i2c_client *subdev;
253 };
254 #endif /* ifndef SI4713_I2C_H */
255