view bwsplash/README @ 303:f76436d19a7a default tip

!GPRS config: fix long-standing AT+COPS chance hanging bug There has been a long-standing bug in FreeCalypso going back years: sometimes in the AT command bring-up sequence of an ACI-only MS, the AT+COPS command would produce only a power scan followed by cessation of protocol stack activity (only L1 ADC traces), instead of the expected network search sequence. This behaviour was seen in different FC firmware versions going back to Citrine, and seemed to follow some law of chance, not reliably repeatable. This bug has been tracked down and found to be specific to !GPRS configuration, stemming from our TCS2/TCS3 hybrid and reconstruction of !GPRS support that was bitrotten in TCS3.2/LoCosto version. ACI module psa_mms.c, needed only for !GPRS, was missing in the TCS3 version and had to be pulled from TCS2 - but as it turns out, there is a new field in the MMR_REG_REQ primitive that needs to be set correctly, and that psa_mms.c module is the place where this initialization needed to be added.
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 08 Jun 2023 08:23:37 +0000
parents a963d8cd8682
children
line wrap: on
line source

When TI's original version of small B&W UI firmware boots or shuts down, the
splash screen it displays consists of a 56x38 pixel B&W TI logo centered in the
middle of the LCD.  (Back when this code was owned by Condat rather than TI,
this splash screen was an animated Condat logo of approximately the same size -
it is still present in the code, conditioned out.)  Because we are FreeCalypso
and not TI or Condat, we need our own logo or at least our own splash screen to
replace those other company logos.

A bona fide FreeCalypso logo does not exist yet as of this writing (2021-03),
and while we (Falconia family that owns FC) do have some logo ideas in the
works, the 96x64 pixel B&W (1bpp) framebuffer in the FreeCalypso Lite config is
far too limited compared to other media - hence we are currently going for a
simple splash screen that merely consists of the words "FreeCalypso Lite".

The current version of our minimal-effort splash screen is 80x30 pixels, to be
centered in the middle of the 96x64 pixel LCD.  The bitmap drawing is given in
bwsplash.pbm, which is a Plain PBM file, making the pixel image directly
viewable and editable in vi.  The tools in this directory compile it into hex
bytes for inclusion in C source, and the finished artifact goes into
src/ui/bmi/mmiIcons.c, fc_splash_screen_smallbw[] char array.  The coordinates
for positioning this bitmap within the full 96x64 pixel framebuffer are given
in src/ui/bmi/mmiResources.h - look for WELCOME_ANI_POS_X and WELCOME_ANI_POS_Y
definitions.

The present splash screen is strictly a minimal-effort job with absolutely no
quality claims of any kind.  If someone is more graphically talented than I am,
or has more time to invest into drawing a prettier splash screen, suggestions
for improvement are always welcome.