^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) ==============================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Alsa driver for Digigram miXart8 and miXart8AES/EBU soundcards
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) ==============================================================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) Digigram <alsa@digigram.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) GENERAL
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) =======
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) The miXart8 is a multichannel audio processing and mixing soundcard
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) that has 4 stereo audio inputs and 4 stereo audio outputs.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) The miXart8AES/EBU is the same with a add-on card that offers further
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) 4 digital stereo audio inputs and outputs.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) Furthermore the add-on card offers external clock synchronisation
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) (AES/EBU, Word Clock, Time Code and Video Synchro)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) The mainboard has a PowerPC that offers onboard mpeg encoding and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) decoding, samplerate conversions and various effects.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) The driver don't work properly at all until the certain firmwares
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) are loaded, i.e. no PCM nor mixer devices will appear.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) Use the mixartloader that can be found in the alsa-tools package.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) VERSION 0.1.0
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) =============
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) One miXart8 board will be represented as 4 alsa cards, each with 1
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) stereo analog capture 'pcm0c' and 1 stereo analog playback 'pcm0p' device.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) With a miXart8AES/EBU there is in addition 1 stereo digital input
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) 'pcm1c' and 1 stereo digital output 'pcm1p' per card.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Formats
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) -------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) U8, S16_LE, S16_BE, S24_3LE, S24_3BE, FLOAT_LE, FLOAT_BE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) Sample rates : 8000 - 48000 Hz continuously
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) Playback
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) --------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) For instance the playback devices are configured to have max. 4
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) substreams performing hardware mixing. This could be changed to a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) maximum of 24 substreams if wished.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) Mono files will be played on the left and right channel. Each channel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45) can be muted for each stream to use 8 analog/digital outputs separately.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Capture
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) -------
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49) There is one substream per capture device. For instance only stereo
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) formats are supported.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) Mixer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53) -----
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) <Master> and <Master Capture>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) analog volume control of playback and capture PCM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) <PCM 0-3> and <PCM Capture>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) digital volume control of each analog substream.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) <AES 0-3> and <AES Capture>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59) digital volume control of each AES/EBU substream.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) <Monitoring>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) Loopback from 'pcm0c' to 'pcm0p' with digital volume
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) and mute control.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) Rem : for best audio quality try to keep a 0 attenuation on the PCM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) and AES volume controls which is set by 219 in the range from 0 to 255
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) (about 86% with alsamixer)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) NOT YET IMPLEMENTED
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) ===================
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) - external clock support (AES/EBU, Word Clock, Time Code, Video Sync)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73) - MPEG audio formats
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) - mono record
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) - on-board effects and samplerate conversions
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) - linked streams
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) FIRMWARE
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) ========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) [As of 2.6.11, the firmware can be loaded automatically with hotplug
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) when CONFIG_FW_LOADER is set. The mixartloader is necessary only
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) for older versions or when you build the driver into kernel.]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) For loading the firmware automatically after the module is loaded, use a
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) install command. For example, add the following entry to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) /etc/modprobe.d/mixart.conf for miXart driver:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) ::
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) install snd-mixart /sbin/modprobe --first-time -i snd-mixart && \
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) /usr/bin/mixartloader
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) (for 2.2/2.4 kernels, add "post-install snd-mixart /usr/bin/vxloader" to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) /etc/modules.conf, instead.)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98) The firmware binaries are installed on /usr/share/alsa/firmware
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) (or /usr/local/share/alsa/firmware, depending to the prefix option of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) configure). There will be a miXart.conf file, which define the dsp image
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) files.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) The firmware files are copyright by Digigram SA
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) COPYRIGHT
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) =========
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) Copyright (c) 2003 Digigram SA <alsa@digigram.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) Distributable under GPL.
Orange Pi5 kernel
Deprecated Linux kernel 5.10.110 for OrangePi 5/5B/5+ boards
3 Commits
0 Branches
0 Tags