AndroidDB - Versionsgeschichte

Ph1959de: Modul FireTV verlinkt

2024-01-15T12:18:31Z

Modul FireTV verlinkt

← Nächstältere Version		Version vom 15. Januar 2024, 14:18 Uhr
Zeile 1:		Zeile 1:
	{{Infobox Modul\|ModPurpose=Steuerung von Android Geräten\|ModType=d\|ModForumArea=Sonstiges\|ModTechName=89_AndroidDB\|ModOwner=zap}}		{{Infobox Modul
			\|ModPurpose=Steuerung von Android Geräten
			\|ModType=d
			\|ModForumArea=Sonstiges
			\|ModTechName=89_AndroidDB
			\|ModOwner=zap ({{Link2FU\|10980\|Forum}}/[[Benutzer Diskussion:Zap\|Wiki]])}}
	== Allgemeines ==		== Allgemeines ==
	Die Module AndroidDB und AndroidDBHost erlauben die Steuerung von Android Geräten über die Android Debug Bridge (ADB). Man kann z.B. Befehle auf Android Geräten ausführen, Android Geräte neu starten oder Tastatur- und Touchscreen-Eingaben an Android Geräte senden und so eine Fernbedienung simulieren. Die Module wurden primär entwickelt, um Android TV Geräte zu steuern, sollten aber auch mit Tablets oder Telefonen funktionieren. Ein "rooten" der zu steuernden Geräte ist nicht erforderlich!		Die Module AndroidDB und AndroidDBHost erlauben die Steuerung von Android Geräten über die Android Debug Bridge (ADB). Man kann z.B. Befehle auf Android Geräten ausführen, Android Geräte neu starten oder Tastatur- und Touchscreen-Eingaben an Android Geräte senden und so eine Fernbedienung simulieren. Die Module wurden primär entwickelt, um Android TV Geräte zu steuern, sollten aber auch mit Tablets oder Telefonen funktionieren. Ein "rooten" der zu steuernden Geräte ist nicht erforderlich!
Zeile 90:		Zeile 94:
	Um eine eigene Preset-Datei zu erstellen, kann man die internen Definitionen von AndroidDB mit dem Befehl '''set exportPresets''' als Preset-Datei exportieren und diese Datei dann anpassen:		Um eine eigene Preset-Datei zu erstellen, kann man die internen Definitionen von AndroidDB mit dem Befehl '''set exportPresets''' als Preset-Datei exportieren und diese Datei dann anpassen:
	set myTV exportPresets /home/fhem/android.dat		set myTV exportPresets /home/fhem/android.dat
	Beispiel: Eine Preset-Datei wurde unter dem Namen "/home/fhem/android.dat" angelegt. Sie enthält 2 Presets mit den Namen "SonyTV" und "FireTV".		Beispiel: Eine Preset-Datei wurde unter dem Namen "/home/fhem/android.dat" angelegt. Sie enthält 2 Presets mit den Namen "SonyTV" und "[[FireTV]]".

	Preset-Datei laden:		Preset-Datei laden:
Zeile 105:		Zeile 109:
	Beispiel:		Beispiel:
	[[Datei:SampleRemote.png\|links\|Remote control created by set createRemote command\|alternativtext=\|512x512px]]		[[Datei:SampleRemote.png\|links\|Remote control created by set createRemote command\|alternativtext=\|512x512px]]

	~~[[Kategorie:Android]]~~

	== Erzeugen von Readings ==		== Erzeugen von Readings ==
Zeile 117:		Zeile 119:
	Befehl ausführen:		Befehl ausführen:
	set myDev shell dumpsys power		set myDev shell dumpsys power

			[[Kategorie:Android]]

Zap: Erzeugung von Readings

2022-03-24T10:53:05Z

Erzeugung von Readings

← Nächstältere Version		Version vom 24. März 2022, 12:53 Uhr
Zeile 107:		Zeile 107:

	[[Kategorie:Android]]		[[Kategorie:Android]]

			== Erzeugen von Readings ==
			Die Ausgabe von "shell" Befehlen kann in FHEM Readings konvertiert werden. Voraussetzung ist, dass die Ausgabe eine oder mehrere Zeilen im Format "Parameter=Wert" enthält. Führende Leerzeichen werden dabei automatisch entfernt.

			Zunächst legt man mit dem Attribut createReadings fest, für welche Shell-Befehle Readings erzeugt werden sollen. Das Argument dieses Attributs ist ein regulärer Ausdruck.

			Beispiel: Die Ausgabe des Befehls "set shell dumpsys" soll in Readings gespeichert werden:
			attr myDev createReadings dumpsys
			Befehl ausführen:
			set myDev shell dumpsys power

Zap: Infobox hinzugefügt

2022-03-10T18:03:10Z

Infobox hinzugefügt

← Nächstältere Version		Version vom 10. März 2022, 20:03 Uhr
Zeile 1:		Zeile 1:
			{{Infobox Modul\|ModPurpose=Steuerung von Android Geräten\|ModType=d\|ModForumArea=Sonstiges\|ModTechName=89_AndroidDB\|ModOwner=zap}}

	== Allgemeines ==		== Allgemeines ==
	Die Module AndroidDB und AndroidDBHost erlauben die Steuerung von Android Geräten über die Android Debug Bridge (ADB). Man kann z.B. Befehle auf Android Geräten ausführen, Android Geräte neu starten oder Tastatur- und Touchscreen-Eingaben an Android Geräte senden und so eine Fernbedienung simulieren. Die Module wurden primär entwickelt, um Android TV Geräte zu steuern, sollten aber auch mit Tablets oder Telefonen funktionieren. Ein "rooten" der zu steuernden Geräte ist nicht erforderlich!		Die Module AndroidDB und AndroidDBHost erlauben die Steuerung von Android Geräten über die Android Debug Bridge (ADB). Man kann z.B. Befehle auf Android Geräten ausführen, Android Geräte neu starten oder Tastatur- und Touchscreen-Eingaben an Android Geräte senden und so eine Fernbedienung simulieren. Die Module wurden primär entwickelt, um Android TV Geräte zu steuern, sollten aber auch mit Tablets oder Telefonen funktionieren. Ein "rooten" der zu steuernden Geräte ist nicht erforderlich!

Zap am 24. Februar 2022 um 12:40 Uhr

2022-02-24T12:40:16Z

← Nächstältere Version		Version vom 24. Februar 2022, 14:40 Uhr
Zeile 102:		Zeile 102:
	* Ein Device vom Typ "notify" mit dem Namen "notify_myTV_RC" (Weiterleitung der Tastendrücke aus "myTV_RC" an "myTV")		* Ein Device vom Typ "notify" mit dem Namen "notify_myTV_RC" (Weiterleitung der Tastendrücke aus "myTV_RC" an "myTV")
	Beispiel:		Beispiel:
	[[Datei:SampleRemote.png\|links~~\|mini~~\|Remote control created by set createRemote command]]		[[Datei:SampleRemote.png\|links\|Remote control created by set createRemote command\|alternativtext=\|512x512px]]

	[[Kategorie:Android]]		[[Kategorie:Android]]

Zap am 24. Februar 2022 um 12:39 Uhr

2022-02-24T12:39:14Z

← Nächstältere Version		Version vom 24. Februar 2022, 14:39 Uhr
Zeile 102:		Zeile 102:
	* Ein Device vom Typ "notify" mit dem Namen "notify_myTV_RC" (Weiterleitung der Tastendrücke aus "myTV_RC" an "myTV")		* Ein Device vom Typ "notify" mit dem Namen "notify_myTV_RC" (Weiterleitung der Tastendrücke aus "myTV_RC" an "myTV")
	Beispiel:		Beispiel:
			[[Datei:SampleRemote.png\|links\|mini\|Remote control created by set createRemote command]]

	[[Kategorie:Android]]		[[Kategorie:Android]]

Zap: /* Steuerung von Android Devices in FHEM */

2022-02-24T12:31:28Z

Steuerung von Android Devices in FHEM

← Nächstältere Version		Version vom 24. Februar 2022, 14:31 Uhr
Zeile 59:		Zeile 59:
	set myTV sendkey KEYCODE_1 KEYCODE_2		set myTV sendkey KEYCODE_1 KEYCODE_2
	Eine Liste der Keycodes findet man hier: https://developer.android.com/reference/android/view/KeyEvent		Eine Liste der Keycodes findet man hier: https://developer.android.com/reference/android/view/KeyEvent

			Weitere Befehle zum Senden von Tastatureingaben sind '''set sendNumKeys''' und '''set sendText'''.

	=== Makros ===		=== Makros ===
Zeile 71:		Zeile 73:

	=== Presets ===		=== Presets ===
	Presets sind eine Liste von ~~Macros~~. AndroidDB hat Presets bereits eingebaut für Magenta TV Stick, Magenta One. Man kann eigene Presets in einer Datei definieren und mit dem Attribut 'presetFile' laden. Eine solche Preset-Datei kann mehrere Preset-Definitionen enthalten. Ein Preset kann mit dem Attribut 'preset' ausgewählt werden.		Presets sind eine Liste von Makrodefinitionen. AndroidDB hat Presets bereits eingebaut für Magenta TV Stick, Magenta One. Man kann eigene Presets in einer Datei definieren und mit dem Attribut 'presetFile' laden. Eine solche Preset-Datei kann mehrere Preset-Definitionen enthalten. Ein Preset kann mit dem Attribut 'preset' ausgewählt werden.

	Eine Preset-Datei hat folgenden Aufbau:<syntaxhighlight lang="text">		Eine Preset-Datei hat folgenden Aufbau:<syntaxhighlight lang="text">
	# Kommentar		# Kommentar
	PresetName1		PresetName1
	MacroName1:~~KeyCode~~[,...]		MacroName1:MacroDef1[,...]
	MacroName2:~~KeyCode~~[,...]		MacroName2:MacroDef2[,...]
	...		...
	PresetName2		PresetName2
	...		...

	</syntaxhighlight>Beispiel: Eine Preset-Datei wurde unter dem Namen "/home/fhem/android.dat" angelegt. Sie enthält 2 Presets mit den Namen "SonyTV" und "FireTV".		</syntaxhighlight>Ein ''MacroName'' darf keine Leerzeichen enthalten. Der Parameter ''MacroDef'' steht entweder für eine Liste von Keycodes oder einen ADB-Befehl. Siehe auch Abschnitt "Makros".

			Um eine eigene Preset-Datei zu erstellen, kann man die internen Definitionen von AndroidDB mit dem Befehl '''set exportPresets''' als Preset-Datei exportieren und diese Datei dann anpassen:
			set myTV exportPresets /home/fhem/android.dat
			Beispiel: Eine Preset-Datei wurde unter dem Namen "/home/fhem/android.dat" angelegt. Sie enthält 2 Presets mit den Namen "SonyTV" und "FireTV".

	Preset-Datei laden:		Preset-Datei laden:
	attr myTV presetFile /home/fhem/android.dat		attr myTV presetFile /home/fhem/android.dat
	Preset auswählen:		Preset auswählen:
	attr myTV preset SonyTV		attr myTV preset SonyTV
	[[Kategorie:Android]]
			=== Fernbedienungen ===
			AndroidDB unterstützt das Anlegen von Remotecontrol-Devices mit dem FHEM Modul remotecontrol. Für die eingebauten Presets kann eine Fernbedienung mit dem Befehl set createRemote angelegt werden:
			set myTV createRemote MagentaOne
			AndroidDB legt damit zwei neue FHEM devices an:
			* Ein Device vom Typ "remotecontrol" mit dem Namen "myTV_RC"
			* Ein Device vom Typ "notify" mit dem Namen "notify_myTV_RC" (Weiterleitung der Tastendrücke aus "myTV_RC" an "myTV")
			Beispiel:

			[[Kategorie:Android]]

Zap: /* Makros */

2022-02-24T12:17:40Z

Makros

← Nächstältere Version		Version vom 24. Februar 2022, 14:17 Uhr
Zeile 61:		Zeile 61:

	=== Makros ===		=== Makros ===
	Ein Makro fasst eine Folge von Tastatureingaben unter einem Befehl zusammen~~, der dann~~ mit dem Befehl remoteControl ausgeführt ~~wird~~.		Ein Makro fasst eine Folge von Tastatureingaben oder einen ADB-Befehl unter einem Befehl zusammen. Tastaturmakros können anschließend mit dem Befehl '''set remoteControl''' ausgeführt werden. Makros für ADB-Befehle stehen als set-Befehle zur Verfügung.

	Beispiel: Es wird ein Makro "DasErste" definiert, bei dessen Ausführung die Sequenz "0001" an ein Android TV Gerät gesendet wird:		Beispiel: Es wird ein Makro "DasErste" definiert, bei dessen Ausführung die Sequenz "0001" an ein Android TV Gerät gesendet wird:
	attr myTV macros DasErste:KEYCODE_0,KEYCODE_0,KEYCODE_0,KEYCODE_1		attr myTV macros DasErste:KEYCODE_0,KEYCODE_0,KEYCODE_0,KEYCODE_1

	set myTV remoteControl DasErste		set myTV remoteControl DasErste
			Beispiel: Es wird ein Makro "listPackages" zum Auflisten aller Apps definiert, die auf einem Android-Device installiert sind:
			attr myTV macros listPackages:shell pm list packages
			set myTV listPackages

	=== Presets ===		=== Presets ===
Zeile 86:		Zeile 88:
	Preset auswählen:		Preset auswählen:
	attr myTV preset SonyTV		attr myTV preset SonyTV
	[[Kategorie:Android]]		[[Kategorie:Android]]

Zap: Makros und Presets

2022-02-15T09:22:53Z

Makros und Presets

← Nächstältere Version		Version vom 15. Februar 2022, 11:22 Uhr
Zeile 50:		Zeile 50:

	== Steuerung von Android Devices in FHEM ==		== Steuerung von Android Devices in FHEM ==
	~~Nun kann man sein Android Gerät steuern.~~ Eine der nützlichsten Funktionen dürfte das Senden von Tastendrücken sein. So kann man in FHEM eine ~~Fernbedieung~~ realisieren.
			=== Tastatureingaben senden ===
			Eine der nützlichsten Funktionen dürfte das Senden von Tastendrücken sein. So kann man in FHEM eine Fernbedienung oder auch die Sprachsteuerung von Android Geräten realisieren.

	Beispiel: Home-Taste drücken		Beispiel: Home-Taste drücken
			set myTV sendKey KEYCODE_HOME
			Beispiel: Umschalten auf Programm 12 / mehrere Keycodes senden:
			set myTV sendkey KEYCODE_1 KEYCODE_2
			Eine Liste der Keycodes findet man hier: https://developer.android.com/reference/android/view/KeyEvent

	~~Code: [Auswählen]~~		=== Makros ===
			Ein Makro fasst eine Folge von Tastatureingaben unter einem Befehl zusammen, der dann mit dem Befehl remoteControl ausgeführt wird.
	~~<code>set myTV sendKey KEYCODE_HOME</code>~~

	~~Beispiel: Umschalten auf Programm 12~~

	~~Code: [Auswählen]~~

	~~<code>set myTV sendKey KEYCODE_0 KEYCODE_0 KEYCODE_1 KEYCODE_2</code>(die beiden führenden 0en könnte man weglassen~~, dann ~~dauert das Umschalten aber länger, da das Gerät wartet, ob weitere Tasten kommen)~~

	~~Eine Liste der Keycodes findet man hier: <nowiki>https://developer.android.com/reference/android/view/KeyEvent</nowiki>~~

	~~'''Presets'''~~

	~~Ich habe einige Presets hinterlegt (am Beispiel eines Magenta TV Sticks). Ein Preset kann mit dem Attribut 'preset' eingestellt werden. Alternativ kann man~~ mit dem ~~Attribut 'macro' eigene RemoteControl Befehle definieren. Ein solcher~~ Befehl ~~kann mehrere Tastendrücke senden.~~

	~~Nach der Auswahl eines Presets kann man Befehle etwas abkürzen, z.B~~.:

	~~Code: [Auswählen]~~

	~~<code>set myTVStick remoteControl APPS</code>~~

	~~<code>set myTVStick remoteControl EPG</code>~~		Beispiel: Es wird ein Makro "DasErste" definiert, bei dessen Ausführung die Sequenz "0001" an ein Android TV Gerät gesendet wird:
			attr myTV macros DasErste:KEYCODE_0,KEYCODE_0,KEYCODE_0,KEYCODE_1

	~~Mit Macros:~~		set myTV remoteControl DasErste

	~~Code: [Auswählen]~~		=== Presets ===
			Presets sind eine Liste von Macros. AndroidDB hat Presets bereits eingebaut für Magenta TV Stick, Magenta One. Man kann eigene Presets in einer Datei definieren und mit dem Attribut 'presetFile' laden. Eine solche Preset-Datei kann mehrere Preset-Definitionen enthalten. Ein Preset kann mit dem Attribut 'preset' ausgewählt werden.

	<~~code~~>~~attr myTV macros DasErste~~:~~KEYCODE_0~~,~~KEYCODE_0~~,~~KEYCODE_0,KEYCODE_1</code>~~		Eine Preset-Datei hat folgenden Aufbau:<syntaxhighlight lang="text">
			# Kommentar
			PresetName1
			MacroName1:KeyCode[,...]
			MacroName2:KeyCode[,...]
			...
			PresetName2
			...

	<~~code~~>~~set myTV remoteControl DasErste<~~/~~code>~~		</syntaxhighlight>Beispiel: Eine Preset-Datei wurde unter dem Namen "/home/fhem/android.dat" angelegt. Sie enthält 2 Presets mit den Namen "SonyTV" und "FireTV".

	~~'''In Arbeit~~:~~'''~~		Preset-Datei laden:
			attr myTV presetFile /home/fhem/android.dat
			Preset auswählen:
			attr myTV preset SonyTV
	[[Kategorie:Android]]		[[Kategorie:Android]]

Zap am 15. Februar 2022 um 08:57 Uhr

2022-02-15T08:57:52Z

← Nächstältere Version		Version vom 15. Februar 2022, 10:57 Uhr
Zeile 87:		Zeile 87:

	'''In Arbeit:'''		'''In Arbeit:'''
	~~[[Kategorie:Hardware]]~~
	[[Kategorie:Android]]		[[Kategorie:Android]]

Zap am 15. Februar 2022 um 08:52 Uhr

2022-02-15T08:52:39Z

← Nächstältere Version		Version vom 15. Februar 2022, 10:52 Uhr
Zeile 27:		Zeile 27:
	== Definition eines I/O Device (AndroidDBHost) ==		== Definition eines I/O Device (AndroidDBHost) ==
	Je FHEM Instanz gibt es nur 1 I/O Device. Die Syntax für die Definition sieht so aus:		Je FHEM Instanz gibt es nur 1 I/O Device. Die Syntax für die Definition sieht so aus:
			define ''Name'' AndroidDBHost [adb=''Pfadangabe'']
			Die Angabe des Parameters 'adb' ist nur erforderlich, wenn sich der Befehl 'adb' nicht im Suchpfad für ausführbare Programme befindet. Beispiel:
			define myADBServer AndroidDBHost adb=/usr/local/platform-tools/adb

	~~define Name AndroidDBHost [adb~~=~~Pfadangabe]~~		== Defintion von Android Devices in FHEM (AndroidDB) ==

	~~Die Angabe des Parameters 'adb' ist nur erforderlich, wenn sich der Befehl 'adb' nicht im Suchpfad für ausführbare Programme befindet. Beispiel:<syntaxhighlight>~~		=== Android Gerät vorbereiten ===
	~~define myADBServer AndroidDBHost adb~~=~~/usr/local/platform-tools/adb~~		Auf jedem Android Device, das über AndroidDB gesteuert werden soll, muss der Entwicklermodus aktiviert und das USB Debugging eingeschaltet sein. Dies sollte auf jedem Android Gerät ohne "root" Berechtigung möglich sein.
	~~</syntaxhighlight>~~

	~~'''Defintion von~~ Android ~~Devices in FHEM'''~~

	~~Voraussetzung:~~ Auf jedem Android Device, das über AndroidDB gesteuert werden soll, muss der Entwicklermodus aktiviert und das USB Debugging eingeschaltet sein. ~~Das~~ Gerät ~~muss nicht(!) gerootet~~ sein.

	Die Aktivierung des Entwicklermodus kann sich von Gerät zu Gerät etwas unterscheiden, ist aber meist ähnlich. Bei Android TV Geräten geht man so vor (einmalige Aktion je Gerät):		Die Aktivierung des Entwicklermodus kann sich von Gerät zu Gerät etwas unterscheiden, ist aber meist ähnlich. Bei Android TV Geräten geht man so vor (einmalige Aktion je Gerät):
			# Sollte das Android Gerät einen USB-Anschluss haben, sollte daran kein Gerät angeschlossen sein (z.B. LAN-Adapter bei TV Geräten)
			# Auf dem Android Gerät ''Geräteeinstellungen'' > ''Info'' auswählen
			# Ganz nach unten scrollen bis zu einer Angabe, die meistens "Build" oder "Version" heißt
			# Auf diese Angabe wiederholt drücken. Android zeigt dann irgendwann die Meldung "in X Schritten bist Du Entwickler" an. Dann noch X Mal drücken bis "Du bist jetzt Entwickler" angezeigt wird
			# Nun unter Geräteeinstellungen > Entwickleroptionen das USB-Debugging einschalten (heißt zwar USB, die Verbindung erfolgt aber über das Netzwerk)
			# Sollte sich das USB-Debugging nicht aktivieren lassen, das Android Gerät neu starten. Dies kann vorkommen, wenn ein Gerät per USB angeschlossen war (siehe 1)

	~~- Geräteeinstellungen > Info auswählen~~		=== AndroidDB Device in FHEM definieren ===
			Nun kann man ein AndroidDB Device in FHEM definieren:
	~~- Ganz nach unten scrollen bis zu einer Angabe, die meistens "Build" oder "Version" heißt~~		define myTV AndroidDB 192.168.1.100

	~~- Auf diese Angabe wiederholt drücken. Android zeigt dann irgendwann "~~in ~~X Schritten bist Du Entwickler" an. Dann noch X Mal drücken bis "Du bist jetzt Entwickler" angezeigt wird~~

	~~- Nun unter Geräteeinstellungen > Entwickleroptionen das USB-Debugging einschalten (heißt zwar USB, die Verbindung erfolgt aber über das Netzwerk)~~

	Nun kann man ein AndroidDB ~~Gerät~~ in FHEM definieren:

	~~Code: [Auswählen]~~

	~~<code>~~define myTV AndroidDB 192.168.1.100~~</code>~~

	Einziger Parameter ist die IP-Adresse des Android-Geräts (man sollte eine feste IP zuordnen). Beim ersten Zugriff auf das Gerät kann es sein, dass man auf dem Gerät einmal die Verbindung von FHEM zulassen muss. In dem Fall sollte man den Haken bei "Zugriff immer erlauben" setzen.		Einziger Parameter ist die IP-Adresse des Android-Geräts (man sollte eine feste IP zuordnen). Beim ersten Zugriff auf das Gerät kann es sein, dass man auf dem Gerät einmal die Verbindung von FHEM zulassen muss. In dem Fall sollte man den Haken bei "Zugriff immer erlauben" setzen.

			== Steuerung von Android Devices in FHEM ==
	Nun kann man sein Android Gerät steuern. Eine der nützlichsten Funktionen dürfte das Senden von Tastendrücken sein. So kann man in FHEM eine Fernbedieung realisieren.		Nun kann man sein Android Gerät steuern. Eine der nützlichsten Funktionen dürfte das Senden von Tastendrücken sein. So kann man in FHEM eine Fernbedieung realisieren.

Zeile 93:		Zeile 87:

	'''In Arbeit:'''		'''In Arbeit:'''
			[[Kategorie:Hardware]]
			[[Kategorie:Android]]