Merge tag 'powerpc-5.11-3' of git://git.kernel.org/pub/scm/linux/kernel/git/powerpc...
[linux/fpc-iii.git] / sound / pci / mixart / mixart_hwdep.c
blob13dcb2fd0a855228a373534b390eedd3857dc42f
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * Driver for Digigram miXart soundcards
5 * DSP firmware management
7 * Copyright (c) 2003 by Digigram <alsa@digigram.com>
8 */
10 #include <linux/interrupt.h>
11 #include <linux/pci.h>
12 #include <linux/firmware.h>
13 #include <linux/vmalloc.h>
14 #include <linux/slab.h>
15 #include <linux/module.h>
16 #include <linux/io.h>
17 #include <sound/core.h>
18 #include "mixart.h"
19 #include "mixart_mixer.h"
20 #include "mixart_core.h"
21 #include "mixart_hwdep.h"
24 /**
25 * wait for a value on a peudo register, exit with a timeout
27 * @mgr: pointer to miXart manager structure
28 * @offset: unsigned pseudo_register base + offset of value
29 * @is_egal: wait for the equal value
30 * @value: value
31 * @timeout: timeout in centisenconds
33 static int mixart_wait_nice_for_register_value(struct mixart_mgr *mgr,
34 u32 offset, int is_egal,
35 u32 value, unsigned long timeout)
37 unsigned long end_time = jiffies + (timeout * HZ / 100);
38 u32 read;
40 do { /* we may take too long time in this loop.
41 * so give controls back to kernel if needed.
43 cond_resched();
45 read = readl_be( MIXART_MEM( mgr, offset ));
46 if(is_egal) {
47 if(read == value) return 0;
49 else { /* wait for different value */
50 if(read != value) return 0;
52 } while ( time_after_eq(end_time, jiffies) );
54 return -EBUSY;
59 structures needed to upload elf code packets
61 struct snd_mixart_elf32_ehdr {
62 u8 e_ident[16];
63 __be16 e_type;
64 __be16 e_machine;
65 __be32 e_version;
66 __be32 e_entry;
67 __be32 e_phoff;
68 __be32 e_shoff;
69 __be32 e_flags;
70 __be16 e_ehsize;
71 __be16 e_phentsize;
72 __be16 e_phnum;
73 __be16 e_shentsize;
74 __be16 e_shnum;
75 __be16 e_shstrndx;
78 struct snd_mixart_elf32_phdr {
79 __be32 p_type;
80 __be32 p_offset;
81 __be32 p_vaddr;
82 __be32 p_paddr;
83 __be32 p_filesz;
84 __be32 p_memsz;
85 __be32 p_flags;
86 __be32 p_align;
89 static int mixart_load_elf(struct mixart_mgr *mgr, const struct firmware *dsp )
91 char elf32_magic_number[4] = {0x7f,'E','L','F'};
92 struct snd_mixart_elf32_ehdr *elf_header;
93 int i;
95 elf_header = (struct snd_mixart_elf32_ehdr *)dsp->data;
96 for( i=0; i<4; i++ )
97 if ( elf32_magic_number[i] != elf_header->e_ident[i] )
98 return -EINVAL;
100 if( elf_header->e_phoff != 0 ) {
101 struct snd_mixart_elf32_phdr elf_programheader;
103 for( i=0; i < be16_to_cpu(elf_header->e_phnum); i++ ) {
104 u32 pos = be32_to_cpu(elf_header->e_phoff) + (u32)(i * be16_to_cpu(elf_header->e_phentsize));
106 memcpy( &elf_programheader, dsp->data + pos, sizeof(elf_programheader) );
108 if(elf_programheader.p_type != 0) {
109 if( elf_programheader.p_filesz != 0 ) {
110 memcpy_toio( MIXART_MEM( mgr, be32_to_cpu(elf_programheader.p_vaddr)),
111 dsp->data + be32_to_cpu( elf_programheader.p_offset ),
112 be32_to_cpu( elf_programheader.p_filesz ));
117 return 0;
121 * get basic information and init miXart
124 /* audio IDs for request to the board */
125 #define MIXART_FIRST_ANA_AUDIO_ID 0
126 #define MIXART_FIRST_DIG_AUDIO_ID 8
128 static int mixart_enum_connectors(struct mixart_mgr *mgr)
130 u32 k;
131 int err;
132 struct mixart_msg request;
133 struct mixart_enum_connector_resp *connector;
134 struct mixart_audio_info_req *audio_info_req;
135 struct mixart_audio_info_resp *audio_info;
137 connector = kmalloc(sizeof(*connector), GFP_KERNEL);
138 audio_info_req = kmalloc(sizeof(*audio_info_req), GFP_KERNEL);
139 audio_info = kmalloc(sizeof(*audio_info), GFP_KERNEL);
140 if (! connector || ! audio_info_req || ! audio_info) {
141 err = -ENOMEM;
142 goto __error;
145 audio_info_req->line_max_level = MIXART_FLOAT_P_22_0_TO_HEX;
146 audio_info_req->micro_max_level = MIXART_FLOAT_M_20_0_TO_HEX;
147 audio_info_req->cd_max_level = MIXART_FLOAT____0_0_TO_HEX;
149 request.message_id = MSG_SYSTEM_ENUM_PLAY_CONNECTOR;
150 request.uid = (struct mixart_uid){0,0}; /* board num = 0 */
151 request.data = NULL;
152 request.size = 0;
154 err = snd_mixart_send_msg(mgr, &request, sizeof(*connector), connector);
155 if((err < 0) || (connector->error_code) || (connector->uid_count > MIXART_MAX_PHYS_CONNECTORS)) {
156 dev_err(&mgr->pci->dev,
157 "error MSG_SYSTEM_ENUM_PLAY_CONNECTOR\n");
158 err = -EINVAL;
159 goto __error;
162 for(k=0; k < connector->uid_count; k++) {
163 struct mixart_pipe *pipe;
165 if(k < MIXART_FIRST_DIG_AUDIO_ID) {
166 pipe = &mgr->chip[k/2]->pipe_out_ana;
167 } else {
168 pipe = &mgr->chip[(k-MIXART_FIRST_DIG_AUDIO_ID)/2]->pipe_out_dig;
170 if(k & 1) {
171 pipe->uid_right_connector = connector->uid[k]; /* odd */
172 } else {
173 pipe->uid_left_connector = connector->uid[k]; /* even */
176 /* dev_dbg(&mgr->pci->dev, "playback connector[%d].object_id = %x\n", k, connector->uid[k].object_id); */
178 /* TODO: really need send_msg MSG_CONNECTOR_GET_AUDIO_INFO for each connector ? perhaps for analog level caps ? */
179 request.message_id = MSG_CONNECTOR_GET_AUDIO_INFO;
180 request.uid = connector->uid[k];
181 request.data = audio_info_req;
182 request.size = sizeof(*audio_info_req);
184 err = snd_mixart_send_msg(mgr, &request, sizeof(*audio_info), audio_info);
185 if( err < 0 ) {
186 dev_err(&mgr->pci->dev,
187 "error MSG_CONNECTOR_GET_AUDIO_INFO\n");
188 goto __error;
190 /*dev_dbg(&mgr->pci->dev, "play analog_info.analog_level_present = %x\n", audio_info->info.analog_info.analog_level_present);*/
193 request.message_id = MSG_SYSTEM_ENUM_RECORD_CONNECTOR;
194 request.uid = (struct mixart_uid){0,0}; /* board num = 0 */
195 request.data = NULL;
196 request.size = 0;
198 err = snd_mixart_send_msg(mgr, &request, sizeof(*connector), connector);
199 if((err < 0) || (connector->error_code) || (connector->uid_count > MIXART_MAX_PHYS_CONNECTORS)) {
200 dev_err(&mgr->pci->dev,
201 "error MSG_SYSTEM_ENUM_RECORD_CONNECTOR\n");
202 err = -EINVAL;
203 goto __error;
206 for(k=0; k < connector->uid_count; k++) {
207 struct mixart_pipe *pipe;
209 if(k < MIXART_FIRST_DIG_AUDIO_ID) {
210 pipe = &mgr->chip[k/2]->pipe_in_ana;
211 } else {
212 pipe = &mgr->chip[(k-MIXART_FIRST_DIG_AUDIO_ID)/2]->pipe_in_dig;
214 if(k & 1) {
215 pipe->uid_right_connector = connector->uid[k]; /* odd */
216 } else {
217 pipe->uid_left_connector = connector->uid[k]; /* even */
220 /* dev_dbg(&mgr->pci->dev, "capture connector[%d].object_id = %x\n", k, connector->uid[k].object_id); */
222 /* TODO: really need send_msg MSG_CONNECTOR_GET_AUDIO_INFO for each connector ? perhaps for analog level caps ? */
223 request.message_id = MSG_CONNECTOR_GET_AUDIO_INFO;
224 request.uid = connector->uid[k];
225 request.data = audio_info_req;
226 request.size = sizeof(*audio_info_req);
228 err = snd_mixart_send_msg(mgr, &request, sizeof(*audio_info), audio_info);
229 if( err < 0 ) {
230 dev_err(&mgr->pci->dev,
231 "error MSG_CONNECTOR_GET_AUDIO_INFO\n");
232 goto __error;
234 /*dev_dbg(&mgr->pci->dev, "rec analog_info.analog_level_present = %x\n", audio_info->info.analog_info.analog_level_present);*/
236 err = 0;
238 __error:
239 kfree(connector);
240 kfree(audio_info_req);
241 kfree(audio_info);
243 return err;
246 static int mixart_enum_physio(struct mixart_mgr *mgr)
248 u32 k;
249 int err;
250 struct mixart_msg request;
251 struct mixart_uid get_console_mgr;
252 struct mixart_return_uid console_mgr;
253 struct mixart_uid_enumeration phys_io;
255 /* get the uid for the console manager */
256 get_console_mgr.object_id = 0;
257 get_console_mgr.desc = MSG_CONSOLE_MANAGER | 0; /* cardindex = 0 */
259 request.message_id = MSG_CONSOLE_GET_CLOCK_UID;
260 request.uid = get_console_mgr;
261 request.data = &get_console_mgr;
262 request.size = sizeof(get_console_mgr);
264 err = snd_mixart_send_msg(mgr, &request, sizeof(console_mgr), &console_mgr);
266 if( (err < 0) || (console_mgr.error_code != 0) ) {
267 dev_dbg(&mgr->pci->dev,
268 "error MSG_CONSOLE_GET_CLOCK_UID : err=%x\n",
269 console_mgr.error_code);
270 return -EINVAL;
273 /* used later for clock issues ! */
274 mgr->uid_console_manager = console_mgr.uid;
276 request.message_id = MSG_SYSTEM_ENUM_PHYSICAL_IO;
277 request.uid = (struct mixart_uid){0,0};
278 request.data = &console_mgr.uid;
279 request.size = sizeof(console_mgr.uid);
281 err = snd_mixart_send_msg(mgr, &request, sizeof(phys_io), &phys_io);
282 if( (err < 0) || ( phys_io.error_code != 0 ) ) {
283 dev_err(&mgr->pci->dev,
284 "error MSG_SYSTEM_ENUM_PHYSICAL_IO err(%x) error_code(%x)\n",
285 err, phys_io.error_code);
286 return -EINVAL;
289 /* min 2 phys io per card (analog in + analog out) */
290 if (phys_io.nb_uid < MIXART_MAX_CARDS * 2)
291 return -EINVAL;
293 for(k=0; k<mgr->num_cards; k++) {
294 mgr->chip[k]->uid_in_analog_physio = phys_io.uid[k];
295 mgr->chip[k]->uid_out_analog_physio = phys_io.uid[phys_io.nb_uid/2 + k];
298 return 0;
302 static int mixart_first_init(struct mixart_mgr *mgr)
304 u32 k;
305 int err;
306 struct mixart_msg request;
308 if((err = mixart_enum_connectors(mgr)) < 0) return err;
310 if((err = mixart_enum_physio(mgr)) < 0) return err;
312 /* send a synchro command to card (necessary to do this before first MSG_STREAM_START_STREAM_GRP_PACKET) */
313 /* though why not here */
314 request.message_id = MSG_SYSTEM_SEND_SYNCHRO_CMD;
315 request.uid = (struct mixart_uid){0,0};
316 request.data = NULL;
317 request.size = 0;
318 /* this command has no data. response is a 32 bit status */
319 err = snd_mixart_send_msg(mgr, &request, sizeof(k), &k);
320 if( (err < 0) || (k != 0) ) {
321 dev_err(&mgr->pci->dev, "error MSG_SYSTEM_SEND_SYNCHRO_CMD\n");
322 return err == 0 ? -EINVAL : err;
325 return 0;
329 /* firmware base addresses (when hard coded) */
330 #define MIXART_MOTHERBOARD_XLX_BASE_ADDRESS 0x00600000
332 static int mixart_dsp_load(struct mixart_mgr* mgr, int index, const struct firmware *dsp)
334 int err, card_index;
335 u32 status_xilinx, status_elf, status_daught;
336 u32 val;
338 /* read motherboard xilinx status */
339 status_xilinx = readl_be( MIXART_MEM( mgr,MIXART_PSEUDOREG_MXLX_STATUS_OFFSET ));
340 /* read elf status */
341 status_elf = readl_be( MIXART_MEM( mgr,MIXART_PSEUDOREG_ELF_STATUS_OFFSET ));
342 /* read daughterboard xilinx status */
343 status_daught = readl_be( MIXART_MEM( mgr,MIXART_PSEUDOREG_DXLX_STATUS_OFFSET ));
345 /* motherboard xilinx status 5 will say that the board is performing a reset */
346 if (status_xilinx == 5) {
347 dev_err(&mgr->pci->dev, "miXart is resetting !\n");
348 return -EAGAIN; /* try again later */
351 switch (index) {
352 case MIXART_MOTHERBOARD_XLX_INDEX:
354 /* xilinx already loaded ? */
355 if (status_xilinx == 4) {
356 dev_dbg(&mgr->pci->dev, "xilinx is already loaded !\n");
357 return 0;
359 /* the status should be 0 == "idle" */
360 if (status_xilinx != 0) {
361 dev_err(&mgr->pci->dev,
362 "xilinx load error ! status = %d\n",
363 status_xilinx);
364 return -EIO; /* modprob -r may help ? */
367 /* check xilinx validity */
368 if (((u32*)(dsp->data))[0] == 0xffffffff)
369 return -EINVAL;
370 if (dsp->size % 4)
371 return -EINVAL;
373 /* set xilinx status to copying */
374 writel_be( 1, MIXART_MEM( mgr, MIXART_PSEUDOREG_MXLX_STATUS_OFFSET ));
376 /* setup xilinx base address */
377 writel_be( MIXART_MOTHERBOARD_XLX_BASE_ADDRESS, MIXART_MEM( mgr,MIXART_PSEUDOREG_MXLX_BASE_ADDR_OFFSET ));
378 /* setup code size for xilinx file */
379 writel_be( dsp->size, MIXART_MEM( mgr, MIXART_PSEUDOREG_MXLX_SIZE_OFFSET ));
381 /* copy xilinx code */
382 memcpy_toio( MIXART_MEM( mgr, MIXART_MOTHERBOARD_XLX_BASE_ADDRESS), dsp->data, dsp->size);
384 /* set xilinx status to copy finished */
385 writel_be( 2, MIXART_MEM( mgr, MIXART_PSEUDOREG_MXLX_STATUS_OFFSET ));
387 /* return, because no further processing needed */
388 return 0;
390 case MIXART_MOTHERBOARD_ELF_INDEX:
392 if (status_elf == 4) {
393 dev_dbg(&mgr->pci->dev, "elf file already loaded !\n");
394 return 0;
397 /* the status should be 0 == "idle" */
398 if (status_elf != 0) {
399 dev_err(&mgr->pci->dev,
400 "elf load error ! status = %d\n",
401 status_elf);
402 return -EIO; /* modprob -r may help ? */
405 /* wait for xilinx status == 4 */
406 err = mixart_wait_nice_for_register_value( mgr, MIXART_PSEUDOREG_MXLX_STATUS_OFFSET, 1, 4, 500); /* 5sec */
407 if (err < 0) {
408 dev_err(&mgr->pci->dev, "xilinx was not loaded or "
409 "could not be started\n");
410 return err;
413 /* init some data on the card */
414 writel_be( 0, MIXART_MEM( mgr, MIXART_PSEUDOREG_BOARDNUMBER ) ); /* set miXart boardnumber to 0 */
415 writel_be( 0, MIXART_MEM( mgr, MIXART_FLOWTABLE_PTR ) ); /* reset pointer to flow table on miXart */
417 /* set elf status to copying */
418 writel_be( 1, MIXART_MEM( mgr, MIXART_PSEUDOREG_ELF_STATUS_OFFSET ));
420 /* process the copying of the elf packets */
421 err = mixart_load_elf( mgr, dsp );
422 if (err < 0) return err;
424 /* set elf status to copy finished */
425 writel_be( 2, MIXART_MEM( mgr, MIXART_PSEUDOREG_ELF_STATUS_OFFSET ));
427 /* wait for elf status == 4 */
428 err = mixart_wait_nice_for_register_value( mgr, MIXART_PSEUDOREG_ELF_STATUS_OFFSET, 1, 4, 300); /* 3sec */
429 if (err < 0) {
430 dev_err(&mgr->pci->dev, "elf could not be started\n");
431 return err;
434 /* miXart waits at this point on the pointer to the flow table */
435 writel_be( (u32)mgr->flowinfo.addr, MIXART_MEM( mgr, MIXART_FLOWTABLE_PTR ) ); /* give pointer of flow table to miXart */
437 return 0; /* return, another xilinx file has to be loaded before */
439 case MIXART_AESEBUBOARD_XLX_INDEX:
440 default:
442 /* elf and xilinx should be loaded */
443 if (status_elf != 4 || status_xilinx != 4) {
444 dev_err(&mgr->pci->dev, "xilinx or elf not "
445 "successfully loaded\n");
446 return -EIO; /* modprob -r may help ? */
449 /* wait for daughter detection != 0 */
450 err = mixart_wait_nice_for_register_value( mgr, MIXART_PSEUDOREG_DBRD_PRESENCE_OFFSET, 0, 0, 30); /* 300msec */
451 if (err < 0) {
452 dev_err(&mgr->pci->dev, "error starting elf file\n");
453 return err;
456 /* the board type can now be retrieved */
457 mgr->board_type = (DAUGHTER_TYPE_MASK & readl_be( MIXART_MEM( mgr, MIXART_PSEUDOREG_DBRD_TYPE_OFFSET)));
459 if (mgr->board_type == MIXART_DAUGHTER_TYPE_NONE)
460 break; /* no daughter board; the file does not have to be loaded, continue after the switch */
462 /* only if aesebu daughter board presence (elf code must run) */
463 if (mgr->board_type != MIXART_DAUGHTER_TYPE_AES )
464 return -EINVAL;
466 /* daughter should be idle */
467 if (status_daught != 0) {
468 dev_err(&mgr->pci->dev,
469 "daughter load error ! status = %d\n",
470 status_daught);
471 return -EIO; /* modprob -r may help ? */
474 /* check daughterboard xilinx validity */
475 if (((u32*)(dsp->data))[0] == 0xffffffff)
476 return -EINVAL;
477 if (dsp->size % 4)
478 return -EINVAL;
480 /* inform mixart about the size of the file */
481 writel_be( dsp->size, MIXART_MEM( mgr, MIXART_PSEUDOREG_DXLX_SIZE_OFFSET ));
483 /* set daughterboard status to 1 */
484 writel_be( 1, MIXART_MEM( mgr, MIXART_PSEUDOREG_DXLX_STATUS_OFFSET ));
486 /* wait for status == 2 */
487 err = mixart_wait_nice_for_register_value( mgr, MIXART_PSEUDOREG_DXLX_STATUS_OFFSET, 1, 2, 30); /* 300msec */
488 if (err < 0) {
489 dev_err(&mgr->pci->dev, "daughter board load error\n");
490 return err;
493 /* get the address where to write the file */
494 val = readl_be( MIXART_MEM( mgr, MIXART_PSEUDOREG_DXLX_BASE_ADDR_OFFSET ));
495 if (!val)
496 return -EINVAL;
498 /* copy daughterboard xilinx code */
499 memcpy_toio( MIXART_MEM( mgr, val), dsp->data, dsp->size);
501 /* set daughterboard status to 4 */
502 writel_be( 4, MIXART_MEM( mgr, MIXART_PSEUDOREG_DXLX_STATUS_OFFSET ));
504 /* continue with init */
505 break;
506 } /* end of switch file index*/
508 /* wait for daughter status == 3 */
509 err = mixart_wait_nice_for_register_value( mgr, MIXART_PSEUDOREG_DXLX_STATUS_OFFSET, 1, 3, 300); /* 3sec */
510 if (err < 0) {
511 dev_err(&mgr->pci->dev,
512 "daughter board could not be initialised\n");
513 return err;
516 /* init mailbox (communication with embedded) */
517 snd_mixart_init_mailbox(mgr);
519 /* first communication with embedded */
520 err = mixart_first_init(mgr);
521 if (err < 0) {
522 dev_err(&mgr->pci->dev, "miXart could not be set up\n");
523 return err;
526 /* create devices and mixer in accordance with HW options*/
527 for (card_index = 0; card_index < mgr->num_cards; card_index++) {
528 struct snd_mixart *chip = mgr->chip[card_index];
530 if ((err = snd_mixart_create_pcm(chip)) < 0)
531 return err;
533 if (card_index == 0) {
534 if ((err = snd_mixart_create_mixer(chip->mgr)) < 0)
535 return err;
538 if ((err = snd_card_register(chip->card)) < 0)
539 return err;
542 dev_dbg(&mgr->pci->dev,
543 "miXart firmware downloaded and successfully set up\n");
545 return 0;
549 int snd_mixart_setup_firmware(struct mixart_mgr *mgr)
551 static const char * const fw_files[3] = {
552 "miXart8.xlx", "miXart8.elf", "miXart8AES.xlx"
554 char path[32];
556 const struct firmware *fw_entry;
557 int i, err;
559 for (i = 0; i < 3; i++) {
560 sprintf(path, "mixart/%s", fw_files[i]);
561 if (request_firmware(&fw_entry, path, &mgr->pci->dev)) {
562 dev_err(&mgr->pci->dev,
563 "miXart: can't load firmware %s\n", path);
564 return -ENOENT;
566 /* fake hwdep dsp record */
567 err = mixart_dsp_load(mgr, i, fw_entry);
568 release_firmware(fw_entry);
569 if (err < 0)
570 return err;
571 mgr->dsp_loaded |= 1 << i;
573 return 0;
576 MODULE_FIRMWARE("mixart/miXart8.xlx");
577 MODULE_FIRMWARE("mixart/miXart8.elf");
578 MODULE_FIRMWARE("mixart/miXart8AES.xlx");