CUL
--
-
-
- reopen
- Reopens the connection to the device and reinitializes it. - - raw
- Issue a CUL firmware command. See the this document - for details on CUL commands. - - freq / bWidth / rAmpl / sens
- SlowRF mode only.
- Set the CUL frequency / bandwidth / receiver-amplitude / sensitivity
- - Use it with care, it may destroy your hardware and it even may be - illegal to do so. Note: The parameters used for RFR transmission are - not affected.
--
-
- freq sets both the reception and transmission frequency. Note: - Although the CC1101 can be set to frequencies between 315 and 915 - MHz, the antenna interface and the antenna of the CUL is tuned for - exactly one frequency. Default is 868.3 MHz (or 433 MHz) -
- bWidth can be set to values between 58 kHz and 812 kHz. Large values - are susceptible to interference, but make possible to receive - inaccurately calibrated transmitters. It affects tranmission too. - Default is 325 kHz. -
- rAmpl is receiver amplification, with values between 24 and 42 dB. - Bigger values allow reception of weak signals. Default is 42. - -
- sens is the decision boundary between the on and off values, and it - is 4, 8, 12 or 16 dB. Smaller values allow reception of less clear - signals. Default is 4 dB. -
- hmPairForSec
- HomeMatic mode only.
- Set the CUL in Pairing-Mode for the given seconds. Any HM device set into - pairing mode in this time will be paired with FHEM. - - hmPairSerial
- HomeMatic mode only.
- Try to pair with the given device. The argument is a 10 character - string, usually starting with letters and ending with digits, printed on - the backside of the device. It is not necessary to put the given device - in learning mode if it is a receiver. - - led
- Set the CUL led off (00), on (01) or blinking (02). - - ITClock - Set the IT clock for Intertechno V1 protocol. Default 250. -
- version
- returns the CUL firmware version - - uptime
- returns the CUL uptime (time since CUL reset) - - raw
- Issues a CUL firmware command, and waits for one line of data returned by - the CUL. See the CUL firmware README document for details on CUL - commands. - - fhtbuf
- CUL has a message buffer for the FHT. If the buffer is full, then newly - issued commands will be dropped, and an "EOB" message is issued to the - FHEM log. -fhtbufreturns the free memory in this buffer (in hex), - an empty buffer in the CUL V2 is 74 bytes, in CUL V3/CUN(O) 200 Bytes. - A message occupies 3 + 2x(number of FHT commands) bytes, - this is the second reason why sending multiple FHT commands with one - set is a good idea. The first reason is, that - these FHT commands are sent at once to the FHT. - - ccconf
- Read some CUL radio-chip (cc1101) registers (frequency, bandwidth, etc.), - and display them in human readable form. - - cmds
- Depending on the firmware installed, CULs have a different set of - possible commands. Please refer to the README of the firmware of your - CUL to interpret the response of this command. See also the raw command. - - credit10ms
- One may send for a duration of credit10ms*10 ms before the send limit - is reached and a LOVF is generated. - - addvaltrigger
- Create triggers for additional device values. Right now these are RSSI - and RAWMSG for the CUL family and RAWMSG for the FHZ. - - connectCommand
- raw culfw command sent to the CUL after a (re-)connect of the USB device, - and sending the usual initialization needed for the configured rfmode. -
-
- - do_not_notify -
- dummy -
- hmId
- Set the HomeMatic ID of this device. If this attribute is absent, the - ID will be F1<FHTID>. Note 1: After setting or changing this - attribute you have to relearn all your HomeMatic devices. Note 2: The - value must be a 6 digit hex number, and 000000 is not valid. FHEM - won't complain if it is not correct, but the communication won't work. - - hmProtocolEvents
- Generate events for HomeMatic protocol messages. These are normally - used for debugging, by activating "inform timer" in a telnet session, - or looking at the Event Monitor window in the FHEMWEB frontend.
- Example: --
-
- 2012-05-17 09:44:22.515 CUL CULHM RCV L:0B N:81 CMD:A258 SRC:...... - DST:...... 0000 (TYPE=88,WAKEMEUP,BIDI,RPTEN) -- - longids
- Comma separated list of device-types for CUL that should be handled - using long IDs. This additional ID allows it to differentiate some - weather sensors, if they are sending on the same channel. - Therefore a random generated id is added. If you choose to use longids, - then you'll have to define a different device after battery change. - Default is not to use long IDs.
- Modules which are using this functionality are for e.g. : - 14_Hideki, 41_OREGON, 14_CUL_TCM97001, 14_SD_WS07.
- - Examples:
-- # Do not use any long IDs for any devices (this is default):
- attr cul longids 0
- # Use long IDs for all devices:
- attr cul longids 1
- # Use longids for SD_WS07 devices.
- # Will generate devices names like SD_WS07_TH_3 for channel 3.
- attr cul longids SD_WS07 - - model (CUL,CUN,etc) -
- sendpool
- If using more than one CUL for covering a large area, sending - different events by the different CUL's might disturb each other. This - phenomenon is also known as the Palm-Beach-Resort effect. - Putting them in a common sendpool will serialize sending the events. - E.g. if you have three CUN's, you have to specify following - attributes:
-attr CUN1 sendpool CUN1,CUN2,CUN3
- attr CUN2 sendpool CUN1,CUN2,CUN3
- attr CUN3 sendpool CUN1,CUN2,CUN3
- - rfmode
- Configure the RF Transceiver of the CUL (the CC1101). Available - arguments are: --
-
- SlowRF
- To communicate with FS20/FHT/HMS/EM1010/S300/Hoermann devices @1 kHz - datarate. This is the default.
-
- - HomeMatic
- To communicate with HomeMatic type of devices @10 kHz datarate.
-
- - MAX
- To communicate with MAX! type of devices @10 kHz datarate.
-
- - WMBus_S -
- WMBus_T
- To communicate with Wireless M-Bus devices like water, gas or - electrical meters. Wireless M-Bus uses two different communication - modes, S-Mode and T-Mode. While in this mode, no reception of other - protocols like SlowRF or HomeMatic is possible. See also the WMBUS - FHEM Module. -
-
- SlowRF
- showtime - - -
- readingFnAttributes -
|
- The CUL/CUN(O) is a family of RF devices sold by busware.de.
-
- With the opensource firmware
- culfw they are capable
- to receive and send different 433/868 MHz protocols (FS20/FHT/S300/EM/HMS/MAX!).
- It is even possible to use these devices as range extenders/routers, see the
- CUL_RFR module for details.
- - - Some protocols (FS20, FHT and KS300) are converted by this module so that - the same logical device can be used, irrespective if the radio telegram is - received by a CUL or an FHZ device. - Other protocols (S300/EM) need their - own modules. E.g. S300 devices are processed by the CUL_WS module if the - signals are received by the CUL, similarly EMWZ/EMGZ/EMEM is handled by the - CUL_EM module. - - It is possible to attach more than one device in order to get better - reception, FHEM will filter out duplicate messages. - - Note: This module may require the Device::SerialPort or
- Win32::SerialPort module if you attach the device via USB
- and the OS sets strange default parameters for serial devices.- - |
- 
- |
-
-
define <name> CUL <device> <FHTID> -
- USB-connected devices (CUL/CUN):
-
- <device> specifies the serial port to communicate with the CUL.
- The name of the serial-device depends on your distribution, under
- linux the cdc_acm kernel module is responsible, and usually a
- /dev/ttyACM0 device will be created. If your distribution does not have a
- cdc_acm module, you can force usbserial to handle the CUL by the
- following command:
-
- modprobe usbserial vendor=0x03eb product=0x204b
- - - You can also specify a baudrate if the device name contains the @ - character, e.g.: /dev/ttyACM0@38400
- - If the baudrate is "directio" (e.g.: /dev/ttyACM0@directio), then the - perl module
Device::SerialPort is not needed, and FHEM
- opens the device with simple file io. This might work if the operating
- system uses sane defaults for the serial parameters, e.g. some Linux
- distributions and OSX.- -
-
- <device> specifies the host:port of the device, e.g.
- 192.168.0.244:2323
-
- If the device is called none, then no device will be opened, so you - can experiment without hardware attached.
- - The FHTID is a 4 digit hex number, and it is used when the CUL talks to - FHT devices or when CUL requests data. Set it to 0000 to avoid answering - any FHT80b request by the CUL. -
- - - Set -
-
-
-
- -
- -
- -
- -
-
-
-
-
-
-
-
- -
- -
-
-
-
-
- -
- -
- -
- -
-
-
-
CUL
--
-
-
- reopen
- Öffnet die Verbindung zum Gerät neu und initialisiert es. - - raw
- Sendet einen CUL Firmware Befehl. Siehe auch - hier für - nähere Erläuterungen der CUL Befehle. - - freq / bWidth / rAmpl / sens
- Nur in der Betriebsart SlowRF.
Bestimmt die - CUL Frequenz / Bandbreite / Empfänger Amplitude / - Empfindlichkeit
- - Bitte mit Vorsicht verwenden, da es die verwendete Hardware - zerstören kann bzw. es zu illegalen Funkzuständen kommen - kann.
Bemerkung: Die Parameter für die RFR Übermittlung - werden hierdurch nicht beeinflußt.
--
-
- freq bestimmt sowohl die Empfangs- als auch die Sendefrequenz.
- Bemerkung: Auch wenn der CC1101 zwischen den Frequenzen 315 und 915 - MHz eingestellt werden kann, ist die Antennenanbindung bzw. die - Antenne des CUL exakt auf eine Frequenz eingestellt. Standard ist - 868.3 MHz (bzw. 433 MHz).
-
- - bWidth kann zwischen 58 kHz und 812 kHz variiert werden. - Große Werte sind empfindlicher gegen Interferencen, aber - machen es möglich, nicht genau kalbrierte Signale zu - empfangen. Die Einstellung beeinflusst ebenso die Übertragung. - Standardwert ist 325 kHz. - -
- rAmpl ist die Verstärkung des Empfängers mit Werten - zwischen 24 and 42 dB. Größere Werte erlauben den - Empfang von schwachen Signalen. Standardwert ist 42. - -
- sens ist die Entscheidungsgrenze zwischen "on" und "off" - Zuständen und kann 4, 8, 12 oder 16 dB sein. Kleinere Werte - erlauben den Empfang von undeutlicheren Signalen. Standard ist 4 - dB. -
- freq bestimmt sowohl die Empfangs- als auch die Sendefrequenz.
- hmPairForSec
- Nur in der Betriebsart HomeMatic.
Versetzt den - CUL für die angegebene Zeit in Sekunden in den Anlern-Modus. Jedes - HM Gerät, das sich im Anlern-Modus befindet, wird an FHEM - angelernt. - hmPairSerial
- Nur in der Betriebsart HomeMatic.
- Versucht, das angegebene Gerät anzulernen (zu "pairen"). Der - Parameter ist eine 10-stellige Zeichenfolge, die normalerweise mit - Buchstaben beginnt und mit Ziffern endet; diese sind auf der - Rückseite der Geräte aufgedruckt. Wenn das Gerät ein - Empfänger ist, ist es nicht notwendig, das angegebene Gerät in - den Anlern-Modus zu versetzen. - led
- Schaltet die LED des CUL: aus (00), an (01) oder blinkend (02). - - ITClock - Setzt die IT clock fü Intertechno V1 Protokoll. Default 250. -
- version
- gibt die Version der CUL Firmware zurück - - uptime
- gibt die Betriebszeit des CULs zurück (Zeit seit dem letzten Reset - des CULs) - raw
- Sendet einen CUL Firmware Befehl und wartet auf eine Rückgabe des - CULs. Siehe auch README der Firmware für nähere - Erläuterungen zu den CUL Befehlen. - fhtbuf
- Der CUL hat einen Puffer für Nachrichten für FHT. Wenn der - Puffer voll ist, werden neu empfangene Telegramme ignoriert und eine - "EOB" Meldung wird in die FHEM Logdatei geschrieben. - -fhtbufgibt den freien Speicher dieses Puffers (in hex) - zurück, ein leerer Puffer im CUL V2 hat 74 Byte, im CUL V3/CUN(O) - hat 200 Byte. Eine Telegramm benötigt 3 + 2x(Anzahl der FHT - Befehle) Byte, dies ist ein Grund, warum man mehrere FHT Befehle mit - einem set senden sollte. Ein weiterer Grund ist, - dass diese FHT Befehle in einem "Paket" zum FHT Gerät gesendet werden. - - ccconf
- Liest einige CUL Register des CC1101 (Sende- und Empfängerchips) - aus (Frequenz, Bandbreite, etc.) und stellt diese in lesbarer Form dar. - - cmds
- In abhägigkeit der installierten Firmware hat der CUL/CUN(O) - unterschiedliche Befehlssätze. Nähere Informationen über - die Befehle bzw. deren Interpretation siehe README Datei der - verwendeten CUL Firmware. Siehe auch Anmerkungen beim raw Befehl. - - credit10ms
- Der Funkraum darf für eine Dauer von credit10ms*10 ms belegt - werden, bevor die gesetzliche 1% Grenze erreicht ist und eine - LOVF Meldung ausgegeben wird. - addvaltrigger
- Generiert Trigger für zusätzliche Werte. Momentan sind dies - RSSI und RAWMSG für die CUL Familie und RAWMSG für FHZ. - - connectCommand
- culfw Befehl, was nach dem Verbindungsaufbau mit dem USB-Gerät, nach - Senden der zum Initialisieren der konfigurierten rfmode benötigten - Befehle gesendet wird. -
-
- - do_not_notify -
- dummy - -
- hmId
- Setzt die HomeMatic ID des Gerätes. Wenn dieses Attribut fehlt, - wird die ID zu F1<FHTID> gesetzt. Bemerkung 1: Nach dem Setzen - bzw. Verändern dieses Attributes müssen alle HomeMatic - Geräte neu angelernt werden. Bemerkung 2: Der Wert muss - eine 6-stellige Hexadezimalzahl sein, 000000 ist ungültig. FHEM - überprüft nicht, ob die ID korrekt ist, im Zweifelsfall - funktioniert die Kommunikation nicht. - hmProtocolEvents
- Generiert Ereignisse für HomeMatic Telegramme. Diese werden - normalerweise für die Fehlersuche verwendet, z.B. durch Aktivieren - voninform timerin einer telnet Sitzung bzw. im -Event MonitorFenster im FHEMWEB Frontend.
- Beispiel: --
-
- 2012-05-17 09:44:22.515 CUL CULHM RCV L:0B N:81 CMD:A258 SRC:...... - DST:...... 0000 (TYPE=88,WAKEMEUP,BIDI,RPTEN) -- - longids
- Durch Kommata getrennte Liste von Device-Typen für Empfang von - langen IDs mit den CUL. Diese zusätzliche ID erlaubt es - Wettersensoren, welche auf dem gleichen Kanal senden zu unterscheiden. - Hierzu wird eine zufällig generierte ID hinzugefügt. Wenn Sie - longids verwenden, dann wird in den meisten Fällen nach einem - Batteriewechsel ein neuer Sensor angelegt. - Standardmäßig werden keine langen IDs verwendet.
- Folgende Module verwenden diese Funktionalität: - 14_Hideki, 41_OREGON, 14_CUL_TCM97001, 14_SD_WS07.
- Beispiele: -- # Keine langen IDs verwenden (Default Einstellung):
- attr cul longids 0
- # Immer lange IDs verwenden:
- attr cul longids 1
- # Verwende lange IDs für SD_WS07 Devices.
- # Device Namen sehen z.B. so aus: SD_WS07_TH_3 for channel 3.
- attr cul longids SD_WS07 - - model (CUL,CUN)
- rfmode
- Konfiguriert den RF Transceiver des CULs (CC1101). Verfügbare - Argumente sind: --
-
- SlowRF
- Für die Kommunikation mit FS20/FHT/HMS/EM1010/S300/Hoermann - Geräten @1 kHz Datenrate (Standardeinstellung).
-
- - HomeMatic
- Für die Kommunikation mit HomeMatic Geräten @10 kHz - Datenrate.
-
- - MAX
- Für die Kommunikation mit MAX! Geräten @10 kHz - Datenrate.
- - WMBus_S -
- WMBus_T
- Für die Kommunikation mit Wireless M-Bus Geräten wie - Wasser-, Gas- oder Elektrozählern. Wireless M-Bus verwendet - zwei unterschiedliche Kommunikationsarten, S-Mode und T-Mode. In - diesem Modus ist der Empfang von anderen Protokollen wie SlowRF - oder HomeMatic nicht möglich.
-
- SlowRF
- sendpool
- Wenn mehr als ein CUL verwendet wird, um einen größeren - Bereich abzudecken, können diese sich gegenseitig - beeinflussen. Dieses Phänomen wird auch Palm-Beach-Resort Effekt - genannt. Wenn man diese zu einen gemeinsamen Sende"pool" - zusammenschließt, wird das Senden der einzelnen Telegramme - seriell (d.h. hintereinander) durchgeführt. - Wenn z.B. drei CUN's zur - Verfügung stehen, werden folgende Attribute gesetzt:
-attr CUN1 sendpool CUN1,CUN2,CUN3
- attr CUN2 sendpool CUN1,CUN2,CUN3
- attr CUN3 sendpool CUN1,CUN2,CUN3
- - showtime -
- readingFnAttributes -
|
- Der CUL/CUN(O) ist eine Familie von Funkempfängern, die von der Firma
- Busware verkauft wird.
-
- Mit der OpenSource Firmware
- culfw können sie verschiedene
- 868 MHz Funkprotokolle empfangen bzw. senden (FS20/FHT/S300/EM/HMS/MAX!).
- Man kann diese Geräte auch zur Reichweitenverlängerung, siehe
- CUL_RFR einsetzen.
- - - Einige Protokolle (FS20, FHT und KS300) werden von diesem Modul in das FHZ - Format konvertiert, daher kann dasselbe logische Gerät verwendet werden, - egal ob das Funktelegramm von einem CUL oder einem FHZ Gerät empfangen - wird. - - Andere Protokolle (S300/EM) benötigen ihre eigenen Module. S300 - Geräte werden vom Modul CUL_WS verarbeitet, wenn das Signal von einem - CUL empfangen wurde, ähnliches gilt für EMWZ/EMGZ/EMEM: diese - werden vom CUL_EM Modul verarbeitet. - - Es ist möglich mehr als ein Gerät zu verwenden, um einen besseren - Empfang zu erhalten, FHEM filtert doppelte Funktelegramme aus. - - Bemerkung: Dieses Modul benötigt unter Umständen das - Device::SerialPort bzw. Win32::SerialPort Modul,
- wenn Sie das Gerät über USB anschließen und das
- Betriebssystem unübliche Parameter für serielle Schnittstellen
- setzt.- - |
-
- |
-
-
define <name> CUL <device> <FHTID> -
- Geräte, die an USB angeschlossen sind (CUL/CUN):
-
-
- <device> gibt die serielle Schnittstelle an, mit der der CUL
- kommuniziert. Der Name der seriellen Schnittstelle hängt von der
- gewählten Distribution und USB-Treiber ab, unter Linux ist dies das
- Kernel Modul cdc_acm und üblicherweise wird die Schnittstelle
- /dev/ttyACM0 genannt. Wenn die Linux Distribution über kein Kernel
- Modul cdc_acm verfügt, dann kann die Schnittstelle über
- usbserial mit dem folgenden Befehl erzeugt werden:
-
- modprobe usbserial vendor=0x03eb product=0x204b
- - - Wenn der Name der Schnittstelle ein @ enthält, kann nachfolgend die - verwendete Baudrate angegeben werden, z.B.: /dev/ttyACM0@38400.
- - Wenn die Baudrate mit "directio" angegeben wird (z.B.: - /dev/ttyACM0@directio), wird das Perl Modul -
Device::SerialPort nicht benötigt und FHEM öffnet
- die Schnittstelle mit einfachem Dateizugriff. Dies sollte dann
- funktionieren, wenn das Betriebssystem vernünftige Standardwerte
- für die serielle Schnittstelle verwendet, wie z.B. einige Linux
- Distributionen oder OSX.-
-
-
- <device> gibt die Hostadresse:Port des Gerätes an, z.B.
- 192.168.0.244:2323
-
- - Wenn das Gerät mit none bezeichnet wird, wird keine Schnittstelle - geöffnet und man kann ohne angeschlossene Hardware - experimentieren.
- - Die FHTID ist eine 4-stellige hexadezimale Zahl und wird verwendet, wenn - der CUL FHT Telegramme sendet bzw. Daten anfragt. Diese sollte als 0000 - gewählt werden, wenn man FHT80b Anfragen durch den CUL vermeiden will. -
- - - Set -
-
-
-
- -
- -
- - -
- - -
-
-
-
-
-
- -
- -
- -
- -
- -
-
-
- -
- -
- -
- -
- -
- -
- -
-
Betty
--
- Todo
-