changeset 29:2168205c15be

add README and INSTALL
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 24 Jun 2023 04:21:14 +0000
parents 58824cef4601
children 2d60f9a3032b
files INSTALL README
diffstat 2 files changed, 38 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/INSTALL	Sat Jun 24 04:21:14 2023 +0000
@@ -0,0 +1,28 @@
+The present FC aftermarket toolkit package needs to be installed on your host
+machine as an add-on to the basic FreeCalypso host tools package.  Please
+install FC host tools first, following the INSTALL document in that package -
+and once you have completed that process, the present package is to be installed
+the same way, with the same 'make' and 'make install' steps.
+
+In addition to FC host tools and the present fc-am-toolkit package, you also
+need to install these two other packages:
+
+* FFS data bundle add-on:
+
+  ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/ffs-data-bundle-latest.tar.bz2
+
+* FFS editing agent target binaries:
+
+  ftp://ftp.freecalypso.org/pub/GSM/FreeCalypso/ffs-editor-latest.tar.bz2
+
+The FFS editing agent part is needed only for the Pirelli DP-L10 workflow, and
+is not currently needed for any of Mot C1xx workflows supported by scripts in
+the present package - however, if you are installing FreeCalypso software on
+your host machine (PC or laptop) for working with different kinds of phones and
+other Calypso targets, it is always good to have a complete installation.
+
+All of the add-on packages used in these FreeCalypso aftermarket config
+workflows (the present fc-am-toolkit package and the other two referenced add-on
+packages) merely add files to the /opt/freecalypso tree established by the basic
+FreeCalypso host tools package; the content and layout of that file system tree
+are dictated solely by the Mother of FreeCalypso.
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Sat Jun 24 04:21:14 2023 +0000
@@ -0,0 +1,10 @@
+The present package is an add-on to FreeCalypso host tools that facilitates
+workflows related to running FC firmware on alien targets (Motorola C1xx and
+Pirelli DP-L10) in aftermarket configurations.  This package consists mostly of
+scripts that automate existing FreeCalypso tools, flashing or RAM-loading
+FreeCalypso firmware in the right combination with the needed bits from FC FFS
+data bundle package.
+
+Please refer to INSTALL document for installation instructions, and the various
+articles in the doc subdirectory for guidance on what you can do with FC
+firmware in aftermarket configurations on different targets.