Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
plugins:teslacmd:start [2024/12/27 15:04] – Version 0.5.0 - Many enhancements Jan Wachsmuthplugins:teslacmd:start [2025/02/09 10:56] (aktuell) – Jan Wachsmuth
Zeile 2: Zeile 2:
  
 ++++ Version history ... | ++++ 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: Version 0.5.0:
Zeile 11: Zeile 39:
   * Show function blocks for outputs and output commands that can be copied to Loxone config   * 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.   * **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: Version 0.2.4:
Zeile 22: Zeile 52:
 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. 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+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. The TeslaCmd plugin supports all new commands and options for 'tesla-control' and 'tesla-keygen'. Updated binaries for 64-bit Raspberry are included.
Zeile 200: Zeile 230:
 | **software_update_cancel**  | %%Cancel a pending software update.%%  | | **software_update_cancel**  | %%Cancel a pending software update.%%  |
 | **guest_mode_off**  | %%Disable Guest Mode.%%  | | **guest_mode_off**  | %%Disable Guest Mode.%%  |
-| **guest_mode_on**  | %%Enable Guest Mode. See https://developer.tesla.com/docs/fleet-api/endpoints/vehicle-commands#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.%% | | **erase_guest_data** | %%Erase Guest Mode user data.%% |
 | **add_key** | %%Add PUBLIC_KEY to vehicle whitelist with ROLE and FORM_FACTOR.%% | | **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.%% | | **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 ^ ^ Befehl ^ Beschreibung ^
Zeile 213: Zeile 243:
 | %%SITE_PROGRAMS%% | %%Retrieves energy site program information.%% | | %%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.%% | | %%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.%% |
 +
 +=== Befehle für Powerwall / Energy Site ===
 +
 +^ Befehl ^ Beschreibung ^
 +| %%BACKUP%% | %%Adjust the site's backup reserve.%% |
 +| %%GRID_IMPORT_EXPORT%% | %%Allow/disallow charging from the grid and exporting energy to the grid.%% |
 +| %%OFF_GRID_VEHICLE_CHARGING_RESERVE%% | %%Adjust the site's off-grid vehicle charging backup reserve.%% |
 +| %%OPERATION%% | %%Use autonomous for time-based control and self_consumption for self-powered mode.%% |
 +| %%STORM_MODE%% | %%Update storm watch participation.%% |
 +| %%TIME_OF_USE_SETTINGS%% | %%Update the time of use settings for the energy site.%% |
  
 ===== Voraussetzungen ===== ===== Voraussetzungen =====
Zeile 231: 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 [[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 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 ==== ==== 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) ü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 === === Installation von Golang ===
Zeile 271: Zeile 318:
 # 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/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/ cd vehicle-command/
 # if not set yet: export PATH=$PATH:/opt/loxberry/golang/go/bin # if not set yet: export PATH=$PATH:/opt/loxberry/golang/go/bin
Zeile 306: Zeile 355:
 cd /opt/loxberry cd /opt/loxberry
 mv ./vehicle-command/cmd/tesla-control/tesla-control /usr/local/bin/ mv ./vehicle-command/cmd/tesla-control/tesla-control /usr/local/bin/
-mv ./vehicle-command/cm/tesla-keygen/tesla-keygen /usr/local/bin/ 
-mv ./vehicle-command/cm/tesla-keygen/tesla-scan /usr/local/bin/ 
 setcap 'cap_net_admin=eip' /usr/local/bin/tesla-control 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 setcap 'cap_net_admin=eip' /usr/local/bin/tesla-scan
 exit exit
Zeile 335: Zeile 384:
 tesla-keygen -f -key-file LRW31234567890123-private.pem create > LRW31234567890123-public.pem tesla-keygen -f -key-file LRW31234567890123-private.pem create > LRW31234567890123-public.pem
 </code> </code>
 +
 +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''. 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''.
Zeile 445: Zeile 496:
 Mögliche weiter Entwicklungsschritte:  Mögliche weiter Entwicklungsschritte: 
  
-  * Automatische XML Erstellung für Loxone+  * Bisher keine Feature Requests gestellt.
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
Zeile 456: Zeile 507:
 pluginuebersicht.logo : :plugins:teslacmd:icon_512.png pluginuebersicht.logo : :plugins:teslacmd:icon_512.png
 pluginuebersicht.status : BETA pluginuebersicht.status : BETA
-pluginuebersicht.version : 0.5.0+pluginuebersicht.version : 0.7.2
 pluginuebersicht.min_lb_version : 2.0 pluginuebersicht.min_lb_version : 2.0
 pluginuebersicht.url_release :  pluginuebersicht.url_release : 
-pluginuebersicht.url_prerelease : https://github.com/Jan21493/LoxBerry-Plugin-TeslaCmd/archive/refs/tags/0.5.0.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.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 pluginuebersicht.languages : EN