1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * drivers/mfd/si476x-cmd.c -- Subroutines implementing command
4 * protocol of si476x series of chips
5 *
6 * Copyright (C) 2012 Innovative Converged Devices(ICD)
7 * Copyright (C) 2013 Andrey Smirnov
8 *
9 * Author: Andrey Smirnov <andrew.smirnov@gmail.com>
10 */
11
12 #include <linux/module.h>
13 #include <linux/completion.h>
14 #include <linux/delay.h>
15 #include <linux/atomic.h>
16 #include <linux/i2c.h>
17 #include <linux/device.h>
18 #include <linux/gpio.h>
19 #include <linux/videodev2.h>
20
21 #include <linux/mfd/si476x-core.h>
22
23 #include <asm/unaligned.h>
24
25 #define msb(x) ((u8)((u16) x >> 8))
26 #define lsb(x) ((u8)((u16) x & 0x00FF))
27
28
29
30 #define CMD_POWER_UP 0x01
31 #define CMD_POWER_UP_A10_NRESP 1
32 #define CMD_POWER_UP_A10_NARGS 5
33
34 #define CMD_POWER_UP_A20_NRESP 1
35 #define CMD_POWER_UP_A20_NARGS 5
36
37 #define POWER_UP_DELAY_MS 110
38
39 #define CMD_POWER_DOWN 0x11
40 #define CMD_POWER_DOWN_A10_NRESP 1
41
42 #define CMD_POWER_DOWN_A20_NRESP 1
43 #define CMD_POWER_DOWN_A20_NARGS 1
44
45 #define CMD_FUNC_INFO 0x12
46 #define CMD_FUNC_INFO_NRESP 7
47
48 #define CMD_SET_PROPERTY 0x13
49 #define CMD_SET_PROPERTY_NARGS 5
50 #define CMD_SET_PROPERTY_NRESP 1
51
52 #define CMD_GET_PROPERTY 0x14
53 #define CMD_GET_PROPERTY_NARGS 3
54 #define CMD_GET_PROPERTY_NRESP 4
55
56 #define CMD_AGC_STATUS 0x17
57 #define CMD_AGC_STATUS_NRESP_A10 2
58 #define CMD_AGC_STATUS_NRESP_A20 6
59
60 #define PIN_CFG_BYTE(x) (0x7F & (x))
61 #define CMD_DIG_AUDIO_PIN_CFG 0x18
62 #define CMD_DIG_AUDIO_PIN_CFG_NARGS 4
63 #define CMD_DIG_AUDIO_PIN_CFG_NRESP 5
64
65 #define CMD_ZIF_PIN_CFG 0x19
66 #define CMD_ZIF_PIN_CFG_NARGS 4
67 #define CMD_ZIF_PIN_CFG_NRESP 5
68
69 #define CMD_IC_LINK_GPO_CTL_PIN_CFG 0x1A
70 #define CMD_IC_LINK_GPO_CTL_PIN_CFG_NARGS 4
71 #define CMD_IC_LINK_GPO_CTL_PIN_CFG_NRESP 5
72
73 #define CMD_ANA_AUDIO_PIN_CFG 0x1B
74 #define CMD_ANA_AUDIO_PIN_CFG_NARGS 1
75 #define CMD_ANA_AUDIO_PIN_CFG_NRESP 2
76
77 #define CMD_INTB_PIN_CFG 0x1C
78 #define CMD_INTB_PIN_CFG_NARGS 2
79 #define CMD_INTB_PIN_CFG_A10_NRESP 6
80 #define CMD_INTB_PIN_CFG_A20_NRESP 3
81
82 #define CMD_FM_TUNE_FREQ 0x30
83 #define CMD_FM_TUNE_FREQ_A10_NARGS 5
84 #define CMD_FM_TUNE_FREQ_A20_NARGS 3
85 #define CMD_FM_TUNE_FREQ_NRESP 1
86
87 #define CMD_FM_RSQ_STATUS 0x32
88
89 #define CMD_FM_RSQ_STATUS_A10_NARGS 1
90 #define CMD_FM_RSQ_STATUS_A10_NRESP 17
91 #define CMD_FM_RSQ_STATUS_A30_NARGS 1
92 #define CMD_FM_RSQ_STATUS_A30_NRESP 23
93
94
95 #define CMD_FM_SEEK_START 0x31
96 #define CMD_FM_SEEK_START_NARGS 1
97 #define CMD_FM_SEEK_START_NRESP 1
98
99 #define CMD_FM_RDS_STATUS 0x36
100 #define CMD_FM_RDS_STATUS_NARGS 1
101 #define CMD_FM_RDS_STATUS_NRESP 16
102
103 #define CMD_FM_RDS_BLOCKCOUNT 0x37
104 #define CMD_FM_RDS_BLOCKCOUNT_NARGS 1
105 #define CMD_FM_RDS_BLOCKCOUNT_NRESP 8
106
107 #define CMD_FM_PHASE_DIVERSITY 0x38
108 #define CMD_FM_PHASE_DIVERSITY_NARGS 1
109 #define CMD_FM_PHASE_DIVERSITY_NRESP 1
110
111 #define CMD_FM_PHASE_DIV_STATUS 0x39
112 #define CMD_FM_PHASE_DIV_STATUS_NRESP 2
113
114 #define CMD_AM_TUNE_FREQ 0x40
115 #define CMD_AM_TUNE_FREQ_NARGS 3
116 #define CMD_AM_TUNE_FREQ_NRESP 1
117
118 #define CMD_AM_RSQ_STATUS 0x42
119 #define CMD_AM_RSQ_STATUS_NARGS 1
120 #define CMD_AM_RSQ_STATUS_NRESP 13
121
122 #define CMD_AM_SEEK_START 0x41
123 #define CMD_AM_SEEK_START_NARGS 1
124 #define CMD_AM_SEEK_START_NRESP 1
125
126
127 #define CMD_AM_ACF_STATUS 0x45
128 #define CMD_AM_ACF_STATUS_NRESP 6
129 #define CMD_AM_ACF_STATUS_NARGS 1
130
131 #define CMD_FM_ACF_STATUS 0x35
132 #define CMD_FM_ACF_STATUS_NRESP 8
133 #define CMD_FM_ACF_STATUS_NARGS 1
134
135 #define CMD_MAX_ARGS_COUNT (10)
136
137
138 enum si476x_acf_status_report_bits {
139 SI476X_ACF_BLEND_INT = (1 << 4),
140 SI476X_ACF_HIBLEND_INT = (1 << 3),
141 SI476X_ACF_HICUT_INT = (1 << 2),
142 SI476X_ACF_CHBW_INT = (1 << 1),
143 SI476X_ACF_SOFTMUTE_INT = (1 << 0),
144
145 SI476X_ACF_SMUTE = (1 << 0),
146 SI476X_ACF_SMATTN = 0x1f,
147 SI476X_ACF_PILOT = (1 << 7),
148 SI476X_ACF_STBLEND = ~SI476X_ACF_PILOT,
149 };
150
151 enum si476x_agc_status_report_bits {
152 SI476X_AGC_MXHI = (1 << 5),
153 SI476X_AGC_MXLO = (1 << 4),
154 SI476X_AGC_LNAHI = (1 << 3),
155 SI476X_AGC_LNALO = (1 << 2),
156 };
157
158 enum si476x_errors {
159 SI476X_ERR_BAD_COMMAND = 0x10,
160 SI476X_ERR_BAD_ARG1 = 0x11,
161 SI476X_ERR_BAD_ARG2 = 0x12,
162 SI476X_ERR_BAD_ARG3 = 0x13,
163 SI476X_ERR_BAD_ARG4 = 0x14,
164 SI476X_ERR_BUSY = 0x18,
165 SI476X_ERR_BAD_INTERNAL_MEMORY = 0x20,
166 SI476X_ERR_BAD_PATCH = 0x30,
167 SI476X_ERR_BAD_BOOT_MODE = 0x31,
168 SI476X_ERR_BAD_PROPERTY = 0x40,
169 };
170
si476x_core_parse_and_nag_about_error(struct si476x_core * core)171 static int si476x_core_parse_and_nag_about_error(struct si476x_core *core)
172 {
173 int err;
174 char *cause;
175 u8 buffer[2];
176
177 if (core->revision != SI476X_REVISION_A10) {
178 err = si476x_core_i2c_xfer(core, SI476X_I2C_RECV,
179 buffer, sizeof(buffer));
180 if (err == sizeof(buffer)) {
181 switch (buffer[1]) {
182 case SI476X_ERR_BAD_COMMAND:
183 cause = "Bad command";
184 err = -EINVAL;
185 break;
186 case SI476X_ERR_BAD_ARG1:
187 cause = "Bad argument #1";
188 err = -EINVAL;
189 break;
190 case SI476X_ERR_BAD_ARG2:
191 cause = "Bad argument #2";
192 err = -EINVAL;
193 break;
194 case SI476X_ERR_BAD_ARG3:
195 cause = "Bad argument #3";
196 err = -EINVAL;
197 break;
198 case SI476X_ERR_BAD_ARG4:
199 cause = "Bad argument #4";
200 err = -EINVAL;
201 break;
202 case SI476X_ERR_BUSY:
203 cause = "Chip is busy";
204 err = -EBUSY;
205 break;
206 case SI476X_ERR_BAD_INTERNAL_MEMORY:
207 cause = "Bad internal memory";
208 err = -EIO;
209 break;
210 case SI476X_ERR_BAD_PATCH:
211 cause = "Bad patch";
212 err = -EINVAL;
213 break;
214 case SI476X_ERR_BAD_BOOT_MODE:
215 cause = "Bad boot mode";
216 err = -EINVAL;
217 break;
218 case SI476X_ERR_BAD_PROPERTY:
219 cause = "Bad property";
220 err = -EINVAL;
221 break;
222 default:
223 cause = "Unknown";
224 err = -EIO;
225 }
226
227 dev_err(&core->client->dev,
228 "[Chip error status]: %s\n", cause);
229 } else {
230 dev_err(&core->client->dev,
231 "Failed to fetch error code\n");
232 err = (err >= 0) ? -EIO : err;
233 }
234 } else {
235 err = -EIO;
236 }
237
238 return err;
239 }
240
241 /**
242 * si476x_core_send_command() - sends a command to si476x and waits its
243 * response
244 * @core: si476x_device structure for the device we are
245 * communicating with
246 * @command: command id
247 * @args: command arguments we are sending
248 * @argn: actual size of @args
249 * @response: buffer to place the expected response from the device
250 * @respn: actual size of @response
251 * @usecs: amount of time to wait before reading the response (in
252 * usecs)
253 *
254 * Function returns 0 on succsess and negative error code on
255 * failure
256 */
si476x_core_send_command(struct si476x_core * core,const u8 command,const u8 args[],const int argn,u8 resp[],const int respn,const int usecs)257 static int si476x_core_send_command(struct si476x_core *core,
258 const u8 command,
259 const u8 args[],
260 const int argn,
261 u8 resp[],
262 const int respn,
263 const int usecs)
264 {
265 struct i2c_client *client = core->client;
266 int err;
267 u8 data[CMD_MAX_ARGS_COUNT + 1];
268
269 if (argn > CMD_MAX_ARGS_COUNT) {
270 err = -ENOMEM;
271 goto exit;
272 }
273
274 if (!client->adapter) {
275 err = -ENODEV;
276 goto exit;
277 }
278
279 /* First send the command and its arguments */
280 data[0] = command;
281 memcpy(&data[1], args, argn);
282 dev_dbg(&client->dev, "Command:\n %*ph\n", argn + 1, data);
283
284 err = si476x_core_i2c_xfer(core, SI476X_I2C_SEND,
285 (char *) data, argn + 1);
286 if (err != argn + 1) {
287 dev_err(&core->client->dev,
288 "Error while sending command 0x%02x\n",
289 command);
290 err = (err >= 0) ? -EIO : err;
291 goto exit;
292 }
293 /* Set CTS to zero only after the command is send to avoid
294 * possible racing conditions when working in polling mode */
295 atomic_set(&core->cts, 0);
296
297 /* if (unlikely(command == CMD_POWER_DOWN) */
298 if (!wait_event_timeout(core->command,
299 atomic_read(&core->cts),
300 usecs_to_jiffies(usecs) + 1))
301 dev_warn(&core->client->dev,
302 "(%s) [CMD 0x%02x] Answer timeout.\n",
303 __func__, command);
304
305 /*
306 When working in polling mode, for some reason the tuner will
307 report CTS bit as being set in the first status byte read,
308 but all the consequtive ones will return zeros until the
309 tuner is actually completed the POWER_UP command. To
310 workaround that we wait for second CTS to be reported
311 */
312 if (unlikely(!core->client->irq && command == CMD_POWER_UP)) {
313 if (!wait_event_timeout(core->command,
314 atomic_read(&core->cts),
315 usecs_to_jiffies(usecs) + 1))
316 dev_warn(&core->client->dev,
317 "(%s) Power up took too much time.\n",
318 __func__);
319 }
320
321 /* Then get the response */
322 err = si476x_core_i2c_xfer(core, SI476X_I2C_RECV, resp, respn);
323 if (err != respn) {
324 dev_err(&core->client->dev,
325 "Error while reading response for command 0x%02x\n",
326 command);
327 err = (err >= 0) ? -EIO : err;
328 goto exit;
329 }
330 dev_dbg(&client->dev, "Response:\n %*ph\n", respn, resp);
331
332 err = 0;
333
334 if (resp[0] & SI476X_ERR) {
335 dev_err(&core->client->dev,
336 "[CMD 0x%02x] Chip set error flag\n", command);
337 err = si476x_core_parse_and_nag_about_error(core);
338 goto exit;
339 }
340
341 if (!(resp[0] & SI476X_CTS))
342 err = -EBUSY;
343 exit:
344 return err;
345 }
346
si476x_cmd_clear_stc(struct si476x_core * core)347 static int si476x_cmd_clear_stc(struct si476x_core *core)
348 {
349 int err;
350 struct si476x_rsq_status_args args = {
351 .primary = false,
352 .rsqack = false,
353 .attune = false,
354 .cancel = false,
355 .stcack = true,
356 };
357
358 switch (core->power_up_parameters.func) {
359 case SI476X_FUNC_FM_RECEIVER:
360 err = si476x_core_cmd_fm_rsq_status(core, &args, NULL);
361 break;
362 case SI476X_FUNC_AM_RECEIVER:
363 err = si476x_core_cmd_am_rsq_status(core, &args, NULL);
364 break;
365 default:
366 err = -EINVAL;
367 }
368
369 return err;
370 }
371
si476x_cmd_tune_seek_freq(struct si476x_core * core,uint8_t cmd,const uint8_t args[],size_t argn,uint8_t * resp,size_t respn)372 static int si476x_cmd_tune_seek_freq(struct si476x_core *core,
373 uint8_t cmd,
374 const uint8_t args[], size_t argn,
375 uint8_t *resp, size_t respn)
376 {
377 int err;
378
379
380 atomic_set(&core->stc, 0);
381 err = si476x_core_send_command(core, cmd, args, argn, resp, respn,
382 SI476X_TIMEOUT_TUNE);
383 if (!err) {
384 wait_event_killable(core->tuning,
385 atomic_read(&core->stc));
386 si476x_cmd_clear_stc(core);
387 }
388
389 return err;
390 }
391
392 /**
393 * si476x_cmd_func_info() - send 'FUNC_INFO' command to the device
394 * @core: device to send the command to
395 * @info: struct si476x_func_info to fill all the information
396 * returned by the command
397 *
398 * The command requests the firmware and patch version for currently
399 * loaded firmware (dependent on the function of the device FM/AM/WB)
400 *
401 * Function returns 0 on succsess and negative error code on
402 * failure
403 */
si476x_core_cmd_func_info(struct si476x_core * core,struct si476x_func_info * info)404 int si476x_core_cmd_func_info(struct si476x_core *core,
405 struct si476x_func_info *info)
406 {
407 int err;
408 u8 resp[CMD_FUNC_INFO_NRESP];
409
410 err = si476x_core_send_command(core, CMD_FUNC_INFO,
411 NULL, 0,
412 resp, ARRAY_SIZE(resp),
413 SI476X_DEFAULT_TIMEOUT);
414
415 info->firmware.major = resp[1];
416 info->firmware.minor[0] = resp[2];
417 info->firmware.minor[1] = resp[3];
418
419 info->patch_id = ((u16) resp[4] << 8) | resp[5];
420 info->func = resp[6];
421
422 return err;
423 }
424 EXPORT_SYMBOL_GPL(si476x_core_cmd_func_info);
425
426 /**
427 * si476x_cmd_set_property() - send 'SET_PROPERTY' command to the device
428 * @core: device to send the command to
429 * @property: property address
430 * @value: property value
431 *
432 * Function returns 0 on succsess and negative error code on
433 * failure
434 */
si476x_core_cmd_set_property(struct si476x_core * core,u16 property,u16 value)435 int si476x_core_cmd_set_property(struct si476x_core *core,
436 u16 property, u16 value)
437 {
438 u8 resp[CMD_SET_PROPERTY_NRESP];
439 const u8 args[CMD_SET_PROPERTY_NARGS] = {
440 0x00,
441 msb(property),
442 lsb(property),
443 msb(value),
444 lsb(value),
445 };
446
447 return si476x_core_send_command(core, CMD_SET_PROPERTY,
448 args, ARRAY_SIZE(args),
449 resp, ARRAY_SIZE(resp),
450 SI476X_DEFAULT_TIMEOUT);
451 }
452 EXPORT_SYMBOL_GPL(si476x_core_cmd_set_property);
453
454 /**
455 * si476x_cmd_get_property() - send 'GET_PROPERTY' command to the device
456 * @core: device to send the command to
457 * @property: property address
458 *
459 * Function return the value of property as u16 on success or a
460 * negative error on failure
461 */
si476x_core_cmd_get_property(struct si476x_core * core,u16 property)462 int si476x_core_cmd_get_property(struct si476x_core *core, u16 property)
463 {
464 int err;
465 u8 resp[CMD_GET_PROPERTY_NRESP];
466 const u8 args[CMD_GET_PROPERTY_NARGS] = {
467 0x00,
468 msb(property),
469 lsb(property),
470 };
471
472 err = si476x_core_send_command(core, CMD_GET_PROPERTY,
473 args, ARRAY_SIZE(args),
474 resp, ARRAY_SIZE(resp),
475 SI476X_DEFAULT_TIMEOUT);
476 if (err < 0)
477 return err;
478 else
479 return get_unaligned_be16(resp + 2);
480 }
481 EXPORT_SYMBOL_GPL(si476x_core_cmd_get_property);
482
483 /**
484 * si476x_cmd_dig_audio_pin_cfg() - send 'DIG_AUDIO_PIN_CFG' command to
485 * the device
486 * @core: device to send the command to
487 * @dclk: DCLK pin function configuration:
488 * #SI476X_DCLK_NOOP - do not modify the behaviour
489 * #SI476X_DCLK_TRISTATE - put the pin in tristate condition,
490 * enable 1MOhm pulldown
491 * #SI476X_DCLK_DAUDIO - set the pin to be a part of digital
492 * audio interface
493 * @dfs: DFS pin function configuration:
494 * #SI476X_DFS_NOOP - do not modify the behaviour
495 * #SI476X_DFS_TRISTATE - put the pin in tristate condition,
496 * enable 1MOhm pulldown
497 * SI476X_DFS_DAUDIO - set the pin to be a part of digital
498 * audio interface
499 * @dout - DOUT pin function configuration:
500 * SI476X_DOUT_NOOP - do not modify the behaviour
501 * SI476X_DOUT_TRISTATE - put the pin in tristate condition,
502 * enable 1MOhm pulldown
503 * SI476X_DOUT_I2S_OUTPUT - set this pin to be digital out on I2S
504 * port 1
505 * SI476X_DOUT_I2S_INPUT - set this pin to be digital in on I2S
506 * port 1
507 * @xout - XOUT pin function configuration:
508 * SI476X_XOUT_NOOP - do not modify the behaviour
509 * SI476X_XOUT_TRISTATE - put the pin in tristate condition,
510 * enable 1MOhm pulldown
511 * SI476X_XOUT_I2S_INPUT - set this pin to be digital in on I2S
512 * port 1
513 * SI476X_XOUT_MODE_SELECT - set this pin to be the input that
514 * selects the mode of the I2S audio
515 * combiner (analog or HD)
516 * [SI4761/63/65/67 Only]
517 *
518 * Function returns 0 on success and negative error code on failure
519 */
si476x_core_cmd_dig_audio_pin_cfg(struct si476x_core * core,enum si476x_dclk_config dclk,enum si476x_dfs_config dfs,enum si476x_dout_config dout,enum si476x_xout_config xout)520 int si476x_core_cmd_dig_audio_pin_cfg(struct si476x_core *core,
521 enum si476x_dclk_config dclk,
522 enum si476x_dfs_config dfs,
523 enum si476x_dout_config dout,
524 enum si476x_xout_config xout)
525 {
526 u8 resp[CMD_DIG_AUDIO_PIN_CFG_NRESP];
527 const u8 args[CMD_DIG_AUDIO_PIN_CFG_NARGS] = {
528 PIN_CFG_BYTE(dclk),
529 PIN_CFG_BYTE(dfs),
530 PIN_CFG_BYTE(dout),
531 PIN_CFG_BYTE(xout),
532 };
533
534 return si476x_core_send_command(core, CMD_DIG_AUDIO_PIN_CFG,
535 args, ARRAY_SIZE(args),
536 resp, ARRAY_SIZE(resp),
537 SI476X_DEFAULT_TIMEOUT);
538 }
539 EXPORT_SYMBOL_GPL(si476x_core_cmd_dig_audio_pin_cfg);
540
541 /**
542 * si476x_cmd_zif_pin_cfg - send 'ZIF_PIN_CFG_COMMAND'
543 * @core - device to send the command to
544 * @iqclk - IQCL pin function configuration:
545 * SI476X_IQCLK_NOOP - do not modify the behaviour
546 * SI476X_IQCLK_TRISTATE - put the pin in tristate condition,
547 * enable 1MOhm pulldown
548 * SI476X_IQCLK_IQ - set pin to be a part of I/Q interace
549 * in master mode
550 * @iqfs - IQFS pin function configuration:
551 * SI476X_IQFS_NOOP - do not modify the behaviour
552 * SI476X_IQFS_TRISTATE - put the pin in tristate condition,
553 * enable 1MOhm pulldown
554 * SI476X_IQFS_IQ - set pin to be a part of I/Q interace
555 * in master mode
556 * @iout - IOUT pin function configuration:
557 * SI476X_IOUT_NOOP - do not modify the behaviour
558 * SI476X_IOUT_TRISTATE - put the pin in tristate condition,
559 * enable 1MOhm pulldown
560 * SI476X_IOUT_OUTPUT - set pin to be I out
561 * @qout - QOUT pin function configuration:
562 * SI476X_QOUT_NOOP - do not modify the behaviour
563 * SI476X_QOUT_TRISTATE - put the pin in tristate condition,
564 * enable 1MOhm pulldown
565 * SI476X_QOUT_OUTPUT - set pin to be Q out
566 *
567 * Function returns 0 on success and negative error code on failure
568 */
si476x_core_cmd_zif_pin_cfg(struct si476x_core * core,enum si476x_iqclk_config iqclk,enum si476x_iqfs_config iqfs,enum si476x_iout_config iout,enum si476x_qout_config qout)569 int si476x_core_cmd_zif_pin_cfg(struct si476x_core *core,
570 enum si476x_iqclk_config iqclk,
571 enum si476x_iqfs_config iqfs,
572 enum si476x_iout_config iout,
573 enum si476x_qout_config qout)
574 {
575 u8 resp[CMD_ZIF_PIN_CFG_NRESP];
576 const u8 args[CMD_ZIF_PIN_CFG_NARGS] = {
577 PIN_CFG_BYTE(iqclk),
578 PIN_CFG_BYTE(iqfs),
579 PIN_CFG_BYTE(iout),
580 PIN_CFG_BYTE(qout),
581 };
582
583 return si476x_core_send_command(core, CMD_ZIF_PIN_CFG,
584 args, ARRAY_SIZE(args),
585 resp, ARRAY_SIZE(resp),
586 SI476X_DEFAULT_TIMEOUT);
587 }
588 EXPORT_SYMBOL_GPL(si476x_core_cmd_zif_pin_cfg);
589
590 /**
591 * si476x_cmd_ic_link_gpo_ctl_pin_cfg - send
592 * 'IC_LINK_GPIO_CTL_PIN_CFG' comand to the device
593 * @core - device to send the command to
594 * @icin - ICIN pin function configuration:
595 * SI476X_ICIN_NOOP - do not modify the behaviour
596 * SI476X_ICIN_TRISTATE - put the pin in tristate condition,
597 * enable 1MOhm pulldown
598 * SI476X_ICIN_GPO1_HIGH - set pin to be an output, drive it high
599 * SI476X_ICIN_GPO1_LOW - set pin to be an output, drive it low
600 * SI476X_ICIN_IC_LINK - set the pin to be a part of Inter-Chip link
601 * @icip - ICIP pin function configuration:
602 * SI476X_ICIP_NOOP - do not modify the behaviour
603 * SI476X_ICIP_TRISTATE - put the pin in tristate condition,
604 * enable 1MOhm pulldown
605 * SI476X_ICIP_GPO1_HIGH - set pin to be an output, drive it high
606 * SI476X_ICIP_GPO1_LOW - set pin to be an output, drive it low
607 * SI476X_ICIP_IC_LINK - set the pin to be a part of Inter-Chip link
608 * @icon - ICON pin function configuration:
609 * SI476X_ICON_NOOP - do not modify the behaviour
610 * SI476X_ICON_TRISTATE - put the pin in tristate condition,
611 * enable 1MOhm pulldown
612 * SI476X_ICON_I2S - set the pin to be a part of audio
613 * interface in slave mode (DCLK)
614 * SI476X_ICON_IC_LINK - set the pin to be a part of Inter-Chip link
615 * @icop - ICOP pin function configuration:
616 * SI476X_ICOP_NOOP - do not modify the behaviour
617 * SI476X_ICOP_TRISTATE - put the pin in tristate condition,
618 * enable 1MOhm pulldown
619 * SI476X_ICOP_I2S - set the pin to be a part of audio
620 * interface in slave mode (DOUT)
621 * [Si4761/63/65/67 Only]
622 * SI476X_ICOP_IC_LINK - set the pin to be a part of Inter-Chip link
623 *
624 * Function returns 0 on success and negative error code on failure
625 */
si476x_core_cmd_ic_link_gpo_ctl_pin_cfg(struct si476x_core * core,enum si476x_icin_config icin,enum si476x_icip_config icip,enum si476x_icon_config icon,enum si476x_icop_config icop)626 int si476x_core_cmd_ic_link_gpo_ctl_pin_cfg(struct si476x_core *core,
627 enum si476x_icin_config icin,
628 enum si476x_icip_config icip,
629 enum si476x_icon_config icon,
630 enum si476x_icop_config icop)
631 {
632 u8 resp[CMD_IC_LINK_GPO_CTL_PIN_CFG_NRESP];
633 const u8 args[CMD_IC_LINK_GPO_CTL_PIN_CFG_NARGS] = {
634 PIN_CFG_BYTE(icin),
635 PIN_CFG_BYTE(icip),
636 PIN_CFG_BYTE(icon),
637 PIN_CFG_BYTE(icop),
638 };
639
640 return si476x_core_send_command(core, CMD_IC_LINK_GPO_CTL_PIN_CFG,
641 args, ARRAY_SIZE(args),
642 resp, ARRAY_SIZE(resp),
643 SI476X_DEFAULT_TIMEOUT);
644 }
645 EXPORT_SYMBOL_GPL(si476x_core_cmd_ic_link_gpo_ctl_pin_cfg);
646
647 /**
648 * si476x_cmd_ana_audio_pin_cfg - send 'ANA_AUDIO_PIN_CFG' to the
649 * device
650 * @core - device to send the command to
651 * @lrout - LROUT pin function configuration:
652 * SI476X_LROUT_NOOP - do not modify the behaviour
653 * SI476X_LROUT_TRISTATE - put the pin in tristate condition,
654 * enable 1MOhm pulldown
655 * SI476X_LROUT_AUDIO - set pin to be audio output
656 * SI476X_LROUT_MPX - set pin to be MPX output
657 *
658 * Function returns 0 on success and negative error code on failure
659 */
si476x_core_cmd_ana_audio_pin_cfg(struct si476x_core * core,enum si476x_lrout_config lrout)660 int si476x_core_cmd_ana_audio_pin_cfg(struct si476x_core *core,
661 enum si476x_lrout_config lrout)
662 {
663 u8 resp[CMD_ANA_AUDIO_PIN_CFG_NRESP];
664 const u8 args[CMD_ANA_AUDIO_PIN_CFG_NARGS] = {
665 PIN_CFG_BYTE(lrout),
666 };
667
668 return si476x_core_send_command(core, CMD_ANA_AUDIO_PIN_CFG,
669 args, ARRAY_SIZE(args),
670 resp, ARRAY_SIZE(resp),
671 SI476X_DEFAULT_TIMEOUT);
672 }
673 EXPORT_SYMBOL_GPL(si476x_core_cmd_ana_audio_pin_cfg);
674
675
676 /**
677 * si476x_cmd_intb_pin_cfg - send 'INTB_PIN_CFG' command to the device
678 * @core - device to send the command to
679 * @intb - INTB pin function configuration:
680 * SI476X_INTB_NOOP - do not modify the behaviour
681 * SI476X_INTB_TRISTATE - put the pin in tristate condition,
682 * enable 1MOhm pulldown
683 * SI476X_INTB_DAUDIO - set pin to be a part of digital
684 * audio interface in slave mode
685 * SI476X_INTB_IRQ - set pin to be an interrupt request line
686 * @a1 - A1 pin function configuration:
687 * SI476X_A1_NOOP - do not modify the behaviour
688 * SI476X_A1_TRISTATE - put the pin in tristate condition,
689 * enable 1MOhm pulldown
690 * SI476X_A1_IRQ - set pin to be an interrupt request line
691 *
692 * Function returns 0 on success and negative error code on failure
693 */
si476x_core_cmd_intb_pin_cfg_a10(struct si476x_core * core,enum si476x_intb_config intb,enum si476x_a1_config a1)694 static int si476x_core_cmd_intb_pin_cfg_a10(struct si476x_core *core,
695 enum si476x_intb_config intb,
696 enum si476x_a1_config a1)
697 {
698 u8 resp[CMD_INTB_PIN_CFG_A10_NRESP];
699 const u8 args[CMD_INTB_PIN_CFG_NARGS] = {
700 PIN_CFG_BYTE(intb),
701 PIN_CFG_BYTE(a1),
702 };
703
704 return si476x_core_send_command(core, CMD_INTB_PIN_CFG,
705 args, ARRAY_SIZE(args),
706 resp, ARRAY_SIZE(resp),
707 SI476X_DEFAULT_TIMEOUT);
708 }
709
si476x_core_cmd_intb_pin_cfg_a20(struct si476x_core * core,enum si476x_intb_config intb,enum si476x_a1_config a1)710 static int si476x_core_cmd_intb_pin_cfg_a20(struct si476x_core *core,
711 enum si476x_intb_config intb,
712 enum si476x_a1_config a1)
713 {
714 u8 resp[CMD_INTB_PIN_CFG_A20_NRESP];
715 const u8 args[CMD_INTB_PIN_CFG_NARGS] = {
716 PIN_CFG_BYTE(intb),
717 PIN_CFG_BYTE(a1),
718 };
719
720 return si476x_core_send_command(core, CMD_INTB_PIN_CFG,
721 args, ARRAY_SIZE(args),
722 resp, ARRAY_SIZE(resp),
723 SI476X_DEFAULT_TIMEOUT);
724 }
725
726
727
728 /**
729 * si476x_cmd_am_rsq_status - send 'AM_RSQ_STATUS' command to the
730 * device
731 * @core - device to send the command to
732 * @rsqack - if set command clears RSQINT, SNRINT, SNRLINT, RSSIHINT,
733 * RSSSILINT, BLENDINT, MULTHINT and MULTLINT
734 * @attune - when set the values in the status report are the values
735 * that were calculated at tune
736 * @cancel - abort ongoing seek/tune opertation
737 * @stcack - clear the STCINT bin in status register
738 * @report - all signal quality information retured by the command
739 * (if NULL then the output of the command is ignored)
740 *
741 * Function returns 0 on success and negative error code on failure
742 */
si476x_core_cmd_am_rsq_status(struct si476x_core * core,struct si476x_rsq_status_args * rsqargs,struct si476x_rsq_status_report * report)743 int si476x_core_cmd_am_rsq_status(struct si476x_core *core,
744 struct si476x_rsq_status_args *rsqargs,
745 struct si476x_rsq_status_report *report)
746 {
747 int err;
748 u8 resp[CMD_AM_RSQ_STATUS_NRESP];
749 const u8 args[CMD_AM_RSQ_STATUS_NARGS] = {
750 rsqargs->rsqack << 3 | rsqargs->attune << 2 |
751 rsqargs->cancel << 1 | rsqargs->stcack,
752 };
753
754 err = si476x_core_send_command(core, CMD_AM_RSQ_STATUS,
755 args, ARRAY_SIZE(args),
756 resp, ARRAY_SIZE(resp),
757 SI476X_DEFAULT_TIMEOUT);
758 /*
759 * Besides getting received signal quality information this
760 * command can be used to just acknowledge different interrupt
761 * flags in those cases it is useless to copy and parse
762 * received data so user can pass NULL, and thus avoid
763 * unnecessary copying.
764 */
765 if (!report)
766 return err;
767
768 report->snrhint = 0x08 & resp[1];
769 report->snrlint = 0x04 & resp[1];
770 report->rssihint = 0x02 & resp[1];
771 report->rssilint = 0x01 & resp[1];
772
773 report->bltf = 0x80 & resp[2];
774 report->snr_ready = 0x20 & resp[2];
775 report->rssiready = 0x08 & resp[2];
776 report->afcrl = 0x02 & resp[2];
777 report->valid = 0x01 & resp[2];
778
779 report->readfreq = get_unaligned_be16(resp + 3);
780 report->freqoff = resp[5];
781 report->rssi = resp[6];
782 report->snr = resp[7];
783 report->lassi = resp[9];
784 report->hassi = resp[10];
785 report->mult = resp[11];
786 report->dev = resp[12];
787
788 return err;
789 }
790 EXPORT_SYMBOL_GPL(si476x_core_cmd_am_rsq_status);
791
si476x_core_cmd_fm_acf_status(struct si476x_core * core,struct si476x_acf_status_report * report)792 int si476x_core_cmd_fm_acf_status(struct si476x_core *core,
793 struct si476x_acf_status_report *report)
794 {
795 int err;
796 u8 resp[CMD_FM_ACF_STATUS_NRESP];
797 const u8 args[CMD_FM_ACF_STATUS_NARGS] = {
798 0x0,
799 };
800
801 if (!report)
802 return -EINVAL;
803
804 err = si476x_core_send_command(core, CMD_FM_ACF_STATUS,
805 args, ARRAY_SIZE(args),
806 resp, ARRAY_SIZE(resp),
807 SI476X_DEFAULT_TIMEOUT);
808 if (err < 0)
809 return err;
810
811 report->blend_int = resp[1] & SI476X_ACF_BLEND_INT;
812 report->hblend_int = resp[1] & SI476X_ACF_HIBLEND_INT;
813 report->hicut_int = resp[1] & SI476X_ACF_HICUT_INT;
814 report->chbw_int = resp[1] & SI476X_ACF_CHBW_INT;
815 report->softmute_int = resp[1] & SI476X_ACF_SOFTMUTE_INT;
816 report->smute = resp[2] & SI476X_ACF_SMUTE;
817 report->smattn = resp[3] & SI476X_ACF_SMATTN;
818 report->chbw = resp[4];
819 report->hicut = resp[5];
820 report->hiblend = resp[6];
821 report->pilot = resp[7] & SI476X_ACF_PILOT;
822 report->stblend = resp[7] & SI476X_ACF_STBLEND;
823
824 return err;
825 }
826 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_acf_status);
827
si476x_core_cmd_am_acf_status(struct si476x_core * core,struct si476x_acf_status_report * report)828 int si476x_core_cmd_am_acf_status(struct si476x_core *core,
829 struct si476x_acf_status_report *report)
830 {
831 int err;
832 u8 resp[CMD_AM_ACF_STATUS_NRESP];
833 const u8 args[CMD_AM_ACF_STATUS_NARGS] = {
834 0x0,
835 };
836
837 if (!report)
838 return -EINVAL;
839
840 err = si476x_core_send_command(core, CMD_AM_ACF_STATUS,
841 args, ARRAY_SIZE(args),
842 resp, ARRAY_SIZE(resp),
843 SI476X_DEFAULT_TIMEOUT);
844 if (err < 0)
845 return err;
846
847 report->blend_int = resp[1] & SI476X_ACF_BLEND_INT;
848 report->hblend_int = resp[1] & SI476X_ACF_HIBLEND_INT;
849 report->hicut_int = resp[1] & SI476X_ACF_HICUT_INT;
850 report->chbw_int = resp[1] & SI476X_ACF_CHBW_INT;
851 report->softmute_int = resp[1] & SI476X_ACF_SOFTMUTE_INT;
852 report->smute = resp[2] & SI476X_ACF_SMUTE;
853 report->smattn = resp[3] & SI476X_ACF_SMATTN;
854 report->chbw = resp[4];
855 report->hicut = resp[5];
856
857 return err;
858 }
859 EXPORT_SYMBOL_GPL(si476x_core_cmd_am_acf_status);
860
861
862 /**
863 * si476x_cmd_fm_seek_start - send 'FM_SEEK_START' command to the
864 * device
865 * @core - device to send the command to
866 * @seekup - if set the direction of the search is 'up'
867 * @wrap - if set seek wraps when hitting band limit
868 *
869 * This function begins search for a valid station. The station is
870 * considered valid when 'FM_VALID_SNR_THRESHOLD' and
871 * 'FM_VALID_RSSI_THRESHOLD' and 'FM_VALID_MAX_TUNE_ERROR' criteria
872 * are met.
873 } *
874 * Function returns 0 on success and negative error code on failure
875 */
si476x_core_cmd_fm_seek_start(struct si476x_core * core,bool seekup,bool wrap)876 int si476x_core_cmd_fm_seek_start(struct si476x_core *core,
877 bool seekup, bool wrap)
878 {
879 u8 resp[CMD_FM_SEEK_START_NRESP];
880 const u8 args[CMD_FM_SEEK_START_NARGS] = {
881 seekup << 3 | wrap << 2,
882 };
883
884 return si476x_cmd_tune_seek_freq(core, CMD_FM_SEEK_START,
885 args, sizeof(args),
886 resp, sizeof(resp));
887 }
888 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_seek_start);
889
890 /**
891 * si476x_cmd_fm_rds_status - send 'FM_RDS_STATUS' command to the
892 * device
893 * @core - device to send the command to
894 * @status_only - if set the data is not removed from RDSFIFO,
895 * RDSFIFOUSED is not decremented and data in all the
896 * rest RDS data contains the last valid info received
897 * @mtfifo if set the command clears RDS receive FIFO
898 * @intack if set the command clards the RDSINT bit.
899 *
900 * Function returns 0 on success and negative error code on failure
901 */
si476x_core_cmd_fm_rds_status(struct si476x_core * core,bool status_only,bool mtfifo,bool intack,struct si476x_rds_status_report * report)902 int si476x_core_cmd_fm_rds_status(struct si476x_core *core,
903 bool status_only,
904 bool mtfifo,
905 bool intack,
906 struct si476x_rds_status_report *report)
907 {
908 int err;
909 u8 resp[CMD_FM_RDS_STATUS_NRESP];
910 const u8 args[CMD_FM_RDS_STATUS_NARGS] = {
911 status_only << 2 | mtfifo << 1 | intack,
912 };
913
914 err = si476x_core_send_command(core, CMD_FM_RDS_STATUS,
915 args, ARRAY_SIZE(args),
916 resp, ARRAY_SIZE(resp),
917 SI476X_DEFAULT_TIMEOUT);
918 /*
919 * Besides getting RDS status information this command can be
920 * used to just acknowledge different interrupt flags in those
921 * cases it is useless to copy and parse received data so user
922 * can pass NULL, and thus avoid unnecessary copying.
923 */
924 if (err < 0 || report == NULL)
925 return err;
926
927 report->rdstpptyint = 0x10 & resp[1];
928 report->rdspiint = 0x08 & resp[1];
929 report->rdssyncint = 0x02 & resp[1];
930 report->rdsfifoint = 0x01 & resp[1];
931
932 report->tpptyvalid = 0x10 & resp[2];
933 report->pivalid = 0x08 & resp[2];
934 report->rdssync = 0x02 & resp[2];
935 report->rdsfifolost = 0x01 & resp[2];
936
937 report->tp = 0x20 & resp[3];
938 report->pty = 0x1f & resp[3];
939
940 report->pi = get_unaligned_be16(resp + 4);
941 report->rdsfifoused = resp[6];
942
943 report->ble[V4L2_RDS_BLOCK_A] = 0xc0 & resp[7];
944 report->ble[V4L2_RDS_BLOCK_B] = 0x30 & resp[7];
945 report->ble[V4L2_RDS_BLOCK_C] = 0x0c & resp[7];
946 report->ble[V4L2_RDS_BLOCK_D] = 0x03 & resp[7];
947
948 report->rds[V4L2_RDS_BLOCK_A].block = V4L2_RDS_BLOCK_A;
949 report->rds[V4L2_RDS_BLOCK_A].msb = resp[8];
950 report->rds[V4L2_RDS_BLOCK_A].lsb = resp[9];
951
952 report->rds[V4L2_RDS_BLOCK_B].block = V4L2_RDS_BLOCK_B;
953 report->rds[V4L2_RDS_BLOCK_B].msb = resp[10];
954 report->rds[V4L2_RDS_BLOCK_B].lsb = resp[11];
955
956 report->rds[V4L2_RDS_BLOCK_C].block = V4L2_RDS_BLOCK_C;
957 report->rds[V4L2_RDS_BLOCK_C].msb = resp[12];
958 report->rds[V4L2_RDS_BLOCK_C].lsb = resp[13];
959
960 report->rds[V4L2_RDS_BLOCK_D].block = V4L2_RDS_BLOCK_D;
961 report->rds[V4L2_RDS_BLOCK_D].msb = resp[14];
962 report->rds[V4L2_RDS_BLOCK_D].lsb = resp[15];
963
964 return err;
965 }
966 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_rds_status);
967
si476x_core_cmd_fm_rds_blockcount(struct si476x_core * core,bool clear,struct si476x_rds_blockcount_report * report)968 int si476x_core_cmd_fm_rds_blockcount(struct si476x_core *core,
969 bool clear,
970 struct si476x_rds_blockcount_report *report)
971 {
972 int err;
973 u8 resp[CMD_FM_RDS_BLOCKCOUNT_NRESP];
974 const u8 args[CMD_FM_RDS_BLOCKCOUNT_NARGS] = {
975 clear,
976 };
977
978 if (!report)
979 return -EINVAL;
980
981 err = si476x_core_send_command(core, CMD_FM_RDS_BLOCKCOUNT,
982 args, ARRAY_SIZE(args),
983 resp, ARRAY_SIZE(resp),
984 SI476X_DEFAULT_TIMEOUT);
985
986 if (!err) {
987 report->expected = get_unaligned_be16(resp + 2);
988 report->received = get_unaligned_be16(resp + 4);
989 report->uncorrectable = get_unaligned_be16(resp + 6);
990 }
991
992 return err;
993 }
994 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_rds_blockcount);
995
si476x_core_cmd_fm_phase_diversity(struct si476x_core * core,enum si476x_phase_diversity_mode mode)996 int si476x_core_cmd_fm_phase_diversity(struct si476x_core *core,
997 enum si476x_phase_diversity_mode mode)
998 {
999 u8 resp[CMD_FM_PHASE_DIVERSITY_NRESP];
1000 const u8 args[CMD_FM_PHASE_DIVERSITY_NARGS] = {
1001 mode & 0x07,
1002 };
1003
1004 return si476x_core_send_command(core, CMD_FM_PHASE_DIVERSITY,
1005 args, ARRAY_SIZE(args),
1006 resp, ARRAY_SIZE(resp),
1007 SI476X_DEFAULT_TIMEOUT);
1008 }
1009 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_phase_diversity);
1010 /**
1011 * si476x_core_cmd_fm_phase_div_status() - get the phase diversity
1012 * status
1013 *
1014 * @core: si476x device
1015 *
1016 * NOTE caller must hold core lock
1017 *
1018 * Function returns the value of the status bit in case of success and
1019 * negative error code in case of failre.
1020 */
si476x_core_cmd_fm_phase_div_status(struct si476x_core * core)1021 int si476x_core_cmd_fm_phase_div_status(struct si476x_core *core)
1022 {
1023 int err;
1024 u8 resp[CMD_FM_PHASE_DIV_STATUS_NRESP];
1025
1026 err = si476x_core_send_command(core, CMD_FM_PHASE_DIV_STATUS,
1027 NULL, 0,
1028 resp, ARRAY_SIZE(resp),
1029 SI476X_DEFAULT_TIMEOUT);
1030
1031 return (err < 0) ? err : resp[1];
1032 }
1033 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_phase_div_status);
1034
1035
1036 /**
1037 * si476x_cmd_am_seek_start - send 'FM_SEEK_START' command to the
1038 * device
1039 * @core - device to send the command to
1040 * @seekup - if set the direction of the search is 'up'
1041 * @wrap - if set seek wraps when hitting band limit
1042 *
1043 * This function begins search for a valid station. The station is
1044 * considered valid when 'FM_VALID_SNR_THRESHOLD' and
1045 * 'FM_VALID_RSSI_THRESHOLD' and 'FM_VALID_MAX_TUNE_ERROR' criteria
1046 * are met.
1047 *
1048 * Function returns 0 on success and negative error code on failure
1049 */
si476x_core_cmd_am_seek_start(struct si476x_core * core,bool seekup,bool wrap)1050 int si476x_core_cmd_am_seek_start(struct si476x_core *core,
1051 bool seekup, bool wrap)
1052 {
1053 u8 resp[CMD_AM_SEEK_START_NRESP];
1054 const u8 args[CMD_AM_SEEK_START_NARGS] = {
1055 seekup << 3 | wrap << 2,
1056 };
1057
1058 return si476x_cmd_tune_seek_freq(core, CMD_AM_SEEK_START,
1059 args, sizeof(args),
1060 resp, sizeof(resp));
1061 }
1062 EXPORT_SYMBOL_GPL(si476x_core_cmd_am_seek_start);
1063
1064
1065
si476x_core_cmd_power_up_a10(struct si476x_core * core,struct si476x_power_up_args * puargs)1066 static int si476x_core_cmd_power_up_a10(struct si476x_core *core,
1067 struct si476x_power_up_args *puargs)
1068 {
1069 u8 resp[CMD_POWER_UP_A10_NRESP];
1070 const bool intsel = (core->pinmux.a1 == SI476X_A1_IRQ);
1071 const bool ctsen = (core->client->irq != 0);
1072 const u8 args[CMD_POWER_UP_A10_NARGS] = {
1073 0xF7, /* Reserved, always 0xF7 */
1074 0x3F & puargs->xcload, /* First two bits are reserved to be
1075 * zeros */
1076 ctsen << 7 | intsel << 6 | 0x07, /* Last five bits
1077 * are reserved to
1078 * be written as 0x7 */
1079 puargs->func << 4 | puargs->freq,
1080 0x11, /* Reserved, always 0x11 */
1081 };
1082
1083 return si476x_core_send_command(core, CMD_POWER_UP,
1084 args, ARRAY_SIZE(args),
1085 resp, ARRAY_SIZE(resp),
1086 SI476X_TIMEOUT_POWER_UP);
1087 }
1088
si476x_core_cmd_power_up_a20(struct si476x_core * core,struct si476x_power_up_args * puargs)1089 static int si476x_core_cmd_power_up_a20(struct si476x_core *core,
1090 struct si476x_power_up_args *puargs)
1091 {
1092 u8 resp[CMD_POWER_UP_A20_NRESP];
1093 const bool intsel = (core->pinmux.a1 == SI476X_A1_IRQ);
1094 const bool ctsen = (core->client->irq != 0);
1095 const u8 args[CMD_POWER_UP_A20_NARGS] = {
1096 puargs->ibias6x << 7 | puargs->xstart,
1097 0x3F & puargs->xcload, /* First two bits are reserved to be
1098 * zeros */
1099 ctsen << 7 | intsel << 6 | puargs->fastboot << 5 |
1100 puargs->xbiashc << 3 | puargs->xbias,
1101 puargs->func << 4 | puargs->freq,
1102 0x10 | puargs->xmode,
1103 };
1104
1105 return si476x_core_send_command(core, CMD_POWER_UP,
1106 args, ARRAY_SIZE(args),
1107 resp, ARRAY_SIZE(resp),
1108 SI476X_TIMEOUT_POWER_UP);
1109 }
1110
si476x_core_cmd_power_down_a10(struct si476x_core * core,struct si476x_power_down_args * pdargs)1111 static int si476x_core_cmd_power_down_a10(struct si476x_core *core,
1112 struct si476x_power_down_args *pdargs)
1113 {
1114 u8 resp[CMD_POWER_DOWN_A10_NRESP];
1115
1116 return si476x_core_send_command(core, CMD_POWER_DOWN,
1117 NULL, 0,
1118 resp, ARRAY_SIZE(resp),
1119 SI476X_DEFAULT_TIMEOUT);
1120 }
1121
si476x_core_cmd_power_down_a20(struct si476x_core * core,struct si476x_power_down_args * pdargs)1122 static int si476x_core_cmd_power_down_a20(struct si476x_core *core,
1123 struct si476x_power_down_args *pdargs)
1124 {
1125 u8 resp[CMD_POWER_DOWN_A20_NRESP];
1126 const u8 args[CMD_POWER_DOWN_A20_NARGS] = {
1127 pdargs->xosc,
1128 };
1129 return si476x_core_send_command(core, CMD_POWER_DOWN,
1130 args, ARRAY_SIZE(args),
1131 resp, ARRAY_SIZE(resp),
1132 SI476X_DEFAULT_TIMEOUT);
1133 }
1134
si476x_core_cmd_am_tune_freq_a10(struct si476x_core * core,struct si476x_tune_freq_args * tuneargs)1135 static int si476x_core_cmd_am_tune_freq_a10(struct si476x_core *core,
1136 struct si476x_tune_freq_args *tuneargs)
1137 {
1138
1139 const int am_freq = tuneargs->freq;
1140 u8 resp[CMD_AM_TUNE_FREQ_NRESP];
1141 const u8 args[CMD_AM_TUNE_FREQ_NARGS] = {
1142 (tuneargs->hd << 6),
1143 msb(am_freq),
1144 lsb(am_freq),
1145 };
1146
1147 return si476x_cmd_tune_seek_freq(core, CMD_AM_TUNE_FREQ, args,
1148 sizeof(args),
1149 resp, sizeof(resp));
1150 }
1151
si476x_core_cmd_am_tune_freq_a20(struct si476x_core * core,struct si476x_tune_freq_args * tuneargs)1152 static int si476x_core_cmd_am_tune_freq_a20(struct si476x_core *core,
1153 struct si476x_tune_freq_args *tuneargs)
1154 {
1155 const int am_freq = tuneargs->freq;
1156 u8 resp[CMD_AM_TUNE_FREQ_NRESP];
1157 const u8 args[CMD_AM_TUNE_FREQ_NARGS] = {
1158 (tuneargs->zifsr << 6) | (tuneargs->injside & 0x03),
1159 msb(am_freq),
1160 lsb(am_freq),
1161 };
1162
1163 return si476x_cmd_tune_seek_freq(core, CMD_AM_TUNE_FREQ,
1164 args, sizeof(args),
1165 resp, sizeof(resp));
1166 }
1167
si476x_core_cmd_fm_rsq_status_a10(struct si476x_core * core,struct si476x_rsq_status_args * rsqargs,struct si476x_rsq_status_report * report)1168 static int si476x_core_cmd_fm_rsq_status_a10(struct si476x_core *core,
1169 struct si476x_rsq_status_args *rsqargs,
1170 struct si476x_rsq_status_report *report)
1171 {
1172 int err;
1173 u8 resp[CMD_FM_RSQ_STATUS_A10_NRESP];
1174 const u8 args[CMD_FM_RSQ_STATUS_A10_NARGS] = {
1175 rsqargs->rsqack << 3 | rsqargs->attune << 2 |
1176 rsqargs->cancel << 1 | rsqargs->stcack,
1177 };
1178
1179 err = si476x_core_send_command(core, CMD_FM_RSQ_STATUS,
1180 args, ARRAY_SIZE(args),
1181 resp, ARRAY_SIZE(resp),
1182 SI476X_DEFAULT_TIMEOUT);
1183 /*
1184 * Besides getting received signal quality information this
1185 * command can be used to just acknowledge different interrupt
1186 * flags in those cases it is useless to copy and parse
1187 * received data so user can pass NULL, and thus avoid
1188 * unnecessary copying.
1189 */
1190 if (err < 0 || report == NULL)
1191 return err;
1192
1193 report->multhint = 0x80 & resp[1];
1194 report->multlint = 0x40 & resp[1];
1195 report->snrhint = 0x08 & resp[1];
1196 report->snrlint = 0x04 & resp[1];
1197 report->rssihint = 0x02 & resp[1];
1198 report->rssilint = 0x01 & resp[1];
1199
1200 report->bltf = 0x80 & resp[2];
1201 report->snr_ready = 0x20 & resp[2];
1202 report->rssiready = 0x08 & resp[2];
1203 report->afcrl = 0x02 & resp[2];
1204 report->valid = 0x01 & resp[2];
1205
1206 report->readfreq = get_unaligned_be16(resp + 3);
1207 report->freqoff = resp[5];
1208 report->rssi = resp[6];
1209 report->snr = resp[7];
1210 report->lassi = resp[9];
1211 report->hassi = resp[10];
1212 report->mult = resp[11];
1213 report->dev = resp[12];
1214 report->readantcap = get_unaligned_be16(resp + 13);
1215 report->assi = resp[15];
1216 report->usn = resp[16];
1217
1218 return err;
1219 }
1220
si476x_core_cmd_fm_rsq_status_a20(struct si476x_core * core,struct si476x_rsq_status_args * rsqargs,struct si476x_rsq_status_report * report)1221 static int si476x_core_cmd_fm_rsq_status_a20(struct si476x_core *core,
1222 struct si476x_rsq_status_args *rsqargs,
1223 struct si476x_rsq_status_report *report)
1224 {
1225 int err;
1226 u8 resp[CMD_FM_RSQ_STATUS_A10_NRESP];
1227 const u8 args[CMD_FM_RSQ_STATUS_A30_NARGS] = {
1228 rsqargs->primary << 4 | rsqargs->rsqack << 3 |
1229 rsqargs->attune << 2 | rsqargs->cancel << 1 |
1230 rsqargs->stcack,
1231 };
1232
1233 err = si476x_core_send_command(core, CMD_FM_RSQ_STATUS,
1234 args, ARRAY_SIZE(args),
1235 resp, ARRAY_SIZE(resp),
1236 SI476X_DEFAULT_TIMEOUT);
1237 /*
1238 * Besides getting received signal quality information this
1239 * command can be used to just acknowledge different interrupt
1240 * flags in those cases it is useless to copy and parse
1241 * received data so user can pass NULL, and thus avoid
1242 * unnecessary copying.
1243 */
1244 if (err < 0 || report == NULL)
1245 return err;
1246
1247 report->multhint = 0x80 & resp[1];
1248 report->multlint = 0x40 & resp[1];
1249 report->snrhint = 0x08 & resp[1];
1250 report->snrlint = 0x04 & resp[1];
1251 report->rssihint = 0x02 & resp[1];
1252 report->rssilint = 0x01 & resp[1];
1253
1254 report->bltf = 0x80 & resp[2];
1255 report->snr_ready = 0x20 & resp[2];
1256 report->rssiready = 0x08 & resp[2];
1257 report->afcrl = 0x02 & resp[2];
1258 report->valid = 0x01 & resp[2];
1259
1260 report->readfreq = get_unaligned_be16(resp + 3);
1261 report->freqoff = resp[5];
1262 report->rssi = resp[6];
1263 report->snr = resp[7];
1264 report->lassi = resp[9];
1265 report->hassi = resp[10];
1266 report->mult = resp[11];
1267 report->dev = resp[12];
1268 report->readantcap = get_unaligned_be16(resp + 13);
1269 report->assi = resp[15];
1270 report->usn = resp[16];
1271
1272 return err;
1273 }
1274
1275
si476x_core_cmd_fm_rsq_status_a30(struct si476x_core * core,struct si476x_rsq_status_args * rsqargs,struct si476x_rsq_status_report * report)1276 static int si476x_core_cmd_fm_rsq_status_a30(struct si476x_core *core,
1277 struct si476x_rsq_status_args *rsqargs,
1278 struct si476x_rsq_status_report *report)
1279 {
1280 int err;
1281 u8 resp[CMD_FM_RSQ_STATUS_A30_NRESP];
1282 const u8 args[CMD_FM_RSQ_STATUS_A30_NARGS] = {
1283 rsqargs->primary << 4 | rsqargs->rsqack << 3 |
1284 rsqargs->attune << 2 | rsqargs->cancel << 1 |
1285 rsqargs->stcack,
1286 };
1287
1288 err = si476x_core_send_command(core, CMD_FM_RSQ_STATUS,
1289 args, ARRAY_SIZE(args),
1290 resp, ARRAY_SIZE(resp),
1291 SI476X_DEFAULT_TIMEOUT);
1292 /*
1293 * Besides getting received signal quality information this
1294 * command can be used to just acknowledge different interrupt
1295 * flags in those cases it is useless to copy and parse
1296 * received data so user can pass NULL, and thus avoid
1297 * unnecessary copying.
1298 */
1299 if (err < 0 || report == NULL)
1300 return err;
1301
1302 report->multhint = 0x80 & resp[1];
1303 report->multlint = 0x40 & resp[1];
1304 report->snrhint = 0x08 & resp[1];
1305 report->snrlint = 0x04 & resp[1];
1306 report->rssihint = 0x02 & resp[1];
1307 report->rssilint = 0x01 & resp[1];
1308
1309 report->bltf = 0x80 & resp[2];
1310 report->snr_ready = 0x20 & resp[2];
1311 report->rssiready = 0x08 & resp[2];
1312 report->injside = 0x04 & resp[2];
1313 report->afcrl = 0x02 & resp[2];
1314 report->valid = 0x01 & resp[2];
1315
1316 report->readfreq = get_unaligned_be16(resp + 3);
1317 report->freqoff = resp[5];
1318 report->rssi = resp[6];
1319 report->snr = resp[7];
1320 report->issi = resp[8];
1321 report->lassi = resp[9];
1322 report->hassi = resp[10];
1323 report->mult = resp[11];
1324 report->dev = resp[12];
1325 report->readantcap = get_unaligned_be16(resp + 13);
1326 report->assi = resp[15];
1327 report->usn = resp[16];
1328
1329 report->pilotdev = resp[17];
1330 report->rdsdev = resp[18];
1331 report->assidev = resp[19];
1332 report->strongdev = resp[20];
1333 report->rdspi = get_unaligned_be16(resp + 21);
1334
1335 return err;
1336 }
1337
si476x_core_cmd_fm_tune_freq_a10(struct si476x_core * core,struct si476x_tune_freq_args * tuneargs)1338 static int si476x_core_cmd_fm_tune_freq_a10(struct si476x_core *core,
1339 struct si476x_tune_freq_args *tuneargs)
1340 {
1341 u8 resp[CMD_FM_TUNE_FREQ_NRESP];
1342 const u8 args[CMD_FM_TUNE_FREQ_A10_NARGS] = {
1343 (tuneargs->hd << 6) | (tuneargs->tunemode << 4)
1344 | (tuneargs->smoothmetrics << 2),
1345 msb(tuneargs->freq),
1346 lsb(tuneargs->freq),
1347 msb(tuneargs->antcap),
1348 lsb(tuneargs->antcap)
1349 };
1350
1351 return si476x_cmd_tune_seek_freq(core, CMD_FM_TUNE_FREQ,
1352 args, sizeof(args),
1353 resp, sizeof(resp));
1354 }
1355
si476x_core_cmd_fm_tune_freq_a20(struct si476x_core * core,struct si476x_tune_freq_args * tuneargs)1356 static int si476x_core_cmd_fm_tune_freq_a20(struct si476x_core *core,
1357 struct si476x_tune_freq_args *tuneargs)
1358 {
1359 u8 resp[CMD_FM_TUNE_FREQ_NRESP];
1360 const u8 args[CMD_FM_TUNE_FREQ_A20_NARGS] = {
1361 (tuneargs->hd << 6) | (tuneargs->tunemode << 4)
1362 | (tuneargs->smoothmetrics << 2) | (tuneargs->injside),
1363 msb(tuneargs->freq),
1364 lsb(tuneargs->freq),
1365 };
1366
1367 return si476x_cmd_tune_seek_freq(core, CMD_FM_TUNE_FREQ,
1368 args, sizeof(args),
1369 resp, sizeof(resp));
1370 }
1371
si476x_core_cmd_agc_status_a20(struct si476x_core * core,struct si476x_agc_status_report * report)1372 static int si476x_core_cmd_agc_status_a20(struct si476x_core *core,
1373 struct si476x_agc_status_report *report)
1374 {
1375 int err;
1376 u8 resp[CMD_AGC_STATUS_NRESP_A20];
1377
1378 if (!report)
1379 return -EINVAL;
1380
1381 err = si476x_core_send_command(core, CMD_AGC_STATUS,
1382 NULL, 0,
1383 resp, ARRAY_SIZE(resp),
1384 SI476X_DEFAULT_TIMEOUT);
1385 if (err < 0)
1386 return err;
1387
1388 report->mxhi = resp[1] & SI476X_AGC_MXHI;
1389 report->mxlo = resp[1] & SI476X_AGC_MXLO;
1390 report->lnahi = resp[1] & SI476X_AGC_LNAHI;
1391 report->lnalo = resp[1] & SI476X_AGC_LNALO;
1392 report->fmagc1 = resp[2];
1393 report->fmagc2 = resp[3];
1394 report->pgagain = resp[4];
1395 report->fmwblang = resp[5];
1396
1397 return err;
1398 }
1399
si476x_core_cmd_agc_status_a10(struct si476x_core * core,struct si476x_agc_status_report * report)1400 static int si476x_core_cmd_agc_status_a10(struct si476x_core *core,
1401 struct si476x_agc_status_report *report)
1402 {
1403 int err;
1404 u8 resp[CMD_AGC_STATUS_NRESP_A10];
1405
1406 if (!report)
1407 return -EINVAL;
1408
1409 err = si476x_core_send_command(core, CMD_AGC_STATUS,
1410 NULL, 0,
1411 resp, ARRAY_SIZE(resp),
1412 SI476X_DEFAULT_TIMEOUT);
1413 if (err < 0)
1414 return err;
1415
1416 report->mxhi = resp[1] & SI476X_AGC_MXHI;
1417 report->mxlo = resp[1] & SI476X_AGC_MXLO;
1418 report->lnahi = resp[1] & SI476X_AGC_LNAHI;
1419 report->lnalo = resp[1] & SI476X_AGC_LNALO;
1420
1421 return err;
1422 }
1423
1424 typedef int (*tune_freq_func_t) (struct si476x_core *core,
1425 struct si476x_tune_freq_args *tuneargs);
1426
1427 static struct {
1428 int (*power_up)(struct si476x_core *,
1429 struct si476x_power_up_args *);
1430 int (*power_down)(struct si476x_core *,
1431 struct si476x_power_down_args *);
1432
1433 tune_freq_func_t fm_tune_freq;
1434 tune_freq_func_t am_tune_freq;
1435
1436 int (*fm_rsq_status)(struct si476x_core *,
1437 struct si476x_rsq_status_args *,
1438 struct si476x_rsq_status_report *);
1439
1440 int (*agc_status)(struct si476x_core *,
1441 struct si476x_agc_status_report *);
1442 int (*intb_pin_cfg)(struct si476x_core *core,
1443 enum si476x_intb_config intb,
1444 enum si476x_a1_config a1);
1445 } si476x_cmds_vtable[] = {
1446 [SI476X_REVISION_A10] = {
1447 .power_up = si476x_core_cmd_power_up_a10,
1448 .power_down = si476x_core_cmd_power_down_a10,
1449 .fm_tune_freq = si476x_core_cmd_fm_tune_freq_a10,
1450 .am_tune_freq = si476x_core_cmd_am_tune_freq_a10,
1451 .fm_rsq_status = si476x_core_cmd_fm_rsq_status_a10,
1452 .agc_status = si476x_core_cmd_agc_status_a10,
1453 .intb_pin_cfg = si476x_core_cmd_intb_pin_cfg_a10,
1454 },
1455 [SI476X_REVISION_A20] = {
1456 .power_up = si476x_core_cmd_power_up_a20,
1457 .power_down = si476x_core_cmd_power_down_a20,
1458 .fm_tune_freq = si476x_core_cmd_fm_tune_freq_a20,
1459 .am_tune_freq = si476x_core_cmd_am_tune_freq_a20,
1460 .fm_rsq_status = si476x_core_cmd_fm_rsq_status_a20,
1461 .agc_status = si476x_core_cmd_agc_status_a20,
1462 .intb_pin_cfg = si476x_core_cmd_intb_pin_cfg_a20,
1463 },
1464 [SI476X_REVISION_A30] = {
1465 .power_up = si476x_core_cmd_power_up_a20,
1466 .power_down = si476x_core_cmd_power_down_a20,
1467 .fm_tune_freq = si476x_core_cmd_fm_tune_freq_a20,
1468 .am_tune_freq = si476x_core_cmd_am_tune_freq_a20,
1469 .fm_rsq_status = si476x_core_cmd_fm_rsq_status_a30,
1470 .agc_status = si476x_core_cmd_agc_status_a20,
1471 .intb_pin_cfg = si476x_core_cmd_intb_pin_cfg_a20,
1472 },
1473 };
1474
si476x_core_cmd_power_up(struct si476x_core * core,struct si476x_power_up_args * args)1475 int si476x_core_cmd_power_up(struct si476x_core *core,
1476 struct si476x_power_up_args *args)
1477 {
1478 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1479 core->revision == -1);
1480 return si476x_cmds_vtable[core->revision].power_up(core, args);
1481 }
1482 EXPORT_SYMBOL_GPL(si476x_core_cmd_power_up);
1483
si476x_core_cmd_power_down(struct si476x_core * core,struct si476x_power_down_args * args)1484 int si476x_core_cmd_power_down(struct si476x_core *core,
1485 struct si476x_power_down_args *args)
1486 {
1487 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1488 core->revision == -1);
1489 return si476x_cmds_vtable[core->revision].power_down(core, args);
1490 }
1491 EXPORT_SYMBOL_GPL(si476x_core_cmd_power_down);
1492
si476x_core_cmd_fm_tune_freq(struct si476x_core * core,struct si476x_tune_freq_args * args)1493 int si476x_core_cmd_fm_tune_freq(struct si476x_core *core,
1494 struct si476x_tune_freq_args *args)
1495 {
1496 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1497 core->revision == -1);
1498 return si476x_cmds_vtable[core->revision].fm_tune_freq(core, args);
1499 }
1500 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_tune_freq);
1501
si476x_core_cmd_am_tune_freq(struct si476x_core * core,struct si476x_tune_freq_args * args)1502 int si476x_core_cmd_am_tune_freq(struct si476x_core *core,
1503 struct si476x_tune_freq_args *args)
1504 {
1505 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1506 core->revision == -1);
1507 return si476x_cmds_vtable[core->revision].am_tune_freq(core, args);
1508 }
1509 EXPORT_SYMBOL_GPL(si476x_core_cmd_am_tune_freq);
1510
si476x_core_cmd_fm_rsq_status(struct si476x_core * core,struct si476x_rsq_status_args * args,struct si476x_rsq_status_report * report)1511 int si476x_core_cmd_fm_rsq_status(struct si476x_core *core,
1512 struct si476x_rsq_status_args *args,
1513 struct si476x_rsq_status_report *report)
1514
1515 {
1516 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1517 core->revision == -1);
1518 return si476x_cmds_vtable[core->revision].fm_rsq_status(core, args,
1519 report);
1520 }
1521 EXPORT_SYMBOL_GPL(si476x_core_cmd_fm_rsq_status);
1522
si476x_core_cmd_agc_status(struct si476x_core * core,struct si476x_agc_status_report * report)1523 int si476x_core_cmd_agc_status(struct si476x_core *core,
1524 struct si476x_agc_status_report *report)
1525
1526 {
1527 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1528 core->revision == -1);
1529 return si476x_cmds_vtable[core->revision].agc_status(core, report);
1530 }
1531 EXPORT_SYMBOL_GPL(si476x_core_cmd_agc_status);
1532
si476x_core_cmd_intb_pin_cfg(struct si476x_core * core,enum si476x_intb_config intb,enum si476x_a1_config a1)1533 int si476x_core_cmd_intb_pin_cfg(struct si476x_core *core,
1534 enum si476x_intb_config intb,
1535 enum si476x_a1_config a1)
1536 {
1537 BUG_ON(core->revision > SI476X_REVISION_A30 ||
1538 core->revision == -1);
1539
1540 return si476x_cmds_vtable[core->revision].intb_pin_cfg(core, intb, a1);
1541 }
1542 EXPORT_SYMBOL_GPL(si476x_core_cmd_intb_pin_cfg);
1543
1544 MODULE_LICENSE("GPL");
1545 MODULE_AUTHOR("Andrey Smirnov <andrew.smirnov@gmail.com>");
1546 MODULE_DESCRIPTION("API for command exchange for si476x");
1547