ha-vmoto-super-soco

KO | EN

gitlite — search

#python #hacktoberfest #ai #go #machine-learning #deep-learning #macos #awesome #kubernetes #pytorch #security #mcp #openai #open-source

ha-vmoto-super-soco

(★ 18)

Custom component for integrating your Super Soco or Vmoto Soco motorcycle into Home Assistant. It provides meaningful data like power status, battery percentage, location and a lot more.

ha-vmoto-super-soco 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Vmoto / Super Soco Home Assistant Integration

[![hacs][hacsbadge]][hacs] [![GitHub Release][releases-shield]][releases] [![GitHub Activity][commits-shield]][commits]

[![License][license-shield]][license] [![Project Maintenance][maintenance-shield]][user_profile]

Custom component for integrating your Vmoto or Super Soco motorcycle into Home Assistant. It provides meaningful data like power status, battery percentage, location and a lot more.

![Example][img-example]

## Disclaimers

> This integration is based on the Vmoto API, so it needs a combination of official ECU and active SIM contract that's currently working and sending data to Vmoto servers. If this is not your case then sadly there's little to no chance that this integration will work for you. To put it simple: if your mobile app is not working, this won't work either.

> Please note that Vmoto do not allow more than one client at a time, so any open session in the official app will be closed when using this integration (same as if you'd log in from a new device).

> This integration is not officially a part of Vmoto or Super Soco. Additionally, this is NOT endorsed by Vmoto or Super Soco in any way. Vmoto and Super Soco are trademarks of Vmoto Limited.

## Installation

You can install this either using [HACS][hacs] (recommended way) or manually copying files:

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find `configuration.yaml`).
2. If you do not have a `custom_components` directory (folder) there, you need to create it.
3. In the `custom_components` directory (folder) create a new folder called `super_soco_custom`.
4. Download _all_ the files from the `custom_components/super_soco_custom/` directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant

## Configuration

Configuration is done in the UI; go to "Configuration" -> "Integrations" click "+ Add Integration" and search for "Vmoto & Super Soco", then select the login method and enter your login credentials as you would do in the official app:

![Setup][img-setup]

If no vehicle is detected for your account after login, the integration will ask you to enter your vehicle's **IMEI** to bind it before completing the setup.

You can configure some extra options by clicking on "Configure" once the integration is up and running:

![Config][img-config]

The options menu also lets you **unbind the vehicle** from your account. Doing so will remove the integration, since it cannot function without a bound vehicle. To use the integration again with a new vehicle, simply add it again.

## Supported entities

- Power switch
- Battery percentage
- Estimated range
- ECU battery percentage
- Current speed
- Current location\* (device tracker)
- Current location via reverse geocoding\* (from [Open Street Map][openstreetmap], disabled by default)
- Current altitude (from [Open Topo Data][opentopodata])
- Current course in degrees
- Current course in 8-point wind rose
- Current distance from home\* with direction of travel (stationary/towards/away from/arrived)
- Current trip distance
- Current GSM signal strength\*
- Current GPS accuracy\*
- Last GPS fix time
- Last warning time\* with title and content
- Last trip time*, distance* and average speed\* (requires native tracking history to be enabled; updates every 10 minutes at most)
- Image URL for the vehicle
- Vehicle IMEI
- Vehicle VIN (frame number)
- Switches to enable/disable native tracking history and push notifications

_\* These entities include extra attributes with more details._

## Known limitations

- Only one vehicle can be seen by this integration (I'm not lucky enough to own two motorcycles, so I don't know how would that look in the API responses)
- Vehicle diagnose can't be initiated from this integration, nor the resulting report be shown in HA
- Vehicle model seen by this integration may not match the actual model (the same issue happens in the official app if your ECU has been replaced with another one intended for a different model)
- ECU may always report a voltage level equal to zero (and hence zero battery percentage); the cause remains unknown

## Roadmap

- [ ] Add altitude and reverse geocoding cache
- [ ] Allow speed threshold customization (this is used to filter out unwanted GPS noise when the vehicle is virtually still)
- [ ] Allow update interval customization while the vehicle is powered on (instead of forcing a 5 seconds interval)
- [ ] Add vehicle diagnosis
- [ ] Add detailed battery information

## Contributions are welcome!

If you want to contribute to this project please read the [Contribution guidelines](CONTRIBUTING.md)

## Special thanks

- Members of the [Super Soco - Spain][telegram] Telegram group who helped me testing this. Such nice and patient folks!
- [Home Assistant][homeassistant], [HACS][hacs], [Integration Blueprint][blueprint], [Open Street Map][openstreetmap], [Open Topo Data][opentopodata] and many more for providing the software and APIs this is built upon: "If I have seen further, it is by standing on the shoulders of Giants." - Isaac Newton

[blueprint]: https://github.com/custom-components/integration_blueprint
[commits-shield]: https://img.shields.io/github/commit-activity/y/drakhart/ha-super-soco-custom.svg?style=for-the-badge
[commits]: https://github.com/drakhart/ha-super-soco-custom/commits/main
[hacs]: https://hacs.xyz
[hacsbadge]: https://img.shields.io/badge/HACS-Default-orange?style=for-the-badge
[homeassistant]: https://www.home-assistant.io/
[img-config]: https://raw.githubusercontent.com/drakhart/ha-super-soco-custom/main/images/config.png
[img-example]: https://raw.githubusercontent.com/drakhart/ha-super-soco-custom/main/images/example.png
[img-setup]: https://raw.githubusercontent.com/drakhart/ha-super-soco-custom/main/images/setup.png
[license-shield]: https://img.shields.io/github/license/drakhart/ha-super-soco-custom.svg?style=for-the-badge
[license]: https://github.com/drakhart/ha-super-soco-custom/blob/main/LICENSE
[maintenance-shield]: https://img.shields.io/badge/maintainer-Brian%20Baidal%20%40drakhart-red.svg?style=for-the-badge
[openstreetmap]: https://www.openstreetmap.org/
[opentopodata]: https://www.opentopodata.org/
[releases-shield]: https://img.shields.io/github/v/release/drakhart/ha-super-soco-custom.svg?style=for-the-badge&color=yellowgreen&sort=semver&include_prereleases
[releases]: https://github.com/drakhart/ha-super-soco-custom/releases
[telegram]: https://t.me/supersocospain
[user_profile]: https://github.com/drakhart

ha-vmoto-super-soco

ha-vmoto-super-soco 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ha-vmoto-super-soco

ha-vmoto-super-soco 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README