App 2.50.0: the Caterpillar crawls while you drive

A hump runs from the tail to the head, lifted feet swing forward while
the others stay planted, and the branch it walks on slides by with the
speed. Parked, it settles into its high arch.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LhzAVaUyqcw5PkGjz4mWW6

SPECS.md

@@ -140,6 +140,10 @@ tyre pressures, GPS (lat, lon, elevation, heading) and the is_* flags. It does *
   confirmed car facts, app structure, UI conventions, build/test/ship, documents. It replaces
   upstream's EVABRPUploader text. The test emulator is now in the flake: `nix run .#car-emulator`
   (Android 9 AOSP at 1920×720, 160 dpi; the car build installs as the system user — checked).
+- 2026-11-07 — App 2.50.0: **the Caterpillar crawls** (owner: "make it so the caterpillar appears to be going when we drive? Using normal caterpillar movement?"). While the car moves it crawls as a caterpillar does: a hump runs from the tail to the head, the body bunches and stretches a little, feet that are lifted swing forward and the others stay planted on a branch whose knots and leaves slide backwards with the speed; the crawl is quicker the faster the car goes (at most 1.2 crawls a second). It does not change its place on screen, so the readings stay put. Parked, it eases back into its high arch (it keeps drawing for that moment only). Two screenshots redone. Tested: unit tests, lint, emulator with sample values (frames 0.25 s apart show the hump travelling and the branch sliding). Not tried on the car.
+- 2026-11-07 — App 2.49.1 published (`car-2.49.1`).
+- 2026-11-07 — App 2.49.1: **the Caterpillar looks more like the one in the book** (owner: "Make it more like the original caterpillar", with the German edition's cover as the reference). It arches over the middle like the cover's: overlapping chunks of mottled green and teal paper, a yellow fringe along the back, olive feet, and a red-orange head with a yellow face, green eyes and purple antennae; the speed is on the face. Power still lights the segments (blue when regenerating) and the back humps while driving. Still my own drawing of it, not the book's artwork. Two screenshots redone. Tested: unit tests, lint, emulator with sample values. Not tried on the car.
+- 2026-11-07 — App 2.49.0 published (`car-2.49.0`).
 - 2026-11-07 — App 2.49.0: **the Caterpillar style** (owner: "a theme based on The Very Hungry Caterpillar"; design agreed first, defaults taken: dark night page, named "Caterpillar" not the book's title, fruit as range). `CaterpillarView`, an original cut-paper collage, not the book's illustrations: the caterpillar's red head is the speed and its ten segments the power (blue while regenerating, wiggling while driving); the sun is the battery (a grey moon below 20 %); a leaf holds trip, usage, climate and odometer; a clock in a paper circle; fruit in the story's order (1 apple, 2 pears, 3 plums, 4 strawberries, 5 oranges) is the range, one per 50 km, used ones with a bite out; P R N D are an egg, the caterpillar, a cocoon and a butterfly; hills are the last two minutes of power. The music light (now also for this style) bounces the sun's rays and the segments on the kick drum. What plays: a butterfly and, on the next pass, a ladybird tow a strip of tissue paper (colour fixed by the song); both in `SongCarriers`. Own palette (green). Two screenshots in THEMES.md. Tested: unit tests, lint, emulator with sample values and with the throwaway fake song. Not tried on the car.
 - 2026-11-07 — App 2.48.0 published (`car-2.48.0`).
 - 2026-11-07 — App 2.48.0: **the Christmas style** (owner: "let's also do a christmas based theme", with music and something that pulsates; design agreed first). `ChristmasView`: a tree with a big red bauble (speed), fairy lights arching over it (power: gold left to right while drawing, ice blue and right to left while regenerating), a glass mug of cocoa filling with the charge (cold blue and "BATTERY LOW" below 20 %), gift tags (trip, usage, climate, odometer), a wreath clock, a signboard (range) with a candy cane per 50 km, P R N D as baubles, and a snow drift of the last two minutes of power; snow falls and the lights twinkle while driving. Own palette (red); always in the drop-down; English only. The music light is now **"Light follows the music"** for Halloween and Christmas (same `PREF_MUSIC_LIGHT`, off by default): the tree's lights and the arch flare on the kick drum. What plays: Santa's sleigh with a reindeer and, on the next pass, an angel with a trumpet tow a strip of wrapping paper (colour fixed by the song); both in `SongCarriers`. Two screenshots in THEMES.md. Tested: unit tests, lint, emulator with sample values (panel and full screen, and with no data), with the throwaway fake song (both carriers), and the music-tap thread runs only with the switch on. Not tried on the emulator: the pulse itself with real sound (the code path is Halloween's `MusicTap`). Not tried on the car.

THEMES.md

@@ -307,9 +307,13 @@ trumpet; the paper's colour is fixed by the song. The app turns red with it.
 ## Caterpillar
 
 After a picture book about a very hungry caterpillar, drawn anew in cut-paper shapes and bright
-tissue colours on the book's night page. The caterpillar crosses the middle: its red head carries
+tissue colours on the book's night page. The caterpillar arches over the middle, after the one on
-the speed, and its ten green segments are the power, lit from the head backwards while drawing and
+the book's cover: overlapping chunks of mottled green paper with a yellow fringe along the back and
-blue while regenerating; it wiggles along while you drive. On the left the sun is the battery,
+olive feet, and a red-orange head with a yellow face, green eyes and purple antennae. The face
+carries the speed, and its ten segments are the power, lit from the head backwards while drawing and
+blue while regenerating. While you drive it crawls the way a caterpillar does: a hump runs from its
+tail to its head, the feet it lifts swing forward and the others stay planted, and the branch it
+walks on slides by, faster the faster the car goes. Parked, it settles into its high arch. On the left the sun is the battery,
 filling with the charge; below 20 % it turns into a grey moon and "BATTERY LOW" blinks. A big leaf
 above it holds trip, usage, climate and odometer on paper labels. On the right a clock in a paper
 circle, and the story's fruit, one apple, two pears, three plums, four strawberries and five

app/build.gradle

@@ -34,8 +34,8 @@ android {
         applicationId "com.stinnesbeck.nilsmg4"
         minSdk 27
         targetSdk 36
-        versionCode 166
+        versionCode 168
-        versionName "2.49.0"
+        versionName "2.50.0"
 
         // Nothing about the server ships in the APK: its URL and ingest token are entered in
         // the app's Server tab (ServerConfig), and the database is only reachable by the server.

app/src/main/java/com/evsuite/abrp/CaterpillarView.java

@@ -17,9 +17,11 @@ import java.util.Locale;
  * The Caterpillar Overview style, after the picture book about a very hungry caterpillar (drawn
  * anew, not copied from it): cut-paper shapes in bright tissue colours on the book's night page.
  *
- * In the middle the caterpillar: its red head carries the speed, and its ten green segments are the
+ * In the middle the caterpillar, arched like the one on the book's cover (overlapping chunks of
- * power, lit from the head backwards while drawing, blue while regenerating; it wiggles along while
+ * mottled green tissue paper, a yellow fringe along the back, a red-orange head with a yellow face):
- * the car moves. On the left the sun is the battery, filling with the charge, and turning into a
+ * the face carries the speed, and its ten segments are the power, lit from the head backwards while
+ * drawing, blue while regenerating; while the car moves it crawls the way a caterpillar does: a hump runs from tail to head, its feet
+ * lifting and planting, on a branch that slides by. On the left the sun is the battery, filling with the charge, and turning into a
  * grey moon with "BATTERY LOW" blinking below 20 %; above it a big leaf holds trip, usage, climate
  * and odometer on paper labels. On the right the clock in a paper circle, and the
  * story's fruit: one apple, two pears, three plums, four strawberries and five oranges, a fruit
@@ -58,6 +60,8 @@ final class CaterpillarView extends ClusterCanvasView {
     private Bitmap sky;
     private int skyW, skyH;
     private float time;
+    /** Where the crawl is (whole numbers are one full crawl), how far the ground has gone by, and how much it crawls (0 to 1). */
+    private float phase, travel, crawl;
     private long lastFrame;
     private MusicTap music;
 
@@ -86,13 +90,18 @@ final class CaterpillarView extends ClusterCanvasView {
         if (w <= 0 || h <= 0) return;
         float u = Math.min(h / 640f, w / 1100f);
         boolean moving = v.speedKmh != null && v.speedKmh > 0.5f;
+        long now = SystemClock.uptimeMillis();
+        float dt = lastFrame == 0 ? 0f : Math.min(0.2f, (now - lastFrame) / 1000f);
+        lastFrame = moving || crawl > 0.01f ? now : 0;
         if (moving) {
-            long now = SystemClock.uptimeMillis();
+            float kmh = Math.min(v.speedKmh, 130f);
-            time += lastFrame == 0 ? 0f : Math.min(0.2f, (now - lastFrame) / 1000f);
+            time += dt;
-            lastFrame = now;
+            // One crawl takes a second or two; faster the faster the car goes, and the ground slides by.
-        } else {
+            phase = (phase + dt * Math.min(1.2f, 0.4f + kmh / 90f)) % 1000f;
-            lastFrame = 0;
+            travel = (travel + dt * kmh * 1.1f * u) % 100000f;
         }
+        // It settles into its resting arch when the car stops, and sets off again when it moves.
+        crawl += ((moving ? 1f : 0f) - crawl) * Math.min(1f, dt * 4f);
         if (sky == null || skyW != w || skyH != h) buildSky(w, h, u);
         c.drawBitmap(sky, 0, 0, image);
         boolean song = drawSong(c, w, u);
@@ -103,8 +112,9 @@ final class CaterpillarView extends ClusterCanvasView {
         drawClock(c, w, u);
         drawFruit(c, w, u);
         drawGears(c, w, u);
+        drawBranch(c, w, u);
         drawCaterpillar(c, w, u, pulse);
-        keepAnimating(moving || pulse > 0f || song, 33);
+        keepAnimating(moving || crawl > 0.01f || pulse > 0f || song, 33);
     }
 
     private void label(Canvas c, String s, float x, float y, float size, int colour, Typeface tf, Paint.Align a) {
@@ -440,56 +450,127 @@ final class CaterpillarView extends ClusterCanvasView {
         }
     }
 
-    // ---------- The caterpillar: speed and power ----------
+    // ---------- The branch it crawls on ----------
 
-    private void drawCaterpillar(Canvas c, int w, float u, float pulse) {
+    /** A branch under the caterpillar; its knots and leaves slide backwards as the car goes. */
-        float hx = w / 2f + 250f * u, hy = 400f * u, hr = 76f * u;
+    private void drawBranch(Canvas c, int w, float u) {
-        int lit = Tally.ofPower(v.powerKw, 150f, 50f, SEGMENTS);
+        float hx = w / 2f + 250f * u, y = 410f * u + 87f * u;
-        int colour = regen() ? ICE : GREEN;
+        float l = hx - 640f * u, rr = hx + 110f * u, span = rr - l;
-        // The segments from the tail towards the head, the legs behind them.
+        line.setColor(0xFF6B4A2B);
-        for (int i = SEGMENTS - 1; i >= 0; i--) {
+        line.setStrokeWidth(20f * u);
-            float x = hx - 100f * u - i * 54f * u;
+        c.drawLine(l, y, rr, y, line);
-            float y = hy + 10f * u + (float) Math.sin(time * 3.5f - i * 0.75f) * 12f * u;
+        line.setColor(0x44FFD59A);
-            boolean on = i < lit;
+        line.setStrokeWidth(4f * u);
-            float rad = 32f * u * (1f + (on ? pulse * (i % 2 == 0 ? 0.18f : 0.12f) : 0f));
+        c.drawLine(l + 6f * u, y - 6f * u, rr - 6f * u, y - 6f * u, line);
-            line.setColor(HEAD);
+        for (int k = 0; k < 8; k++) {
-            line.setStrokeWidth(4f * u);
+            float x = l + (((k * span / 8f) - travel) % span + span) % span;
-            float foot = (i % 2 == 0 ? 6f : -6f) * u;
+            fill.setColor(0xFF4A3018);
-            c.drawLine(x, y + rad - 4f * u, x + foot, y + rad + 14f * u, line);
+            r.set(x - 9f * u, y - 5f * u, x + 9f * u, y + 6f * u);
-            fill.setColor(on ? colour : 0xFF3B7A4A);
+            c.drawOval(r, fill);
-            c.drawCircle(x, y, rad, fill);
+            if (k % 2 == 0) {
-            line.setColor(on ? GREEN_DARK : 0xFF2A5A36);
+                fill.setColor(0xFF3FA34D);
-            line.setStrokeWidth(3f * u);
+                r.set(x - 4f * u, y + 6f * u, x + 20f * u, y + 18f * u);
-            c.drawCircle(x, y, rad, line);
+                c.drawOval(r, fill);
-            if (on) {
-                fill.setColor(0x44FFFFFF);
-                c.drawCircle(x - rad * 0.3f, y - rad * 0.35f, rad * 0.28f, fill);
             }
         }
-        // The head, with antennae and eyes, and the speed.
+    }
-        line.setColor(HEAD);
+
-        line.setStrokeWidth(4f * u);
+    // ---------- The caterpillar: speed and power ----------
-        c.drawLine(hx - 22f * u, hy - hr + 8f * u, hx - 40f * u, hy - hr - 30f * u, line);
+
-        c.drawLine(hx + 22f * u, hy - hr + 8f * u, hx + 40f * u, hy - hr - 30f * u, line);
+    /** Tissue-paper greens for a segment: base colours, a light patch and a teal patch, by state. */
-        fill.setColor(0xFFFFA726);
+    private static final int[][] DRAWING = { { 0xFF4CC15C, 0xFF38A94A, 0xFF66CC6A }, { 0xFF9BE08A, 0xFF2FA89A } };
-        c.drawCircle(hx - 40f * u, hy - hr - 32f * u, 7f * u, fill);
+    private static final int[][] REGEN = { { 0xFF2A8FC9, 0xFF1F78B4, 0xFF4AA8DA }, { 0xFF9BDCFF, 0xFF3AC8D0 } };
-        c.drawCircle(hx + 40f * u, hy - hr - 32f * u, 7f * u, fill);
+    private static final int[][] OFF = { { 0xFF2B7A40, 0xFF256B38, 0xFF328C4B }, { 0xFF3A9060, 0xFF2A8078 } };
-        fill.setColor(HEAD);
+
-        c.drawCircle(hx, hy, hr * (1f + pulse * 0.04f), fill);
+    /**
-        fill.setColor(0x33FFFFFF);
+     * The caterpillar arches over the middle like the one on the book's cover: overlapping chunks of
-        c.drawCircle(hx - hr * 0.35f, hy - hr * 0.4f, hr * 0.2f, fill);
+     * mottled tissue paper in greens and teals, a fringe of yellow hair along its back, olive feet,
-        for (int side = -1; side <= 1; side += 2) {
+     * and a red-orange head with a yellow face, green eyes and purple antennae. Power lights the
-            fill.setColor(0xFFFFFFFF);
+     * segments (bright green, or blue when regenerating, dull when dark); the speed is on its face.
-            c.drawCircle(hx + side * 24f * u, hy - 34f * u, 14f * u, fill);
+     */
-            fill.setColor(INK);
+    private void drawCaterpillar(Canvas c, int w, float u, float pulse) {
-            c.drawCircle(hx + side * 24f * u + 3f * u, hy - 33f * u, 6f * u, fill);
+        float hx = w / 2f + 250f * u, hy = 410f * u, hr = 76f * u;
+        int lit = Tally.ofPower(v.powerKw, 150f, 50f, SEGMENTS);
+        int[][] palette = regen() ? REGEN : DRAWING;
+        // At rest it arches high in the middle. Crawling, a real caterpillar pulls its rear forward and
+        // humps the body up, and the hump runs from the tail to the head while the feet it lifts swing
+        // forward and the others stay planted; the body also bunches and stretches as it goes.
+        float arch = (92f * (1f - crawl) + 30f * crawl) * u;
+        float cycle = phase % 1f;
+        float stretch = 1f + 0.08f * crawl * (float) Math.sin(cycle * 2f * Math.PI);
+        float wave = 1.25f - cycle * 1.6f;
+        float[] xs = new float[SEGMENTS], ys = new float[SEGMENTS], lift = new float[SEGMENTS];
+        for (int i = 0; i < SEGMENTS; i++) {
+            float along = (SEGMENTS - 1 - i) / (SEGMENTS - 1f);
+            float d = Math.max(0f, 1f - Math.abs(along - wave) / 0.4f);
+            lift[i] = crawl * d * d * (3f - 2f * d);
+            xs[i] = hx - 92f * u - i * 48f * u * stretch;
+            ys[i] = hy + 24f * u - arch * (float) Math.sin(Math.PI * (i + 0.7) / (SEGMENTS + 0.4)) - lift[i] * 46f * u;
         }
-        label(c, fmt(v.speedKmh, "%.0f", "—"), hx, hy + 38f * u, 58f * u, 0xFFFFFFFF, serif, Paint.Align.CENTER);
+        // From the tail towards the head, each overlapping the one before.
-        label(c, "KM/H", hx, hy + 58f * u, 14f * u, 0xCCFFE9EA, face, Paint.Align.CENTER);
+        for (int i = SEGMENTS - 1; i >= 0; i--) {
+            boolean on = i < lit;
+            int[][] pal = on ? palette : OFF;
+            float x = xs[i], y = ys[i];
+            int prev = Math.max(0, i - 1), next = Math.min(SEGMENTS - 1, i + 1);
+            float angle = (float) Math.toDegrees(Math.atan2(ys[prev] - ys[next], xs[prev] - xs[next]));
+            float grow = 1f + (on ? pulse * (i % 2 == 0 ? 0.16f : 0.1f) : 0f);
+            c.save();
+            c.rotate(angle, x, y);
+            c.scale(grow, grow, x, y);
+            // The foot, under every other segment.
+            if (i % 2 == 0) {
+                line.setColor(0xFF8A7B2E);
+                line.setStrokeWidth(8f * u);
+                // A lifted foot swings forward and up; a planted one is on the branch.
+                float up = lift[i] * 12f * u;
+                c.drawLine(x, y + 46f * u, x + (3f + lift[i] * 12f) * u, y + 60f * u - up, line);
+            }
+            // The chunk of paper with two patches of other tissue on it.
+            r.set(x - 37f * u, y - 48f * u, x + 37f * u, y + 48f * u);
+            fill.setColor(pal[0][i % 3]);
+            c.drawOval(r, fill);
+            fill.setColor(AccentColor.withAlpha(pal[1][0], 0x80));
+            r.set(x - 28f * u, y - (i % 2 == 0 ? 38f : 10f) * u, x + 4f * u, y + (i % 2 == 0 ? -4f : 36f) * u);
+            c.drawOval(r, fill);
+            fill.setColor(AccentColor.withAlpha(pal[1][1], 0x70));
+            r.set(x - 2f * u, y - (i % 2 == 0 ? 8f : 40f) * u, x + 30f * u, y + (i % 2 == 0 ? 38f : 0f) * u);
+            c.drawOval(r, fill);
+            // The fringe of hair along the back.
+            line.setColor(on ? 0xFFD9C84A : 0x80D9C84A);
+            line.setStrokeWidth(2f * u);
+            for (int k = -2; k <= 2; k++) {
+                c.drawLine(x + k * 12f * u, y - (46f - Math.abs(k) * 4f) * u, x + k * 15f * u, y - (57f - Math.abs(k) * 4f) * u, line);
+            }
+            c.restore();
+        }
+        // The head: purple antennae, a red-orange head with a yellow face, green eyes, the speed.
+        line.setColor(0xFF7B68C8);
+        line.setStrokeWidth(8f * u);
+        c.drawLine(hx - 24f * u, hy - hr + 10f * u, hx - 46f * u, hy - hr - 40f * u, line);
+        c.drawLine(hx + 24f * u, hy - hr + 10f * u, hx + 46f * u, hy - hr - 40f * u, line);
+        float hs = 1f + pulse * 0.04f;
+        fill.setColor(0xFFE8452B);
+        c.drawCircle(hx, hy, hr * hs, fill);
+        r.set(hx - 52f * u, hy - 64f * u, hx + 52f * u, hy + 62f * u);
+        fill.setColor(0xFFFFC21F);
+        c.drawOval(r, fill);
+        for (int side = -1; side <= 1; side += 2) {
+            r.set(hx + side * 26f * u - 11f * u, hy - 50f * u, hx + side * 26f * u + 11f * u, hy - 20f * u);
+            fill.setColor(0xFF3F9A3A);
+            c.drawOval(r, fill);
+            line.setColor(INK);
+            line.setStrokeWidth(2f * u);
+            c.drawOval(r, line);
+            fill.setColor(INK);
+            c.drawCircle(hx + side * 26f * u, hy - 38f * u, 3.5f * u, fill);
+        }
+        label(c, fmt(v.speedKmh, "%.0f", "—"), hx, hy + 30f * u, 46f * u, INK, serif, Paint.Align.CENTER);
+        label(c, "KM/H", hx, hy + 48f * u, 13f * u, 0xFF7A3A10, face, Paint.Align.CENTER);
         boolean regen = regen();
         String power = v.powerKw == null ? "— kW" : String.format(Locale.US, regen ? "+%.1f kW" : "%.1f kW",
                 Math.abs(v.powerKw));
-        outlined(c, power, hx - 100f * u - 4.5f * 54f * u, 556f * u, 34f * u, regen ? ICE : BONE, face, Paint.Align.CENTER, u);
+        outlined(c, power, hx - 92f * u - 4.5f * 48f * u, 556f * u, 34f * u, regen ? ICE : BONE, face, Paint.Align.CENTER, u);
     }
 
     // ---------- What plays: a butterfly or a ladybird tows it on tissue paper ----------