Verification Request: homebridge-volvo-xc90

[sunil-zacharia]

Basic Details

Plugin Name: homebridge-volvo-xc90

Link To GitHub Repo: https://github.com/Codzelerate/homebridge-volvo-xc90

npm: https://www.npmjs.com/package/homebridge-volvo-xc90

---

Verification Requirements

General

The plugin does not offer the same nor less functionality than that of any existing verified plugin.
🟢 Yes

The only other Volvo-related plugin on npm (homebridge-volvo) targets an older Volvo On Call API that was deprecated and is no longer functional. Our plugin is built specifically for the 2016 Volvo XC90 (Sensus) using the current Volvo Connected Vehicle API v2 and Energy API v2, with support for the T8 PHEV's EV battery and charging state — functionality that does not exist in any verified plugin.

---

Environment

The plugin successfully installs and does not start unless it is configured.
🟢 Yes — the plugin requires vccApiKey and vin at minimum. Without these it logs a clear error and exits the auth flow without registering any accessories.

The plugin does not require the user to run Homebridge in a TTY or with non-standard startup parameters, even for initial configuration.
🟢 Yes — all setup (including the OTP authentication flow) is handled through the standard Homebridge Config UI X settings page.

---

Codebase

The plugin does not contain any analytics or calls that enable you to track the user.
🟢 Yes — no analytics, telemetry, or third-party tracking of any kind.

If the plugin needs to write files to disk (cache, keys, etc.), it stores them inside the Homebridge storage directory.
🟢 Yes — the refresh token and auth flow state are persisted to hbApi.user.storagePath() (homebridge-volvo-xc90.json), the correct Homebridge storage path.

The plugin does not throw unhandled exceptions, the plugin must catch and log its own errors.
🟢 Yes — all API calls are wrapped in try/catch blocks. Errors are logged via platform.log.warn or platform.log.error and polling continues uninterrupted.

---

More Information

homebridge-volvo-xc90 integrates a 2016 Volvo XC90 (Sensus infotainment, with built-in cellular) into Apple HomeKit. It uses Volvo's current PingFederate-based OTP authentication and the Connected Vehicle API v2 + Energy API v2.

Accessories:

• Volvo Lock — lock/unlock via LockMechanism
• Volvo Controls — three-switch tile: Climate pre-conditioning, Honk & Flash (momentary), Remote Start
• Volvo Doors — ContactSensor summary tile + 6 individual door/hood/tailgate sensors
• Volvo Energy — Battery service (EV charge %, charging state, low-charge alert) + HumiditySensor (petrol tank %)

Plugin type: dynamicPlatform
Homebridge Config UI X schema: full fieldsets with descriptions and defaults
GitHub Releases: automated via GitHub Actions on every version tag with changelog notes
Node.js: ≥18 (tested on v18 and v20)