Files
mg4/DISCLAIMER.md
T
TCFDONMEZandClaude Opus 5 444732438d feat: close all windows when parked and a door opens
Ports WinClose's SWI69 window control as an opt-in foreground service that is
independent of ABRP: no token, no GPS, no upload cadence. The driver opening a
door while the car is in P at a readable 0 km/h pulses UP at all four areas for
five seconds, then STOP.

Only the parts that serve that one behaviour are taken. WinClose's speed and
time arming, configurable delay, warning beep, per-window modes and position
reads are all absent — the target car is a Comfort trim whose motors carry no
position sensor, so a close can be neither verified nor cancelled.

The pulse, the door edge detector and the eligibility policy are pure classes
with unit tests. STOP is attempted from a finally block on every exit, including
an interrupted sleep, a refused write and a sender that throws, because a pulse
that stops arriving leaves the motors wherever they were.

Guards worth naming, several of them learned from reading WinClose rather than
from the port itself:

- A wake lock spans the pulse. This fires as the driver leaves, which is exactly
  when the head unit suspends; without it the glass can stop halfway with no
  STOP sent.
- A fresh listener registration replays the door's current state. That replay
  seeds the edge detector instead of triggering it, or a binder reconnect while
  the door stands open would close the windows on someone halfway out.
- WinClose's 60-second cooldown, so reaching back into the car does not run a
  second pulse.
- The service stops itself on a non-SWI69 generation, and the switch is disabled
  unless the process holds system uid — only the unstable flavor declares
  android.uid.system, so a stable build could otherwise offer a toggle whose
  every command would fail.

This is the project's first write to the vehicle. README, SECURITY, AGENTS,
CONTRIBUTING and DISCLAIMER all claimed the app never writes; that claim is
retracted and scoped rather than quietly left standing.

Untested on a car. The feature is off by default.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-25 14:00:10 +03:00

42 lines
2.3 KiB
Markdown

# Disclaimer — no warranty, no liability
**Use this software entirely at your own risk.**
This project is provided **"as is"**, without warranty of any kind, express or implied,
including but not limited to the warranties of merchantability, fitness for a particular
purpose and non-infringement. In no event shall the authors or contributors be liable for
any claim, damages or other liability, whether in an action of contract, tort or
otherwise, arising from, out of or in connection with the software or its use.
## What that means concretely
- The app runs on a **vehicle**. Installing third-party software on a car is your
decision and your responsibility, including any effect on the head unit's stability,
your warranty, your insurance, or your vehicle's roadworthiness.
- **Do not operate the app while driving.** Configure it parked. Nothing in it should
require attention on the move, and looking at a screen instead of the road is on you.
- Telemetry may be **wrong, delayed or missing**. Never rely on it for range or charging
decisions where being wrong matters — check the car's own instruments.
- The **unstable channel is untested on vehicles** by definition. It builds automatically
from `main`; its OTA trigger is suspended during the suite safety and legal audit.
- Vehicle data is uploaded to **A Better Route Planner**, a third-party service governed
by its own terms and privacy policy. This project has no control over what happens to
data once sent.
- Reading vehicle properties uses **undocumented runtime interfaces**. They can change or
disappear with any firmware update.
- Optional WinClose automation sends window-closing commands. Sensorless Comfort windows
cannot confirm completion; command timing and motor/anti-pinch behavior have not been
verified on this vehicle. Check physical operation while parked before relying on it.
## Not affiliated
This project is **not affiliated with, endorsed by, or supported by** SAIC Motor, MG
Motor, Iternio (A Better Route Planner), or Google. MG, MG4 and related names and logos are
trademarks of their respective owners. They are used solely to identify compatibility with
certain vehicles; no official origin, certification or approval is claimed.
## Contributors
Contributors provide their work on the same terms: no warranty, and no liability for how
anyone uses it.