Tags 0

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- plugins:teslacmd:start [2024/10/19 22:58] – Jan Wachsmuth
+++ plugins:teslacmd:start [2025/02/09 10:56] (aktuell) – Jan Wachsmuth
@@ Zeile 2: / Zeile 2: @@
 ++++ Version history ... |
+Version 0.7.2:
+  * %%Fixed queries for Tesla powerwall.%%
+Version 0.7.1:
+  * %%Added commands to retrieve status and control battery for Tesla powerwall.%%
+Version 0.7.0:
+  * Settings page enhanced: now you can adjust timeouts, debugging and retries directly (custom BLE command removed).
+  * Debug messages for plugin are more descriptive and comprehensive.
+  * Process handling for generating and verifying keys is improved: you may stop the countdown of 30 seconds now if you are done by clicking the button.
+  * Enhancement for send.php: now VIN is used for MQTT messages if it was provided.
+Version 0.6.0:
+  * added queuing system on Loxberry for BLE commands (only one binary is able to use BLE device at a time)
+  * improved performance for settings screen - RSSI is fetched on request only
+  * updated tesla-control binary (RSSI is added in JSON output)
+  * added verification, if a public key was installed properly
+Version 0.5.1:
+  * Minor corrections in function to send keys to car
+  * Added verification if public key was properly installed in car
+  * Added/updated binary images for Tesla Vehicle Command SDK utilities for 32-bit Raspberry OS
+Version 0.5.0:
+  * Automatically select the proper SDK/API from VIN of the vehicle (only pre 2021 S and Y models use old API).
+  * Create and delete a key pair via GUI for each vehicle with explanations
+  * Send public key to car via GUI with explanations
+  * Show RSSI (received signal strength) and meaning
+  * Show function blocks for outputs and output commands that can be copied to Loxone config
+  * **NOTE**: since this version, special builds of Tesla utlities that produce JSON output are required! See below for more information.
+  * Updated binary for tool '**tesla-contol**' that has a new category to get location information
+  * Added binary for new tool '**tesla-scan**' that scans for vehicles nearby without using any keys
+Version 0.2.4:
+  * Fix for version 0.2.2 - state command was missing in json file.
+Version 0.2.2:
+  * Updated and enhanced to reflect changes from Tesla vehicle-command SDK, PR #330 - Support vehicle data over BLE
+Statement from Tesla regarding the updated SDK: adds support for fetching and decrypting vehicle data over BLE. Some types of vehicle data are not available prior to 2024.38.
+You are able to retrieve detailed status information from the vehicle via BLE. The tool '**tesla-contol**' has a new command 'state <category>', with following values for category: charge-schedule, precondition-schedule, media-detail, software-update, climate, drive, tire-pressure, media, parental-controls, charge, closures
+The TeslaCmd plugin supports all new commands and options for 'tesla-control' and 'tesla-keygen'. Updated binaries for 64-bit Raspberry are included.
+Version 0.2.1:
+  * Minor bug fixes.
+  * %%Fixed problem with 'wake up' option via force=true option.%%
 Version 0.1.9:
   * Minor bug fixes.
-  * %%Added wake up to commands via force=true option.%%
+  * %%Added 'wake up' to commands via force=true option.%%
 Version 0.1.8:
@@ Zeile 59: / Zeile 117: @@
 Das Tesla Vehicle Command SDK enthält das [Tesla Control Utility]([[https://github.com/teslamotors/vehicle-command/tree/main/cmd/tesla-control#tesla-control-utility]]) über welches Befehle  entweder über Bluetooth Low Energy (BLE) oder das Internet über die Tesla Fleet API an das Fahrzeug gesendet werden können. Derzeit ist für das Plugin nur BLE implementiert und es gibt derzeit keine Pläne die Fleet API zu unterstützen.
-Bisher (Stand Juli 2024) gibt es in der neuen API nur Befehle zum Steuern von Funktionen, wie z.B. das Ein- oder Ausschalten der Klimaanlage, das Einstellen des maximalen Ladestroms oder zum Öffnen bzw. Schließen des Kofferraumes. Die API enthält einen einzigen Befehl 'body-controller-state', um den Status für diverse Systeme abzufragen, u.a. Schlafzustand, Präsenz, Schließzustand für Türen und Kofferraum.
+Alle Befehle zur Steuerung des Fahrzeugs, z.B. Das Ändern der Klimatisierung, das Ändern der Einstellungen zum Laden des Fahrzeugs oder das Öffnen oder Schließen des Kofferraums sind über die neue Vehicle Command API sowohl über BLE, als auch über die Fleet API verfügbar. Mittlerweile unterstützt die neue API zwei Befehle zum Abrufen von Statusinformationen über BLE. Der erste Befehl „**//body-controller-state//**“ ruft grundlegende Informationen über Schließzustände, Schlafstatus und Benutzeranwesenheitsstatus ab und funktioniert auch, wenn das Fahrzeug schläft. Der zweite Befehl „**//state//**“ wird verwendet, um detaillierte Statusinformationen abzurufen.
-Diese Plugin unterstützt daher weiterhin die bisherige (inoffizielle) Owner's API für alle Befehle, die darüber noch funktionieren, um z.B. Statusinformationen zum Fahrzeug oder einer Power Wall abzufragen. In den Einstellungen kann man für jedes Fahrzeug bzw. Powerwall festlegen, welche API verwendet wird:  - die alte (inoffizielle) Owner's API für ALLE Befehle. Dies ist sinnvoll sofern das Fahrzeug die alten Befehle noch unterstützt oder eine Powerwall verwendet wird. - ein Mix aus der (inoffizielle) Owner's API um Statusinformationen abzufragen und die neue Vehicle Command API, um Befehle über BLE an das Fahrzeug zu senden. Diese werden über das Tool 'Tesla Control Utility' (tesla-control) gesendet.
+Das Plugin unterstützt ebenfalls die alten Befehle der (inoffiziellen) Owner's API, die noch funktionieren und z.B. für S- und Y-Modelle vor 2021und Powerwalls weiterhin verwendet werden. Bei neueren Fahrzeugen können einige Statusinformationen weiterhin ebenfalls über die (inoffizielle) Owner's-API ([[https://owner-api.teslamotors.com/api/1/vehicles/]]...) abgerufen werden. Seit Version 0.5 dieses Plugins wird die richtige API automatisch ausgewählt.
 Alle Daten (Statusinformationen) werden vom Fahrzeug über MQTT zurück an den Loxone Miniserver übertragen. Die Subskription dafür lautet ''%%teslacmd/#%%'' und wird im MQTT Gateway Plugin automatisch eingetragen. Beim ersten Öffnen des Plugins muss die Anmeldung bei Tesla durchgeführt werden. Dazu wird bei Tesla ein Token generiert. Das Token wird anschliessend automatisch verlängert. Nach erfolgreicher Anmeldung werden möglichen Abfragen aufgelistet, welche am Miniserver als Virtuelle Ausgänge definiert werden können.
@@ Zeile 70: / Zeile 128: @@
 ^ Befehl  ^ Beschreibung  ^
-| STATUS  | Status of the Tesla API.  |
+| **status**  | Status of the Tesla API.  |
-| PRODUCT_LIST | Returns all products including vehicles, powerwalls, and energy sites. |
+| **product_list** | Returns all products including vehicles, powerwalls, and energy sites. |
-| VEHICLES  | Returns a list of all vehicle registered for the authenticated user.  |
+| **vehicles**  | Returns a list of all vehicle registered for the authenticated user.  |
 === Abfragen für ein Fahrzeug ===
-^ Befehl  ^ Beschreibung  ^
+Alle Befehle, die das neue Vehicle Command API via BLE verwenden, sind mit dem Bluetooth Symbol gekennzeichnet.
-| VEHICLE_SUMMARY  | Summary information of the vehicle.  |
-| VEHICLE_DATA  | All information and states of the vehicle.  |
-| CHARGE_STATE  | Charge state information including battery limit, charge miles, charge voltage, charge phases, current, charge management, and battery heater status.  |
-| CLIMATE_STATE  | Climate settings including seats, vents battery, steering wheel, and preconditioning state.  |
-| CLOSURES_STATE  |   |
-| DRIVE_STATE  | Drive state including latitude, longitude, and heading of the vehicle.  |
-| GUI_SETTINGS  | GUI settings of the car, such as unit format and range display  |
-| LOCATION_DATA  |   |
-| VEHICLE_CONFIG  | Vehicle configuration information including model, color, badging and wheels  |
-| VEHICLE_STATE  | Vehicle state, such as which doors are open, tpms pressure  |
-=== Befehle für ein Fahrzeug ===
+^ Befehl  ^ Type ^ Beschreibung  ^   ^
+| **vehicle_summary**  |   | Summary information of the vehicle.  |   |
+| **vehicle_data**  |   | All information and states of the vehicle.  |   |
+| **list_keys** | {{ :plugins:teslacmd:bluetooth.svg?10x20&nolink }} | %%List public keys enrolled on vehicle.%% |   |
+| **charge_state**  |   | Charge state information including battery limit, charge miles, charge voltage, charge phases, current, charge management, and battery heater status.  |   |
+| **climate_state**  |   | Climate settings including seats, vents battery, steering wheel, and preconditioning state.  |   |
+| **closures_state**  |   | %%Closure state informations - may be empty%%  |   |
+| **drive_state**  |   | Drive state including latitude, longitude, and heading of the vehicle.  |   |
+| **gui_settings**  |   | GUI settings of the car, such as unit format and range display  |   |
+| **location_data**  |   | %%Location information including position, heading, and speed.%%  |   |
+| **vehicle_config**  |   | Vehicle configuration information including model, color, badging and wheels  |   |
+| **vehicle_state**  |   | Vehicle state, such as which doors are open, tpms pressure  |   |
+| **body_controller_state** | {{ :plugins:teslacmd:bluetooth.svg?10x20&nolink }}  | %%Fetch limited vehicle state information. Works over BLE even when infotainment / vehicle is asleep.%% |   |
+| **state** | {{ :plugins:teslacmd:bluetooth.svg?10x20&nolink }}  | %%Fetch vehicle state over BLE for following categories: 'tire-pressure', 'parental-controls', 'closures', 'charge-schedule', 'drive', 'location', 'precondition-schedule', 'media', 'media-detail', 'software-update', 'charge', or 'climate'.%% |   |
+=== Befehle für ein Fahrzeug für die alte Owner's API ===
+Die nachfolgenden Befehle sind über die alte Owner's API über das Internet verfügbar. Neuere Fahrzeuge unterstützen diese API nicht mehr, sondern aus Sicherheitsgründen für Befehle an das Fahrzeug nur noch die neue Vehicle Command API.
+^ Befehl ^ Beschreibung ^
+| **wake_up** | Wakes up the vehicle from a sleeping state. |
+| **sun_roof_control** | Controls the panoramic sunroof on the Model S. |
+| **window_control** | Controls the windows. Will vent or close all windows simultaneously. |
+| **actuate_trunk** | Opens or close either the front or rear trunk. |
+| **honk_horn** | Honks the horn of the vehicle once. |
+| **flash_lights** | Flashes the headlights once. |
+| **auto_conditioning_start** | Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature. |
+| **auto_conditioning_stop** | Stop the climate control (HVAC) system. |
+| **set_temps** | Sets the target temperature for the climate control (HVAC) system. (e.g. value 20) |
+| **set_preconditioning_max** | Toggles the climate controls between Max Defrost and the previous setting. |
+| **remote_seat_heater_request** | Sets the specified seat's heater level. |
+| **remote_steering_wheel_heater_request** | Turn steering wheel heater on or off. |
+| **charge_port_door_open** | Opens the charge port or unlocks the cable. |
+| **charge_port_door_close** | Closes the charge port. |
+| **charge_start** | If the car is plugged in but not currently charging, this will start it charging. |
+| **charge_stop** | If the car is currently charging, this will stop it. |
+| **charge_standard** | Set vehicle to standard charge limit or ~90%. |
+| **charge_max_range** | Set the vehicle to max charge limit. |
+| **set_charge_limit** | Set the vehicle to defined charge limit. (e.g. value 80) |
+| **set_charging_amps** | Sets the charge amps limit to a custom value. (e.g. value 16) |
+| **set_scheduled_departure** | Set the scheduled departure. |
+| **set_scheduled_charging** | Set the scheduled charge. |
+| **set_valet_mode** | Activates or deactivates Valet Mode. |
+| **reset_valet_pi** | Clears the currently set PIN for Valet Mode when deactivated. A new PIN will be required when activating from the car screen. |
+| **set_sentry_mode** | Turns sentry mode on or off. |
+=== Neue oder angepasste Befehle für die Vehicle Control API via BLE ===
+Die nachfolgenden Befehle sind in der neuen Vehicle Command API enthalten. Das Plugin unterstützt derzeit nur das Senden über BLE.
 ^ Befehl  ^ Beschreibung  ^
-| WAKE_UP  | Wakes up the vehicle from a sleeping state.  |
+| **ble_wake** | %%Wakes up the vehicle from a sleeping state via Bluetooth Low Energy (BLE).%% |
-| REMOTE_START_DRIVE  | Enables keyless driving. There is a two minute window after issuing the command to start driving the car.  |
+| **ping** | %%Ping the vehicle.%% |
-| DOOR_UNLOCK  | Unlocks the doors to the vehicle.  |
+| **remote_start_drive**  | Enables keyless driving. There is a two minute window after issuing the command to start driving the car.  |
-| DOOR_LOCK  | Locks the doors to the vehicle.  |
+| **door_unlock**  | Unlocks the doors to the vehicle.  |
-| SUN_ROOF_CONTROL  | Controls the panoramic sunroof on the Model S.  |
+| **door_lock**  | Locks the doors to the vehicle.  |
-| WINDOW_CONTROL  | Controls the windows. Will vent or close all windows simultaneously.  |
+| **autosecure_modelx** | %%Close falcon-wing doors and lock vehicle. Model X only.%% |
-| ACTUATE_TRUNK  | Opens or close either the front or rear trunk.  |
+| **windows_close** | %%Closes all windows simultaneously.%% |
-| HONK_HORN  | Honks the horn of the vehicle once.  |
+| **windows_vent** | %%Vent all windows simultaneously.%% |
-| FLASH_LIGHTS  | Flashes the headlights once.  |
+| **trunk_close** | %%Closes vehicle trunk. Only available on certain vehicle types.%% |
-| AUTO_CONDITIONING_START  | Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature.  |
+| **trunk_open** | %%Open vehicle trunk. Note that trunk-close only works on certain vehicle types.%% |
-| AUTO_CONDITIONING_STOP  | Stop the climate control (HVAC) system.  |
+| **trunk_move** | %%Toggle trunk open/closed. Closing is only available on certain vehicle types.%% |
-| SET_PRECONDITIONING_MAX  | Toggles the climate controls between Max Defrost and the previous setting.  |
+| **frunk_open** | %%Open vehicle frunk. Note that there's no frunk-close command!%% |
-| REMOTE_SEAT_HEATER_REQUEST  | Sets the specified seat's heater level.  |
+| **honk_horn**  | Honks the horn of the vehicle once.  |
-| REMOTE_STEERING_WHEEL_HEATER_REQUEST | Turn steering wheel heater on or off.  |
+| **flash_lights**  | Flashes the headlights once.  |
-| SET_TEMPS  | Sets the target temperature for the climate control (HVAC) system. (e.g. value 20)  |
+| **auto_conditioning_start**  | Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature.  |
-| CHARGE_PORT_DOOR_OPEN  | Opens the charge port or unlocks the cable.  |
+| **auto_conditioning_stop**  | Stop the climate control (HVAC) system.  |
-| CHARGE_PORT_DOOR_CLOSE  | Closes the charge port.  |
+| **auto_seat_and_climate**  | %%Turn on automatic seat heating and climate control (HVAC).%%  |
-| CHARGE_START  | If the car is plugged in but not currently charging, this will start it charging.  |
+| **climate_set_temp** | %%Desired temperature for climate control (HVAC) system.%% |
-| CHARGE_STOP  | If the car is currently charging, this will stop it.  |
+| **seat_heater**  | %%Sets the specified seat's heater level.%%  |
-| CHARGE_STANDARD  | Set vehicle to standard charge limit or ~90%.  |
+| **steering_wheel_heater** | Turn steering wheel heater on or off.  |
-| CHARGE_MAX_RANGE  | Set the vehicle to max charge limit.  |
+| **charge_port_door_open**  | Opens the charge port or unlocks the cable.  |
-| SET_CHARGE_LIMIT  | Set the vehicle to defined charge limit. (e.g. value 80)  |
+| **charge_port_door_close**  | Closes the charge port.  |
-| SET_CHARGING_AMPS  | Sets the charge amps limit to a custom value. (e.g. value 16)  |
+| **charge_start**  | If the car is plugged in but not currently charging, this will start it charging.  |
-| SET_SCHEDULED_DEPARTURE  | Set the scheduled departure.  |
+| **charge_stop**  | If the car is currently charging, this will stop it.  |
-| SET_SCHEDULED_CHARGING  | Set the scheduled charge.  |
+| **set_charge_limit**  | Set the vehicle to defined charge limit. (e.g. value 80)  |
-| SET_VALET_MODE  | Activates or deactivates Valet Mode.  |
+| **set_charging_amps**  | Sets the charge amps limit to a custom value. (e.g. value 16)  |
-| RESET_VALET_PIN  | Clears the currently set PIN for Valet Mode when deactivated. A new PIN will be required when activating from the car screen. |
+| **charging_schedule**  | %%Schedule charging to MINS minutes after midnight and enable daily scheduling.%%  |
-| SET_SENTRY_MODE  | Turns sentry mode on or off.  |
+| **charging_schedule_cancel**  | %%Cancel scheduled charge start.%%  |
+| **charging_schedule_add** | %%Schedule charge for DAYS START_TIME-END_TIME at LATITUDE LONGITUDE for [ID].%% |
+| **charging_schedule_remove** | %%Removes charging schedule of TYPE [ID].%% |
+| **precondition_schedule_add** | %%Schedule precondition for DAYS TIME at LATITUDE LONGITUDE.%% |
+| **precondition_schedule_remove** | %%Removes precondition schedule of TYPE [ID]%% |
+| **valet_mode_off** | %%Disable valet mode.%% |
+| **valet_mode_on** | %%Enable valet mode and set pin.%%  |
+| **sentry_mode**  | Turns sentry mode on or off.  |
+| **tonneau_close** | %%Close Cybertruck tonneau.%% |
+| **tonneau_open** | %%Open Cybertruck tonneau.%% |
+| **tonneau_stop** | %%Stop moving Cybertruck tonneau.%% |
+| **media_set_volume** | %%Set volume.%% |
+| **media_toggle_playback** | %%Toggle between play/pause.%% |
+| **software_update_start** | %%Start software update after DELAY.%% |
+| **software_update_cancel**  | %%Cancel a pending software update.%%  |
+| **guest_mode_off**  | %%Disable Guest Mode.%%  |
+| **guest_mode_on**  | %%Enable Guest Mode. This mode is used by e.g. rental car companies to restricts certain vehicle UI functionality like renaming the car or deleting keys. See https://developer.tesla.com/docs/fleet-api/endpoints/vehicle-commands#guest-mode.%%  |
+| **erase_guest_data** | %%Erase Guest Mode user data.%% |
+| **add_key** | %%Add PUBLIC_KEY to vehicle whitelist with ROLE and FORM_FACTOR.%% |
+| **add_key_request** | %%Request NFC-card approval for a enrolling PUBLIC_KEY with ROLE and FORM_FACTOR.%% |
-=== Abfragen für Powerwall ===
+=== Abfragen für Powerwall / Energy Site ===
 ^ Befehl ^ Beschreibung ^
@@ Zeile 128: / Zeile 243: @@
 | %%SITE_PROGRAMS%% | %%Retrieves energy site program information.%% |
 | %%SITE_TARIFF_RATE%% | %%Retrieves the user defined Utility Rate Plan used for Time-Based Control mode. It looks like this endpoint is updated every 30 minutes.%% |
+| %%BACKUP_HISTORY%% | %%Returns the backup (off-grid) event history of the site in duration of seconds.%% |
+| %%CHARGE_HISTORY%% | %%Returns the charging history of a wall connector.%% |
+| %%ENERGY_HISTORY%% | %%Returns the energy measurements of the site, aggregated to the requested period.%% |
-=== Neue oder angepasste Befehle über die Vehicle Control API via BLE ===
+=== Befehle für Powerwall / Energy Site ===
 ^ Befehl ^ Beschreibung ^
-| %%LIST_KEYS%% | %%List public keys enrolled on vehicle.%% |
+| %%BACKUP%% | %%Adjust the site's backup reserve.%% |
-| %%BODY_CONTROLLER_STATE%% | %%Fetch limited vehicle state information. Works over BLE when infotainment / vehicle is asleep.%% |
+| %%GRID_IMPORT_EXPORT%% | %%Allow/disallow charging from the grid and exporting energy to the grid.%% |
-| %%BLE_WAKE%% | %%Wakes up the vehicle from a sleeping state via Bluetooth Low Energy (BLE).%% |
+| %%OFF_GRID_VEHICLE_CHARGING_RESERVE%% | %%Adjust the site's off-grid vehicle charging backup reserve.%% |
-| %%PING%% | %%Ping the vehicle.%% |
+| %%OPERATION%% | %%Use autonomous for time-based control and self_consumption for self-powered mode.%% |
-| %%REMOTE_START_DRIVE%% | %%Enables keyless driving. There is a two minute window after issuing the command to start driving the car.%% |
+| %%STORM_MODE%% | %%Update storm watch participation.%% |
-| %%DOOR_UNLOCK%% | %%Unlocks the doors to the vehicle.%% |
+| %%TIME_OF_USE_SETTINGS%% | %%Update the time of use settings for the energy site.%% |
-| %%DOOR_LOCK%% | %%Locks the doors to the vehicle.%% |
-| %%AUTOSECURE_MODELX%% | %%Close falcon-wing doors and lock vehicle. Model X only.%% |
-| %%WINDOWS_CLOSE%% | %%Closes all windows simultaneously.%% |
-| %%WINDOWS_VENT%% | %%Vent all windows simultaneously.%% |
-| %%TRUNK_CLOSE%% | %%Closes vehicle trunk. Only available on certain vehicle types.%% |
-| %%TRUNK_OPEN%% | %%Open vehicle trunk. Note that trunk-close only works on certain vehicle types.%% |
-| %%TRUNK_MOVE%% | %%Toggle trunk open/closed. Closing is only available on certain vehicle types.%% |
-| %%FRUNK_OPEN%% | %%Open vehicle frunk. Note that there's no frunk-close command!%% |
-| %%HONK_HORN%% | %%Honks the horn of the vehicle once.%% |
-| %%FLASH_LIGHTS%% | %%Flashes the head- and backlights once.%% |
-| %%AUTO_CONDITIONING_START%% | %%Start the climate control (HVAC) system. Will cool or heat automatically, depending on set temperature.%% |
-| %%AUTO_CONDITIONING_STOP%% | %%Stop the climate control (HVAC) system.%% |
-| %%AUTO_SEAT_AND_CLIMATE%% | %%Turn on automatic seat heating and climate control (HVAC).%% |
-| %%SET_TEMPS%% | %%Sets the target temperature for the climate control (HVAC) system (e.g. value 20).%% |
-| %%CLIMATE_SET_TEMP%% | %%Desired temperature for climate control (HVAC) system.%% |
-| %%SET_PRECONDITIONING_MAX%% | %%Toggles the climate controls between Max Defrost and the previous setting.%% |
-| %%SEAT_HEATER%% | %%Sets the specified seat's heater level.%% |
-| %%STEERING_WHEEL_HEATER%% | %%Turn steering wheel heater on or off.%% |
-| %%CHARGE_PORT_DOOR_OPEN%% | %%Opens the charge port or unlocks the cable.%% |
-| %%CHARGE_PORT_DOOR_CLOSE%% | %%Closes the charge port.%% |
-| %%CHARGE_START%% | %%If the car is plugged in but not currently charging, this will start it charging.%% |
-| %%CHARGE_STOP%% | %%If the car is currently charging, this will stop it.%% |
-| %%SET_CHARGE_LIMIT%% | %%Set the vehicle to defined charge limit. (e.g. value 80)%% |
-| %%SET_CHARGING_AMPS%% | %%Sets the charge amps limit to a custom value. (e.g. value 16)%% |
-| %%CHARGING_SCHEDULE%% | %%Schedule charging to MINS minutes after midnight and enable daily scheduling.%% |
-| %%CHARGING_SCHEDULE_CANCEL%% | %%Cancel scheduled charge start.%% |
-| %%SENTRY_MODE%% | %%Turns sentry mode on or off.%% |
-| %%MEDIA_SET_VOLUME%% | %%Set volume.%% |
-| %%MEDIA_TOGGLE_PLAYBACK%% | %%Toggle between play/pause.%% |
-| %%SOFTWARE_UPDATE_START%% | %%Start software update after DELAY.%% |
-| %%SOFTWARE_UPDATE_CANCEL%% | %%Cancel a pending software update.%% |
 ===== Voraussetzungen =====
 Damit der Loxberry Befehle via BLE (Bluetooth Low Energy) an ein Fahrzeug senden kann, muss er sich in der Nähe des Fahrzeugs befinden. Eine maximal mögliche Entfernung kann ich nicht nennen, aber bei mir funktioniert es mit der (nicht besonders guten) kombinierten WLAN/BLE Antenne, die sich auf der Platine des Raspberry PI 3B+ befindet, durch eine Außenwand des Gebäudes (ohne Fenster auf der Seite zum Fahrzeug) über eine Distanz von ca. 7m ziemlich zuverlässig. Wer seinen Loxberry im Verteilerschrank aus Metall eingebaut hat, der sollte die Antenne auf jeden Fall nach außen verlegen, wofür die Platine bearbeitet werden muss. Anleitungen für so eine Modifikation gibt es sehr viele im Internet, u.a. [[https://geeks-r-us.de/2019/08/31/wlan-bluetooth-upgrade-fuer-den-rpi-4/|hier]]. Falls der Raspberry in ein Gehäuse aus Metall eingebaut wurde, ist eine externe Antenne ebenfalls dringend empfohlen. Man kann das Plugin sicherlich auch auf einem eigenen Loxberry installieren, der an einem sicheren Ort in der Nähe des Fahrzeugs installiert wird. Im SDK von Tesla werden Linux und MacOS als mögliche Betriebssysteme bei Verwendung von Bluetooth genannt. Windows wird offiziell nicht unterstützt.
+===== Golang Bluetooth Library =====
+Leider wird die Golang Bluetooth Library **//[[https://github.com/go-ble/ble|go-ble]]//** derzeit nicht gepflegt. Auf einem Raspberry PI kommt es bei Ausführung des Tools '//tesla-control//' aus dem SDK, welches das Plugin verwendet, zu einem Problem, wenn z.B. das Fahrzeug nicht in der Nähe über BLE erreichbar ist. Das Tool kann dann in einer Endlosschleife festhängen und gibt die verwendeten Bluetooth Ressourcen nicht mehr frei. Ein weiteres Ausführungen des Tools wird mit einer Fehlermeldung abgebrochen. Dieses Problem ist von einem Anwender erkannt worden und in einem [[https://github.com/go-ble/ble/pull/112|Pull Request]] (PR) bereits ein Code vorbereitet worden, der den Fehler beseitigt, aber der PR wird nicht von den Maintainern des Git Repositories bestätigt. Dadurch ist es deutlich umständlicher, aus den 'offiziellen' Quellen eine Version des Tools ohne den Fehler zu erstellen.
+Da die Meldungen im Debug-Modus im o.a. Fehlerbild zu mehreren 1000 Zeilen Output führen, habe ich die Tools aus dem Tesla Vehicle Command SDK auf eine andere [[https://github.com/rigado/ble|Golang Bluetooth Library von Rigado]] umgestellt, die deutlich bessere Meldungen erzeugt. Der o.a. Fehler ist dort leider ebenfalls noch vorhanden, siehe [[https://github.com/rigado/ble/pull/76|Pull Request #76]]. Daher muss eine angepasste Version des Tesla Vehicle Command SDK verwendet werden, die eine angepasste Version der BLE Library inklusive Fix verwendet.
 ===== Installation =====
@@ Zeile 181: / Zeile 274: @@
   - Installation des [[plugins:mqtt_gateway:start|Plugin MQTT Gateway]]. Sollte dieses bereits auf dem Loxberry vorhanden sein, kann dieser Punkt übersprungen werden. Ab LoxBerry 3.0 ist das MQTT Gateway ein Bestandteil des LoxBerrys und daher bereits automatisch installiert.
   - Installation des Tesla-Command Plugins über die Plugin Verwaltung.
-  - Installation bzw. Erstellung der beiden Kommandozeilentools aus dem Tesla Vehicle Command SDK, siehe zugehörige README.md auf Github oder nachfolgende Hinweise.
+  - Installation bzw. Erstellung der beiden Kommandozeilentools aus dem Tesla Vehicle Command SDK, siehe nachfolgende Hinweise. Dieser Schritt entfällt bei einem Loxberry auf Basis eines Raspberry PI mit **64-Bit** (Diet-PI mit Version Bookworm).
-  - Erstellung eines privaten und öffentlichen Schlüssels bzw. Schlüsselpaares, Installation des öffentlichen Schlüssels im Fahrzeug, siehe zugehöriges README.md vom Tesla Vehicle Command SDK auf Github oder nachfolgende Hinweise.
+  - Erstellung eines privaten und öffentlichen Schlüssels bzw. Schlüsselpaares, Installation des öffentlichen Schlüssels im Fahrzeug, siehe zugehöriges README.md vom Tesla Vehicle Command SDK auf Github oder nachfolgende Hinweise. Dieser Schritt entfällt seit Version 0.5.0 und ist hier nur noch als Referenz enthalten. Ab Version 0.5.0 können die benötigten Schlüssel direkt in der GUI erstellt werden.
 ==== Installation der Tools aus dem Tesla Vehicle Command SDK ====
-Dieser Schritt kann bei einem Loxberry auf Basis eines Raspberry PI mit 64-Bit (z.B. bei einem Diet-PI mit Version Bookworm) als auch 32-Bit übersprungen werden, weil die beiden benötigten Tools bereits im Binärformat im Plugin enthalten sind. Man benötigt daher weder Golang noch das SDK. Für alle anderen Betriebssysteme und CPUs ist dieser Schritt erforderlich. Die Installation der Tools ist in der [[https://github.com/teslamotors/vehicle-command/blob/main/README.md#installation-and-configuration|README.md]] des SDKs beschrieben und hier nur ergänzt. Windows wird offiziell nicht unterstützt. Die Installation hat auf einem MacBook mit Sonoma und einem Raspberry PI mit 32 als auch 64-Bit funktioniert. Wenn man die Tools lieber selber erstellen möchte oder Tesla das SDK aktualisiert hat, dann kann man alternativ die nachfolgenden Schritte auch auf einem Raspberry PI ausführen.
+Dieser Schritt kann bei einem Loxberry auf Basis eines Raspberry PI mit **64-Bit** (z.B. bei einem Diet-PI mit Version Bookworm) übersprungen werden, weil die beiden benötigten Tools bereits im Binärformat im Plugin enthalten sind. Man benötigt daher weder Golang noch das SDK. Bei Verwendung eines Raspberry PI mit **32-Bit** bitte die Release Notes beachten. In einigen Versionen habe ich die Tools aktualisiert, aber wg. des zusätzlichen Aufwandes sind die nicht in jeder Version aktualisiert und funktionieren daher möglicherweise nicht.
+Für alle anderen Betriebssysteme und CPUs ist dieser Schritt erforderlich. Die Installation der Tools ist in der [[https://github.com/teslamotors/vehicle-command/blob/main/README.md#installation-and-configuration|README.md]] des SDKs beschrieben und hier nur ergänzt. Windows wird offiziell nicht unterstützt. Die Installation hat auf einem MacBook mit Sonoma und einem Raspberry PI mit 32 als auch 64-Bit funktioniert. Wenn man die Tools lieber selber erstellen möchte oder Tesla das SDK aktualisiert hat, dann kann man alternativ die nachfolgenden Schritte auch auf einem Raspberry PI ausführen.
+**WICHTIG**: die Installation von Golang ist sehr spezifisch für die jeweilige Hardware und OS Version, insbesondere ist auf die passende Architektur (64- oder 32-Bit) zu achten. Die nachfolgende Anleitung ist daher nur exemplarisch für ein Raspberry dargestellt und erfordert u.U. tiefergehende Kenntnisse von Linux und Erstellung von Programmen (u.a. Git und Golang Compile/Build). Wg. größerer Anpassungen an den Ausgaben der Tools (u.a. kompaktes JSON-Format, Erweiterung um Nummern statt Enum Bezeichnern, andere BLE Bibliothek mit Bugfix) funktionieren nur die u.a. Bibliotheken (github.com/jan21493/vehicle-command.git und github.com/Jan21493/ble)
 === Installation von Golang ===
@@ Zeile 211: / Zeile 308: @@
 Die Installation des **//Tesla Vehicle Command SDK//** kann über **//Git//** erfolgen. Alternativ kann das SDK auch im **//.zip//** Format heruntergeladen und ausgepackt werden. Der entscheidende Schritt ist der Befehl 'build' mit dem die beiden benötigten Tools **//tesla-keygen//** und **//tesla-control //**erstellt**// //**werden. Diese Befehle sollten als User 'loxberry' ausgeführt werden.
-Anschließend werden die Tools in das Verzeichnis **///usr/local/bin//** kopiert, welches für zusätzliche Befehle bereits vorgesehen und im Suchpfad eingetragen ist. Da der Befehl **//sudo//** auf dem Loxberry aus Sicherheitsgründen eingeschränkt ist, muss man sich mit dem Befehl **//su//** als Superuser anmelden, um die entsprechenden Tools in die Systemverzeichnisse kopieren zu können. Danach meldet man sich mit **//exit//** wieder als Superuser ab.
+Eine modifizierte Version der Golang Bluetooth Library von Rigado ist [[https://github.com/Jan21493/ble|hier]] zu finden. Eine [[https://github.com/Jan21493/vehicle-command/|angepasste Version des Tesla Command SDKs]] für diese Golang BLE Library, die zusätzlich Versionsinformationen anzeigt und Ausgaben kompakt im JSON Format liefert, ist dort ebenfalls zu finden. Für das Erstellen der Tools mit Go sind mehrere Umgebungsvariablen zu setzen:
 <code bash>
@@ Zeile 219: / Zeile 316: @@
 # exit
 cd ~
-git clone https://github.com/teslamotors/vehicle-command.git
+# git clone https://github.com/teslamotors/vehicle-command.git
+git clone https://github.com/jan21493/vehicle-command.git
+# git clone https://github.com/rigado/ble.git
+git clone --single-branch --branch local-enhancements https://github.com/Jan21493/ble
 cd vehicle-command/
 # if not set yet: export PATH=$PATH:/opt/loxberry/golang/go/bin
 go get ./...
+# set environment variables that are used for version information
+HWINFO=$(cat /sys/firmware/devicetree/base/model|xargs --null printf "%s")
+HWARCH=$(uname -m)
+VCVERSION=$(git rev-parse --short HEAD)
+TODAY=$(date "+%a, %d %b %Y %T")
+echo "Hardware info: "$HWINFO
+echo "Hardware architecure: "$HWARCH
+echo "Vehicle-Command SDK version: "$VCVERSION
+echo "Date: "$TODAY
 # build tesla-control utility - may take a while
 cd cmd/tesla-control
-go build ./...
+go build -ldflags "-X 'main.version=$VCVERSION' -X 'main.hwinfo=$HWINFO' -X 'main.hwarch=$HWARCH' -X 'main.today=$TODAY'"  ./...
+# build tesla-scan utility - may take a while
+cd ../tesla-scan
+go build -ldflags "-X 'main.version=$VCVERSION' -X 'main.hwinfo=$HWINFO' -X 'main.hwarch=$HWARCH' -X 'main.today=$TODAY'"  ./...
 # build tesla-keygen utility - may take a while
@@ Zeile 232: / Zeile 346: @@
 go build ./...
 cd ..
-# als Superuser ausführen
-su
-mv ./tesla-control/tesla-control /usr/local/bin/
-mv ./tesla-keygen/tesla-keygen /usr/local/bin/
 </code>
-Der Zugriff auf Bluetooth erfordert unter Linux ein entsprechendes Recht, welches man dem Tool tesla-control explizit geben muss, damit es von einem 'normalen' User ausgeführt werden kann. Dafür ist eine Anmeldung als Superuser erforderlich.
+Anschließend werden die Tools in das Verzeichnis **///usr/local/bin//** kopiert, welches für zusätzliche Befehle bereits vorgesehen und im Suchpfad eingetragen ist. Da der Befehl **//sudo//** auf dem Loxberry aus Sicherheitsgründen eingeschränkt ist, muss man sich mit dem Befehl **//su//** als Superuser anmelden, um die entsprechenden Tools in die Systemverzeichnisse kopieren zu können. Der Zugriff auf Bluetooth erfordert unter Linux ein entsprechendes Recht, welches man den Tools tesla-control und tesla-scan explizit geben muss, damit es von einem 'normalen' User ausgeführt werden kann. Dafür ist ebenfalls eine Anmeldung als Superuser erforderlich.
 <code bash>
 # als Superuser ausführen
+su
+cd /opt/loxberry
+mv ./vehicle-command/cmd/tesla-control/tesla-control /usr/local/bin/
 setcap 'cap_net_admin=eip' /usr/local/bin/tesla-control
+mv ./vehicle-command/cmd/tesla-keygen/tesla-keygen /usr/local/bin/
+mv ./vehicle-command/cmd/tesla-scan/tesla-scan /usr/local/bin/
+setcap 'cap_net_admin=eip' /usr/local/bin/tesla-scan
 exit
 </code>
-Als Ergebnis der oben dargestellen Schritte sind jetzt zwei Tools aus dem Tesla Vehicle Command SDK auf dem Loxberry installiert, die vom User Loxberry ausgeführt werden können. Zur ersten Überprüfung kann man die Tools mit der Hilfe-Funktion aufrufen.
+Als Ergebnis der oben dargestellen Schritte sind jetzt die Tools aus dem Tesla Vehicle Command SDK auf dem Loxberry installiert, die vom User Loxberry ausgeführt werden können. Zur ersten Überprüfung kann man die Tools mit der Hilfe-Funktion aufrufen.
 <code bash>
 tesla-control -h
 tesla-keygen -h
+tesla-scan -h
 </code>
@@ Zeile 259: / Zeile 376: @@
 Zunächst wird dafür ein Schlüsselpaar erstellt. Damit im Plugin mehrere Fahrzeuge unterschieden werden können, muss das Schlüsselpaar die VIN des Fahrzeugs im Namen enthalten. Diese wird z.B. im 'Settings Menu' für jedes Fahrzeug angezeigt.
-Derzeit muss das Schlüsselpaar noch manuell erstellt werden. Für eine spätere Version ist eine Integration in die GUI geplant. Die VIN muss durch die VIN des eigenen Fahrzeugs ersetzt werden. Der öffentliche Schlüssel wird nach der Installation im Fahrzeug nicht mehr benötigt und kann dann gelöscht werden.
+Mittlerweile kann das Schlüsselpaar über die GUI im Menü 'Settings' erstellt werden, indem man auf das Plus-Symbol klickt.
+Um manuell ein Schlüsselpaar zu erstellen, ersetzt man die VIN durch die VIN des eigenen Fahrzeugs und führt den nachfolgend angegebenen Befehl aus. Der öffentliche Schlüssel wird nach der Installation im Fahrzeug nicht mehr benötigt und kann dann gelöscht werden.
 <code bash>
@@ Zeile 266: / Zeile 385: @@
 </code>
-Die Schlüssel, die mit Hilfe des Tools **//tesla-keygen//** erstellt wurden, können auch mit OpenSSL Tools verarbeitet werden, um sich z.B. den öffentlichen Schlüssel anzeigen zu lassen ''openssl ec -in LRW31234567890123-private.pem  -pubout'' bzw. diesen zu speichern''openssl ec -in LRW31234567890123-private.pem -pubout -out LRW31234567890123-public.pem''.
+Der gleiche o.a. Befehl mit 'create' zeigt den öffentlichen Schlüssel an, sofern der private Schlüssel bereits vorhanden ist.
+Die Schlüssel, die mit Hilfe des Tools **//tesla-keygen//** erstellt wurden, können auch mit OpenSSL Tools verarbeitet werden, um sich z.B. den öffentlichen Schlüssel anzeigen zu lassen ''openssl ec -in LRW31234567890123-private.pem  -pubout'' bzw. diesen zu speichern ''openssl ec -in LRW31234567890123-private.pem -pubout -out LRW31234567890123-public.pem''.
 ==== Installation des öffentlichen Schlüssels im Fahrzeug ====
 Erst mit der Installation des öffentlichen Schlüssels eines Schlüsselpaares im Fahrzeug wird der zugehörige private Schlüssel autorisiert und damit schützenswert. Um den Schlüssel zu installieren, empfiehlt es sich ein Laptop zu verwenden und mit diesem eine ssh Verbindung zum Loxberry aufzubauen. So kann man einfach und relativ schnell die notwendigen Schritte im Fahrzeug ausführen, um den öffentlichen Schlüssel zu installieren.
-**Wichtig ist, dass das Fahrzeug wach ist und sich nicht im Schlafmodus befindet!**
 === Senden des Befehls an das Fahrzeug ===
-Im ersten Schritt wird der Befehl zum Installieren des öffentlichen Schlüssels an das Fahrzeug gesendet. Der Befehl **//tesla-control add-key-request//** erfordert dabei die Angabe der VIN, des öffentlichen Schlüssels, der Rolle (entweder **//owner//** oder **//driver//**) und eines Form-Faktors (entweder %%//**nfc_card**, **ios_device**, **android_device** //oder// **cloud_key//**)%%. Nachfolgend ist ein Beispiel angegeben.
+Im ersten Schritt wird der Befehl zum Installieren des öffentlichen Schlüssels an das Fahrzeug gesendet. Dieser Schritt ist mittlerweile ebenfalls in der GUI implementiert und kann über das blaue Auto-Symbol im Menü 'Settings' ausgewählt werden.
+Der Befehl **//tesla-control add-key-request//** erfordert dabei die Angabe der VIN, des öffentlichen Schlüssels, der Rolle (entweder **//owner//** oder **//driver//**) und eines Form-Faktors (entweder %%'**//nfc_card//**', '**//ios_device//**', '**//android_device//**' oder '**//cloud_key//**')%%. Nachfolgend ist ein Beispiel angegeben.
 <code bash>
@@ Zeile 286: / Zeile 407: @@
 Nur wenn die Ausgabe //''Sent add-key request to LRW31234567890123. Confirm by tapping NFC card on center console.''// nach einigen Sekunden angezeigt wird, war der Befehl erfolgreich. Eine Meldung wird auf dem Bildschirm im Fahrzeug zunächst **nicht** angezeigt.
-Man muss beim Absenden des Befehls nicht im Fahrzeug sein. Wichtig ist aber, dass sich das Fahrzeug nicht im Schlafmodus befindet.
+Man muss beim Absenden des Befehls nicht im Fahrzeug sein. Bei einigen Modellen kann es erforderlich sein, dass sich das Fahrzeug nicht im Schlafmodus befindet.
 === Autorisierung des neuen Schlüssels ===
-Der neue Schlüssel wird autorisiert, indem eine der beiden schwarzen NFC Karten, die mit dem Fahrzeug ausgeliefert wurden, auf die Mittelkonsole zwischen Getränkehalter und Armlehne gelegt wird. Dieser Schritt muss innerhalb von 30 Sekunden nach dem o.a. Befehl erfolgen! Erst danach wird eine Meldung angezeigt, die innerhalb von 10 Sekunden bestätigt werden muss.
+Der neue Schlüssel wird autorisiert, indem eine der beiden schwarzen NFC Karten, die mit dem Fahrzeug ausgeliefert wurden, auf die Mittelkonsole zwischen Getränkehalter und Armlehne gelegt wird. Dieser Schritt muss **innerhalb von 30 Sekunden** nach dem o.a. Befehl erfolgen! Erst danach wird eine Meldung angezeigt, die innerhalb von 10 Sekunden bestätigt werden muss.
 {{:plugins:teslacmd:img_1142.jpeg?800}}
-Der Text der Meldung "//Handyschlüssel//-Koppelung" ist zumindest in deutsch nicht korrekt, aber wahrscheinlich hat Tesla sich nicht die Mühe gemacht, eine eigene Meldung für API Schlüssel zu erstellen.
+Der Text der Meldung "//**Handy**schlüssel//-Koppelung" ist nicht ganz korrekt, aber wahrscheinlich hat Tesla sich nicht die Mühe gemacht, eine eigene Meldung für API Schlüssel zu erstellen.
 {{:plugins:teslacmd:img_1143.jpeg?500}}
-Nach der Bestätigung wird der neue Schlüssel in der Liste der autorisierten Schlüssel angezeigt. Das entsprechende Menü heisst **//Verriegelungen//** und ist durch ein Schloss aus Symbol gekennzeichnet. Falls der Schlüssel nicht sichtbar ist, kann man auch nach unten scrollen, was grafisch nicht angezeigt wird.
+Nach der Bestätigung wird der neue Schlüssel in der Liste der autorisierten Schlüssel angezeigt. Das entsprechende Menü heisst **//Verriegelungen//** und ist durch ein Schloss aus Symbol gekennzeichnet. Falls der Schlüssel nicht sichtbar ist, kann man auch nach unten scrollen, was grafisch nicht angezeigt durch einen Balken wird.
 {{:plugins:teslacmd:img_1145.jpeg?800}}
@@ Zeile 371: / Zeile 492: @@
 ===== Roadmap =====
-Dieses Plugin ist im frühen Entwicklungsstand. Ich verwende das Plugin nur zum Befehle an das Auto zusenden, wie z.B. Ladeklappe öffnen, Vorklimatisierung, usw. Ich freue mich, falls jemand Ideen hat und das Projekt weiter mit entwickeln möchte.
+Dieses Plugin ist im Entwicklungsstand. Ich verwende das Plugin derzeit, um zu prüfen, ob das Fahrzeug in der Nähe (i.d.R. im Carport) ist und zum Senden einiger Befehle an das Auto, wie z.B. Ladeklappe öffnen, Vorklimatisierung. Ich freue mich, falls jemand Ideen hat und das Projekt weiter mit entwickeln möchte.
 Mögliche weiter Entwicklungsschritte:
-  * ToDo: integrated wake up via BLE if force option is used (only shown, but not implemented so far)
+  * Bisher keine Feature Requests gestellt.
-  * Erstellen des Schlüsselpaares über das Plugin
-  * Automatische XML Erstellung für Loxone
 ===== Fragen stellen und Fehler melden =====
@@ Zeile 388: / Zeile 507: @@
 pluginuebersicht.logo : :plugins:teslacmd:icon_512.png
 pluginuebersicht.status : BETA
-pluginuebersicht.version : 0.1.9
+pluginuebersicht.version : 0.7.2
 pluginuebersicht.min_lb_version : 2.0
 pluginuebersicht.url_release :
-pluginuebersicht.url_prerelease : https://github.com/Jan21493/LoxBerry-Plugin-TeslaCmd/archive/refs/tags/0.1.9.zip
+pluginuebersicht.url_prerelease : https://github.com/Jan21493/LoxBerry-Plugin-TeslaCmd/archive/refs/tags/0.7.2.zip
 pluginuebersicht.description : Plugin für das von Tesla in 2024 veröffentlichte Tesla Vehicle Command SDK. Über das Plugin können Informationen zu den verwendeten Tesla Produkten abgerufen oder Befehle an die Tesla Produkte gesendet werden. Nachfolger des TeslaConnect Plugins.
 pluginuebersicht.languages : EN

Werkzeuge

Navigationsmenüs und Suche

Wikiübergreifende Schnellsuche

Seitenstatus

Standortanzeiger

Seiten-Werkzeuge

Metainformationen zur Seite

Unterschiede