EnOcean Equipment Profiles (EEP): Zrozumienie rodzin profili A5, D5, F6
The EnOcean Equipment Profile (EEP) is a 3-byte identifier that defines the complete telegram format for an EnOcean device: what data bytes are transmitted, how they are encoded, and what physical quantity each byte represents. Any EnOcean receiver that knows a sender's EEP can decode every telegram from that device — regardless of which manufacturer produced it.
Struktura EEP: RORG-FUNC-TYPE
Każdy kod EEP składa się z trzech bajtów wyrażonych w systemie szesnastkowym i zapisanych jako triplet oddzielony myślnikami. Każdy bajt ma odrębne znaczenie:
Struktura bajtów EEP
EEP: A5 - 04 - 01
↑ ↑ ↑
RORG FUNC TYPE
RORG (Radio ORGanization, byte 1):
Defines telegram structure and payload length
0xA5 = 4BS (4 data bytes)
0xD5 = 1BS (1 data byte)
0xF6 = RPS (1 data byte, rocker/pushbutton)
0xD2 = VLD (variable length, up to 14 bytes)
0xD1 = MSC (manufacturer-specific, variable)
FUNC (Function, byte 2):
Sub-category within RORG family
A5-04 = Temperature and Humidity sensors
A5-07 = Occupancy sensors
A5-06 = Light, temperature and occupancy sensor
A5-12 = Automated meter reading
TYPE (Type, byte 3):
Specific variant within FUNC category
A5-04-01 = Range 0–40°C, 0–100%RH
A5-04-02 = Range -20–60°C, 0–100%RH
A5-04-03 = Range -20–60°C, 0–100%RH (extended)EEP nie jest przesyłany w normalnych telegramach danych. Bajt RORG jest osadzony w nagłówku telegramu (jest identyfikatorem typu telegramu), ale FUNC i TYPE nie są wysyłane w zwykłych telegramach danych. Są one przesyłane tylko podczas sekwencji uczenia. Dlatego bramy wymagają ręcznego skonfigurowania EEP – lub przechwycenia podczas uczenia – dla każdego kanału czujnika.
Przegląd rodzin RORG
Bajt RORG określa strukturę telegramu. Większość czujników automatyki budynkowej używa 4BS (0xA5) do pomiarów wielowartościowych oraz RPS (0xF6) do przełączników dźwigniowych. VLD (0xD2) jest używany dla aktuatorów i urządzeń z komunikacją dwukierunkową.
| RORG | Hex | Ładunek | Typowe zastosowanie |
|---|---|---|---|
| 1BS (czujnik 1-bajtowy) | 0xD5 | 1 bajt (8 bitów) | Styk drzwi/okna, prosty czujnik binarny |
| 4BS (czujnik 4-bajtowy) | 0xA5 | 4 bajty (32 bity) | Temperatura, wilgotność, obecność, natężenie oświetlenia, licznik energii |
| RPS (Repeated Switch) | 0xF6 | 1 bajt (8 bitów) | Przełącznik wahadłowy, przycisk, położenie klamki okiennej |
| VLD (Variable Length Data) | 0xD2 | 1–14 bajtów | Siłowniki, urządzenia dwukierunkowe, zawory HVAC |
| MSC (Producent-specyficzny) | 0xD1 | Zmienny | Proprietary punkty danych, wymaga dekodera producenta |
| ADT (Adresowanie docelowe) | 0xA6 | Zmienny | Adresowane telegramy punkt-punkt (dwukierunkowe) |
Kluczowe EEP dla automatyki budynkowej
Poniższe profile obejmują większość czujników EnOcean stosowanych w komercyjnej automatyce budynkowej. Sprawdź dokładny bajt TYPE z etykiety fizycznego czujnika – zakres temperatury i rozdzielczość pomiaru różnią się w zależności od wariantu TYPE.
| EEP | Opis | Kluczowe punkty danych | KNX DPT |
|---|---|---|---|
| F6-02-01 | Przycisk 2-klawiszowy (4 akcje) | AI/BI góra/dół wciśnięty/zwolniony | DPT 1.001, 1.008 |
| D5-00-01 | Pojedynczy styk, drzwi/okno | Styk otwarty (1) / zamknięty (0) | DPT 1.009 |
| A5-02-05 | Czujnik temperatury 0–40°C | Temperatura (8-bit, rozdz. 0,16°C) | DPT 9.001 |
| A5-04-01 | Temp (0–40°C) + wilgotność (0–100%) | DB2=temp, DB1=wilgotność, DB0=bit LRN | DPT 9.001, 9.007 |
| A5-07-01 | Czujnik obecności (PIR, 3-osiowy) | Bit obecności + napięcie zasilania | DPT 1.001 |
| A5-06-01 | Natężenie oświetlenia (300–30000 luksów) | DB3=zakres luksów, DB2=zasilanie, DB1=wartość luksów | DPT 9.004 |
| A5-12-01 | Automatyczny odczyt liczników (impulsowy) | DB3–DB1=24-bitowy licznik impulsów, DB0=dzielnik | DPT 12.001 |
| A5-09-04 | Stężenie CO₂ (0–2550 ppm) | DB3=CO₂, DB2=wilgotność, DB1=temperatura | DPT 9.008 |
Profile specyficzne dla producenta: MSC (0xD1)
The MSC RORG (0xD1) is reserved for manufacturer-specific datapoints that do not fit within the standardised EEP framework. The payload format is proprietary — only the manufacturer's SDK or decoder library can extract meaningful values from the telegram. MSC telegrams cannot be decoded by generic EnOcean gateways without a manufacturer-provided ETS6 plugin or firmware extension.
Identyfikacja profilu MSC
MSC telegram structure:
Byte 0: 0xD1 (RORG = MSC)
Byte 1: MID high byte (manufacturer ID, 11-bit)
Byte 2: MID low byte
Byte 3–n: Manufacturer-specific payload
Manufacturer IDs (examples):
0x002 = EnOcean GmbH
0x00D = Eltako
0x019 = Siemens
0x028 = Thermokon
Full list: EnOcean Alliance manufacturer registry
When MSC is encountered:
1. Read MID from bytes 1–2
2. Identify manufacturer from EnOcean Alliance registry
3. Obtain manufacturer decoder:
— ETS6 plugin (manufacturer download portal)
— SDK library for custom software integration
— Firmware update for gateway with MSC support
4. Do NOT configure gateway with standard EEP for MSC sensor
— Standard EEP will produce garbage decoded valuesPreferuj standardowe czujniki EEP w nowych instalacjach.MSC sensors create a dependency on a single manufacturer's toolchain. If the ETS6 plugin is discontinued or incompatible with a future ETS version, MSC sensors become undecodable. Standard EEP sensors (A5, D5, F6, D2) are decodable by any EnOcean gateway indefinitely.
Narzędzia do dekodowania EEP
Kilka narzędzi obsługuje przechwytywanie telegramów EnOcean i dekodowanie EEP podczas uruchamiania, rozwiązywania problemów i walidacji systemu.
FT4 Analyzer (EnOcean)
- Bezpłatne pobranie z EnOcean (Dolphin View)
- Działa z odbiornikiem EnOcean USB 300
- Wyświetla surowy hex telegramu + zdekodowane wartości EEP
- Pomiar RSSI na telegram
- Przypisanie EEP dla automatycznego dekodowania
Wireshark + wtyczka EnOcean
- Deskryptor protokołu EnOcean Serial Protocol (ESP3)
- Przechwytywanie PCAP do rejestrowania wszystkich telegramów
- Przydatne do analizy gęstości (ilu nadawców jest aktywnych)
- Eksport do CSV dla protokołów uruchomieniowych
- Filtruj według ID nadawcy lub typu RORG
EVCC / openHAB / Fhem
- Otwarta automatyka domowa z powiązaniem EnOcean
- Wyświetlanie telegramów w czasie rzeczywistym na ekranie
- Konfigurowalny EEP na ID nadawcy
- Przydatne do weryfikacji czujników przed uruchomieniem
- Fhem: set enocean learningMode on/off
Dekoder EEP przełączników DIP
- Narzędzie online: enocean-tools.com
- Wprowadź kod EEP → zobacz pełną mapę bitów ładunku
- Wprowadź surowy telegram hex → odczytane wartości
- Przydatne do weryfikacji formuł skalowania
- Obejmuje wszystkie EEP opublikowane przez EnOcean Alliance
Baza danych EEP i odniesienie
The complete EEP specification is maintained by the EnOcean Alliance and published as a free PDF document. New EEPs are added with each specification revision as new sensor types enter the market. Always download the latest version when working with sensors whose EEP is not in your gateway's firmware.
Źródła referencyjne EEP
Official EEP document: EnOcean Alliance EEP specification v3.1 (latest) URL: enocean-alliance.org/enocean-equipment-profiles/ Free registration required for download Published as PDF: ~300 pages, full bit-level specifications Online decoder tool: enocean-tools.com/en/eep-viewer Enter EEP code → interactive bit-field diagram Enter raw telegram hex → decoded value output ETS6 product database (for KNX gateways): Weinzierl: weinzierl.de/en/products (import .knxprod) MDT: mdt.de/ETS_Download.html EEP coverage varies by firmware version Check release notes for newly supported EEPs Community resources: openHAB EnOcean binding documentation Fhem EnoceanBinding wiki Home Assistant enocean integration
Interoperacyjność: podstawowa gwarancja EEP
Podstawową wartością struktury EEP jest niezależna od producenta interoperacyjność. Każdy certyfikowany przez EnOcean odbiornik lub brama może dekodować dowolny certyfikowany przez EnOcean czujnik korzystający ze standardowego opublikowanego EEP — niezależnie od tego, która firma wyprodukowała które urządzenie. Jest to kluczowa przewaga architektoniczna nad zastrzeżonymi protokołami RF, w których czujniki i odbiorniki muszą pochodzić od tego samego dostawcy.
Co gwarantuje EEP
- Układ bitów ładunku telegramu jest ustandaryzowany
- Skalowanie wartości (min/maks/rozdzielczość) jest zdefiniowane
- Jednostka miary jest ustalona przez specyfikację
- Każdy certyfikowany odbiornik może dekodować dowolnego certyfikowanego nadajnika
- Bramki aktualizowane przez oprogramowanie sprzętowe w miarę publikowania nowych EEP
Czego EEP nie gwarantuje
- Interwał transmisji (zdefiniowany przez producenta)
- Żywotność energy harvesting (zależna od urządzenia)
- Zasięg RF (konstrukcja anteny różni się w zależności od producenta)
- Poziom bezpieczeństwa (nie wszystkie czujniki używają AES-128)
- Nazewnictwo podpunktów danych (kosmetyczna zmiana w interfejsach)
Praktyczne implikacje:if a specific sensor model is discontinued, it can be replaced with any other manufacturer's sensor using the same EEP code without reconfiguring the gateway channel — only the sender ID needs updating. This makes EnOcean installations resilient to product lifecycle changes across a 20–30 year building automation system lifetime.
Potrzebujesz czujników EnOcean z odpowiednimi kodami EEP do swojego projektu?
Wybieramy i weryfikujemy EEP czujników EnOcean dla każdego zastosowania, konfigurujemy kanały bramy z poprawnym mapowaniem DPT i dostarczamy szafy sterownicze z pełną dokumentacją EEP – w tym zdjęcia etykiet czujników, identyfikatory nadajników i przypisania adresów grupowych.
Poproś o wycenę →