Add name methods

Author: Bre77

tesla_fleet_api/tesla/vehicle/bluetooth.py

@@ -65,6 +65,8 @@
 WRITE_UUID = "00000212-b2d1-43f0-9b88-960cebf8b91e"
 READ_UUID = "00000213-b2d1-43f0-9b88-960cebf8b91e"
 VERSION_UUID = "00000214-b2d1-43f0-9b88-960cebf8b91e"
+NAME_UUID = "00002a00-0000-1000-8000-00805f9b34fb"
+APPEARANCE_UUID = "00002a01-0000-1000-8000-00805f9b34fb"
 
 if TYPE_CHECKING:
     from tesla_fleet_api.tesla.tesla import Tesla
@@ -216,6 +218,39 @@ async def _send(self, msg: RoutableMessage, requires: str, timeout: int = 2) ->
                     if resp.HasField(requires):
                         return resp
 
+    async def query_name(self, strip_key=True):
+        """Read the device name via GATT characteristic if available"""
+        try:
+            # Standard GATT Device Name characteristic (0x2A00)
+            device_name = await self.client.read_gatt_char(NAME_UUID)
+            device_name = device_name.decode('utf-8')
+            if(strip_key):
+                device_name = device_name.replace("🔑 ","")
+            return device_name
+        except Exception as e:
+            LOGGER.error(f"Failed to read device name: {e}")
+            return None
+
+    async def query_appearance(self) -> bytearray:
+        """Read the device appearance via GATT characteristic if available"""
+        try:
+            # Standard GATT Appearance characteristic (0x2A01)
+            return await self.client.read_gatt_char(APPEARANCE_UUID)
+        except Exception as e:
+            LOGGER.error(f"Failed to read device appearance: {e}")
+            return None
+
+    async def query_version(self) -> int | None:
+        """Read the device version via GATT characteristic if available"""
+        try:
+            # Custom GATT Version characteristic (0x2A02)
+            device_version = await self.client.read_gatt_char(VERSION_UUID)
+            # Convert the bytes to an integer
+            if device_version and len(device_version) > 0:
+                return int.from_bytes(device_version, byteorder='big')
+        except Exception as e:
+            LOGGER.error(f"Failed to read device version: {e}")
+        return None
 
     async def pair(self, role: Role = Role.ROLE_OWNER, form: KeyFormFactor = KeyFormFactor.KEY_FORM_FACTOR_CLOUD_KEY, timeout: int = 60):
         """Pair the key."""

tesla_fleet_api/tesla/vehicle/vehicle.py

@@ -18,9 +18,11 @@ class Vehicle:
     """Base class describing a Tesla vehicle."""
 
     vin: str
+    parent: Tesla
 
     def __init__(self, parent: Tesla, vin: str):
         self.vin = vin
+        self.parent = parent
 
     @property
     def pre2021(self) -> bool:

tesla_fleet_api/tesla/vehicle/vehicles.py

@@ -1,12 +1,15 @@
 from __future__ import annotations
 from typing import TYPE_CHECKING
+from bleak import BleakClient
 from bleak.backends.device import BLEDevice
+from bleak_retry_connector import establish_connection
 from cryptography.hazmat.primitives.asymmetric import ec
 
 from tesla_fleet_api.tesla.vehicle.signed import VehicleSigned
-from tesla_fleet_api.tesla.vehicle.bluetooth import VehicleBluetooth
+from tesla_fleet_api.tesla.vehicle.bluetooth import NAME_UUID, VehicleBluetooth
 from tesla_fleet_api.tesla.vehicle.fleet import VehicleFleet
 from tesla_fleet_api.tesla.vehicle.vehicle import Vehicle
+from tesla_fleet_api.const import LOGGER
 
 if TYPE_CHECKING:
     from tesla_fleet_api.tesla.fleet import TeslaFleetApi
@@ -69,3 +72,19 @@ def createBluetooth(self, vin: str, key: ec.EllipticCurvePrivateKey | None = Non
         vehicle = self.Bluetooth(self._parent, vin, key, device)
         self[vin] = vehicle
         return vehicle
+
+    async def query_device_name(self, device: BLEDevice, max_attempts=3) -> str:
+        """Queries the name of a bluetooth vehicle."""
+        async with await establish_connection(
+            BleakClient,
+            device,
+            device.name or "Unknown",
+            max_attempts=max_attempts
+        ) as client:
+            try:
+                # Standard GATT Device Name characteristic (0x2A00)
+                device_name = await client.read_gatt_char(NAME_UUID)
+                return device_name.decode('utf-8').replace("🔑 ","")
+            except Exception as e:
+                LOGGER.error(f"Failed to read device name: {e}")
+                return None