comparison README @ 5:abcbd98087bc

README added
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 19 Oct 2017 21:35:54 +0000
parents
children 39efa8203dfe
comparison
equal deleted inserted replaced
4:4d7c28689911 5:abcbd98087bc
1 This repository contains the source for the audio mode config files that need
2 to be uploaded into the flash file system (FFS) of FreeCalypso GSM devices
3 under /aud, along with the necessary Makefiles that compile these sources into
4 the binaries that are actually uploaded into the FFS of FreeCalypso devices.
5
6 The *.cfg and *.vol files that are compiled from the sources in this repository
7 are uploaded into the FFS of FreeCalypso devices on the factory production line,
8 however, these configurations will inevitably receive updates after the hardware
9 devices for which they are intended have been produced and shipped, hence
10 empowered end users (i.e., the kind of end users for whom our devices are made)
11 need to be able to install updated versions of these audio configurations on
12 their own devices, as well as study the source and possibly make their own
13 changes.
14
15 You need to have a recent version of FreeCalypso host tools (fc-host-tools-r7
16 or later) installed on your host system before you can compile the binary *.cfg
17 and *.vol files from the sources in this repository. Once you have these tools
18 installed, run 'make' to compile the *.cfg and *.vol files, then run
19 'make install' to have them installed in /opt/freecalypso/aud-* on your host
20 system.
21
22 Once you have up-to-date versions of the *.cfg and *.vol files compiled from
23 the present source installed on your host system under /opt/freecalypso, you
24 can then upload them into the FFS of actual FreeCalypso GSM devices with the
25 fc-fsio utility. For example, to update the /aud/*.{cfg,vol} files on an
26 FCDEV3B board, execute the following command:
27
28 fc-fsio upload-subtree /opt/freecalypso/aud-fcdev3b /aud
29
30 Change the /opt/freecalypso/aud-* source directory accordingly for other
31 FreeCalypso device types.