Overview
This node integrates with Hyundai and Kia vehicles via the BlueLinky library, allowing users to remotely access and control various vehicle functions. It supports operations such as listing vehicles linked to an account, retrieving vehicle status, location, and odometer readings, as well as locking/unlocking doors and starting/stopping the engine or climate control.
Common scenarios include:
- Fleet management: Monitoring multiple vehicles' statuses and locations.
- Remote vehicle control: Locking/unlocking or starting the engine/climate remotely for convenience or security.
- Data collection: Fetching odometer readings or vehicle health data for maintenance tracking.
Example use case:
- A user wants to check the current status of their Hyundai vehicle and then remotely start the climate control before arriving home.
Properties
| Name | Meaning |
|---|---|
| VIN | Optional Vehicle Identification Number to target a specific vehicle. If empty, vehicle index is used. |
| Vehicle Index | Index number of the vehicle to use when VIN is not provided (minimum 0). |
These properties are used to select which vehicle to operate on when multiple vehicles are associated with the account.
Output
The output is a JSON object containing the result of the selected operation:
- List Vehicles: An array of vehicles with fields like
vin,id, andnickname. - Get Vehicle Status: Detailed parsed status information about the vehicle or a full status if available.
- Get Location: Current GPS location data of the vehicle.
- Get Odometer: Odometer reading of the vehicle.
- Lock/Unlock: Confirmation of success in locking or unlocking the vehicle.
- Start Engine/Climate: Result of starting the engine or climate control with options.
- Stop Engine/Climate: Result of stopping the engine or climate control.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential with username, password, region, language, and optionally a PIN for authentication with the BlueLinky service.
- Uses the external
bluelinkylibrary to communicate with Hyundai/Kia vehicle services. - The node must be configured with valid BlueLinky credentials in n8n.
Troubleshooting
- Missing Credentials: The node will throw an error if BlueLinky credentials are not set up.
- No Vehicles Found: If the account has no vehicles linked, an error is thrown.
- Invalid VIN or Vehicle Index: Errors occur if the specified VIN does not match any vehicle or if the vehicle index is out of bounds.
- Unknown Operation: Selecting an unsupported operation results in an error.
- API or Network Issues: Failures during login or API calls may cause errors; ensure network connectivity and valid credentials.
To resolve these issues:
- Verify that BlueLinky credentials are correctly configured.
- Confirm the VIN or vehicle index corresponds to a vehicle in the account.
- Check network access and API availability.
Links and References
- BlueLinky GitHub Repository - Library used for interfacing with Hyundai/Kia vehicles.
- Hyundai Blue Link and Kia UVO official websites for understanding vehicle remote services.