FHEMWiki - Benutzerbeiträge [de]

1-Wire Emulation per ATTiny

2015-10-11T15:54:58Z

Ritchie: Tipfehler im Namen beseitigt (Thomas -> Tobias)

== Einführung ==
Der Atmel Atiny oder andere Mikrokontroller des Atmel Familie lassen sich mittels Software zu einem 1-Wire Baustein konfigurieren. Basis dieses Gedanken war die Tatsache das der Zählerbaustein DS2423 von Dallas abgekündigt wurde. Jedoch wurden mit diesem Baustein viele Schaltung realisiert und aus diesem Grund wurde eine Software-Lösung gefunden. Die Software Lösung bietet aber noch weitere Vorteile, welche die Standard-Bausteine nicht bieten. So können z.B. Kurze Impulse festgehalten werden, Steuerfunktionen und Notfunktionen dezentral gelöst werden ohne den Busmaster mit diesen Funktionen zu belasten.
=== Foren Links ===
* Wer sich für den Nachbau des DS2423 interessiert, sollte sich diesen Thread durchlesen/verfolgen. [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* der hier besprochene Quellcode basiert auf dieser Software [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfiguierbar DS2423/DS18BS20/DS2413/DS2408]
== Hardware ==
=== ATtiny44A ===
[[Bild:atmel1wireslaveschaltung.png|mini|100px|rechts|1-Wire Slave Schaltung]]
Die hier gezeigte Schaltung zeigt einen ATTINY44A als 1-Wire Slave, welcher folgende Funktionen hat:
* 4 Status LED's, welche den Zustand der Eingänge anzeigt.
* 1 Taster. Zeigt bei Betätigung den Status der Eingänge
* 4 Eingänge über je einen Operationsverstärker, welcher als Vergleicher arbeitet
* 1 Programmierschnittstelle 6 polig zum laden der Software
=== ATtiny25 ===
Die Hardware vom DS2423, welcher hier im Forum sehr bekannt ist,
kann von seiner Webseite [http://m1n1.de/html/1w_counter_v1_7.html] eingesehen werden.
== Software ==
Die Grundfunktion der Software wurde von Maximum in der [http://www.maximintegrated.com/en/app-notes/index.mvp/id/126 Applikation Note 126] beschrieben. Hier hat Tobias Mueller eine gute Implementierung der Umsetzung auf seiner [http://www.tm3d.de/index.php/1-wire-device-mit-avr Webseite] gemacht. Er zeigt hier das Signalverhalten und die einzelnen Schritte der Software in verschiedenen Diagrammen. Für ein generelles Verständnis ist diese Webseite ein guter Einstieg.
Der hier vorgestellte Quellcode basiert auf seiner Vorlage. Es wurden jedoch die bestehenden 1-Wire Typen DS2423 & DS18BS20 in eine Datei von Ihm übernommen. Zusätzlich sind der 1-Wire DS2408/DS2413 eingefügt worden. Die Code wurde aufgeräumt und nochmals zusätzlich modularisiert und dokumentiert.
Der Quellcode wurde in diesem [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 Forumsthread] abgelegt.
=== Programmierung ===
Die Software ist in C geschrieben und verwendet hierbei die speziellen Funktionen des Controllers. Eine genaues Einlesen in das Handbuch des Mikrocontroller ist hierbei unerlässlich, um die einzelnen Funktionen zu verstehen. Dies ist auch notwendig, wenn man die bestehende Software auf einen anderen Controller umschreiben will. Wie im im Schaltplan erkennen kann, werden die einzelnen Pin's mehrfach belegt.
=== Datenblätter ===
Hier findet man das Datenblatt zum Mikrocontroller. In diesem Dokument sind alle Funktionen und Register des jeweiligen Mikrocontroller in englisch beschrieben. Für das Verständnis der Funktionen des Mikrocontroller ist eine Kenntnis diese Dokument notwendig.
[http://www.atmel.com/Images/doc8006.pdf Datenblatt von Attiny 24/44/88]
=== Programmierumgebungen ===
* AVR Studio
* AVRDude
=== Der Quellcode ===
Die Funktionen der Software werden in drei Teile getrennt.
* Zeitkritische Funktionen, welche über einen PIN - Interrupt realisiert sind
* Zeitabhängige Funktionen, welcher über einen Timer - Interrupt realisiert sind
* Zeitunkritische Funktionen, welche über das Hauptprogramm realisiert sind

Im folgenden Abschnitt werden die einzelnen Funktion des Quellcodes erklärt.
==== Allgemeine Deklaration ====
// selection of the used
//#define DS2423 1
//#define DS18BS20 1
#define DS2408 1
//#define DS2413 1
...
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
In dieser Sektion sind generelle Deklarationen definiert.
So wird hier durch die Definitionen DS2423...DS2413 der jeweilige 1-Wire Slave Typ bei der nächsten Kompilierung erstellt.
Es darf nur ein Typ ausgewählt sein, da es sonst zu nicht funktionsfähigen Code kommt.
==== Controller Spezifische Deklarationen ====
#ifdef __AVR_ATtiny44A__
// OW_PORT Pin 7 - PB2
//
//OW Pin
//
#define OW_PORT PORTB //1 Wire Port
#define OW_PIN PINB //1 Wire Pin as number
...
#endif // __AVR_ATtiny44a__
In dieser Sektion können die jeweiligen Realisierungen der verschiedenen Mikrocontroller Typen abgelegt werden.
Da die Registerbelegung von Controller zu Controller unterschiedlich sind, können diese dem Compiler mittels Makroanweisungen hier
entsprechend zugewiesen werden.
==== 1-Wire Baustein spezifische Deklarationen ====
#ifdef DS2423
#define PC_INT_ISR ISR(PCINT0_vect) { /*ATT44 with 0 by PCINT*/ \
if (((PINA&(1<<PINA4))==0)&&((istat&(1<<PINA4))==(1<<PINA4))) { Counter[0]++; } \
if (((PINA&(1<<PINA3))==0)&&((istat&(1<<PINA3))==(1<<PINA3))) { Counter[1]++; } \
if (((PINA&(1<<PINA0))==0)&&((istat&(1<<PINA0))==(1<<PINA0))) \
{ \
eeprom_write_byte((uint8_t *)0,0x55);\
eeprom_write_dword((uint32_t *)1,Counter[0]);\
eeprom_write_dword((uint32_t *)5,Counter[1]); \
} \
istat=PINA;}
#define INIT_COUNTER_PINS /* Counter Interrupt */ \
GIMSK|= (1<<PCIE0);\
PCMSK0= (1<<PCINT3)|(1<<PCINT4)|(1<<PCINT0); \
DDRA &=~ (1<<PINA1) | (1<<PINA2); \
istat=PINB;
#endif

Über eine solche Deklaration wird dem bei dem jeweiligen 1-Wire Type die entsprechende Konstante entsprechend konfiguriert.
Für weitere 1-Wire Typen sind entsprechende Konstanten vorzusehen. Einige der Deklarationen sind nur für den jeweiligen Type
notwendig, andere sind für jeden Typ notwendig.
==== Globale Variablen Deklarationen ====
// --------------------- Device depending variables ------------------------------------
#ifdef DS2423
typedef union
{
volatile uint8_t bytes[13];//={1,1,2,0,0,0,0,0,0,0,0,5,5};
struct
{
uint16_t addr;
uint8_t read;
uint32_t counter;
uint32_t zero;
uint16_t crc;
};
} counterpack_t;
counterpack_t counterpack;
volatile uint32_t Counter[2]; // Counter Buffer
#endif
In diesem Bereich werden globale Variablen definiert, welche nur für den jeweiligen 1-Wire Typen notwendig sind.
==== Byte Definitionen des 1-Wire Bus ====
#define OWM_SLEEP 0 //Waiting for next reset pulse
#define OWM_RESET 1 //Reset pulse received
#define OWM_PRESENCE 2 //sending presence pulse
...
#define OW_RESET_ACTIVITY_LATCHES 0xC3
In diesem Bereich sind die einzelnen Kommandos und Status Variablen des 1-Wire Bus deklariert. Diese Definitionen finden sich in den einzelnen
Datenblätter der 1-Wire Bausteine wieder.
==== PIN Interrupt Routine ====
PIN_INT
{
...
}
In dieser Routine wird das Datenhandling bei Statuswechsel des 1-Wire PIN's durchgeführt.

==== PIN Interrupt Routine / EEPROM sichern ====
Ebenso wird die Routine auch aufgerufen, wenn die Spannung an dem Spannungsteiler R1/R2 auf Low Level geht. Hierdurch wird der folgende Programmteil durchlaufen und die entsprechenden Werte des jeweiligen Chip ins EEPROM geschrieben.

if (((PINA&(1<<PINA0))==0))
{ /* Power fail signal */
uint8_t i;
cli(); /* disable any interrupt */
eeprom_update_byte((uint8_t *)0,0x0); /*clear the magic number */
for (i=0;i<sizeof(Register_state);i++)
{
eeprom_update_byte((uint8_t *)(i+1),Register_state[i]);
}
eeprom_update_byte((uint8_t *)0,0x55); /*value is now valid */
software_reset(); /* Wait until the the system get reset (or power off) */
}

==== Timer Interrupt Routine ====
TIMER_INT
{
}
Alle zeitbasierenden Funktionen werden über diesen Interrupt ausgeführt. Wartezeiten mit Signalprüfungen und dergleichen.
==== Main Routine / Start up ====
Main()
{
}
In dieser Funktion wird der Mikrocontroller und dessen Hardware aufgesetzt. Danach erfolgt die eigentliche
1-Wire Steuerung nur über Interrupts. In der Mainroutine können zusätzlich Funktionen programmiert werden.
Es kann jedoch kein Zugriff auf Interrupt-Funktionen verwendet werden (z.B. SPI, I2C via Interrupt) da hierdurch
das Timing des 1-Wire Bus nicht mehr garantiert werden kann (Vorsetzung bei diesem Mikrocontroller Type).
=== Slave-ID Berechnung ===
Sollte man eigene Slave erstellen wollen, so ist es notwendig die Slave ID entsprechend berechnen zu lassen.
Der Rechner von [http://www.tm3d.de/index.php/tools#berechnungid Tobias Mueller] ist hier ein nützliches Werkzeug.
=== Fuse Bits ===
[[Bild:FuseBits.png|mini|100px|rechts|Fuse Bit des Controllers]]
Der Controller verwendet nur BODLEVEL von 4.3 Volt. Bei Erreichen dieser Versorgungsspannung wird der Controller automatisch in
den Reset-Modus gesetzt. Der Watchdog wird per Software eingeschaltet. Die CPU arbeitet mit 8Mhz ohne externen Quarz.

= Quellen =
== Webseite ==
* [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* [http://www.tm3d.de/index.php/1-wire-device-mit-avr 1-Wire Device mit AR-Mikrocontroller]
* [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfigurierbar DS2423/DS18BS20/DS2413/DS2408]
* [https://www.mikrocontroller.net/articles/Atmel_Studio Hinweis zum AVR Studio]
* [http://www.atmel.com Hersteller der Mikrocontroller Atmel]

== Datenblätter ==
* [https://datasheets.maximintegrated.com/en/ds/DS2408.pdf Datenblatt des DS2408]
* [http://datasheets.maximintegrated.com/en/ds/DS2423.pdf Datenblatt des DS2423]
* [http://datasheets.maximintegrated.com/en/ds/DS2413.pdf Datenblatt des DS2413]
* [http://datasheets.maximintegrated.com/en/ds/DS18B20.pdf Datenblatt des DS18B20]

[[Kategorie:1-Wire]]

1-Wire Emulation per ATTiny

2015-10-10T16:48:18Z

Ritchie: Weitere Links eingefügt, Fusebit Bild eingefügt

== Einführung ==
Der Atmel Atiny oder andere Mikrokontroller des Atmel Familie lassen sich mittels Software zu einem 1-Wire Baustein konfigurieren. Basis dieses Gedanken war die Tatsache das der Zählerbaustein DS2423 von Dallas abgekündigt wurde. Jedoch wurden mit diesem Baustein viele Schaltung realisiert und aus diesem Grund wurde eine Software-Lösung gefunden. Die Software Lösung bietet aber noch weitere Vorteile, welche die Standard-Bausteine nicht bieten. So können z.B. Kurze Impulse festgehalten werden, Steuerfunktionen und Notfunktionen dezentral gelöst werden ohne den Busmaster mit diesen Funktionen zu belasten.
=== Foren Links ===
* Wer sich für den Nachbau des DS2423 interessiert, sollte sich diesen Thread durchlesen/verfolgen. [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* der hier besprochene Quellcode basiert auf dieser Software [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfiguierbar DS2423/DS18BS20/DS2413/DS2408]
== Hardware ==
=== ATtiny44A ===
[[Bild:atmel1wireslaveschaltung.png|mini|100px|rechts|1-Wire Slave Schaltung]]
Die hier gezeigte Schaltung zeigt einen ATTINY44A als 1-Wire Slave, welcher folgende Funktionen hat:
* 4 Status LED's, welche den Zustand der Eingänge anzeigt.
* 1 Taster. Zeigt bei Betätigung den Status der Eingänge
* 4 Eingänge über je einen Operationsverstärker, welcher als Vergleicher arbeitet
* 1 Programmierschnittstelle 6 polig zum laden der Software
=== ATtiny25 ===
Die Hardware vom DS2423, welcher hier im Forum sehr bekannt ist,
kann von seiner Webseite [http://m1n1.de/html/1w_counter_v1_7.html] eingesehen werden.
== Software ==
Die Grundfunktion der Software wurde von Maximum in der [http://www.maximintegrated.com/en/app-notes/index.mvp/id/126 Applikation Note 126] beschrieben. Hier hat Tobias Mueller eine gute Implementierung der Umsetzung auf seiner [http://www.tm3d.de/index.php/1-wire-device-mit-avr Webseite] gemacht. Er zeigt hier das Signalverhalten und die einzelnen Schritte der Software in verschiedenen Diagrammen. Für ein generelles Verständnis ist diese Webseite ein guter Einstieg.
Der hier vorgestellte Quellcode basiert auf seiner Vorlage. Es wurden jedoch die bestehenden 1-Wire Typen DS2423 & DS18BS20 in eine Datei von Ihm übernommen. Zusätzlich sind der 1-Wire DS2408/DS2413 eingefügt worden. Die Code wurde aufgeräumt und nochmals zusätzlich modularisiert und dokumentiert.
Der Quellcode wurde in diesem [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 Forumsthread] abgelegt.
=== Programmierung ===
Die Software ist in C geschrieben und verwendet hierbei die speziellen Funktionen des Controllers. Eine genaues Einlesen in das Handbuch des Mikrocontroller ist hierbei unerlässlich, um die einzelnen Funktionen zu verstehen. Dies ist auch notwendig, wenn man die bestehende Software auf einen anderen Controller umschreiben will. Wie im im Schaltplan erkennen kann, werden die einzelnen Pin's mehrfach belegt.
=== Datenblätter ===
Hier findet man das Datenblatt zum Mikrocontroller. In diesem Dokument sind alle Funktionen und Register des jeweiligen Mikrocontroller in englisch beschrieben. Für das Verständnis der Funktionen des Mikrocontroller ist eine Kenntnis diese Dokument notwendig.
[http://www.atmel.com/Images/doc8006.pdf Datenblatt von Attiny 24/44/88]
=== Programmierumgebungen ===
* AVR Studio
* AVRDude
=== Der Quellcode ===
Die Funktionen der Software werden in drei Teile getrennt.
* Zeitkritische Funktionen, welche über einen PIN - Interrupt realisiert sind
* Zeitabhängige Funktionen, welcher über einen Timer - Interrupt realisiert sind
* Zeitunkritische Funktionen, welche über das Hauptprogramm realisiert sind

Im folgenden Abschnitt werden die einzelnen Funktion des Quellcodes erklärt.
==== Allgemeine Deklaration ====
// selection of the used
//#define DS2423 1
//#define DS18BS20 1
#define DS2408 1
//#define DS2413 1
...
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
In dieser Sektion sind generelle Deklarationen definiert.
So wird hier durch die Definitionen DS2423...DS2413 der jeweilige 1-Wire Slave Typ bei der nächsten Kompilierung erstellt.
Es darf nur ein Typ ausgewählt sein, da es sonst zu nicht funktionsfähigen Code kommt.
==== Controller Spezifische Deklarationen ====
#ifdef __AVR_ATtiny44A__
// OW_PORT Pin 7 - PB2
//
//OW Pin
//
#define OW_PORT PORTB //1 Wire Port
#define OW_PIN PINB //1 Wire Pin as number
...
#endif // __AVR_ATtiny44a__
In dieser Sektion können die jeweiligen Realisierungen der verschiedenen Mikrocontroller Typen abgelegt werden.
Da die Registerbelegung von Controller zu Controller unterschiedlich sind, können diese dem Compiler mittels Makroanweisungen hier
entsprechend zugewiesen werden.
==== 1-Wire Baustein spezifische Deklarationen ====
#ifdef DS2423
#define PC_INT_ISR ISR(PCINT0_vect) { /*ATT44 with 0 by PCINT*/ \
if (((PINA&(1<<PINA4))==0)&&((istat&(1<<PINA4))==(1<<PINA4))) { Counter[0]++; } \
if (((PINA&(1<<PINA3))==0)&&((istat&(1<<PINA3))==(1<<PINA3))) { Counter[1]++; } \
if (((PINA&(1<<PINA0))==0)&&((istat&(1<<PINA0))==(1<<PINA0))) \
{ \
eeprom_write_byte((uint8_t *)0,0x55);\
eeprom_write_dword((uint32_t *)1,Counter[0]);\
eeprom_write_dword((uint32_t *)5,Counter[1]); \
} \
istat=PINA;}
#define INIT_COUNTER_PINS /* Counter Interrupt */ \
GIMSK|= (1<<PCIE0);\
PCMSK0= (1<<PCINT3)|(1<<PCINT4)|(1<<PCINT0); \
DDRA &=~ (1<<PINA1) | (1<<PINA2); \
istat=PINB;
#endif

Über eine solche Deklaration wird dem bei dem jeweiligen 1-Wire Type die entsprechende Konstante entsprechend konfiguriert.
Für weitere 1-Wire Typen sind entsprechende Konstanten vorzusehen. Einige der Deklarationen sind nur für den jeweiligen Type
notwendig, andere sind für jeden Typ notwendig.
==== Globale Variablen Deklarationen ====
// --------------------- Device depending variables ------------------------------------
#ifdef DS2423
typedef union
{
volatile uint8_t bytes[13];//={1,1,2,0,0,0,0,0,0,0,0,5,5};
struct
{
uint16_t addr;
uint8_t read;
uint32_t counter;
uint32_t zero;
uint16_t crc;
};
} counterpack_t;
counterpack_t counterpack;
volatile uint32_t Counter[2]; // Counter Buffer
#endif
In diesem Bereich werden globale Variablen definiert, welche nur für den jeweiligen 1-Wire Typen notwendig sind.
==== Byte Definitionen des 1-Wire Bus ====
#define OWM_SLEEP 0 //Waiting for next reset pulse
#define OWM_RESET 1 //Reset pulse received
#define OWM_PRESENCE 2 //sending presence pulse
...
#define OW_RESET_ACTIVITY_LATCHES 0xC3
In diesem Bereich sind die einzelnen Kommandos und Status Variablen des 1-Wire Bus deklariert. Diese Definitionen finden sich in den einzelnen
Datenblätter der 1-Wire Bausteine wieder.
==== PIN Interrupt Routine ====
PIN_INT
{
...
}
In dieser Routine wird das Datenhandling bei Statuswechsel des 1-Wire PIN's durchgeführt.

==== PIN Interrupt Routine / EEPROM sichern ====
Ebenso wird die Routine auch aufgerufen, wenn die Spannung an dem Spannungsteiler R1/R2 auf Low Level geht. Hierdurch wird der folgende Programmteil durchlaufen und die entsprechenden Werte des jeweiligen Chip ins EEPROM geschrieben.

if (((PINA&(1<<PINA0))==0))
{ /* Power fail signal */
uint8_t i;
cli(); /* disable any interrupt */
eeprom_update_byte((uint8_t *)0,0x0); /*clear the magic number */
for (i=0;i<sizeof(Register_state);i++)
{
eeprom_update_byte((uint8_t *)(i+1),Register_state[i]);
}
eeprom_update_byte((uint8_t *)0,0x55); /*value is now valid */
software_reset(); /* Wait until the the system get reset (or power off) */
}

==== Timer Interrupt Routine ====
TIMER_INT
{
}
Alle zeitbasierenden Funktionen werden über diesen Interrupt ausgeführt. Wartezeiten mit Signalprüfungen und dergleichen.
==== Main Routine / Start up ====
Main()
{
}
In dieser Funktion wird der Mikrocontroller und dessen Hardware aufgesetzt. Danach erfolgt die eigentliche
1-Wire Steuerung nur über Interrupts. In der Mainroutine können zusätzlich Funktionen programmiert werden.
Es kann jedoch kein Zugriff auf Interrupt-Funktionen verwendet werden (z.B. SPI, I2C via Interrupt) da hierdurch
das Timing des 1-Wire Bus nicht mehr garantiert werden kann (Vorsetzung bei diesem Mikrocontroller Type).
=== Slave-ID Berechnung ===
Sollte man eigene Slave erstellen wollen, so ist es notwendig die Slave ID entsprechend berechnen zu lassen.
Der Rechner von [http://www.tm3d.de/index.php/tools#berechnungid Thomas Mueller] ist hier ein nützliches Werkzeug.
=== Fuse Bits ===
[[Bild:FuseBits.png|mini|100px|rechts|Fuse Bit des Controllers]]
Der Controller verwendet nur BODLEVEL von 4.3 Volt. Bei Erreichen dieser Versorgungsspannung wird der Controller automatisch in
den Reset-Modus gesetzt. Der Watchdog wird per Software eingeschaltet. Die CPU arbeitet mit 8Mhz ohne externen Quarz.

= Quellen =
== Webseite ==
* [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* [http://www.tm3d.de/index.php/1-wire-device-mit-avr 1-Wire Device mit AR-Mikrocontroller]
* [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfigurierbar DS2423/DS18BS20/DS2413/DS2408]
* [https://www.mikrocontroller.net/articles/Atmel_Studio Hinweis zum AVR Studio]
* [http://www.atmel.com Hersteller der Mikrocontroller Atmel]

== Datenblätter ==
* [https://datasheets.maximintegrated.com/en/ds/DS2408.pdf Datenblatt des DS2408]
* [http://datasheets.maximintegrated.com/en/ds/DS2423.pdf Datenblatt des DS2423]
* [http://datasheets.maximintegrated.com/en/ds/DS2413.pdf Datenblatt des DS2413]
* [http://datasheets.maximintegrated.com/en/ds/DS18B20.pdf Datenblatt des DS18B20]

[[Kategorie:1-Wire]]

Datei:Atmel1wireslaveschaltung.png

2015-10-10T16:27:49Z

Ritchie: Ritchie lud eine neue Version von Datei:Atmel1wireslaveschaltung.png hoch

Diese Schaltung zeigt eine mögliche Schaltung für einen 1-Wire Slave.

Datei:FuseBits.png

2015-10-10T11:36:28Z

Ritchie: Fuse Bit des Attiny 44a für die Programmierung eines 1-Wire Slaves auf Basis eines Atmel Controllers

Fuse Bit des Attiny 44a für die Programmierung eines 1-Wire Slaves auf Basis eines Atmel Controllers

1-Wire Emulation per ATTiny

2015-05-02T21:47:01Z

Ritchie: Erstellung der Basisartikel

== Einführung ==
Der Atmel Atiny oder andere Mikrokontroller des Atmel Familie lassen sich mittels Software zu einem 1-Wire Baustein konfigurieren. Basis dieses Gedanken war die Tatsache das der Zählerbaustein DS2423 von Dallas abgekündigt wurde. Jedoch wurden mit diesem Baustein viele Schaltung realisiert und aus diesem Grund wurde eine Software-Lösung gefunden. Die Software Lösung bietet aber noch weitere Vorteile, welche die Standard-Bausteine nicht bieten. So können z.B. Kurze Impulse festgehalten werden, Steuerfunktionen und Notfunktionen dezentral gelöst werden ohne den Busmaster mit diesen Funktionen zu belasten.
=== Foren Links ===
* Wer sich für den Nachbau des DS2423 interessiert, sollte sich diesen Thread durchlesen/verfolgen. [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* der hier besprochene Quellcode basiert auf dieser Software [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfiguierbar DS2423/DS18BS20/DS2408/DS2408]
== Hardware ==
=== ATtiny44A ===
[[Bild:atmel1wireslaveschaltung.png|mini|100px|rechts|1-Wire Slave Schaltung]]
Die hier gezeigte Schaltung zeigt einen ATTINY44A als 1-Wire Slave, welcher folgende Funktionen hat:
* 4 Status LED's, welche den Zustand der Eingänge anzeigt.
* 1 Taster. Zeigt bei Betätigung den Status der Eingänge
* 4 Eingänge über je einen Operationsverstärker, welcher als Vergleicher arbeitet
* 1 Programmierschnittstelle 6 polig zum laden der Software
=== ATtiny25 ===
Die Hardware vom DS2423, welcher hier im Forum sehr bekannt ist,
kann von seiner Webseite [http://m1n1.de/html/1w_counter_v1_7.html] eingesehen werden.
== Software ==
Die Grundfunktion der Software wurde von Maximum in der [http://www.maximintegrated.com/en/app-notes/index.mvp/id/126 Applikation Note 126] beschrieben. Hier hat Tobias Mueller eine gute Implementierung der Umsetzung auf seiner [http://www.tm3d.de/index.php/1-wire-device-mit-avr Webseite] gemacht. Er zeigt hier das Signalverhalten und die einzelnen Schritte der Software in verschiedenen Diagrammen. Für ein generelles Verständnis ist diese Webseite ein guter Einstieg.
Der hier vorgestellte Quellcode basiert auf seiner Vorlage. Es wurden jedoch die bestehenden 1-Wire Typen DS2423 & DS18BS20 in eine Datei von Ihm übernommen. Zusätzlich sind der 1-Wire DS2408/DS2413 eingefügt worden. Die Code wurde aufgeräumt und nochmals zusätzlich modularisiert und dokumentiert.
Der Quellcode wurde in diesem [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 Forumsthread] abgelegt.

=== Programmierung ===
Die Software ist in C geschrieben und verwendet hierbei die speziellen Funktionen des Controllers. Eine genaues Einlesen in das Handbuch des Mikrocontroller ist hierbei unerlässlich, um die einzelnen Funktionen zu verstehen. Dies ist auch notwendig, wenn man die bestehende Software auf einen anderen Controller umschreiben will. Wie im im Schaltplan erkennen kann, werden die einzelnen Pin's mehrfach belegt.
=== Datenblätter ===
Hier findet man das Datenblatt zum Mikrocontroller. In diesem Dokument sind alle Funktionen und Register des jeweiligen Mikrocontroller in englisch beschrieben. Für das Verständnis der Funktionen des Mikrocontroller ist eine Kenntnis diese Dokument notwendig.
[http://www.atmel.com/Images/doc8006.pdf Datenblatt von Attiny 24/44/88]
=== Programmierumgebungen ===
* AVR Studio
* AVRDude
=== Der Quellcode ===
Die Funktionen der Software werden in drei Teile getrennt.
* Zeitkritische Funktionen, welche über einen PIN - Interrupt realisiert sind
* Zeitabhängige Funktionen, welcher über einen Timer - Interrupt realisiert sind
* Zeitunkritische Funktionen, welche über das Hauptprogramm realisiert sind

Im folgenden Abschnitt werden die einzelnen Funktion des Quellcodes erklärt.
==== Allgemeine Deklaration ====
// selection of the used
//#define DS2423 1
//#define DS18BS20 1
#define DS2408 1
//#define DS2413 1
...
#define SET_BIT(PORT, BITNUM) ((PORT) |= (1<<(BITNUM)))
#define CLEAR_BIT(PORT, BITNUM) ((PORT) &= ~(1<<(BITNUM)))
In dieser Sektion sind generelle Deklarationen definiert.
So wird hier durch die Definitionen DS2423...DS2413 der jeweilige 1-Wire Slave Typ bei der nächsten Kompilierung erstellt.
Es darf nur ein Typ ausgewählt sein, da es sonst zu nicht funktionsfähigen Code kommt.
==== Controller Spezifische Deklarationen ====
#ifdef __AVR_ATtiny44A__
// OW_PORT Pin 7 - PB2
//
//OW Pin
//
#define OW_PORT PORTB //1 Wire Port
#define OW_PIN PINB //1 Wire Pin as number
...
#endif // __AVR_ATtiny44a__
In dieser Sektion können die jeweiligen Realisierungen der verschiedenen Mikrocontroller Typen abgelegt werden.
Da die Registerbelegung von Controller zu Controller unterschiedlich sind, können diese dem Compiler mittels Makroanweisungen hier
entsprechend zugewiesen werden.
==== 1-Wire Baustein spezifische Deklarationen ====
#ifdef DS2423
#define PC_INT_ISR ISR(PCINT0_vect) { /*ATT44 with 0 by PCINT*/ \
if (((PINA&(1<<PINA4))==0)&&((istat&(1<<PINA4))==(1<<PINA4))) { Counter[0]++; } \
if (((PINA&(1<<PINA3))==0)&&((istat&(1<<PINA3))==(1<<PINA3))) { Counter[1]++; } \
if (((PINA&(1<<PINA0))==0)&&((istat&(1<<PINA0))==(1<<PINA0))) \
{ \
eeprom_write_byte((uint8_t *)0,0x55);\
eeprom_write_dword((uint32_t *)1,Counter[0]);\
eeprom_write_dword((uint32_t *)5,Counter[1]); \
} \
istat=PINA;}
#define INIT_COUNTER_PINS /* Counter Interrupt */ \
GIMSK|= (1<<PCIE0);\
PCMSK0= (1<<PCINT3)|(1<<PCINT4)|(1<<PCINT0); \
DDRA &=~ (1<<PINA1) | (1<<PINA2); \
istat=PINB;
#endif

Über eine solche Deklaration wird dem bei dem jeweiligen 1-Wire Type die entsprechende Konstante entsprechend konfiguriert.
Für weitere 1-Wire Typen sind entsprechende Konstanten vorzusehen. Einige der Deklarationen sind nur für den jeweiligen Type
notwendig, andere sind für jeden Typ notwendig.
==== Globale Variablen Deklarationen ====
// --------------------- Device depending variables ------------------------------------
#ifdef DS2423
typedef union
{
volatile uint8_t bytes[13];//={1,1,2,0,0,0,0,0,0,0,0,5,5};
struct
{
uint16_t addr;
uint8_t read;
uint32_t counter;
uint32_t zero;
uint16_t crc;
};
} counterpack_t;
counterpack_t counterpack;
volatile uint32_t Counter[2]; // Counter Buffer
#endif
In diesem Bereich werden globale Variablen definiert, welche nur für den jeweiligen 1-Wire Typen notwendig sind.
==== Byte Definitionen des 1-Wire Bus ====
#define OWM_SLEEP 0 //Waiting for next reset pulse
#define OWM_RESET 1 //Reset pulse received
#define OWM_PRESENCE 2 //sending presence pulse
...
#define OW_RESET_ACTIVITY_LATCHES 0xC3
In diesem Bereich sind die einzelnen Kommandos und Status Variablen des 1-Wire Bus deklariert. Diese Definitionen finden sich in den einzelnen
Datenblätter der 1-Wire Bausteine wieder.
==== PIN Interrupt Routine ====
PIN_INT
{
...
}
In dieser Routine wird das Datenhandling bei Statuswechsel des 1-Wire PIN's durchgeführt.
==== Timer Interrupt Routine ====
TIMER_INT
{
}
Alle zeitbasierenden Funktionen werden über diesen Interrupt ausgeführt. Wartezeiten mit Signalprüfungen und dergleichen.
==== Main Routine / Start up ====
Main()
{
}
In dieser Funktion wird der Mikrocontroller und dessen Hardware aufgesetzt. Danach erfolgt die eigentliche
1-Wire Steuerung nur über Interrupts. In der Mainroutine können zusätzlich Funktionen programmiert werden.
Es kann jedoch kein Zugriff auf Interrupt-Funktionen verwendet werden (z.B. SPI, I2C via Interrupt) da hierdurch
das Timing des 1-Wire Bus nicht mehr garantiert werden kann (Vorsetzung bei diesem Mikrocontroller Type).
=== Slave-ID Berechnung ===
Sollte man eigene Slave erstellen wollen, so ist es notwendig die Slave ID entsprechend berechnen zu lassen.
Der Rechner von [http://www.tm3d.de/index.php/tools#berechnungid Thomas Mueller] ist hier ein nützliches Werkzeug.
=== Compilieren ===
kommt noch
=== Programm in den Atmel laden ===
kommt noch

= Quellen =
* [http://forum.fhem.de/index.php?t=msg&th=10962&start=0&rid=118 Alternative zum DS2423 Counter]
* [http://www.tm3d.de/index.php/1-wire-device-mit-avr 1-Wire Device mit AR-Mikrocontroller]
* [http://forum.fhem.de/index.php/topic,22431.msg158105.html#msg158105 AVR Attiny44A als 1Wire Slave konfigurierbar DS2423/DS18BS20/DS2408/DS2408]
* [http://www.atmel.com Hersteller der Mikrocontroller Atmel]
[[Kategorie:1-Wire]]

Datei:Atmel1wireslaveschaltung.png

2015-05-02T17:48:42Z

Ritchie: Diese Schaltung zeigt eine mögliche Schaltung für einen 1-Wire Slave.

Diese Schaltung zeigt eine mögliche Schaltung für einen 1-Wire Slave.

1-Wire Störungsbeseitigung

2015-04-29T19:53:13Z

Ritchie: Bild für das Signalverhalten eines 1-Wire Impulse eingefügt. Kleine Korrekuren im Text.

Generell beschreiben die folgenden Punkte Informationen aus dem Dokument [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“]. Dieser Absatz soll eine zusätzliche Hilfe darstellen und bezieht sich aus den Informationen des obigen Dokuments mit einigen praktischen Hinweisen.
== Bus Fehler feststellen==
Der OWServer und die entsprechende Webseite des Servers bietet einige Möglichkeiten um Fehler auf dem 1-Wire Bus festzustellen. Die Fehler können innerhalb der Statistik des OW Servers gesehen werden.
=== CRC Fehler ===
[[Bild:1wireowservererrorstatus.png|mini|100px|rechts|Anzeige der CRC Fehler für den Bus]]
Die [http://de.wikipedia.org/wiki/Zyklische_Redundanzpr%C3%BCfung CRC Fehler] werden auf der Seite „http://<IP-OWSERVER>:2121/bus.0/statistics/errors“ dargestellt. Hier sieht man die Anzahl der übertragenen Pakete und deren Fehleranzahl. Bei einem guten Bus sollte die Anzahl der CRC8 / CRC16 = 0 sein. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den gesendeten Protokollen ist, umso schlechter ist der Bus.

=== Search Fehler ===
[[Bild:1wireowserversearcherror.png|mini|100px|rechts|Anzeige des Fehlerstatus für den Bus]]
Sollten während der Suche von Busteilnehmer auf dem 1-Wire Bus Fehler auftreten, werden diese auf diese Webseite des OW Server dargestellt. Hier sollte auch immer eine 0 stehen. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den Suchanfragen ist, umso schlechter ist der Bus. http://<IP-OWSERVER>:2121/bus.0/bus.2/interface/statistics/search_errors

=== Generelle Fehler===
Sollten werden eine Schreibvorgangs oder Lesevorgangs generelle Fehler auftauchen, so werden hier die entsprechenden Fehlerzähler angezeigt. Im Normalfall sollte auch hier 0 stehen. http://<IP-OWSERVER>:2121/bus.0/bus.0/interface/statistics

== Bus Fehler Ursache suchen ==
Um die Fehlerquellen entsprechend einzukreisen, kann man wie folgt vorgehen, um die Ursache zu finden und entsprechend zu beseitigen.
Es wird generell von einer korrekten Konfiguration des OW-Servers ausgegangen.
=== Kurzschluss prüfen ===
Zeigen sich auf dem 1-Wire Bus keine Teilnehmer, liegt die Vermutung nahe, das ein Kurzschluss auf dem Bus vorhanden ist (oder auch die Datenleitung durch einen 1-Wire Teilnehmer auf 0 Volt gezogen wird. Dies kann durch Software 1-Wire Bausteine auch passieren).

Alle Teilnehmer entfernen und die Leitungen entsprechend durchmessen. Hierbei kann auch eine hochohmige Verbindung (kein direkter Kurzschluss) eine Problem sein. Um diese auszuschließen muss das Multimeter im Mega-Ohm Bereich eingestellt werden und die Leitungen prüfen. Danach jeden Teilnehmer einzeln wieder in den Bus aufnehmen und prüfen, ob der Bus noch in Ordnung ist (Error Counter prüfen).
=== Leitungsbruch prüfen ===
Sind an allen Teilnehmer alle Leitungen korrekt angeschlossen. Sind Klemmen verwendet, da sollte man prüfen, ob alle Drähte fest angeschlossen. Man sollte an den Drähten ziehen können, ohne das sich der Draht löst. Wenn man LSA Klemmen verwendet, sollte man prüfen, ob der Draht auch wirklich tief in die Klemme gedrückt wurde. Evtl. einfach nochmals alle Kontakte nachdrücken. Kalte Lötstellen sind auch eine mögliche Problemstelle.

=== Spannungsversorgung prüfen ===
Damit der 1-Wire Bus stabil arbeiten kann, muss die Spannungsversorgung aller Busteilnehmer stabil sein.
Einen ersten Test kann man mit einem normalen Multimeter durchführen. Hierbei sollte die Spannung an allen
Teilstrecken des Bus zwischen 4,9V und 5.2Volt liegen. '''Ein Multimeter kann kurzzeitige Spannungseinbrüche nicht messen!'''
Hier ist ein Oszilloskope für die genaue Messung notwendig. Dann kann auch die Brummspannung (Ripple) auf der 5V Leitung gemessen werden. Eine Brummspannung größer 100mV (eigentlich weniger) ist ein Zeichen für eine fehlerhafte Spannungsversorgung und sollte geprüft werden. Hier könnten Filterschaltungen oder ein besseres Netzteil Abhilfe schaffen.

=== Signalverhalten prüfen ===
[[Bild:1wiresignal.png|mini|100px|rechts|Signalverhalten des 1-Wire Bus]]
Ein Fehler, welcher bei Leitungen im kurzen und mittleren Leitungsbereich gerne auftritt, ist das „'''ringing/undershoot'''“ Signal.
Hierbei wird kurzzeitige das 1-Wire Signal in den negativen Spannungsbereich gezogen (Impulse von bis -0.5Volt und mehr sind keine Seltenheit).
Ein entsprechendes Bild des Signalverlauf kann man auf der Seite 10 (Appendix D. Waveform Examples) des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] sehen.

Dieser Effekt wird durch die angeschlossenen Client's bei einem Bus Reset durch den Master erzeugt.
Diese Impulse können hierbei die angeschlossenen 1-Wire Teilnehmer in der Signalfolge des 1-Wire Protokolle aus dem Tritt bringen.
Der Effekt zeigt sich z.B. durch kommen und gehende Teilnehmer in der Device-Übersicht des OW Servers.
Diesen Effekt kann man nur mit einem Oszilloskope messen/darstellen.

Eine '''Abhilfe''' ist hier nur die Einbringung eines '''RC-Glied''' in den Anfang des betroffenen 1-Wire Bus.
Laut Guideline von Maxim sollte es ein 68 Ohm Widerstand sein und ein 470pF oder 4700pF je nach Leitungslänge sein.
Der entsprechend Schaltplan ist auf der Seite 9 des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] zu sehen.

== Bus Erweiterungen ==
Wenn der 1-wire Bus erweitert wird, kann sich das Leitungsverhalten ändern, insbesondere dann, wenn man nicht die optimale Netztopologie "Linear" verwendet.
=== Stubs vermeiden ===
Hier können die sogenannten '''Stub''', Abzweigungen vom Hauptstrang zum Problem werden. Sind diese Abzweigungen länger als 3m, beeinflussen sie nachweislich das Signalverhalten, da man in diesem Fall nicht mehr von einem linearen Bus, sondern einem '''stubbed''' Topologie redet. Die Leitungsrefektionen dieser Seitenarme können den Bus stören und sind daher zu vermeiden.
=== Slave Device Weight prüfen ===
Das Slave Device Weight ist eine Kenngröße für die Kabellänge in Verbindung mit den angeschlossenen Devices innerhalb eines Bus Strangs. Hierbei wird die Kabellänge und die Anzahl der angeschlossenen 1-wire Slaves zu einem "Gewicht" ermittelt. Hierbei hat ein iButton die Kenngröße "1m" und normale Devices eine Kenngröße von "0.5m" in Verbindung mit der Kabellänge kann man so den maximalen Ausbau seines möglichen Bus ermitteln.

[[Kategorie:1-Wire]]

Datei:1wiresignal.png

2015-04-29T19:48:24Z

Ritchie: Signal behavior of a 1-Wire Signal Red line shows the 1-Wire Signal (a Part of the Signal) and a small under shoot. The yellow line show the voltage ripple during 1-Wire signal.

Signal behavior of a 1-Wire Signal
Red line shows the 1-Wire Signal (a Part of the Signal) and a small under shoot. The yellow line show the voltage ripple during 1-Wire signal.

1-Wire Störungsbeseitigung

2015-04-29T18:36:12Z

Ritchie: Einfügen eines Bild für die Darstellung der Search Fehler aus dem Webinterface

Generell beschreiben die folgenden Punkte Informationen aus dem Dokument [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“]. Dieser Absatz soll eine zusätzliche Hilfe darstellen und bezieht sich aus den Informationen des obigen Dokuments mit einigen praktischen Hinweisen.
== Bus Fehler feststellen==
Der OWServer und die entsprechende Webseite des Servers bietet einige Möglichkeiten um Fehler auf dem 1-Wire Bus festzustellen. Die Fehler können innerhalb der Statistik des OW Servers gesehen werden.
=== CRC Fehler ===
[[Bild:1wireowservererrorstatus.png|mini|100px|rechts|Anzeige der CRC Fehler für den Bus]]
Die [http://de.wikipedia.org/wiki/Zyklische_Redundanzpr%C3%BCfung CRC Fehler] werden auf der Seite „http://<IP-OWSERVER>:2121/bus.0/statistics/errors“ dargestellt. Hier sieht man die Anzahl der übertragenen Pakete und deren Fehleranzahl. Bei einem guten Bus sollte die Anzahl der CRC8 / CRC16 = 0 sein. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den gesendeten Protokollen ist, umso schlechter ist der Bus.

=== Search Fehler ===
[[Bild:1wireowserversearcherror.png|mini|100px|rechts|Anzeige des Fehlerstatus für den Bus]]
Sollten während der Suche von Busteilnehmer auf dem 1-Wire Bus Fehler auftreten, werden diese auf diese Webseite des OW Server dargestellt. Hier sollte auch immer eine 0 stehen. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den Suchanfragen ist, umso schlechter ist der Bus. http://<IP-OWSERVER>:2121/bus.0/bus.2/interface/statistics/search_errors

=== Generelle Fehler===
Sollten werden eine Schreibvorgangs oder Lesevorgangs generelle Fehler auftauchen, so werden hier die entsprechenden Fehlerzähler angezeigt. Im Normalfall sollte auch hier 0 stehen. http://<IP-OWSERVER>:2121/bus.0/bus.0/interface/statistics

== Bus Fehler Ursache suchen ==
Um die Fehlerquellen entsprechend einzukreisen, kann man wie folgt vorgehen, um die Ursache zu finden und entsprechend zu beseitigen.
Es wird generell von einer korrekten Konfiguration des OW-Servers ausgegangen.
=== Kurzschluss prüfen ===
Zeigen sich auf dem 1-Wire Bus keine Teilnehmer, liegt die Vermutung nahe, das ein Kurzschluss auf dem Bus vorhanden ist (oder auch die Datenleitung durch einen 1-Wire Teilnehmer auf 0 Volt gezogen wird. Dies kann durch Software 1-Wire Bausteine auch passieren).

Alle Teilnehmer entfernen und die Leitungen entsprechend durchmessen. Hierbei kann auch eine hochohmige Verbindung (kein direkter Kurzschluss) eine Problem sein. Um diese auszuschließen muss das Multimeter im Mega-Ohm Bereich eingestellt werden und die Leitungen prüfen. Danach jeden Teilnehmer einzeln wieder in den Bus aufnehmen und prüfen, ob der Bus noch in Ordnung ist (Error Counter prüfen).
=== Leitungsbruch prüfen ===
Sind an allen Teilnehmer alle Leitungen korrekt angeschlossen. Sind Klemmen verwendet, da sollte man prüfen, ob alle Drähte fest angeschlossen. Man sollte an den Drähten ziehen können, ohne das sich der Draht löst. Wenn man LSA Klemmen verwendet, sollte man prüfen, ob der Draht auch wirklich tief in die Klemme gedrückt wurde. Evtl. einfach nochmals alle Kontakte nachdrücken. Kalte Lötstellen sind auch eine mögliche Problemstelle.

=== Spannungsversorgung prüfen ===
Damit der 1-Wire Bus stabil arbeiten kann, muss die Spannungsversorgung aller Busteilnehmer stabil sein.
Einen ersten Test kann man mit einem normalen Multimeter durchführen. Hierbei sollte die Spannung an allen
Teilstrecken des Bus zwischen 4,9V und 5.2Volt liegen. '''Ein Multimeter kann kurzzeitige Spannungseinbrüche nicht messen!'''
Hier ist ein Oszilloskope für die genaue Messung notwendig. Dann kann auch die Brummspannung (Ripple) auf der 5V Leitung gemessen werden. Eine Brummspannung größer 100mV (eigentlich weniger) ist ein Zeichen für eine fehlerhafte Spannungsversorgung und sollte geprüft werden. Hier könnten Filterschaltungen oder ein besseres Netzteil Abhilfe schaffen.

=== Signalverhalten prüfen ===
Ein Fehler, welcher bei Leitungen im kurzen und mittleren Bereich gerne auftritt, ist das „'''ringing/undershoot'''“ Signal.
Hierbei wird kurzzeitige das 1-Wire Signal in den negativen Spannungsbereich gezogen (Impulse von bis -0.5Volt und mehr sind keine Seltenheit).
Ein entsprechendes Bild des Signalverlauf kann man auf der Seite 10 (Appendix D. Waveform Examples) des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] sehen.

Dieser Effekt wird durch die angeschlossenen Client's bei einem Bus Reset durch den Master erzeugt.
Diese Impulse können hierbei die angeschlossenen 1-wire Teilnehmer in der Signalfolge des 1-wire Protokolle aus dem Tritt bringen.
Der Effekt zeigt sich z.B. durch kommen und gehende Teilnehmer in der Device-Übersicht des OW Servers.
Diesen Effekt kann man nur mit einem Oszilloskope messen/darstellen.

Eine '''Abhilfe''' ist hier nur die Einbringung eines '''RC-Glied''' in den Anfang des betroffenen 1-Wire Bus.
Laut Guideline von Maxim sollte es ein 68 Ohm Widerstand sein und ein 470pF oder 4700pF je nach Leitungslänge sein.
Der entsprechend Schaltplan ist auf der Seite 9 des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] zu sehen.
== Bus Erweiterungen ==
Wenn der 1-wire Bus erweitert wird, kann sich das Leitungsverhalten ändern, insbesondere dann, wenn man nicht die optimale Netztopologie "Linear" verwendet.
=== Stubs vermeiden ===
Hier können die sogenannten '''Stub''', Abzweigungen vom Hauptstrang zum Problem werden. Sind diese Abzweigungen länger als 3m, beeinflussen sie nachweislich das Signalverhalten, da man in diesem Fall nicht mehr von einem linearen Bus, sondern einem '''stubbed''' Topologie redet. Die Leitungsrefektionen dieser Seitenarme können den Bus stören und sind daher zu vermeiden.
=== Slave Device Weight prüfen ===
Das Slave Device Weight ist eine Kenngröße für die Kabellänge in Verbindung mit den angeschlossenen Devices innerhalb eines Bus Strangs. Hierbei wird die Kabellänge und die Anzahl der angeschlossenen 1-wire Slaves zu einem "Gewicht" ermittelt. Hierbei hat ein iButton die Kenngröße "1m" und normale Devices eine Kenngröße von "0.5m" in Verbindung mit der Kabellänge kann man so den maximalen Ausbau seines möglichen Bus ermitteln.

[[Kategorie:1-Wire]]

Datei:1wireowserversearcherror.png

2015-04-29T18:34:02Z

Ritchie: Display of the search errors of the 1-Wire Bus

Display of the search errors of the 1-Wire Bus

1-Wire Störungsbeseitigung

2015-04-29T18:30:06Z

Ritchie: Bild des Webinterface für die Anzeige eines CRC Fehler vom owserver eingefügt

Generell beschreiben die folgenden Punkte Informationen aus dem Dokument [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“]. Dieser Absatz soll eine zusätzliche Hilfe darstellen und bezieht sich aus den Informationen des obigen Dokuments mit einigen praktischen Hinweisen.
== Bus Fehler feststellen==
Der OWServer und die entsprechende Webseite des Servers bietet einige Möglichkeiten um Fehler auf dem 1-Wire Bus festzustellen. Die Fehler können innerhalb der Statistik des OW Servers gesehen werden.
=== CRC Fehler ===
[[Bild:1wireowservererrorstatus.png|mini|100px|rechts|Anzeige der CRC Fehler für den Bus]]
Die [http://de.wikipedia.org/wiki/Zyklische_Redundanzpr%C3%BCfung CRC Fehler] werden auf der Seite „http://<IP-OWSERVER>:2121/bus.0/statistics/errors“ dargestellt. Hier sieht man die Anzahl der übertragenen Pakete und deren Fehleranzahl. Bei einem guten Bus sollte die Anzahl der CRC8 / CRC16 = 0 sein. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den gesendeten Protokollen ist, umso schlechter ist der Bus.

=== Search Fehler ===
Sollten während der Suche von Busteilnehmer auf dem 1-Wire Bus Fehler auftreten, werden diese auf diese Webseite des OW Server dargestellt. Hier sollte auch immer eine 0 stehen. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den Suchanfragen ist, umso schlechter ist der Bus. http://<IP-OWSERVER>:2121/bus.0/bus.2/interface/statistics/search_errors
=== Generelle Fehler===
Sollten werden eine Schreibvorgangs oder Lesevorgangs generelle Fehler auftauchen, so werden hier die entsprechenden Fehlerzähler angezeigt. Im Normalfall sollte auch hier 0 stehen. http://<IP-OWSERVER>:2121/bus.0/bus.0/interface/statistics

== Bus Fehler Ursache suchen ==
Um die Fehlerquellen entsprechend einzukreisen, kann man wie folgt vorgehen, um die Ursache zu finden und entsprechend zu beseitigen.
Es wird generell von einer korrekten Konfiguration des OW-Servers ausgegangen.
=== Kurzschluss prüfen ===
Zeigen sich auf dem 1-Wire Bus keine Teilnehmer, liegt die Vermutung nahe, das ein Kurzschluss auf dem Bus vorhanden ist (oder auch die Datenleitung durch einen 1-Wire Teilnehmer auf 0 Volt gezogen wird. Dies kann durch Software 1-Wire Bausteine auch passieren).

Alle Teilnehmer entfernen und die Leitungen entsprechend durchmessen. Hierbei kann auch eine hochohmige Verbindung (kein direkter Kurzschluss) eine Problem sein. Um diese auszuschließen muss das Multimeter im Mega-Ohm Bereich eingestellt werden und die Leitungen prüfen. Danach jeden Teilnehmer einzeln wieder in den Bus aufnehmen und prüfen, ob der Bus noch in Ordnung ist (Error Counter prüfen).
=== Leitungsbruch prüfen ===
Sind an allen Teilnehmer alle Leitungen korrekt angeschlossen. Sind Klemmen verwendet, da sollte man prüfen, ob alle Drähte fest angeschlossen. Man sollte an den Drähten ziehen können, ohne das sich der Draht löst. Wenn man LSA Klemmen verwendet, sollte man prüfen, ob der Draht auch wirklich tief in die Klemme gedrückt wurde. Evtl. einfach nochmals alle Kontakte nachdrücken. Kalte Lötstellen sind auch eine mögliche Problemstelle.

=== Spannungsversorgung prüfen ===
Damit der 1-Wire Bus stabil arbeiten kann, muss die Spannungsversorgung aller Busteilnehmer stabil sein.
Einen ersten Test kann man mit einem normalen Multimeter durchführen. Hierbei sollte die Spannung an allen
Teilstrecken des Bus zwischen 4,9V und 5.2Volt liegen. '''Ein Multimeter kann kurzzeitige Spannungseinbrüche nicht messen!'''
Hier ist ein Oszilloskope für die genaue Messung notwendig. Dann kann auch die Brummspannung (Ripple) auf der 5V Leitung gemessen werden. Eine Brummspannung größer 100mV (eigentlich weniger) ist ein Zeichen für eine fehlerhafte Spannungsversorgung und sollte geprüft werden. Hier könnten Filterschaltungen oder ein besseres Netzteil Abhilfe schaffen.

=== Signalverhalten prüfen ===
Ein Fehler, welcher bei Leitungen im kurzen und mittleren Bereich gerne auftritt, ist das „'''ringing/undershoot'''“ Signal.
Hierbei wird kurzzeitige das 1-Wire Signal in den negativen Spannungsbereich gezogen (Impulse von bis -0.5Volt und mehr sind keine Seltenheit).
Ein entsprechendes Bild des Signalverlauf kann man auf der Seite 10 (Appendix D. Waveform Examples) des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] sehen.

Dieser Effekt wird durch die angeschlossenen Client's bei einem Bus Reset durch den Master erzeugt.
Diese Impulse können hierbei die angeschlossenen 1-wire Teilnehmer in der Signalfolge des 1-wire Protokolle aus dem Tritt bringen.
Der Effekt zeigt sich z.B. durch kommen und gehende Teilnehmer in der Device-Übersicht des OW Servers.
Diesen Effekt kann man nur mit einem Oszilloskope messen/darstellen.

Eine '''Abhilfe''' ist hier nur die Einbringung eines '''RC-Glied''' in den Anfang des betroffenen 1-Wire Bus.
Laut Guideline von Maxim sollte es ein 68 Ohm Widerstand sein und ein 470pF oder 4700pF je nach Leitungslänge sein.
Der entsprechend Schaltplan ist auf der Seite 9 des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] zu sehen.
== Bus Erweiterungen ==
Wenn der 1-wire Bus erweitert wird, kann sich das Leitungsverhalten ändern, insbesondere dann, wenn man nicht die optimale Netztopologie "Linear" verwendet.
=== Stubs vermeiden ===
Hier können die sogenannten '''Stub''', Abzweigungen vom Hauptstrang zum Problem werden. Sind diese Abzweigungen länger als 3m, beeinflussen sie nachweislich das Signalverhalten, da man in diesem Fall nicht mehr von einem linearen Bus, sondern einem '''stubbed''' Topologie redet. Die Leitungsrefektionen dieser Seitenarme können den Bus stören und sind daher zu vermeiden.
=== Slave Device Weight prüfen ===
Das Slave Device Weight ist eine Kenngröße für die Kabellänge in Verbindung mit den angeschlossenen Devices innerhalb eines Bus Strangs. Hierbei wird die Kabellänge und die Anzahl der angeschlossenen 1-wire Slaves zu einem "Gewicht" ermittelt. Hierbei hat ein iButton die Kenngröße "1m" und normale Devices eine Kenngröße von "0.5m" in Verbindung mit der Kabellänge kann man so den maximalen Ausbau seines möglichen Bus ermitteln.

[[Kategorie:1-Wire]]

Datei:1wireowservererrorstatus.png

2015-04-29T18:12:46Z

Ritchie: Display of the bus error status of the selected 1-Wire Bus, using the owserver web interface

Display of the bus error status of the selected
1-Wire Bus, using the owserver web interface

1-Wire Störungsbeseitigung

2015-04-26T15:04:06Z

Ritchie: Die Seite wurde neu angelegt: „Generell beschreiben die folgenden Punkte Informationen aus dem Dokument [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliab…“

Generell beschreiben die folgenden Punkte Informationen aus dem Dokument [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“]. Dieser Absatz soll eine zusätzliche Hilfe darstellen und bezieht sich aus den Informationen des obigen Dokuments mit einigen praktischen Hinweisen.
== Bus Fehler feststellen==
Der OWServer und die entsprechende Webseite des Servers bietet einige Möglichkeiten um Fehler auf dem 1-Wire Bus festzustellen. Die Fehler können innerhalb der Statistik des OW Servers gesehen werden.
=== CRC Fehler ===
Die [http://de.wikipedia.org/wiki/Zyklische_Redundanzpr%C3%BCfung CRC Fehler] werden auf der Seite „http://<IP-OWSERVER>:2121/bus.0/statistics/errors“ dargestellt. Hier sieht man die Anzahl der übertragenen Pakete und deren Fehleranzahl. Bei einem guten Bus sollte die Anzahl der CRC8 / CRC16 = 0 sein. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den gesendeten Protokollen ist, umso schlechter ist der Bus.

=== Search Fehler ===
Sollten während der Suche von Busteilnehmer auf dem 1-Wire Bus Fehler auftreten, werden diese auf diese Webseite des OW Server dargestellt. Hier sollte auch immer eine 0 stehen. Generell kann man sagen, je größer diese Zahl im Verhältnis zu den Suchanfragen ist, umso schlechter ist der Bus. http://<IP-OWSERVER>:2121/bus.0/bus.2/interface/statistics/search_errors
=== Generelle Fehler===
Sollten werden eine Schreibvorgangs oder Lesevorgangs generelle Fehler auftauchen, so werden hier die entsprechenden Fehlerzähler angezeigt. Im Normalfall sollte auch hier 0 stehen. http://<IP-OWSERVER>:2121/bus.0/bus.0/interface/statistics

== Bus Fehler Ursache suchen ==
Um die Fehlerquellen entsprechend einzukreisen, kann man wie folgt vorgehen, um die Ursache zu finden und entsprechend zu beseitigen.
Es wird generell von einer korrekten Konfiguration des OW-Servers ausgegangen.
=== Kurzschluss prüfen ===
Zeigen sich auf dem 1-Wire Bus keine Teilnehmer, liegt die Vermutung nahe, das ein Kurzschluss auf dem Bus vorhanden ist (oder auch die Datenleitung durch einen 1-Wire Teilnehmer auf 0 Volt gezogen wird. Dies kann durch Software 1-Wire Bausteine auch passieren).

Alle Teilnehmer entfernen und die Leitungen entsprechend durchmessen. Hierbei kann auch eine hochohmige Verbindung (kein direkter Kurzschluss) eine Problem sein. Um diese auszuschließen muss das Multimeter im Mega-Ohm Bereich eingestellt werden und die Leitungen prüfen. Danach jeden Teilnehmer einzeln wieder in den Bus aufnehmen und prüfen, ob der Bus noch in Ordnung ist (Error Counter prüfen).
=== Leitungsbruch prüfen ===
Sind an allen Teilnehmer alle Leitungen korrekt angeschlossen. Sind Klemmen verwendet, da sollte man prüfen, ob alle Drähte fest angeschlossen. Man sollte an den Drähten ziehen können, ohne das sich der Draht löst. Wenn man LSA Klemmen verwendet, sollte man prüfen, ob der Draht auch wirklich tief in die Klemme gedrückt wurde. Evtl. einfach nochmals alle Kontakte nachdrücken. Kalte Lötstellen sind auch eine mögliche Problemstelle.

=== Spannungsversorgung prüfen ===
Damit der 1-Wire Bus stabil arbeiten kann, muss die Spannungsversorgung aller Busteilnehmer stabil sein.
Einen ersten Test kann man mit einem normalen Multimeter durchführen. Hierbei sollte die Spannung an allen
Teilstrecken des Bus zwischen 4,9V und 5.2Volt liegen. '''Ein Multimeter kann kurzzeitige Spannungseinbrüche nicht messen!'''
Hier ist ein Oszilloskope für die genaue Messung notwendig. Dann kann auch die Brummspannung (Ripple) auf der 5V Leitung gemessen werden. Eine Brummspannung größer 100mV (eigentlich weniger) ist ein Zeichen für eine fehlerhafte Spannungsversorgung und sollte geprüft werden. Hier könnten Filterschaltungen oder ein besseres Netzteil Abhilfe schaffen.

=== Signalverhalten prüfen ===
Ein Fehler, welcher bei Leitungen im kurzen und mittleren Bereich gerne auftritt, ist das „'''ringing/undershoot'''“ Signal.
Hierbei wird kurzzeitige das 1-Wire Signal in den negativen Spannungsbereich gezogen (Impulse von bis -0.5Volt und mehr sind keine Seltenheit).
Ein entsprechendes Bild des Signalverlauf kann man auf der Seite 10 (Appendix D. Waveform Examples) des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] sehen.

Dieser Effekt wird durch die angeschlossenen Client's bei einem Bus Reset durch den Master erzeugt.
Diese Impulse können hierbei die angeschlossenen 1-wire Teilnehmer in der Signalfolge des 1-wire Protokolle aus dem Tritt bringen.
Der Effekt zeigt sich z.B. durch kommen und gehende Teilnehmer in der Device-Übersicht des OW Servers.
Diesen Effekt kann man nur mit einem Oszilloskope messen/darstellen.

Eine '''Abhilfe''' ist hier nur die Einbringung eines '''RC-Glied''' in den Anfang des betroffenen 1-Wire Bus.
Laut Guideline von Maxim sollte es ein 68 Ohm Widerstand sein und ein 470pF oder 4700pF je nach Leitungslänge sein.
Der entsprechend Schaltplan ist auf der Seite 9 des [http://www.maximintegrated.com/en/app-notes/index.mvp/id/148 „Guidelines for Reliable Long 1-Wire Networks.“] zu sehen.
== Bus Erweiterungen ==
Wenn der 1-wire Bus erweitert wird, kann sich das Leitungsverhalten ändern, insbesondere dann, wenn man nicht die optimale Netztopologie "Linear" verwendet.
=== Stubs vermeiden ===
Hier können die sogenannten '''Stub''', Abzweigungen vom Hauptstrang zum Problem werden. Sind diese Abzweigungen länger als 3m, beeinflussen sie nachweislich das Signalverhalten, da man in diesem Fall nicht mehr von einem linearen Bus, sondern einem '''stubbed''' Topologie redet. Die Leitungsrefektionen dieser Seitenarme können den Bus stören und sind daher zu vermeiden.
=== Slave Device Weight prüfen ===
Das Slave Device Weight ist eine Kenngröße für die Kabellänge in Verbindung mit den angeschlossenen Devices innerhalb eines Bus Strangs. Hierbei wird die Kabellänge und die Anzahl der angeschlossenen 1-wire Slaves zu einem "Gewicht" ermittelt. Hierbei hat ein iButton die Kenngröße "1m" und normale Devices eine Kenngröße von "0.5m" in Verbindung mit der Kabellänge kann man so den maximalen Ausbau seines möglichen Bus ermitteln.

[[Kategorie:1-Wire]]

PDF Datei darstellen

2013-12-27T16:27:00Z

Ritchie: /* FireFox */

= PDF Dateien unter FHEM darstellen =

Mit den folgenden Zeilen kann man eine PDF Datei direkt in seiner FHEM Webseite darstellen. Der PDF
Reader wird in dem entsprechenden Frame des Computers geöffnet.

'''Für fhem.cfg'''
<nowiki>### Aufruf der FHEM Anfänger Anleitung via https
define FhemDoc weblink iframe https://fhem:8083/fhem/docs/fhem-floorplan-installation-guide_de.pdf
attr FhemDoc room Anleitung
attr FhemDoc htmlattr width="600" height="900" frameborder="0" marginheight="0" marginwidth="0"
</nowiki>

Mittels des "htmlattr" kann man die Größe des PDF-Viewers innerhalb der Webseite bestimmen.

Hierbei wird bei Anwahl des Menüpunkt "Fhemdoc" innerhalb des gleichen Frames ein PDF Reader geöffnet und
dieser zeigt dann die entsprechende PDF Seite an.
== PC basierend ==
=== Linux ===
Das Darstellen oder Einbinden von Dokumentation ist auf linux PC ist generell einfach, da durch den Aufruf automatisch ein entsprechender Reader geladen wird. Unter Linux (kubuntu) wird automatisch okula geöffnet.
=== Windows/Mac ===
Auf einer Windows-Maschine oder Mac Maschine ist meist der Acrobat Reader installiert und sollte daher auch sofort arbeitet. Sollte die Darstellung nicht arbeiten, fehlt meistens das Acrobat Reader Plug-in des Internet Browsers.
== Android basierend ==
=== Standard Browser ===
Standardmäßig stellt der WEB Browser eines Android Handy's oder Tablet keine PDF Dateien dar. Die Datei wird automatisch gedownloaded und muss dann manuell mit einem PDF Reader geöffnet.
=== FireFox ===
Der Browser "FireFox" biete die Möglichkeit von Addons, welche den Browser um weitere Funktionen erweitert.

Nachdem man im Google Play Store das Programm-Paket "Fire Fox" hinzugefügt hat und diesen nach seinen Wünschen konfiguiert hat, muss hier noch das Addon für "Fire Fox" namens "PDF Viewer" zu Firefox hinzugefügt werden.

;HInweis zum Browser FireFox
*Firefox scheint ein Problem mit dem "iFrame" Code zu haben, da ein entsprechender Code nicht auf der Webseite darstellt wird.
*Firefox ist generell nicht der schnellste Browser

; Nachteile der PDF Viewer Lösung
* Die Software wandelt die PDF Datei beim Öffnen der PDF-Datei diese in HTML5 um. Hierdurch ist die Darstellung der PDF Datei sehr langsam. Leider ist dies derzeit die einzige Lösung (Stand 12.2013), wie man in Webseiten eine PDF Datei unter Fire Fox darstellen kann.

=== Dolphin Browser ===
Infos fehlen noch
=== Boat Browser ===
Infos fehlen noch
=== Maxthon Browser ===
Infos fehlen noch
=== Opera Browser ===
Infos fehlen noch
=== UC Browser ===
Infos fehlen noch
=== Chrome Browser ===
Infos fehlen noch

[[Kategorie:HOWTOS]]

PDF Datei darstellen

2013-12-13T17:03:03Z

Ritchie: /* PDF Dateien unter FHEM darstellen */

= PDF Dateien unter FHEM darstellen =

Mit den folgenden Zeilen kann man eine PDF Datei direkt in seiner FHEM Webseite darstellen. Der PDF
Reader wird in dem entsprechenden Frame des Computers geöffnet.

'''Für fhem.cfg'''
<nowiki>### Aufruf der FHEM Anfänger Anleitung via https
define FhemDoc weblink iframe https://fhem:8083/fhem/docs/fhem-floorplan-installation-guide_de.pdf
attr FhemDoc room Anleitung
attr FhemDoc htmlattr width="600" height="900" frameborder="0" marginheight="0" marginwidth="0"
</nowiki>

Mittels des "htmlattr" kann man die Größe des PDF-Viewers innerhalb der Webseite bestimmen.

Hierbei wird bei Anwahl des Menüpunkt "Fhemdoc" innerhalb des gleichen Frames ein PDF Reader geöffnet und
dieser zeigt dann die entsprechende PDF Seite an.
== PC basierend ==
=== Linux ===
Das Darstellen oder Einbinden von Dokumentation ist auf linux PC ist generell einfach, da durch den Aufruf automatisch ein entsprechender Reader geladen wird. Unter Linux (kubuntu) wird automatisch okula geöffnet.
=== Windows/Mac ===
Auf einer Windows-Maschine oder Mac Maschine ist meist der Acrobat Reader installiert und sollte daher auch sofort arbeitet. Sollte die Darstellung nicht arbeiten, fehlt meistens das Acrobat Reader Plug-in des Internet Browsers.
== Android basierend ==
=== Standard Browser ===
Standardmäßig stellt der WEB Browser eines Android Handy's oder Tablet keine PDF Dateien dar. Die Datei wird automatisch gedownloaded und muss dann manuell mit einem PDF Reader geöffnet.
=== FireFox ===
Der Browser "FireFox" biete die Möglichkeit von Addons, welche den Browser um weitere Funktionen erweitert.

Nachdem man im Google Play Store das Programm-Paket "Fire Fox" hinzugefügt hat und diesen nach seinen Wünschen konfiguiert hat, muss hier noch das Addon für "Fire Fox" namens "PDF Viewer" zu Firefox hinzugefügt werden.

; Nachteile der PDF Viewer Lösung
* Die Software wandelt die PDF Datei beim Öffnen der PDF-Datei diese in HTML5 um. Hierdurch ist die Darstellung der PDF Datei sehr langsam. Leider ist dies derzeit die einzige Lösung (Stand 12.2013), wie man in Webseiten eine PDF Datei unter Fire Fox darstellen kann.
=== Dolphin Browser ===
Infos fehlen noch
=== Boat Browser ===
Infos fehlen noch
=== Maxthon Browser ===
Infos fehlen noch
=== Opera Browser ===
Infos fehlen noch
=== UC Browser ===
Infos fehlen noch
=== Chrome Browser ===
Infos fehlen noch

[[Kategorie:HOWTOS]]

PDF Datei darstellen

2013-12-13T17:00:43Z

Ritchie: Die Seite wurde neu angelegt: „= PDF Dateien unter FHEM darstellen = Mit den folgenden Zeilen kann man eine PDF Datei direkt in seiner FHEM Webseite darstellen. Der PDF Reader wird in dem e…“

= PDF Dateien unter FHEM darstellen =

Mit den folgenden Zeilen kann man eine PDF Datei direkt in seiner FHEM Webseite darstellen. Der PDF
Reader wird in dem entsprechenden Frame des Computers geöffnet.

'''Für fhem.cfg'''
<nowiki>### Aufruf der FHEM Anfänger Anleitung via https
define FhemDoc weblink iframe https://fhem:8083/fhem/docs/fhem-floorplan-installation-guide_de.pdf
attr FhemDoc room Anleitung
attr FhemDoc htmlattr width="600" height="900" frameborder="0" marginheight="0" marginwidth="0"
</nowiki>

Mittels des "htmlattr" kann man die Größe des PDF-Viewers innerhalb der Webseite bestimmen.

Hierbei wird bei Anwahl des Menüpunkt "Fhemdoc" innerhalb des gleichen Frames ein PDF Reader geöffnet und
dieser zeigt dann die entsprechende PDF Seite an.
== PC basierend ==
=== Linux ===
Das Darstellen oder Einbinden von Dokumentation ist auf linux PC ist generell einfach, da durch den Aufruf automatisch ein entsprechender Reader geladen wird. Unter Linux (kubuntu) wird automatisch okula geöffnet.
=== Windows/Mac ===
Auf einer Windows-Maschine oder Mac Maschine ist meist der Acrobat Reader installiert und sollte daher auch sofort arbeitet. Sollte die Darstellung nicht arbeiten, fehlt meistens das Acrobat Reader Plug-in des Internet Browsers.
== Android basierend ==
=== Standard Browser ===
Standardmäßig stellt der WEB Browser eines Android Handy's oder Tablet keine PDF Dateien dar. Die Datei wird automatisch gedownloaded und muss dann manuell mit einem PDF Reader geöffnet.
=== FireFox ===
Der Browser "FireFox" biete die Möglichkeit von Addons, welche den Browser um weitere Funktionen erweitert.

Nachdem man im Google Play Store das Programm-Paket "Fire Fox" hinzugefügt hat und diesen nach seinen Wünschen konfiguiert hat, muss hier noch das Addon für "Fire Fox" namens "PDF Viewer" zu Firefox hinzugefügt werden.

; Nachteile der PDF Viewer Lösung
* Die Software wandelt die PDF Datei beim Öffnen der PDF-Datei diese in HTML5 um. Hierdurch ist die Darstellung der PDF Datei sehr langsam. Leider ist dies derzeit die einzige Lösung (Stand 12.2013), wie man in Webseiten eine PDF Datei unter Fire Fox darstellen kann.
=== Dolphin Browser ===
Infos fehlen noch
=== Boat Browser ===
Infos fehlen noch
=== Maxthon Browser ===
Infos fehlen noch
=== Opera Browser ===
Infos fehlen noch
=== UC Browser ===
Infos fehlen noch
=== Chrome Browser ===
Infos fehlen noch

Listenlive

2013-12-13T16:15:59Z

Ritchie: /* SkyTC Hardware */

ListenLive ist eine
* alternative Firmware für eine Reihe von Webradio Geräten (dadurch wird es für FHEM relevant)
* Datenbank mit Informationen und Links zu Webradio und WebTV Sendern

= Hardware =
Die Firmware von ListenLive arbeitet mit einer Vielzahl von Webradio Geräten zusammen. Einen Überblick über unterstützte Geräte geben die folgenden Abschnitte. Eine detaillierte aktuelle Liste findet sich jeweils auf der [http://listenlive.nl/dl.php ListenLive Webseite].

== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson,
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys,
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI,
Pbirkit2, Konig HAV-20/21/22

== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [[Xoro HMT 350]], XORO HMT370,
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235,
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv

= Firmware =
Auf der ListenLive Webseite gibt es für Webradios der Hersteller PenPex und SkytV eine alternative Firmware. Die derzeitige Version 1.49 (Stand 06.2013) wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert.
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket.
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet.
Im Wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig.
Das Radio sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen,
dass man in den Netzwerkeinstellungen für dieses Geräte die Einstellung
* "Diesem Gerät immer die gleiche IP Adresse vergeben."
verwendet.
Die korrekte Erkennung des Radios erfolgt hierbei über die Mac-Adresse des WLAN Interfaces
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080

== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
; Die Uhrzeit anzeigen
* "CLOCK" an das Radio senden
* "EXIT" beendet die Anzeige der Uhrzeit wieder
; Die Lautstärke ändert
* "VOLp" für lauter und "VOLm" für leiser an das Radio sendet

== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1)" verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.

== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Bekannte Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das Ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==
* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]
[[Kategorie:Socks]]

Listenlive

2013-12-13T16:15:12Z

Ritchie: /* SkyTC Hardware */

ListenLive ist eine
* alternative Firmware für eine Reihe von Webradio Geräten (dadurch wird es für FHEM relevant)
* Datenbank mit Informationen und Links zu Webradio und WebTV Sendern

= Hardware =
Die Firmware von ListenLive arbeitet mit einer Vielzahl von Webradio Geräten zusammen. Einen Überblick über unterstützte Geräte geben die folgenden Abschnitte. Eine detaillierte aktuelle Liste findet sich jeweils auf der [http://listenlive.nl/dl.php ListenLive Webseite].

== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson,
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys,
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI,
Pbirkit2, Konig HAV-20/21/22

== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [[Xoro HMT 350]], XORO HMT370,
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235,
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv

[[Darstellung einer PDF Seite im Handy oder Tablet]]

= Firmware =
Auf der ListenLive Webseite gibt es für Webradios der Hersteller PenPex und SkytV eine alternative Firmware. Die derzeitige Version 1.49 (Stand 06.2013) wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert.
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket.
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet.
Im Wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig.
Das Radio sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen,
dass man in den Netzwerkeinstellungen für dieses Geräte die Einstellung
* "Diesem Gerät immer die gleiche IP Adresse vergeben."
verwendet.
Die korrekte Erkennung des Radios erfolgt hierbei über die Mac-Adresse des WLAN Interfaces
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080

== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
; Die Uhrzeit anzeigen
* "CLOCK" an das Radio senden
* "EXIT" beendet die Anzeige der Uhrzeit wieder
; Die Lautstärke ändert
* "VOLp" für lauter und "VOLm" für leiser an das Radio sendet

== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1)" verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.

== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Bekannte Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das Ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==
* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]
[[Kategorie:Socks]]

Fritzbox via URL (http) steuern

2013-07-16T16:46:54Z

Ritchie: /* Wlan ein/ausschalten */ Fritzbox System Log Eintrag eingefügt.

= Einleitung =

Im Gegensatz zu der Anderen hier vorgestellten Lösung arbeitet diese Lösung mit einem PHP Programm, welches einige API Funktionen der Fritzbox zur Verfügung stellt. 
Hierbei erfolgt die Steuerung der Fritzbox mittels eines Remote Login in der gleichen Weise, wie es mittels der WEB Oberfläche der Administrator Oberfläche geschieht. Es ist also nicht zwingend notwendig, das dieser Script direkt auf der Fritzbox läuft.
= Voraussetzung =
Es muss PHP 5 (PHP 5.3 und 5.4) auf dem System (Raspberry PI) installiert sein.

Die Installation von PHP kann man unter anderem mit folgenden Befehlen bewerkstelligen:
<nowiki>
sudo bash
sudo apt-get install php5
sudo apt-get install libapache2-mod-php5 libapache2-mod-perl2 php5 php5-cli \
php5-common php5-curl php5-dev php5-gd php5-imap php5-ldap php5-mhash \
php5-mysql php5-odbc php-pear php-apc
</nowiki>
Dies ist nur eine der Möglichkeiten um PHP zu installieren und auf einem Raspberry PI hat diese Procedure ohne Probleme gearbeitet. In dieser Version werden alle notwendigen Lib für das Betreiben eines Webservers installieren. Hierbei sind sicherlich mehr Libs installiert, als für diese Funktion notwendig ist. 
Die Installation kann etwas dauern. Daher sollte man das nicht so zwischendurch machen.

= Basisfunktion für die Steuerung =
Um eine Fritzbox mittels remote Funktionen via einer URL zu steuern, muss ein bestimmtes Anmeldeverfahren (Login-Session) verwendet werden. Eine entsprechende Funktion wird im IP-Phone Forum sehr ausführlich beschrieben und auch weiterentwickelt. 
Hier hat sich das Mitglied "Spackmat" sehr intensive mit dem Thema beschäftigt und eine API Funktion und einige kleine Hilfeprogramme als Download bereitgestellt. Direkten Support gibt es nicht (Freiberufler, gegen Bezahlung natürlich doch), aber es gibt genügend Hinweise und Hilfe von anderen Beträgen.

Hier der Link zum Download der API und Basis Thread, welcher Grundlage für diesen Artikel ist
[http://www.ip-phone-forum.de/showthread.php?t=196309&p=1369463&viewfull=1#post1369463 Fritz!Box API für PHP (inkl. Login-Sessions) im IP-phone-forum]

Ein Download kann nur von dieser Seite gemacht werden, da hier immer die aktuelle Version vorliegt. Es lohnt sich bei Interesse die einzelnen Beträge durchzulesen, da man hier auch andere Funktionen auffinden kann (z.B. reboot der Fritzbox).
'''Folgende Scripte liegen hier bei (Stand 07.2013):'''
== Basis Klasse „fritzbox_api.class.php“ ==
Die Basis Klasse, welche alle Basis Funktionen zur Steuerung des Login Verfahren beinhaltet. Änderungen sind in dieser Datei eigentlich nicht notwendig.
== Konfigurationsdatei „fritzbox_user.conf.php“ ==
In dieser Datei müssen die entsprechenden Parameter der Fritzbox eingetragen werden.
Als da wären die IP Adresse, das Passwort der Weboberfläche der Fritzbox, da der Script die gleichen Aktionen wie die Weboberfläche durchführt.
<nowiki>
# use the new .lua login method in current (end 2012) labor and newer firmwares (Fritz!OS 5.50 and up)
$this->config->setItem('use_lua_login_method', true);
</nowiki>
Bei älteren Fritzboxen muss man hier 'false' eintragen. Dies war für eine 7570 notwendig.
<nowiki>
# set to your Fritz!Box IP address or DNS name (defaults to fritz.box), for remote config mode, use the dyndns-name like example.dyndns.org
$this->config->setItem('fritzbox_ip', 'fritz.box');
</nowiki>
Hier muss die IP Adresse der Fritzbox eingetragen werden. Die meisten Fritzboxen reagieren aber genau auf die url.
<nowiki>
# set to your Fritz!Box password (defaults to no password, will be ignored, when remote config is enabled)
$this->config->setItem('password', 'Hier das Password');
</nowiki>
Hier muss das Password der Fritzbox eingetragen werden, damit die Anmeldung des Scripts an die Fritzbox korrekt arbeitet.
== Gast Wlan ein / ausschalten ==
Mit dieser Funktion kann man das Gast Wlan der Fritzbox ein und ausschalten. Der Parameter 0 schaltet es aus, 1 ein.
<nowiki>fritzbox_guestwlan_on_off.php 0 | 1
</nowiki>
== Telefon anrufen ==
Mit dieser Funktion kann man eine Telefonnummer anrufen. Getestet wurde es mit dem Fritz-Fon. Die Rufnummer steht am Anfang der Datei und ruft in dieser Version das erste Fritz-Fon an.
<nowiki>
fritzbox_ring_phone.php
</nowiki>
== Rufumleitung aktivieren ==
Hiermit wird die Rufumleitung ein/ausgeschaltet, welche in der Fritzbox entsprechend vorher konfiguiert wurde.
<nowiki>
fritzbox_diversity0on.php 0 | 1
</nowiki>
== Gast LAN (Port 4) Schnittstellen ein/ausschalten ==

<nowiki>
fritzbox_guestlan_on_off.php 0 | 1
</nowiki>
== Anrufliste auslesen ==
Hier kann man die Anrufliste auslesen.
<nowiki>
fritzbox_get_foncallslist.php
</nowiki>
== Anrufbeantworter ein/ausschalten ==
Die Funktion schaltet den Anrufbeantworter der Fritzbox ein/aus.
<nowiki>
fritzbox_tam_on_off.php 0 | 1
</nowiki>
== Wlan ein/ausschalten ==
Der folgende Code schaltet das WLAN der Fritzbox ein / aus. Der Parameter ist 0 | 1.
<nowiki>
<?php
$dial = ''; // set to the number to dial
// init the output message
$message = date('Y-m-d H:i') . ' ';
try
{
// load the fritzbox_api class
require_once(__DIR__ . '/fritzbox_api.class.php');
$fritz = new fritzbox_api();

// handle the CLI arguments or give a help message
if (isset($argv[1]) && ($argv[1] == 0 || $argv[1] == 1) )
{
$mode = (bool)$argv[1];
}
else
{
$mode = 0;
}

if( $mode == 1 )
{
$dial = '#96*1*'; // set to the number to dial
}
else
{
$dial = '#96*0*'; // set to the number to dial
}

// update the setting

$formfields = array(
'telcfg:command/Dial' => $dial,
);
$fritz->doPostForm($formfields);
}
catch (Exception $e)
{
$message .= $e->getMessage();
}

// log the result
if ( isset($fritz) && is_object($fritz) && get_class($fritz) == 'fritzbox_api' )
{
$fritz->logMessage($message);
}
else
{
echo($message);
}
$fritz = null; // destroy the object to log out
?>
</nowiki>
Da dieser Befehl derzeit noch nicht in der ZIP Datei eingepflegt ist, hier ein direkter Auszug des Quell Code. Der Code basiert im Grund auf der "Dial" Funktion und verwendet die entsprechenden Rufnummern der Fritzbox zum Ein '#96*1*' und Ausschalten '#96*0*' der WLAN Verbindung.

Das Abschalten des WLAN kann man im Systemlog der Fritzbox einsehen. Hier wird folgender Logeintrag für das Ausschalten und Einschalten erzeugt.
<nowiki>
16.07.13 17:53:18 WLAN wurde über das Telefon aktiviert (2,4 GHz).
16.07.13 17:52:44 WLAN wurde über das Telefon deaktiviert (2,4 GHz).
</nowiki>

= Links =
Weiterführende Information zu diesem Thema findet man hier [http://www.wehavemorefun.de/ AVM Wiki der Fritz Box]

[[Kategorie:HOWTOS]]

Fritzbox via URL (http) steuern

2013-07-15T20:19:14Z

Ritchie: Basisartikel angelegt

= Einleitung =

Im Gegensatz zu der Anderen hier vorgestellten Lösung arbeitet diese Lösung mit einem PHP Programm, welches einige API Funktionen der Fritzbox zur Verfügung stellt. 
Hierbei erfolgt die Steuerung der Fritzbox mittels eines Remote Login in der gleichen Weise, wie es mittels der WEB Oberfläche der Administrator Oberfläche geschieht. Es ist also nicht zwingend notwendig, das dieser Script direkt auf der Fritzbox läuft.
= Voraussetzung =
Es muss PHP 5 (PHP 5.3 und 5.4) auf dem System (Raspberry PI) installiert sein.

Die Installation von PHP kann man unter anderem mit folgenden Befehlen bewerkstelligen:
<nowiki>
sudo bash
sudo apt-get install php5
sudo apt-get install libapache2-mod-php5 libapache2-mod-perl2 php5 php5-cli \
php5-common php5-curl php5-dev php5-gd php5-imap php5-ldap php5-mhash \
php5-mysql php5-odbc php-pear php-apc
</nowiki>
Dies ist nur eine der Möglichkeiten um PHP zu installieren und auf einem Raspberry PI hat diese Procedure ohne Probleme gearbeitet. In dieser Version werden alle notwendigen Lib für das Betreiben eines Webservers installieren. Hierbei sind sicherlich mehr Libs installiert, als für diese Funktion notwendig ist. 
Die Installation kann etwas dauern. Daher sollte man das nicht so zwischendurch machen.

= Basisfunktion für die Steuerung =
Um eine Fritzbox mittels remote Funktionen via einer URL zu steuern, muss ein bestimmtes Anmeldeverfahren (Login-Session) verwendet werden. Eine entsprechende Funktion wird im IP-Phone Forum sehr ausführlich beschrieben und auch weiterentwickelt. 
Hier hat sich das Mitglied "Spackmat" sehr intensive mit dem Thema beschäftigt und eine API Funktion und einige kleine Hilfeprogramme als Download bereitgestellt. Direkten Support gibt es nicht (Freiberufler, gegen Bezahlung natürlich doch), aber es gibt genügend Hinweise und Hilfe von anderen Beträgen.

Hier der Link zum Download der API und Basis Thread, welcher Grundlage für diesen Artikel ist
[http://www.ip-phone-forum.de/showthread.php?t=196309&p=1369463&viewfull=1#post1369463 Fritz!Box API für PHP (inkl. Login-Sessions) im IP-phone-forum]

Ein Download kann nur von dieser Seite gemacht werden, da hier immer die aktuelle Version vorliegt. Es lohnt sich bei Interesse die einzelnen Beträge durchzulesen, da man hier auch andere Funktionen auffinden kann (z.B. reboot der Fritzbox).
'''Folgende Scripte liegen hier bei (Stand 07.2013):'''
== Basis Klasse „fritzbox_api.class.php“ ==
Die Basis Klasse, welche alle Basis Funktionen zur Steuerung des Login Verfahren beinhaltet. Änderungen sind in dieser Datei eigentlich nicht notwendig.
== Konfigurationsdatei „fritzbox_user.conf.php“ ==
In dieser Datei müssen die entsprechenden Parameter der Fritzbox eingetragen werden.
Als da wären die IP Adresse, das Passwort der Weboberfläche der Fritzbox, da der Script die gleichen Aktionen wie die Weboberfläche durchführt.
<nowiki>
# use the new .lua login method in current (end 2012) labor and newer firmwares (Fritz!OS 5.50 and up)
$this->config->setItem('use_lua_login_method', true);
</nowiki>
Bei älteren Fritzboxen muss man hier 'false' eintragen. Dies war für eine 7570 notwendig.
<nowiki>
# set to your Fritz!Box IP address or DNS name (defaults to fritz.box), for remote config mode, use the dyndns-name like example.dyndns.org
$this->config->setItem('fritzbox_ip', 'fritz.box');
</nowiki>
Hier muss die IP Adresse der Fritzbox eingetragen werden. Die meisten Fritzboxen reagieren aber genau auf die url.
<nowiki>
# set to your Fritz!Box password (defaults to no password, will be ignored, when remote config is enabled)
$this->config->setItem('password', 'Hier das Password');
</nowiki>
Hier muss das Password der Fritzbox eingetragen werden, damit die Anmeldung des Scripts an die Fritzbox korrekt arbeitet.
== Gast Wlan ein / ausschalten ==
Mit dieser Funktion kann man das Gast Wlan der Fritzbox ein und ausschalten. Der Parameter 0 schaltet es aus, 1 ein.
<nowiki>fritzbox_guestwlan_on_off.php 0 | 1
</nowiki>
== Telefon anrufen ==
Mit dieser Funktion kann man eine Telefonnummer anrufen. Getestet wurde es mit dem Fritz-Fon. Die Rufnummer steht am Anfang der Datei und ruft in dieser Version das erste Fritz-Fon an.
<nowiki>
fritzbox_ring_phone.php
</nowiki>
== Rufumleitung aktivieren ==
Hiermit wird die Rufumleitung ein/ausgeschaltet, welche in der Fritzbox entsprechend vorher konfiguiert wurde.
<nowiki>
fritzbox_diversity0on.php 0 | 1
</nowiki>
== Gast LAN (Port 4) Schnittstellen ein/ausschalten ==

<nowiki>
fritzbox_guestlan_on_off.php 0 | 1
</nowiki>
== Anrufliste auslesen ==
Hier kann man die Anrufliste auslesen.
<nowiki>
fritzbox_get_foncallslist.php
</nowiki>
== Anrufbeantworter ein/ausschalten ==
Die Funktion schaltet den Anrufbeantworter der Fritzbox ein/aus.
<nowiki>
fritzbox_tam_on_off.php 0 | 1
</nowiki>
== Wlan ein/ausschalten ==
Der folgende Code schaltet das WLAN der Fritzbox ein / aus. Der Parameter ist 0 | 1.
<nowiki>
<?php
$dial = ''; // set to the number to dial
// init the output message
$message = date('Y-m-d H:i') . ' ';
try
{
// load the fritzbox_api class
require_once(__DIR__ . '/fritzbox_api.class.php');
$fritz = new fritzbox_api();

// handle the CLI arguments or give a help message
if (isset($argv[1]) && ($argv[1] == 0 || $argv[1] == 1) )
{
$mode = (bool)$argv[1];
}
else
{
$mode = 0;
}

if( $mode == 1 )
{
$dial = '#96*1*'; // set to the number to dial
}
else
{
$dial = '#96*0*'; // set to the number to dial
}

// update the setting

$formfields = array(
'telcfg:command/Dial' => $dial,
);
$fritz->doPostForm($formfields);
}
catch (Exception $e)
{
$message .= $e->getMessage();
}

// log the result
if ( isset($fritz) && is_object($fritz) && get_class($fritz) == 'fritzbox_api' )
{
$fritz->logMessage($message);
}
else
{
echo($message);
}
$fritz = null; // destroy the object to log out
?>
</nowiki>
Da dieser Befehl derzeit noch nicht in der ZIP Datei eingepflegt ist, hier ein direkter Auszug des Quell Code. Der Code basiert im Grund auf der "Dial" Funktion und verwendet die entsprechenden Rufnummern der Fritzbox zum Ein '#96*1*' und Ausschalten '#96*0*' der WLAN Verbindung.

= Links =
Weiterführende Information zu diesem Thema findet man hier [http://www.wehavemorefun.de/ AVM Wiki der Fritz Box]

[[Kategorie:HOWTOS]]

Listenlive

2013-07-08T07:15:01Z

Ritchie: /* SkyTC Hardware */ Link für XORO angepasst

= Hardware =
Die Firmware von Listenliste arbeitet derzeit (Stand 06.2013) mit der folgenden Hardware für die unter aufgeführten Produkte zusammen.
== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson, 
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys, 
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI, 
Pbirkit2, Konig HAV-20/21/22 
== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [http://www.fhemwiki.de/wiki/Xoro_HMT_350 XORO-HMT350] XORO HMT370, 
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235, 
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv 

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für Webradios der Serie (PenPex und SkytV) eine alternative Firmware. Die derzeit Version 1.49 (Stand 06.2013) 
wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert. 
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket. 
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet. 
Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet. 
== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig. 
Die IP Adresse des Radios sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen, 
das man in den Netzwerkeinstellung für dieses Geräte die Einstellung. 
*"Diesem Gerät immer die gleiche IP Adresse vergeben."
einstellt. 
Die korrekte Erkennung des Radios erfolgt hierbei über die Mac-Adresse des WLAN Interface. 
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080

== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
; Die Uhrzeit anzeigen
* "CLOCK" an das Radio senden
* "EXIT" beendet die Anzeige der Uhrzeit wieder
; Die Lautstärke ändert
* "VOLp" für lauter und "VOLm" für leiser an das Radio sendet

== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1) verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.
== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Xoro HMT 350

2013-07-07T17:14:56Z

Ritchie: /* Technische Daten */ Formatierung bearbeitet

== Webradio mit ListenLive Firmware ==
[[Datei:XORO350.JPG]]

Diese Radio kann nach dem einspielen der Firmware von ListenLive mittels eines TCP/IP Socket über FHEM gesteuert werden.

== Kosten ==
Das Radio kostet im Internet ca. 100 Euro. Bei Pearl kann man es hin und wieder als B Ware für um die 60€ kaufen.

== Nachfolgemodell ==
Es gibt bereits ein Nachfolgemodell (HMT 370) dieses Radios, welches ein größeres Display hat. Verschiedene Kritiken im Internet zeigten unterschiedliche Meinungen, hier sollte jeder sein eigene Endscheidung treffen. Fakt ist jedoch der höhere Stromverbrauch des XORO 370 bedingt durch das größere Display (7 Zoll), was der klare Vorteil des XORO 350 ist.

== Technische Daten ==
'''Stromverbrauch'''
* Display komplett dunkel 1,8 Watt
* Display Normal im Menue 2,3 Watt
* Internet-Radiobetrieb 2,9 Watt 
'''Display Größe'''
*3.5 Zoll
'''Fernbedienung''' 
*IR Fernbedienung
'''Anschlüsse'''
* FM Antenne
* Stereo Eingang (Line In)
* Kartenleser für SD Karten
* Strom Mini USB

== IR Fernbedienung ==
Dem Gerät ist eine IR Fernbedienung beigelegt. Diese Fernbedienung benötigt direkten Sichtkontakt zu Radio und bei einer Entfernung von mehr als 3m ist das Erkennen von Kommandos schon schwieriger. 
[[Datei:Xoro350IRFernbedienung.JPG]]

== Softwarefehler in der Originalsoftware ==
Laut ListenLive befindet sich in der Originalfirmware des XORO 350, welche er mit "[http://de.wikipedia.org/wiki/Reverse_Engineering reverse engineering]" analysiert hat und dann in seine eigene Version umgeändert hat, ein Programmteil, welche nach einem Zufallsverfahren das eingebaute FLASH mit übermässigen Schreibbefehlen kapputt schreibt. Hierdurch soll es zu einem vorzeitigen Geräteausfall kommen. Dieser "Fehler" wird durch dem Austausch der Firmware beseitigt.

Listenlive

2013-07-07T17:13:16Z

Ritchie: /* Vorgehensweise für Radioansteuerung (derzeit) */

= Hardware =
Die Firmware von Listenliste arbeitet derzeit (Stand 06.2013) mit der folgenden Hardware für die unter aufgeführten Produkte zusammen.
== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson, 
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys, 
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI, 
Pbirkit2, Konig HAV-20/21/22 
== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [http://www.fhemwiki.de/wiki/xorohmt350 XORO-HMT350] XORO HMT370, 
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235, 
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv 

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für Webradios der Serie (PenPex und SkytV) eine alternative Firmware. Die derzeit Version 1.49 (Stand 06.2013) 
wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert. 
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket. 
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet. 
Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet. 
== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig. 
Die IP Adresse des Radios sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen, 
das man in den Netzwerkeinstellung für dieses Geräte die Einstellung. 
*"Diesem Gerät immer die gleiche IP Adresse vergeben."
einstellt. 
Die korrekte Erkennung des Radios erfolgt hierbei über die Mac-Adresse des WLAN Interface. 
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080

== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
; Die Uhrzeit anzeigen
* "CLOCK" an das Radio senden
* "EXIT" beendet die Anzeige der Uhrzeit wieder
; Die Lautstärke ändert
* "VOLp" für lauter und "VOLm" für leiser an das Radio sendet

== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1) verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.
== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Listenlive

2013-07-07T17:09:37Z

Ritchie: /* Schnittstellenparameter */ Satzstellung

= Hardware =
Die Firmware von Listenliste arbeitet derzeit (Stand 06.2013) mit der folgenden Hardware für die unter aufgeführten Produkte zusammen.
== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson, 
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys, 
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI, 
Pbirkit2, Konig HAV-20/21/22 
== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [http://www.fhemwiki.de/wiki/xorohmt350 XORO-HMT350] XORO HMT370, 
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235, 
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv 

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für Webradios der Serie (PenPex und SkytV) eine alternative Firmware. Die derzeit Version 1.49 (Stand 06.2013) 
wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert. 
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket. 
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet. 
Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet. 
== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig. 
Die IP Adresse des Radios sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen, 
das man in den Netzwerkeinstellung für dieses Geräte die Einstellung. 
*"Diesem Gerät immer die gleiche IP Adresse vergeben."
einstellt. 
Die korrekte Erkennung des Radios erfolgt hierbei über die Mac-Adresse des WLAN Interface. 
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080

== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1) verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.
== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Listenlive

2013-07-06T18:35:29Z

Ritchie: /* Beispiel für das Einschalten des Radio mit dem ersten Favoriten */

= Hardware =
Die Firmware von Listenliste arbeitet derzeit (Stand 06.2013) mit der folgenden Hardware für die unter aufgeführten Produkte zusammen.
== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson, 
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys, 
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI, 
Pbirkit2, Konig HAV-20/21/22 
== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [http://www.fhemwiki.de/wiki/xorohmt350 XORO-HMT350] XORO HMT370, 
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235, 
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv 

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für Webradios der Serie (PenPex und SkytV) eine alternative Firmware. Die derzeit Version 1.49 (Stand 06.2013) 
wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert. 
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket. 
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet. 
Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet. 
== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig. 
Die IP Adresse des Radios sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen, 
das man in den Netzwerkeinstellung für dieses Geräte die Einstellung. 
Diesem Gerät immer die gleiche IP Adresse vergeben. Die korrekte Erkennung des Radios erfolgt hierbei mit der Mac-Adresse. 
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080
== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Vorgehensweise für Radioansteuerung (derzeit) ==
; Laufende Applikation beenden
* "EXIT" , "EXIT", "EXIT", "EXIT" an das Radio senden
oder 
; Das Radio einschalten (Hier muss FHEM ein Merker halten, ob das Radio an/aus ist)
* "POWER" an das Radio senden
; Das Radio in das Hauptmenu mit dem Eintrag "Favoriten" einstellen
* "HOME" an das Radio senden
; In den Menüeintrag "Favoriten" wechseln
* "OK" an das Radio senden
; Den Eintrag "Internet-Radio Favoriten auswählen"
* "OK" an das Radio senden.
; jetzt den Radiosender auswählen
* "DOWN" an das Radio senden (Eintragsnr -1 ) mal senden
; Jetzt das Radio hören starten
* "OK" an das Radio senden
Während das Radio abgespielt wird, kann man noch auf die Wettervorhersage wechseln. Dies geht mit den folgenden Kommandos:
; Akuelles Wetter auswählen
* "MENU" an das Radio senden
; 5 Tage Vorhersage auswählen (wenn Wetter angezeigt wird)
* "LEFT" an das Radio senden
* nochmals "RIGHT" zeigt wieder das aktuelle Wetter an
; Wetter Anzeige wieder beenden
* "EXIT" senden
== Ansatz für eine erste Lösung des Steuerproblems ==
Eine Klasse schreiben, welche die Steuerung der Menupunkt innerhalb der Klasse kapselt. Der Anwender sollte hierbei nur Kommandos wie "Radio.SenderAbspielen(1) verwenden müssen. Die aktuelle Position innerhalb der Menustruktur sollte die Klasse festhalten.
== Beispielcode für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Xoro HMT 350

2013-07-06T17:41:24Z

Ritchie: /* Technische Daten */ Einfügen der Sektion Fernbedienung

== Webradio mit ListenLive Firmware ==
[[Datei:XORO350.JPG]]

Diese Radio kann nach dem einspielen der Firmware von ListenLive mittels eines TCP/IP Socket über FHEM gesteuert werden.

== Kosten ==
Das Radio kostet im Internet ca. 100 Euro. Bei Pearl kann man es hin und wieder als B Ware für um die 60€ kaufen.

== Nachfolgemodell ==
Es gibt bereits ein Nachfolgemodell (HMT 370) dieses Radios, welches ein größeres Display hat. Verschiedene Kritiken im Internet zeigten unterschiedliche Meinungen, hier sollte jeder sein eigene Endscheidung treffen. Fakt ist jedoch der höhere Stromverbrauch des XORO 370 bedingt durch das größere Display (7 Zoll), was der klare Vorteil des XORO 350 ist.

== Technische Daten ==
'''Stromverbrauch'''
* Display komplett dunkel 1,8 Watt
* Display Normal im Menue 2,3 Watt
* Internet-Radiobetrieb 2,9 Watt
'''Display Größe'''
3.5 Zoll
'''Fernbedienung'''
IR Fernbedienung
'''Anschlüsse'''
* FM Antenne
* Stereo Eingang (Line In)
* Kartenleser für SD Karten
* Strom Mini USB

== IR Fernbedienung ==
Dem Gerät ist eine IR Fernbedienung beigelegt. Diese Fernbedienung benötigt direkten Sichtkontakt zu Radio und bei einer Entfernung von mehr als 3m ist das Erkennen von Kommandos schon schwieriger. 
[[Datei:Xoro350IRFernbedienung.JPG]]

== Softwarefehler in der Originalsoftware ==
Laut ListenLive befindet sich in der Originalfirmware des XORO 350, welche er mit "[http://de.wikipedia.org/wiki/Reverse_Engineering reverse engineering]" analysiert hat und dann in seine eigene Version umgeändert hat, ein Programmteil, welche nach einem Zufallsverfahren das eingebaute FLASH mit übermässigen Schreibbefehlen kapputt schreibt. Hierdurch soll es zu einem vorzeitigen Geräteausfall kommen. Dieser "Fehler" wird durch dem Austausch der Firmware beseitigt.

Datei:Xoro350IRFernbedienung.JPG

2013-07-06T17:33:07Z

Ritchie: Das Bild zeigt die Standard Fernbedienung des XORO HMT 350.

Das Bild zeigt die Standard Fernbedienung des XORO HMT 350.

Listenlive

2013-07-06T17:31:50Z

Ritchie: /* Listenlive.nl Firmware */ Schnittstellenparameter eingeführt & Firmwarebeschreibung erweitert.

= Hardware =
Die Firmware von Listenliste arbeitet derzeit (Stand 06.2013) mit der folgenden Hardware für die unter aufgeführten Produkte zusammen.
== Penbex Hardware ==
DMTech, Watson, ctiradio, Joybien, eradio, KW-1004, HipShing, Goodmans, Proline, Neon, Clas Ohlson, 
Orchard, Yusan, Zylux, Logik, Sabre, MPMan, Uptoday, LA302, Olympia, Centrios, Amitech, Odys, 
Forworld2, Boom, VEGA, Pbirkit, IRM8001, Lafayette, DNT IPMicro, Akira, SL-D960, GP-60X, PBXBoom2-SI, 
Pbirkit2, Konig HAV-20/21/22 
== SkyTC Hardware ==
Mediabox 135, Arnova WebRadio & TV, [http://www.fhemwiki.de/wiki/xorohmt350 XORO-HMT350] XORO HMT370, 
LinePro, Pearl Auvisio IPTV2335 (PX-8595), Wiwa eRTV208, Otek IPTV510, Envivo PO1119 PO1171 PO1235, 
Disgo TVGo, Vista Quest, Xenta KMP510, Foxman, Apex, Cayenne, Roxcore, Aigo, Lookeetv 

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für Webradios der Serie (PenPex und SkytV) eine alternative Firmware. Die derzeit Version 1.49 (Stand 06.2013) 
wurde von ListenLive um eine TCP/IP Schnittstelle für die Steuerung des Radios erweitert. 
Hierbei erfolgt die Datenübertragung der Kommandos über eine TCP/IP Socket. 
Die gesendeten Befehle werden jeweils mit dem Text "OK" beantwortet. 
Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet. 
== Schnittstellenparameter ==
Die folgenden Parameter sind für die Kommunikation mit dem Radio sehr wichtig. 
Die IP Adresse des Radios sollte eine feste IP Adresse haben. Dies kann man z.B. bei einer Fritzbox so lösen, 
das man in den Netzwerkeinstellung für dieses Geräte die Einstellung. 
Diesem Gerät immer die gleiche IP Adresse vergeben. Die korrekte Erkennung des Radios erfolgt hierbei mit der Mac-Adresse. 
* IP Adresse des Radios (z.B. 192.168.1.33)
* Port 8080
== Der Code ==
'''Für fhem.cfg'''

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

'''Für die myUtils:'''

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.0.55', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Listenlive

2013-07-06T17:15:05Z

Ritchie: /* Hardware */ Produktbasis erweitert.

Xoro HMT 350

2013-07-06T14:09:41Z

Ritchie: /* Technische Daten */ Neue Sektion "Software Fehler" eingefügt

== Webradio mit ListenLive Firmware ==
[[Datei:XORO350.JPG]]

Diese Radio kann nach dem einspielen der Firmware von ListenLive mittels eines TCP/IP Socket über FHEM gesteuert werden.

== Kosten ==
Das Radio kostet im Internet ca. 100 Euro. Bei Pearl kann man es hin und wieder als B Ware für um die 60€ kaufen.

== Nachfolgemodell ==
Es gibt bereits ein Nachfolgemodell (HMT 370) dieses Radios, welches ein größeres Display hat. Verschiedene Kritiken im Internet zeigten unterschiedliche Meinungen, hier sollte jeder sein eigene Endscheidung treffen. Fakt ist jedoch der höhere Stromverbrauch des XORO 370 bedingt durch das größere Display (7 Zoll), was der klare Vorteil des XORO 350 ist.

== Technische Daten ==
'''Stromverbrauch'''
* Display komplett dunkel 1,8 Watt
* Display Normal im Menue 2,3 Watt
* Internet-Radiobetrieb 2,9 Watt
'''Display Größe'''
3.5 Zoll
'''Fernbedienung'''
IR Fernbedienung
'''Anschlüsse'''
* FM Antenne
* Stereo Eingang (Line In)
* Kartenleser für SD Karten
* Strom Mini USB

== Softwarefehler in der Originalsoftware ==
Laut ListenLive befindet sich in der Originalfirmware des XORO 350, welche er mit "[http://de.wikipedia.org/wiki/Reverse_Engineering reverse engineering]" analysiert hat und dann in seine eigene Version umgeändert hat, ein Programmteil, welche nach einem Zufallsverfahren das eingebaute FLASH mit übermässigen Schreibbefehlen kapputt schreibt. Hierdurch soll es zu einem vorzeitigen Geräteausfall kommen. Dieser "Fehler" wird durch dem Austausch der Firmware beseitigt.

Xoro HMT 350

2013-07-06T13:59:46Z

Ritchie: /* Nachfolgemodell */ Satzstellung und Hinweis erweitert

Listenlive

2013-07-05T21:15:46Z

Ritchie: /* Listenlive.nl Firmware */

= Hardware =
Die Firmware unter anderm auf diesen Geräten
[http://www.fhemwiki.de/wiki/xorohmt350 XORO-HMT350]
= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
<nowiki>#
#Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Datei:XORO350.JPG

2013-07-05T21:02:55Z

Ritchie:

Ein Foto des Hauptmenues des Webradios XORO HMT 350 mit der Firmware von ListenLive

Datei:XORO350.JPG

2013-07-05T21:02:17Z

Ritchie: Ein Foto des Hauptmenues des Webradios XORO 350 mit der Firmware von ListenLive

Ein Foto des Hauptmenues des Webradios XORO 350 mit der Firmware von ListenLive

Listenlive

2013-07-05T15:46:14Z

Ritchie: /* Probleme */

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
# 
# Power on with the first radio sender 
# 
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.
* Generell hilft hier derzeit nur das ausprobieren mit der IR-Fernbedienung und die entsprechenden Kommandos dann an das Radio zu senden
* Die Firmware wird derzeit nur von einer Person gewartet, welcher aber sehr aktiv an dem Projekt arbeitet.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Listenlive

2013-07-05T15:41:27Z

Ritchie: /* Links */ Examples eingefügt

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
# 
# Power on with the first radio sender 
# 
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]
[[Kategorie:Examples]]

Listenlive

2013-07-05T15:39:29Z

Ritchie: /* Beispiel für das Einschalten des Radio mit dem ersten Favoriten */

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
# 
# Power on with the first radio sender 
# 
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]

Listenlive

2013-07-05T15:38:20Z

Ritchie: /* Probleme */

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Beispiel für das Einschalten des Radio mit dem ersten Favoriten ==
#
# Power on with the first radio sender
#
sub SwitchRadioOn
{
radio("POWER");
radio("HOME");
radio("OK");
radio("OK");
radio("OK");
return;
}
== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]

Listenlive

2013-07-05T15:34:09Z

Ritchie: /* Der Code */ Update des Programmcodes noch eingefügt

= Listenlive.nl Firmware =
Auf der Seite listenlive.nl gibt es für viele Webradios eine alternative Firmware, derzeit in Version 1.49.

Die Kommunikation erfolgt über socks.

Im wesentlichen kann man darüber die Befehle senden, die auch die IR-Fernbedienung sendet.

== Der Code ==

Die IP Adresse des Radios müsst ihr ändern, der Rest ist ok, so wie es ist :)

Für fhem.cfg

<nowiki>### WebRadio
define WebRadio dummy
attr WebRadio room Wohnzimmer
attr WebRadio setList UP LEFT DOWN RIGHT EXIT POWER OK VOLp VOLm STOP REPEAT PGUP PGDN RECORD HOME MENU MUTE FORWARD REWIND FMRADIO IRADIO ITV PAUSE CLOCK
attr WebRadio webCmd UP:LEFT:DOWN:RIGHT:EXIT:POWER:OK:VOLp:VOLm:STOP:REPEAT:PGUP:PGDN:RECORD:HOME:MENU:MUTE:FORWARD:REWIND:FMRADIO:IRADIO:ITV:PAUSE:CLOCK
define myWebRadio notify WebRadio {radio($EVENT)};;</nowiki>

Für die myUtils:

<nowiki>use strict;
use warnings;
use POSIX;
use CGI qw(:standard);
use IO::Socket;
use IO::Socket::INET;
use MIME::Base64;
use Time::HiRes qw(usleep nanosleep);

#
# Listenlive Radio
#
sub radio($)
{
my ($socket,$client_socket);
my $response ="";

#
# Create a socket object for the communication with the radio
#
$socket = new IO::Socket::INET (
PeerHost => '192.168.5.56', ########## <- hier eure IP Adresse eingeben
PeerPort => '8080',
Proto => 'tcp',
) or die "ERROR in Socket Creation : $!\n";

#
# Send the given command into the socket
#
$socket->send(@_);
#
# get the radio some time to execute the command (300ms )
#
usleep(30000); ###### <- erhöhen, wenn das Radio Kommandos verschluckt

#
# get the answer of the radio
#
$socket->recv($response, 2);

if($response !~ m/OK/)
{
Log 1, "Error from radio ! Response from Radio : $response" ;
}

$socket->close();
return;
}</nowiki>

== Probleme ==
* Das Timing ist nicht perfekt, manchmal verschluckt das Radio Befehle. Hochsetzen von usleep kann helfen.
* Viel problematischer ist, dass wir eigentlich keine echte Rückmeldung bekommen, was das Radio grade tut. Somit ist es nicht möglich, von einem beliebigen Zustand aus mit FHEM loszulegen.

== Wie es weitergeht ==
Eine Möglichkeit besteht darin, abzuwarten was William in der 1.5er Firmware ändert
Andererseits läuft eine BusyBox auf dem Radio und der Telnet Zugang ist aktiviert.

== Links ==

* [http://forum.fhem.de/index.php?t=msg&th=12571&start=0&rid=1421 Forumthread]
* [http://listenlive.nl/ Homepage von Listenlive.nl]

[[Kategorie:Unterhaltungselektronik]]