annotate README @ 15:ee565d95164c default tip

aud-caramel: create handheld.{cfg,vol} equal to hds4.{cfg,vol} The main audio channel on FC Caramel2 is not truly handheld, thus if someone is operating a C2 board in ACI mode, then doing AT@AUL="hds4" is more truthful than AT@AUL="handheld". However, the same audio mode needs to be named "handheld" for the UI firmware to pick it up in our Luna configuration.
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 06 Nov 2021 08:23:16 +0000
parents 39efa8203dfe
children
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
13
39efa8203dfe README: minimum required version of FC host tools is now r16
Mychaela Falconia <falcon@freecalypso.org>
parents: 5
diff changeset
15 You need to have a recent version of FreeCalypso host tools (fc-host-tools-r16
5
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.