comparison 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
comparison
equal deleted inserted replaced
842:9da5fb3f42dd 843:6a0fcbca8ac7
265 265
266 * If neither setting is given, a 164 byte file will be produced, with the 5 AEC 266 * If neither setting is given, a 164 byte file will be produced, with the 5 AEC
267 words of the old type being all zeros. Thanks to the modified audio mode 267 words of the old type being all zeros. Thanks to the modified audio mode
268 loading code in our firmwares, these 164 byte mode files can still be used 268 loading code in our firmwares, these 164 byte mode files can still be used
269 with current Tourmaline fw, with AEC set to its default disabled state. 269 with current Tourmaline fw, with AEC set to its default disabled state.
270
271 fc-tmsync aur and aur-all addition
272 ==================================
273
274 New addition as of fc-host-tools-r16: our aur command which natively resides in
275 fc-tmsh (audio mode full access read operation via ETM) has also been
276 implemented in fc-tmsync for scripted usage. Furthermore, we also implemented
277 an aur-all command that issues the same sequence of aur operations as the
278 firmware's built-in audio_mode_save() and emits the output on stdout in the same
279 format as tiaud-decomp. The end effect is that fc-tmsync aur-all is a much
280 shorter and more direct way of obtaining exactly the same result as would
281 previously be obtained by saving the current audio mode config with aus, reading
282 out the resulting binary file with fc-fsio and decoding it with tiaud-decomp.
283
284 The implementation of aur-all and the more elementary aur 12 command in
285 fc-tmsync works only with firmware versions that have L1_NEW_AEC enabled -
286 therefore, these commands work with FC Tourmaline but not Magnetite.
287
288 Furthermore, our aur command in both fc-tmsh and fc-tmsync and the new fc-tmsync
289 aur-all command also work against Pirelli's firmware - this alien fw implements
290 ETM aur operation exactly the same as standard TCS211, and it has L1_NEW_AEC
291 enabled, such that aur 12 returns the 24 byte long L1_NEW_AEC version of
292 T_AUDIO_AEC_CFG structure. The combination of this functionality in Pirelli's
293 fw and our fc-tmsync addition makes it possible to read out Pirelli's highly
294 tuned audio configurations in a very convenient manner, much more convenient
295 than reading ABB registers with abbr and reading DSP API words with r16.