diff doc/Audio-mode-config @ 843:6a0fcbca8ac7

document fc-tmsync aur & aur-all addition
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 31 Jul 2021 21:00:26 +0000
parents 02d92d49c9f8
children 6e137995c9c8
line wrap: on
line diff
--- a/doc/Audio-mode-config	Sat Jul 31 09:06:30 2021 +0000
+++ b/doc/Audio-mode-config	Sat Jul 31 21:00:26 2021 +0000
@@ -267,3 +267,29 @@
   words of the old type being all zeros.  Thanks to the modified audio mode
   loading code in our firmwares, these 164 byte mode files can still be used
   with current Tourmaline fw, with AEC set to its default disabled state.
+
+fc-tmsync aur and aur-all addition
+==================================
+
+New addition as of fc-host-tools-r16: our aur command which natively resides in
+fc-tmsh (audio mode full access read operation via ETM) has also been
+implemented in fc-tmsync for scripted usage.  Furthermore, we also implemented
+an aur-all command that issues the same sequence of aur operations as the
+firmware's built-in audio_mode_save() and emits the output on stdout in the same
+format as tiaud-decomp.  The end effect is that fc-tmsync aur-all is a much
+shorter and more direct way of obtaining exactly the same result as would
+previously be obtained by saving the current audio mode config with aus, reading
+out the resulting binary file with fc-fsio and decoding it with tiaud-decomp.
+
+The implementation of aur-all and the more elementary aur 12 command in
+fc-tmsync works only with firmware versions that have L1_NEW_AEC enabled -
+therefore, these commands work with FC Tourmaline but not Magnetite.
+
+Furthermore, our aur command in both fc-tmsh and fc-tmsync and the new fc-tmsync
+aur-all command also work against Pirelli's firmware - this alien fw implements
+ETM aur operation exactly the same as standard TCS211, and it has L1_NEW_AEC
+enabled, such that aur 12 returns the 24 byte long L1_NEW_AEC version of
+T_AUDIO_AEC_CFG structure.  The combination of this functionality in Pirelli's
+fw and our fc-tmsync addition makes it possible to read out Pirelli's highly
+tuned audio configurations in a very convenient manner, much more convenient
+than reading ABB registers with abbr and reading DSP API words with r16.