tescmd 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

tescmd/telemetry/fields.py

@@ -1,6 +1,8 @@
 """Fleet Telemetry field name registry and preset configurations.
 
-Field IDs sourced from Tesla's ``vehicle_data.proto`` Field enum.
+Field IDs and names sourced from Tesla's ``vehicle_data.proto`` Field enum
+(https://github.com/teslamotors/fleet-telemetry/blob/main/protos/vehicle_data.proto).
+
 Presets define commonly-used field groups with appropriate polling
 intervals for different use cases.
 """
@@ -11,131 +13,299 @@ from tescmd.api.errors import ConfigError
 
 # ---------------------------------------------------------------------------
 # Field enum → human-readable name  (from vehicle_data.proto)
+#
+# IDs and names match the proto exactly.  Excluded:
+#   - Unknown (0)
+#   - Deprecated_1 (162), Deprecated_2 (100), Deprecated_3 (257)
+#   - Experimental_1-15 (119-122, 168-178)
 # ---------------------------------------------------------------------------
 
 FIELD_NAMES: dict[int, str] = {
-    1: "DriveState",
-    2: "ChargeState",
-    3: "Soc",
+    # --- Drive / Motion ---
+    1: "DriveRail",
     4: "VehicleSpeed",
     5: "Odometer",
-    6: "PackVoltage",
-    7: "PackCurrent",
-    8: "BatteryLevel",
-    9: "Location",
     10: "Gear",
-    11: "EstBatteryRange",
-    12: "IdealBatteryRange",
-    13: "RatedBatteryRange",
-    14: "ACChargingEnergyIn",
-    15: "ACChargingPower",
-    16: "DCChargingEnergyIn",
-    17: "DCChargingPower",
-    18: "ChargeCurrentRequest",
-    19: "ChargeCurrentRequestMax",
-    20: "ChargeLimitSoc",
-    21: "ChargePortDoorOpen",
-    22: "ChargePortLatch",
-    23: "ChargerActualCurrent",
-    24: "ChargerPhases",
-    25: "ChargerPilotCurrent",
-    26: "ChargerVoltage",
-    27: "FastChargerPresent",
-    28: "ScheduledChargingMode",
-    29: "ScheduledChargingPending",
-    30: "ScheduledChargingStartTime",
-    31: "ScheduledDepartureTime",
-    32: "TimeToFullCharge",
-    33: "InsideTemp",
-    34: "OutsideTemp",
-    35: "DriverTempSetting",
-    36: "PassengerTempSetting",
-    37: "IsClimateOn",
-    38: "FanStatus",
-    39: "LeftTempDirection",
-    40: "RightTempDirection",
-    41: "SeatHeaterLeft",
-    42: "SeatHeaterRight",
-    43: "SeatHeaterRearLeft",
-    44: "SeatHeaterRearCenter",
-    45: "SeatHeaterRearRight",
-    46: "SteeringWheelHeater",
-    47: "AutoSeatClimateLeft",
-    48: "AutoSeatClimateRight",
-    49: "CabinOverheatProtection",
-    50: "DefrostMode",
-    51: "Locked",
-    52: "SentryMode",
-    53: "CenterDisplay",
-    54: "ValetMode",
-    55: "RemoteStart",
-    56: "DoorState",
-    57: "WindowState",
-    58: "TrunkOpen",
-    59: "FrunkOpen",
-    60: "SoftwareVersion",
-    61: "TpmsPressureFl",
-    62: "TpmsPressureFr",
-    63: "TpmsPressureRl",
-    64: "TpmsPressureRr",
-    65: "DetailedChargeState",
-    66: "HomeLink",
-    67: "UserPresent",
-    68: "DashcamState",
-    69: "RearSeatHeaters",
-    70: "BatteryHeaterOn",
-    71: "NotEnoughPowerToHeat",
-    72: "BmsFullchargecomplete",
-    73: "ChargeEnablerequest",
-    74: "ChargerPhases2",
-    75: "EnergyRemaining",
-    76: "LifetimeEnergyUsed",
-    77: "LifetimeEnergyUsedDrive",
-    78: "BMSState",
-    79: "GuestModeEnabled",
-    80: "PreconditioningEnabled",
-    81: "ScheduledChargingStartTimeApp",
-    82: "TripCharging",
-    83: "ChargingCableType",
-    84: "RouteLastUpdated",
-    85: "RouteLine",
-    86: "MilesToArrival",
-    87: "MinutesToArrival",
-    88: "TrafficMinutesDelay",
-    89: "Elevation",
-    90: "Heading",
-    91: "PowerState",
-    92: "RatedRange",
-    93: "CruiseState",
-    94: "CruiseSetSpeed",
-    95: "LaneAssistLevel",
-    96: "AutopilotState",
-    97: "AutopilotHandsOnState",
-    98: "SpeedLimitMode",
-    99: "SpeedLimitWarning",
-    100: "MaxSpeedLimit",
-    101: "SunRoofPercentOpen",
-    102: "SunRoofState",
-    103: "TonneauPosition",
-    104: "TonneauState",
-    105: "WiperHeatEnabled",
+    12: "PedalPosition",
+    13: "BrakePedal",
+    21: "Location",
+    22: "GpsState",
+    23: "GpsHeading",
+    98: "LateralAcceleration",
+    99: "LongitudinalAcceleration",
+    101: "CruiseSetSpeed",
     106: "BrakePedalPos",
-    107: "PedalPosition",
-    108: "DriveRailAmps12v",
-    109: "BrickVoltageMax",
-    110: "BrickVoltageMin",
-    111: "ModuleTempMax",
-    112: "ModuleTempMin",
-    113: "NumBrickVoltageMax",
-    114: "NumBrickVoltageMin",
-    115: "NumModuleTempMax",
-    116: "NumModuleTempMin",
-    117: "ChargeAmps",
-    118: "FastChargerType",
-    119: "ConnChargeCable",
-    120: "Supercharger",
+    126: "CruiseFollowDistance",
+    129: "SpeedLimitWarning",
+    # --- Battery / Energy ---
+    6: "PackVoltage",
+    7: "PackCurrent",
+    8: "Soc",
+    9: "DCDCEnable",
+    11: "IsolationResistance",
+    24: "NumBrickVoltageMax",
+    25: "BrickVoltageMax",
+    26: "NumBrickVoltageMin",
+    27: "BrickVoltageMin",
+    28: "NumModuleTempMax",
+    29: "ModuleTempMax",
+    30: "NumModuleTempMin",
+    31: "ModuleTempMin",
+    32: "RatedRange",
+    33: "Hvil",
+    40: "EstBatteryRange",
+    41: "IdealBatteryRange",
+    42: "BatteryLevel",
+    55: "BatteryHeaterOn",
+    56: "NotEnoughPowerToHeat",
+    102: "LifetimeEnergyUsed",
+    103: "LifetimeEnergyUsedDrive",
+    134: "LifetimeEnergyGainedRegen",
+    158: "EnergyRemaining",
+    160: "BMSState",
+    # --- Charging ---
+    2: "ChargeState",
+    3: "BmsFullchargecomplete",
+    34: "DCChargingEnergyIn",
+    35: "DCChargingPower",
+    36: "ACChargingEnergyIn",
+    37: "ACChargingPower",
+    38: "ChargeLimitSoc",
+    39: "FastChargerPresent",
+    43: "TimeToFullCharge",
+    44: "ScheduledChargingStartTime",
+    45: "ScheduledChargingPending",
+    46: "ScheduledDepartureTime",
+    47: "PreconditioningEnabled",
+    48: "ScheduledChargingMode",
+    49: "ChargeAmps",
+    50: "ChargeEnableRequest",
+    51: "ChargerPhases",
+    52: "ChargePortColdWeatherMode",
+    53: "ChargeCurrentRequest",
+    54: "ChargeCurrentRequestMax",
+    57: "SuperchargerSessionTripPlanner",
+    117: "ChargePort",
+    118: "ChargePortLatch",
+    179: "DetailedChargeState",
+    183: "ChargePortDoorOpen",
+    184: "ChargerVoltage",
+    185: "ChargingCableType",
+    190: "EstimatedHoursToChargeTermination",
+    193: "FastChargerType",
+    256: "ChargeRateMilePerHour",
+    # --- Climate / HVAC ---
+    85: "InsideTemp",
+    86: "OutsideTemp",
+    87: "SeatHeaterLeft",
+    88: "SeatHeaterRight",
+    89: "SeatHeaterRearLeft",
+    90: "SeatHeaterRearRight",
+    91: "SeatHeaterRearCenter",
+    92: "AutoSeatClimateLeft",
+    93: "AutoSeatClimateRight",
+    186: "ClimateKeeperMode",
+    187: "DefrostForPreconditioning",
+    188: "DefrostMode",
+    196: "HvacACEnabled",
+    197: "HvacAutoMode",
+    198: "HvacFanSpeed",
+    199: "HvacFanStatus",
+    200: "HvacLeftTemperatureRequest",
+    201: "HvacPower",
+    202: "HvacRightTemperatureRequest",
+    203: "HvacSteeringWheelHeatAuto",
+    204: "HvacSteeringWheelHeatLevel",
+    211: "RearDisplayHvacEnabled",
+    237: "ClimateSeatCoolingFrontLeft",
+    238: "ClimateSeatCoolingFrontRight",
+    254: "SeatVentEnabled",
+    255: "RearDefrostEnabled",
+    180: "CabinOverheatProtectionMode",
+    181: "CabinOverheatProtectionTemperatureLimit",
+    # --- Security / Doors / Windows ---
+    58: "DoorState",
+    59: "Locked",
+    60: "FdWindow",
+    61: "FpWindow",
+    62: "RdWindow",
+    63: "RpWindow",
+    64: "VehicleName",
+    65: "SentryMode",
+    66: "SpeedLimitMode",
+    67: "CurrentLimitMph",
+    68: "Version",
+    94: "DriverSeatBelt",
+    95: "PassengerSeatBelt",
+    96: "DriverSeatOccupied",
+    123: "GuestModeEnabled",
+    124: "PinToDriveEnabled",
+    125: "PairedPhoneKeyAndKeyFobQty",
+    159: "ServiceMode",
+    161: "GuestModeMobileAccessState",
+    182: "CenterDisplay",
+    213: "RemoteStartEnabled",
+    226: "ValetModeEnabled",
+    # --- Tires ---
+    69: "TpmsPressureFl",
+    70: "TpmsPressureFr",
+    71: "TpmsPressureRl",
+    72: "TpmsPressureRr",
+    81: "TpmsLastSeenPressureTimeFl",
+    82: "TpmsLastSeenPressureTimeFr",
+    83: "TpmsLastSeenPressureTimeRl",
+    84: "TpmsLastSeenPressureTimeRr",
+    224: "TpmsHardWarnings",
+    225: "TpmsSoftWarnings",
+    # --- Drive Inverter (per-motor diagnostics) ---
+    14: "DiStateR",
+    15: "DiHeatsinkTR",
+    16: "DiAxleSpeedR",
+    17: "DiTorquemotor",
+    18: "DiStatorTempR",
+    19: "DiVBatR",
+    20: "DiMotorCurrentR",
+    135: "DiStateF",
+    136: "DiStateREL",
+    137: "DiStateRER",
+    138: "DiHeatsinkTF",
+    139: "DiHeatsinkTREL",
+    140: "DiHeatsinkTRER",
+    141: "DiAxleSpeedF",
+    142: "DiAxleSpeedREL",
+    143: "DiAxleSpeedRER",
+    144: "DiSlaveTorqueCmd",
+    145: "DiTorqueActualR",
+    146: "DiTorqueActualF",
+    147: "DiTorqueActualREL",
+    148: "DiTorqueActualRER",
+    149: "DiStatorTempF",
+    150: "DiStatorTempREL",
+    151: "DiStatorTempRER",
+    152: "DiVBatF",
+    153: "DiVBatREL",
+    154: "DiVBatRER",
+    155: "DiMotorCurrentF",
+    156: "DiMotorCurrentREL",
+    157: "DiMotorCurrentRER",
+    164: "DiInverterTR",
+    165: "DiInverterTF",
+    166: "DiInverterTREL",
+    167: "DiInverterTRER",
+    # --- Navigation / Route ---
+    107: "RouteLastUpdated",
+    108: "RouteLine",
+    109: "MilesToArrival",
+    110: "MinutesToArrival",
+    111: "OriginLocation",
+    112: "DestinationLocation",
+    163: "DestinationName",
+    215: "RouteTrafficMinutesDelay",
+    192: "ExpectedEnergyPercentAtTripArrival",
+    # --- Vehicle Info / Config ---
+    113: "CarType",
+    114: "Trim",
+    115: "ExteriorColor",
+    116: "RoofColor",
+    189: "EfficiencyPackage",
+    191: "EuropeVehicle",
+    214: "RightHandDrive",
+    227: "WheelType",
+    228: "WiperHeatEnabled",
+    # --- Safety / ADAS ---
+    127: "AutomaticBlindSpotCamera",
+    128: "BlindSpotCollisionWarningChime",
+    130: "ForwardCollisionWarning",
+    131: "LaneDepartureAvoidance",
+    132: "EmergencyLaneDepartureAvoidance",
+    133: "AutomaticEmergencyBrakingOff",
+    # --- Powershare ---
+    206: "PowershareHoursLeft",
+    207: "PowershareInstantaneousPowerKW",
+    208: "PowershareStatus",
+    209: "PowershareStopReason",
+    210: "PowershareType",
+    # --- Homelink ---
+    194: "HomelinkDeviceCount",
+    195: "HomelinkNearby",
+    # --- Software Updates ---
+    216: "SoftwareUpdateDownloadPercentComplete",
+    217: "SoftwareUpdateExpectedDurationMinutes",
+    218: "SoftwareUpdateInstallationPercentComplete",
+    219: "SoftwareUpdateScheduledStartTime",
+    220: "SoftwareUpdateVersion",
+    # --- Tonneau ---
+    221: "TonneauOpenPercent",
+    222: "TonneauPosition",
+    223: "TonneauTentMode",
+    # --- Location Context ---
+    229: "LocatedAtHome",
+    230: "LocatedAtWork",
+    231: "LocatedAtFavorite",
+    # --- Settings ---
+    232: "SettingDistanceUnit",
+    233: "SettingTemperatureUnit",
+    234: "Setting24HourTime",
+    235: "SettingTirePressureUnit",
+    236: "SettingChargeUnit",
+    # --- Lights ---
+    239: "LightsHazardsActive",
+    240: "LightsTurnSignal",
+    241: "LightsHighBeams",
+    # --- Media ---
+    242: "MediaPlaybackStatus",
+    243: "MediaPlaybackSource",
+    244: "MediaAudioVolume",
+    245: "MediaNowPlayingDuration",
+    246: "MediaNowPlayingElapsed",
+    247: "MediaNowPlayingArtist",
+    248: "MediaNowPlayingTitle",
+    249: "MediaNowPlayingAlbum",
+    250: "MediaNowPlayingStation",
+    251: "MediaAudioVolumeIncrement",
+    252: "MediaAudioVolumeMax",
+    # --- Misc ---
+    205: "OffroadLightbarPresent",
+    212: "RearSeatHeaters",
+    253: "SunroofInstalled",
+    258: "MilesSinceReset",
+    259: "SelfDrivingMilesSinceReset",
+    # --- Semi-truck (included for completeness, excluded from presets) ---
+    73: "SemitruckTpmsPressureRe1L0",
+    74: "SemitruckTpmsPressureRe1L1",
+    75: "SemitruckTpmsPressureRe1R0",
+    76: "SemitruckTpmsPressureRe1R1",
+    77: "SemitruckTpmsPressureRe2L0",
+    78: "SemitruckTpmsPressureRe2L1",
+    79: "SemitruckTpmsPressureRe2R0",
+    80: "SemitruckTpmsPressureRe2R1",
+    97: "SemitruckPassengerSeatFoldPosition",
+    104: "SemitruckTractorParkBrakeStatus",
+    105: "SemitruckTrailerParkBrakeStatus",
 }
 
+# ---------------------------------------------------------------------------
+# Fields that exist in vehicle_data.proto but should be excluded from the
+# "all" preset.  Semi-truck fields won't work on consumer vehicles.
+# LifetimeEnergyGainedRegen returns "unsupported_field" on many vehicles.
+# ---------------------------------------------------------------------------
+
+_NON_STREAMABLE_FIELDS: frozenset[str] = frozenset(
+    {name for name in FIELD_NAMES.values() if name.startswith("Semitruck")}
+    | {
+        "LifetimeEnergyGainedRegen",  # returns "unsupported_field" on many vehicles
+    }
+)
+
+# Fields that require minimum_delta instead of interval_seconds.
+# Tesla's API rejects these if minimum_delta is not explicitly set >= 1.
+_DELTA_FIELDS: frozenset[str] = frozenset(
+    {
+        "MilesSinceReset",
+        "SelfDrivingMilesSinceReset",
+    }
+)
+
 # ---------------------------------------------------------------------------
 # Preset field configurations
 # ---------------------------------------------------------------------------
@@ -160,16 +330,17 @@ PRESETS: dict[str, dict[str, dict[str, int]]] = {
         "VehicleSpeed": {"interval_seconds": 1},
         "Location": {"interval_seconds": 1},
         "Gear": {"interval_seconds": 1},
-        "Heading": {"interval_seconds": 1},
+        "GpsHeading": {"interval_seconds": 1},
         "Odometer": {"interval_seconds": 10},
-        "Elevation": {"interval_seconds": 5},
         "BatteryLevel": {"interval_seconds": 10},
         "Soc": {"interval_seconds": 10},
         "PackCurrent": {"interval_seconds": 5},
         "PackVoltage": {"interval_seconds": 5},
-        "CruiseState": {"interval_seconds": 5},
         "CruiseSetSpeed": {"interval_seconds": 5},
-        "PowerState": {"interval_seconds": 10},
+        "LateralAcceleration": {"interval_seconds": 5},
+        "LongitudinalAcceleration": {"interval_seconds": 5},
+        "BrakePedalPos": {"interval_seconds": 5},
+        "PedalPosition": {"interval_seconds": 5},
     },
     "charging": {
         "Soc": {"interval_seconds": 5},
@@ -177,7 +348,7 @@ PRESETS: dict[str, dict[str, dict[str, int]]] = {
         "PackVoltage": {"interval_seconds": 5},
         "PackCurrent": {"interval_seconds": 5},
         "ChargeState": {"interval_seconds": 5},
-        "ChargerActualCurrent": {"interval_seconds": 5},
+        "ChargeAmps": {"interval_seconds": 5},
         "ChargerVoltage": {"interval_seconds": 5},
         "ChargerPhases": {"interval_seconds": 30},
         "ACChargingPower": {"interval_seconds": 5},
@@ -191,18 +362,26 @@ PRESETS: dict[str, dict[str, dict[str, int]]] = {
     "climate": {
         "InsideTemp": {"interval_seconds": 10},
         "OutsideTemp": {"interval_seconds": 30},
-        "DriverTempSetting": {"interval_seconds": 30},
-        "PassengerTempSetting": {"interval_seconds": 30},
-        "IsClimateOn": {"interval_seconds": 10},
-        "FanStatus": {"interval_seconds": 10},
+        "HvacLeftTemperatureRequest": {"interval_seconds": 30},
+        "HvacRightTemperatureRequest": {"interval_seconds": 30},
+        "HvacPower": {"interval_seconds": 10},
+        "HvacFanStatus": {"interval_seconds": 10},
         "SeatHeaterLeft": {"interval_seconds": 30},
         "SeatHeaterRight": {"interval_seconds": 30},
-        "SteeringWheelHeater": {"interval_seconds": 30},
-        "CabinOverheatProtection": {"interval_seconds": 60},
+        "HvacSteeringWheelHeatLevel": {"interval_seconds": 30},
+        "CabinOverheatProtectionMode": {"interval_seconds": 60},
         "DefrostMode": {"interval_seconds": 30},
         "PreconditioningEnabled": {"interval_seconds": 30},
     },
-    "all": {name: {"interval_seconds": 30} for name in FIELD_NAMES.values()},
+    "all": {
+        name: (
+            {"interval_seconds": 30, "minimum_delta": 1}
+            if name in _DELTA_FIELDS
+            else {"interval_seconds": 30}
+        )
+        for name in FIELD_NAMES.values()
+        if name not in _NON_STREAMABLE_FIELDS
+    },
 }
 
 # Reverse lookup: name → ID