13d8e8186STakashi Iwai============================================================== 23d8e8186STakashi IwaiAlsa driver for Digigram miXart8 and miXart8AES/EBU soundcards 33d8e8186STakashi Iwai============================================================== 43d8e8186STakashi Iwai 53d8e8186STakashi IwaiDigigram <alsa@digigram.com> 63d8e8186STakashi Iwai 73d8e8186STakashi Iwai 83d8e8186STakashi IwaiGENERAL 93d8e8186STakashi Iwai======= 103d8e8186STakashi Iwai 113d8e8186STakashi IwaiThe miXart8 is a multichannel audio processing and mixing soundcard 123d8e8186STakashi Iwaithat has 4 stereo audio inputs and 4 stereo audio outputs. 133d8e8186STakashi IwaiThe miXart8AES/EBU is the same with a add-on card that offers further 143d8e8186STakashi Iwai4 digital stereo audio inputs and outputs. 153d8e8186STakashi IwaiFurthermore the add-on card offers external clock synchronisation 163d8e8186STakashi Iwai(AES/EBU, Word Clock, Time Code and Video Synchro) 173d8e8186STakashi Iwai 183d8e8186STakashi IwaiThe mainboard has a PowerPC that offers onboard mpeg encoding and 193d8e8186STakashi Iwaidecoding, samplerate conversions and various effects. 203d8e8186STakashi Iwai 213d8e8186STakashi IwaiThe driver don't work properly at all until the certain firmwares 223d8e8186STakashi Iwaiare loaded, i.e. no PCM nor mixer devices will appear. 233d8e8186STakashi IwaiUse the mixartloader that can be found in the alsa-tools package. 243d8e8186STakashi Iwai 253d8e8186STakashi Iwai 263d8e8186STakashi IwaiVERSION 0.1.0 273d8e8186STakashi Iwai============= 283d8e8186STakashi Iwai 293d8e8186STakashi IwaiOne miXart8 board will be represented as 4 alsa cards, each with 1 303d8e8186STakashi Iwaistereo analog capture 'pcm0c' and 1 stereo analog playback 'pcm0p' device. 313d8e8186STakashi IwaiWith a miXart8AES/EBU there is in addition 1 stereo digital input 323d8e8186STakashi Iwai'pcm1c' and 1 stereo digital output 'pcm1p' per card. 333d8e8186STakashi Iwai 343d8e8186STakashi IwaiFormats 353d8e8186STakashi Iwai------- 363d8e8186STakashi IwaiU8, S16_LE, S16_BE, S24_3LE, S24_3BE, FLOAT_LE, FLOAT_BE 373d8e8186STakashi IwaiSample rates : 8000 - 48000 Hz continuously 383d8e8186STakashi Iwai 393d8e8186STakashi IwaiPlayback 403d8e8186STakashi Iwai-------- 413d8e8186STakashi IwaiFor instance the playback devices are configured to have max. 4 423d8e8186STakashi Iwaisubstreams performing hardware mixing. This could be changed to a 433d8e8186STakashi Iwaimaximum of 24 substreams if wished. 443d8e8186STakashi IwaiMono files will be played on the left and right channel. Each channel 453d8e8186STakashi Iwaican be muted for each stream to use 8 analog/digital outputs separately. 463d8e8186STakashi Iwai 473d8e8186STakashi IwaiCapture 483d8e8186STakashi Iwai------- 493d8e8186STakashi IwaiThere is one substream per capture device. For instance only stereo 503d8e8186STakashi Iwaiformats are supported. 513d8e8186STakashi Iwai 523d8e8186STakashi IwaiMixer 533d8e8186STakashi Iwai----- 543d8e8186STakashi Iwai<Master> and <Master Capture> 553d8e8186STakashi Iwai analog volume control of playback and capture PCM. 563d8e8186STakashi Iwai<PCM 0-3> and <PCM Capture> 573d8e8186STakashi Iwai digital volume control of each analog substream. 583d8e8186STakashi Iwai<AES 0-3> and <AES Capture> 593d8e8186STakashi Iwai digital volume control of each AES/EBU substream. 603d8e8186STakashi Iwai<Monitoring> 613d8e8186STakashi Iwai Loopback from 'pcm0c' to 'pcm0p' with digital volume 623d8e8186STakashi Iwai and mute control. 633d8e8186STakashi Iwai 643d8e8186STakashi IwaiRem : for best audio quality try to keep a 0 attenuation on the PCM 653d8e8186STakashi Iwaiand AES volume controls which is set by 219 in the range from 0 to 255 663d8e8186STakashi Iwai(about 86% with alsamixer) 673d8e8186STakashi Iwai 683d8e8186STakashi Iwai 693d8e8186STakashi IwaiNOT YET IMPLEMENTED 703d8e8186STakashi Iwai=================== 713d8e8186STakashi Iwai 723d8e8186STakashi Iwai- external clock support (AES/EBU, Word Clock, Time Code, Video Sync) 733d8e8186STakashi Iwai- MPEG audio formats 743d8e8186STakashi Iwai- mono record 753d8e8186STakashi Iwai- on-board effects and samplerate conversions 763d8e8186STakashi Iwai- linked streams 773d8e8186STakashi Iwai 783d8e8186STakashi Iwai 793d8e8186STakashi IwaiFIRMWARE 803d8e8186STakashi Iwai======== 813d8e8186STakashi Iwai 823d8e8186STakashi Iwai[As of 2.6.11, the firmware can be loaded automatically with hotplug 833d8e8186STakashi Iwai when CONFIG_FW_LOADER is set. The mixartloader is necessary only 843d8e8186STakashi Iwai for older versions or when you build the driver into kernel.] 853d8e8186STakashi Iwai 863d8e8186STakashi IwaiFor loading the firmware automatically after the module is loaded, use a 873d8e8186STakashi Iwaiinstall command. For example, add the following entry to 883d8e8186STakashi Iwai/etc/modprobe.d/mixart.conf for miXart driver: 893d8e8186STakashi Iwai:: 903d8e8186STakashi Iwai 913d8e8186STakashi Iwai install snd-mixart /sbin/modprobe --first-time -i snd-mixart && \ 923d8e8186STakashi Iwai /usr/bin/mixartloader 933d8e8186STakashi Iwai 943d8e8186STakashi Iwai 953d8e8186STakashi Iwai(for 2.2/2.4 kernels, add "post-install snd-mixart /usr/bin/vxloader" to 963d8e8186STakashi Iwai/etc/modules.conf, instead.) 973d8e8186STakashi Iwai 983d8e8186STakashi IwaiThe firmware binaries are installed on /usr/share/alsa/firmware 993d8e8186STakashi Iwai(or /usr/local/share/alsa/firmware, depending to the prefix option of 1003d8e8186STakashi Iwaiconfigure). There will be a miXart.conf file, which define the dsp image 1013d8e8186STakashi Iwaifiles. 1023d8e8186STakashi Iwai 1033d8e8186STakashi IwaiThe firmware files are copyright by Digigram SA 1043d8e8186STakashi Iwai 1053d8e8186STakashi Iwai 1063d8e8186STakashi IwaiCOPYRIGHT 1073d8e8186STakashi Iwai========= 1083d8e8186STakashi Iwai 1093d8e8186STakashi IwaiCopyright (c) 2003 Digigram SA <alsa@digigram.com> 1103d8e8186STakashi IwaiDistributable under GPL. 111