Skip to content

Repository files navigation

GWM ORA

HACS Validation

⚠️ Disclaimer: This project is not affiliated with, endorsed by, or sponsored by GWM or ORA. It is a community-maintained integration provided as-is, without warranty of any kind. Use at your own risk.

Home Assistant integration for GWM ORA vehicles (Funky Cat, etc.).

Based on the original ora2mqtt by zivillian.

Features

  • Sensors: SOC, range, charging time, tire pressures & temperatures, odometer, interior temperature, and more
  • Binary sensors: A/C status, lock, windows, charge plug, air circulation, defroster
  • Device tracker: GPS location tracking
  • Auto token refresh: Seamless token management with proactive refresh
  • Privacy-aware logging: All sensitive data masked in logs
  • Configurable polling: 10–300 second interval via options UI

Installation

Via HACS

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Or add manually:

  1. Open Home Assistant → HACS → Integrations
  2. Click the three-dot menu → Add repository
  3. Enter https://github.com/FunCyRanger/ora2mqtt-python
  4. Search for "GWM ORA" and install
  5. Restart Home Assistant

Manual

  1. Copy the custom_components/ora directory to your HA custom_components folder
  2. Restart Home Assistant

Configuration

  1. Go to Settings → Devices & Services → Add Integration
  2. Search for "GWM ORA"
  3. Enter your GWM ORA app email and password
  4. If prompted, enter the verification code sent to your email
  5. Adjust polling interval if desired (default: 60 s)

Requirements

  • Home Assistant 2026.1+
  • HACS (recommended) or manual install
  • A GWM ORA account

Data Points

CodeSensorUnit
2011501Rangekm
2013021SOC%
2013022Charging Time Remainingmin
2013023SOC Target%
2041142Charging Active
2041301SOCE%
2078020Air Circulation
2101001–4Tire Pressure (FL/FR/RL/RR)kPa
2101005–8Tire Temperature (FL/FR/RL/RR)°C
2103010Odometerkm
2201001Interior Temperature°C
2202001A/C
2208001Lock
2210001–4Windows (FL/FR/RL/RR)
2222001Front Defroster
2042082Charge Plug

Development

uv sync # Install dependencies
pytest # Run all tests
pytest -m integration # Unit/integration tests
make lint # ruff check
make format # ruff format

See API.md for the GWM API reference and DEV_NOTES.md for architectural notes.

Contributing

Contributions welcome! Please open an issue or pull request on GitHub.

License

MIT

About

Home Assistant integration for GWM ORA vehicles (Funky Cat). Unofficial, community-maintained.

Topics

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages