1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Routines for control of the CS8427 via i2c bus
4 * IEC958 (S/PDIF) receiver & transmitter by Cirrus Logic
5 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>
8 #include <linux/slab.h>
9 #include <linux/delay.h>
10 #include <linux/init.h>
11 #include <linux/bitrev.h>
12 #include <linux/module.h>
13 #include <linux/unaligned.h>
14 #include <sound/core.h>
15 #include <sound/control.h>
16 #include <sound/pcm.h>
17 #include <sound/cs8427.h>
18 #include <sound/asoundef.h>
20 static void snd_cs8427_reset(struct snd_i2c_device
*cs8427
);
22 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
23 MODULE_DESCRIPTION("IEC958 (S/PDIF) receiver & transmitter by Cirrus Logic");
24 MODULE_LICENSE("GPL");
26 #define CS8427_ADDR (0x20>>1) /* fixed address */
28 struct cs8427_stream
{
29 struct snd_pcm_substream
*substream
;
30 char hw_status
[24]; /* hardware status */
31 char def_status
[24]; /* default status */
32 char pcm_status
[24]; /* PCM private status */
34 struct snd_kcontrol
*pcm_ctl
;
38 unsigned char regmap
[0x14]; /* map of first 1 + 13 registers */
40 unsigned int reset_timeout
;
41 struct cs8427_stream playback
;
42 struct cs8427_stream capture
;
45 int snd_cs8427_reg_write(struct snd_i2c_device
*device
, unsigned char reg
,
53 err
= snd_i2c_sendbytes(device
, buf
, 2);
55 dev_err(device
->bus
->card
->dev
,
56 "unable to send bytes 0x%02x:0x%02x to CS8427 (%i)\n",
58 return err
< 0 ? err
: -EIO
;
63 EXPORT_SYMBOL(snd_cs8427_reg_write
);
65 static int snd_cs8427_reg_read(struct snd_i2c_device
*device
, unsigned char reg
)
70 err
= snd_i2c_sendbytes(device
, ®
, 1);
72 dev_err(device
->bus
->card
->dev
,
73 "unable to send register 0x%x byte to CS8427\n", reg
);
74 return err
< 0 ? err
: -EIO
;
76 err
= snd_i2c_readbytes(device
, &buf
, 1);
78 dev_err(device
->bus
->card
->dev
,
79 "unable to read register 0x%x byte from CS8427\n", reg
);
80 return err
< 0 ? err
: -EIO
;
85 static int snd_cs8427_select_corudata(struct snd_i2c_device
*device
, int udata
)
87 struct cs8427
*chip
= device
->private_data
;
90 udata
= udata
? CS8427_BSEL
: 0;
91 if (udata
!= (chip
->regmap
[CS8427_REG_CSDATABUF
] & udata
)) {
92 chip
->regmap
[CS8427_REG_CSDATABUF
] &= ~CS8427_BSEL
;
93 chip
->regmap
[CS8427_REG_CSDATABUF
] |= udata
;
94 err
= snd_cs8427_reg_write(device
, CS8427_REG_CSDATABUF
,
95 chip
->regmap
[CS8427_REG_CSDATABUF
]);
102 static int snd_cs8427_send_corudata(struct snd_i2c_device
*device
,
104 unsigned char *ndata
,
107 struct cs8427
*chip
= device
->private_data
;
108 char *hw_data
= udata
?
109 chip
->playback
.hw_udata
: chip
->playback
.hw_status
;
110 unsigned char data
[32];
113 if (!memcmp(hw_data
, ndata
, count
))
115 err
= snd_cs8427_select_corudata(device
, udata
);
118 memcpy(hw_data
, ndata
, count
);
120 memset(data
, 0, sizeof(data
));
121 if (memcmp(hw_data
, data
, count
) == 0) {
122 chip
->regmap
[CS8427_REG_UDATABUF
] &= ~CS8427_UBMMASK
;
123 chip
->regmap
[CS8427_REG_UDATABUF
] |= CS8427_UBMZEROS
|
125 err
= snd_cs8427_reg_write(device
, CS8427_REG_UDATABUF
,
126 chip
->regmap
[CS8427_REG_UDATABUF
]);
127 return err
< 0 ? err
: 0;
130 data
[0] = CS8427_REG_AUTOINC
| CS8427_REG_CORU_DATABUF
;
131 for (idx
= 0; idx
< count
; idx
++)
132 data
[idx
+ 1] = bitrev8(ndata
[idx
]);
133 if (snd_i2c_sendbytes(device
, data
, count
+ 1) != count
+ 1)
138 static void snd_cs8427_free(struct snd_i2c_device
*device
)
140 kfree(device
->private_data
);
143 int snd_cs8427_init(struct snd_i2c_bus
*bus
,
144 struct snd_i2c_device
*device
)
146 static unsigned char initvals1
[] = {
147 CS8427_REG_CONTROL1
| CS8427_REG_AUTOINC
,
148 /* CS8427_REG_CONTROL1: RMCK to OMCK, valid PCM audio, disable mutes,
150 CS8427_SWCLK
| CS8427_TCBLDIR
,
151 /* CS8427_REG_CONTROL2: hold last valid audio sample, RMCK=256*Fs,
152 normal stereo operation */
154 /* CS8427_REG_DATAFLOW: output drivers normal operation, Tx<=serial,
156 CS8427_TXDSERIAL
| CS8427_SPDAES3RECEIVER
,
157 /* CS8427_REG_CLOCKSOURCE: Run off, CMCK=256*Fs,
158 output time base = OMCK, input time base = recovered input clock,
159 recovered input clock source is ILRCK changed to AES3INPUT
160 (workaround, see snd_cs8427_reset) */
162 /* CS8427_REG_SERIALINPUT: Serial audio input port data format = I2S,
164 CS8427_SIDEL
| CS8427_SILRPOL
,
165 /* CS8427_REG_SERIALOUTPUT: Serial audio output port data format
166 = I2S, 24-bit, 64*Fsi */
167 CS8427_SODEL
| CS8427_SOLRPOL
,
169 static unsigned char initvals2
[] = {
170 CS8427_REG_RECVERRMASK
| CS8427_REG_AUTOINC
,
171 /* CS8427_REG_RECVERRMASK: unmask the input PLL clock, V, confidence,
172 biphase, parity status bits */
173 /* CS8427_UNLOCK | CS8427_V | CS8427_CONF | CS8427_BIP | CS8427_PAR,*/
174 0xff, /* set everything */
175 /* CS8427_REG_CSDATABUF:
176 Registers 32-55 window to CS buffer
177 Inhibit D->E transfers from overwriting first 5 bytes of CS data.
178 Inhibit D->E transfers (all) of CS data.
179 Allow E->F transfer of CS data.
180 One byte mode; both A/B channels get same written CB data.
181 A channel info is output to chip's EMPH* pin. */
182 CS8427_CBMR
| CS8427_DETCI
,
183 /* CS8427_REG_UDATABUF:
184 Use internal buffer to transmit User (U) data.
185 Chip's U pin is an output.
186 Transmit all O's for user data.
187 Inhibit D->E transfers.
188 Inhibit E->F transfers. */
189 CS8427_UD
| CS8427_EFTUI
| CS8427_DETUI
,
191 struct cs8427
*chip
= device
->private_data
;
193 unsigned char buf
[24];
196 err
= snd_cs8427_reg_read(device
, CS8427_REG_ID_AND_VER
);
197 if (err
!= CS8427_VER8427A
) {
198 /* give second chance */
199 dev_warn(device
->bus
->card
->dev
,
200 "invalid CS8427 signature 0x%x: let me try again...\n",
202 err
= snd_cs8427_reg_read(device
, CS8427_REG_ID_AND_VER
);
204 if (err
!= CS8427_VER8427A
) {
206 dev_err(device
->bus
->card
->dev
,
207 "unable to find CS8427 signature (expected 0x%x, read 0x%x),\n",
208 CS8427_VER8427A
, err
);
209 dev_err(device
->bus
->card
->dev
,
210 " initialization is not completed\n");
213 /* turn off run bit while making changes to configuration */
214 err
= snd_cs8427_reg_write(device
, CS8427_REG_CLOCKSOURCE
, 0x00);
217 /* send initial values */
218 memcpy(chip
->regmap
+ (initvals1
[0] & 0x7f), initvals1
+ 1, 6);
219 err
= snd_i2c_sendbytes(device
, initvals1
, 7);
221 err
= err
< 0 ? err
: -EIO
;
224 /* Turn off CS8427 interrupt stuff that is not used in hardware */
226 /* from address 9 to 15 */
227 buf
[0] = 9; /* register */
228 err
= snd_i2c_sendbytes(device
, buf
, 7);
231 /* send transfer initialization sequence */
232 memcpy(chip
->regmap
+ (initvals2
[0] & 0x7f), initvals2
+ 1, 3);
233 err
= snd_i2c_sendbytes(device
, initvals2
, 4);
235 err
= err
< 0 ? err
: -EIO
;
238 /* write default channel status bytes */
239 put_unaligned_le32(SNDRV_PCM_DEFAULT_CON_SPDIF
, buf
);
240 memset(buf
+ 4, 0, 24 - 4);
241 if (snd_cs8427_send_corudata(device
, 0, buf
, 24) < 0)
243 memcpy(chip
->playback
.def_status
, buf
, 24);
244 memcpy(chip
->playback
.pcm_status
, buf
, 24);
247 /* turn on run bit and rock'n'roll */
248 snd_cs8427_reset(device
);
257 EXPORT_SYMBOL(snd_cs8427_init
);
259 int snd_cs8427_create(struct snd_i2c_bus
*bus
,
261 unsigned int reset_timeout
,
262 struct snd_i2c_device
**r_cs8427
)
266 struct snd_i2c_device
*device
;
268 err
= snd_i2c_device_create(bus
, "CS8427", CS8427_ADDR
| (addr
& 7),
272 chip
= device
->private_data
= kzalloc(sizeof(*chip
), GFP_KERNEL
);
274 snd_i2c_device_free(device
);
277 device
->private_free
= snd_cs8427_free
;
279 if (reset_timeout
< 1)
281 chip
->reset_timeout
= reset_timeout
;
283 err
= snd_cs8427_init(bus
, device
);
287 #if 0 // it's nice for read tests
292 snd_i2c_sendbytes(device
, buf
, 1);
293 snd_i2c_readbytes(device
, buf
, 127);
294 for (xx
= 0; xx
< 127; xx
++)
295 dev_dbg(device
->bus
->card
->dev
, "reg[0x%x] = 0x%x\n", xx
+1, buf
[xx
]);
304 snd_i2c_device_free(device
);
305 return err
< 0 ? err
: -EIO
;
308 EXPORT_SYMBOL(snd_cs8427_create
);
311 * Reset the chip using run bit, also lock PLL using ILRCK and
312 * put back AES3INPUT. This workaround is described in latest
313 * CS8427 datasheet, otherwise TXDSERIAL will not work.
315 static void snd_cs8427_reset(struct snd_i2c_device
*cs8427
)
318 unsigned long end_time
;
319 int data
, aes3input
= 0;
321 if (snd_BUG_ON(!cs8427
))
323 chip
= cs8427
->private_data
;
324 snd_i2c_lock(cs8427
->bus
);
325 if ((chip
->regmap
[CS8427_REG_CLOCKSOURCE
] & CS8427_RXDAES3INPUT
) ==
326 CS8427_RXDAES3INPUT
) /* AES3 bit is set */
328 chip
->regmap
[CS8427_REG_CLOCKSOURCE
] &= ~(CS8427_RUN
| CS8427_RXDMASK
);
329 snd_cs8427_reg_write(cs8427
, CS8427_REG_CLOCKSOURCE
,
330 chip
->regmap
[CS8427_REG_CLOCKSOURCE
]);
332 chip
->regmap
[CS8427_REG_CLOCKSOURCE
] |= CS8427_RUN
| CS8427_RXDILRCK
;
333 snd_cs8427_reg_write(cs8427
, CS8427_REG_CLOCKSOURCE
,
334 chip
->regmap
[CS8427_REG_CLOCKSOURCE
]);
336 snd_i2c_unlock(cs8427
->bus
);
337 end_time
= jiffies
+ chip
->reset_timeout
;
338 while (time_after_eq(end_time
, jiffies
)) {
339 snd_i2c_lock(cs8427
->bus
);
340 data
= snd_cs8427_reg_read(cs8427
, CS8427_REG_RECVERRORS
);
341 snd_i2c_unlock(cs8427
->bus
);
342 if (!(data
& CS8427_UNLOCK
))
344 schedule_timeout_uninterruptible(1);
346 snd_i2c_lock(cs8427
->bus
);
347 chip
->regmap
[CS8427_REG_CLOCKSOURCE
] &= ~CS8427_RXDMASK
;
349 chip
->regmap
[CS8427_REG_CLOCKSOURCE
] |= CS8427_RXDAES3INPUT
;
350 snd_cs8427_reg_write(cs8427
, CS8427_REG_CLOCKSOURCE
,
351 chip
->regmap
[CS8427_REG_CLOCKSOURCE
]);
352 snd_i2c_unlock(cs8427
->bus
);
355 static int snd_cs8427_in_status_info(struct snd_kcontrol
*kcontrol
,
356 struct snd_ctl_elem_info
*uinfo
)
358 uinfo
->type
= SNDRV_CTL_ELEM_TYPE_INTEGER
;
360 uinfo
->value
.integer
.min
= 0;
361 uinfo
->value
.integer
.max
= 255;
365 static int snd_cs8427_in_status_get(struct snd_kcontrol
*kcontrol
,
366 struct snd_ctl_elem_value
*ucontrol
)
368 struct snd_i2c_device
*device
= snd_kcontrol_chip(kcontrol
);
371 snd_i2c_lock(device
->bus
);
372 data
= snd_cs8427_reg_read(device
, kcontrol
->private_value
);
373 snd_i2c_unlock(device
->bus
);
376 ucontrol
->value
.integer
.value
[0] = data
;
380 static int snd_cs8427_qsubcode_info(struct snd_kcontrol
*kcontrol
,
381 struct snd_ctl_elem_info
*uinfo
)
383 uinfo
->type
= SNDRV_CTL_ELEM_TYPE_BYTES
;
388 static int snd_cs8427_qsubcode_get(struct snd_kcontrol
*kcontrol
,
389 struct snd_ctl_elem_value
*ucontrol
)
391 struct snd_i2c_device
*device
= snd_kcontrol_chip(kcontrol
);
392 unsigned char reg
= CS8427_REG_QSUBCODE
;
395 snd_i2c_lock(device
->bus
);
396 err
= snd_i2c_sendbytes(device
, ®
, 1);
398 dev_err(device
->bus
->card
->dev
,
399 "unable to send register 0x%x byte to CS8427\n", reg
);
400 snd_i2c_unlock(device
->bus
);
401 return err
< 0 ? err
: -EIO
;
403 err
= snd_i2c_readbytes(device
, ucontrol
->value
.bytes
.data
, 10);
405 dev_err(device
->bus
->card
->dev
,
406 "unable to read Q-subcode bytes from CS8427\n");
407 snd_i2c_unlock(device
->bus
);
408 return err
< 0 ? err
: -EIO
;
410 snd_i2c_unlock(device
->bus
);
414 static int snd_cs8427_spdif_info(struct snd_kcontrol
*kcontrol
,
415 struct snd_ctl_elem_info
*uinfo
)
417 uinfo
->type
= SNDRV_CTL_ELEM_TYPE_IEC958
;
422 static int snd_cs8427_spdif_get(struct snd_kcontrol
*kcontrol
,
423 struct snd_ctl_elem_value
*ucontrol
)
425 struct snd_i2c_device
*device
= snd_kcontrol_chip(kcontrol
);
426 struct cs8427
*chip
= device
->private_data
;
428 snd_i2c_lock(device
->bus
);
429 memcpy(ucontrol
->value
.iec958
.status
, chip
->playback
.def_status
, 24);
430 snd_i2c_unlock(device
->bus
);
434 static int snd_cs8427_spdif_put(struct snd_kcontrol
*kcontrol
,
435 struct snd_ctl_elem_value
*ucontrol
)
437 struct snd_i2c_device
*device
= snd_kcontrol_chip(kcontrol
);
438 struct cs8427
*chip
= device
->private_data
;
439 unsigned char *status
= kcontrol
->private_value
?
440 chip
->playback
.pcm_status
: chip
->playback
.def_status
;
441 struct snd_pcm_runtime
*runtime
= chip
->playback
.substream
?
442 chip
->playback
.substream
->runtime
: NULL
;
445 snd_i2c_lock(device
->bus
);
446 change
= memcmp(ucontrol
->value
.iec958
.status
, status
, 24) != 0;
447 memcpy(status
, ucontrol
->value
.iec958
.status
, 24);
448 if (change
&& (kcontrol
->private_value
?
449 runtime
!= NULL
: runtime
== NULL
)) {
450 err
= snd_cs8427_send_corudata(device
, 0, status
, 24);
454 snd_i2c_unlock(device
->bus
);
458 static int snd_cs8427_spdif_mask_info(struct snd_kcontrol
*kcontrol
,
459 struct snd_ctl_elem_info
*uinfo
)
461 uinfo
->type
= SNDRV_CTL_ELEM_TYPE_IEC958
;
466 static int snd_cs8427_spdif_mask_get(struct snd_kcontrol
*kcontrol
,
467 struct snd_ctl_elem_value
*ucontrol
)
469 memset(ucontrol
->value
.iec958
.status
, 0xff, 24);
473 static const struct snd_kcontrol_new snd_cs8427_iec958_controls
[] = {
475 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
476 .info
= snd_cs8427_in_status_info
,
477 .name
= "IEC958 CS8427 Input Status",
478 .access
= (SNDRV_CTL_ELEM_ACCESS_READ
|
479 SNDRV_CTL_ELEM_ACCESS_VOLATILE
),
480 .get
= snd_cs8427_in_status_get
,
484 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
485 .info
= snd_cs8427_in_status_info
,
486 .name
= "IEC958 CS8427 Error Status",
487 .access
= (SNDRV_CTL_ELEM_ACCESS_READ
|
488 SNDRV_CTL_ELEM_ACCESS_VOLATILE
),
489 .get
= snd_cs8427_in_status_get
,
493 .access
= SNDRV_CTL_ELEM_ACCESS_READ
,
494 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
495 .name
= SNDRV_CTL_NAME_IEC958("",PLAYBACK
,MASK
),
496 .info
= snd_cs8427_spdif_mask_info
,
497 .get
= snd_cs8427_spdif_mask_get
,
500 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
501 .name
= SNDRV_CTL_NAME_IEC958("",PLAYBACK
,DEFAULT
),
502 .info
= snd_cs8427_spdif_info
,
503 .get
= snd_cs8427_spdif_get
,
504 .put
= snd_cs8427_spdif_put
,
508 .access
= (SNDRV_CTL_ELEM_ACCESS_READWRITE
|
509 SNDRV_CTL_ELEM_ACCESS_INACTIVE
),
510 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
511 .name
= SNDRV_CTL_NAME_IEC958("",PLAYBACK
,PCM_STREAM
),
512 .info
= snd_cs8427_spdif_info
,
513 .get
= snd_cs8427_spdif_get
,
514 .put
= snd_cs8427_spdif_put
,
518 .iface
= SNDRV_CTL_ELEM_IFACE_PCM
,
519 .info
= snd_cs8427_qsubcode_info
,
520 .name
= "IEC958 Q-subcode Capture Default",
521 .access
= (SNDRV_CTL_ELEM_ACCESS_READ
|
522 SNDRV_CTL_ELEM_ACCESS_VOLATILE
),
523 .get
= snd_cs8427_qsubcode_get
526 int snd_cs8427_iec958_build(struct snd_i2c_device
*cs8427
,
527 struct snd_pcm_substream
*play_substream
,
528 struct snd_pcm_substream
*cap_substream
)
530 struct cs8427
*chip
= cs8427
->private_data
;
531 struct snd_kcontrol
*kctl
;
535 if (snd_BUG_ON(!play_substream
|| !cap_substream
))
537 for (idx
= 0; idx
< ARRAY_SIZE(snd_cs8427_iec958_controls
); idx
++) {
538 kctl
= snd_ctl_new1(&snd_cs8427_iec958_controls
[idx
], cs8427
);
541 kctl
->id
.device
= play_substream
->pcm
->device
;
542 kctl
->id
.subdevice
= play_substream
->number
;
543 err
= snd_ctl_add(cs8427
->bus
->card
, kctl
);
546 if (! strcmp(kctl
->id
.name
,
547 SNDRV_CTL_NAME_IEC958("",PLAYBACK
,PCM_STREAM
)))
548 chip
->playback
.pcm_ctl
= kctl
;
551 chip
->playback
.substream
= play_substream
;
552 chip
->capture
.substream
= cap_substream
;
553 if (snd_BUG_ON(!chip
->playback
.pcm_ctl
))
558 EXPORT_SYMBOL(snd_cs8427_iec958_build
);
560 int snd_cs8427_iec958_active(struct snd_i2c_device
*cs8427
, int active
)
564 if (snd_BUG_ON(!cs8427
))
566 chip
= cs8427
->private_data
;
568 memcpy(chip
->playback
.pcm_status
,
569 chip
->playback
.def_status
, 24);
570 chip
->playback
.pcm_ctl
->vd
[0].access
&= ~SNDRV_CTL_ELEM_ACCESS_INACTIVE
;
572 chip
->playback
.pcm_ctl
->vd
[0].access
|= SNDRV_CTL_ELEM_ACCESS_INACTIVE
;
574 snd_ctl_notify(cs8427
->bus
->card
,
575 SNDRV_CTL_EVENT_MASK_VALUE
| SNDRV_CTL_EVENT_MASK_INFO
,
576 &chip
->playback
.pcm_ctl
->id
);
580 EXPORT_SYMBOL(snd_cs8427_iec958_active
);
582 int snd_cs8427_iec958_pcm(struct snd_i2c_device
*cs8427
, unsigned int rate
)
588 if (snd_BUG_ON(!cs8427
))
590 chip
= cs8427
->private_data
;
591 status
= chip
->playback
.pcm_status
;
592 snd_i2c_lock(cs8427
->bus
);
593 if (status
[0] & IEC958_AES0_PROFESSIONAL
) {
594 status
[0] &= ~IEC958_AES0_PRO_FS
;
596 case 32000: status
[0] |= IEC958_AES0_PRO_FS_32000
; break;
597 case 44100: status
[0] |= IEC958_AES0_PRO_FS_44100
; break;
598 case 48000: status
[0] |= IEC958_AES0_PRO_FS_48000
; break;
599 default: status
[0] |= IEC958_AES0_PRO_FS_NOTID
; break;
602 status
[3] &= ~IEC958_AES3_CON_FS
;
604 case 32000: status
[3] |= IEC958_AES3_CON_FS_32000
; break;
605 case 44100: status
[3] |= IEC958_AES3_CON_FS_44100
; break;
606 case 48000: status
[3] |= IEC958_AES3_CON_FS_48000
; break;
609 err
= snd_cs8427_send_corudata(cs8427
, 0, status
, 24);
611 snd_ctl_notify(cs8427
->bus
->card
,
612 SNDRV_CTL_EVENT_MASK_VALUE
,
613 &chip
->playback
.pcm_ctl
->id
);
614 reset
= chip
->rate
!= rate
;
616 snd_i2c_unlock(cs8427
->bus
);
618 snd_cs8427_reset(cs8427
);
619 return err
< 0 ? err
: 0;
622 EXPORT_SYMBOL(snd_cs8427_iec958_pcm
);