annotate bwsplash/README @ 266:160a5b3a076c

new ABB_SLEEP_RESTRICTION definition in fc-target.h When we first introduced the mechanism to suppress ABB superdeep sleep on targets with LCDs powered from Iota VRIO, we made it conditional on CONFIG_TARGET_LUNA. This conditional is now being generalized: the feature in question is now conditionalized on the new ABB_SLEEP_RESTRICTION preprocessor symbol, to be defined in targets/*.h for those targets that need it. The new ABB_SLEEP_RESTRICTION definition is being added to targets/luna[12].h to keep the actual logic unchanged.
author Mychaela Falconia <falcon@freecalypso.org>
date Wed, 02 Jun 2021 02:12:14 +0000
parents a963d8cd8682
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
195
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
1 When TI's original version of small B&W UI firmware boots or shuts down, the
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
2 splash screen it displays consists of a 56x38 pixel B&W TI logo centered in the
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
3 middle of the LCD. (Back when this code was owned by Condat rather than TI,
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
4 this splash screen was an animated Condat logo of approximately the same size -
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
5 it is still present in the code, conditioned out.) Because we are FreeCalypso
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
6 and not TI or Condat, we need our own logo or at least our own splash screen to
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
7 replace those other company logos.
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
8
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
9 A bona fide FreeCalypso logo does not exist yet as of this writing (2021-03),
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
10 and while we (Falconia family that owns FC) do have some logo ideas in the
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
11 works, the 96x64 pixel B&W (1bpp) framebuffer in the FreeCalypso Lite config is
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
12 far too limited compared to other media - hence we are currently going for a
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
13 simple splash screen that merely consists of the words "FreeCalypso Lite".
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
14
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
15 The current version of our minimal-effort splash screen is 80x30 pixels, to be
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
16 centered in the middle of the 96x64 pixel LCD. The bitmap drawing is given in
4d9f24c501f3 bwsplash: simple splash screen for FreeCalypso Lite (smallbw)
Mychaela Falconia <falcon@freecalypso.org>
parents:
diff changeset
17 bwsplash.pbm, which is a Plain PBM file, making the pixel image directly
197
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
18 viewable and editable in vi. The tools in this directory compile it into hex
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
19 bytes for inclusion in C source, and the finished artifact goes into
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
20 src/ui/bmi/mmiIcons.c, fc_splash_screen_smallbw[] char array. The coordinates
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
21 for positioning this bitmap within the full 96x64 pixel framebuffer are given
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
22 in src/ui/bmi/mmiResources.h - look for WELCOME_ANI_POS_X and WELCOME_ANI_POS_Y
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
23 definitions.
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
24
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
25 The present splash screen is strictly a minimal-effort job with absolutely no
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
26 quality claims of any kind. If someone is more graphically talented than I am,
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
27 or has more time to invest into drawing a prettier splash screen, suggestions
a963d8cd8682 bwsplash/README: additional notes
Mychaela Falconia <falcon@freecalypso.org>
parents: 195
diff changeset
28 for improvement are always welcome.