SWAP - Versionsgeschichte

Ph1959de: Überflüssiges "SEITENTITEL" entfernt

2017-08-04T08:39:15Z

Überflüssiges "SEITENTITEL" entfernt

← Nächstältere Version		Version vom 4. August 2017, 10:39 Uhr
Zeile 1:		Zeile 1:
	~~{{SEITENTITEL:SWAP}}~~

	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Modul zur generischen Ansteuerung sämtlicher panStamp Boards.		\|ModPurpose=Modul zur generischen Ansteuerung sämtlicher panStamp Boards.
Zeile 10:		Zeile 8:
	\|ModOwner=André/ justme1968 ({{Link2FU\|430\|Forum}} / [[Benutzer Diskussion:Justme\|Wiki]])		\|ModOwner=André/ justme1968 ({{Link2FU\|430\|Forum}} / [[Benutzer Diskussion:Justme\|Wiki]])
	}}		}}


	[[SWAP]] ist das Basismodul für die Unterstützung der panStamp Baugruppen. Zur Kommunikation in einem panStamp Netzwerk dient das ''Simple Wireless Abstract Protocol'' ([https://github.com/panStamp/panstamp/wiki/Simple%20Wireless%20Abstract%20Protocol SWAP]).		[[SWAP]] ist das Basismodul für die Unterstützung der panStamp Baugruppen. Zur Kommunikation in einem panStamp Netzwerk dient das ''Simple Wireless Abstract Protocol'' ([https://github.com/panStamp/panstamp/wiki/Simple%20Wireless%20Abstract%20Protocol SWAP]).

Markusbloch: Ersetzung von Forum-Links mit Vorlage Link2Forum

2017-03-19T19:50:54Z

Ersetzung von Forum-Links mit Vorlage Link2Forum

← Nächstältere Version		Version vom 19. März 2017, 21:50 Uhr
Zeile 132:		Zeile 132:
	Mit Hilfe der im jeweiligen Device Definition File hinterlegten Beschreibung werden hierzu automatisch userReadings angelegt (Wenn den Endpoints eine Unit mit Factor zugewiesen ist) die neben den reinen Registerwerten in hex auch ''menschenlesbare'' readings der Sensorwerte erzeugen.		Mit Hilfe der im jeweiligen Device Definition File hinterlegten Beschreibung werden hierzu automatisch userReadings angelegt (Wenn den Endpoints eine Unit mit Factor zugewiesen ist) die neben den reinen Registerwerten in hex auch ''menschenlesbare'' readings der Sensorwerte erzeugen.
	Damit dies funktioniert, muss das Attribut ProductCode korrekt gesetzt sein. Das geschieht normalerweise automatisch beim Anlegen des Device.		Damit dies funktioniert, muss das Attribut ProductCode korrekt gesetzt sein. Das geschieht normalerweise automatisch beim Anlegen des Device.
	Das entsprechende Device Definition File liegt unter ./FHEM/lib/SWAP wie hier beschrieben ~~[http://forum.fhem.de/index.php/topic,~~12487~~.msg86257.html#msg86257]~~.		Das entsprechende Device Definition File liegt unter ./FHEM/lib/SWAP wie hier beschrieben {{Link2Forum\|Topic=12487\|Message=86257}}.

	Hier Beispielhaft anhand eines BMP085 Temperatur- und Luftdrucksensors dargestellt:		Hier Beispielhaft anhand eines BMP085 Temperatur- und Luftdrucksensors dargestellt:

Markusbloch: Anpassung von Links an neues Repository

2016-12-15T22:16:25Z

Anpassung von Links an neues Repository

← Nächstältere Version		Version vom 16. Dezember 2016, 00:16 Uhr
Zeile 219:		Zeile 219:
	Ein Artikel über ein selbst entwickeltes panStamp Batterieboard zum Anschluss von Analogsensoren/1Wire und Solarversorgung ist hier [[Bodenfeuchtesensor]] beschrieben. Die Weiterentwicklung zum Umweltsensor ist hier [[panStamp_Umweltsensor]] beschrieben.		Ein Artikel über ein selbst entwickeltes panStamp Batterieboard zum Anschluss von Analogsensoren/1Wire und Solarversorgung ist hier [[Bodenfeuchtesensor]] beschrieben. Die Weiterentwicklung zum Umweltsensor ist hier [[panStamp_Umweltsensor]] beschrieben.

	Eine für einen Vegetronix Sensor angepasste Version kann ~~von~~ [~~http~~://~~sourceforge~~.~~net/p/~~fhem/~~code/HEAD~~/~~tree~~/trunk/fhem/contrib/arduino/ ~~sourceforge~~] heruntergeladen werden. Das ~~Übertragungsintervall~~ ist wie üblich über das Register <code>0A</code> konfigurierbar. Der Sensor wird an GND, D7 für die Versorgungsspannung und A4 für den Messwert angeschlossen. Erfahrungen haben gezeigt, dass bei einem fünfminütigen ~~Übertragungsintervall~~ nach 12 Monaten Laufzeit die Batteriespannung von 1.55V auf 1.4V abfällt. Das würde bedeuten, dass eine Batterie im Batterieboard mindestens eine Laufzeit von drei Jahren haben sollte.		Eine für einen Vegetronix Sensor angepasste Version kann aus dem [https://svn.fhem.de/trac/browser/trunk/fhem/contrib/arduino/ FHEM-Repository] heruntergeladen werden. Das Übertragungsinterval ist wie üblich über das Register <code>0A</code> konfigurierbar. Der Sensor wird an GND, D7 für die Versorgungsspannung und A4 für den Messwert angeschlossen. Erfahrungen haben gezeigt, dass bei einem fünfminütigen Übertragungsinterval nach 12 Monaten Laufzeit die Batteriespannung von 1.55V auf 1.4V abfällt. Das würde bedeuten, dass eine Batterie im Batterieboard mindestens eine Laufzeit von drei Jahren haben sollte.

	<code>set <MyBodenfeuchte> stateFormat VWC_A%</code>		<code>set <MyBodenfeuchte> stateFormat VWC_A%</code>

Joshi04: Link zu panStick ersetzt

2016-06-12T15:19:55Z

Link zu panStick ersetzt

← Nächstältere Version		Version vom 12. Juni 2016, 17:19 Uhr
Zeile 43:		Zeile 43:
	=== Define ===		=== Define ===
	'''Info: Das SWAP Modul unterstützt autocreate. Bei der Inbetriebnahme sollte autocreate aktiviert sein, da dies die Einrichtung deutlich vereinfacht.'''		'''Info: Das SWAP Modul unterstützt autocreate. Bei der Inbetriebnahme sollte autocreate aktiviert sein, da dies die Einrichtung deutlich vereinfacht.'''
	Wenn der [[panStick]] läuft, sollten die SWAP-Devices per autocreate angelegt werden, sobald sie das erste Mal senden, z.B. nach dem Einschalten oder nach einem Reset. Normalerweise werden beim autocreate alle Werte abgefragt und angezeigt. Das geht normalerweise ohne jedes Zutun.		Wenn der [[panStamp#panStick/Shield\|panStick]] läuft, sollten die SWAP-Devices per autocreate angelegt werden, sobald sie das erste Mal senden, z.B. nach dem Einschalten oder nach einem Reset. Normalerweise werden beim autocreate alle Werte abgefragt und angezeigt. Das geht normalerweise ohne jedes Zutun.

	panStick rein -> broadcast -> discovery -> anlegen.		panStick rein -> broadcast -> discovery -> anlegen.
Zeile 59:		Zeile 59:
	Die anderen Adressen sind wie folgt belegt:		Die anderen Adressen sind wie folgt belegt:
	* <code>00</code> ist die Broadcast-ID		* <code>00</code> ist die Broadcast-ID
	* <code>01</code> ist die ID des [[panStick]] am FHEM-System		* <code>01</code> ist die ID des panStick am FHEM-System
	* <code>FF</code> ist die Default ID, die jeder panStamp im Auslieferungszustand besitzt		* <code>FF</code> ist die Default ID, die jeder panStamp im Auslieferungszustand besitzt
	* <code>F0-FE</code> sind die IDs, auf die autocreate die Adresse automatisch ändert, wenn ein neuer mit der ID <code>FF</code> erkannt wird und kein entsprechender Device-Name definiert ist.		* <code>F0-FE</code> sind die IDs, auf die autocreate die Adresse automatisch ändert, wenn ein neuer mit der ID <code>FF</code> erkannt wird und kein entsprechender Device-Name definiert ist.

Justme: /* Device Definition File */

2016-05-04T10:10:26Z

Device Definition File

← Nächstältere Version		Version vom 4. Mai 2016, 12:10 Uhr
Zeile 137:		Zeile 137:

	<code>		<code>
	attr ~~temppress~~ userReadings voltage:0B-Voltage.* {hex(ReadingsVal($name,"0B-Voltage","0"))0.001}, temperature:0C.0-Temperature {hex(ReadingsVal($name,"0C.0-Temperature","0"))0.1-50}, pressure:0C.1-Pressure {hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01}, pressureNN:0C.1-Pressure {sprintf("%.2f",hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01 + AttrVal("global", "altitude", 0)/8.5)}		attr temp press userReadings voltage:0B-Voltage.* {hex(ReadingsVal($name,"0B-Voltage","0"))0.001}, temperature:0C.0-Temperature. {hex(ReadingsVal($name,"0C.0-Temperature","0"))0.1-50}, pressure:0C.1-Pressure. {hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01}, pressureNN:0C.1-Pressure. {sprintf("%.2f",hex(ReadingsVal($name,"0C.1-Pressure","0"))*0.01 + AttrVal("global", "altitude", 0)/8.5)}
	</code>		</code>

Krikan: /* Device Definition File */ -> Anpassung an geändertes trigger-Verhalten userReadings

2016-05-04T08:47:21Z

Device Definition File: -> Anpassung an geändertes trigger-Verhalten userReadings

← Nächstältere Version		Version vom 4. Mai 2016, 10:47 Uhr
Zeile 137:		Zeile 137:

	<code>		<code>
	attr temppress userReadings voltage:0B-Voltage {hex(ReadingsVal($name,"0B-Voltage","0"))0.001}, temperature:0C.0-Temperature {hex(ReadingsVal($name,"0C.0-Temperature","0"))0.1-50}, pressure:0C.1-Pressure {hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01}, pressureNN:0C.1-Pressure {sprintf("%.2f",hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01 + AttrVal("global", "altitude", 0)/8.5)}		attr temppress userReadings voltage:0B-Voltage.* {hex(ReadingsVal($name,"0B-Voltage","0"))0.001}, temperature:0C.0-Temperature {hex(ReadingsVal($name,"0C.0-Temperature","0"))0.1-50}, pressure:0C.1-Pressure {hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01}, pressureNN:0C.1-Pressure {sprintf("%.2f",hex(ReadingsVal($name,"0C.1-Pressure","0"))0.01 + AttrVal("global", "altitude", 0)/8.5)}
	</code>		</code>

Justme am 9. August 2015 um 09:17 Uhr

2015-08-09T09:17:03Z

← Nächstältere Version		Version vom 9. August 2015, 11:17 Uhr
Zeile 2:		Zeile 2:

	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Modul zur ~~allgemeinen~~ Ansteuerung sämtlicher panStamp Boards.		\|ModPurpose=Modul zur generischen Ansteuerung sämtlicher panStamp Boards.
	\|ModType=d		\|ModType=d
	\|ModCmdRef=SWAP		\|ModCmdRef=SWAP

TeeVau: Schreibweise auf panStamp (kleines p)

2015-08-06T14:01:31Z

Schreibweise auf panStamp (kleines p)

TeeVau: Rechtschreibfehler korrigiert und Baustelle entfernt

2015-08-06T06:23:49Z

Rechtschreibfehler korrigiert und Baustelle entfernt

Änderungen zeigen

TeeVau am 23. Juli 2015 um 13:57 Uhr

2015-07-23T13:57:43Z

Änderungen zeigen

← Nächstältere Version		Version vom 6. August 2015, 16:01 Uhr
Zeile 2:		Zeile 2:

	{{Infobox Modul		{{Infobox Modul
	\|ModPurpose=Modul zur allgemeinen Ansteuerung sämtlicher ~~PanStamp~~ Boards.		\|ModPurpose=Modul zur allgemeinen Ansteuerung sämtlicher panStamp Boards.
	\|ModType=d		\|ModType=d
	\|ModCmdRef=SWAP		\|ModCmdRef=SWAP
Zeile 12:		Zeile 12:


	[[SWAP]] ist das Basismodul für die Unterstützung der ~~PanStamp~~ Baugruppen. Zur Kommunikation in einem ~~PanStamp~~ Netzwerk dient das ''Simple Wireless Abstract Protocol'' ([https://github.com/panStamp/panstamp/wiki/Simple%20Wireless%20Abstract%20Protocol SWAP]).		[[SWAP]] ist das Basismodul für die Unterstützung der panStamp Baugruppen. Zur Kommunikation in einem panStamp Netzwerk dient das ''Simple Wireless Abstract Protocol'' ([https://github.com/panStamp/panstamp/wiki/Simple%20Wireless%20Abstract%20Protocol SWAP]).
	Die komplette SWAP- Kommunikation ist registerbasiert und erfolgt mit Nachrichten um diese Register abzufragen, zu setzen und deren Inhalt zu senden. Alle Register lassen sich lesen, manche auch beschreiben. Für eine tiefgreifende FHEM Integration können weitere Module (wie z.B. [[SWAP_0000002200000003]]) vorhanden sein. Diese Module bauen, als 3. Ebene, auf das SWAP Modul (2. Ebene) auf und bedienen im backend ebenfalls die panStamp-Hardware über die Register. Der panStamp Software Stack unterstützt einen stromsparenden Power-Down- oder Sleep-Modus für batteriebetriebene Sensoren, aus dem diese dann nur zur eigentlichen Messung und Übertragung "aufwachen".		Die komplette SWAP- Kommunikation ist registerbasiert und erfolgt mit Nachrichten um diese Register abzufragen, zu setzen und deren Inhalt zu senden. Alle Register lassen sich lesen, manche auch beschreiben. Für eine tiefgreifende FHEM Integration können weitere Module (wie z.B. [[SWAP_0000002200000003]]) vorhanden sein. Diese Module bauen, als 3. Ebene, auf das SWAP Modul (2. Ebene) auf und bedienen im backend ebenfalls die panStamp-Hardware über die Register. Der panStamp Software Stack unterstützt einen stromsparenden Power-Down- oder Sleep-Modus für batteriebetriebene Sensoren, aus dem diese dann nur zur eigentlichen Messung und Übertragung "aufwachen".

Zeile 18:		Zeile 18:
	Für den Betrieb ist XML:Simple notwendig, dass bei Bedarf folgendermaßen nachinstalliert werden kann [http://forum.fhem.de/index.php?topic=12487.msg87373#msg87373].		Für den Betrieb ist XML:Simple notwendig, dass bei Bedarf folgendermaßen nachinstalliert werden kann [http://forum.fhem.de/index.php?topic=12487.msg87373#msg87373].
	sudo apt-get install libxml-simple-perl		sudo apt-get install libxml-simple-perl
	Diese Abhängigkeit kann beim Betrieb auf einer Fritzbox ebenfalls zu Problemen führen. Das [[SWAP]] Modul greift auf das [[~~PanStamp~~]] Modul zu, was vorher per <code>define</code> angelegt werden muss.		Diese Abhängigkeit kann beim Betrieb auf einer Fritzbox ebenfalls zu Problemen führen. Das [[SWAP]] Modul greift auf das [[panStamp]] Modul zu, was vorher per <code>define</code> angelegt werden muss.

	== Anwendung ==		== Anwendung ==
Zeile 39:		Zeile 39:
	* Es ist möglich direkt Endpoints (Teile eines Registers) zu schreiben		* Es ist möglich direkt Endpoints (Teile eines Registers) zu schreiben
	* (Fast) keine hardkodierte Sonderbehandlung mehr für das RGB-Board. Das SWAP Modul kann mit jedem beliebige Swap Device umgehen.		* (Fast) keine hardkodierte Sonderbehandlung mehr für das RGB-Board. Das SWAP Modul kann mit jedem beliebige Swap Device umgehen.
	* Es gibt eine dritte (optionale) Modulebene neben dem [[~~PanStamp~~]] FHEM-Modul (1. Ebene) für die Hardware und dem SWAP Modul (2. Ebene) für das Protokoll. Mit dem generellen SWAP Modul lasen sich alle SWAP Devices ''zu Fuß'' über die Register ansprechen. Um die Register auf einer höheren Ebene auf FHEM Kommandos wie on/off/on-for-timer zu mappen ist dann ein Modul der 3. Ebene notwendig. {{Link2Forum\|Topic=12487 \|Message=78502 }}		* Es gibt eine dritte (optionale) Modulebene neben dem [[panStamp]] FHEM-Modul (1. Ebene) für die Hardware und dem SWAP Modul (2. Ebene) für das Protokoll. Mit dem generellen SWAP Modul lasen sich alle SWAP Devices ''zu Fuß'' über die Register ansprechen. Um die Register auf einer höheren Ebene auf FHEM Kommandos wie on/off/on-for-timer zu mappen ist dann ein Modul der 3. Ebene notwendig. {{Link2Forum\|Topic=12487 \|Message=78502 }}

	=== Define ===		=== Define ===
Zeile 45:		Zeile 45:
	Wenn der [[panStick]] läuft, sollten die SWAP-Devices per autocreate angelegt werden, sobald sie das erste Mal senden, z.B. nach dem Einschalten oder nach einem Reset. Normalerweise werden beim autocreate alle Werte abgefragt und angezeigt. Das geht normalerweise ohne jedes Zutun.		Wenn der [[panStick]] läuft, sollten die SWAP-Devices per autocreate angelegt werden, sobald sie das erste Mal senden, z.B. nach dem Einschalten oder nach einem Reset. Normalerweise werden beim autocreate alle Werte abgefragt und angezeigt. Das geht normalerweise ohne jedes Zutun.

	~~PanStick~~ rein -> broadcast -> discovery -> anlegen.		panStick rein -> broadcast -> discovery -> anlegen.

	Bei Devices mit power down Mode erfolgt dieses das erste Mal wenn sie Strom haben.		Bei Devices mit power down Mode erfolgt dieses das erste Mal wenn sie Strom haben.
Zeile 171:		Zeile 171:
	Für die Systemregister kann hierzu statt der Register ID auch der Registername (siehe regListAll) verwendet werden.		Für die Systemregister kann hierzu statt der Register ID auch der Registername (siehe regListAll) verwendet werden.

	=== Intervall bei Sketch mit power down / batterie betriebene ~~PanStamps~~ ===		=== Intervall bei Sketch mit power down / batterie betriebene panStamps ===
	panStamp Hardware mit power down Mode durchlaufen während des Booten (beim Einschalten oder bei einem Reset) eine 3 Sekunden Schleife und warten auf SWAP-Kommandos, die z.B. Register für das Sendeintervall oder sonstige Konfigurationen ändern. Nach dieser Zeit wird die normale Loop Schleife im Arduino Sketch gestartet. Normaler Weise werden dann die Register mit den Sensorwerten an FHEM gesendet. Power down Devices gehen danach schlafen (power down Modus mit extrem niedrigem Stromverbrauch) und wachen regelmäßig auf (TX_INTERVAL aus dem Systemregister) um die Sensoren auszulesen und die Werte wieder an FHEM zu senden. Das Sendeintervall betrifft nur das Senden der Sensorwerte. Normalerweise empfängt das panStamp Modul in diesem Modus keine Befehle mehr. Das passiert nur einmalig nach einem Reset. Je nach Sketch kann das natürlich variieren und anders programmiert sein!		panStamp Hardware mit power down Mode durchlaufen während des Booten (beim Einschalten oder bei einem Reset) eine 3 Sekunden Schleife und warten auf SWAP-Kommandos, die z.B. Register für das Sendeintervall oder sonstige Konfigurationen ändern. Nach dieser Zeit wird die normale Loop Schleife im Arduino Sketch gestartet. Normaler Weise werden dann die Register mit den Sensorwerten an FHEM gesendet. Power down Devices gehen danach schlafen (power down Modus mit extrem niedrigem Stromverbrauch) und wachen regelmäßig auf (TX_INTERVAL aus dem Systemregister) um die Sensoren auszulesen und die Werte wieder an FHEM zu senden. Das Sendeintervall betrifft nur das Senden der Sensorwerte. Normalerweise empfängt das panStamp Modul in diesem Modus keine Befehle mehr. Das passiert nur einmalig nach einem Reset. Je nach Sketch kann das natürlich variieren und anders programmiert sein!

Zeile 217:		Zeile 217:
	Der panStamp soilmoisture Sketch aus dem examples Verzeichnis ist mit dem Standard SWAP Modul kompatibel.		Der panStamp soilmoisture Sketch aus dem examples Verzeichnis ist mit dem Standard SWAP Modul kompatibel.

	Ein Artikel über ein selbst entwickeltes ~~PanStamp~~ Batterieboard zum Anschluss von Analogsensoren/1Wire und Solarversorgung ist hier [[Bodenfeuchtesensor]] beschrieben. Die Weiterentwicklung zum Umweltsensor ist hier [[~~PanStamp_Umweltsensor~~]] beschrieben.		Ein Artikel über ein selbst entwickeltes panStamp Batterieboard zum Anschluss von Analogsensoren/1Wire und Solarversorgung ist hier [[Bodenfeuchtesensor]] beschrieben. Die Weiterentwicklung zum Umweltsensor ist hier [[panStamp_Umweltsensor]] beschrieben.

	Eine für einen Vegetronix Sensor angepasste Version kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Das Übertragungsintervall ist wie üblich über das Register <code>0A</code> konfigurierbar. Der Sensor wird an GND, D7 für die Versorgungsspannung und A4 für den Messwert angeschlossen. Erfahrungen haben gezeigt, dass bei einem fünfminütigen Übertragungsintervall nach 12 Monaten Laufzeit die Batteriespannung von 1.55V auf 1.4V abfällt. Das würde bedeuten, dass eine Batterie im Batterieboard mindestens eine Laufzeit von drei Jahren haben sollte.		Eine für einen Vegetronix Sensor angepasste Version kann von [http://sourceforge.net/p/fhem/code/HEAD/tree/trunk/fhem/contrib/arduino/ sourceforge] heruntergeladen werden. Das Übertragungsintervall ist wie üblich über das Register <code>0A</code> konfigurierbar. Der Sensor wird an GND, D7 für die Versorgungsspannung und A4 für den Messwert angeschlossen. Erfahrungen haben gezeigt, dass bei einem fünfminütigen Übertragungsintervall nach 12 Monaten Laufzeit die Batteriespannung von 1.55V auf 1.4V abfällt. Das würde bedeuten, dass eine Batterie im Batterieboard mindestens eine Laufzeit von drei Jahren haben sollte.
Zeile 287:		Zeile 287:
	sudo apt-get install libxml-simple-perl		sudo apt-get install libxml-simple-perl

	=== ~~PanStamp~~ antwortet nicht/EEprom to factory defaults ===		=== panStamp antwortet nicht/EEprom to factory defaults ===
	Wenn der panStamp nicht antwortet, kann es sein das die Adressen durcheinander gekommen sind. Dann musst man einmal in <code>setup()</code> ein <code>eepromToFactoryDefaults()</code> aufrufen und damit flashen. Wenn damit einmal gestartet wurde, die Zeile wieder entfernen und den normalen Sketch flashen. {{Link2Forum\|Topic=13890 \|Message=121677}}		Wenn der panStamp nicht antwortet, kann es sein das die Adressen durcheinander gekommen sind. Dann musst man einmal in <code>setup()</code> ein <code>eepromToFactoryDefaults()</code> aufrufen und damit flashen. Wenn damit einmal gestartet wurde, die Zeile wieder entfernen und den normalen Sketch flashen. {{Link2Forum\|Topic=13890 \|Message=121677}}