EnOcean Link  1.14.0.0
Middleware to Connect EnOcean easily to other Projects
eoApiDef.h
Go to the documentation of this file.
1 /******************************************************************************
2  DISCLAIMER
3 
4  THIS SOFTWARE PRODUCT ("SOFTWARE") IS PROPRIETARY TO ENOCEAN GMBH, OBERHACHING,
5  GERMANY (THE "OWNER") AND IS PROTECTED BY COPYRIGHT AND INTERNATIONAL TREATIES OR
6  PROTECTED AS TRADE SECRET OR AS OTHER INTELLECTUAL PROPERTY RIGHT. ALL RIGHTS, TITLE AND
7  INTEREST IN AND TO THE SOFTWARE, INCLUDING ANY COPYRIGHT, TRADE SECRET OR ANY OTHER
8  INTELLECTUAL PROPERTY EMBODIED IN THE SOFTWARE, AND ANY RIGHTS TO REPRODUCE,
9  DISTRIBUTE, MODIFY, DISPLAY OR OTHERWISE USE THE SOFTWARE SHALL EXCLUSIVELY VEST IN THE
10  OWNER. ANY UNAUTHORIZED REPRODUCTION, DISTRIBUTION, MODIFICATION, DISPLAY OR OTHER
11  USE OF THE SOFTWARE WITHOUT THE EXPLICIT PERMISSION OF OWNER IS PROHIBITED AND WILL
12  CONSTITUTE AN INFRINGEMENT OF THE OWNER'S RIGHT AND MAY BE SUBJECT TO CIVIL OR
13  CRIMINAL SANCTION.
14 
15  THIS SOFTWARE IS PROVIDED BY THE OWNER "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
16  INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
17  FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN PARTICULAR, THE OWNER DOES NOT WARRANT
18  THAT THE SOFTWARE SHALL BE ERROR FREE AND WORKS WITHOUT INTERRUPTION.
19 
20  IN NO EVENT SHALL THE OWNER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
21  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
22  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23  HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
24  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25  SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  ******************************************************************************/
27 
33 #ifndef API_DEF_H_
34 #define API_DEF_H_
35 
40 typedef enum
41 {
44  EO_OK = 0x00,
45  EO_ERROR = 0x01,
47  NOT_SUPPORTED = 0x02,
49  WRONG_PARAM = 0x03,
51  OPERATION_DENIED = 0x04,
53  LOCK_SET = 0x05,
55  BUFFER_TOO_SMALL = 0x06,
57  NO_FREE_BUFFER = 0x06,
59  TIME_OUT = 0x50,
62  NO_RX = 0x51,
64  ONGOING_RX = 0x52,
66  NEW_RX = 0x53,
68  BUFF_FULL = 0x54,
70  OUT_OF_RANGE = 0x55,
72  PORT_ERROR = 0x56,
74  USER_CMD = 0x57,
76  NOT_RECOM = 0x81,
82 } eoReturn;
83 
85 typedef enum
86 {
87  PACKET_RESERVED = 0x00,
88  PACKET_RADIO = 0x01,
89  PACKET_RESPONSE = 0x02,
91  PACKET_EVENT = 0x04,
99  PACKET_DEBUG = 0x0F
100 } PACKET_TYPE;
101 
103 typedef enum
104 {
159 
160 } CHOICE_TYPE;
162 typedef enum
163 {
165  RORG_RPS = 0xF6,
167  RORG_1BS = 0xD5,
169  RORG_4BS = 0xA5,
171  RORG_HRC = 0xA3,
173  RORG_SYS = 0xA4,
175  RORG_SYS_EX = 0xC5,
181  RORG_RECLAIM = 0xA7,
183  RORG_SIGNAL = 0xD0,
185  RORG_ADT = 0xA6,
187  GP_TI = 0xB0,
189  GP_TR = 0xB1,
191  GP_CD = 0xB2,
193  GP_SD = 0xB3,
195  RORG_VLD = 0xD2,
197  RORG_UTE = 0xD4,
199  RORG_MSC = 0xD1,
201  RORG_CDM = 0x40,
203  RORG_SEC = 0x30,
207  RORG_SECD = 0x32,
209  RORG_SEC_CDM = 0x33,
213  RORG_SEC_TI = 0x35
214 } RORG_TYPE;
215 
216 
218 #define BROADCAST_ID 0xFFFFFFFF
219 
220 #endif /* API_DEF_H_ */
0x02 - The functionality is not supported by that implementation
Definition: eoApiDef.h:48
Smart Ack command.
Definition: eoApiDef.h:94
RORG_TYPE
RORGS.
Definition: eoApiDef.h:162
Secure teach-in telegram.
Definition: eoApiDef.h:158
Teach-in request.
Definition: eoApiDef.h:187
Smart Ack Reclaim telegram.
Definition: eoApiDef.h:181
1BS telegram
Definition: eoApiDef.h:167
Reserved.
Definition: eoApiDef.h:88
Encapsulated addressable telegram.
Definition: eoApiDef.h:126
0x57 - User command
Definition: eoApiDef.h:75
Chained Data.
Definition: eoApiDef.h:144
Single Data.
Definition: eoApiDef.h:142
0x53 - A new byte or telegram received
Definition: eoApiDef.h:67
Chained Security telegram.
Definition: eoApiDef.h:209
0x05 - Lock set
Definition: eoApiDef.h:54
Smart Request telegram.
Definition: eoApiDef.h:183
Complete Data.
Definition: eoApiDef.h:191
0x56 - Error Opening Port
Definition: eoApiDef.h:73
SYS_EX telegram.
Definition: eoApiDef.h:116
0x90 Invalid Packet
Definition: eoApiDef.h:79
Single Teach-In Request.
Definition: eoApiDef.h:134
HRC telegram.
Definition: eoApiDef.h:171
Universal Teach In EEP based.
Definition: eoApiDef.h:197
0xFF - This function is not implemented
Definition: eoApiDef.h:81
Production command.
Definition: eoApiDef.h:96
0x54 - Buffer full, no space in Tx or Rx buffer
Definition: eoApiDef.h:69
Definition: eoApiDef.h:44
Remote management command.
Definition: eoApiDef.h:95
0x04 - Operation denied
Definition: eoApiDef.h:52
1BS telegram
Definition: eoApiDef.h:108
Smart Ack Learn Answer telegram.
Definition: eoApiDef.h:120
0x06 - Buffer too small
Definition: eoApiDef.h:56
Secure telegram without choice encapsulation.
Definition: eoApiDef.h:203
Secure telegram decrypted.
Definition: eoApiDef.h:207
4BS telegram
Definition: eoApiDef.h:110
0x52 - The UART receive is ongoing
Definition: eoApiDef.h:65
Universal Teach In EEP based.
Definition: eoApiDef.h:130
RPS telegram.
Definition: eoApiDef.h:165
SYS_EX telegram.
Definition: eoApiDef.h:175
SYS telegram.
Definition: eoApiDef.h:173
Maintenance security.
Definition: eoApiDef.h:156
RPS telegram.
Definition: eoApiDef.h:106
Encapsulated addressable telegram.
Definition: eoApiDef.h:185
HRC telegram.
Definition: eoApiDef.h:112
Chained data message.
Definition: eoApiDef.h:201
Secure telegram with choice encapsulation.
Definition: eoApiDef.h:205
set radio stuff&answear
Definition: eoApiDef.h:99
Manufacturer Specific Communication.
Definition: eoApiDef.h:199
Radio subtelegram (EnOcean internal function�)
Definition: eoApiDef.h:91
Smart Ack Learn Request telegram.
Definition: eoApiDef.h:177
eoReturn
contains all the return values from different functions
Definition: eoApiDef.h:40
0x81 Received message is not a recom message
Definition: eoApiDef.h:77
Variable Length Data.
Definition: eoApiDef.h:195
!Radio message (chained radio telegrams)
Definition: eoApiDef.h:97
4BS telegram
Definition: eoApiDef.h:169
0x03 - There was a wrong function parameter
Definition: eoApiDef.h:50
0x51 - No byte or telegram received
Definition: eoApiDef.h:63
Secure teach-in telegram.
Definition: eoApiDef.h:213
CHOICE_TYPE
Telegram choice codes applies to radio telegram only.
Definition: eoApiDef.h:103
Response to any packet.
Definition: eoApiDef.h:90
Manufacturer Specific Communication.
Definition: eoApiDef.h:132
Definition: eoApiDef.h:61
0x01 - Generic Error
Definition: eoApiDef.h:46
Chained Teach-In Request.
Definition: eoApiDef.h:136
Teach-in response.
Definition: eoApiDef.h:189
Event message.
Definition: eoApiDef.h:92
SYS telegram.
Definition: eoApiDef.h:114
Radio telegram.
Definition: eoApiDef.h:89
Selective data.
Definition: eoApiDef.h:146
Smart Ack Reclaim telegram.
Definition: eoApiDef.h:122
Maintenance security.
Definition: eoApiDef.h:211
PACKET_TYPE
Packet type (ESP3)
Definition: eoApiDef.h:85
0x55 - Generic out of range return code e.g. address is out of range or the buffer is too small ...
Definition: eoApiDef.h:71
Smart Ack Learn Answer telegram.
Definition: eoApiDef.h:179
Advanced protocol radio telegram.
Definition: eoApiDef.h:98
Variable Length Data.
Definition: eoApiDef.h:128
Common command.
Definition: eoApiDef.h:93
Single Teach-In Response.
Definition: eoApiDef.h:138
Secure telegram.
Definition: eoApiDef.h:148
Smart Request telegram.
Definition: eoApiDef.h:124
Secure telegram with choice encapsulation.
Definition: eoApiDef.h:150
Chained Security telegram.
Definition: eoApiDef.h:154
Chained Teach-In Response.
Definition: eoApiDef.h:140
Selective data.
Definition: eoApiDef.h:193
0x07 - No free buffer
Definition: eoApiDef.h:58
Smart Ack Learn Request telegram.
Definition: eoApiDef.h:118
Non-secure telegram.
Definition: eoApiDef.h:152