feat(dashboard): give the screen back to the numbers, and say which version it is

The top bar spent 80dp of a 720dp panel introducing the app to a driver who
had just tapped its name to get here, and announcing "vehicle data
available" all day — a line that said what the numbers underneath were
already saying. Both are gone. Sub-screens keep their bars, where a title
and a way back are the whole point of one.

What the space bought: the state of charge, the one Display element on this
screen, reads at 56sp instead of 32sp, and the battery card grew with it;
every value in the instrument moved up a step of the scale. The suite token
text_display is untouched — the 56sp lives in dimens_app.xml with the reason
next to it, because this anchor no longer shares its screen with a bar and a
status line.

When the car stops answering, the line under the state of charge says so in
red, in the place where the missing number is, instead of a banner saying it
in orange somewhere else. Text and colour together: roughly one driver in
twelve cannot separate the hues, and the word is faster to read anyway.
Nothing appears, moves or asks for a tap while driving.

The rail did not fit and had not for two tickets. Once the system bars take
their share of 720dp, four stacked full-width buttons put the charge stop
off the bottom of the screen, where it was unreachable — the emulator at
1920x720 shows it plainly. The five actions are now one primary and a 2x2
grid, which fits with room to spare. The paired readout labels wrap in
French and not in English, so their values sat at four different heights;
two lines everywhere puts them back on one baseline.

About lives on a version badge at the top of the rail, where the app's name
used to be in the bar: version, author, and the repository as a QR encoded
on the device. The address is deliberately not a link — this head unit has
no browser to hand it to, and a tap that does nothing is worse than a code
the phone in a pocket can read off the glass. Modelled on EVTasker's, which
is where the zxing dependency comes from too.

Verified on the 1920x720 API 28 emulator in both palettes: nothing clipped,
nothing off-screen, #8F0F18 on white at 8.7:1 and #FFACAC on the night
surface at 10:1, both past the 7:1 daylight floor. README screenshots
regenerated from that run.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: malys

CHANGELOG.md

@@ -106,6 +106,24 @@ All notable changes follow [Keep a Changelog](https://keepachangelog.com/en/1.1.
 
 ### Changed
 
+- **The dashboard stopped introducing itself and started reading larger.** The top bar spent
+  80dp of a 720dp screen on the app's own name — which the driver had just tapped to get here —
+  and on a permanent "vehicle data available", a line that said what the numbers underneath
+  were already saying. Both are gone. The state of charge, the one Display element on this
+  screen, is now 56sp instead of 32sp, and every value on it moved up a step of the type scale;
+  the battery card grew with them. When the car stops answering, the line under the state of
+  charge says so in red instead of a banner saying it in orange all day: text and colour
+  together, in the place where the missing number is, and nothing appears, moves or asks for a
+  tap while driving. Sub-screens keep their title bars, where a title and a way back are the
+  point of the bar.
+
+- **The app says which version it is, and how to find its source from a car with no keyboard.**
+  A version badge sits at the top of the trip rail, where the app's name used to be in the bar,
+  and opens an About with the version, the author and the repository as a QR code — encoded on
+  the device, no network involved, modelled on EVTasker's. The address is deliberately not a
+  link: this head unit has no browser to hand it to, and a tap that does nothing is worse than
+  a code a phone can read off the glass.
+
 - **"Works offline" stopped being true in one direction only, and the documents say so.**
   Network and location were approved for route planning, which retires the first line of this
   app's safety argument — an app that cannot open a socket cannot exfiltrate a trip history, and

app/build.gradle.kts

@@ -94,5 +94,7 @@ dependencies {
     implementation(libs.material)
     implementation(libs.gson)
     implementation(libs.androidx.security.crypto)
+    // Encodes the About QR locally; the same version EVTasker ships.
+    implementation(libs.zxing.core)
     testImplementation(libs.junit)
 }

app/src/main/java/com/evsuite/chargepilot/MainActivity.kt

@@ -5,8 +5,11 @@ import android.content.Context
 import android.content.Intent
 import android.content.ServiceConnection
 import android.content.pm.PackageManager
+import android.graphics.Color
+import android.graphics.drawable.ColorDrawable
 import android.os.Bundle
 import android.os.IBinder
+import android.widget.ImageView
 import android.widget.TextView
 import android.widget.Toast
 import androidx.activity.result.contract.ActivityResultContracts
@@ -29,6 +32,8 @@ import com.evsuite.hardware.telemetry.EnergyTripSummary
 import com.evsuite.hardware.telemetry.Provenanced
 import com.evsuite.hardware.telemetry.TripDetector
 import com.evsuite.hardware.telemetry.UnavailableReason
+import com.google.android.material.button.MaterialButton
+import com.google.android.material.dialog.MaterialAlertDialogBuilder
 import java.io.File
 import java.util.Locale
 import java.util.concurrent.Executors
@@ -106,6 +111,8 @@ class MainActivity : AppCompatActivity() {
         binding.chargeStopAction.setOnClickListener {
             startActivity(Intent(this, ChargeStopActivity::class.java))
         }
+        binding.aboutAction.text = getString(R.string.about_version_badge, appVersion())
+        binding.aboutAction.setOnClickListener { showAbout() }
         renderUnavailable()
         requestVehiclePermissions()
         if (TripRecordingService.isAutomaticDetectionEnabled(this)) {
@@ -188,10 +195,7 @@ class MainActivity : AppCompatActivity() {
         renderReadings(readings, value.firmware)
 
         val hasVehicleData = value.hasVehicleData
-        binding.dataStatus.text = getString(
-            if (hasVehicleData) R.string.status_vehicle_connected else R.string.status_waiting_for_vehicle
-        )
-        binding.dataStatus.setTextColor(getColor(if (hasVehicleData) R.color.ev_ok else R.color.ev_warn))
+        renderDataStatus(hasVehicleData)
 
         // Recording controls are for a parked driver. Live values remain passive and readable
         // while moving; the app never presents an overlay or asks for attention.
@@ -417,11 +421,51 @@ class MainActivity : AppCompatActivity() {
         view.contentDescription = provenance.describe(getString(label), value, rendered)
     }
 
+    /**
+     * The screen carries no status banner: when the car answers, this line says where the
+     * number above it comes from, and when it does not, the same line says so in red. Text
+     * and colour together, because a driver reads the word faster than the hue and roughly
+     * one in twelve cannot separate the hues at all.
+     */
+    private fun renderDataStatus(hasVehicleData: Boolean) {
+        binding.dataStatus.setText(
+            if (hasVehicleData) R.string.soc_vehicle_reported else R.string.status_waiting_for_vehicle
+        )
+        binding.dataStatus.setTextColor(
+            getColor(if (hasVehicleData) R.color.ev_text_secondary else R.color.ev_error)
+        )
+    }
+
+    /** What the driver can read back down a phone line, build suffix and all. */
+    private fun appVersion(): String = runCatching {
+        packageManager.getPackageInfo(packageName, 0).versionName
+    }.getOrNull() ?: getString(R.string.about_version_unknown)
+
+    /**
+     * Version, authorship and the repository as a QR. The address is not a link: this head
+     * unit has no browser to hand it to, and a tap that does nothing is worse than a code
+     * the phone in the driver's pocket can read off the glass.
+     */
+    private fun showAbout() {
+        val content = layoutInflater.inflate(R.layout.dialog_about, null)
+        content.findViewById<TextView>(R.id.aboutVersion).text =
+            getString(R.string.about_version, appVersion())
+        QrCode.generate(REPOSITORY_URL, QR_SIZE_PX)?.let {
+            content.findViewById<ImageView>(R.id.aboutQrCode).setImageBitmap(it)
+        }
+        val dialog = MaterialAlertDialogBuilder(this).setView(content).create()
+        content.findViewById<MaterialButton>(R.id.aboutClose).setOnClickListener { dialog.dismiss() }
+        dialog.show()
+        // The card draws its own surface, outline and radius; the dialog window must not
+        // draw a second one behind it.
+        dialog.window?.setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
+    }
+
     private fun renderUnavailable() {
         latestReadings = DashboardReadings.empty()
         consumption.reset()
         renderReadings(latestReadings)
-        binding.dataStatus.text = getString(R.string.status_waiting_for_vehicle)
+        renderDataStatus(false)
         binding.tripAction.isEnabled = false
         binding.automaticDetection.isEnabled = false
         val automatic = TripRecordingService.isAutomaticDetectionEnabled(this)
@@ -766,6 +810,9 @@ class MainActivity : AppCompatActivity() {
         const val MAX_LOG_SECTION_BYTES = 32 * 1_024
         const val MAX_INVENTORY_FILES = 64
         const val DASH = "—"
+        const val REPOSITORY_URL = "https://github.com/malys/EVChargePilot"
+        /** Encoded once at this size, then scaled down into a 208dp view. */
+        const val QR_SIZE_PX = 416
         // The unit-bearing fields keep their unit while unavailable so the layout does not
         // shift the moment the vehicle starts answering.
         const val SOC_UNAVAILABLE = "— %"

app/src/main/java/com/evsuite/chargepilot/QrCode.kt

@@ -0,0 +1,28 @@
+package com.evsuite.chargepilot
+
+import android.graphics.Bitmap
+import android.graphics.Color
+import com.google.zxing.BarcodeFormat
+import com.google.zxing.EncodeHintType
+import com.google.zxing.MultiFormatWriter
+
+/**
+ * The repository address as a QR, encoded on the device: this app holds no network
+ * capability of its own beyond routing, and an About screen is not the place to gain one.
+ * Null when the encoder refuses; the caller leaves the image blank rather than guessing.
+ */
+object QrCode {
+
+    fun generate(content: String, sizePx: Int): Bitmap? = runCatching {
+        val hints = mapOf<EncodeHintType, Any>(
+            EncodeHintType.MARGIN to 1,
+            EncodeHintType.CHARACTER_SET to "UTF-8",
+        )
+        val matrix = MultiFormatWriter()
+            .encode(content, BarcodeFormat.QR_CODE, sizePx, sizePx, hints)
+        val pixels = IntArray(sizePx * sizePx) { index ->
+            if (matrix.get(index % sizePx, index / sizePx)) Color.BLACK else Color.WHITE
+        }
+        Bitmap.createBitmap(pixels, sizePx, sizePx, Bitmap.Config.RGB_565)
+    }.getOrNull()
+}

app/src/main/res/drawable/about_logo_tile.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android" android:shape="rectangle">
+    <solid android:color="@color/ev_icon_tile" />
+    <corners android:radius="@dimen/ev_corner" />
+</shape>