EnOcean Equipment Profiles (EEP): Comprendere le famiglie di 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.
Struttura EEP: RORG-FUNC-TYPE
Ogni codice EEP è composto da tre byte espressi in esadecimale e scritti come tripletta separata da trattini. Ogni byte ha un significato distinto:
Struttura dei byte 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)L'EEP non viene trasmesso nei normali telegrammi dati. Il byte RORG è incorporato nell'intestazione del telegramma (è l'identificatore del tipo di telegramma), ma FUNC e TYPE non vengono inviati nei telegrammi dati regolari. Vengono trasmessi solo durante la sequenza di apprendimento. Questo è il motivo per cui i gateway richiedono che l'EEP sia configurato manualmente — o catturato durante l'apprendimento — per ogni canale del sensore.
Panoramica delle famiglie RORG
Il byte RORG determina la struttura del telegramma. La maggior parte dei sensori per l'automazione degli edifici utilizza 4BS (0xA5) per misurazioni multi-valore e RPS (0xF6) per interruttori a bilanciere. VLD (0xD2) viene utilizzato per attuatori e dispositivi con comunicazione bidirezionale.
| RORG | Hex | Payload | Uso tipico |
|---|---|---|---|
| 1BS (sensore a 1 byte) | 0xD5 | 1 byte (8 bit) | Contatto porta/finestra, sensore binario semplice |
| 4BS (sensore a 4 byte) | 0xA5 | 4 byte (32 bit) | Temperatura, umidità, presenza, illuminamento, contatore energia |
| RPS (Repeated Switch) | 0xF6 | 1 byte (8 bit) | Interruttore a bilanciere, pulsante, posizione maniglia finestra |
| VLD (Variable Length Data) | 0xD2 | 1–14 byte | Attuatori, dispositivi bidirezionali, valvole HVAC |
| MSC (Specifico del produttore) | 0xD1 | Variabile | Punti dati proprietari, richiede decoder del produttore |
| ADT (Indirizzamento di destinazione) | 0xA6 | Variabile | Telegrammi indirizzati punto-punto (bidirezionali) |
EEP chiave per l'automazione degli edifici
I profili seguenti coprono la maggior parte dei sensori EnOcean utilizzati nell'automazione degli edifici commerciali. Verificare il byte TYPE esatto sull'etichetta del sensore fisico – l'intervallo di temperatura e la risoluzione di misura variano tra le varianti TYPE.
| EEP | Descrizione | Punti dati chiave | KNX DPT |
|---|---|---|---|
| F6-02-01 | Pulsante a 2 leve (4 azioni) | AI/BI su/giù premuto/rilasciato | DPT 1.001, 1.008 |
| D5-00-01 | Contatto singolo, porta/finestra | Contatto aperto (1) / chiuso (0) | DPT 1.009 |
| A5-02-05 | Sensore di temperatura 0–40°C | Temperatura (8 bit, ris. 0,16°C) | DPT 9.001 |
| A5-04-01 | Temp (0–40°C) + umidità (0–100%) | DB2=temp, DB1=umidità, DB0=bit LRN | DPT 9.001, 9.007 |
| A5-07-01 | Sensore di presenza (PIR, 3 assi) | Bit di presenza + tensione di alimentazione | DPT 1.001 |
| A5-06-01 | Illuminamento (300–30000 lux) | DB3=range lux, DB2=alimentazione, DB1=valore lux | DPT 9.004 |
| A5-12-01 | Lettura automatica dei contatori (impulsi) | DB3–DB1=contatore impulsi a 24 bit, DB0=divisore | DPT 12.001 |
| A5-09-04 | Concentrazione di CO₂ (0–2550 ppm) | DB3=CO₂, DB2=umidità, DB1=temperatura | DPT 9.008 |
Profili specifici del produttore: 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.
Identificazione del profilo 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 valuesPreferisci sensori EEP standard per nuove installazioni.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.
Strumenti di decodifica EEP
Diversi strumenti supportano l'acquisizione di telegrammi EnOcean e la decodifica EEP durante la messa in servizio, la risoluzione dei problemi e la validazione del sistema.
FT4 Analyzer (EnOcean)
- Download gratuito da EnOcean (Dolphin View)
- Funziona con ricevitore EnOcean USB 300
- Mostra hex grezzo del telegramma + valori EEP decodificati
- Misurazione RSSI per telegramma
- Assegnazione EEP per decodifica automatica
Wireshark + plugin EnOcean
- Dissettore del protocollo seriale EnOcean (ESP3)
- Cattura PCAP per la registrazione di tutti i telegrammi
- Utile per l'analisi della densità (quanti trasmettitori attivi)
- Esportazione in CSV per i registri di messa in servizio
- Filtra per ID trasmettitore o tipo RORG
EVCC / openHAB / Fhem
- Domotica open source con binding EnOcean
- Visualizzazione in tempo reale dei telegrammi sullo schermo
- EEP configurabile per ID trasmettitore
- Utile per la verifica dei sensori prima della messa in servizio
- Fhem: set enocean learningMode on/off
Decodificatore EEP per interruttori DIP
- Strumento online: enocean-tools.com
- Inserisci codice EEP → visualizza mappa bit completa del payload
- Inserisci telegramma hex grezzo → valori decodificati
- Utile per verificare le formule di scaling
- Copre tutti gli EEP pubblicati da EnOcean Alliance
Database EEP e riferimento
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.
Fonti di riferimento 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
Interoperabilità: la garanzia fondamentale dell'EEP
Il valore fondamentale del framework EEP è l'interoperabilità indipendente dal produttore. Qualsiasi ricevitore o gateway certificato EnOcean può decodificare qualsiasi sensore certificato EnOcean che utilizza un EEP standard pubblicato — indipendentemente dall'azienda che ha prodotto ciascun dispositivo. Questo è il vantaggio architettonico chiave rispetto ai protocolli RF proprietari in cui sensori e ricevitori devono provenire dallo stesso fornitore.
Cosa garantisce l'EEP
- Il layout dei bit del payload del telegramma è standardizzato
- La scalatura dei valori (min/max/risoluzione) è definita
- L'unità di misura è fissata dalla specifica
- Qualsiasi ricevitore certificato può decodificare qualsiasi trasmettitore certificato
- I gateway vengono aggiornati tramite firmware man mano che vengono pubblicati nuovi EEP
Cosa l'EEP non garantisce
- Intervallo di trasmissione (definito dal produttore)
- Durata dell'energy harvesting (specifica del dispositivo)
- Portata RF (il design dell'antenna varia a seconda del produttore)
- Livello di sicurezza (non tutti i sensori utilizzano AES-128)
- Denominazione dei sotto-punti dati (variazione estetica nelle interfacce)
Implicazione pratica: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.
Hai bisogno di sensori EnOcean specificati con codici EEP corretti per il tuo progetto?
Selezioniamo e verifichiamo gli EEP dei sensori EnOcean per ogni applicazione, configuriamo i canali del gateway con il corretto mapping DPT e forniamo quadri con documentazione EEP completa – incluse foto delle etichette dei sensori, ID trasmettitori e assegnazioni degli indirizzi di gruppo.
Richiedi un preventivo →