view doc/C1xx-updates @ 29:2168205c15be

add README and INSTALL
author Mychaela Falconia <falcon@freecalypso.org>
date Sat, 24 Jun 2023 04:21:14 +0000
parents afd760eb1f8d
children
line wrap: on
line source

In C1xx-flashing article we have covered how to initially flash FreeCalypso
aftermarket firmware into a C1xx phone and how to restore that phone back to its
original state.  However, what about updates?  What if your C1xx phone is
currently flashed with FreeCalypso and you would like to load a new firmware
build?  Or what if there is a new release of our FFS data bundle package with
updates that are relevant to C1xx targets?  How do you update these components
in your FC-on-C1xx flash?  There are two approaches, both described in this
article.

Full reflashing method
======================

If your C1xx phone is currently flashed with a FreeCalypso fw version from ages
ago, or you just don't know its exact state and would rather not depend on it,
you can simply follow the regular flashing procedure described in the
C1xx-flashing article.  If you run c1xx-analyze-image on a flashdump.bin image
that is FC aftermarket, the analysis script will detect this condition and
report it in its verbose output.  Generation of restore-flash script will be
skipped in this scenario - you don't have an original Motorola flash image to
restore - but you can still always flash any of Mot fw images posted on our FTP
site, just not with these scripts.

If you already have a per-phone project directory in which you've already run
c1xx-analyze-image and you simply wish to rerun the
{c11x,c139,c155}-gen-fc-script step, please feel free to do so.  The newly
generated fc-flash-script will refer to whichever firmware image you name on
the command line when you run the generator script anew, and fc-ffs.bin will be
regenerated based on your current state of /opt/freecalypso installation, which
is where all ffs-data-bundle updates go.  You can then execute the new
fc-flash-script in fc-loadtool just like the first time, and the phone will be
brought to the new state.

Fine-grained reflashing
=======================

If you are actively iterating, flashing new fw images as you build them, it
makes the most sense to reflash just the fw component, without touching the
dangerous boot sector (FreeCalypso bootloader never changes) and without having
to blow away and reflash your FFS.  In this scenario, make fc-loadtool entry as
usual and then execute a command of the following form:

On C11x/12x and C139/140 subfamilies:

loadtool> flash e-program-bin 0x10000 path/to/fwimage.bin

Or on C155/156 subfamily:

loadtool> flash e-program-bin 0x20000 path/to/fwimage.bin

Updating and reflashing just the FFS part
=========================================

If you wish regenerate fc-ffs.bin only (presumably to pick up updates to FFS
data bundle bits under /opt/freecalypso) without flashing or even naming a new
FC firmware image, you can run one of these scripts:

c11x-gen-fc-ffs-img rfbin IMEI 2m	-- for C11x/12x with 2 MiB flash
c11x-gen-fc-ffs-img rfbin IMEI 4m	-- for C11x/12x with 4 MiB flash
c139-gen-fc-ffs-img rfbin IMEI		-- for C139/140 (always 4 MiB flash)
c155-gen-fc-ffs-img rfbin IMEI		-- for C155/156 (always 8 MiB flash)

When you are ready to reflash fc-ffs.bin with fc-loadtool, whether it's because
you just regenerated it or because you simply wish to reset your FC FFS to its
pristine state, execute one of these commands:

for 2 MiB flash:

loadtool> flash e-program-bin 0x1C0000 fc-ffs.bin

for 4 MiB flash:

loadtool> flash e-program-bin 0x300000 fc-ffs.bin

for 8 MiB flash:

loadtool> flash e-program-bin 0x700000 fc-ffs.bin

You can also make "organic" updates to your FFS with fc-fsio, without going in
"brute force" with fc-loadtool - but you understand the workings of FreeCalypso
to that level, you probably won't be reading this guide or using any of these
scripts.