NIO Open Telematics 0.1.1-dev.3

Development release focused on making installation and cross-vehicle testing easier while preparing the project for HACS default-repository submission.

What changed

• Added a prominent call for European NIO owners to test the integration and report which telemetry works for their car.
• Added and linked a dedicated, owner-friendly model and country compatibility discussion.
• Expanded the installation guide with exact custom-repository, download, restart, and Home Assistant setup steps.
• Added a one-click Open in HACS button.
• Added Home Assistant application-credentials guidance for the exact OAuth redirect URI.
• Added the public contribution policy and credited @lubbyhst for early cross-vehicle testing and feedback.
• Declared the currently documented European NIO markets in hacs.json for country-aware HACS discovery.

Important current limitation

OAuth, token refresh, current timestamps, vehicle state, and odometer work in live testing. NIO currently returns SoC as 0 or no record on the tested ET5 Touring and ET7, while several other documented endpoints return permission_denied. This is being investigated publicly and with NIO support.

Please share a quick result in Discussion #6. Never post credentials, tokens, a full VIN, or precise location data.

Validation

The release commit passed pytest, hassfest, and HACS repository validation.

NIO Open Telematics 0.1.1-dev.2

Development release improving setup guidance and project contribution handling.

Changes

• Document the exact Home Assistant OAuth redirect URI: https://my.home-assistant.io/redirect/oauth.
• Show that URI directly on Home Assistant’s application-credentials screen when entering the NIO Client ID and Client Secret.
• Add regression coverage for the callback guidance.
• Add public contribution guidelines covering issue-first coordination, testing, pull requests, and privacy.
• Keep the OAuth scope parameter deliberately omitted so NIO Personal Applications use their full default permitted scope set.

Current limitation

This remains an experimental development release. Live testing on an EU ET5 Touring and an independent ET7 still returns an incorrect SoC of 0. The upstream NIO API investigation remains open and NIO support feedback is pending.

Acknowledgement

Special thanks to @lubbyhst for early cross-vehicle testing, clear issue reports, proposed OAuth and documentation improvements, and sharing independent NIO API results.

See CHANGELOG.md for the maintained release history.

NIO Open Telematics 0.1.1-dev.1

Development release for the unofficial NIO Open Telematics Home Assistant integration.

Changes

• Adds one enabled diagnostic API availability sensor with an overall state of available, partial, or unavailable.
• Groups every endpoint into working, temporarily empty, permission-denied, or errored attributes, so users can decide which detailed sensors to enable.
• Adds each enabled detailed telemetry sensor's source endpoint and current endpoint status as attributes.
• Corrects odometer scaling: NIO's live mileage value is already kilometres and must not be divided by ten.
• Moves to an unambiguous SemVer prerelease sequence so HACS orders future development releases correctly.

Current API status

NIO authentication and vehicle status work. Several change feeds currently have no recent records, while most optional endpoint families remain permission-denied for the tested personal application. A detailed case is pending with NIO support. Anyone with faster access to NIO's API support team is welcome to help.

This is an independent, unofficial personal project created with substantial AI assistance and shared in case others find it useful. It is not affiliated with or endorsed by NIO.

NIO Open Telematics 0.1.0-dev9

Development release for the unofficial NIO Open Telematics Home Assistant integration.

Changes

• Fixes OAuth reauthorization started from Home Assistant Repairs by explicitly selecting the OAuth implementation stored on the existing config entry.
• Keeps the one-time scope-revision migration introduced in dev8.
• Publishes this development version through the normal GitHub release channel so HACS can expose its release notes.

Current API status

NIO authentication and basic vehicle dynamics work. Energy telemetry remains unavailable for the tested vehicle/application, and a detailed case is pending with NIO support. Anyone with faster access to NIO's API support team is welcome to help.

This is an independent, unofficial personal project created with substantial AI assistance and shared in case others find it useful. It is not affiliated with or endorsed by NIO.

NIO Open Telematics 0.1.0-dev10

Development release for the unofficial NIO Open Telematics Home Assistant integration.

Changes

• Omits the OAuth scope parameter so NIO grants the application's full permitted scope set using its documented default behavior.
• Avoids invalid_scope when an explicit combined scope list contains a permission unavailable to the application.
• Advances the permission-policy revision so existing installations receive the corrected native reauthentication prompt.
• Adds a regression check that prevents a scope parameter from being reintroduced.

Current API status

NIO authentication and basic vehicle dynamics work. Energy telemetry remains unavailable for the tested vehicle/application, and a detailed case is pending with NIO support. Anyone with faster access to NIO's API support team is welcome to help.

This is an independent, unofficial personal project created with substantial AI assistance and shared in case others find it useful. It is not affiliated with or endorsed by NIO.

NIO Open Telematics 0.1.0-dev8

Development release for the unofficial NIO Open Telematics Home Assistant integration.

Changes

• Records a revision for the requested NIO OAuth permission set.
• Existing installations receive Home Assistant's native reauthentication prompt once after the requested scopes expand.
• Completed reauthorization records the revision, preventing repeated prompts.
• Optional feeds that NIO still denies remain isolated as permission_denied.

Current API status

NIO authentication and basic vehicle dynamics work. Energy telemetry remains unavailable for the tested vehicle/application, and a detailed case is pending with NIO support. Anyone with faster access to NIO's API support team is welcome to help.

This is an independent, unofficial personal project created with substantial AI assistance and shared in case others find it useful. It is not affiliated with or endorsed by NIO.

NIO Open Telematics 0.1.0-dev7

Development release for the unofficial NIO Open Telematics Home Assistant integration.

Changes

• Optional NIO endpoints blocked by missing OAuth scopes now report permission_denied without breaking the entire integration setup.
• Required-scope failures continue to trigger Home Assistant's native reauthentication flow.
• Public documentation and changelog are updated.

Current API status

NIO authentication and basic vehicle dynamics work, but energy telemetry is still unavailable for the tested vehicle/application. A detailed case is pending with NIO support. Anyone with faster access to NIO's API support team is welcome to help.

This is an independent, unofficial personal project created with substantial AI assistance and shared in case others find it useful. It is not affiliated with or endorsed by NIO.