ua_basictypes.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387
  1. /*
  2. * ua_basictypes.h
  3. *
  4. * Created on: 13.03.2014
  5. * Author: mrt
  6. */
  7. #ifndef OPCUA_BASICTYPES_H_
  8. #define OPCUA_BASICTYPES_H_
  9. #include <stdint.h>
  10. #define DBG_VERBOSE(expression) //
  11. #define DBG_ERR(expression) //
  12. #if defined(DEBUG) || 1
  13. # undef DBG_ERR
  14. # define DBG_ERR(expression) expression
  15. # if defined(VERBOSE)
  16. # undef DBG_VERBOSE
  17. # define DBG_VERBOSE(expression) expression
  18. # endif
  19. #endif
  20. /* Basic types */
  21. typedef _Bool UA_Boolean;
  22. typedef uint8_t UA_Byte;
  23. typedef int8_t UA_SByte;
  24. typedef int16_t UA_Int16;
  25. typedef uint16_t UA_UInt16;
  26. typedef int32_t UA_Int32;
  27. typedef uint32_t UA_UInt32;
  28. typedef int64_t UA_Int64;
  29. typedef uint64_t UA_UInt64;
  30. typedef float UA_Float;
  31. typedef double UA_Double;
  32. /* ByteString - Part: 6, Chapter: 5.2.2.7, Page: 17 */
  33. typedef struct T_UA_ByteString
  34. {
  35. UA_Int32 length;
  36. UA_Byte* data;
  37. }
  38. UA_ByteString;
  39. /* Function return values */
  40. #define UA_SUCCESS 0
  41. #define UA_NO_ERROR UA_SUCCESS
  42. #define UA_ERROR (0x01)
  43. #define UA_ERR_INCONSISTENT (UA_ERROR | (0x01 << 1))
  44. #define UA_ERR_INVALID_VALUE (UA_ERROR | (0x01 << 2))
  45. #define UA_ERR_NO_MEMORY (UA_ERROR | (0x01 << 3))
  46. #define UA_ERR_NOT_IMPLEMENTED (UA_ERROR | (0x01 << 4))
  47. /* Boolean values and null */
  48. #define UA_TRUE (42==42)
  49. #define TRUE UA_TRUE
  50. #define UA_FALSE (!UA_TRUE)
  51. #define FALSE UA_FALSE
  52. /* Compare values */
  53. #define UA_EQUAL 0
  54. #define UA_NOT_EQUAL (!UA_EQUAL)
  55. /* heap memory functions */
  56. #define UA_NULL ((void*)0)
  57. extern void const * UA_alloc_lastptr;
  58. #define UA_free(ptr) _UA_free(ptr,__FILE__,__LINE__)
  59. UA_Int32 _UA_free(void * ptr,char*,int);
  60. UA_Int32 UA_memcpy(void *dst, void const *src, int size);
  61. #define UA_alloc(ptr,size) _UA_alloc(ptr,size,__FILE__,__LINE__)
  62. UA_Int32 _UA_alloc(void ** dst, int size,char*,int);
  63. /* Array operations */
  64. UA_Int32 UA_Array_calcSize(UA_Int32 noElements, UA_Int32 type, void const ** const ptr);
  65. UA_Int32 UA_Array_encodeBinary(void const **src, UA_Int32 noElements, UA_Int32 type, UA_Int32* pos, UA_ByteString * dst);
  66. UA_Int32 UA_Array_decodeBinary(UA_ByteString const * src,UA_Int32 noElements, UA_Int32 type, UA_Int32* pos, void ** const dst);
  67. UA_Int32 UA_Array_delete(void **p,UA_Int32 noElements, UA_Int32 type);
  68. UA_Int32 UA_Array_init(void **p,UA_Int32 noElements, UA_Int32 type);
  69. UA_Int32 UA_Array_new(void **p,UA_Int32 noElements, UA_Int32 type);
  70. #define UA_TYPE_METHOD_PROTOTYPES(TYPE) \
  71. UA_Int32 TYPE##_calcSize(TYPE const * ptr);\
  72. UA_Int32 TYPE##_encodeBinary(TYPE const * src, UA_Int32* pos, UA_ByteString * dst);\
  73. UA_Int32 TYPE##_decodeBinary(UA_ByteString const * src, UA_Int32* pos, TYPE * dst);\
  74. UA_Int32 TYPE##_delete(TYPE * p);\
  75. UA_Int32 TYPE##_deleteMembers(TYPE * p); \
  76. UA_Int32 TYPE##_init(TYPE * p); \
  77. UA_Int32 TYPE##_new(TYPE ** p);
  78. #define UA_TYPE_METHOD_CALCSIZE_SIZEOF(TYPE) \
  79. UA_Int32 TYPE##_calcSize(TYPE const * p) { return sizeof(TYPE); }
  80. #define UA_TYPE_METHOD_CALCSIZE_AS(TYPE, TYPE_AS) \
  81. UA_Int32 TYPE##_calcSize(TYPE const * p) { return TYPE_AS##_calcSize((TYPE_AS*) p); }
  82. #define UA_TYPE_METHOD_DELETE_FREE(TYPE) \
  83. UA_Int32 TYPE##_delete(TYPE * p) { return UA_free(p); }
  84. #define UA_TYPE_METHOD_DELETE_AS(TYPE, TYPE_AS) \
  85. UA_Int32 TYPE##_delete(TYPE * p) { return TYPE_AS##_delete((TYPE_AS*) p);}
  86. #define UA_TYPE_METHOD_DELETE_STRUCT(TYPE) \
  87. UA_Int32 TYPE##_delete(TYPE *p) { \
  88. UA_Int32 retval = UA_SUCCESS; \
  89. retval |= TYPE##_deleteMembers(p); \
  90. retval |= UA_free(p); \
  91. return retval; \
  92. }
  93. #define UA_TYPE_METHOD_DELETEMEMBERS_NOACTION(TYPE) \
  94. UA_Int32 TYPE##_deleteMembers(TYPE * p) { return UA_SUCCESS; }
  95. #define UA_TYPE_METHOD_DELETEMEMBERS_AS(TYPE, TYPE_AS) \
  96. UA_Int32 TYPE##_deleteMembers(TYPE * p) { return TYPE_AS##_deleteMembers((TYPE_AS*) p);}
  97. #define UA_TYPE_METHOD_DECODEBINARY_AS(TYPE,TYPE_AS) \
  98. UA_Int32 TYPE##_decodeBinary(UA_ByteString const * src, UA_Int32* pos, TYPE *dst) { \
  99. return TYPE_AS##_decodeBinary(src,pos,(TYPE_AS*) dst); \
  100. }
  101. #define UA_TYPE_METHOD_ENCODEBINARY_AS(TYPE,TYPE_AS) \
  102. UA_Int32 TYPE##_encodeBinary(TYPE const * src, UA_Int32* pos, UA_ByteString *dst) { \
  103. return TYPE_AS##_encodeBinary((TYPE_AS*) src,pos,dst); \
  104. }
  105. #define UA_TYPE_METHOD_INIT_AS(TYPE, TYPE_AS) \
  106. UA_Int32 TYPE##_init(TYPE * p){ \
  107. return TYPE_AS##_init((TYPE_AS*)p); \
  108. }
  109. #define UA_TYPE_METHOD_PROTOTYPES_AS(TYPE, TYPE_AS) \
  110. UA_TYPE_METHOD_CALCSIZE_AS(TYPE, TYPE_AS) \
  111. UA_TYPE_METHOD_ENCODEBINARY_AS(TYPE, TYPE_AS) \
  112. UA_TYPE_METHOD_DECODEBINARY_AS(TYPE, TYPE_AS) \
  113. UA_TYPE_METHOD_DELETE_AS(TYPE, TYPE_AS) \
  114. UA_TYPE_METHOD_DELETEMEMBERS_AS(TYPE, TYPE_AS) \
  115. UA_TYPE_METHOD_INIT_AS(TYPE, TYPE_AS)
  116. #define UA_TYPE_METHOD_NEW_DEFAULT(TYPE) \
  117. UA_Int32 TYPE##_new(TYPE ** p){ \
  118. UA_Int32 retval = UA_SUCCESS;\
  119. retval |= UA_alloc((void**)p, TYPE##_calcSize(UA_NULL));\
  120. retval |= TYPE##_init(*p);\
  121. return retval;\
  122. }
  123. #define UA_TYPE_METHOD_INIT_DEFAULT(TYPE) \
  124. UA_Int32 TYPE##_init(TYPE * p){ \
  125. if(p==UA_NULL)return UA_ERROR;\
  126. *p = (TYPE)0;\
  127. return UA_SUCCESS;\
  128. }
  129. /*** Prototypes for basic types **/
  130. UA_TYPE_METHOD_PROTOTYPES (UA_Boolean)
  131. UA_TYPE_METHOD_PROTOTYPES (UA_Byte)
  132. UA_TYPE_METHOD_PROTOTYPES (UA_SByte)
  133. UA_TYPE_METHOD_PROTOTYPES (UA_Int16)
  134. UA_TYPE_METHOD_PROTOTYPES (UA_UInt16)
  135. UA_TYPE_METHOD_PROTOTYPES (UA_Int32)
  136. UA_TYPE_METHOD_PROTOTYPES (UA_UInt32)
  137. UA_TYPE_METHOD_PROTOTYPES (UA_Int64)
  138. UA_TYPE_METHOD_PROTOTYPES (UA_UInt64)
  139. UA_TYPE_METHOD_PROTOTYPES (UA_Float)
  140. UA_TYPE_METHOD_PROTOTYPES (UA_Double)
  141. /**
  142. * StatusCodeBinaryEncoding
  143. * Part: 6
  144. * Chapter: 5.2.2.11
  145. * Page: 20
  146. */
  147. typedef UA_Int32 UA_StatusCode;
  148. enum UA_StatusCode_enum
  149. {
  150. // Some Values are called the same as previous Enumerations so we need
  151. //names that are unique
  152. UA_STATUSCODE_GOOD = 0x00
  153. };
  154. UA_TYPE_METHOD_PROTOTYPES (UA_StatusCode)
  155. /** IntegerId - Part: 4, Chapter: 7.13, Page: 118 */
  156. typedef float UA_IntegerId;
  157. UA_TYPE_METHOD_PROTOTYPES (UA_IntegerId)
  158. typedef struct T_UA_VTable {
  159. UA_UInt32 Id;
  160. UA_Int32 (*calcSize)(void const * ptr);
  161. UA_Int32 (*decodeBinary)(UA_ByteString const * src, UA_Int32* pos, void* dst);
  162. UA_Int32 (*encodeBinary)(void const * src, UA_Int32* pos, UA_ByteString* dst);
  163. UA_Int32 (*new)(void ** p);
  164. UA_Int32 (*delete)(void * p);
  165. UA_Byte* name;
  166. } UA_VTable;
  167. /* VariantBinaryEncoding - Part: 6, Chapter: 5.2.2.16, Page: 22 */
  168. enum UA_VARIANT_ENCODINGMASKTYPE_enum
  169. {
  170. UA_VARIANT_ENCODINGMASKTYPE_TYPEID_MASK = 0x3F, // bits 0:5
  171. UA_VARIANT_ENCODINGMASKTYPE_DIMENSIONS = (0x01 << 6), // bit 6
  172. UA_VARIANT_ENCODINGMASKTYPE_ARRAY = ( 0x01 << 7) // bit 7
  173. };
  174. typedef struct T_UA_Variant {
  175. UA_VTable* vt; // internal entry into vTable
  176. UA_Byte encodingMask; // Type of UA_Variant_EncodingMaskType_enum
  177. UA_Int32 arrayLength; // total number of elements
  178. void** data;
  179. } UA_Variant;
  180. UA_TYPE_METHOD_PROTOTYPES (UA_Variant)
  181. /* String - Part: 6, Chapter: 5.2.2.4, Page: 16 */
  182. typedef struct T_UA_String
  183. {
  184. UA_Int32 length;
  185. UA_Byte* data;
  186. }
  187. UA_String;
  188. UA_TYPE_METHOD_PROTOTYPES (UA_String)
  189. UA_Int32 UA_String_copy(UA_String const * src, UA_String* dst);
  190. UA_Int32 UA_String_copycstring(char const * src, UA_String* dst);
  191. UA_Int32 UA_String_compare(UA_String *string1, UA_String *string2);
  192. void UA_String_printf(char* label, UA_String* string);
  193. void UA_String_printx(char* label, UA_String* string);
  194. void UA_String_printx_hex(char* label, UA_String* string);
  195. /* ByteString - Part: 6, Chapter: 5.2.2.7, Page: 17 */
  196. UA_TYPE_METHOD_PROTOTYPES (UA_ByteString)
  197. UA_Int32 UA_ByteString_compare(UA_ByteString *string1, UA_ByteString *string2);
  198. UA_Int32 UA_ByteString_copy(UA_ByteString const * src, UA_ByteString* dst);
  199. UA_Int32 UA_ByteString_newMembers(UA_ByteString* p, UA_Int32 length);
  200. extern UA_ByteString UA_ByteString_securityPoliceNone;
  201. /** LocalizedTextBinaryEncoding - Part: 6, Chapter: 5.2.2.14, Page: 21 */
  202. enum UA_LOCALIZEDTEXT_ENCODINGMASKTYPE_enum
  203. {
  204. UA_LOCALIZEDTEXT_ENCODINGMASKTYPE_LOCALE = 0x01,
  205. UA_LOCALIZEDTEXT_ENCODINGMASKTYPE_TEXT = 0x02
  206. };
  207. typedef struct T_UA_LocalizedText
  208. {
  209. UA_Byte encodingMask;
  210. UA_String locale;
  211. UA_String text;
  212. }
  213. UA_LocalizedText;
  214. UA_TYPE_METHOD_PROTOTYPES (UA_LocalizedText)
  215. UA_Int32 UA_LocalizedText_copycstring(char const * src, UA_LocalizedText* dst);
  216. void UA_ByteString_printf(char* label, UA_ByteString* string);
  217. void UA_ByteString_printx(char* label, UA_ByteString* string);
  218. void UA_ByteString_printx_hex(char* label, UA_ByteString* string);
  219. /* GuidType - Part: 6, Chapter: 5.2.2.6 Page: 17 */
  220. typedef struct T_UA_Guid
  221. {
  222. UA_UInt32 data1;
  223. UA_UInt16 data2;
  224. UA_UInt16 data3;
  225. UA_Byte data4[8];
  226. } UA_Guid;
  227. UA_TYPE_METHOD_PROTOTYPES (UA_Guid)
  228. UA_Int32 UA_Guid_compare(UA_Guid *g1, UA_Guid *g2);
  229. /* DateTime - Part: 6, Chapter: 5.2.2.5, Page: 16 */
  230. typedef UA_Int64 UA_DateTime; //100 nanosecond resolution
  231. UA_TYPE_METHOD_PROTOTYPES (UA_DateTime)
  232. UA_DateTime UA_DateTime_now();
  233. typedef struct T_UA_NodeId
  234. {
  235. UA_Byte encodingByte; //enum BID_NodeIdEncodingValuesType
  236. UA_UInt16 namespace;
  237. union
  238. {
  239. UA_UInt32 numeric;
  240. UA_String string;
  241. UA_Guid guid;
  242. UA_ByteString byteString;
  243. }
  244. identifier;
  245. } UA_NodeId;
  246. UA_TYPE_METHOD_PROTOTYPES (UA_NodeId)
  247. UA_Int32 UA_NodeId_compare(UA_NodeId *n1, UA_NodeId *n2);
  248. void UA_NodeId_printf(char* label, UA_NodeId* node);
  249. /** XmlElement - Part: 6, Chapter: 5.2.2.8, Page: 17 */
  250. typedef struct T_UA_XmlElement
  251. {
  252. //TODO Überlegung ob man es direkt als ByteString speichert oder als String
  253. UA_ByteString data;
  254. } UA_XmlElement;
  255. UA_TYPE_METHOD_PROTOTYPES (UA_XmlElement)
  256. /* ExpandedNodeId - Part: 6, Chapter: 5.2.2.10, Page: 19 */
  257. // 62541-6 Chapter 5.2.2.9, Table 5
  258. #define UA_NODEIDTYPE_NAMESPACE_URI_FLAG 0x80
  259. #define UA_NODEIDTYPE_SERVERINDEX_FLAG 0x40
  260. #define UA_NODEIDTYPE_MASK (~(UA_NODEIDTYPE_NAMESPACE_URI_FLAG | UA_NODEIDTYPE_SERVERINDEX_FLAG))
  261. typedef struct T_UA_ExpandedNodeId
  262. {
  263. UA_NodeId nodeId;
  264. UA_String namespaceUri;
  265. UA_UInt32 serverIndex;
  266. }
  267. UA_ExpandedNodeId;
  268. UA_TYPE_METHOD_PROTOTYPES(UA_ExpandedNodeId)
  269. typedef UA_Int32 UA_IdentifierType;
  270. UA_TYPE_METHOD_PROTOTYPES(UA_IdentifierType)
  271. /* ExtensionObjectBinaryEncoding - Part: 6, Chapter: 5.2.2.15, Page: 21 */
  272. typedef struct T_UA_ExtensionObject {
  273. UA_NodeId typeId;
  274. UA_Byte encoding; //Type of the enum UA_ExtensionObjectEncodingMaskType
  275. UA_ByteString body;
  276. } UA_ExtensionObject;
  277. UA_TYPE_METHOD_PROTOTYPES(UA_ExtensionObject)
  278. enum UA_ExtensionObject_EncodingMaskType_enum
  279. {
  280. UA_EXTENSIONOBJECT_ENCODINGMASKTYPE_NOBODYISENCODED = 0x00,
  281. UA_EXTENSIONOBJECT_ENCODINGMASKTYPE_BODYISBYTESTRING = 0x01,
  282. UA_EXTENSIONOBJECT_ENCODINGMASKTYPE_BODYISXML = 0x02
  283. };
  284. /* QualifiedNameBinaryEncoding - Part: 6, Chapter: 5.2.2.13, Page: 20 */
  285. typedef struct T_UA_QualifiedName {
  286. UA_UInt16 namespaceIndex;
  287. UA_UInt16 reserved;
  288. UA_String name;
  289. } UA_QualifiedName;
  290. UA_TYPE_METHOD_PROTOTYPES(UA_QualifiedName)
  291. /* DataValue - Part: 6, Chapter: 5.2.2.17, Page: 23 */
  292. typedef struct UA_DataValue {
  293. UA_Byte encodingMask;
  294. UA_Variant value;
  295. UA_StatusCode status;
  296. UA_DateTime sourceTimestamp;
  297. UA_Int16 sourcePicoseconds;
  298. UA_DateTime serverTimestamp;
  299. UA_Int16 serverPicoseconds;
  300. } UA_DataValue;
  301. UA_TYPE_METHOD_PROTOTYPES(UA_DataValue)
  302. /** 62541-6, §5.2.2.17, Table 15 */
  303. enum UA_DataValue_EncodingMaskType_enum
  304. {
  305. UA_DATAVALUE_VARIANT = 0x01,
  306. UA_DATAVALUE_STATUSCODE = 0x02,
  307. UA_DATAVALUE_SOURCETIMESTAMP = 0x04,
  308. UA_DATAVALUE_SERVERTIMPSTAMP = 0x08,
  309. UA_DATAVALUE_SOURCEPICOSECONDS = 0x10,
  310. UA_DATAVALUE_SERVERPICOSECONDS = 0x20
  311. };
  312. /* DiagnosticInfo - Part: 6, Chapter: 5.2.2.12, Page: 20 */
  313. typedef struct T_UA_DiagnosticInfo {
  314. UA_Byte encodingMask; //Type of the Enum UA_DIAGNOSTICINFO_ENCODINGMASKTYPE
  315. UA_Int32 symbolicId;
  316. UA_Int32 namespaceUri;
  317. UA_Int32 localizedText;
  318. UA_Int32 locale;
  319. UA_String additionalInfo;
  320. UA_StatusCode innerStatusCode;
  321. struct T_UA_DiagnosticInfo* innerDiagnosticInfo;
  322. } UA_DiagnosticInfo;
  323. UA_TYPE_METHOD_PROTOTYPES(UA_DiagnosticInfo)
  324. enum UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_enum
  325. {
  326. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_SYMBOLICID = 0x01,
  327. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_NAMESPACE = 0x02,
  328. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_LOCALIZEDTEXT = 0x04,
  329. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_LOCALE = 0x08,
  330. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_ADDITIONALINFO = 0x10,
  331. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_INNERSTATUSCODE = 0x20,
  332. UA_DIAGNOSTICINFO_ENCODINGMASKTYPE_INNERDIAGNOSTICINFO = 0x40
  333. };
  334. #endif /* OPCUA_BASICTYPES_H_ */