hyundai-kia-connect-api 3.17.6__py2.py3-none-any.whl → 3.32.0__py2.py3-none-any.whl

hyundai_kia_connect_api/VehicleManager.py

@@ -8,9 +8,14 @@ import logging
 import pytz
 
 from .exceptions import APIError
-from .ApiImpl import ApiImpl, ClimateRequestOptions, WindowRequestOptions
-from .HyundaiBlueLinkAPIUSA import HyundaiBlueLinkAPIUSA
-from .KiaUvoAPIUSA import KiaUvoAPIUSA
+from .ApiImpl import (
+    ApiImpl,
+    ClimateRequestOptions,
+    WindowRequestOptions,
+    ScheduleChargingClimateRequestOptions,
+)
+from .HyundaiBlueLinkApiUSA import HyundaiBlueLinkApiUSA
+from .KiaUvoApiUSA import KiaUvoApiUSA
 from .KiaUvoApiCA import KiaUvoApiCA
 from .KiaUvoApiEU import KiaUvoApiEU
 from .KiaUvoApiCN import KiaUvoApiCN
@@ -32,6 +37,7 @@ from .const import (
     VEHICLE_LOCK_ACTION,
     CHARGE_PORT_ACTION,
     OrderStatus,
+    VALET_MODE_ACTION,
 )
 
 _LOGGER = logging.getLogger(__name__)
@@ -91,23 +97,28 @@ class VehicleManager:
             _LOGGER.debug(f"{DOMAIN} - Vehicle Disabled, skipping.")
 
     def check_and_force_update_vehicles(self, force_refresh_interval: int) -> None:
+        for vehicle_id in self.vehicles.keys():
+            self.check_and_force_update_vehicle(force_refresh_interval, vehicle_id)
+
+    def check_and_force_update_vehicle(
+        self, force_refresh_interval: int, vehicle_id: str
+    ) -> None:
         # Force refresh only if current data is older than the value bassed in seconds.
         # Otherwise runs a cached update.
         started_at_utc: dt = dt.datetime.now(pytz.utc)
-        for vehicle_id in self.vehicles.keys():
-            vehicle = self.get_vehicle(vehicle_id)
-            if vehicle.last_updated_at is not None:
-                _LOGGER.debug(
-                    f"{DOMAIN} - Time differential in seconds: {(started_at_utc - vehicle.last_updated_at).total_seconds()}"  # noqa
-                )
-                if (
-                    started_at_utc - vehicle.last_updated_at
-                ).total_seconds() > force_refresh_interval:
-                    self.force_refresh_vehicle_state(vehicle_id)
-                else:
-                    self.update_vehicle_with_cached_state(vehicle_id)
+        vehicle = self.get_vehicle(vehicle_id)
+        if vehicle.last_updated_at is not None:
+            _LOGGER.debug(
+                f"{DOMAIN} - Time differential in seconds: {(started_at_utc - vehicle.last_updated_at).total_seconds()}"  # noqa
+            )
+            if (
+                started_at_utc - vehicle.last_updated_at
+            ).total_seconds() > force_refresh_interval:
+                self.force_refresh_vehicle_state(vehicle_id)
             else:
                 self.update_vehicle_with_cached_state(vehicle_id)
+        else:
+            self.update_vehicle_with_cached_state(vehicle_id)
 
     def force_refresh_all_vehicles_states(self) -> None:
         for vehicle_id in self.vehicles.keys():
@@ -155,11 +166,24 @@ class VehicleManager:
     def stop_charge(self, vehicle_id: str) -> str:
         return self.api.stop_charge(self.token, self.get_vehicle(vehicle_id))
 
+    def start_hazard_lights(self, vehicle_id: str) -> str:
+        return self.api.start_hazard_lights(self.token, self.get_vehicle(vehicle_id))
+
+    def start_hazard_lights_and_horn(self, vehicle_id: str) -> str:
+        return self.api.start_hazard_lights_and_horn(
+            self.token, self.get_vehicle(vehicle_id)
+        )
+
     def set_charge_limits(self, vehicle_id: str, ac: int, dc: int) -> str:
         return self.api.set_charge_limits(
             self.token, self.get_vehicle(vehicle_id), ac, dc
         )
 
+    def set_charging_current(self, vehicle_id: str, level: int) -> str:
+        return self.api.set_charging_current(
+            self.token, self.get_vehicle(vehicle_id), level
+        )
+
     def set_windows_state(self, vehicle_id: str, options: WindowRequestOptions) -> str:
         return self.api.set_windows_state(
             self.token, self.get_vehicle(vehicle_id), options
@@ -209,7 +233,7 @@ class VehicleManager:
 
     def update_month_trip_info(self, vehicle_id: str, yyyymm_string: str) -> None:
         """
-        Europe feature only.
+        feature only available for some regions.
         Updates the vehicle.month_trip_info for the specified month.
 
         Default this information is None:
@@ -221,7 +245,7 @@ class VehicleManager:
 
     def update_day_trip_info(self, vehicle_id: str, yyyymmdd_string: str) -> None:
         """
-        Europe feature only.
+        feature only available for some regions.
         Updates the vehicle.day_trip_info information for the specified day.
 
         Default this information is None:
@@ -237,6 +261,23 @@ class VehicleManager:
     def enable_vehicle(self, vehicle_id: str) -> None:
         self.get_vehicle(vehicle_id).enabled = True
 
+    def schedule_charging_and_climate(
+        self, vehicle_id: str, options: ScheduleChargingClimateRequestOptions
+    ) -> str:
+        return self.api.schedule_charging_and_climate(
+            self.token, self.get_vehicle(vehicle_id), options
+        )
+
+    def start_valet_mode(self, vehicle_id: str) -> str:
+        return self.api.valet_mode_action(
+            self.token, self.get_vehicle(vehicle_id), VALET_MODE_ACTION.ACTIVATE
+        )
+
+    def stop_valet_mode(self, vehicle_id: str) -> str:
+        return self.api.valet_mode_action(
+            self.token, self.get_vehicle(vehicle_id), VALET_MODE_ACTION.DEACTIVATE
+        )
+
     @staticmethod
     def get_implementation_by_region_brand(
         region: int, brand: int, language: str
@@ -248,9 +289,9 @@ class VehicleManager:
         elif REGIONS[region] == REGION_USA and (
             BRANDS[brand] == BRAND_HYUNDAI or BRANDS[brand] == BRAND_GENESIS
         ):
-            return HyundaiBlueLinkAPIUSA(region, brand, language)
+            return HyundaiBlueLinkApiUSA(region, brand, language)
         elif REGIONS[region] == REGION_USA and BRANDS[brand] == BRAND_KIA:
-            return KiaUvoAPIUSA(region, brand, language)
+            return KiaUvoApiUSA(region, brand, language)
         elif REGIONS[region] == REGION_CHINA:
             return KiaUvoApiCN(region, brand, language)
         elif REGIONS[region] == REGION_AUSTRALIA:

hyundai_kia_connect_api/__init__.py

@@ -1,12 +1,11 @@
 """Top-level package for Hyundai / Kia Connect."""
 
 # flake8: noqa
-from .ApiImpl import ApiImpl, ClimateRequestOptions, WindowRequestOptions
-from .HyundaiBlueLinkAPIUSA import HyundaiBlueLinkAPIUSA
-from .KiaUvoApiCA import KiaUvoApiCA
-from .KiaUvoApiEU import KiaUvoApiEU
-from .KiaUvoAPIUSA import KiaUvoAPIUSA
-from .KiaUvoApiCN import KiaUvoApiCN
+from .ApiImpl import (
+    ClimateRequestOptions,
+    WindowRequestOptions,
+    ScheduleChargingClimateRequestOptions,
+)
 
 from .Token import Token
 from .Vehicle import Vehicle

hyundai_kia_connect_api/bluelink.py

@@ -0,0 +1,457 @@
+#!/usr/bin/env python3
+
+"""Connects to the Bluelink API and query the vehicle."""
+
+import argparse
+import datetime
+import json
+import logging
+import os
+import sys
+import textwrap
+
+import hyundai_kia_connect_api
+from hyundai_kia_connect_api import const
+
+
+def print_vehicle(vehicle):
+    print("Identification")
+    print("  id:", vehicle.id)
+    print("  name:", vehicle.name)
+    print("  model:", vehicle.model)
+    print("  registration_date:", vehicle.registration_date)
+    print("  year:", vehicle.year)
+    print("  VIN:", vehicle.VIN)
+    print("  key:", vehicle.key)
+    print("General")
+    print("  engine_type:", vehicle.engine_type)
+    print("  ccu_ccs2_protocol_support:", vehicle.ccu_ccs2_protocol_support)
+    print(
+        "  total_driving_range:",
+        vehicle.total_driving_range,
+        vehicle.total_driving_range_unit,
+    )
+    print("  odometer:", vehicle.odometer, vehicle.odometer_unit)
+    print("  geocode:", vehicle.geocode)
+    print("  car_battery_percentage:", vehicle.car_battery_percentage)
+    print("  engine_is_running:", vehicle.engine_is_running)
+    print("  last_updated_at:", vehicle.last_updated_at)
+    print("  timezone:", vehicle.timezone)
+    print("  dtc_count:", vehicle.dtc_count)
+    print("  dtc_descriptions:", vehicle.dtc_descriptions)
+    print("  smart_key_battery_warning_is_on:", vehicle.smart_key_battery_warning_is_on)
+    print("  washer_fluid_warning_is_on:", vehicle.washer_fluid_warning_is_on)
+    print("  brake_fluid_warning_is_on:", vehicle.brake_fluid_warning_is_on)
+    print("Climate")
+    print("  air_temperature:", vehicle.air_temperature, vehicle._air_temperature_unit)
+    print("  air_control_is_on:", vehicle.air_control_is_on)
+    print("  defrost_is_on:", vehicle.defrost_is_on)
+    print("  steering_wheel_heater_is_on:", vehicle.steering_wheel_heater_is_on)
+    print("  back_window_heater_is_on:", vehicle.back_window_heater_is_on)
+    print("  side_mirror_heater_is_on:", vehicle.side_mirror_heater_is_on)
+    print("  front_left_seat_status:", vehicle.front_left_seat_status)
+    print("  front_right_seat_status:", vehicle.front_right_seat_status)
+    print("  rear_left_seat_status:", vehicle.rear_left_seat_status)
+    print("  rear_right_seat_status:", vehicle.rear_right_seat_status)
+    print("Doors")
+    print("  is_locked:", vehicle.is_locked)
+    print("  front_left_door_is_open:", vehicle.front_left_door_is_open)
+    print("  front_right_door_is_open:", vehicle.front_right_door_is_open)
+    print("  back_left_door_is_open:", vehicle.back_left_door_is_open)
+    print("  back_right_door_is_open:", vehicle.back_right_door_is_open)
+    print("  trunk_is_open:", vehicle.trunk_is_open)
+    print("  hood_is_open:", vehicle.hood_is_open)
+    print("Windows")
+    print("  front_left_window_is_open:", vehicle.front_left_window_is_open)
+    print("  front_right_window_is_open:", vehicle.front_right_window_is_open)
+    print("  back_left_window_is_open:", vehicle.back_left_window_is_open)
+    print("  back_right_window_is_open:", vehicle.back_right_window_is_open)
+    print("Tire Pressure")
+    print("  tire_pressure_all_warning_is_on:", vehicle.tire_pressure_all_warning_is_on)
+    print(
+        "  tire_pressure_rear_left_warning_is_on:",
+        vehicle.tire_pressure_rear_left_warning_is_on,
+    )
+    print(
+        "  tire_pressure_front_left_warning_is_on:",
+        vehicle.tire_pressure_front_left_warning_is_on,
+    )
+    print(
+        "  tire_pressure_front_right_warning_is_on:",
+        vehicle.tire_pressure_front_right_warning_is_on,
+    )
+    print(
+        "  tire_pressure_rear_right_warning_is_on:",
+        vehicle.tire_pressure_rear_right_warning_is_on,
+    )
+    print("Service")
+    print(
+        "  next_service_distance:",
+        vehicle.next_service_distance,
+        vehicle._next_service_distance_unit,
+    )
+    print(
+        "  last_service_distance:",
+        vehicle.last_service_distance,
+        vehicle._last_service_distance_unit,
+    )
+    print("Location")
+    print("  location:", vehicle.location)
+    print("  location_last_updated_at:", vehicle.location_last_updated_at)
+    print("EV/PHEV")
+    print("  charge_port_door_is_open:", vehicle.ev_charge_port_door_is_open)
+    print("  charging_power:", vehicle.ev_charging_power)
+    print("  charge_limits_dc:", vehicle.ev_charge_limits_dc)
+    print("  charge_limits_ac:", vehicle.ev_charge_limits_ac)
+    print("  charging_current:", vehicle.ev_charging_current)
+    print("  v2l_discharge_limit:", vehicle.ev_v2l_discharge_limit)
+    print("  total_power_consumed:", vehicle.total_power_consumed, "Wh")
+    print("  total_power_regenerated:", vehicle.total_power_regenerated, "Wh")
+    print("  power_consumption_30d:", vehicle.power_consumption_30d, "Wh")
+    print("  battery_percentage:", vehicle.ev_battery_percentage)
+    print("  battery_soh_percentage:", vehicle.ev_battery_soh_percentage)
+    print("  battery_remain:", vehicle.ev_battery_remain)
+    print("  battery_capacity:", vehicle.ev_battery_capacity)
+    print("  battery_is_charging:", vehicle.ev_battery_is_charging)
+    print("  battery_is_plugged_in:", vehicle.ev_battery_is_plugged_in)
+    print("  driving_range:", vehicle.ev_driving_range, vehicle._ev_driving_range_unit)
+    print(
+        "  estimated_current_charge_duration:",
+        vehicle.ev_estimated_current_charge_duration,
+        vehicle._ev_estimated_current_charge_duration_unit,
+    )
+    print(
+        "  estimated_fast_charge_duration:",
+        vehicle.ev_estimated_fast_charge_duration,
+        vehicle._ev_estimated_fast_charge_duration_unit,
+    )
+    print(
+        "  estimated_portable_charge_duration:",
+        vehicle.ev_estimated_portable_charge_duration,
+        vehicle._ev_estimated_portable_charge_duration_unit,
+    )
+    print(
+        "  estimated_station_charge_duration:",
+        vehicle.ev_estimated_station_charge_duration,
+        vehicle._ev_estimated_station_charge_duration_unit,
+    )
+    print(
+        "  target_range_charge_AC:",
+        vehicle.ev_target_range_charge_AC,
+        vehicle._ev_target_range_charge_AC_unit,
+    )
+    print(
+        "  target_range_charge_DC:",
+        vehicle.ev_target_range_charge_DC,
+        vehicle._ev_target_range_charge_DC_unit,
+    )
+
+    print("  first_departure_enabled:", vehicle.ev_first_departure_enabled)
+    print(
+        "  first_departure_climate_temperature:",
+        vehicle.ev_first_departure_climate_temperature,
+        vehicle._ev_first_departure_climate_temperature_unit,
+    )
+    print("  first_departure_days:", vehicle.ev_first_departure_days)
+    print("  first_departure_time:", vehicle.ev_first_departure_time)
+    print(
+        "  first_departure_climate_enabled:", vehicle.ev_first_departure_climate_enabled
+    )
+    print(
+        "  first_departure_climate_defrost:", vehicle.ev_first_departure_climate_defrost
+    )
+    print("  second_departure_enabled:", vehicle.ev_second_departure_enabled)
+    print(
+        "  second_departure_climate_temperature:",
+        vehicle.ev_second_departure_climate_temperature,
+        vehicle._ev_second_departure_climate_temperature_unit,
+    )
+    print("  second_departure_days:", vehicle.ev_second_departure_days)
+    print("  second_departure_time:", vehicle.ev_second_departure_time)
+    print(
+        "  second_departure_climate_enabled:",
+        vehicle.ev_second_departure_climate_enabled,
+    )
+    print(
+        "  second_departure_climate_defrost:",
+        vehicle.ev_second_departure_climate_defrost,
+    )
+    print("  off_peak_start_time:", vehicle.ev_off_peak_start_time)
+    print("  off_peak_end_time:", vehicle.ev_off_peak_end_time)
+    print("  off_peak_charge_only_enabled:", vehicle.ev_off_peak_charge_only_enabled)
+    print("  schedule_charge_enabled:", vehicle.ev_schedule_charge_enabled)
+    print("PHEV/HEV/IC")
+    print(
+        "  fuel_driving_range:",
+        vehicle.fuel_driving_range,
+        vehicle._fuel_driving_range_unit,
+    )
+    print("  fuel_level:", vehicle.fuel_level)
+    print("  fuel_level_is_low:", vehicle.fuel_level_is_low)
+    print("Trips")
+    print("  daily_stats:", vehicle.daily_stats)
+    print("  month_trip_info:", vehicle.month_trip_info)
+    print("  day_trip_info:", vehicle.day_trip_info)
+    print("Debug")
+    print(textwrap.indent(json.dumps(vehicle.data, indent=2, sort_keys=True), " "))
+
+
+def vehicle_to_dict(vehicle):
+    return {
+        "identification": {
+            "id": vehicle.id,
+            "name": vehicle.name,
+            "model": vehicle.model,
+            "registration_date": vehicle.registration_date,
+            "year": vehicle.year,
+            "VIN": vehicle.VIN,
+            "key": vehicle.key,
+        },
+        "general": {
+            "engine_type": str(vehicle.engine_type),
+            "ccu_ccs2_protocol_support": vehicle.ccu_ccs2_protocol_support,
+            "total_driving_range": [
+                vehicle.total_driving_range,
+                vehicle.total_driving_range_unit,
+            ],
+            "odometer": [vehicle.odometer, vehicle.odometer_unit],
+            "geocode": vehicle.geocode,
+            "car_battery_percentage": vehicle.car_battery_percentage,
+            "engine_is_running": vehicle.engine_is_running,
+            "last_updated_at": vehicle.last_updated_at,
+            "timezone": vehicle.timezone,
+            "dtc_count": vehicle.dtc_count,
+            "dtc_descriptions": vehicle.dtc_descriptions,
+            "smart_key_battery_warning_is_on": vehicle.smart_key_battery_warning_is_on,
+            "washer_fluid_warning_is_on": vehicle.washer_fluid_warning_is_on,
+            "brake_fluid_warning_is_on": vehicle.brake_fluid_warning_is_on,
+        },
+        "climate": {
+            "air_temperature": [
+                vehicle.air_temperature,
+                vehicle._air_temperature_unit,
+            ],
+            "air_control_is_on": vehicle.air_control_is_on,
+            "defrost_is_on": vehicle.defrost_is_on,
+            "steering_wheel_heater_is_on": vehicle.steering_wheel_heater_is_on,
+            "back_window_heater_is_on": vehicle.back_window_heater_is_on,
+            "side_mirror_heater_is_on": vehicle.side_mirror_heater_is_on,
+            "front_left_seat_status": vehicle.front_left_seat_status,
+            "front_right_seat_status": vehicle.front_right_seat_status,
+            "rear_left_seat_status": vehicle.rear_left_seat_status,
+            "rear_right_seat_status": vehicle.rear_right_seat_status,
+        },
+        "doors": {
+            "is_locked": vehicle.is_locked,
+            "front_left_door_is_open": vehicle.front_left_door_is_open,
+            "front_right_door_is_open": vehicle.front_right_door_is_open,
+            "back_left_door_is_open": vehicle.back_left_door_is_open,
+            "back_right_door_is_open": vehicle.back_right_door_is_open,
+            "trunk_is_open": vehicle.trunk_is_open,
+            "hood_is_open": vehicle.hood_is_open,
+        },
+        "windows": {
+            "front_left_window_is_open": vehicle.front_left_window_is_open,
+            "front_right_window_is_open": vehicle.front_right_window_is_open,
+            "back_left_window_is_open": vehicle.back_left_window_is_open,
+            "back_right_window_is_open": vehicle.back_right_window_is_open,
+        },
+        "tires": {
+            "tire_pressure_all_warning_is_on": vehicle.tire_pressure_all_warning_is_on,
+            "tire_pressure_rear_left_warning_is_on": vehicle.tire_pressure_rear_left_warning_is_on,
+            "tire_pressure_front_left_warning_is_on": vehicle.tire_pressure_front_left_warning_is_on,
+            "tire_pressure_front_right_warning_is_on": vehicle.tire_pressure_front_right_warning_is_on,
+            "tire_pressure_rear_right_warning_is_on": vehicle.tire_pressure_rear_right_warning_is_on,
+        },
+        "service": {
+            "next_service_distance": [
+                vehicle.next_service_distance,
+                vehicle._next_service_distance_unit,
+            ],
+            "last_service_distance": [
+                vehicle.last_service_distance,
+                vehicle._last_service_distance_unit,
+            ],
+        },
+        "location": {
+            "location": vehicle.location,
+            "location_last_updated_at": vehicle.location_last_updated_at,
+        },
+        "electric": {
+            "charge_port_door_is_open": vehicle.ev_charge_port_door_is_open,
+            "charging_power": vehicle.ev_charging_power,
+            "charge_limits_dc": vehicle.ev_charge_limits_dc,
+            "charge_limits_ac": vehicle.ev_charge_limits_ac,
+            "charging_current": vehicle.ev_charging_current,
+            "v2l_discharge_limit": vehicle.ev_v2l_discharge_limit,
+            "total_power_consumed": [vehicle.total_power_consumed, "Wh"],
+            "total_power_regenerated": [vehicle.total_power_regenerated, "Wh"],
+            "power_consumption_30d": [vehicle.power_consumption_30d, "Wh"],
+            "battery_percentage": vehicle.ev_battery_percentage,
+            "battery_soh_percentage": vehicle.ev_battery_soh_percentage,
+            "battery_remain": vehicle.ev_battery_remain,
+            "battery_capacity": vehicle.ev_battery_capacity,
+            "battery_is_charging": vehicle.ev_battery_is_charging,
+            "battery_is_plugged_in": vehicle.ev_battery_is_plugged_in,
+            "driving_range": [
+                vehicle.ev_driving_range,
+                vehicle._ev_driving_range_unit,
+            ],
+            "estimated_current_charge_duration": [
+                vehicle.ev_estimated_current_charge_duration,
+                vehicle._ev_estimated_current_charge_duration_unit,
+            ],
+            "estimated_fast_charge_duration": [
+                vehicle.ev_estimated_fast_charge_duration,
+                vehicle._ev_estimated_fast_charge_duration_unit,
+            ],
+            "estimated_portable_charge_duration": [
+                vehicle.ev_estimated_portable_charge_duration,
+                vehicle._ev_estimated_portable_charge_duration_unit,
+            ],
+            "estimated_station_charge_duration": [
+                vehicle.ev_estimated_station_charge_duration,
+                vehicle._ev_estimated_station_charge_duration_unit,
+            ],
+            "target_range_charge_AC": [
+                vehicle.ev_target_range_charge_AC,
+                vehicle._ev_target_range_charge_AC_unit,
+            ],
+            "target_range_charge_DC": [
+                vehicle.ev_target_range_charge_DC,
+                vehicle._ev_target_range_charge_DC_unit,
+            ],
+            "first_departure_enabled": vehicle.ev_first_departure_enabled,
+            "first_departure_climate_temperature": [
+                vehicle.ev_first_departure_climate_temperature,
+                vehicle._ev_first_departure_climate_temperature_unit,
+            ],
+            "first_departure_days": vehicle.ev_first_departure_days,
+            "first_departure_time": vehicle.ev_first_departure_time,
+            "first_departure_climate_enabled": vehicle.ev_first_departure_climate_enabled,
+            "first_departure_climate_defrost": vehicle.ev_first_departure_climate_defrost,
+            "second_departure_enabled": vehicle.ev_second_departure_enabled,
+            "second_departure_climate_temperature": [
+                vehicle.ev_second_departure_climate_temperature,
+                vehicle._ev_second_departure_climate_temperature_unit,
+            ],
+            "second_departure_days": vehicle.ev_second_departure_days,
+            "second_departure_time": vehicle.ev_second_departure_time,
+            "second_departure_climate_enabled": vehicle.ev_second_departure_climate_enabled,
+            "second_departure_climate_defrost": vehicle.ev_second_departure_climate_defrost,
+            "off_peak_start_time": vehicle.ev_off_peak_start_time,
+            "off_peak_end_time": vehicle.ev_off_peak_end_time,
+            "off_peak_charge_only_enabled": vehicle.ev_off_peak_charge_only_enabled,
+            "schedule_charge_enabled": vehicle.ev_schedule_charge_enabled,
+        },
+        "ic": {
+            "fuel_driving_range": [
+                vehicle.fuel_driving_range,
+                vehicle._fuel_driving_range_unit,
+            ],
+            "fuel_level": vehicle.fuel_level,
+            "fuel_level_is_low": vehicle.fuel_level_is_low,
+        },
+        "trips": {
+            "daily_stats": vehicle.daily_stats,
+            "month_trip_info": vehicle.month_trip_info,
+            "day_trip_info": vehicle.day_trip_info,
+        },
+        "debug": vehicle.data,
+    }
+
+
+class DateTimeEncoder(json.JSONEncoder):
+    def default(self, obj):
+        if isinstance(obj, (datetime.date, datetime.datetime)):
+            return obj.isoformat()
+
+
+def cmd_info(vm, args):
+    for vehicle_id, vehicle in vm.vehicles.items():
+        print_vehicle(vehicle)
+    if args.json:
+        data = {id: vehicle_to_dict(v) for id, v in vm.vehicles.items()}
+        json.dump(data, args.json, separators=(",", ":"), cls=DateTimeEncoder)
+    return 0
+
+
+def main():
+    default_username = os.environ.get("BLUELINK_USERNAME", "")
+    default_password = os.environ.get("BLUELINK_PASSWORD", "")
+    default_pin = None
+    if os.environ.get("BLUELINK_PIN", ""):
+        try:
+            default_pin = int(os.environ["BLUELINK_PIN"])
+        except ValueError:
+            print("Invalid BLUELINK_PIN environment variable", file=sys.stderr)
+            return 1
+
+    parser = argparse.ArgumentParser(description=sys.modules[__name__].__doc__)
+    parser.add_argument(
+        "--region",
+        default=os.environ.get("BLUELINK_REGION", const.REGION_CANADA),
+        choices=sorted(const.REGIONS.values()),
+        help="Car's region, use env var BLUELINK_REGION",
+    )
+    parser.add_argument(
+        "--brand",
+        default=os.environ.get("BLUELINK_BRAND", const.BRAND_HYUNDAI),
+        choices=sorted(const.BRANDS.values()),
+        help="Car's brand, use env var BLUELINK_BRAND",
+    )
+    parser.add_argument(
+        "--username",
+        default=default_username,
+        help="Bluelink account username, use env var BLUELINK_USERNAME",
+        required=not default_username,
+    )
+    parser.add_argument(
+        "--password",
+        default=default_password,
+        help="Bluelink account password, use env var BLUELINK_PASSWORD",
+        required=not default_password,
+    )
+    parser.add_argument(
+        "--pin",
+        type=int,
+        default=default_pin,
+        help="Bluelink account pin, use env var BLUELINK_PIN",
+        required=not default_pin,
+    )
+    parser.add_argument("-v", "--verbose", action=argparse.BooleanOptionalAction)
+    subparsers = parser.add_subparsers(help="Commands", required=True)
+    parser_info = subparsers.add_parser(
+        "info", help="Prints infos about the cars found"
+    )
+    parser_info.set_defaults(func=cmd_info)
+    parser_info.add_argument(
+        "--json",
+        type=argparse.FileType("w", encoding="UTF-8"),
+        help="Save data to file as JSON",
+    )
+
+    args = parser.parse_args()
+    logging.basicConfig(level=logging.DEBUG if args.verbose else logging.ERROR)
+
+    # Reverse lookup.
+    region = [k for k, v in const.REGIONS.items() if v == args.region][0]
+    brand = [k for k, v in const.BRANDS.items() if v == args.brand][0]
+
+    vm = hyundai_kia_connect_api.VehicleManager(
+        region=region,
+        brand=brand,
+        username=args.username,
+        password=args.password,
+        pin=args.pin,
+        geocode_api_enable=True,
+        geocode_api_use_email=True,
+    )
+    # TODO: Cache token.
+    vm.check_and_refresh_token()
+    vm.update_all_vehicles_with_cached_state()
+    return args.func(vm, args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

hyundai_kia_connect_api/const.py

@@ -29,7 +29,13 @@ LOGIN_TOKEN_LIFETIME = datetime.timedelta(hours=23)
 
 LENGTH_KILOMETERS = "km"
 LENGTH_MILES = "mi"
-DISTANCE_UNITS = {None: None, 0: None, 1: LENGTH_KILOMETERS, 3: LENGTH_MILES}
+DISTANCE_UNITS = {
+    None: None,
+    0: None,
+    1: LENGTH_KILOMETERS,
+    2: LENGTH_MILES,
+    3: LENGTH_MILES,
+}
 
 TEMPERATURE_C = "°C"
 TEMPERATURE_F = "°F"
@@ -92,3 +98,8 @@ class WINDOW_STATE(IntEnum):
     CLOSED = 0
     OPEN = 1
     VENTILATION = 2
+
+
+class VALET_MODE_ACTION(Enum):
+    ACTIVATE = "activate"
+    DEACTIVATE = "deactivate"