# eHelp release v1.1.6

App 1.1.5 with firmware 1.1.4.

Ready-to-install files, so you don't need to compile anything.

| File | What it is |
|---|---|
| `eHelp-app-1.1.5.apk` | Android app |
| `eHelp-firmware-1.1.4-flight.bin` | eHelp controller firmware for flying (LilyGO T-QT Pro N8, ESP32-S3) |
| `eHelp-firmware-1.1.4-demo-sim.bin` | Bench/demo firmware: simulated ESC, battery and sensors; ESC output disabled. For trying the app and screen without hardware. |
| `SHA256SUMS.txt` | Checksums to confirm the downloads are intact |

Each `.bin` is a **merged image** (bootloader + partition table + app). Write it to address **0x0**.

## Install the app

1. Copy `eHelp-app-1.1.5.apk` to the phone (USB, Drive, email…), then open it.
2. Android will ask to allow installs from that source: allow it, then tap **Install**.
3. Updating from an older version keeps your flights and settings.

## Flash the firmware

> Remove the propeller before flashing or bench testing. Unplug the ESC battery; the T-QT is powered over USB while flashing.

### Option A: in the browser (Chrome or Edge, no install)

1. Plug the T-QT into the computer with a USB-C data cable.
2. Open <https://espressif.github.io/esptool-js/> and click **Connect**; pick the T-QT's port (USB JTAG/serial).
   If it does not show, unplug the T-QT, hold its **BOOT** button (IO0: the **right** button when mounted on the carrier),
   plug the cable back in, then release BOOT and try again.
3. Set **Flash Address** to `0x0`, choose the `.bin` file, and click **Program**.
4. When it finishes, unplug and replug the USB cable. The app shows the firmware version in Settings once connected.

### Option B: esptool on the command line

```
pip install esptool
esptool.py --chip esp32s3 --baud 921600 write_flash 0x0 eHelp-firmware-1.1.4-flight.bin
```
Add `--port COM5` (Windows) or `--port /dev/ttyACM0` (Linux/macOS) if it can't find the board.

### Keeping your settings

Flashing the merged image at 0x0 keeps the settings stored on the eHelp (battery, cutoffs, glider curves, sensor roles), because
they live in a separate area of flash. To wipe everything, run `esptool.py --chip esp32s3 erase_flash` first.

## After flashing

- Open the app, connect, and check **Settings** shows firmware **1.1.4**.
- In **Settings › Temperature sensors**, check each sensor has the right role (Pack L, Pack R, Motor).
- Check the settings in **Setup** and tap **SAVE TO eHELP** at the bottom until it shows **✓ ALL SAVED ON eHELP**.
- Do a motor test (prop off) before flying.

## What's new in app 1.1.5

- GPS moved from the Bluetooth tab to **Settings › GPS**. The phone's built-in GPS always runs and is the default.
- **Use vario GPS when available** (off by default): when on, the app uses the vario's GPS while its fixes keep arriving.
  If Bluetooth to the vario drops or the vario loses its fix, the app is back on the phone GPS within 3 seconds, with no
  gap in the log. "Now using" shows which GPS is feeding the log.

## What's new in firmware 1.1.4 / app 1.1.4

- The ESC fan is always on at 25 % throttle or more (off again below 20 %), whatever the temperature.
- Fan on/off temperatures are stored in 0.5 °C steps (config v2), so the app steps in whole degrees in both °F and °C.
  Older firmware still works; the app writes whole °C to it.
- Dashboard: ESC temperature between BATTERY L and BATTERY R; with a motor sensor it shows L · MOTOR · ESC · R.
- Settings › Temperature sensors always lists three rows; a missing sensor shows "not detected".
- Throttle: an inverted pot (released reads high) is handled; cruise is no longer cancelled by the released end sitting
  on the rail. The calibration wizard no longer flags a reversed pot resting at the top rail as a broken wire.

## What's new in firmware 1.1.2

- Throttle pots can be wired either way round: the calibration wizard (Setup › Calibrate) now saves a reversed pot
  (closed reads high, full reads low). Re-run the wizard after flashing if your throttle is reversed.
- A throttle whose released end sits right at 0 V or 3.3 V no longer stops cruise, the motor test or storage discharge.
  The kill switch (sharing the throttle's ground wire) and the broken-wire POT FAULT still stop the motor in every mode.

## What's new in app 1.1.2

- One **SAVE TO eHELP** button for the whole Setup area: battery, motor KV/poles, ESC fan, pack/motor cutoffs,
  climb reserve and the T-QT °F/°C all go to the eHelp together. It shows how many changes are not on the eHelp yet.
- Leaving Setup with unsaved changes asks whether to save, discard or go back.
- New **Bench** tab for the motor test, fan test and demo data (moved out of Settings).
- ESC fan: one **Fan on at** setting; it turns off again a fixed 5 °C lower so it doesn't cycle.
- Firmware 1.0 units: the pack cutoff and reserve count as saved even though that firmware has no motor cutoff.

## What's new in app 1.1.1

- The dashboard shows the MOTOR temperature only when a sensor has the Motor role; otherwise it goes back to the two
  pack temperatures (BATTERY TEMP L / R). If the motor sensor drops out in flight, MOTOR stays and shows a dash.

## What's new in 1.1.0

- Temperature sensor roles: each sensor gets a role selector (Pack L, Pack R, Motor or None); picking a role that another
  sensor holds moves it and leaves the other sensor blank.
- Third (motor) temperature sensor with motor temp caution and cutoff.
- Throttle kill switch on a 4th wire (GPIO33).
- SAVE CUTOFFS TO eHELP button that confirms the cutoffs are stored on the unit.

## Building it yourself

Firmware: `cd "1. ESP32" && pio run -e tqt` (or `-e tqt_sim`). App: `cd "2. Android" && flutter build apk --release`.
`release/make_release.ps1 -Ver 1.1.6 -FwVer 1.1.4` packages both into this folder.