annotate README @ 7:677abb56abac

create aud-minimal mode config Our FreeCalypso handset firmware will soon start requiring audio mode configuration files. handfree and headset modes can be omitted on targets that have no headset or loudspeaker support, but the basic handheld mode will always be required - if audio mode loading fails, then volume control via RV Audio Service won't work. The minimal handheld mode config created here should be correct for all currently supported targets.
author Mychaela Falconia <falcon@freecalypso.org>
date Mon, 14 Jun 2021 00:57:24 +0000
parents abcbd98087bc
children 39efa8203dfe
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 This repository contains the source for the audio mode config files that need
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 to be uploaded into the flash file system (FFS) of FreeCalypso GSM devices
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 under /aud, along with the necessary Makefiles that compile these sources into
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 the binaries that are actually uploaded into the FFS of FreeCalypso devices.
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 The *.cfg and *.vol files that are compiled from the sources in this repository
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 are uploaded into the FFS of FreeCalypso devices on the factory production line,
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8 however, these configurations will inevitably receive updates after the hardware
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 devices for which they are intended have been produced and shipped, hence
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 empowered end users (i.e., the kind of end users for whom our devices are made)
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 need to be able to install updated versions of these audio configurations on
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 their own devices, as well as study the source and possibly make their own
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 changes.
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 You need to have a recent version of FreeCalypso host tools (fc-host-tools-r7
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 or later) installed on your host system before you can compile the binary *.cfg
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 and *.vol files from the sources in this repository. Once you have these tools
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
18 installed, run 'make' to compile the *.cfg and *.vol files, then run
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
19 'make install' to have them installed in /opt/freecalypso/aud-* on your host
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
20 system.
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
21
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
22 Once you have up-to-date versions of the *.cfg and *.vol files compiled from
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
23 the present source installed on your host system under /opt/freecalypso, you
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
24 can then upload them into the FFS of actual FreeCalypso GSM devices with the
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
25 fc-fsio utility. For example, to update the /aud/*.{cfg,vol} files on an
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
26 FCDEV3B board, execute the following command:
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
27
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
28 fc-fsio upload-subtree /opt/freecalypso/aud-fcdev3b /aud
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
29
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
30 Change the /opt/freecalypso/aud-* source directory accordingly for other
abcbd98087bc README added
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
31 FreeCalypso device types.